Bug#1089003: bundledoc.1: Some remarks and editorial changes for this man page
Package: texlive-extra-utils
Version: 2024.20241115-1
Severity: minor
Tags: patch
* What led up to the situation?
Checking for defects with
test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -ww -b -z < "man page"
[Use "groff -e ' $' <file>" to find trailing spaces.]
["test-groff" is a script in the repository for "groff"; is not shipped]
(local copy and "troff" slightly changed by me).
[The fate of "test-nroff" was decided in groff bug #55941.]
* What was the outcome of this action?
troff: backtrace: '<stdin>':10: macro 'Vb'
troff: backtrace: file '<stdin>':171
troff:<stdin>:171: warning: font name 'CW' is deprecated
Bad use of \s0 in a string definition, the string "X" could be resized,
for example with "\s-1\*X\s0".
25:.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
* What outcome did you expect instead?
No output (no warnings).
-.-
General remarks and further material, if a diff-file exist, are in the
attachments.
-- System Information:
Debian Release: trixie/sid
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 6.11.10-amd64 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages texlive-extra-utils depends on:
ii libfile-homedir-perl 1.006-2
ii libunicode-linebreak-perl 0.0.20190101-1+b8
ii libyaml-tiny-perl 1.74-1
ii python3 3.12.6-1
ii tex-common 6.18
ii texlive-base 2024.20241115-1
ii texlive-binaries 2024.20240313.70630+ds-5
ii texlive-latex-base 2024.20241115-1
ii texlive-luatex 2024.20241115-1
ii texlive-plain-generic 2024.20241115-1
Versions of packages texlive-extra-utils recommends:
ii ghostscript 10.04.0~dfsg-1
pn liblog-log4perl-perl <none>
ii ruby 1:3.1+nmu1
ii texlive-latex-recommended 2024.20241115-1
Versions of packages texlive-extra-utils suggests:
pn chktex <none>
pn default-jre-headless <none>
pn dvidvi <none>
pn dvipng <none>
pn fragmaster <none>
pn lacheck <none>
pn latexdiff <none>
pn latexmk <none>
pn purifyeps <none>
pn xindy <none>
Versions of packages tex-common depends on:
ii ucf 3.0043+nmu1
Versions of packages tex-common suggests:
pn debhelper <none>
Versions of packages texlive-extra-utils is related to:
ii tex-common 6.18
ii texlive-binaries 2024.20240313.70630+ds-5
-- no debconf information
Input file is bundledoc.1
Any program (person), that produces man pages, should check the output
for defects by using (both groff and nroff)
[gn]roff -mandoc -t -ww -b -z -K utf8 <man page>
The same goes for man pages that are used as an input.
For a style guide use
mandoc -T lint
-.-
So any 'generator' should check its products with the above mentioned
'groff', 'mandoc', and additionally with 'nroff ...'.
This is just a simple quality control measure.
The 'generator' may have to be corrected to get a better man page,
the source file may, and any additional file may.
Common defects:
Input text line longer than 80 bytes.
Not removing trailing spaces (in in- and output).
The reason for these trailing spaces should be found and eliminated.
Not beginning each input sentence on a new line.
Lines should thus be shorter.
See man-pages(7), item 'semantic newline'.
-.-
The difference between the formatted output of the original and patched file
can be seen with:
nroff -mandoc <file1> > <out1>
nroff -mandoc <file2> > <out2>
diff -u <out1> <out2>
and for groff, using
"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -mandoc -Z - "
instead of 'nroff -mandoc'
Add the option '-t', if the file contains a table.
Read the output of 'diff -u' with 'less -R' or similar.
-.-.
If 'man' (man-db) is used to check the manual for warnings,
the following must be set:
The option "-warnings=w"
The environmental variable:
export MAN_KEEP_STDERR=yes (or any non-empty value)
or
(produce only warnings):
export MANROFFOPT="-ww -b -z"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-.
Output from "mandoc -T lint bundledoc.1 ": (shortened list)
29 input text line longer than 80 bytes
-.-.
Output from "test-groff -mandoc -t -ww -b -z bundledoc.1 ": (shortened list)
1 font name 'CW' is deprecated
-.-.
Output from "mandoc -T lint bundledoc.1 ":
mandoc: bundledoc.1:180:94: STYLE: input text line longer than 80 bytes: The \f(CW\*(C`\eRequ...
mandoc: bundledoc.1:181:93: STYLE: input text line longer than 80 bytes: When \fBbundledoc\fR...
mandoc: bundledoc.1:182:87: STYLE: input text line longer than 80 bytes: dependent files \*(-...
mandoc: bundledoc.1:212:85: STYLE: input text line longer than 80 bytes: not the case, then u...
mandoc: bundledoc.1:231:83: STYLE: input text line longer than 80 bytes: While \f(CW\*(C`\-\-...
mandoc: bundledoc.1:232:85: STYLE: input text line longer than 80 bytes: directory tree to be...
mandoc: bundledoc.1:239:82: STYLE: input text line longer than 80 bytes: The \f(CW\*(C`\-\-in...
mandoc: bundledoc.1:249:82: STYLE: input text line longer than 80 bytes: something else, use ...
mandoc: bundledoc.1:256:83: STYLE: input text line longer than 80 bytes: as a comma-separated...
mandoc: bundledoc.1:258:84: STYLE: input text line longer than 80 bytes: If the list contains...
mandoc: bundledoc.1:259:83: STYLE: input text line longer than 80 bytes: dependencies with re...
mandoc: bundledoc.1:286:88: STYLE: input text line longer than 80 bytes: However, \f(CW\*(C`\...
mandoc: bundledoc.1:308:82: STYLE: input text line longer than 80 bytes: and it's easy to wri...
mandoc: bundledoc.1:338:81: STYLE: input text line longer than 80 bytes: for use by configura...
mandoc: bundledoc.1:341:100: STYLE: input text line longer than 80 bytes: is, when the command...
mandoc: bundledoc.1:362:84: STYLE: input text line longer than 80 bytes: The parentheses in t...
mandoc: bundledoc.1:366:100: STYLE: input text line longer than 80 bytes: Notice how the comma...
mandoc: bundledoc.1:367:85: STYLE: input text line longer than 80 bytes: environment variable...
mandoc: bundledoc.1:370:100: STYLE: input text line longer than 80 bytes: Windows-based TeX di...
mandoc: bundledoc.1:373:84: STYLE: input text line longer than 80 bytes: The value for \f(CW\...
mandoc: bundledoc.1:374:98: STYLE: input text line longer than 80 bytes: for \f(CW\*(C`find:\...
mandoc: bundledoc.1:375:83: STYLE: input text line longer than 80 bytes: the most opportunity...
mandoc: bundledoc.1:453:117: STYLE: input text line longer than 80 bytes: The \f(CW\*(C`\-\-lo...
mandoc: bundledoc.1:454:101: STYLE: input text line longer than 80 bytes: control over the arc...
mandoc: bundledoc.1:462:86: STYLE: input text line longer than 80 bytes: If \f(CW\*(C`\-\-loc...
mandoc: bundledoc.1:465:82: STYLE: input text line longer than 80 bytes: For each \f(CW\*(C`\...
mandoc: bundledoc.1:468:86: STYLE: input text line longer than 80 bytes: For each \f(CW\*(C`\...
mandoc: bundledoc.1:477:91: STYLE: input text line longer than 80 bytes: Rename \fIbundledoc\...
mandoc: bundledoc.1:513:82: STYLE: input text line longer than 80 bytes: send it to me at the...
-.-.
Split lines longer than 80 characters into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause; after punctuation marks.
N.B.
The number of lines affected can be too large to be in a patch.
Line 107, length 91
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
Line 109, length 84
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
Line 180, length 94
The \f(CW\*(C`\eRequirePackage{snapshot}\*(C'\fR causes a \fIhello.dep\fR file to be produced.
Line 181, length 93
When \fBbundledoc\fR is then given \f(CW\*(C`hello.dep\*(C'\fR as an argument, it locates the
Line 182, length 87
dependent files \*(-- \fIsnapshot.sty\fR, \fIarticle.cls\fR, and \fIsize11.clo\fR \*(--
Line 191, length 81
\&\fBsnapshot\fR, normally \fIsomefile\fR\fI.dep\fR). (For convenience, the file
Line 201, length 91
.ie n .IP "\fB\-\-\fR[\fBno\fR]\fBverbose\fR (default: ""noverbose"")" 4
Line 202, length 93
.el .IP "\fB\-\-\fR[\fBno\fR]\fBverbose\fR (default: \f(CWnoverbose\fR)" 4
Line 206, length 93
.IP "\fB\-\-texfile\fR=\fImain .tex file\fR (default: \fIsomefile\fR\fI.tex\fR)" 4
Line 212, length 85
not the case, then use \f(CW\*(C`\-\-texfile\*(C'\fR to specify the correct filename.
Line 213, length 83
.IP "\fB\-\-directory\fR=\fIarchive directory\fR (default: \fIsomefile\fR)" 4
Line 222, length 93
.ie n .IP "\fB\-\-\fR[\fBno\fR]\fBlocalonly\fR (default: ""nolocalonly"")" 4
Line 223, length 95
.el .IP "\fB\-\-\fR[\fBno\fR]\fBlocalonly\fR (default: \f(CWnolocalonly\fR)" 4
Line 226, length 94
\&\fI.dep\fR file, the \f(CW\*(C`\-\-localonly\*(C'\fR option tells \fBbundledoc\fR to exclude
Line 231, length 83
While \f(CW\*(C`\-\-localonly\*(C'\fR causes files outside of the \fI.tex\fR file's
Line 232, length 85
directory tree to be omitted from the archive, \f(CW\*(C`\-\-exclude\*(C'\fR provides
Line 234, length 88
\&\f(CW\*(C`\-\-exclude\*(C'\fR option, which can be specified repeatedly on the command
Line 239, length 82
The \f(CW\*(C`\-\-include\*(C'\fR option, which can be specified repeatedly on the
Line 243, length 90
.IP "\fB\-\-manifest\fR=\fImanifest file\fR (default: \fI\s-1MANIFEST\s0\fR)" 4
Line 249, length 82
something else, use the \f(CW\*(C`\-\-manifest\*(C'\fR option. As a special case,
Line 250, length 91
\&\f(CW\*(C`\-\-manifest=""\*(C'\fR tells \fBbundledoc\fR not to include a manifest file at
Line 255, length 149
\&\f(CW\*(C`\-\-listdeps\*(C'\fR accepts one or more of \f(CW\*(C`yes\*(C'\fR, \f(CW\*(C`no\*(C'\fR, \f(CW\*(C`only\*(C'\fR, or \f(CW\*(C`rel\*(C'\fR
Line 256, length 83
as a comma-separated list. As long as \f(CW\*(C`no\*(C'\fR does not appear in this
Line 258, length 84
If the list contains \f(CW\*(C`rel\*(C'\fR, then \fBbundledoc\fR outputs the list of
Line 259, length 83
dependencies with relative pathnames. If the list contains \f(CW\*(C`only\*(C'\fR,
Line 262, length 92
.ie n .IP "\fB\-\-\fR[\fBno\fR]\fBkeepdirs\fR (default: ""nokeepdirs"")" 4
Line 263, length 94
.el .IP "\fB\-\-\fR[\fBno\fR]\fBkeepdirs\fR (default: \f(CWnokeepdirs\fR)" 4
Line 268, length 86
\&\f(CW\*(C`\-\-keepdirs\*(C'\fR is specified, all the dependent files are stored with
Line 286, length 88
However, \f(CW\*(C`\-\-keepdirs\*(C'\fR will cause the \fIsomefile\fR archive to contain
Line 299, length 99
\&\f(CW\*(C`\-\-directory\*(C'\fR is not used when \f(CW\*(C`\-\-keepdirs\*(C'\fR is in effect. In
Line 308, length 82
and it's easy to write more. See \*(L"\s-1CONFIGURATION FILES\*(R"\s0 (below) for
Line 316, length 89
\&\f(CW\*(C`#\*(C'\fR are comments. Blank lines are ignored. All other lines are of the
Line 338, length 81
for use by configuration-file commands: \f(CW\*(C`BDBASE\*(C'\fR, which is set to
Line 339, length 100
\&\fIsomefile\fR (as in \*(L"\s-1OPTIONS\*(R"\s0), and \f(CW\*(C`BDINPUTS\*(C'\fR, which is set to a
Line 341, length 100
is, when the command associated with \f(CW\*(C`bundle\*(C'\fR is running, \f(CW\*(C`BDINPUTS\*(C'\fR
Line 362, length 84
The parentheses in the \f(CW\*(C`bundle:\*(C'\fR line tell the Unix shell to run the
Line 366, length 100
Notice how the commands treat \f(CW\*(C`BDBASE\*(C'\fR and \f(CW\*(C`BDINPUTS\*(C'\fR like any other
Line 367, length 85
environment variables in a Unix shell, using \f(CW\*(C`$\*(C'\fR to take their value.
Line 370, length 100
Windows-based TeX distribution would use \f(CW\*(C`%BDBASE%\*(C'\fR and \f(CW\*(C`%BDINPUTS%\*(C'\fR
Line 373, length 84
The value for \f(CW\*(C`sink:\*(C'\fR is specific to an operating system. The value
Line 374, length 98
for \f(CW\*(C`find:\*(C'\fR is specific to a TeX distribution. \f(CW\*(C`bundle:\*(C'\fR is where
Line 375, length 83
the most opportunity for customization lies. You can use \f(CW\*(C`bundle:\*(C'\fR
Line 409, length 86
\&\*(L".fd\*(R" or \*(L".sty\*(R" in their names are omitted. However, all \fI.bib\fR
Line 453, length 117
The \f(CW\*(C`\-\-localonly\*(C'\fR, \f(CW\*(C`\-\-exclude\*(C'\fR, and \f(CW\*(C`\-\-include\*(C'\fR options provide
Line 454, length 101
control over the archive's contents. \f(CW\*(C`\-\-exclude\*(C'\fR and \f(CW\*(C`\-\-include\*(C'\fR
Line 462, length 86
If \f(CW\*(C`\-\-localonly\*(C'\fR is specified, all files not found in the \fI.tex\fR
Line 465, length 82
For each \f(CW\*(C`\-\-exclude\*(C'\fR string specified, all files containing that
Line 468, length 86
For each \f(CW\*(C`\-\-include\*(C'\fR file specification, the set of files designated
Line 477, length 91
Rename \fIbundledoc\fR to \fIbundledoc.pl\fR and run \f(CW\*(C`bundledoc.pl\*(C'\fR. (This
Line 513, length 82
send it to me at the address listed in \*(L"\s-1AUTHOR\*(R"\s0 so I can include it
Line 529, length 105
\&\f(CW\*(C`\-\-exclude\*(C'\fR and \f(CW\*(C`\-\-include\*(C'\fR options; to Marius Kleiner for updating
Line 536, length 111
\&\fBarlatex\fR\|(1), \fBgzip\fR\|(1), \fBkpsewhich\fR\|(1), \fBlatex\fR\|(1), \fBperl\fR\|(1), \fBzip\fR\|(1),
-.-.
Do not use "\s0" in a string definition but an absolute number,
as the size of the string could be changed.
Then a situation of "\s+X...\s+Y...\s0...\s0" could emerge.
Type size changes have an effect in "troff", but not in "nroff".
25:.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
-.-.
Add a zero (0) in front of a decimal fraction that begins with a period
(.)
6:.if t .sp .5v
77:. ds #V .8m
78:. ds #F .3m
84:. ds #V .6m
-.-.
Output from "test-groff -mandoc -t -K utf8 -rF0 -rHY=0 -ww -b -z ":
troff: backtrace: '<stdin>':10: macro 'Vb'
troff: backtrace: file '<stdin>':171
troff:<stdin>:171: warning: font name 'CW' is deprecated
Bad use of \s0 in a string definition, the string "X" could be resized,
for example with "\s-1\*X\s0".
25:.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
-.-
Change font name 'CW' to 'CR' for groff command and compatible in macro 'Vb'
--- bundledoc.1 2024-12-04 02:44:10.013548143 +0000
+++ bundledoc.1.new 2024-12-04 03:16:37.132821366 +0000
@@ -3,11 +3,12 @@
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
+.if t .sp 0.5v
.if n .sp
..
.de Vb \" Begin verbatim text
-.ft CW
+. ie \\n(.g .ft CR
+. el .ft CW
.nf
.ne \\$1
..
@@ -22,7 +23,7 @@
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s+2\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
. ds PI pi
@@ -74,14 +75,14 @@
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
-. ds #V .8m
-. ds #F .3m
+. ds #V 0.8m
+. ds #F 0.3m
. ds #[ \f1
. ds #] \fP
.\}
.if t \{\
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
-. ds #V .6m
+. ds #V 0.6m
. ds #F 0
. ds #[ \&
. ds #] \&
@@ -177,8 +178,10 @@ As the simplest example possible, consid
\& \eend{document}
.Ve
.PP
-The \f(CW\*(C`\eRequirePackage{snapshot}\*(C'\fR causes a \fIhello.dep\fR file to be produced.
-When \fBbundledoc\fR is then given \f(CW\*(C`hello.dep\*(C'\fR as an argument, it locates the
+The
+\f(CR\*(C`\eRequirePackage{snapshot}\*(C'\fP
+causes a \fIhello.dep\fR file to be produced.
+When \fBbundledoc\fR is then given \f(CR\*(C`hello.dep\*(C'\fR as an argument, it locates the
dependent files \*(-- \fIsnapshot.sty\fR, \fIarticle.cls\fR, and \fIsize11.clo\fR \*(--
and bundles them into a single archive file, along with \fIhello.tex\fR and a
\&\fI\s-1MANIFEST\s0\fR file (described in \*(L"\s-1OPTIONS\*(R"\s0, below).
@@ -199,17 +202,17 @@ of the remaining options.
.IX Item "--help"
Give a brief usage message. This overrides all of the remaining options.
.ie n .IP "\fB\-\-\fR[\fBno\fR]\fBverbose\fR (default: ""noverbose"")" 4
-.el .IP "\fB\-\-\fR[\fBno\fR]\fBverbose\fR (default: \f(CWnoverbose\fR)" 4
+.el .IP "\fB\-\-\fR[\fBno\fR]\fBverbose\fR (default: \f(CRnoverbose\fR)" 4
.IX Item "--[no]verbose (default: noverbose)"
\&\fBbundledoc\fR normally does not output anything except error messages.
-With \f(CW\*(C`\-\-verbose\*(C'\fR, it outputs copious status messages.
+With \f(CR\*(C`\-\-verbose\*(C'\fR, it outputs copious status messages.
.IP "\fB\-\-texfile\fR=\fImain .tex file\fR (default: \fIsomefile\fR\fI.tex\fR)" 4
.IX Item "--texfile=main .tex file (default: somefile.tex)"
\&\fBsnapshot\fR's dependency file does not list the main LaTeX file (the
one that gets passed to \fBlatex\fR). In order for \fBbundledoc\fR to find
and bundle that file, \fBbundledoc\fR assumes it has the same name as the
\&\fBsnapshot\fR dependency file but with a \fI.tex\fR extension. If this is
-not the case, then use \f(CW\*(C`\-\-texfile\*(C'\fR to specify the correct filename.
+not the case, then use \f(CR\*(C`\-\-texfile\*(C'\fR to specify the correct filename.
.IP "\fB\-\-directory\fR=\fIarchive directory\fR (default: \fIsomefile\fR)" 4
.IX Item "--directory=archive directory (default: somefile)"
When \fBbundledoc\fR creates an archive (e.g., a \fI.tar\fR or \fI.zip\fR file)
@@ -218,25 +221,25 @@ avoid cluttering the current directory w
dependency file is called \fIsomefile\fR\fI.dep\fR then the resulting
archive will, by default, store all the dependent files in a
\&\fIsomefile\fR directory. To change the directory name use the
-\&\f(CW\*(C`\-\-directory\*(C'\fR option.
+\&\f(CR\*(C`\-\-directory\*(C'\fR option.
.ie n .IP "\fB\-\-\fR[\fBno\fR]\fBlocalonly\fR (default: ""nolocalonly"")" 4
-.el .IP "\fB\-\-\fR[\fBno\fR]\fBlocalonly\fR (default: \f(CWnolocalonly\fR)" 4
+.el .IP "\fB\-\-\fR[\fBno\fR]\fBlocalonly\fR (default: \f(CRnolocalonly\fR)" 4
.IX Item "--[no]localonly (default: nolocalonly)"
Although \fBbundledoc\fR normally archives all of the files named in the
-\&\fI.dep\fR file, the \f(CW\*(C`\-\-localonly\*(C'\fR option tells \fBbundledoc\fR to exclude
+\&\fI.dep\fR file, the \f(CR\*(C`\-\-localonly\*(C'\fR option tells \fBbundledoc\fR to exclude
all files located in a directory other than the \fI.tex\fR file's
directory or one of its subdirectories.
.IP "\fB\-\-exclude\fR=\fIstring\fR (default: \fInone\fR)" 4
.IX Item "--exclude=string (default: none)"
-While \f(CW\*(C`\-\-localonly\*(C'\fR causes files outside of the \fI.tex\fR file's
-directory tree to be omitted from the archive, \f(CW\*(C`\-\-exclude\*(C'\fR provides
+While \f(CR\*(C`\-\-localonly\*(C'\fR causes files outside of the \fI.tex\fR file's
+directory tree to be omitted from the archive, \f(CR\*(C`\-\-exclude\*(C'\fR provides
finer-grained control over files to omit from the archive. The
-\&\f(CW\*(C`\-\-exclude\*(C'\fR option, which can be specified repeatedly on the command
+\&\f(CR\*(C`\-\-exclude\*(C'\fR option, which can be specified repeatedly on the command
line, causes all files whose name contains \fIstring\fR to be omitted
from the archive.
.IP "\fB\-\-include\fR=\fIfilespec\fR (default: \fInone\fR)" 4
.IX Item "--include=filespec (default: none)"
-The \f(CW\*(C`\-\-include\*(C'\fR option, which can be specified repeatedly on the
+The \f(CR\*(C`\-\-include\*(C'\fR option, which can be specified repeatedly on the
command line, instructs \fBbundledoc\fR to include in the archive all of
the files matching \fIfilespec\fR, even if they're not referenced in the
\&\fI.dep\fR file.
@@ -246,26 +249,26 @@ In addition to the dependent files, \fBb
archive file one extra file called, by default, ``\fI\s-1MANIFEST\s0\fR''.
\&\fI\s-1MANIFEST\s0\fR is a text file that lists the original filenames of all
the dependencies. To change the filename from ``\fI\s-1MANIFEST\s0\fR'' to
-something else, use the \f(CW\*(C`\-\-manifest\*(C'\fR option. As a special case,
-\&\f(CW\*(C`\-\-manifest=""\*(C'\fR tells \fBbundledoc\fR not to include a manifest file at
+something else, use the \f(CR\*(C`\-\-manifest\*(C'\fR option. As a special case,
+\&\f(CR\*(C`\-\-manifest=""\*(C'\fR tells \fBbundledoc\fR not to include a manifest file at
all.
.ie n .IP "\fB\-\-listdeps\fR=[yes|no|only|rel]...] (default: ""no"")" 4
-.el .IP "\fB\-\-listdeps\fR=[yes|no|only|rel]...] (default: \f(CWno\fR)" 4
+.el .IP "\fB\-\-listdeps\fR=[yes|no|only|rel]...] (default: \f(CRno\fR)" 4
.IX Item "--listdeps=[yes|no|only|rel]...] (default: no)"
-\&\f(CW\*(C`\-\-listdeps\*(C'\fR accepts one or more of \f(CW\*(C`yes\*(C'\fR, \f(CW\*(C`no\*(C'\fR, \f(CW\*(C`only\*(C'\fR, or \f(CW\*(C`rel\*(C'\fR
-as a comma-separated list. As long as \f(CW\*(C`no\*(C'\fR does not appear in this
+\&\f(CR\*(C`\-\-listdeps\*(C'\fR accepts one or more of \f(CR\*(C`yes\*(C'\fR, \f(CR\*(C`no\*(C'\fR, \f(CR\*(C`only\*(C'\fR, or \f(CR\*(C`rel\*(C'\fR
+as a comma-separated list. As long as \f(CR\*(C`no\*(C'\fR does not appear in this
list, \fBbundledoc\fR outputs all of the main LaTeX file's dependencies.
-If the list contains \f(CW\*(C`rel\*(C'\fR, then \fBbundledoc\fR outputs the list of
-dependencies with relative pathnames. If the list contains \f(CW\*(C`only\*(C'\fR,
+If the list contains \f(CR\*(C`rel\*(C'\fR, then \fBbundledoc\fR outputs the list of
+dependencies with relative pathnames. If the list contains \f(CR\*(C`only\*(C'\fR,
then \fBbundledoc\fR exits after displaying the list, without producing
an archive.
.ie n .IP "\fB\-\-\fR[\fBno\fR]\fBkeepdirs\fR (default: ""nokeepdirs"")" 4
-.el .IP "\fB\-\-\fR[\fBno\fR]\fBkeepdirs\fR (default: \f(CWnokeepdirs\fR)" 4
+.el .IP "\fB\-\-\fR[\fBno\fR]\fBkeepdirs\fR (default: \f(CRnokeepdirs\fR)" 4
.IX Item "--[no]keepdirs (default: nokeepdirs)"
Normally, the archive file that \fBbundledoc\fR produces contains a
single directory \*(-- and subdirectories, if the document refers
explicitly to them \*(-- in which all the dependent files lie. If
-\&\f(CW\*(C`\-\-keepdirs\*(C'\fR is specified, all the dependent files are stored with
+\&\f(CR\*(C`\-\-keepdirs\*(C'\fR is specified, all the dependent files are stored with
their original pathnames. For example, if \fIsomefile.tex\fR depends on
\&\fIfigures/somefigure.eps\fR, \fIarticle.cls\fR, and \fIsnapshot.sty\fR, then
the \fIsomefile\fR archive will normally contain the following files:
@@ -283,7 +286,7 @@ the \fIsomefile\fR archive will normally
.RE
.RS 4
.Sp
-However, \f(CW\*(C`\-\-keepdirs\*(C'\fR will cause the \fIsomefile\fR archive to contain
+However, \f(CR\*(C`\-\-keepdirs\*(C'\fR will cause the \fIsomefile\fR archive to contain
the following sorts of filenames instead:
.IP "\(bu" 4
\&\fIhome/me/mydocs/somefile.tex\fR
@@ -296,13 +299,13 @@ the following sorts of filenames instead
.RE
.RS 4
.Sp
-\&\f(CW\*(C`\-\-directory\*(C'\fR is not used when \f(CW\*(C`\-\-keepdirs\*(C'\fR is in effect. In
+\&\f(CR\*(C`\-\-directory\*(C'\fR is not used when \f(CR\*(C`\-\-keepdirs\*(C'\fR is in effect. In
addition, no manifest file is written to the archive file as it
contains redundant information.
.RE
.IP "\fB\-\-config\fR=\fIconfiguration file\fR (default: <none>)" 4
.IX Item "--config=configuration file (default: <none>)"
-The \f(CW\*(C`\-\-config\*(C'\fR option is used to point \fBbundledoc\fR to the
+The \f(CR\*(C`\-\-config\*(C'\fR option is used to point \fBbundledoc\fR to the
appropriate configuration (\fI.cfg\fR) file for your TeX distribution and
operating system. \fBbundledoc\fR comes with a few configuration files
and it's easy to write more. See \*(L"\s-1CONFIGURATION FILES\*(R"\s0 (below) for
@@ -313,7 +316,7 @@ file can be specified without its \fI.cf
.SS "Format"
.IX Subsection "Format"
Configuration files follow a fairly simple format. Lines beginning with
-\&\f(CW\*(C`#\*(C'\fR are comments. Blank lines are ignored. All other lines are of the
+\&\f(CR\*(C`#\*(C'\fR are comments. Blank lines are ignored. All other lines are of the
form:
.PP
.Vb 1
@@ -332,16 +335,16 @@ The affix to a command to discard its ou
The command to find a file within the TeX tree(s).
.PP
Values that are too long for one line can be split across multiple lines
-by using \f(CW\*(C`\e\*(C'\fR as the line-continuation symbol.
+by using \f(CR\*(C`\e\*(C'\fR as the line-continuation symbol.
.PP
There are two environment variables that \fBbundledoc\fR makes available
-for use by configuration-file commands: \f(CW\*(C`BDBASE\*(C'\fR, which is set to
-\&\fIsomefile\fR (as in \*(L"\s-1OPTIONS\*(R"\s0), and \f(CW\*(C`BDINPUTS\*(C'\fR, which is set to a
+for use by configuration-file commands: \f(CR\*(C`BDBASE\*(C'\fR, which is set to
+\&\fIsomefile\fR (as in \*(L"\s-1OPTIONS\*(R"\s0), and \f(CR\*(C`BDINPUTS\*(C'\fR, which is set to a
space-separated list of files that a command is to operate upon. That
-is, when the command associated with \f(CW\*(C`bundle\*(C'\fR is running, \f(CW\*(C`BDINPUTS\*(C'\fR
+is, when the command associated with \f(CR\*(C`bundle\*(C'\fR is running, \f(CR\*(C`BDINPUTS\*(C'\fR
contains the list of all the files that are to be archived. In
-contrast, when the command associated with \f(CW\*(C`find\*(C'\fR is running,
-\&\f(CW\*(C`BDINPUTS\*(C'\fR contains the name of the file to search for.
+contrast, when the command associated with \f(CR\*(C`find\*(C'\fR is running,
+\&\f(CR\*(C`BDINPUTS\*(C'\fR contains the name of the file to search for.
.SS "Examples"
.IX Subsection "Examples"
The following configuration file parallels \fBbundledoc\fR's default
@@ -359,20 +362,20 @@ or \s-1GNU\s0 \fBtar\fR:
\& find: kpsewhich \-progname=latex $BDINPUTS
.Ve
.PP
-The parentheses in the \f(CW\*(C`bundle:\*(C'\fR line tell the Unix shell to run the
-command in a subshell. This is to make the \f(CW\*(C`sink:\*(C'\fR affix work
-properly (i.e., so there aren't two \f(CW\*(C`>\*(C'\fR's in the same command).
+The parentheses in the \f(CR\*(C`bundle:\*(C'\fR line tell the Unix shell to run the
+command in a subshell. This is to make the \f(CR\*(C`sink:\*(C'\fR affix work
+properly (i.e., so there aren't two \f(CR\*(C`>\*(C'\fR's in the same command).
.PP
-Notice how the commands treat \f(CW\*(C`BDBASE\*(C'\fR and \f(CW\*(C`BDINPUTS\*(C'\fR like any other
-environment variables in a Unix shell, using \f(CW\*(C`$\*(C'\fR to take their value.
+Notice how the commands treat \f(CR\*(C`BDBASE\*(C'\fR and \f(CR\*(C`BDINPUTS\*(C'\fR like any other
+environment variables in a Unix shell, using \f(CR\*(C`$\*(C'\fR to take their value.
Other operating systems use different conventions for referring to
environment variables. For instance, a configuration file for a
-Windows-based TeX distribution would use \f(CW\*(C`%BDBASE%\*(C'\fR and \f(CW\*(C`%BDINPUTS%\*(C'\fR
+Windows-based TeX distribution would use \f(CR\*(C`%BDBASE%\*(C'\fR and \f(CR\*(C`%BDINPUTS%\*(C'\fR
instead.
.PP
-The value for \f(CW\*(C`sink:\*(C'\fR is specific to an operating system. The value
-for \f(CW\*(C`find:\*(C'\fR is specific to a TeX distribution. \f(CW\*(C`bundle:\*(C'\fR is where
-the most opportunity for customization lies. You can use \f(CW\*(C`bundle:\*(C'\fR
+The value for \f(CR\*(C`sink:\*(C'\fR is specific to an operating system. The value
+for \f(CR\*(C`find:\*(C'\fR is specific to a TeX distribution. \f(CR\*(C`bundle:\*(C'\fR is where
+the most opportunity for customization lies. You can use \f(CR\*(C`bundle:\*(C'\fR
to specify your favorite archive format. For example, you can produce
a shar file on Unix with something like:
.PP
@@ -445,13 +448,13 @@ files; older version of MikTeX required
This is a variant of \fItexlive\-unix.cfg\fR that uses \fBarlatex\fR instead
of \fBgzip\fR to archive files. \fBarlatex\fR is a script included in the
\&\fBbundledoc\fR distribution that generates a self-extracting \fI.tex\fR
-file based on LaTeX's \f(CW\*(C`filecontents\*(C'\fR environment.
+file based on LaTeX's \f(CR\*(C`filecontents\*(C'\fR environment.
.SH "NOTES"
.IX Header "NOTES"
.SS "Including and excluding files"
.IX Subsection "Including and excluding files"
-The \f(CW\*(C`\-\-localonly\*(C'\fR, \f(CW\*(C`\-\-exclude\*(C'\fR, and \f(CW\*(C`\-\-include\*(C'\fR options provide
-control over the archive's contents. \f(CW\*(C`\-\-exclude\*(C'\fR and \f(CW\*(C`\-\-include\*(C'\fR
+The \f(CR\*(C`\-\-localonly\*(C'\fR, \f(CR\*(C`\-\-exclude\*(C'\fR, and \f(CR\*(C`\-\-include\*(C'\fR options provide
+control over the archive's contents. \f(CR\*(C`\-\-exclude\*(C'\fR and \f(CR\*(C`\-\-include\*(C'\fR
can be specified repeatedly on the command line. The order in which
these options are specified is immaterial; \fBbundledoc\fR processes file
inclusions and exclusions in the following order:
@@ -459,26 +462,26 @@ inclusions and exclusions in the followi
All files referenced by the \fI.dep\fR file are added to the list of
files to archive.
.IP "2." 4
-If \f(CW\*(C`\-\-localonly\*(C'\fR is specified, all files not found in the \fI.tex\fR
+If \f(CR\*(C`\-\-localonly\*(C'\fR is specified, all files not found in the \fI.tex\fR
file's directory are removed from the list.
.IP "3." 4
-For each \f(CW\*(C`\-\-exclude\*(C'\fR string specified, all files containing that
+For each \f(CR\*(C`\-\-exclude\*(C'\fR string specified, all files containing that
string are removed from the list.
.IP "4." 4
-For each \f(CW\*(C`\-\-include\*(C'\fR file specification, the set of files designated
+For each \f(CR\*(C`\-\-include\*(C'\fR file specification, the set of files designated
by its expansion are added to the list.
.SS "Issues When Running Under Microsoft Windows"
.IX Subsection "Issues When Running Under Microsoft Windows"
First, because \fBbundledoc\fR is a Perl script, you should do one of the
following to run it under Windows:
.IP "\(bu" 4
-\&\f(CW\*(C`perl bundledoc\*(C'\fR
+\&\f(CR\*(C`perl bundledoc\*(C'\fR
.IP "\(bu" 4
-Rename \fIbundledoc\fR to \fIbundledoc.pl\fR and run \f(CW\*(C`bundledoc.pl\*(C'\fR. (This
+Rename \fIbundledoc\fR to \fIbundledoc.pl\fR and run \f(CR\*(C`bundledoc.pl\*(C'\fR. (This
is assuming you have a file association set up for \fI.pl\fR.)
.IP "\(bu" 4
Run the \fBpl2bat\fR script (if you have it) to convert \fIbundledoc\fR to
-\&\fIbundledoc.bat\fR, then run \f(CW\*(C`bundledoc\*(C'\fR.
+\&\fIbundledoc.bat\fR, then run \f(CR\*(C`bundledoc\*(C'\fR.
.PP
Second, Windows uses a multi-rooted filesystem (i.e., multiple drive
letters). I wouldn't be surprised if bad things were to happen if the
@@ -525,8 +528,8 @@ other common font formats, as well.
.SS "Acknowledgments"
.IX Subsection "Acknowledgments"
Thanks to Fabien Vignes-Tourneret for suggesting what became the
-\&\f(CW\*(C`\-\-localonly\*(C'\fR option and for a discussion that led to the
-\&\f(CW\*(C`\-\-exclude\*(C'\fR and \f(CW\*(C`\-\-include\*(C'\fR options; to Marius Kleiner for updating
+\&\f(CR\*(C`\-\-localonly\*(C'\fR option and for a discussion that led to the
+\&\f(CR\*(C`\-\-exclude\*(C'\fR and \f(CR\*(C`\-\-include\*(C'\fR options; to Marius Kleiner for updating
\&\fBbundledoc\fR to properly handle document subdirectories; and to Frank
Mittelbach for suggesting using Kpathsea to help find \fI.cfg\fR files
and to automatically append \fI.cfg\fR and \fI.dep\fR extensions if
Reply to: