[cups.development] [RFE] STR #2263: lpmove(1) documentation

[John A. Murdie]

DO NOT REPLY TO THIS MESSAGE.  INSTEAD, POST ANY RESPONSES TO THE LINK BELOW.

[STR New]

I'd like the CUPS documentation web page about "Printing options"
http://www.cups.org/documentation.php/options.html to add a short
paragraph about the lpmove(1) command - a brief example of its use, and a
reference to the manual page for those who want to know more. (Perhaps the
"Printing options" web page would be better re-titled "Command line
printing". Reference to the manual pages should be made for all the
commands in this overview-like tutorial, of course.)

The lpmove(1) manual page should mention that this command is available
(by default) as /usr/sbin/lpmove - and say why it is there rather than in
/usr/bin (after all, lprm(1) and cancel(1) go there by default). It might
also give an example showing the need to authenticate even if one is
logged in as the owner of the job one wishes to move (and say why
authentication is necessary - something I haven't understood) e.g. on our
print server with CUPS 1.2.5:

$ who am i
john       pts/3        Feb 26 11:52    (pc118) 	
$ lpq -Ppp23
pp23 is ready and printing
Rank    Owner   Job     File(s)                         Total Size
active  john    1634    howtobeaprogrammer.pdf          224256 bytes
$ /usr/local/pkg/cups-1.2.5/sbin/lpmove pp23-1634 pp00
Password for john on localhost? ^C
lpmove: Unauthorized
$

John A. Murdie

Link: http://www.cups.org/str.php?L2263
Version:  -feature