[subversion-commit] SVN tex-common commit + diffs: r900 - in tex-common/trunk: debian scripts

Norbert Preining preining-guest at costa.debian.org
Fri Feb 17 11:53:58 UTC 2006


Author: preining-guest
Date: 2006-02-17 11:53:57 +0000 (Fri, 17 Feb 2006)
New Revision: 900

Added:
   tex-common/trunk/scripts/dh_installtexfonts
   tex-common/trunk/scripts/dh_installtexfonts.1
   tex-common/trunk/scripts/dh_installtexfonts.pl
Removed:
   tex-common/trunk/scripts/dh_installtexfonts
Modified:
   tex-common/trunk/debian/README.Debian
   tex-common/trunk/debian/changelog
   tex-common/trunk/debian/rules
Log:
- replace dh_installtexfonts by a script converting the syntax
- give a warning in the dh_installtexfonts man page


Modified: tex-common/trunk/debian/README.Debian
===================================================================
--- tex-common/trunk/debian/README.Debian	2006-02-17 09:52:43 UTC (rev 899)
+++ tex-common/trunk/debian/README.Debian	2006-02-17 11:53:57 UTC (rev 900)
@@ -8,7 +8,7 @@
 /var partition, this might be a security risk, depending on local
 requirements and policy.
 
-If you don't like this, use "dpkg-reconfigure tex-common" to switch
+If you don't like this, use "dpkg-reconfigure -plow tex-common" to switch
 group ownership of the directory to a different group, or remove the
 group write permission.  In this case, the local administrator should
 probably fill the font cache, using the commands "allneeded" or

Modified: tex-common/trunk/debian/changelog
===================================================================
--- tex-common/trunk/debian/changelog	2006-02-17 09:52:43 UTC (rev 899)
+++ tex-common/trunk/debian/changelog	2006-02-17 11:53:57 UTC (rev 900)
@@ -1,6 +1,9 @@
 tex-common (0.15.1) UNRELEASED; urgency=low
 
   * Add dh_installtex for public perusal. [preining]
+    - add dh_installtex and man page
+    - replace dh_installtexfonts by a script converting the syntax
+    - give a warning in the dh_installtexfonts man page
   * common.functions.in:
     - Add md5sums for tetex-extra's former configuration files (closes:
       #351649, #352486) [frank]
