minor corrections from Andrea, + other improvements
[goodguy/cin-manual-latex.git] / parts / Configuration.tex
index 9be3bccc8283f07bb76f61062b0353944ddb3144..5780a6935f56591f19112cdd556f8e3e6e1b4850 100644 (file)
@@ -265,7 +265,7 @@ If a user wants to prevent the automatic scaling, \textit{Layout Scale} should b
 
 For testing or when you are using a different sized monitor and want to ensure the expected
 size for larger text/fonts before you start the application from a window, you can keyin:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
         BC_SCALE=2.0 {your Cinelerra path}/bin/cin
 \end{lstlisting}
 The scaling size would only be in effect for that run of Cinelerra.  This is particularly
@@ -274,7 +274,7 @@ Then the environment variable, BC\_SCALE, can be used to overcome the bad settin
 Cinelerra and fix the scaling parameter.  For example, if you 
 accidentally set \textit{Layout Scale} to 112.6, keyin the following 
 and then when you get back into Cinelerra, fix \textit{Layout Scale} value in Preferences.  
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
         BC_SCALE=1.0 {your Cinelerra path}/bin/cin
 \end{lstlisting}
 
@@ -323,11 +323,14 @@ This section contains many useful options to cater to the various preferences of
     \end{figure}
     \item[EDL version warns if mismatched] in the case of a Batch Render, it is often helpful to be warned if the EDL has been changed so that you are aware that what is going to be rendered is different than your current EDL session.
     \item[Create Bluray warns if not root] if checked and you are not logged in as root, you will get an error message in order to avoid doing a lot of work and then failing out because root is required for automount and to write on DVD hardware.
+    \item[Warn on creating file references] if checked, you will always be warned when using "File by 
+Reference", that is when an EDL is opened as \textit{Reference}.  This is best left checked to ensure that you are aware of the fact that when changes are made
+to this file and rendered, any other uses of the same file will be affected and modified also.
     \item[Popups activate on button up] this is the default but if unchecked, popups activate on button down.
     \item[Set Input Focus when window entered] this is checked on by default because on some operating system distros, when you move your mouse to a different window, nothing happens and you are left wondering why you can not enter information.  When checked this causes the input focus to shift to any Cinelerra window when the cursor enters an exposed region of the window which eliminates the need to switch input focus by tabbing. 
     \item[Click to activate text focus] Click to activate text focus
     \item [Click to deactivate text focus] if checked, you will have to click to deactivate text focus.
-    \item[Always show next frame] in this mode the insertion pointer reflects the same as the Compositor so that for playing forward, the result is what looks like 1 was added to the frame displayed in the Compositor window.  This is fully explained in another section (\hyperref[sub:playing_seeking]{17.2.1}).
+    \item[Always show next frame] in this mode the insertion pointer reflects the same as the Compositor so that for playing forward, the result is what looks like 1 was added to the frame displayed in the Compositor window.  This is fully explained in another section (\hyperref[sub:playing_seeking]{Playing is Different than Seeking/Positioning!}).
     \item[Use thumbnails in resource window] the Resource Window displays thumbnails of assets by default, but drawing asset thumbnails can take more time and CPU so you may want to uncheck this.
     \item[Perpetual session] is very useful for working on a project over many days so you can just quit before
     shutting down and the next time you start up Cinelerra you will be right back where you left off. You
@@ -357,19 +360,19 @@ The following exported variables can be set to customize your environment. \\ Th
     \item[{\small CIN\_LOCALE}] locale text domain path to use for translating text
     \item[{\small CIN\_PLUGIN}] plugin directory path
     \item[{\small CIN\_RENDER}] complete filename with path, that was used for \textit{select file to render} to in the current session’s last successful Render job; this is used in the \texttt{RenderMux} defined \textit{Shell Cmds} and is available for any user-defined script inside Cinelerra
-    \item[{\small CIN\_PKG}] used to set your text domain, that is the locale path pointing to mo language file
+    \item[{\small CIN\_PKG}] used to set your text domain, that is the locale path pointing to the cin.mo language file
     \item[{\small CIN\_XSYNCH}] (for Developers only) set to 1 helps debugging for windows primitives to execute immediately and not be buffered up so you can see what is happening
 \end{description}
 
 One example:
 
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
 export CIN_BROWSER=chrome       #would override default firefox for Shell Cmds.
 \end{lstlisting}
 
 Another example:
 
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
 export CIN_CONFIG=/tmp/.bcast5   #use a temporary setup for testing purposes.
 \end{lstlisting}
 
@@ -386,8 +389,40 @@ normal size of 1. Refer to the previous Appearance section, \textit{Layout Scale
     \item[{\small LADSPA\_PATH}] specify an alternate set of ladspa plugins or include the default with the use of a colon separated list of directories to search for LADSPA plugins. This is always used first and if it does not
     exist, then the value for \texttt{CIN\_LADSPA} becomes \texttt{LADSPA\_PATH}.
     \item[{\small LV2\_PATH}] specify a certain set of LV2 plugins to use.  Separate multiple paths with colons.
-    \item[{\small LANG and LANGUAGE}] Cinelerra can be localized to display menus and messages in many languages. Language settings are normally read from your linux O/S language settings. To run on a language different than the one selected on your system just change the \texttt{LANG} and \texttt{LANGUAGE} environment variables.  For example, open a shell and type: \texttt{export LANG=es\_ES} or
-    \texttt{LANGUAGE=es\_ES}, then run Cin from the same shell and you will have translations in Spanish.
+    \item[{\small LANG}] Cinelerra can be localized to display menus and messages in many languages.
+Currently there are 16 languages in addition to English, of varying quality. Some information on
+these is in the \nameref{cha:translations} chapter.
+Language settings are normally read from your Linux O/S \textit{locale} settings. 
+The Cinelerra program checks environment variables to determine your settings to use as the language.
+First it checks the value of LANGUAGE and will use that if set.
+If that is not set, then it checks 
+LC\_ALL and finally if that is not set either, it will use the value of LANG. You can check the current
+settings from a window by looking at the output of the \textit{printenv} command.
+
+To run on a language different than the one selected on your system just change 
+the \texttt{LANG} environment variable before starting up Cinelerra like this:
+
+\hspace{2em} \texttt{export LANG}=\textit{2 letter language code\_2 letter country code.UTF-8} 
+
+For example, from a window type:
+
+\hspace{2em} \texttt{export LANG=es\_ES.UTF-8} 
+
+then startup Cinelerra and you will have translations in Spanish.  If you started Cinelerra from that same
+window using \texttt{\{cinelerra\_path\}/bin/cin} you will see a message in that window something similar to:
+
+\hspace{2em}  \textit{lang changed from en\_US.UTF-8 to es\_ES-UTF-8}
+
+However, although generally LANGUAGE is not set, it is possible that another progam that was run may
+have set it so you may have to substitute LANGUAGE for the word LANG above.
+
+Depending on your Operating System and Desktop application, there may be other ways to accomplish a
+language change.  For example, on Fedora with the Gnome desktop, the simplest method of switching your
+language to German and immediately starting Cinelerra is to use:
+
+\hspace{2em} \texttt{LANGUAGE=de \{cinelerra\_path\}/bin/cin} 
+
+
     \item[{\small SHUTTLE\_CONFIG\_FILE}] alternate shuttle configuration file.
 \end{description}