[subversion-commit] SVN tetex-bin commit + diffs: r933 - tetex-bin/trunk/debian

[Frank Küster]

Author: frank
Date: 2006-02-24 09:23:07 +0000 (Fri, 24 Feb 2006)
New Revision: 933

Modified:
   tetex-bin/trunk/debian/README.Debian
   tetex-bin/trunk/debian/changelog
Log:
* Make clearer in README.Debian that adding configuration files is
  preferred over editing conffiles, thanks to Richard Lewis
  <rtf at jabble.org> [frank] 


Modified: tetex-bin/trunk/debian/README.Debian
===================================================================
--- tetex-bin/trunk/debian/README.Debian	2006-02-24 09:03:35 UTC (rev 932)
+++ tetex-bin/trunk/debian/README.Debian	2006-02-24 09:23:07 UTC (rev 933)
@@ -85,9 +85,9 @@
 
 The central system-wide configuration files texmf.cnf (which controls
 the basic operation and file search paths for the included programs),
-fmtutil.cnf (which specifies the available TeX formats) updmap.cfg (font
-configuration) and language.dat (hyphenation patterns for many formats)
-are handled through a Debian-specific mechanism that allows the
+fmtutil.cnf (which specifies the available TeX formats), updmap.cfg
+(font configuration) and language.dat (hyphenation patterns for many
+formats) are handled through a Debian-specific mechanism that allows the
 teTex-packages, add-on packages and local administrators to combine
 their changes (see below).
 
@@ -113,7 +113,8 @@
 alternatives. For norwegian, there are different sets of patterns, and
 upstream chose nohyphb.tex. Details can be found in
 /usr/share/texmf/doc/generic/nohyph/README.nohyph - you can chose an
-other one by editing language.dat.
+other one by editing language.dat or rather
+/etc/texmf/language.d/01tetex.cnf. 
 
 For ukranian, the right pattern file depends on the output encoding,
 see /usr/share/texmf/tex/generic/ukrhyph/ukrhyph.tex; you can also
@@ -132,6 +133,13 @@
 definitions taking precedence over later ones, it is best to keep only a
 minimal set of definitions in the user-specific file.
 
+In order to make updates smooth, you should avoid *editing* these files
+as far as possible, and instead *add* new files to change settings.  For
+texmf.cnf snippets, this is particularly easy, since earlier entries
+override any later entries.  Only for removing settings completely from
+fmtutil.cnf, updmap.cfg or language.dat is it necessary to edit existing
+files. 
+
 1.3.1 texmf.cnf and update-texmf:
 
 The TeX binaries are built to look for texmf.cnf (the master config
@@ -173,8 +181,8 @@
 /etc/texmf/updmap.d/, /etc/texmf/fmt.d/ and /etc/texmf/language.d/ will
 be treated as configuration files.
 
-As for texmf.cnf, the right way to change settings is to edit or add
-files in /etc/texmf/updmap.d/, /etc/texmf/fmt.d/ or
+Just as for texmf.cnf, the right way to change settings is to edit or
+add files in /etc/texmf/updmap.d/, /etc/texmf/fmt.d/ or
 /etc/texmf/language.d/. The details have been described above
 (1.3.1). Note, however, that the extension for updmap files is '.cfg',
 not '.cnf'.
@@ -254,7 +262,7 @@
 
 This can generally be done site-wide (by an administrator who has write
 access to at least /usr/local/share/texmf and /etc/texmf), or on a
-per-user basis.  This can be done by any use on the system, without
+per-user basis.  This can be done by any user on the system, without
 requiring write access to system directories.  Some people might also
 find it more convenient in case they share their home directory between
 a couple of machines, even if they do have administrator rights.
@@ -317,9 +325,9 @@
 where <supplier> identifies the supplier of the fonts (for instance,
 "adobe", "urw" or "public") and <typeface> refers to the name of the
 font family (e.g., "marvosym" or "lm"). If in doubt, you should have a
-look at the system tree managed by Debian packages, /usr/share/texmf; it
-follows the same layout, called the TeX Directory Structure, and is
-documented at:
+look at the system tree managed by Debian packages,
+/usr/share/texmf(-tetex); it follows the same layout, called the TeX
+Directory Structure, and is documented at:
 
   http://www.tug.org/tds/
 
@@ -382,10 +390,10 @@
 3.4 User-specific installation
 ------------------------------
 
-Instead of a system-wide installation, one can also install fonts in the 
-private $TEXMFHOME, which is set to $HOME/texmf by default.  Compared to
-the system-wide installation explained above, the following changes have
-to be made:
+Instead of a system-wide installation, one can also install input files
+and fonts in the private $TEXMFHOME, which is set to $HOME/texmf by
+default.  For fonts, compared to the system-wide installation explained
+above, the following changes have to be made:
 
 a) In step a), copy all relevant files to the appropriate subdirectories in
    $TEXMFHOME.  
@@ -465,7 +473,7 @@
 
 
  -- Frank Küster <frank at debian.org>
-    Florent Rougon <frn at debian.org>         Thu Aug  4 15:42:46 UTC 2005
+    Florent Rougon <frn at debian.org>         Fri Feb 24 10:42:46 UTC 2005
 
 Local Variables:
 mode:text

Modified: tetex-bin/trunk/debian/changelog
===================================================================
--- tetex-bin/trunk/debian/changelog	2006-02-24 09:03:35 UTC (rev 932)
+++ tetex-bin/trunk/debian/changelog	2006-02-24 09:23:07 UTC (rev 933)
@@ -1,8 +1,11 @@
 tetex-bin (3.0-14.1) UNRELEASED; urgency=low
 
-  * Really install the reportbug control script
+  * Really install the reportbug control script [frank]
+  * Make clearer in README.Debian that adding configuration files is
+    preferred over editing conffiles, thanks to Richard Lewis
+    <rtf at jabble.org> [frank] 
 
- -- Frank Küster <frank at debian.org>  Tue, 21 Feb 2006 12:34:12 +0100
+ -- Frank Küster <frank at debian.org>  Fri, 24 Feb 2006 10:23:52 +0100
 
 tetex-bin (3.0-14) unstable; urgency=low