[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#1072319: marked as done (ttf2pk.1: some remarks and editorial changes for this man page)

Your message dated Thu, 25 Jul 2024 10:51:38 +0000
with message-id <E1sWw4Q-00ELK1-19@fasolo.debian.org>
and subject line Bug#1072319: fixed in texlive-bin 2024.20240313.70630+ds-3
has caused the Debian Bug report #1072319,
regarding ttf2pk.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.)


-- 
1072319: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1072319
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message --- 
Package: texlive-binaries
Version: 2023.20230311.66589-9+b2
Severity: minor
Tags: patch

Dear Maintainer,

   * What led up to the situation?

     Checking for defects with

[test-][g|n]roff -mandoc -t -K utf8 -ww -b -z <man page>

  [test-groff is a script in the repository for "groff"]

   * What was the outcome of this action?

troff: backtrace: file '<stdin>':76
troff:<stdin>:76: warning: trailing space in the line
troff: backtrace: '<stdin>':55: macro 'C'

<following is a bug in troff>
troff: backtrace: file '<stdin>':253
troff:<stdin>:253: warning: ignoring font selection on interrupted line

   * What outcome did you expect instead?

     No output (warnings).

-,-

  Remarks and a patch are in the attachments.


-- System Information:
Debian Release: trixie/sid
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 6.7.12-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-binaries depends on:
ii  libc6            2.38-11
ii  libcairo2        1.18.0-3+b1
ii  libfontconfig1   2.15.0-1.1
ii  libfreetype6     2.13.2+dfsg-1+b4
ii  libgcc-s1        14-20240330-1
ii  libgraphite2-3   1.3.14-2
ii  libharfbuzz0b    8.3.0-2+b1
ii  libicu72         72.1-4+b1
ii  libkpathsea6     2023.20230311.66589-9+b2
ii  libmpfr6         4.2.1-1+b1
ii  libpaper1        1.1.29+b1
ii  libpixman-1-0    0.42.2-1+b1
ii  libpng16-16t64   1.6.43-5
ii  libpotrace0      1.16-2+b1
ii  libptexenc1      2023.20230311.66589-9+b2
ii  libstdc++6       14-20240330-1
ii  libsynctex2      2023.20230311.66589-9+b2
ii  libteckit0       2.5.12+ds1-1
ii  libtexlua53-5    2023.20230311.66589-9+b2
ii  libx11-6         2:1.8.7-1+b1
ii  libxaw7          2:1.0.14-1+b2
ii  libxi6           2:1.8.1-1
ii  libxmu6          2:1.1.3-3+b2
ii  libxpm4          1:3.5.17-1+b1
ii  libxt6t64        1:1.2.1-1.2
ii  libzzip-0-13t64  0.13.72+dfsg.1-1.2+b1
ii  perl             5.38.2-4
ii  t1utils          1.41-4
ii  tex-common       6.18
ii  zlib1g           1:1.3.dfsg+really1.3.1-1

Versions of packages texlive-binaries recommends:
pn  dvisvgm       <none>
ii  texlive-base  2023.20240207-1

Versions of packages texlive-binaries suggests:
pn  hintview               <none>
pn  texlive-binaries-sse2  <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-binaries is related to:
ii  tex-common    6.18
ii  texlive-base  2023.20240207-1

-- no debconf information

  Any program (person), that produces man pages, should check its content for
defects by using

groff -mandoc -t -ww -b -z [ -K utf8 | k ] <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' 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.

-.-

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

"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -man -Z - "

instead of "nroff -man"

  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 -z"

export MAN_KEEP_STDERR=yes (or any non-empty value)

-.-.

Output from "mandoc -T lint ttf2pk.1": (possibly shortened list)

mandoc: ttf2pk.1:76:69: STYLE: whitespace at end of input line

-.-.

Lines containing '\c':

