The single user build allows for running completely out of a local user directory so it doesn't affect the system.
We recommend the single-user version when possible.
-It makes it very easy to install a new version without having to delete the older version in case you want it for backup – once you are happy with the new version, all you have to do is delete the entire old directory path.
+It makes it very easy to install a new version without having to delete the older version in case you want it for backup - once you are happy with the new version, all you have to do is delete the entire old directory path.
Also, if you install a new Operating System version and if you have Cinelerra on separate disk space that is preserved, you won't have to reinstall Cinelerra.
In addition for purposes of having the ability to interrupt or to see any possible error messages, if you start the application from a terminal window command line you will have more control to catch problems.
However, the system builds can be useful in a university lab setting where there are possibly multiple users, or multiple versions.
\paragraph{To do a system build,} you should read the \texttt{README} that is at the top level after you get the source.
+
\begin{enumerate}
\item
You need at least 2.5\,GB of disk storage to operate a build + you need to have “\texttt{git}” installed.
To see the full list of features use:
\begin{lstlisting}[language=bash]
-$ ./configure –help
+$ ./configure -help
\end{lstlisting}
The default build is a system build which uses:
\begin{lstlisting}[language=bash]
-$ ./configure –without-single-user
+$ ./configure -without-single-user
\end{lstlisting}
In the single-user build, the target directory is always “cin”.
Because this is also the developer build, constant names are used throughout.
However, you can rename files after the install is complete.
-f your distro/operating system has issues with the default install to \texttt{/usr/local}, you might have to change the location to /usr for a system build. Then you will have to use:
+If your operating system has issues with the default install to \texttt{/usr/local}, you might have to change the location to \texttt{/usr} for a system build. Then you will have to use:
\begin{lstlisting}[language=bash]
$ ./configure --prefix=/usr
\end{lstlisting}
$ ./configure --with-exec-name=cinelerra
\end{lstlisting}
-The home configuration directory can also be set, but defaults to \texttt{\$\$HOME/.bcast5}.
+The home configuration directory can also be set, but default location is \texttt{\$HOME/.bcast5}.
For example:
\begin{lstlisting}[language=bash]
-$ ./configure –with-config-dir=/myusername/.bcast5
+$ ./configure -with-config-dir=/myusername/.bcast5
\end{lstlisting}
NOTE: when you specify parameters to the configure program, it will create a make file as a consequence.
To get your customized build to work, you need to change the probe options for the conflicting libraries from "yes" to "auto", or even rework the \texttt{configure.ac} script.
There may be several libraries which need special treatment.
-An example of a problem you might encounter with your customized installation is with “\texttt{a52dec}” which has probes \texttt{(CHECK\_LIB/CHECK\_HEADER)} in \texttt{configure.ac}, but \texttt{djbfft} does not.
+An example of a problem you might encounter with your customized installation is with “\texttt{a52dec}” which has probes line \texttt{(CHECK\_LIB/CHECK\_HEADER)} in \texttt{configure.ac}, but \texttt{djbfft} does not.
In this case, \texttt{djbfft} is only built because \texttt{a52dec} is built, so if your system has \texttt{a52dec}, set \texttt{a52dec} to auto and see if that problem is solved by retrying the build with:
\begin{lstlisting}[language=bash]
-$ ./confgure --with-single-user –enable-a52dec=auto .
+$ ./confgure --with-single-user -enable-a52dec=auto .
\end{lstlisting}
With persistence, you can get results, but it may take several tries to stabilize the build.
If you need help, email the "\texttt{log}" and "\texttt{config.log}", which is usually sufficient to determine why a build failed.
-\vspace{5ex}
+%\vspace{5ex}
If you have already installed the \texttt{libfdk\_aac} development package on your computer because you prefer this version over the default aac, you will have to do the following to get this alternative operational.
Then, to run as a developer in the debugger:
\begin{lstlisting}[language=bash]
-$ CFLAGS=”-O2 -ggdb” make -j8 rebuild_all
+$ CFLAGS="-O2 -ggdb" make -j8 rebuild_all
$ cd cinelerra
$ gdb ./ci
\end{lstlisting}
These scripts are in the “blds” subdirectory.
The bsd.bld should be used with the bsd.patch file in that same directory.
-The reason that Cin Infinity traditionally uses thirdparty builds (bundled builds) is because there are a lot of different distros with varying levels of ffmpeg and other needed thirdparty libraries.
+The reason that Cin Infinity traditionally uses thirdparty builds (bundled builds)\todo{hanging line} is because there are a lot of different distros with varying levels of ffmpeg and other needed thirdparty libraries.
However, some users prefer using their current system baseline without another/different copy of ffmpeg.
With different levels of the user’s libraries, uncertainty, potential instability, and unknown issues may come up while running Cinelerra and this will make it, for all practical purposes, impossible to diagnose and debug problems or crashes.
There may be no help in these cases. You are encouraged to report any errors which potentially originate from Cin Infinity, but if the data indicates alternate library sources, please report the problems to the appropriate maintainers.
wget https://cinelerra-gg.org/download/pkgs/{substitute_name}/cin_5.1.<sub_name>.deb
and install it manually, for example: dpkg -i cin_5.1.{substitute_filename}.deb
-# GENTOO – courtesy Dominque Michel
+# GENTOO - courtesy Dominque Michel
# There is an ebuild package at this time as of 01/03/2019 at:
# https://svnweb.tuxfamily.org/listing.php?repname=proaudio%2Fproaudio&path=
# %2Ftrunk%2Foverlays%2Fproaudio%2Fmedia-video%2Fcinelerra%2F&#ab000caf7024d83112f42a7e8285f2f29
-# FREEBSD – courtesy Yuri
+# FREEBSD - courtesy Yuri
# There is a port available at: https://www.freshports.org/multimedia/cinelerra-gg/
# To use this port: cd /usr/ports/multimedia/cinelerra-gg && make install clean
# and then install this precompiled package via: pkg install cinelerra-gg
projects / goodguy / cin-manual-latex.git / blobdiff