Bug#1039977: kpsewhich.1: some remarks and editorial fixes for the manual
Package: texlive-binaries
Version: 2022.20220321.62855-5.1
Severity: minor
Tags: patch
Dear Maintainer,
here are some notes and a patch for the man page.
-.-.
The difference between the formatted outputs can be seen with:
nroff -man <file1> > <out1>
nroff -man <file2> > <out2>
diff -u <out1> <out2>
and for groff using
"groff -man -Z" instead of "nroff -man"
-.-.
Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a
name for an option.
35:.B -format
45:.BI -debug \ num
48:.BI -D \ num
53:.BI -dpi \ num
55:.BR -D.
57:.BI -engine \ string
62:.BI -expand-braces \ string
66:.BI -expand-path \ string
70:.BI -expand-var \ string
74:.BI -format \ name
78:.B -help
81:.B -help
84:.B -interactive
87:.BI -mktex \ fmt
93:.BI -mode \ string
100:.B -must-exist
103:.BI -no-mktex \ fmt
109:.BI -path \ string
113:.BI -progname \ string
117:.\" .BI -separator \ string
121:.\" .B -path
126:.BI -show-path \ name
130:.B -help
133:.BI -var-value \ variable
137:.B -version
-.-.
Find a repeated word
! 20 --> and
-.-.
Split a punctuation mark from a single argument for a two-font macro
55:.BR -D.
-.-.
Output from "test-nroff -man -b -ww -z -rCHECKSTYLE=3":
[ "test-groff" is a developmental version of "groff" ]
Input file is ./kpsewhich.1
Output from "test-groff -b -mandoc -dAD=l -rF0 -rHY=0 -t -w w -z -rSTYLECHECK=3":
an.tmac:<stdin>:55: style: .BR expects at least 2 arguments, got 1
Bad use of \s0 in a string definition, the string could get resized.
6:.if t .ds MF M\s-2ETAFONT\s0
13:.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
16:.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
-.-.
--- kpsewhich.1 2023-06-30 01:03:17.000000000 +0000
+++ kpsewhich.1.new 2023-06-30 01:31:07.000000000 +0000
@@ -3,21 +3,21 @@
.if n .ds MP MetaPost
.if t .ds MP MetaPost
.if n .ds MF Metafont
-.if t .ds MF M\s-2ETAFONT\s0
+.if t .ds MF M\s-2ETAFONT\s+2
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff
.el .ds OX TeX for nroff
.\" the same but obliqued
.\" BX definition must follow TX so BX can use TX
-.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
+.if t .ds BX \fRB\s-2IB\s+2\fP\*(TX
.if n .ds BX BibTeX
.\" LX definition must follow TX so LX can use TX
-.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
+.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s+2\\h'-0.15m'\\v'0.15v'\fP\*(TX
.if n .ds LX LaTeX
.\"=====================================================================
.SH NAME
-kpsewhich \- standalone path lookup and and expansion for kpathsea
+kpsewhich \- standalone path lookup and expansion for kpathsea
.SH SYNOPSIS
.B kpsewhich
.RI [ options ]
@@ -32,7 +32,7 @@ or manual
.B kpsewhich
is used as a standalone front-end of the kpathsea library that can be
used to examine variables and find files. When the
-.B -format
+.B \-format
option is not given, the search path used when looking for a file is
inferred from the name given, by looking for a known extension. If
no known extension is found, the search path for \*(TX source files is
@@ -42,99 +42,99 @@ used.
.B kpsewhich
accepts the following options:
.TP
-.BI -debug \ num
+.BI \-debug \ num
Set debugging flags.
.TP
-.BI -D \ num
+.BI \-D \ num
Use a base resolution of
.IR num ;
the default, set by the installer, is typically 600.
.TP
-.BI -dpi \ num
+.BI \-dpi \ num
As
-.BR -D.
+.BR \-D .
.TP
-.BI -engine \ string
+.BI \-engine \ string
Set
.I $engine
in the environment, which is used in some search paths.
.TP
-.BI -expand-braces \ string
+.BI \-expand-braces \ string
Print variable and brace expansion of
.IR string .
.TP
-.BI -expand-path \ string
+.BI \-expand-path \ string
Print complete path expansion of
.IR string .
.TP
-.BI -expand-var \ string
+.BI \-expand-var \ string
Print variable expansion of
.IR string .
.TP
-.BI -format \ name
+.BI \-format \ name
Use file type
.IR name .
See the info manual for a list of valid names, or use the
-.B -help
+.B \-help
option to print the list.
.TP
-.B -help
+.B \-help
Print help message and exit.
.TP
-.B -interactive
+.B \-interactive
Ask for additional filenames to look up.
.TP
-.BI -mktex \ fmt
+.BI \-mktex \ fmt
enable
.RI mktex fmt
generation.
.RI ( fmt =pk/mf/tex/tfm)
.TP
-.BI -mode \ string
+.BI \-mode \ string
Set device name for
.I $MAKETEX_MODE
to
.IR string ;
no default.
.TP
-.B -must-exist
+.B \-must-exist
Search the disk as well as ls-R if necessary.
.TP
-.BI -no-mktex \ fmt
+.BI \-no-mktex \ fmt
disable
.RI mktex fmt
generation.
.RI ( fmt =pk/mf/tex/tfm)
.TP
-.BI -path \ string
+.BI \-path \ string
Search in the path
.IR string .
.TP
-.BI -progname \ string
+.BI \-progname \ string
Set program name to
.IR string .
.\" .TP
-.\" .BI -separator \ string
+.\" .BI \-separator \ string
.\" .rb
.\" .I string
.\" separates components in
-.\" .B -path
+.\" .B \-path
.\" output; default is
.\" .I :
.\" on UNIX systems.
.TP
-.BI -show-path \ name
+.BI \-show-path \ name
Output search path for file type
.IR name .
See the info manual for a list of valid names, or use the
-.B -help
+.B \-help
option to print the list.
.TP
-.BI -var-value \ variable
+.BI \-var-value \ variable
Print the expansion of
.IR variable .
.TP
-.B -version
+.B \-version
Print version information and exit.
.\"=====================================================================
.SH "SEE ALSO"
-- System Information:
Debian Release: trixie/sid
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 6.3.7-1 (SMP w/2 CPU threads; PREEMPT)
Kernel taint flags: TAINT_WARN
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-binaries depends on:
ii libc6 2.36-9
ii libcairo2 1.16.0-7
ii libfontconfig1 2.14.1-4
ii libfreetype6 2.12.1+dfsg-5
ii libgcc-s1 13.1.0-6
ii libgraphite2-3 1.3.14-1
ii libharfbuzz0b 6.0.0+dfsg-3
ii libicu72 72.1-3
ii libkpathsea6 2022.20220321.62855-5.1
ii libmpfr6 4.2.0-1
ii libpaper1 1.1.29
ii libpixman-1-0 0.42.2-1
ii libpng16-16 1.6.39-2
ii libptexenc1 2022.20220321.62855-5.1
ii libstdc++6 13.1.0-6
ii libsynctex2 2022.20220321.62855-5.1
ii libteckit0 2.5.11+ds1-1+b1
ii libtexlua53-5 2022.20220321.62855-5.1
ii libtexluajit2 2022.20220321.62855-5.1
ii libx11-6 2:1.8.6-1
ii libxaw7 2:1.0.14-1
ii libxi6 2:1.8-1+b1
ii libxmu6 2:1.1.3-3
ii libxpm4 1:3.5.12-1.1
ii libxt6 1:1.2.1-1.1
ii libzzip-0-13 0.13.72+dfsg.1-1.1
ii perl 5.36.0-7
ii t1utils 1.41-4
ii tex-common 6.18
ii zlib1g 1:1.2.13.dfsg-1
Versions of packages texlive-binaries recommends:
pn dvisvgm <none>
ii texlive-base 2022.20230122-3
texlive-binaries suggests no packages.
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-binaries is related to:
ii tex-common 6.18
ii texlive-base 2022.20230122-3
-- no debconf information
Reply to: