Your message dated Wed, 15 Jan 2025 11:57:37 +0000 with message-id <E1tY21h-008Pmr-9y@fasolo.debian.org> and subject line Bug#1089003: fixed in texlive-extra 2024.20250114-1 has caused the Debian Bug report #1089003, regarding bundledoc.1: Some remarks and editorial changes for this man page to be marked as done. This means that you claim that the problem has been dealt with. If this is not the case it is now your responsibility to reopen the Bug report if necessary, and/or fix the problem forthwith. (NB: If you are a system administrator and have no idea what this message is talking about, this may indicate a serious mail system misconfiguration somewhere. Please contact owner@bugs.debian.org immediately.) -- 1089003: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1089003 Debian Bug Tracking System Contact owner@bugs.debian.org with problems
--- Begin Message ---
- To: Debian Bug Tracking System <submit@bugs.debian.org>
- Subject: bundledoc.1: Some remarks and editorial changes for this man page
- From: Bjarni Ingi Gislason <bjarniig@simnet.is>
- Date: Wed, 4 Dec 2024 03:28:59 +0000
- Message-id: <173328280820.6857.1756797876030832626.reportbug@kassi.invalid.is>
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 informationInput 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
--- End Message ---
--- Begin Message ---
- To: 1089003-close@bugs.debian.org
- Subject: Bug#1089003: fixed in texlive-extra 2024.20250114-1
- From: Debian FTP Masters <ftpmaster@ftp-master.debian.org>
- Date: Wed, 15 Jan 2025 11:57:37 +0000
- Message-id: <E1tY21h-008Pmr-9y@fasolo.debian.org>
- Reply-to: Hilmar Preuße <hille42@debian.org>
Source: texlive-extra Source-Version: 2024.20250114-1 Done: Hilmar Preuße <hille42@debian.org> We believe that the bug you reported is fixed in the latest version of texlive-extra, which is due to be installed in the Debian FTP archive. A summary of the changes between this version and the previous one is attached. Thank you for reporting the bug, which will now be closed. If you have further comments please address them to 1089003@bugs.debian.org, and the maintainer will reopen the bug report if appropriate. Debian distribution maintenance software pp. Hilmar Preuße <hille42@debian.org> (supplier of updated texlive-extra package) (This message was generated automatically at their request; if you believe that there is a problem with it please contact the archive administrators by mailing ftpmaster@ftp-master.debian.org) -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 Format: 1.8 Date: Wed, 15 Jan 2025 11:38:14 +0100 Source: texlive-extra Architecture: source Version: 2024.20250114-1 Distribution: unstable Urgency: medium Maintainer: Debian TeX Task Force <debian-tex-maint@lists.debian.org> Changed-By: Hilmar Preuße <hille42@debian.org> Closes: 1088732 1089003 Changes: texlive-extra (2024.20250114-1) unstable; urgency=medium . * New upstream snapshot. * Patches for manual pages from Bjarni Ingi Gislason <bjarniig@simnet.is> - arara.1 (Closes: #1088732) - bundledoc.1 (Closes: #1089003) Checksums-Sha1: 0c31bb01b50c139b395d6088db30953fd1dbf71b 4032 texlive-extra_2024.20250114-1.dsc ded6808320cdfaf6b4b277067a5d8a0afd9a7daf 19032 texlive-extra_2024.20250114.orig-tex4ht.tar.xz 68c5fa02538fbf950b4b0f1d4b4c5b784443b679 2745294736 texlive-extra_2024.20250114.orig.tar.xz 330d86a7a94be9820b0751901270ec97a7787ab2 202748 texlive-extra_2024.20250114-1.debian.tar.xz 35d42e06cb0f7443cd08b7acf749f38613d8fce2 5944 texlive-extra_2024.20250114-1_source.buildinfo Checksums-Sha256: d74aeca7096d11342e1730844541f1fa8b3731121058b5d219c449795cafbaaf 4032 texlive-extra_2024.20250114-1.dsc 40c3d6c0715590c041df400a62227216a60f0e15bda8666bc21ebd3345050543 19032 texlive-extra_2024.20250114.orig-tex4ht.tar.xz 018d4af2a790e50a1aa4c8b5485b564b263d95105d26ab5720f9e9a04bfc657a 2745294736 texlive-extra_2024.20250114.orig.tar.xz 5c05e8508f34530d66d36cdce128f0d04723d7bf605319f63dbf98498db32c55 202748 texlive-extra_2024.20250114-1.debian.tar.xz bff927341c7030d48b814b0e822c292abb773c6e5d0d20f04372767de50fcfab 5944 texlive-extra_2024.20250114-1_source.buildinfo Files: 4c090f1075b8c97d5305bc1dd5aec900 4032 tex optional texlive-extra_2024.20250114-1.dsc 8a87f246ccbe8a5f728ee7a2f4be32fd 19032 tex optional texlive-extra_2024.20250114.orig-tex4ht.tar.xz df1143f4d18e9205bc75eb01916fed50 2745294736 tex optional texlive-extra_2024.20250114.orig.tar.xz 4d6906e2b9a94b70677021492487e699 202748 tex optional texlive-extra_2024.20250114-1.debian.tar.xz af95bed0a16da145032d486484376954 5944 tex optional texlive-extra_2024.20250114-1_source.buildinfo -----BEGIN PGP SIGNATURE----- iQKTBAEBCgB9FiEEaXGmC/nkbIhxf16kxiZYRqvgLIsFAmeHmNRfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDY5 NzFBNjBCRjlFNDZDODg3MTdGNUVBNEM2MjY1ODQ2QUJFMDJDOEIACgkQxiZYRqvg LIsP1hAAxfDkvsRsFwP8NoP5lc9vgtkyoHmG7ggg3c7BJ8d7+L/T/Q49B2Gd/0YM JrDZGg1G9DvJPbDkYtETz9hsgfEYZfnjFAvMvTxn7kSGqBhujwMAh7LXvv+j5+jv 5gCz9MY6qIU+9uZd8g4Vle3aRUr5bfmBMZeJzHeAsU/XVJvFg1WWrUte6J7EJg2F O3l0lOs1kPE0vqx/8hisup86zQY7cadgLZWwZkYgZg+hXDkyxeJNt3U1hTkgl8SB /adPjIDkCjsHfyUkgYBjWyAhGXuYohvKhuWhWyfSdCQ8WHfrx/tlp+4S+ZSSRwmu DwtBL8i3exi0bf++iNDe1RPIDXngTytOhcAxizv1VbouTs6IDgpTxFUAQiF5mO9Y TOlJAmJio9Y+9xQiMFP2wCa3K8trZYeMn7B6EJTKeEgHJ7EPu41s/oPxr7jEUR/7 d71euFddUyyZpTHmJgavE/5nqgwALspxTkgDwd9tbheCv5DJoe/iFnFTa5kHBNFl iqPw+rKL5NJAyxklHJGzux5sBwZenMILX24mDngTcqv2scr2iSOsb0sPl51nUouP DRvUA7Dd2cLPZTwElmYCnpIIjlFtd3ow6vXyBcEv+SECYNtMuVDp+hGf1P7KSDvK 6srmfKBD5S1mwHWFq6YEyTl8K51j2EPc7rop2AsbcGwc4nq1fz8= =9isK -----END PGP SIGNATURE-----Attachment: pgpKudDJmzQT_.pgp
Description: PGP signature
--- End Message ---