From d35e389f3447f1f0b37d9a0c2981a6e17e5be3a7 Mon Sep 17 00:00:00 2001 From: Good Guy Date: Fri, 1 Jul 2022 19:23:45 -0600 Subject: [PATCH] Andrea has fixed the build/install to avoid using root --- parts/Installation.tex | 38 ++++++++++++++------------------------ 1 file changed, 14 insertions(+), 24 deletions(-) diff --git a/parts/Installation.tex b/parts/Installation.tex index dcc5751..6d5e612 100644 --- a/parts/Installation.tex +++ b/parts/Installation.tex @@ -221,8 +221,7 @@ To do a system build \index{build} , you should read the file \item You need about 6.0 \,GB of disk storage to operate a build and you need to have \textit{git} installed. -\item Obviously in order to install into the system, you must run as - \textbf{root}. +\item You do not need to be \textbf{root} (or \textit{sudo} ...) to install, except to run \texttt{bld\_prepare.sh} which calls in the distro's package manager. However if there are problems with permissions you can try to compile as root. \item The \textit{git:} step has to download many files (approx 130\,MB) so allow time. When decompressed this will expand to @@ -250,16 +249,13 @@ cd cinelerra5/cinelerra-5.1 make 2>&1 | tee log # make and log the build \end{lstlisting} - \texttt{bld\_prepare.sh} for Arch Linux may require other packages, - so you may have to install the dependencies - manually as you will have to do for gentoo. \texttt{README.arch} or \texttt{README.gentoo}, which - contain the list of dependencies, can be found at: - \begin{list}{}{} +\texttt{bld\_prepare.sh} works for debian-testing, ubuntu-testing, and arch with some additional information. For Arch linux, a README file containing many more dependencies is maintained. For Gentoo, a README file lists other dependencies that have to be installed manually. +\begin{list}{}{} \item \href{https://cinelerra-gg.org/download/README.arch}{https://cinelerra-gg.org/download/README.arch} \item \href{https://cinelerra-gg.org/download/README.gentoo}{https://cinelerra-gg.org/download/README.gentoo} - \end{list} - - \texttt{bld\_prepare.sh} option of debian-testing and ubuntu-testing is currently for future distros and +\end{list} + + \texttt{bld\_prepare.sh} option of debian-testing and ubuntu-testing is currently for perhaps the absolute latest versions and future distros and will be changed to more relevant names when they are released. \item Check for obvious build errors: @@ -279,7 +275,7 @@ grep "\*\*\*.*error" -ai log make install \end{lstlisting} Where represents the Operating System supported by \CGG{}, such -as centos, fedora, suse, ubuntu, mint, debian. +as centos, fedora, suse, ubuntu, mint, or debian. The ``with-single-user'' parameter makes it so. % Make and log build ( Check for errors before proceeding. @@ -302,8 +298,7 @@ the top level after you get the source. \item You need at least 6\,GB of disk storage to operate a build + you need to have “\texttt{git}” installed. -\item Recommend you build and run as \textbf{root}, just to avoid - permission issues initially. +\item You can install it without being \textbf{root} or without using \textit{sudo}. In case of problems you can use \textit{sudo} to avoid permission issues. \item The \textit{git} step has to download many files (approx 130\,MB) so allow time. @@ -319,8 +314,7 @@ cd cinelerra5/cinelerra-5.1 NOTE: if your system has never had \CGG{} Infinity installed, you will have to make sure all the compilers and libraries necessary are -installed. So on the very first build you should run as -\textbf{root}: +installed. Thus, for the execution part of \texttt{bld\_prepare.sh} you must use sudo, but the other steps can be done as a normal user. % FIXME No novels in the listings. \begin{lstlisting}[style=sh] @@ -331,7 +325,7 @@ make 2>&1 | tee log make install \end{lstlisting} Where represents the Operating System supported by \CGG{}, such -as centos, fedora, suse, ubuntu, mint, debian. +as centos, fedora, suse, ubuntu, mint, debian and arch. The ``with-single-user'' parameter makes it so. % Make and log build ( Check for errors before proceeding. @@ -339,14 +333,13 @@ Check for errors before proceeding. Then just start the application by keying in: \texttt{./cin} in the bin subdirectory OR add a desktop icon by using the appropriate -directory to copy the files to, run as \textbf{root}, and edit to +directory to copy the files to and edit to correct the directory path. Below are generic directions of how to do this. Then just start the application by keying in: \texttt{./cin} in the bin subdirectory OR add a desktop icon by using the appropriate -directory to copy the files to, run as \textbf{root}, and edit to -correct the directory path. Below are generic directions of how to +directory to copy the files to, run as root, and edit to correct the directory path. Below are generic directions of how to do this. \begin{lstlisting}[style=sh] @@ -359,16 +352,13 @@ After you have followed the above, in the cin.desktop file, change the \texttt{Exec=cin} line to be \texttt{Exec=/bin/cin}. -The preceding directions for doing a single-user build may work -without being root on some distros except for the \texttt{bld\_prepare.sh} -and creating the desktop icon. For example in Arch Linux installing without being root -works using the following steps: +A working example of how to build in Arch as a normal user: \begin{lstlisting}[style=sh] $ git clone --depth 1 "git://git.cinelerra-gg.org/goodguy/cinelerra.git" cinelerra5 $ cd /home/USER/cinelerra5/cinelerra-5.1 $ ./autogen.sh -$ ./configure --prefix=/usr --with-single-user --with-booby +$ ./configure --with-single-user --with-booby $ make 2>&1 | tee /tmp/cin5.log && make install \end{lstlisting} -- 2.26.2