add tlmgr documentation for configuration file and GUI expert mode toggle

git-svn-id: svn://tug.org/texlive/trunk@18432 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 28 insertions, 1 deletions

diff --git a/Master/texmf/scripts/texlive/tlmgr.pl b/Master/texmf/scripts/texlive/tlmgr.pl
index 4f1b91fdaa6..1615cd38038 100755
--- a/Master/texmf/scripts/texlive/tlmgr.pl
+++ b/Master/texmf/scripts/texlive/tlmgr.pl
@@ -5554,6 +5554,28 @@ updmap> yourself.  After that, network updates and your local changes
 should be merged.
 
 
+=head1 CONFIGURATION FILE
+
+A small subset of the command line options can be set in a config
+file for C<tlmgr> which resides in C<TEXMFVAR/tlmgr/config>. Note
+that it is B<not> C<TEXMFSYSVAR> so the file is specific to a single
+user. By default thus the config file is in C<~/.texlive2010/tlmgr/config>.
+
+Format of this file is: empty lines and lines starting with # are ignored.
+All other lines must look like
+
+  key = value
+
+where the allowed keys are C<gui_expertmode>, C<persistent-downloads>, and
+C<allow-ftp>. The values can only be 0 or 1 for those settings.
+C<persistent-downloads> and C<allow-ftp> correspond to the respective
+command line options of C<tlmgr>. C<gui_expertmode> switches between
+the full GUI and a simplified with only the important and mostly used
+settings.
+
+Warning: If you switch your gui expert mode settings within the GUI itself,
+all comments written in the config file will be discarded.
+
 =head1 GUI
 
 The graphical user interface for C<tlmgr> needs Perl/TK being installed.
@@ -5592,6 +5614,12 @@ I<Architectures> (only on Unix, configuration of the supported/installed
 architectures), as well as some toggles to turn on and off various
 options.
 
+There is also a toggle for C<Expert options> which defaults to on. If
+you turn this off the next time you start the GUI a simplified screen
+will be shown that exhibits only the most important and necessary 
+functionality. This setting is saved in the configuration file of
+C<tlmgr>, see L<CONFIGURATION FILE> for details.
+
 =item B<Actions>
 
 Provides access to a variety of items, such as updating the filename
@@ -5723,7 +5751,6 @@ action needs the option C<backupdir> set (see Options -> General).
 Finally, the status area at the bottom of the window gives additional
 information what is going on.
 
-
 =head2 the old (v1) GUI
 
 For the time being the first GUI written for C<tlmgr> is still included