Bug#900043: dt2dv.1: Some formatting fixes in the manual
Package: texlive-binaries
Version: 2018.20180416.47457-3+b1
Severity: minor
Tags: patch
Dear Maintainer,
* What led up to the situation?
Warning from "groff":
<dt2dv.1>:60 (macro IR): only 1 argument, but more are expected
Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z
["test-groff" is a developmental version of "groff"]
#####
Summary:
Split long lines (> 80).
Change ".X [abc]" to ".RX [ abc ]"
Change ".IR <one argument>" to ".I <one argument>"
Begin a sentence on a new line
Protect full stop (.) if it is not an end of a sentence
###
Details:
Input file is dt2dv.1
Test nr. 16:
Use the correct macro for the font change of one argument.
Split a punctuation mark from the only argument if one is there
60:.IR required
#####
Test nr. 41:
Wrong distance between sentences or protect the indicator.
1) Separate the sentences and subordinate clauses; each begins on a new
line. See man-pages(7) [package "manpages"] and "info groff".
Or
2) Adjust space between sentences (two spaces),
3) or protect the indicator by adding "\&" after it.
The "indicator" is an "end-of-sentence character" (.!?).
71:utility, back to a binary DVI file. DTL
87:Donald E. Knuth,
150:Nelson H. F. Beebe, Ph.D.
#####
Test nr. 42:
Split lines longer than 80 characters into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause.
dt2dv.1: line 3 length 193
.\" The author has expressed the hope that any modification will retain enough content to remain useful. He would also appreciate being acknowledged as the original author in the documentation.
dt2dv.1: line 4 length 92
.\" This declaration added 2008/11/14 by Clea F. Rees with the permission of Geoffrey Tobin.
#####
Patch:
--- dt2dv.1 2018-05-13 21:39:41.000000000 +0000
+++ dt2dv.1.new 2018-05-25 01:53:48.000000000 +0000
@@ -1,7 +1,10 @@
.\" This file is public domain.
.\" Originally written 1995, Geoffrey Tobin.
-.\" The author has expressed the hope that any modification will retain enough content to remain useful. He would also appreciate being acknowledged as the original author in the documentation.
-.\" This declaration added 2008/11/14 by Clea F. Rees with the permission of Geoffrey Tobin.
+.\" The author has expressed the hope that any modification will
+.\" retain enough content to remain useful. He would also appreciate being
+.\" acknowledged as the original author in the documentation.
+.\" This declaration added 2008/11/14 by Clea F. Rees with the
+.\" permission of Geoffrey Tobin.
.\" ====================================================================
.\" @Troff-man-file{
.\" author = "Nelson H. F. Beebe and Geoffrey R. D. Tobin",
@@ -48,8 +51,8 @@ dt2dv \- convert a DTL text representati
.RB [ \-group ]
.RB [ \-si ]
.RB [ \-so ]
-.I [input-DTL-file]
-.I [output-DVI-file]
+.RI [ input-DTL-file ]
+.RI [ output-DVI-file ]
.PP
In the absence of the
.B \-si
@@ -57,9 +60,9 @@ and
.B \-so
options,
both file arguments are
-.IR required
+.I required
in the order
-.B input-DTL-file output-DVI-file .
+.BR "input-DTL-file output-DVI-file" .
But also see the OPTIONS section below.
No default file extensions are supplied.
.\"======================================================================
@@ -68,7 +71,8 @@ No default file extensions are supplied.
converts a text representation of a \*(Te\& DVI
file, usually produced by the companion
.BR dv2dt (1)
-utility, back to a binary DVI file. DTL
+utility, back to a binary DVI file.
+DTL
.RI ( "DVI Text Language" )
files can be edited, with care, and then restored
to DVI form for processing by any \*(Te\& DVI
@@ -84,7 +88,7 @@ not well-suited for conversion back to a
.PP
The format of \*(Te\& DVI files is fully described
in
-Donald E. Knuth,
+Donald E.\& Knuth,
.IR "\*(Te\&: The Program" ,
Addison-Wesley (1986), ISBN 0-201-13437-3, as well
as in the
@@ -147,7 +151,7 @@ Email: <G.Tobin@ee.latrobe.edu.au>
These manual pages were written primarily by
.RS
.nf
-Nelson H. F. Beebe, Ph.D.
+Nelson H.\& F.\& Beebe, Ph.D.
Center for Scientific Computing
Department of Mathematics
University of Utah
-- System Information:
Debian Release: buster/sid
APT prefers stable-updates
APT policy: (500, 'stable-updates'), (500, 'proposed-updates'), (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)
Kernel: Linux 4.9.88-1-u1 (SMP w/2 CPU cores)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE=is_IS.iso88591 (charmap=ISO-8859-1)
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages texlive-binaries depends on:
[removed]
Versions of packages texlive-binaries recommends:
ii texlive-base 2018.20180505-1
texlive-binaries suggests no packages.
-- no debconf information
--
Bjarni I. Gislason
Reply to: