[Debian-tex-commits] SVN tex-common commit + diffs: r2491 - tex-common/trunk/scripts

[Frank Küster]

Author: frank
Date: 2007-02-19 22:03:34 +0100 (Mon, 19 Feb 2007)
New Revision: 2491

Modified:
   tex-common/trunk/scripts/dh_installtex
Log:
wrote the documentation for the planned "create format symlinks"
feature.  There's no code yet!


Modified: tex-common/trunk/scripts/dh_installtex
===================================================================
--- tex-common/trunk/scripts/dh_installtex	2007-02-19 18:44:05 UTC (rev 2490)
+++ tex-common/trunk/scripts/dh_installtex	2007-02-19 21:03:34 UTC (rev 2491)
@@ -16,6 +16,7 @@
 [B<-n>]
 [B<--priority=>I<n>]
 [B<--flavor=>I<flavor>[,I<flavor>]]
+[B<--no-format-links>]
 [B<map=MixedMap,>I<file.map>]
 [B<map=Map,>I<file.map>]
 [B<mapfile=>I<file.cfg>[=I<n>]]
@@ -168,13 +169,25 @@
 
 Default is I<not> to generate any config files.
 
-B<format:build_all> creates all defined formats in the postinst file,
-recreates all defined formats in the postrm file, and in addition cleans
-the generated files in the postrm files.
+B<format:build_all> will add code to the postinst script to create all
+defined formats, and to the postrm script to clean and recreate? FIXME?
+the generated formats.
 
 B<format:add_one:I<formatname>> allows to add the generation of a specific
-format without actually providing it (in a cnf file).
+format without actually providing it (in a cnf file).  This is useful if a 
+package adds hyphenation patterns to an existing formats.
 
+=item B<--no-format-links>]
+
+Usually, for every format that is specified in a configuration file in
+/etc/texmf/fmt.d/, dh_installtex will create a symlink
+/usr/bin/I<format> that points to the corresponding engine.  For
+example, /usr/bin/latex would be created as a symlink to pdftex.  
+
+The option B<--no-format-links> inhibits this. If a link already
+exists, dh_installtex will skip this format with an informational
+message, even if this option is not given.
+
 =head1 NOTES
 
 Note that this command is not idempotent. "dh_clean -k" should be called