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

Wed Aug 24 10:57:48 UTC 2005

Author: frank
Date: 2005-08-24 10:57:48 +0000 (Wed, 24 Aug 2005)
New Revision: 160

Added:
   tetex-bin/trunk/debian/libkpathsea4-dev.README.Debian
Modified:
   tetex-bin/trunk/debian/README.Debian
   tetex-bin/trunk/debian/changelog
Log:
documentation enhancements

Modified: tetex-bin/trunk/debian/README.Debian
===================================================================

--- tetex-bin/trunk/debian/README.Debian	2005-08-24 09:51:20 UTC (rev 159)
+++ tetex-bin/trunk/debian/README.Debian	2005-08-24 10:57:48 UTC (rev 160)
@@ -41,6 +41,11 @@
     2.3 PDF and DVI output
     2.4 "TeX capacity exceeded" and similar errors
 3. How to install additional or updated (La)TeX packages or fonts. 
+    3.1 (La)TeX input files
+    3.2 Complex installations
+    3.3 Font installation
+    3.3 User-specific installation
+
 4. Problems, bug reports
 
 
@@ -234,13 +239,10 @@
 leads to that error, or to a similar error message. The package
 documentation, the google archive, or TeX-related mailinglists or
 newsgroups will be helpful to find out which parameter needs to be
-changed in /etc/texmf/texmf.cnf. 
+changed in /etc/texmf/texmf.cnf (or rather in
+/etc/texmf/texmf.d/95NonPath.cnf, see 1.3.1 above). 
 
-As described above (1.3.1), please do not edit this file
-directly. Rather edit the files in /etc/texmf/texmf.d/ and invoke
-update-texmf. 
 
-
 3. How to install additional or updated (La)TeX packages or fonts. 
 ================================================================
 
@@ -249,13 +251,22 @@
 a) install it at a place where TeX can find it
 b) register it properly.
 
+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
+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.
+
+In the following, we first explain the principles by describing a
+site-wide setup, then we explain the details for user-specific setup. 
+
 3.1 (La)TeX input files
 ----------------------
 
-This is usually quite easy. You can either install them in your
-$HOMETEXMF tree, that is, into a directory called "texmf" in your home
-directory. Or, if you are the local administrator, you can put it in
-$LOCALTEXMF which is the directory tree below /usr/local/share/texmf.
+This is usually quite easy.  Put the files in an appropriate directory
+below $LOCALTEXMF which is the directory tree rooted at
+/usr/local/share/texmf.
 
    For LaTeX packages, create the directory tex/latex/<packagename>
    within that tree (or use tex/latex/misc) and put the files
@@ -279,7 +290,8 @@
 package. The Debian-specific part comes in when the configuration
 files texmf.cnf, fmtutil.cnf or updmap.cfg need to be changed. See the
 description above (1.3), and the manpages for update-updmap,
-update-texmf and update-fmtutil.
+update-texmf and update-fmtutil, and the section on font installation
+below.
 
 3.3 Font installation
 ---------------------
@@ -366,6 +378,55 @@
 users on the system.
 
 
