Package: gnumeric
Version: 1.12.57-1.1+b1
Severity: minor
Tags: patch
* What led up to the situation?
Checking for defects with a new version
test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -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?
an.tmac:<stdin>:417: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:418: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:419: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:420: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
* 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.12.6-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 gnumeric depends on:
ii debconf [debconf-2.0] 1.5.89
ii gnumeric-common 1.12.57-1.1
ii libatk1.0-0t64 2.54.0-1
ii libc6 2.40-4
ii libcairo2 1.18.2-2
ii libgdk-pixbuf-2.0-0 2.42.12+dfsg-1+b1
ii libglib2.0-0t64 2.82.4-1
ii libgoffice-0.10-10t64 0.10.57-2
ii libgsf-1-114 1.14.52-1.1
ii libgtk-3-0t64 3.24.43-4
ii libpango-1.0-0 1.55.0+ds-3
ii libpangocairo-1.0-0 1.55.0+ds-3
ii libxml2 2.12.7+dfsg+really2.9.14-0.2+b1
ii procps 2:4.0.4-6
ii pxlib1 0.6.9-1+b1
ii zlib1g 1:1.3.dfsg+really1.3.1-1+b1
Versions of packages gnumeric recommends:
pn evince <none>
pn gnumeric-doc <none>
pn lp-solve <none>
Versions of packages gnumeric suggests:
pn fonts-liberation | ttf-mscorefonts-installer <none>
pn gnumeric-plugins-extra <none>
pn libgsf-1-dev <none>
-- debconf information excluded
Input file is ssconvert.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 ssconvert.1": (shortened list)
2 input text line longer than 80 bytes
1 skipping insecure request
2 skipping paragraph macro
-.-.
Output from "test-groff -mandoc -t -ww -z ssconvert.1": (shortened list)
4 Use macro '.B' for one argument or split argument.
4 .BR is for at least 2 arguments, got 1
-.-.
Change two HYPHEN-MINUSES (code 0x2D) to an em-dash (\(em),
if one is intended.
" \(em " creates a too big gap in the text (in "troff").
An en-dash is usually surrounded by a space,
while an em-dash is used without spaces.
"man" (1 byte characters in input) transforms an en-dash (\(en) to one
HYPHEN-MINUS,
and an em-dash to two HYPHEN-MINUSES without considering the space
around it.
If "--" are two single "-"
(begin of an option or end of options)
then use "\-\-".
ssconvert.1:27:starting with two dashes (`--').
-.-.
Use "\e" to print the escape character instead of "\\" (which gets
interpreted in copy mode).
309:The character or string used for quoting fields. Defaults to "\fB\\"\fR"
-.-.
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.
26:letter options starting with a single dash (`-') and longer options
27:starting with two dashes (`--').
210:XHTML range - for export to clipboard
383:\fBssconvert\fR \fB-O 'separator=; format=raw'\fR
\fIsamples/excel/statfuns.xls\fR \fIstatfuns.txt\fR
-.-.
Wrong distance between sentences in the input file.
Separate the sentences and subordinate clauses; each begins on a new
line. See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").
The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.
Remember coding: Only one command ("sentence") on each (logical) line.
E-mail: Easier to quote exactly the relevant lines.
Generally: Easier to edit the sentence.
Patches: Less unaffected text.
Search for two adjacent words is easier, when they belong to the same line,
and the same phrase.
The amount of space between sentences in the output can then be
controlled with the ".ss" request.
Mark a final abbreviation point as such by suffixing it with "\&".
N.B.
The number of lines affected can be too large to be in a patch.
16:between various spreadsheet file formats. It is a companion utility to
21:\fIoutfile\fR. The special URIs \fIfd://0\fR and \fIfd://1\fR can be
49:Specify which exporter to use; see below for a list. This is only
62:documented below. Multiple parameters can be specified
72:Specify which importer to use; see below for a list. This is only
264:Name of the sheet object to print. If this option is given any \fBsheet\fR
option is ignored.
269:Paper size. Valid values include "\fBA4\fR" for ISO A4 and
270:"\fBna_letter_8.5x11in\fR" for US Letter. If an individual graph is
specified through the
299:The character encoding of the output. Defaults to UTF-8.
309:The character or string used for quoting fields. Defaults to "\fB\\"\fR"
314:The string used to separate fields. Defaults to space.
332:as "1973/04/19". With "\fBpreserve\fR", the formatting will be preserved and
333:it will be output as "19-Apr-1973". With "\fBraw\fR" it will be output as
349:"\fBalways\fR". Defaults to "\fBauto\fR".
353:Controls whether initial or terminal whitespace forces quoting. Defaults to
399:License (GPL), version 2 or 3. For information on this license look at the
413:The initial version of this manpage was written by J.H.M. Dassen (Ray)
-.-.
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.
Line 12, length 103
\fBssconvert\fR [\fIOPTIONS\fR] \fB\-\-merge\-to\fR \fIoutfile\fR \fIinfile1\fR
\fIinfile2\fR \fB...\fR
Line 124, length 85
.URL "http://en.wikipedia.org/wiki/Data_Interchange_Format"; "Data Interchange
Format"
Line 136, length 83
.URL "http://en.wikipedia.org/wiki/SYmbolic_LinK_%28SYLK%29"; "Symbolic Link
(SYLK)"
Line 172, length 99
.URL "http://en.wikipedia.org/wiki/MPS_%28format%29"; "MPS (Mathematical
Programming System) format"
Line 264, length 93
Name of the sheet object to print. If this option is given any \fBsheet\fR
option is ignored.
Line 270, length 89
"\fBna_letter_8.5x11in\fR" for US Letter. If an individual graph is specified
through the
Line 271, length 90
\fBobject\fR option, then a paper size of "\fBfit\fR" reduces the size of the
paper to the
Line 383, length 101
\fBssconvert\fR \fB-O 'separator=; format=raw'\fR
\fIsamples/excel/statfuns.xls\fR \fIstatfuns.txt\fR
Line 388, length 83
\fBssconvert\fR \fB\-\-export\-graphs\fR \fIinput.gnumeric\fR
\fI'output.%n.svg'\fR
Line 393, length 110
\fBssconvert\fR \fB\-\-export\-type=png\fR \fB\-\-export\-graphs\fR
\fIinput.gnumeric\fR \fI'output.%n.png'\fR
-.-.
Use \(en (en-dash) for a dash at the beginning of a line,
or between space characters,
not a minus (\-) or a hyphen (-), except in the NAME section.
ssconvert.1:210:XHTML range - for export to clipboard
-.-.
Split a punctuation mark from a single argument for a two-font macro
417:.BR gnumeric(1),
418:.BR ssdiff(1),
419:.BR ssgrep(1),
-.-.
Name of a manual is set in bold, the section in roman.
See man-pages(7).
420:.BR ssindex(1)
-.-.
Put a parenthetical sentence, phrase on a separate line,
if not part of a code.
See man-pages(7), item "semantic newline".
ssconvert.1:46:List the available exporters (file formats that can be written).
ssconvert.1:66:numbered image files (SVG by default). The list of available
image
ssconvert.1:70:List the available importers (file formats that can be read).
ssconvert.1:132:Text (configurable)
ssconvert.1:150:HTML (*.html, *.htm)
ssconvert.1:172:.URL "http://en.wikipedia.org/wiki/MPS_%28format%29"; "MPS
(Mathematical Programming System) format"
ssconvert.1:320:"\fBautomatic\fR" (apply automatic formatting; default),
ssconvert.1:321:"\fBraw\fR" (output data raw, unformatted), or
ssconvert.1:322:"\fBpreserve\fR" (preserve the formatting from the source
document).
ssconvert.1:334:"26773" (Gnumeric's internal representation: days since an
epoch).
ssconvert.1:348:"\fBauto\fR" (puts quotes where needed), or
-.-.
Put a subordinate sentence (after a comma) on a new line.
17:\fBGnumeric\fR, the powerful spreadsheet program created by the GNOME
25:This program follows the usual GNU command line syntax, with single
36:put an expression in a cell, add an extra =, for example \-\-set
"A11==A10+1".
38:recalculated after all cells have been set, provided that the workbook is
39:set for automatic recalculation. If not, recalculation can be forced
52:\-\-list\-exporters option. However, when image export is requested
53:using the \-\-export\-graphs option, the list of image formats should be
59:\fIoptionsstring\fR is a list of \fIparameter\fR=\fIvalue\fR pairs, separated
91:is substituted for %n, sheet name is substituted for %s, and sheet object
93:substitutions, a default of ".%n" is added.
121:As an exporter, this is ODF/OpenOffice without foreign elements (*.ods).
260:irrelevant, but the equal sign is mandatory.
271:\fBobject\fR option, then a paper size of "\fBfit\fR" reduces the size of
the paper to the
288:irrelevant, but the equal sign is mandatory.
321:"\fBraw\fR" (output data raw, unformatted), or
328:input as "4/19/73" in a US locale, with a format set to "d-mmm-yyyy" and
332:as "1973/04/19". With "\fBpreserve\fR", the formatting will be preserved and
341:"\fBtransliterate\fR", or
348:"\fBauto\fR" (puts quotes where needed), or
374:The export format can be specified explicitly, to override the default
399:License (GPL), version 2 or 3. For information on this license look at the
-.-.
Remove quotes when there is a printable
but no space character between them
and the quotes are not for emphasis (markup),
for example as an argument to a macro.
5:.TH SSCONVERT 1 "2020-04-19" "gnumeric" "GNOME"
117:.URL "http://en.wikipedia.org/wiki/OpenDocument"; "OpenDocument"
119:.URL "http://en.wikipedia.org/wiki/OpenOffice.org_Calc"; "OpenOffice Calc"
124:.URL "http://en.wikipedia.org/wiki/Data_Interchange_Format"; "Data
Interchange Format"
128:.URL "http://en.wikipedia.org/wiki/Paradox_%28database%29"; "Paradox
database"
135:.URL "http://en.wikipedia.org/wiki/Multiplan"; "MultiPlan"
136:.URL "http://en.wikipedia.org/wiki/SYmbolic_LinK_%28SYLK%29"; "Symbolic Link
(SYLK)"
141:.URL "http://en.wikipedia.org/wiki/XLSX"; "OOXML"
161:.URL "http://en.wikipedia.org/wiki/Quattro_Pro"; "Quattro Pro"
168:.URL "http://en.wikipedia.org/wiki/Lotus_1-2-3"; "Lotus 1-2-3"
172:.URL "http://en.wikipedia.org/wiki/MPS_%28format%29"; "MPS (Mathematical
Programming System) format"
176:.URL "http://en.wikipedia.org/wiki/GNU_Oleo"; "GNU Oleo"
189:.URL "http://en.wikipedia.org/wiki/XBase"; "xBase"
242:.URL "http://en.wikipedia.org/wiki/Troff"; "TROFF"
246:.URL "http://sourceforge.net/projects/lpsolve/"; "LPSolve"
401:.URL "http://www.gnu.org"; "GNU project page" .
422:.URL "http://www.gnome.org/projects/gnumeric/"; "The Gnumeric Homepage" .
424:.URL "http://www.gnome.org/"; "The GNOME project page" .
-.-.
Output from "test-groff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z
":
an.tmac:<stdin>:417: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:418: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:419: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:420: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
--- ssconvert.1 2025-01-11 22:53:04.541286297 +0000
+++ ssconvert.1.new 2025-01-11 23:26:36.050529804 +0000
@@ -2,7 +2,7 @@
\\$2 \(laURL: \\$1 \(ra\\$3
..
.if \n[.g] .mso www.tmac
-.TH SSCONVERT 1 "2020-04-19" "gnumeric" "GNOME"
+.TH SSCONVERT 1 2020-04-19 gnumeric GNOME
.SH NAME
ssconvert \- a command line spreadsheet format converter
@@ -23,8 +23,8 @@ used for standard input and standard out
.SH OPTIONS
This program follows the usual GNU command line syntax, with single
-letter options starting with a single dash (`-') and longer options
-starting with two dashes (`--').
+letter options starting with a single dash (`\-') and longer options
+starting with two dashes (`\-\-').
.SS "Main options"
.TP
@@ -114,31 +114,31 @@ The following IDs can be can be used bot
Gnumeric's XML file format (*.gnumeric)
.TP
.B Gnumeric_OpenCalc:openoffice
-.URL "http://en.wikipedia.org/wiki/OpenDocument"; "OpenDocument"
+.URL http://en.wikipedia.org/wiki/OpenDocument OpenDocument
or
-.URL "http://en.wikipedia.org/wiki/OpenOffice.org_Calc"; "OpenOffice Calc"
+.URL http://en.wikipedia.org/wiki/OpenOffice.org_Calc "OpenOffice Calc"
(*.sxc, *.ods) format.
As an exporter, this is ODF/OpenOffice without foreign elements (*.ods).
.TP
.B Gnumeric_dif:dif
-.URL "http://en.wikipedia.org/wiki/Data_Interchange_Format"; "Data Interchange
Format"
+.URL http://en.wikipedia.org/wiki/Data_Interchange_Format "Data Interchange
Format"
(*.dif)
.TP
.B Gnumeric_paradox:paradox
-.URL "http://en.wikipedia.org/wiki/Paradox_%28database%29"; "Paradox database"
+.URL http://en.wikipedia.org/wiki/Paradox_%28database%29 "Paradox database"
or primary index file (*.db, *.px)
.TP
.B Gnumeric_stf:stf_assistant
Text (configurable)
.TP
.B Gnumeric_sylk:sylk
-.URL "http://en.wikipedia.org/wiki/Multiplan"; "MultiPlan"
-.URL "http://en.wikipedia.org/wiki/SYmbolic_LinK_%28SYLK%29"; "Symbolic Link
(SYLK)"
+.URL http://en.wikipedia.org/wiki/Multiplan MultiPlan
+.URL http://en.wikipedia.org/wiki/SYmbolic_LinK_%28SYLK%29 "Symbolic Link
(SYLK)"
(*.slk)
.TP
.B Gnumeric_Excel:xlsx
Microsoft Excel (tm) 2007 ("Office Open XML",
-.URL "http://en.wikipedia.org/wiki/XLSX"; "OOXML"
+.URL http://en.wikipedia.org/wiki/XLSX OOXML
) format
.SH LIST OF IMPORTANT IMPORTER IDS
@@ -158,22 +158,22 @@ Microsoft Excel (tm) 2003 SpreadsheetML
.SH LIST OF OTHER IMPORTER IDS
.TP
.B Gnumeric_QPro:qpro
-.URL "http://en.wikipedia.org/wiki/Quattro_Pro"; "Quattro Pro"
+.URL http://en.wikipedia.org/wiki/Quattro_Pro "Quattro Pro"
(*.wb1, *.wb2, *.wb3)
.TP
.B Gnumeric_applix:applix
Applix (*.as)
.TP
.B Gnumeric_lotus:lotus
-.URL "http://en.wikipedia.org/wiki/Lotus_1-2-3"; "Lotus 1-2-3"
+.URL http://en.wikipedia.org/wiki/Lotus_1-2-3 "Lotus 1-2-3"
(*.wk1, *.wks, *.123)
.TP
.B Gnumeric_mps:mps
-.URL "http://en.wikipedia.org/wiki/MPS_%28format%29"; "MPS (Mathematical
Programming System) format"
+.URL http://en.wikipedia.org/wiki/MPS_%28format%29 "MPS (Mathematical
Programming System) format"
Linear programming and mixed integer programming file format (*.mps)
.TP
.B Gnumeric_oleo:oleo
-.URL "http://en.wikipedia.org/wiki/GNU_Oleo"; "GNU Oleo"
+.URL http://en.wikipedia.org/wiki/GNU_Oleo "GNU Oleo"
(*.oleo)
.TP
.B Gnumeric_plan_perfect:pln
@@ -186,7 +186,7 @@ Psion (*.psisheet)
SC/xspread
.TP
.B Gnumeric_xbase:xbase
-.URL "http://en.wikipedia.org/wiki/XBase"; "xBase"
+.URL http://en.wikipedia.org/wiki/XBase xBase
(*.dbf) file format
.SH LIST OF IMPORTANT EXPORTER IDS
@@ -207,7 +207,7 @@ HTML (*.html) fragment
XHTML (*.html)
.TP
.B Gnumeric_html:xhtml_range
-XHTML range - for export to clipboard
+XHTML range \(en for export to clipboard
.TP
.B Gnumeric_pdf:pdf_assistant
Portable Document Format (*.PDF)
@@ -239,11 +239,11 @@ LaTeX 2e (*.tex)
LaTeX 2e (*.tex) table fragment
.TP
.B Gnumeric_html:roff
-.URL "http://en.wikipedia.org/wiki/Troff"; "TROFF"
+.URL http://en.wikipedia.org/wiki/Troff TROFF
(*.me) format.
.TP
.B Gnumeric_lpsolve:lpsolve
-.URL "http://sourceforge.net/projects/lpsolve/"; "LPSolve"
+.URL http://sourceforge.net/projects/lpsolve/ LPSolve
Mixed Integer Linear Programming (MILP) solver
.SH OPTIONS FOR THE PORTABLE DOCUMENT FORMAT (*.pdf) EXPORTER
@@ -261,14 +261,18 @@ irrelevant, but the equal sign is mandat
.TP
.B object
-Name of the sheet object to print. If this option is given any \fBsheet\fR
option is ignored.
+Name of the sheet object to print.
+If this option is given any \fBsheet\fR option is ignored.
Only the first \fBobject\fR given is exported.
.TP
.B paper
-Paper size. Valid values include "\fBA4\fR" for ISO A4 and
-"\fBna_letter_8.5x11in\fR" for US Letter. If an individual graph is specified
through the
-\fBobject\fR option, then a paper size of "\fBfit\fR" reduces the size of the
paper to the
+Paper size.
+Valid values include "\fBA4\fR" for ISO A4 and
+"\fBna_letter_8.5x11in\fR" for US Letter.
+If an individual graph is specified through the
+\fBobject\fR option,
+then a paper size of "\fBfit\fR" reduces the size of the paper to the
size of the graph.
.\" FIXME Is there a convenient way to list all valid paper sizes?
.\" It looks like at least the values from plugins/excel/ms-excel-read.c's
@@ -306,7 +310,7 @@ Consult \fBlocale \-a\fR output for acce
.TP
.B quote
-The character or string used for quoting fields. Defaults to "\fB\\"\fR"
+The character or string used for quoting fields. Defaults to "\fB\e"\fR"
(quotation mark / double quote).
.TP
@@ -380,7 +384,7 @@ The export format can be specified expli
To convert an Excel format file \fIstatfuns.xls\fR to a text file,
specifying the semicolon as the separator character:
.PP
-\fBssconvert\fR \fB-O 'separator=; format=raw'\fR
\fIsamples/excel/statfuns.xls\fR \fIstatfuns.txt\fR
+\fBssconvert\fR \fB\-O 'separator=; format=raw'\fR
\fIsamples/excel/statfuns.xls\fR \fIstatfuns.txt\fR
.PP
To export the charts from the input file \fIinput.gnumeric\fR to numbered
SVG files:
@@ -391,14 +395,11 @@ To export the charts from the input file
PNG files:
.PP
\fBssconvert\fR \fB\-\-export\-type=png\fR \fB\-\-export\-graphs\fR
\fIinput.gnumeric\fR \fI'output.%n.png'\fR
-.PP
-
.SH LICENSE
-
\fBssconvert\fR is licensed under the terms of the General Public
License (GPL), version 2 or 3. For information on this license look at the
source code that came with the software or see the
-.URL "http://www.gnu.org"; "GNU project page" .
+.URL http://www.gnu.org "GNU project page" .
.SH COPYRIGHT
@@ -414,11 +415,11 @@ The initial version of this manpage was
<jdas...@debian.org>.
.SH SEE ALSO
-.BR gnumeric(1),
-.BR ssdiff(1),
-.BR ssgrep(1),
-.BR ssindex(1)
+.BR gnumeric (1),
+.BR ssdiff (1),
+.BR ssgrep (1),
+.BR ssindex (1)
-.URL "http://www.gnome.org/projects/gnumeric/"; "The Gnumeric Homepage" .
+.URL http://www.gnome.org/projects/gnumeric/ "The Gnumeric Homepage" .
-.URL "http://www.gnome.org/"; "The GNOME project page" .
+.URL http://www.gnome.org/ "The GNOME project page" .
