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

[Brian Potkin <claremont102@gmail.com>]

On Sun 15 May 2016 at 19:20:19 +0100, Brian Potkin wrote:

> 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'.

The suggestion doesn't quite match the reality of cups-filters 1.0.83.
A corrected patch 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 unless the PPD file has a *LandscapeOrientation line
saying 'Minus90', which results in a 90 degree rotation clockwise. 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'.