+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:
+
+a) In step a), copy all relevant files to the appropriate subdirectories in
+   $TEXMFHOME.  
+
+b) The configuration file created in step b) should be placed in
+   $TEXMFCONFIG ($HOME/.texmf-config by default).  An appropriate place
+   would be $TEXMFCONFIG/updmap.d. Note that most likely you will have
+   to create this directory first.
+
+c) In step c), one then calls "update-updmap" to create updmap.cfg in
+   $TEXMFVAR/web2c ($HOME/.texmf-var/web2c by default):
+
+$ update-updmap --conf-dir $HOME/.texmf-config/updmap.d \
+                --output-file $HOME/.texmf-var/web2c/updmap.cfg
+
+   This creates $HOME/.texmf-var/web2c/updmap.cfg based on the
+   configuration files in $HOME/.texmf-config/updmap.d *and* in
+   /etc/texmf/updmap.d.  If a file exists in both directories, the
+   version in $TEXMFCONFIG takes precedence. 
+
+e) After updating the ls-R files with "mktexlsr" or "texhash" (step d),
+   one has to generate the map files in step e).  This is done by running
+   the program "updmap" instead of "updmap-sys".  The generated files
+   are also created in directories below $TEXMFVAR.
+
+Note that "update-updmap" merges the configuration files in
+$HOME/.texmf-config/web2c/updmap.d and in /etc/texmf/updmap.d.
+Therefore, all system-wide installed fonts are accessible without
+dublicating their configuration files.  Merging the configuration files
+is done on the basis of file names: If a file exists in both
+directories, the version in $TEXMFCONFIG takes precedence.  Thus, you
+can also use this mechanism to change settings compared to the site-wide
+configuration, e.g. by keeping a changed copy of 00updmap.cfg in
+$TEXMFCONFIG/updmap.d.
+
+Keep in mind that you still have to call "update-updmap" with the above
+options whenever the system-wide installation changes.  If you keep a
+changed copy of a file from the site-wide directories, you need to
+manually merge any changes to this file, if desired.
+
+
+
 4. Problems, bug reports
 ========================
 

Modified: tetex-bin/trunk/debian/changelog
===================================================================
--- tetex-bin/trunk/debian/changelog	2005-08-24 09:51:20 UTC (rev 159)
+++ tetex-bin/trunk/debian/changelog	2005-08-24 10:57:48 UTC (rev 160)
@@ -8,8 +8,13 @@
     TEXMFMAIN/web2c [frank]
   * Correct ebb's usage message (patch-tmp), and refine its manpage
     (closes: #324670).  Thanks to Robert Millan <rmh at aybabtu.com> [frank] 
+  * Added a README.Debian file for libkpathsea4-dev, thanks to Hilmar
+    (closes: #321241) [frank] 
+  * Added an explanation of user-specific font configuration in
+    README.Debian, thanks to Ralf Stubner
+    <Ralf.Stubner at physik.uni-erlangen.de> [frank]
 
- -- Frank KÃ¼ster <frank at debian.org>  Tue, 23 Aug 2005 14:36:11 +0200
+ -- Frank KÃ¼ster <frank at debian.org>  Wed, 24 Aug 2005 12:57:20 +0200
 
 tetex-bin (3.0-6) experimental; urgency=low
 

Added: tetex-bin/trunk/debian/libkpathsea4-dev.README.Debian
===================================================================
--- tetex-bin/trunk/debian/libkpathsea4-dev.README.Debian	2005-08-24 09:51:20 UTC (rev 159)
+++ tetex-bin/trunk/debian/libkpathsea4-dev.README.Debian	2005-08-24 10:57:48 UTC (rev 160)
@@ -0,0 +1,25 @@
+Why a new soname of libkpathsea in teTeX 3.0?
+---------------------------------------------
+
+We're just quoting Olaf Weber, the author of web2c. The full message can be
+found on:
+http://lists.debian.org/debian-tetex-maint/2004/03/msg00181.html
+
+"libkpathsea moved from using klibtool (a web2c-specific libtool-like hack)
+to libtool. As a result it acquired a new soname.
+libkpathsea was not designed to work well as a shared library, and has
+numerous flaws in that area -- in particular, too many internals are
+exposed, and too much is hard-coded."
+
+Olaf does not expect too many changes in the API of the libkpathsea between
+teTeX 2.0.2 and 3.0 so just relinking the programs should be sufficient.
+However that is not really predictable.
+
+"So at present my advice is that it's better to be safe than sorry, and
+enforce that the version of libkpathsea matches the program's version."
+
+A new redesigned libkpathsea, which is really a shared lib, is on his TODO
+list, but he can't say when it will be released.
+
+ -- Frank Küster <frank at debian.org>, Wed Aug 24 12:54:11 2005
+


