Alternative shortcuts added to manual as documented/tested by Andrea and IgorB

[goodguy/cin-manual-latex.git] / parts / Installation.tex

diff --git a/parts/Installation.tex b/parts/Installation.tex
index fd4859cf638ef6e2847de6934e36ad52b71c11a5..242a9ac81ff073d79fb3dc65e1acf88dcee01195 100644 (file)
--- a/parts/Installation.tex
+++ b/parts/Installation.tex
@@ -33,7 +33,8 @@ Some example file names are as follows - where 8 digits represent yyyymmdd:
          (currently based on Fedora 32, libc version 2.31)
        CinGG-20230131-x86_64-older-distros-multibit.AppImage
          (currently based on Fedora 29 - runs on RHEL8 - linux kernel 4.19.9, libc version 2.28)
-       CinGG-20230831-x86_64-alternative_shortcuts.AppImage
+       CinGG-20230930-alternative_shortcuts.AppImage
+         (currently based on Ubuntu 16.04, libc version 2.23)
 \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:
@@ -71,6 +72,12 @@ 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}.
 
+\subsection{AppImage with Standard Shortcuts}
+\label{sec:appimage_standard_shortcuts}
+
+In video editing it is important to learn how to use shortcuts to speed up your work. \CGG{} uses shortcuts different from those considered standard in both the Linux world and video editing. For example, \texttt{"s"} is used instead of \texttt{Ctrl+S}, \texttt{"q"} instead of \texttt{Ctrl+Q}, and even the classic editing keys \texttt{J, K, L} are different.
+In addition, in \CGG{} the keys are fixed and not customizable. A new user may have a hard time getting used to a new combination of shortcuts. To make it a little easier, an appimage containing a patch that makes use of some of the more frequently used classic key combinations is available. It can be downloaded \href{https://cinelerra-gg.org/download/images/CinGG-20230930-alternative_shortcuts.AppImage}{here} (note that the file contains the month and last day of the month, but you will want to go up a directory and download the latest date instead to include the current changes). A table showing the changes from \CGG{} mode to standard mode can be found here: \nameref{sec:alternative_shortcuts}.
+
 \section{Download Already Built \CGG{}}%
 \label{sec:download_already_built_cinelerra_gg}
 
@@ -360,9 +367,10 @@ $ cd /home/USER/cinelerra5/cinelerra-5.1
 $ ./autogen.sh
 $ ./configure --with-single-user --with-booby
 $ make 2>&1 | tee /tmp/cin5.log &&  make install
+$ mv Makefile Makefile.cfg
+$ cp Makefile.devel Makefile
 \end{lstlisting}
 
-
 \subsection{Notable Options and Caveats}%
 \label{sub:notable_options_and_caveats}
 \index{./configure}
@@ -374,6 +382,16 @@ handling errors, other problems and potential crashes with the most
 success.  Included in this section are some of the build variations
 easily available for normal builds.
 
+You can, during compilation, use a patch that changes the main non-standard shortcuts of \CGG{} to standard ones (\texttt{Ctrl+S} and \texttt{J, K, L}, etc.). 
+A table showing the changes from \CGG{} mode to standard mode can be found here: \nameref{sec:alternative_shortcuts}.
+The instructions for the build with the patch are as follows. After downloading the sources from the git repository in the usual way, you apply the patch:
+
+\begin{lstlisting}[style=sh]
+       cd cinelerra-5.1
+       patch -p1 -i alt_shortcuts.patch
+       ./bld.sh
+\end{lstlisting}
+
 To see the full list of features use:
 
 \begin{lstlisting}[style=sh]