minor improvements from Andrea
[goodguy/cin-manual-latex.git] / parts / Installation.tex
index 5aafa09c816fdc7ecd420a9a66412f52e76d05a4..6b64974afa76492f2c8cd0d6aad30d140a7be0a9 100644 (file)
@@ -4,16 +4,15 @@
 
 \section{\CGG{} AppImage}%
 \label{sec:cin_gg_appimage}
+\index{appimage}
 
 The main way to install \CGG{} is to use the AppImage. This is updated regularly and works for every distro, since it already contains the necessary dependencies. 
 A big advantage of using the AppImage format is that it is only 1/3 the size of the normal install,
 and since each release is named differently, you can keep a number of versions in a directory,
 and when testing from a terminal you just have to type CinGG, then hit tab, and complete it to
 the desired date release.
-
 For 64-bit systems you can choose between an image with up-to-date libraries or one that supports older libraries, which you should use only if the first image gives you problems with unsupported libs. There is also a 32-bit older distro available that has \textit{i686} as part of the filename that currently works on older distros but may not work on the newest distros
-(most of the popular Linux distributions such
-as Arch, Ubuntu, and Fedora have dropped support for this older architecture). In any case, if you are using a 32-bit Linux distro, you should compile your sources from git or use a precompiled binary\protect\footnote{Remember that a 32-bit distro does not address more than 4GB of memory, so you may have stability and performance problems with large, high-resolution mediafiles.}. And there is a 8/10/12 bit newer distro that handles 8 or 10 or 12 bits that has \textit{multibit} as part of the filename.  Installing the appimage is simple:
+(most of the popular Linux distributions such as Arch, Ubuntu, and Fedora have dropped support for this older architecture). In any case, if you are using a 32-bit Linux distro, you should compile your sources from git or use a precompiled binary\protect\footnote{Remember that a 32-bit distro does not address more than 4GB of memory, so you may have stability and performance problems with large, high-resolution mediafiles.}. And there is a 8/10/12 bit newer distro that handles 8 or 10 or 12 bits that has \textit{multibit} as part of the filename.  Installing the appimage is simple:
 
 Download the file from:
 
@@ -22,14 +21,18 @@ Download the file from:
 Some example file names are as follows - where 8 digits represent yyyymmdd:
 
 \begin{lstlisting}[style=sh]
-       CinGG-20210731-x86_64.AppImage
-         (currently based on Fedora Core 32, libc version 2.31)
-       CinGG-20210731-x86_64-older-distros.AppImage
+       CinGG-20220131-x86_64.AppImage
+         (currently based on Fedora 32, linux kernel 5.8.15, libc version 2.31)
+       CinGG-20220131-x86_64-older-distros.AppImage
          (currently based on Ubuntu 16.04, libc version 2.23)
-       CinGG-20210731-i686.AppImage
-         (currently based on Debian 9, linux kernel 4.9, does not work on Debian 11.0)
-       CinGG-20210731-x86_64-multibit.AppImage
-         (currently based on Fedora Core 32, libc version 2.31)
+       CinGG-20220131-i686.AppImage
+         (currently based on Debian 9, linux kernel 4.9, use "newer" for Debian 11.0)
+       CinGG-20220131-i686-newer-distros.AppImage
+         (currently based on Debian 11, linux kernel 5.10)
+       CinGG-20220131-x86_64-multibit.AppImage
+         (currently based on Fedora 32, libc version 2.31)
+       CinGG-20220131-x86_64-older-distros-multibit.AppImage
+         (currently based on Fedora 29 - runs on RHEL8 - linux kernel 4.19.9, libc version 2.28)
 \end{lstlisting}
 
 Make the file executable with the proper execute permissions either from the GUI of the Desktop Environment used (link to the file) or from a terminal window.  Make sure you are already in the directory containing the appimage:
@@ -65,6 +68,8 @@ In addition, if you are using the OpenGL video driver, you will need to install
 drivers for your Operating System graphics board because libGLU.so and other OpenGL libraries are
 not included in the AppImage.
 
+Using AppImage means you can't have the installation folder and work on the files. To unpack the AppImage and get its structure in folders and files see \nameref{sub:managing_appimage} To create, edit and manage appimages see \nameref{sub:built_appimage_scratch}.
+
 \section{Download Already Built \CGG{}}%
 \label{sec:download_already_built_cinelerra_gg}
 
@@ -157,8 +162,8 @@ NOTE: as of May 31, 2021 when Context Help was added, to include
 this Context Help you will need to download the corresponding
 tgz file containing the HTML manual sections referenced for the
 Help pages.  The file to download is:
-\url{https://cinelerra-gg.org/download/images/HTML_Manual-20210531.tgz}
-substituting for "20210531" the "yyyymmdd" representing latest release date.
+\url{https://cinelerra-gg.org/download/images/HTML_Manual-20220131.tgz}
+substituting for "20220131" the "yyyymmdd" representing latest release date.
 Then unpack to your Cinelerra/bin/doc directory so it is included in
 your built system.
 NOTE End
@@ -454,8 +459,8 @@ NOTE: as of May 31, 2021 when Context Help was added, to include
 this Context Help you will need to download the corresponding
 tgz file containing the HTML manual sections referenced for the
 Help pages.  The file to download is:
-\url{https://cinelerra-gg.org/download/images/HTML_Manual-20210531.tgz}
-substituting for "20210531" the "yyyymmdd" representing latest release date.
+\url{https://cinelerra-gg.org/download/images/HTML_Manual-20220131.tgz}
+substituting for "20220131" the "yyyymmdd" representing latest release date.
 Then unpack to your Cinelerra/bin/doc directory so it is included in
 your built system.  The reason for not including the HTML manual in 
 the source code so that it would already be there, is because it is