Update of /cvsroot/mahogany/M/doc
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv24968/doc

Modified Files:
        Manual.htex 
Log Message:
short explanation of multiple config sources

Index: Manual.htex
===================================================================
RCS file: /cvsroot/mahogany/M/doc/Manual.htex,v
retrieving revision 1.120
retrieving revision 1.121
diff -b -u -2 -r1.120 -r1.121
--- Manual.htex 5 Jul 2005 12:32:52 -0000       1.120
+++ Manual.htex 5 Jul 2005 15:51:22 -0000       1.121
@@ -70,4 +70,6 @@
 \begin{itemize}
    \item New integrated statistical spam filter (DSPAM)
+   \item Better support for sharing preferences between multiple installations
+         (see \ref{multiconfigsources})
    \item Folders can now be dragged in the folder tree to reorder them
    \item Mahogany can now select the viewer best suited for the contents of the
@@ -1059,4 +1061,39 @@
 
 
+\subsection{Using multiple configuration sources}\label{multiconfigsources}
+
+The default behaviour described in the sections above is the simplest possible
+and works well as long as Mahogany is only used on a single machine. However it
+is not ideal if you want to use it from several different installations. It
+should be noted that in the simplest case, when all these installations use the
+same operating system and are similarly configured, you may simply trasnfer the
+Mahogany configuration file \footnote{use the option in the synchronisation
+page of the options dialog to force using a file instead of the registry under
+Windows} to the other machine, however this doesn't work if you want to use the
+program from both Unix and Windows as in such case some settings are bound to
+be different.
+
+The solution is to use multiple \emph{configuration sources} (they are called
+sources and not files because, in general, the settings can also be stored in
+other locations such as on a remote IMAP server). To set this up, choose the
+corresponding command from the \MenuCmd{Edit} menu: it will present you with
+the dialog allowing to create more configuration sources (currently only local
+files are supported) and to change their priority by moving them up or down in
+the list.
+
+Here is an example of a setup recommended for IMAP users:
+\begin{enumerate}
+   \item OS-specific settings are stored in \texttt{machine-os.conf}: this
+         file should be tiny as the only OS-specific options are those that
+         involve external paths, e.g. the user directory.
+   \item Machine-specific settings are stored in \texttt{machine.conf}: this
+         file is still quite small as the only machine-specific entries are
+         usually the IMAP and SMTP host names.
+   \item All the rest is stored in \texttt{global.conf} which may be shared
+         among all installations. This file is, correspondingly, usually large.
+\end{enumerate}
+
+
+
 \section{The User Interface}
 



-------------------------------------------------------
SF.Net email is sponsored by: Discover Easy Linux Migration Strategies
from IBM. Find simple to follow Roadmaps, straightforward articles,
informative Webcasts and more! Get everything you need to get up to
speed, fast. http://ads.osdn.com/?ad_id=7477&alloc_id=16492&op=click
_______________________________________________
Mahogany-cvsupdates mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/mahogany-cvsupdates

Reply via email to