[Debian-hebrew-package] Bug#366912: Re-write man page

[Anthony DeRobertis]

Package: paps
Version: 0.6.4-1
Severity: wishlist

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

The man page is, honestly, in rather poor shape; it reads as a
half-completed rough draft.

       --column cl
              Number of columns output. Default is 1.

This confused me at first with the other meaning of column, as in an
80-column terminal. Not quite sure how to fix this one.


       --fontscale fs
              Font scaling. Default is 12.

Does this mean point size? If so, this option is named wrong.


       --family f
              Pango ft2 font family. Default is sans.

What is "ft2" ?


       --rtl  Do rtl layout.

After scratching my head for a while, 'rtl' must mean right-to-left.
Please expand the acronym in the description! Second, what does this
mean? Is all the text forced right-to-left? How does this interact with
normal Unicode BiDi?


       --paper ps
              Choose  paper  size.  Known  paper  sizes are legal, letter, a4.
              Default is A4.

Put an "and" before hte last item in a list. Known paper sizes are
legal, letter, and a4. 


Someone else has already reported all the margins which have no unit
specified.


- -- System Information:
Debian Release: testing/unstable
  APT prefers testing
  APT policy: (500, 'testing'), (130, 'unstable')
Architecture: amd64 (x86_64)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.12-1-amd64-k8-smp
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)

Versions of packages paps depends on:
ii  libc6                         2.3.6-7    GNU C Library: Shared libraries
ii  libfreetype6                  2.1.10-3   FreeType 2 font engine, shared lib
ii  libglib2.0-0                  2.10.2-1   The GLib library of C routines
ii  libpango1.0-0                 1.12.1-2   Layout and rendering of internatio

paps recommends no packages.

- -- no debconf information

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.3 (GNU/Linux)

iD8DBQFEY++q+z+IwlXqWf4RApu/AJ9H3iVckBc+FN7L2vPEy+hY6l49AACdHjNj
XSkRX+wJKRXbWtb/g8oX7iw=
=MOVM
-----END PGP SIGNATURE-----