Bug#505643: djvulibre: clean-up of c44 manpage

2008-11-14 Thread Barak A. Pearlmutter
Thanks Steve.  I've pushed that man page patch upstream, and it will
be in the next upload to debian.

(Although technically the correct way to prevent the final periods in
"e.g." and "i.e."  from ending sentences is to note that each of them
should always be followed by a comma.  This is house style in, e.g.,
most good journals, whose copy editors, i.e., their final arbiters on
such copy editing issues, carefully insert such commas.)

--Barak.



-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]



Bug#505643: djvulibre: clean-up of c44 manpage

2008-11-13 Thread Steve Langasek
Package: djvulibre-bin
Version: 3.5.21-1
Severity: minor
Tags: patch
User: [EMAIL PROTECTED]
Usertags: origin-ubuntu ubuntu-patch jaunty

Hi Barak,

The djvulibre package in Ubuntu Jaunty currently has a single patch against
it relative to the Debian package, to fix up some manpage formatting.  The
rationale for the patch is originally given in
https://bugs.launchpad.net/ubuntu/+source/djvulibre/+bug/255695 as:

  The attached patch fixes this and various other problems with the page's
  formatting, including removing extra blank lines, starting paragraphs
  the proper way, removing empty paragraphs from before a section header,
  removing spaces from inside other parenthesis, stopping `e.g.' and
  `i.e.' from looking like the end of a sentance, and removing full stops
  after exclamation marks.

The "this" refers to an incorrect invocation of the SM macro; the patch for
that was forwarded upstream and incorporated in the 3.5.21 upstream version,
but for some reason the rest of this patch was not.

You are welcome to apply the attached patch (and to forward it upstream);
the patch looks correct to me and the manpage also appears to render
correctly with it applied.

Cheers,
-- 
Steve Langasek   Give me a lever long enough and a Free OS
Debian Developer   to set it on, and I can move the world.
Ubuntu Developerhttp://www.debian.org/
[EMAIL PROTECTED] [EMAIL PROTECTED]
diff -Nru djvulibre-3.5.21/tools/c44.1 djvulibre-3.5.21/tools/c44.1
--- djvulibre-3.5.21/tools/c44.1	2008-11-14 04:37:00.0 +
+++ djvulibre-3.5.21/tools/c44.1	2008-11-14 04:37:01.0 +
@@ -22,10 +22,10 @@
 .TH C44 1 "10/11/2001" "DjVuLibre-3.5" "DjVuLibre-3.5"
 .SH NAME
 c44 \- DjVuPhoto encode.
-
+.
 .SH SYNOPSIS
 .BI "c44 [" "options" "] " "inputfilename" " [" "outputfilename" "]"
-
+.
 .SH DESCRIPTION
 Produces a DjVuPhoto encoded image.
 The input image file 
@@ -45,14 +45,14 @@
 already present in highly compressed
 .SM JPEG
 files.
-
+.P
 The program produces a DjVuPhoto file
 .IR outputfilename .
 If the output file name is not specified,
 a default file name will be generated by replacing
 the input file name suffix by suffix 
 .IR djvu .
-
+.P
 The main design objective for the DjVu wavelets consisted of allowing
 progressive rendering and smooth scrolling of large images with limited memory
 requirements.  Decoding functions process the compressed data and update a
@@ -67,15 +67,15 @@
 wavelets reach these requirements today and may in the future implement more
 modern refinements if these refinements can be implemented within our
 constraints.
-
+.
 .SH QUALITY SELECTION OPTIONS
-
+.
 DjVuPhoto files are logically composed of a sequence of "slices" containing
 successive image refinements.  Slices are grouped in "chunks" defining the
 progressive rendering sequence.  The viewer is able to display an intermediate
 image after processing each chunk.  A typical DjVuPhoto files contains 80 to
 120 slices grouped into 1 to 4 chunks.
-
+.P
 The quality selection options provide various ways to specify the number of
 chunks and the number of slices per chunk.  The 
 .B c44
@@ -84,7 +84,7 @@
 The following options define targets for each chunk.  The option 
 argument contain several numerical values (one per chunk) separated
 by either commas or pluses.
-
+.
 .TP
 .BI "-slice " "n" "+...+" "n"
 Specify the number of slices in each chunk.
@@ -100,7 +100,7 @@
 Specify the cumulative number of slices for each chunk.
 Since the final quality is determined by the total number of slices,
 it is often more convenient to use comma-separated values (one per chunk)
-indicating the cumulative number of slices for each chunk (i.e. including
+indicating the cumulative number of slices for each chunk (i.e.\& including
 those encoded in all previous chunks).  The values suggested above
 can also be expressed as
 .B "-slice 74,87,97"
@@ -142,7 +142,7 @@
 should be computed by averaging the mean squared errors of only the fraction
 .I frac
 of the most mis-represented blocks of 32 x 32 pixels.  This option is useful
-with composite images containing solid color features (e.g. an image with a
+with composite images containing solid color features (e.g.\& an image with a
 large white border).
 .PP
 Providing no quality specification options automatically selects a default
@@ -152,7 +152,7 @@
 file whose total number of chunks is the largest number of chunks of all
 quality specifications.  Slices are added to each chunk until reaching any of
 the quality target for this chunk.
-
+.
 .SH OTHER OPTIONS
 The following additional options are supported:
 .TP
@@ -221,27 +221,25 @@
 .BI "-crcbnone "
 Disable the encoding of the chrominance.  Only the luminance information will
 be encoded. The resulting image will show in shades of gray.
-.PP
-
+.
 .SH REMARKS
 The default quality setting of the DjVuLibre version of
 .B c44
 has been increased