[Poppler-bugs] [Bug 81761] New: Manuals: Some typesetting improvements

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=81761

          Priority: medium
            Bug ID: 81761
          Assignee: poppler-bugs at lists.freedesktop.org
           Summary: Manuals: Some typesetting improvements
          Severity: minor
    Classification: Unclassified
                OS: Linux (All)
          Reporter: bjarniig at rhi.hi.is
          Hardware: Other
            Status: NEW
           Version: unspecified
         Component: utils
           Product: poppler

Created attachment 103471
  --> https://bugs.freedesktop.org/attachment.cgi?id=103471&action=edit
Patches for manuals

Poppler-utils
Version: 0.26.2

  The patches are in the attachment.

  Main changes in each file:

pdfdetach.1

Change - to \(en (en-dash) for a numeric range.

Change name of macros for two fonts (e.g., BR and IR) to one letter,
if there is only one argument.

Change - to \- if it means a minus sign

####

pdffonts.1

Change - to \(en (en-dash) for a numeric range.

Change two hyphen-minuses to an em-dash (\[em]).  An en-dash is usually
surrounded by a space, while an em-dash is used without spaces.  "man"
(1 byte characters) transforms an en-dash (\[en]) to one hyphen-minus, and an
em-dash to two hyphen-minuses without considering the space around it.

Change name of macros for two fonts (e.g., BR and IR) to one letter,
if there is only one argument.

Change - to \- if it means a minus sign

####

pdfimages.1

Split lines longer than 75[1] characters into two or more lines, each
at most 72 (8x(10-1)) characters long.
[1] man-pages(7)

The space between sentences in "roff" is two spaces.
Better is to begin each sentence on a new line[1] to avoid different
writers' conventions.
[1] man-pages(7)

Add command .tr '\(aq at the top of the source file to use only
straight single quotes (nondirectional ones)[1].
[1] man-pages(7)

Change - to \(en (en-dash) for a numeric range.

Change a minus sign (\-) in(side) names to a hyphen-minus (-) .  Names or
(compound) words are not written with a minus sign (which is an
operator).

Change (or include a "FIXME" paragraph about) misused SI (metric)
numeric prefixes (or names) to the binary ones, like Ki (kibi), Mi
(mebi), Gi (gibi), or Ti (tebi), if indicated.  If the metric prefixes
are correct, add the definitions or an explanation to avoid
misunderstanding.

Protect a full stop (.) with \&, if
 a) it can be transported to the first column, when the line is
reformatted (split).
 b) it is the last part of an abbreviation that does not end a
sentence.

Correct space around a semicolon or a comma.

Change name of macros for two fonts (e.g., BR and IR) to one letter,
if there is only one argument.

Change - to \- if it means a minus sign

#####

pdfinfo.1

The space between sentences in "roff" is two spaces.
Better is to begin each sentence on a new line[1] to avoid different
writers' conventions.
[1] man-pages(7)

Change \' (acute) to ', if used as a quote.

Add command .tr '\(aq at the top of the source file to use only
straight single quotes (nondirectional ones)[1].
[1] man-pages(7)

Change - to \(en (en-dash) for a numeric range.

Protect a full stop (.) with \&, if
 a) it can be transported to the first column, when the line is
reformatted (split).
 b) it is the last part of an abbreviation that does not end a
sentence.

Change - to \- if it means a minus sign

####

pdfseparate.1

Split lines longer than 75[1] characters into two or more lines, each
at most 72 (8x(10-1)) characters long.
[1] man-pages(7)

The space between sentences in "roff" is two spaces.
Better is to begin each sentence on a new line[1] to avoid different
writers' conventions.
[1] man-pages(7)

Change - to \(en (en-dash) for a numeric range.

Protect a full stop (.) with \&, if
 a) it can be transported to the first column, when the line is
reformatted (split).
 b) it is the last part of an abbreviation that does not end a
sentence.

Correct space around a semicolon or a comma.

Change - to \- if it means a minus sign

####

pdftocairo.1

Split lines longer than 75[1] characters into two or more lines, each
at most 72 (8x(10-1)) characters long.
[1] man-pages(7)

