The doc­u­ment­a­tion of CUPS is not very good (CUPS cli­ent setup)

Yes­ter­day even­ing I did setup a CUPS serv­er at home. It was on my TODO list since years. Be­fore I just went down­stairs and con­nec­ted the print­er via USB to the laptop/​net­book for print­ing (to pickup the prin­tout I have to go there any­way). It is not the first time that I setup the serv­er side of CUPS, but it was the first time that I wanted to use the CUPS com­mand line util­it­ies in­stead of the FreeBSD/​Sol­ar­is print­spool­er and the nat­ive lpr/​lp com­mands.

First I just had a look at some man-​pages of the CUPS util­it­ies, in the hope to find some com­mand to tell that any print­ing should be done via a re­mote CUPS serv­er. As I did not find any­thing, I went to the doc­u­ment­a­tion page of CUPS to search there. To me this is some simple con­fig part if you want to print from more than one ma­chine, so I had a look at the “Get­ting Star­ted” part. This was a total fail­ure. I found noth­ing re­lated to my prob­lem. After that I went to the “Man Pages” part to search for a com­mand which I may have over­looked. Again, a total fail­ure. The FAQ also does not con­tain any use­ful in­form­a­tion when you search for “cli­ent” or “re­mote”. In the end I stumbled over the client.conf entry in the Ref­er­ences part. After I found this it was easy (and fast, I just ad­ded a line in client.conf with “Server­Name <serv­er>” and everything worked as I wanted it to work).

The setup in Win­dows XP to use the CUPS serv­er is easy, just add a net­work print­er via http://<server>:631/printers/<printer> and use the cor­rect print­er driver for your print­er mod­el. Do not for­get to make the application/​object-​stream in the mime* con­fig files and al­low re­mote print­ing in the serv­er. No, I do not want to in­teg­rate it in­to Samba, the num­ber of Win­dows sys­tems is very lim­ited (2 Win­dows against 2 Unix ma­chines with 14 light­weight vir­tu­al Unix ma­chines), so I do not need this.