95:Use only `\c
97:as the extension instead of `\c
98:.C \&. \c
99:.RI < \%resolution >\c
128:and the used file search library (e.g.\ \c
183:in map files\(em\c
236:with `\c
237:.BI \-r \ old-glyphname\ new-glyphname\c
239:are directly specified with `\c
251:For a description of subfonts (i.e., entries of the form `\c
252:.I <namestem>\c
253:.C @\c
254:.I <sfd-filename>\c

Remove space characters at the end of lines.

Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".

76:CJKV (Chinese/Japanese/Korean/old Vietnamese) subfonts as created by 

-.-.

Mark a full stop (.) and the exclamation mark (!) with "\&",
if it does not mean an end of a sentence.
This is a preventive action,
the paragraph could be reshaped, e.g., after changes.

When typing, one does not always notice when the line wraps after the
period.
There are too many examples of input lines in manual pages,
that end with an abbreviation point.

This marking is robust, and independent of the position on the line.

It corresponds to "\ " in TeX, and to "@:" in Texinfo.


98:.C \&. \c

-.-.

Add a (no-break, "\ " or "\~") space between a number and a unit,
as these are not one entity.

81:always assumes 10pt as the design size for the written \*(TX
123:The design size is always assumed to be 10pt.

-.-.

Use "\e" to print the escape character instead of "\\" (which gets
interpreted in copy mode).

273:You can use `\\' as the final character of a line to indicate that the

-.-.

Change a HYPHEN-MINUS (code 0x2D) to a minus(-dash) (\-),
if it
is in front of a name for an option,
is a symbol for standard input,
is a single character used to indicate an option,
or is in the NAME section (man-pages(7)).
N.B. - (0x2D), processed as a UTF-8 file, is changed to a hyphen
(0x2010, groff \[u2010] or \[hy]) in the output.

191:.C "ttf2tfm arial -p T1.enc -s 0.25 -P 1 -E 0 arials"

-.-.

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 "groff", but not in "nroff".

38:.ds LX \fRL\h'-0.36m'\v'-0.15v'\s-3A\s0\h'-0.15m'\v'0.15v'\fP\*(TX

-.-.

Output from "test-groff -b -mandoc -dAD=l -rF0 -rHY=0 -K utf8 -t -ww -z -K utf8":

troff: backtrace: file '<stdin>':76
troff:<stdin>:76: warning: trailing space in the line
troff: backtrace: '<stdin>':55: macro 'C'
troff: backtrace: file '<stdin>':253
troff:<stdin>:253: warning: ignoring font selection on interrupted line

Bad use of \s0 in a string definition, the string could be resized.

38:.ds LX \fRL\h'-0.36m'\v'-0.15v'\s-3A\s0\h'-0.15m'\v'0.15v'\fP\*(TX
39:.el .ds LX \fRL\h'-0.36m'\v'-0.22v'\s-2A\s0\h'-0.15m'\v'0.22v'\fP\*(TX


--- ttf2pk.1	2024-05-31 13:36:36.686567085 +0000
+++ ttf2pk.1.new	2024-05-31 22:32:34.572210190 +0000
@@ -35,8 +35,8 @@ ttf2pk \- convert a TrueType font into T
 .\" and here the same for \LaTeX
 .if t \{\
 .ie '\*(.T'dvi' \
-.ds LX \fRL\h'-0.36m'\v'-0.15v'\s-3A\s0\h'-0.15m'\v'0.15v'\fP\*(TX
-.el .ds LX \fRL\h'-0.36m'\v'-0.22v'\s-2A\s0\h'-0.15m'\v'0.22v'\fP\*(TX
+.ds LX \fRL\h'-0.36m'\v'-0.15v'\s-3A\s+3\h'-0.15m'\v'0.15v'\fP\*(TX
+.el .ds LX \fRL\h'-0.36m'\v'-0.22v'\s-2A\s+2\h'-0.15m'\v'0.22v'\fP\*(TX
 .\}
 .if n .ds LX LaTeX
 .
@@ -52,7 +52,7 @@ ttf2pk \- convert a TrueType font into T
 .\" a typewriter font
 .if t \{\
 .de C
-\fC\\$1\fP\\$2
+\f(CR\\$1\fP\\$2
 ..
 .\}
 .if n \{\
@@ -73,12 +73,12 @@ This program converts a TrueType font in
 file; the created font can then be used with \*(TX
 or \*(LX.
 .PP
-CJKV (Chinese/Japanese/Korean/old Vietnamese) subfonts as created by 
+CJKV (Chinese/Japanese/Korean/old Vietnamese) subfonts as created by
 .B ttf2tfm
 are also supported.
 .PP
 .B ttf2pk
-always assumes 10pt as the design size for the written \*(TX
+always assumes 10\~points (10pt) as the design size for the written \*(TX
 font.
 .
 .
@@ -120,7 +120,7 @@ to process the font.
 The resolution, given in dots per inch.
 Currently the horizontal resolution is equal to the vertical
 resolution.
-The design size is always assumed to be 10pt.
+The design size is always assumed to be 10\~points (10pt).
 .TP
 .B \-\^\-version
 Shows the current version of
@@ -188,7 +188,7 @@ map file.
 As an example, a call to
 .PP
 .in +2m
-.C "ttf2tfm arial -p T1.enc -s 0.25 -P 1 -E 0 arials"
+.C "ttf2tfm arial \-p T1.enc \-s 0.25 \-P 1 \-E 0 arials"
 .PP
 will produce the following line:
 .PP
@@ -209,27 +209,27 @@ parameters and the corresponding entries
 .PP
 .in +4m
 .ta 2i
--s	Slant
+\-s	Slant
 .br
--e	Extend
+\-e	Extend
 .br
--p	Encoding
+\-p	Encoding
 .br
--f	Fontindex
+\-f	Fontindex
 .br
--P	Pid
+\-P	Pid
 .br
--E	Eid
+\-E	Eid
 .br
--n	PS=Yes
+\-n	PS=Yes
 .br
--N	PS=Only
+\-N	PS=Only
 .br
--R	Replacement
+\-R	Replacement
 .br
--x	Rotate=Yes
+\-x	Rotate=Yes
 .br
--y	Y-Offset
+\-y	Y-Offset
 .PP
 Single replacement glyph names given to
 .B ttf2tfm
@@ -243,7 +243,7 @@ They will be ignored if in subfont mode
 One additional parameter in a map file is unique to
 .BR ttf2pk :
 `Hinting', which can take the values `On' or `Off'.
-Some fonts (e.g.\ the CJK part of
+Some fonts (e.g., the CJK part of
 .C \%cyberbit.ttf )
 are rendered incorrectly if hinting is activated.
 Default is `On' (you can also use `Yes', `No', `1', and `0').
@@ -270,7 +270,7 @@ command line is found, otherwise the pro
 Thus you can use any character invalid in a \*(TX
 font name to start a comment line.
 .PP
-You can use `\\' as the final character of a line to indicate that the
+You can use `\e' as the final character of a line to indicate that the
 input is continued on the next line.
 The backslash and the following newline character will be removed.
 .PP

--- End Message ---
--- Begin Message --- 
Source: texlive-bin
Source-Version: 2024.20240313.70630+ds-3
Done: Hilmar Preuße <hille42@debian.org>

We believe that the bug you reported is fixed in the latest version of
texlive-bin, 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 1072319@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-bin 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: Thu, 25 Jul 2024 12:03:11 +0200
Source: texlive-bin
Architecture: source
Version: 2024.20240313.70630+ds-3
Distribution: unstable
Urgency: medium
Maintainer: Debian TeX Task Force <debian-tex-maint@lists.debian.org>
Changed-By: Hilmar Preuße <hille42@debian.org>
Closes: 1072254 1072319 1075564
Changes:
 texlive-bin (2024.20240313.70630+ds-3) unstable; urgency=medium
 .
   [ Hilmar Preusse ]
   * Add patches for manual pages:
     - tex2aspc.1 (Closes: #1072254)
     - ttf2pk.1 (Closes: #1072319)
 .
   Add patch texlive-bin-20230311-typecasts.patch (from Fedora [1]) to
   make xdvik compatible to the old lbxaw package currently in Debian.
   Once libxaw >= 1.0.16 has entered Debian the patch needs to be
   disabled again (Closes: #1075564).
 .
   [1] https://src.fedoraproject.org/rpms/texlive-base/c/ef14236976cfb48e0fe4b2b3af14cdf3d0d64516?branch=rawhide
Checksums-Sha1:
 d0115621d626c157b12affc3899f8ee311e98811 3539 texlive-bin_2024.20240313.70630+ds-3.dsc
 8d61a4ac39bcb32786d2890667cb01effefb90e1 79160 texlive-bin_2024.20240313.70630+ds-3.debian.tar.xz
 e4ed4afb5202f50216ef9dc47f741d6666f92a15 6093 texlive-bin_2024.20240313.70630+ds-3_source.buildinfo
Checksums-Sha256:
 63329dc889f807f746a9bf0495b505da8cb488d620d7c098a6aa42bd6a0655f9 3539 texlive-bin_2024.20240313.70630+ds-3.dsc
 5fd1207c6b605d6552a04ce0d65ad46876d08f5291671655ce340e6008bb3318 79160 texlive-bin_2024.20240313.70630+ds-3.debian.tar.xz
 e5b9af0a731af972c365bc9360052600c62890dd993d331304555b1fcd2ce25d 6093 texlive-bin_2024.20240313.70630+ds-3_source.buildinfo
Files:
 5e0507dc23efdd5b05c86395d5df69fb 3539 tex optional texlive-bin_2024.20240313.70630+ds-3.dsc
 3fe73a4de36d214bd0d3e62d1ff3cbd8 79160 tex optional texlive-bin_2024.20240313.70630+ds-3.debian.tar.xz
 dcab85b1e568330eca5bb030514e2c43 6093 tex optional texlive-bin_2024.20240313.70630+ds-3_source.buildinfo

-----BEGIN PGP SIGNATURE-----

iQKTBAEBCgB9FiEEaXGmC/nkbIhxf16kxiZYRqvgLIsFAmaiI7xfFIAAAAAALgAo
aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDY5
NzFBNjBCRjlFNDZDODg3MTdGNUVBNEM2MjY1ODQ2QUJFMDJDOEIACgkQxiZYRqvg
LIuuXRAAg/ID144+3LT2o7JGWu/epziWpLT7Kwpa2Cx55Y7P3Mf2pX8FdPHAMriH
IyllDYzWLsnIdT72N5yLhbeil4njQBSKTpDNvXCLqnB23pxfVpqSHyryT/ORVcid
rd+11N/OL5XZTawsZgU5OH+95sC43KNG6/zFbCXAX7R7dCmcDpW9H1TTQQWwyDsl
R58sbj5tlkJjSyhP4oGa2O1Yp7ClbpNZ89Suc7tV8OnpbsGnNPxNTMoSacvheHhp
e3TGBBn1O16Dv9+1BJ89sRP0k/GN0jOuUsmHLL8JH6uDqB6SnbV2KfgsmTIGXDTK
dnehe+qlXXVQAKL647snXlpOHxP0WMKjePbR3ZsDR6qoqMv3qK+mabyw5528i9JT
IDBk9T0oxZdwQ9y9XGLUQMGWMxNitnMwRgkTsc7D1XlqslX8NkgPzOzvxmCqhmH/
dx9oaBSzxt7cqsds1PtLiKXTh112Yc1Y2Tf2Pf8LWrdywzU0luco+eW7QxWjYlSj
vgOuU2gIEeFCkHabYPdX2n31N7XehXlqY6X5Y69CZpFoamgGsgrs/M/A1mfBR0sU
cyyN27GJbTPp3JS+TjZoEmkcOycrCYEcVz1jwTls9HSYgo+212FJuxXmdxV7Xti+
0H0veSKW5M9rio/YhSu/F0B2WQjff4QTk4MSQIQSv6I6vr+GpmE=
=tthb
-----END PGP SIGNATURE-----

Attachment: pgpClDRjJWtb0.pgp
Description: PGP signature


--- End Message ---
Reply to: