summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNorbert Preining <preining@logic.at>2010-05-23 15:02:44 +0000
committerNorbert Preining <preining@logic.at>2010-05-23 15:02:44 +0000
commitfdfa1bfca0c03b6397e20cdc42328953a144b97b (patch)
tree123b4811748f2eebb5212cd9283908aaa10459e5
parent01b299aa854d009a20e4fe28f5d21d878ee179cb (diff)
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
-rwxr-xr-xMaster/texmf/scripts/texlive/tlmgr.pl29
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