The space between sentences in "roff" is two spaces.
Better is to begin each sentence on a new line[1] to avoid different
writers' conventions.
[1] man-pages(7)

Change - to \(en (en-dash) for a numeric range.

Protect a full stop (.) with \&, if
 a) it can be transported to the first column, when the line is
reformatted (split).
 b) it is the last part of an abbreviation that does not end a
sentence.

Correct space around a semicolon or a comma.

Change name of macros for two fonts (e.g., BR and IR) to one letter,
if there is only one argument.

Change - to \- if it means a minus sign


Empty (or only spaces) lines cause a break.  Start such lines with
.\" (or remove them).

Use the word (in)valid instead of (il)legal.

####

pdftohtml.1

Split lines longer than 75[1] characters into two or more lines, each
at most 72 (8x(10-1)) characters long.
[1] man-pages(7)

Remove space at end of lines to simplify automatic tests to improve
typesetting.

The space between sentences in "roff" is two spaces.
Better is to begin each sentence on a new line[1] to avoid different
writers' conventions.
[1] man-pages(7)

Change - to \(en (en-dash) for a numeric range.

Protect a full stop (.) with \&, if
 a) it can be transported to the first column, when the line is
reformatted (split).
 b) it is the last part of an abbreviation that does not end a
sentence.

Change - to \- if it means a minus sign

Empty (or only spaces) lines cause a break.  Start such lines with
.\" (or remove them).

####

pdftoppm.1

Remove space at end of lines to simplify automatic tests to
improve typesetting.

The space between sentences in "roff" is two spaces.
Better is to begin each sentence on a new line[1] to avoid different
writers' conventions.
[1] man-pages(7)

Change - to \(en (en-dash) for a numeric range.

Protect a full stop (.) with \&, if
 a) it can be transported to the first column, when the line is
reformatted (split).
 b) it is the last part of an abbreviation that does not end a
sentence.

Correct space around a semicolon or a comma.

Change name of macros for two fonts (e.g., BR and IR) to one letter,
if there is only one argument.

Change - to \- if it means a minus sign

####

pdftops.1

Split lines longer than 75[1] characters into two or more lines, each
at most 72 (8x(10-1)) characters long.
[1] man-pages(7)

The space between sentences in "roff" is two spaces.
Better is to begin each sentence on a new line[1] to avoid different
writers' conventions.
[1] man-pages(7)

Change \' (acute) to ', if used as a quote.

Change - to \(en (en-dash) for a numeric range.

Protect a full stop (.) with \&, if
 a) it can be transported to the first column, when the line is
reformatted (split).
 b) it is the last part of an abbreviation that does not end a
sentence.

Correct space around a semicolon or a comma.

Change name of macros for two fonts (e.g., BR and IR) to one letter,
if there is only one argument.

Change - to \- if it means a minus sign

Use the word (in)valid instead of (il)legal.

####

pdftotext.1

Remove space at end of lines to simplify automatic tests to
improve typesetting.

The space between sentences in "roff" is two spaces.
Better is to begin each sentence on a new line[1] to avoid different
writers' conventions.
[1] man-pages(7)

Change \' (acute) to ', if used as a quote.

Add command .tr '\(aq at the top of the source file to use only
straight single quotes (nondirectional ones)[1].
[1] man-pages(7)

Change - to \(en (en-dash) for a numeric range.

Protect a full stop (.) with \&, if
 a) it can be transported to the first column, when the line is
reformatted (split).
 b) it is the last part of an abbreviation that does not end a
sentence.

Correct space around a semicolon or a comma.

Change - to \- if it means a minus sign

####

pdfunite.1

Split lines longer than 75[1] characters into two or more lines, each
at most 72 (8x(10-1)) characters long.
[1] man-pages(7)

Change - to \(en (en-dash) for a numeric range.

Change - to \- if it means a minus sign
(END)

-- 
You are receiving this mail because:
You are the assignee for the bug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.freedesktop.org/archives/poppler-bugs/attachments/20140725/e34cfb04/attachment-0001.html>