[subversion-commit] SVN tetex commit + diffs: r115 -
tetex-bin/trunk/debian
Florent Rougon
frn at costa.debian.org
Thu Aug 4 16:32:27 UTC 2005
Author: frn
Date: 2005-08-04 16:32:20 +0000 (Thu, 04 Aug 2005)
New Revision: 115
Modified:
tetex-bin/trunk/debian/Debian-TeX-Policy.sgml
tetex-bin/trunk/debian/README.Debian
tetex-bin/trunk/debian/changelog
Log:
[tetex-bin]
* Update the section in debian/README.Debian that deals with manual
system-wide font installation by administrators.
* Minor typo fixes in debian/Debian-TeX-Policy.sgml and
debian/README.Debian.
Modified: tetex-bin/trunk/debian/Debian-TeX-Policy.sgml
===================================================================
--- tetex-bin/trunk/debian/Debian-TeX-Policy.sgml 2005-08-04 15:04:01 UTC (rev 114)
+++ tetex-bin/trunk/debian/Debian-TeX-Policy.sgml 2005-08-04 16:32:20 UTC (rev 115)
@@ -128,7 +128,7 @@
<item>
<p>The configuration information from files provided by
- differen TeX-related packages must be merged and made
+ different TeX-related packages must be merged and made
available in appropriate form to the various programs. This
is usually done by scripts that write files into the
<var>TEXMFSYSVAR</var> tree.
Modified: tetex-bin/trunk/debian/README.Debian
===================================================================
--- tetex-bin/trunk/debian/README.Debian 2005-08-04 15:04:01 UTC (rev 114)
+++ tetex-bin/trunk/debian/README.Debian 2005-08-04 16:32:20 UTC (rev 115)
@@ -42,6 +42,7 @@
3. How to install additional or updated (La)TeX packages or fonts.
4. Problems, bug reports
+
1. Changing your configuration, file placement
==============================================
@@ -54,7 +55,7 @@
configuration setup in the user's home directory. System
administrators must use the commands texconfig-sys, fmtutil-sys and
updmap-sys which act on the system-wide configuration files. Users can
-invode their user counterparts texconfig, fmtutil and updmap. This
+invoke their user counterparts texconfig, fmtutil and updmap. This
will put copies of the system-wide configuration files into the user's
TEXCONFIG directory (by default, $HOME/.texmf-config), modify them and
generate according formats, if applicable.
@@ -95,8 +96,6 @@
with debconf". User-specific formats with different hyphenation
patterns can
-
-
1.2 Hyphenation
---------------
@@ -119,7 +118,6 @@
see /usr/share/texmf/tex/generic/ukrhyph/ukrhyph.tex; you can also
choose different rule sets in the file.
-
1.3 The files texmf.cnf, fmtutil.cnf, and updmap.cfg
----------------------------------------------------
@@ -211,6 +209,7 @@
rather /etc/texmf) at the time they are first invoked, and do not
track later system-wide changes!
+
2. Usage hints, debian-specific adaptations
===========================================
@@ -290,32 +289,87 @@
3.3 Font installation
---------------------
-Generally you should look at the installation instructions that come
-with the font. Usually, files have to be put in the correct
-subdirectories below texmf/fonts/, i.e. afm files go into
-texmf/fonts/afm etc., and are ordered according to their
-manufacturer's names, or put in public. Don't forget to invoke
-mktexlsr.
+If you wish to install a font package in a system-wide manner, please
+follow the instructions in this section. If you are preparing a Debian
+package containing fonts, you should refer to the Debian teTeX policy
+instead.
-In order to register the font for the different programs, you need to
-make it's map known. This is how it can usually be done:
+In the following paragraphs, $TEXMFLOCAL stands for
+"/usr/local/share/texmf". This is where most files should be installed
+during system-wide installations that are not done by Debian packages.
-- to add font package "foo", first put its map file, e.x. foo.map in
- /etc/texmf/map/dvips/ (or in the other subdirectories of
- /etc/texmf/map/ if they are specific to pdftex or dvipdfm)
+Generally, you should first have a look at the installation instructions
+that come with the font package, in case there is something specific to
+that package with respect to installation. Usually, files have to be put
+in specific subdirectories below $TEXMFLOCAL. For instance, AFM files
+should be stored into:
-- provide a configuration file /etc/texmf/updmap.d/10foo.cfg (the
- extension ".cfg" is important!) The file should contain the line
- "Map foo.map", or "MixedMap foo.map" if "foo" is available both
- as bitmap and as outline.
+ $TEXMFLOCAL/fonts/afm/<supplier>/<typeface>/
-- now run "update-updmap", this will generate an appropriate updmap.cfg
- under /var/lib/texmf/web2c (not /etc/texmf !). Then run "updmap" itself.
- This will generate the files that are read by dvips, pdflatex,
- dvipdfm etc., e.g. psfonts.map.
+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
+documented at:
+ http://www.tug.org/tds/
+In order for the various TeX-related programs to be able to use a font,
+you need to somehow register its map files (simply copying the files to
+$TEXMFLOCAL is not enough). You can do this with the following steps,
+performed as root, where "foo" stands for the name of the font package
+you are installing:
+ a) Make sure you have stored all the relevant files shipped in the
+ package (.afm, .tfm, .pfb, .pfa, .mf, .fd, .enc, .map, .sty are all
+ relevant in this context) in the appropriate subdirectories of
+ $TEXMFLOCAL, as explained above.
+
+ Note: in teTeX 3 (as opposed to teTeX 2)
+ - .map files should go to $TEXMFLOCAL/fonts/map/<syntax>/foo/
+ - .enc files should go to $TEXMFLOCAL/fonts/enc/<syntax>/foo/
+
+ where <syntax> indicates the syntax followed by the files (it is
+ often "dvips"). Please refer to the teTeX Manual for details (you
+ can read it with the command 'texdoc TETEXDOC').
+
+ b) Create a configuration file /etc/texmf/updmap.d/10local-foo.cfg (the
+ extension ".cfg" is important!). The file should list the map files
+ you stored in step a) under $TEXMFLOCAL, with one line per file, as
+ in:
+
+ # This is a comment line
+ Map foo.map
+ Map other-map-file-from-package-foo.map
+
+ If a font is available both as bitmap and outline, you should use
+ MixedMap instead of Map. Please refer to update-updmap(1) and
+ updmap-sys(1) for details.
+
+ c) Run the program "update-updmap". This will generate an appropriate
+ updmap.cfg file under /var/lib/texmf/web2c/ (not /etc/texmf/!),
+ containing the Map and/or MixedMap lines taken from 10local-foo.cfg.
+
+ Note: modifying updmap.cfg directly is not supported in Debian,
+ because Debian font packages need to update it when they are
+ installed or removed. This is why updmap.cfg is not stored under
+ /etc and why you have to use update-updmap whenever you want to
+ modify it.
+
+ d) Run the program "mktexlsr" (or "texhash", which is the same). This
+ will record all the newly created files in ls-R files (these are
+ used by TeX-related programs as indices to find the files they need
+ when operating).
+
+ e) Run the program "updmap-sys". This will use your updated updmap.cfg
+ to generate files that are needed by dvips, pdflatex, dvipdfm, etc.,
+ such as psfonts.map or pdftex.map.
+
+At this point, the font package should be properly installed for all
+users on the system.
+
+
4. Problems, bug reports
========================
@@ -352,4 +406,10 @@
which are not included in the upstream teTeX.
- -- Frank Küster <frank at debian.org>, Sun Apr 17 15:27:45 2005
+ -- Frank Küster <frank at debian.org>
+ Florent Rougon <frn at debian.org> Thu Aug 4 15:42:46 UTC 2005
+
+Local Variables:
+mode:text
+fill-column:72
+End:
Modified: tetex-bin/trunk/debian/changelog
===================================================================
--- tetex-bin/trunk/debian/changelog 2005-08-04 15:04:01 UTC (rev 114)
+++ tetex-bin/trunk/debian/changelog 2005-08-04 16:32:20 UTC (rev 115)
@@ -2,12 +2,14 @@
* Now Build-Depends on tex-common, and uses common.variables and
common.functions from there if possible. We still need the files in
- the diff.gz. though, I'm not a Makefile guru.
+ the diff.gz. though, I'm not a Makefile guru. [frank]
* Apply patch by Matthias Klose to allow building with xorg (closes:
- #310434).
+ #310434). [frank]
* Re-libtoolize with newer libtool to allow building for GNU/KFreeBSD,
minimal patch thanks to Aurelien Jarno <aurel32 at debian.org> (closes:
- #320141).
+ #320141). [frank]
+ * Update the section in debian/README.Debian that deals with manual
+ system-wide font installation by administrators. [frn]
-- Frank Küster <frank at debian.org> Mon, 1 Aug 2005 18:55:27 +0200
More information about the Pkg-tetex-commits
mailing list