Bug#824419: cups-filters: Please document pdfAutorotate in the README

[Brian Potkin <claremont102@gmail.com>]

Package: cups-filters
Version: 1.0.83-2+b1
Severity: wishlist
Tags: patch upstream


Although pdfAutorotate was introduced in cups-filters 1.0.25 it is not
documented anywhere. I would suggest the README is as good a place as
any. My suggestion is:

  A PDF file containing pages with page width greater than page height
  (a landscape page) has such pages automatically rotated anticlockwise
  by 90 degrees. To turn off the feature on a job-for-job basis use

    lp -d <print_queue_name> -o nopdfAutorotate <document>

  On a per queue basis use

    -o nopdfAutorotate

  as an option to lpadmin.  

  Note that the 'landscape' and 'orientation-requested=4' options of
  CUPS take precedence and are applied before 'pdfAutorotate' or
  'nopdfAutorotate'.

(BTW. It is noticable that portrait/landscape bug reports when printing
from applications have reduced to zero since the introduction of
pdfAutorotate. It is also worth remarking that I think it is the only
way of printing a PDF with mixed orientation pages).

Regards,

Brian.