@@ -12,9 +15,9 @@
       variable and as a maintainer script variable
   * rework debconf usage (Closes: #352394) [preining]
     - do not manage the ls-R files permissions from now on
-    - manage the group and permissions of /var/cache/fonts 
+    - manage the group and permissions of /var/cache/fonts
 
- -- Frank Küster <frank at debian.org>  Tue, 14 Feb 2006 14:48:27 +0100
+ -- Norbert Preining <preining at logic.at>  Fri, 17 Feb 2006 12:52:27 +0100
 
 tex-common (0.15) unstable; urgency=high
 

Modified: tex-common/trunk/debian/rules
===================================================================
--- tex-common/trunk/debian/rules	2006-02-17 09:52:43 UTC (rev 899)
+++ tex-common/trunk/debian/rules	2006-02-17 11:53:57 UTC (rev 900)
@@ -40,7 +40,7 @@
 
 	# Add here commands to compile the package.
 	cd doc; $(MAKE)
-	cd scripts; pod2man dh_installtexfonts > dh_installtexfonts.1
+	#cd scripts; pod2man dh_installtexfonts > dh_installtexfonts.1
 	cd scripts; pod2man dh_installtex > dh_installtex.1
 
 	touch build-stamp
@@ -78,9 +78,9 @@
 	ln -s ../sbin/update-fontlang $(INSTDIR)/usr/bin/update-updmap
 
 	# debhelper stuff
-	# dh_installtexfonts(.1) is already installed via the bin_scripts
-	grep -v '^[ \t]*#' scripts/postrm-texfonts > $(INSTDIR)/usr/share/debhelper/autoscripts/postrm-texfonts
-	grep -v '^[ \t]*#' scripts/postinst-texfonts > $(INSTDIR)/usr/share/debhelper/autoscripts/postinst-texfonts
+	# dh_installtex(.1) is already installed via the bin_scripts
+	#grep -v '^[ \t]*#' scripts/postrm-texfonts > $(INSTDIR)/usr/share/debhelper/autoscripts/postrm-texfonts
+	#grep -v '^[ \t]*#' scripts/postinst-texfonts > $(INSTDIR)/usr/share/debhelper/autoscripts/postinst-texfonts
 	grep -v '^[ \t]*#' scripts/postrm-tex > $(INSTDIR)/usr/share/debhelper/autoscripts/postrm-tex
 	grep -v '^[ \t]*#' scripts/postinst-tex > $(INSTDIR)/usr/share/debhelper/autoscripts/postinst-tex
 

Deleted: tex-common/trunk/scripts/dh_installtexfonts
===================================================================
--- tex-common/trunk/scripts/dh_installtexfonts	2006-02-17 09:52:43 UTC (rev 899)
+++ tex-common/trunk/scripts/dh_installtexfonts	2006-02-17 11:53:57 UTC (rev 900)
@@ -1,320 +0,0 @@
-#!/usr/bin/perl -w
-
-=head1 NAME
-
-dh_installtexfonts - register Type 1 fonts with TeX
-
-=cut
-
-use strict;
-use Debian::Debhelper::Dh_Lib;
-
-=head1 SYNOPSIS
-
-B<dh_installtexfonts> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] 
-    [B<--flavor=>I<flavor>] [S<I<maptype=mapfile ...>>] [S<I<cfg-file[=I<n>] ...>>] 
-
-=head1 DESCRIPTION
-
-dh_installtexfonts is a debhelper program that is responsible for
-registering Type 1 fonts with TeX.
-
-Your package should depend on tex-common so that the
-update-* commands are available. (This program adds that dependency to
-${misc:Depends}.)
-
-Registering map files for TeX can be done in the following ways:
-
-1) You can specify cfg files on the cmd line, optionally providing a 
-priority by affixing =n to it. These cfg files will be 
-installed into /etc/texmf/updmap.d/ with the specified priority, if present,
-or with the default priority and their original name.
-
-Example:
-
-	dh_installtexfonts foo.cfg dvips/bar.cfg=42
-
-would install foo.cfg as /etc/texmf/updmap.d/10foo.cfg, and dvips/bar.cfg
-as /etc/texmf/updmap.d/42bar.cfg.
-
-2) You can specify map lines on the cmdline, where the map type and the
-map files is connected with =. These map lines are stored in a cfg file
-10package.cfg.
-
-Example:
-
-	dh_installtexfonts Map=foo.map MixedMap=bar.map
-
-would install a file /etc/texmf/updmap.d/10package.cfg containing the lines
-
-	Map foo.map
-	MixedMap bar.map
-
-3) You create a file debian/package.maps or debian/maps. These files are
-installed with default priority and the name of the package. The file 
-debian/maps will be installed into the first package dh_installtexfonts 
-is told to act on. By default this is the first binary package in 
-debian/control, but if you use -p, -i, or -a flags, it will be the first
-package specified by those flags.
-
-Example:
-
-	dh_installtexfonts
-
-would install a present debian/package.maps file as 
-/etc/texmf/updmap.d/10package.cfg.
-
-=head2 Mixing the different variants
-
-The command line maps (Variant 2) are merged into the debian/package.maps 
-file and the merged file is installed as 10package.cfg. If you specify 
-an additional package.cfg (Variant 1) without a different priority than
-the default one on the cmd line, this will raise an error since both files 
-would be installed as 10package.cfg. You can only specify package.cfg without
-a different priority than the default one if no debian/package.maps nor
-any command line Map files are present.
-
-=head2 The pseudo-comment
-
-If the provided cfg files do not contain the pseudo-comment as described
-in the Debian TeX Policy, Font configuration, an additional header with
-explanation, warning and the pseudo-comment is added.
-
-
-This program automatically generates the postinst and postrm commands needed
-to register the fonts with TeX.  See L<dh_installdeb(1)> for an explanation 
-of how this works.
-
-=head1 OPTIONS
-
-=over 4
-
-=item B<-n>, B<--noscripts>
-
-Do not modify postinst/prerm scripts.
-
-=item B<--priority=>I<n>
-
-Set the default priority to I<n> instead of 10.
-
-=item B<--flavor=>I<flavor>
-
-This option will be used to switch additional options on. At the moment
-you can select for I<flavor> either B<config_for_active_maps> or 
-B<config_for_all_maps>.
-B<config_for_active_maps> will create a file I<config.bar> for each active
-(i.e. uncommented) map in each of the cfg file generated by one of the
-three methods described above. These files are installed in
-/usr/share/texmf/dvips/config/.
-
-If you select B<config_for_all_maps> the script will generate I<config.bar>
-even for those map files which are present in a cfg file, but deactivated by a comment.
-
-The file I<config.bar> is used when called by `dvips -Pbar ...'. Thus it
-allows the activation of single map files even if they are not automatically
-activated via the updmap(-sys) mechanism.
-
-Default is I<not> to generate any config files.
-
-=head1 NOTES
-
-Note that this command is not idempotent. "dh_clean -k" should be called
-between invocations of this command, unless using the B<-n> option. 
-Otherwise, it may cause multiple instances of the same text to be added 
-to maintainer scripts.
-
-Please refer to the Debian TeX policy for details about fonts configuration
-for TeX by Debian packages.
-
-=cut
-
-init();
-
-sub extract_map {
-	my ($line,$doconfig) = @_;
-	if ($doconfig == 0) { return ""; }
-	if ($_ =~ m/^[[:space:]]*([#[:space:]]*)[[:space:]]*(Mixed)?Map[[:space:]]*(.*\.map)[[:space:]]*(#.*)?$/) {
-		my $comment = $1;
-		my $map = $3;
-		if (($comment eq "") || ($doconfig == 2)) {
-			return $map;
-		}
-	}
-	return "";
-}
-
-sub magic_comment_present {
-	my ($fname) = @_;
-	my @args = ( "grep", "-q", "^# -_- DebPkgProvidedMaps -_-", $fname );
-	if (system(@args) == 0) { return 1; }
-	return 0;
-}
-
-my $magicheader = "# You can change/add entries to this file and changes will be preserved
-# over upgrades, even if you have removed the main package prior
-# (not if you purged it). You should leave the following pseudo comment
-# present in the file!
-# -_- DebPkgProvidedMaps -_-
-#
-";
-
-foreach my $package (@{$dh{DOPACKAGES}}) {
-	my $tmp=tmpdir($package);
-	my $file=pkgfile($package,"maps");
-	my $priority=10;
-	my @pkgcfg;
-	my @cmdlinemaps;
-	my %cmdcfgshash;
-	my @cmdlinecfgs;
-	my $pkgfileoncmdline = 0;
-	my @listlines;
-	my @mapfiles;
-	my $doconfig = 0;
-
-	if (defined($dh{PRIORITY}) && $dh{PRIORITY} ne '') {
-		$priority=$dh{PRIORITY};
-	}
-	if (defined($dh{FLAVOR})) {
-		if ($dh{FLAVOR} eq "config_for_active_maps") {
-			$doconfig = 1;
-		} elsif ($dh{FLAVOR} eq "config_for_all_maps") {
-			$doconfig = 2;
-		} else {
-			error("Specified flavor $dh{FLAVOR} not supported.\nPlease see man page for supported flavors!\n");
-		}
-	}
-	if ($file) {
-		open(FOO, "<$file") || error("$file cannot be opened.");
-		@pkgcfg = <FOO>;
-		close(FOO);
-	}
-	if (($package eq $dh{FIRSTPACKAGE} || $dh{PARAMS_ALL}) && @ARGV) {
-		foreach my $entry (@ARGV) {
-			if ($entry =~ m/^(Map|MixedMap)=(.*)$/) {
-				push @cmdlinemaps, "$1 $2";
-				if ($doconfig > 0) { push @mapfiles, $2; }
-			} elsif ($entry =~ m/^(.*\.cfg)(=([[:digit:]]+))?$/) {
-				my $fn=$1;
-				my $pr=$priority;
-				if (defined($3)) {
-					$pr=$3;
-				}
-				my $bn=basename($fn);
-				if ($bn eq "$package.cfg" && $pr == $priority) {
-					$pkgfileoncmdline = 1;
-				}
-				$cmdcfgshash{$fn}=$pr;
-			} else {
-				error("$entry is neither of the form Map=filename.map, MixedMap=filename.map, or filename.cfg(=priority).");
-			}
-		}
-	}
-
-	@cmdlinecfgs = keys(%cmdcfgshash);
-	if (!$file && ($#cmdlinemaps < 0) && ($#cmdlinecfgs < 0)) {
-		# we have nothing to do here, skip to the next one!
-		next;
-	}
-
-	if ($pkgfileoncmdline && ($file || ($#cmdlinemaps >= 0))) {
-		error("This call would create multiple copies of $priority$package.cfg.\nPlease read the man page on how this should be fixed!\n");
-	}
-
-        if ( ! -d "$tmp/etc/texmf/updmap.d/") {
-            doit("install","-d","$tmp/etc/texmf/updmap.d/");
-        }
-	#
-	# the cmd line cfg files
-	#
-	foreach my $fn (@cmdlinecfgs) {
-		my $bn=basename($fn);
-		my $pr=$cmdcfgshash{$fn};
-		-r "$tmp/etc/texmf/updmap.d/$pr$bn" &&
-			error("The config file $tmp/etc/texmf/updmap.d/$pr$bn already exists! Cannot recreate it, please call dh_clean -k!");
-		open(CFGFILE, ">$tmp/etc/texmf/updmap.d/$pr$bn") ||
-			error("Cannot open $tmp/etc/texmf/updmap.d/$pr$bn for writing!");
-		verbose_print("Writing $tmp/etc/texmf/updmap.d/$pr$bn");
-		if (!magic_comment_present($fn)) {
-			print CFGFILE "# $pr$bn\n";
-			print CFGFILE $magicheader;
-		}
-		open(FOO,"<$fn") || error("Cannot open $fn for reading!");
-		while (<FOO>) { 
-			my $m;
-			print CFGFILE $_; 
-			if ($m = extract_map($_, $doconfig)) { push @mapfiles, $m; }
-		}
-		close(FOO);
-		close(CFGFILE);
-		$bn =~ s/\.cfg$//;
-		push @listlines, "$pr$bn";
-	}
-	#
-	# now debian/package.maps and/or debian/maps
-	# merge in the cmd line arguments
-	#
-	if ($file || ($#cmdlinemaps >= 0)) {
-		-r "$tmp/etc/texmf/updmap.d/$priority$package.cfg" &&
-			error("The config file $tmp/etc/texmf/updmap.d/$priority$package.cfg already exists! Cannot recreate it, please call dh_clean -k!");
-		open(CFGFILE, ">$tmp/etc/texmf/updmap.d/$priority$package.cfg") || 
-			error("Cannot open $tmp/etc/texmf/updmap.d/$priority$package.cfg for writing!");
-		verbose_print("Writing $tmp/etc/texmf/updmap.d/$priority$package.cfg");
-		if (($file && !magic_comment_present($file)) ||
-		    (!$file && ($#cmdlinemaps >= 0))) {
-			print CFGFILE "# $priority$package.cfg\n";
-			print CFGFILE $magicheader;
-		}
-		foreach (@pkgcfg) {
-			my $m;
-			print CFGFILE "$_";
-			if ($m = extract_map($_, $doconfig)) { push @mapfiles, $m; }
-		}
-		foreach (@cmdlinemaps) {
-			print CFGFILE "$_\n";
-		}
-		close(CFGFILE);
-		push @listlines, "$priority$package";
-	}
-	
-        if ( ! -d "$tmp/var/lib/tex-common/fontmap-cfg/") {
-            doit("install","-d","$tmp/var/lib/tex-common/fontmap-cfg/");
-        }
-	open(LISTFILE, ">>$tmp/var/lib/tex-common/fontmap-cfg/$package.list")||
-		error("Cannot open $tmp/var/lib/tex-common/fontmap-cfg/$package.list for writing/appending!");
-	verbose_print("Writing $tmp/var/lib/tex-common/fontmap-cfg/$package.list");
-	foreach (@listlines) {
-		print LISTFILE "$_\n";
-	}
-	close(LISTFILE);
-
-	if ($#mapfiles >= 0) {
-		doit("install","-d","$tmp/usr/share/texmf/dvips/config/");
-	}
-	foreach my $m (@mapfiles) {
-		my $f = $m;
-		$f =~ s/\.map$//;
-		-r "$tmp/usr/share/texmf/dvips/config/config.$f" &&
-			error("The dvips config file $tmp/usr/share/texmf/dvips/config/config.$f already exists!\nYou may have to call dh_clean -k!\n");
-		open(CNFFILE, ">$tmp/usr/share/texmf/dvips/config/config.$f") ||
-			error("Cannot open $tmp/usr/share/texmf/dvips/config/config.$f for writing!");
-		verbose_print("Writing $tmp/usr/share/texmf/dvips/config/config.$f");
-		print CNFFILE "p +$m\n";
-		close(CNFFILE);
-	}
-	if (! $dh{NOSCRIPTS}) {
-		autoscript($package, "postinst", "postinst-texfonts", "");
-		autoscript($package, "postrm",   "postrm-texfonts",   "");
-	}
-
-	addsubstvar($package, "misc:Depends", "tex-common", ">= 0.7");
-}
-
-=head1 SEE ALSO
-
-L<debhelper(7)>
-
-=head1 AUTHOR
-
-Norbert Preining <preining at logic.at>
-
-=cut

Added: tex-common/trunk/scripts/dh_installtexfonts
===================================================================
--- tex-common/trunk/scripts/dh_installtexfonts	2006-02-17 09:52:43 UTC (rev 899)
+++ tex-common/trunk/scripts/dh_installtexfonts	2006-02-17 11:53:57 UTC (rev 900)
@@ -0,0 +1,40 @@
+#!/bin/sh
+#
+# dh_installtexfonts
+# 
+# transform calls from the old dh_installtexfonts syntax to the new
+# dh_installtex syntax
+#
+# Norbert Preining
+# 2006
+#
+
+echo "dh_installtexfonts is deprecated. Please use dh_installtex!" >&2
+echo "This is a shell script converting the call syntax for " >&2
+echo "dh_installtexfonts into the syntax for dh_installtex." >&2
+
+newargs=""
+for i in "$@" ; do
+    case "$i" in
+    	--flavor=*)
+	    foo=$(echo "$i" | sed -e 's/--flavor=/--flavor=map:/')
+	    newargs="$newargs $foo"
+	    ;;
+	Map=*|MixedMap=*|map=*|mixedmap=*)
+	    foo=$(echo "$i" | sed -e 's/=/,/')
+	    newargs="$newargs map=$foo"
+	    ;;
+	*.cfg|*.cfg=*)
+	    newargs="$newargs mapfile=$i"
+	    ;;
+	*)
+	    newargs="$newargs $i"
+	    ;;
+    esac
+done
+
+echo "Please use dh_installtex in your scripts!" >&2
+echo "Calling: dh_installtex $newargs" >&2
+
+dh_installtex $newargs
+

Added: tex-common/trunk/scripts/dh_installtexfonts.1
===================================================================
--- tex-common/trunk/scripts/dh_installtexfonts.1	2006-02-17 09:52:43 UTC (rev 899)
+++ tex-common/trunk/scripts/dh_installtexfonts.1	2006-02-17 11:53:57 UTC (rev 900)
@@ -0,0 +1,256 @@
+.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sh \" Subsection heading
+.br
+.if t .Sp
+.ne 5
+.PP
+\fB\\$1\fR
+.PP
+..
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Set up some character translations and predefined strings.  \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote.  | will give a
+.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
+.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
+.\" expand to `' in nroff, nothing in troff, for use with C<>.
+.tr \(*W-|\(bv\*(Tr
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+.    ds -- \(*W-
+.    ds PI pi
+.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
+.    ds L" ""
+.    ds R" ""
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds -- \|\(em\|
+.    ds PI \(*p
+.    ds L" ``
+.    ds R" ''
+'br\}
+.\"
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.if \nF \{\
+.    de IX
+.    tm Index:\\$1\t\\n%\t"\\$2"
+..
+.    nr % 0
+.    rr F
+.\}
+.\"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.hy 0
+.if n .na
+.\"
+.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
+.    \" fudge factors for nroff and troff
+.if n \{\
+.    ds #H 0
+.    ds #V .8m
+.    ds #F .3m
+.    ds #[ \f1
+.    ds #] \fP
+.\}
+.if t \{\
+.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+.    ds #V .6m
+.    ds #F 0
+.    ds #[ \&
+.    ds #] \&
+.\}
+.    \" simple accents for nroff and troff
+.if n \{\
+.    ds ' \&
+.    ds ` \&
+.    ds ^ \&
+.    ds , \&
+.    ds ~ ~
+.    ds /
+.\}
+.if t \{\
+.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+.\}
+.    \" troff and (daisy-wheel) nroff accents
+.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+.ds ae a\h'-(\w'a'u*4/10)'e
+.ds Ae A\h'-(\w'A'u*4/10)'E
+.    \" corrections for vroff
+.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+.    \" for low resolution devices (crt and lpr)
+.if \n(.H>23 .if \n(.V>19 \
+\{\
+.    ds : e
+.    ds 8 ss
+.    ds o a
+.    ds d- d\h'-1'\(ga
+.    ds D- D\h'-1'\(hy
+.    ds th \o'bp'
+.    ds Th \o'LP'
+.    ds ae ae
+.    ds Ae AE
+.\}
+.rm #[ #] #H #V #F C
+.\" ========================================================================
+.\"
+.IX Title "DH_INSTALLTEXFONTS 1"
+.TH DH_INSTALLTEXFONTS 1 "2006-02-17" "perl v5.8.8" "User Contributed Perl Documentation"
+.SH "NAME"
+dh_installtexfonts \- register Type 1 fonts with TeX
+.SH "SYNOPSIS"
+.IX Header "SYNOPSIS"
+\&\fBdh_installtexfonts\fR [\fIdebhelper\ options\fR] [\fB\-n\fR] [\fB\-\-priority=\fR\fIn\fR] 
+    [\fB\-\-flavor=\fR\fIflavor\fR] [\fImaptype=mapfile\ ...\fR] [\fIcfg\-file[=\fIn\fI]\ ...\fR] 
+.SH "DESCRIPTION"
+.IX Header "DESCRIPTION"
+dh_installtexfonts is a debhelper program that is responsible for
+registering Type 1 fonts with TeX.
+.PP
+\&\fB\s-1THIS\s0 \s-1PROGRAM\s0 \s-1IS\s0 \s-1DEPRECATED\s0, \s-1PLEASE\s0 \s-1USE\s0 \s-1DH_INSTALLTEX\s0\fR
+.PP
+Your package should depend on tex-common so that the
+update\-* commands are available. (This program adds that dependency to
+${misc:Depends}.)
+.PP
+Registering map files for TeX can be done in the following ways:
+.PP
+1) You can specify cfg files on the cmd line, optionally providing a 
+priority by affixing =n to it. These cfg files will be 
+installed into /etc/texmf/updmap.d/ with the specified priority, if present,
+or with the default priority and their original name.
+.PP
+Example:
+.PP
+.Vb 1
+\&        dh_installtexfonts foo.cfg dvips/bar.cfg=42
+.Ve
+.PP
+would install foo.cfg as /etc/texmf/updmap.d/10foo.cfg, and dvips/bar.cfg
+as /etc/texmf/updmap.d/42bar.cfg.
+.PP
+2) You can specify map lines on the cmdline, where the map type and the
+map files is connected with =. These map lines are stored in a cfg file
+10package.cfg.
+.PP
+Example:
+.PP
+.Vb 1
+\&        dh_installtexfonts Map=foo.map MixedMap=bar.map
+.Ve
+.PP
+would install a file /etc/texmf/updmap.d/10package.cfg containing the lines
+.PP
+.Vb 2
+\&        Map foo.map
+\&        MixedMap bar.map
+.Ve
+.PP
+3) You create a file debian/package.maps or debian/maps. These files are
+installed with default priority and the name of the package. The file 
+debian/maps will be installed into the first package dh_installtexfonts 
+is told to act on. By default this is the first binary package in 
+debian/control, but if you use \-p, \-i, or \-a flags, it will be the first
+package specified by those flags.
+.PP
+Example:
+.PP
+.Vb 1
+\&        dh_installtexfonts
+.Ve
+.PP
+would install a present debian/package.maps file as 
+/etc/texmf/updmap.d/10package.cfg.
+.Sh "Mixing the different variants"
+.IX Subsection "Mixing the different variants"
+The command line maps (Variant 2) are merged into the debian/package.maps 
+file and the merged file is installed as 10package.cfg. If you specify 
+an additional package.cfg (Variant 1) without a different priority than
+the default one on the cmd line, this will raise an error since both files 
+would be installed as 10package.cfg. You can only specify package.cfg without
+a different priority than the default one if no debian/package.maps nor
+any command line Map files are present.
+.Sh "The pseudo-comment"
+.IX Subsection "The pseudo-comment"
+If the provided cfg files do not contain the pseudo-comment as described
+in the Debian TeX Policy, Font configuration, an additional header with
+explanation, warning and the pseudo-comment is added.
+.PP
+This program automatically generates the postinst and postrm commands needed
+to register the fonts with TeX.  See \fIdh_installdeb\fR\|(1) for an explanation 
+of how this works.
+.SH "OPTIONS"
+.IX Header "OPTIONS"
+.IP "\fB\-n\fR, \fB\-\-noscripts\fR" 4
+.IX Item "-n, --noscripts"
+Do not modify postinst/prerm scripts.
+.IP "\fB\-\-priority=\fR\fIn\fR" 4
+.IX Item "--priority=n"
+Set the default priority to \fIn\fR instead of 10.
+.IP "\fB\-\-flavor=\fR\fIflavor\fR" 4
+.IX Item "--flavor=flavor"
+This option will be used to switch additional options on. At the moment
+you can select for \fIflavor\fR either \fBconfig_for_active_maps\fR or 
+\&\fBconfig_for_all_maps\fR.
+\&\fBconfig_for_active_maps\fR will create a file \fIconfig.bar\fR for each active
+(i.e. uncommented) map in each of the cfg file generated by one of the
+three methods described above. These files are installed in
+/usr/share/texmf/dvips/config/.
+.Sp
+If you select \fBconfig_for_all_maps\fR the script will generate \fIconfig.bar\fR
+even for those map files which are present in a cfg file, but deactivated by a comment.
+.Sp
+The file \fIconfig.bar\fR is used when called by `dvips \-Pbar ...'. Thus it
+allows the activation of single map files even if they are not automatically
+activated via the updmap(\-sys) mechanism.
+.Sp
+Default is \fInot\fR to generate any config files.
+.SH "NOTES"
+.IX Header "NOTES"
+Note that this command is not idempotent. \*(L"dh_clean \-k\*(R" should be called
+between invocations of this command, unless using the \fB\-n\fR option. 
+Otherwise, it may cause multiple instances of the same text to be added 
+to maintainer scripts.
+.Sp
+Please refer to the Debian TeX policy for details about fonts configuration
+for TeX by Debian packages.
+.SH "SEE ALSO"
+.IX Header "SEE ALSO"
+\&\fIdebhelper\fR\|(7)
+.SH "AUTHOR"
+.IX Header "AUTHOR"
+Norbert Preining <preining at logic.at>

Copied: tex-common/trunk/scripts/dh_installtexfonts.pl (from rev 899, tex-common/trunk/scripts/dh_installtexfonts)




More information about the Pkg-tetex-commits mailing list