From e6c2f6780374c7af419862a28a858d899bb84cd4 Mon Sep 17 00:00:00 2001 From: Gabor Pali Date: Fri, 24 Oct 2008 23:01:06 +0000 Subject: [PATCH] Fix some doc bugs found during its translation: - Disable TOC generation in Makefile because in the original version it does not make too much sense to have a one-item TOC - Change structure of sections, move all the sect2 to level sect1; this results shorter high-level sections, but it gives a more normal layout - Mark up CUPS ports with to add Ports Collection links for them - Mark up group "cups" with - Fix a within a situation - Replace tags with for local CUPS web interface links - Replace tags with for "localhost" - Mark up menu items with rather than - Use elements where applicable - Fix spelling - Remove all verbatim quote symbols, replace them with elements - Mark up make variables with elements - Mark up make targets with elements Reviewed by: Chess Griffin --- en_US.ISO8859-1/articles/cups/Makefile | 1 - en_US.ISO8859-1/articles/cups/article.sgml | 94 +++++++++++----------- 2 files changed, 48 insertions(+), 47 deletions(-) diff --git a/en_US.ISO8859-1/articles/cups/Makefile b/en_US.ISO8859-1/articles/cups/Makefile index 44784a415f..bfc00d4dbb 100644 --- a/en_US.ISO8859-1/articles/cups/Makefile +++ b/en_US.ISO8859-1/articles/cups/Makefile @@ -6,7 +6,6 @@ DOC?= article FORMATS?= html -WITH_ARTICLE_TOC?= YES INSTALL_COMPRESSED?=gz INSTALL_ONLY_COMPRESSED?= diff --git a/en_US.ISO8859-1/articles/cups/article.sgml b/en_US.ISO8859-1/articles/cups/article.sgml index ceb2c06819..8cc8ef41e5 100644 --- a/en_US.ISO8859-1/articles/cups/article.sgml +++ b/en_US.ISO8859-1/articles/cups/article.sgml @@ -11,7 +11,7 @@ Chess - Grifin + Griffin
chess@chessgriffin.com
 @@ -55,8 +55,9 @@ The main site for CUPS is . + - + Installing the CUPS Print Server CUPS can be installed from ports @@ -73,15 +74,15 @@ &prompt.root; pkg_add -r cups Other optional, but recommended, ports or packages are - print/gutenprint-cups and - print/hplip, both of which add + print/gutenprint-cups and + print/hplip, both of which add drivers and utilities for a variety of printers. Once installed, the CUPS configuration files can be found in the directory /usr/local/etc/cups. - + - + Configuring the CUPS Print Server After installation, a few files must edited in order to @@ -89,7 +90,7 @@ create or modify, as the case may be, the file /etc/devfs.rules and add the following information to set the proper permissions on all potential - printer devices and to associate printers with the cups user + printer devices and to associate printers with the cups user group: [system=10] @@ -108,10 +109,12 @@ devfs_system_ruleset="system" the local devfs rule created above, respectively. In order to enable CUPS printing - under certain µsoft.windows; clients, the line - application/octet-stream should be + under certain µsoft.windows; clients, the line below + should be uncommented in /usr/local/etc/cups/mime.types - and /usr/local/etc/cups/mime.convs. + and /usr/local/etc/cups/mime.convs: + + application/octet-stream Once these changes have been made, the &man.devfs.8; and CUPS systems must both be restarted, @@ -121,9 +124,9 @@ devfs_system_ruleset="system" &prompt.root; /etc/rc.d/devfs restart &prompt.root; /usr/local/etc/rc.d/cupsd restart - + - + Configuring Printers on the CUPS Print Server After the CUPS system has been @@ -137,11 +140,11 @@ devfs_system_ruleset="system" The primary means for managing and administering the CUPS server is through the web-based interface, which can be found by launching a web browser and - entering http://localhost:631 in the + entering in the browser's URL bar. If the CUPS server is on another machine on the network, substitute the server's local IP addresss for - localhost. The CUPS + localhost. The CUPS web interface is fairly self-explanatory, as there are sections for managing printers and print jobs, authorizing users, and more. Additionally, on the right-hand side of the @@ -153,21 +156,21 @@ devfs_system_ruleset="system" privileges to the printers and print jobs. Adding a printer is generally as easy as clicking - Add Printer at the Administration screen of + Add Printer at the Administration screen of the CUPS web interface, or clicking - one of the New Printers Found buttons also + one of the New Printers Found buttons also at the Administration screen. When presented with the - Device drop-down box, simply select the + Device drop-down box, simply select the desired locally-attached printer, and then continue through the process. If one has added the - print/gutenprint-cups or - print/hplip ports or packages as + print/gutenprint-cups or + print/hplip ports or packages as referenced above, then additional print drivers will be available in the subsequent screens that might provide more stability or features. - + - + Configuring CUPS Clients Once the CUPS server has been @@ -178,7 +181,7 @@ devfs_system_ruleset="system" desktop machine that is acting as both server and client, then much of this information may not be needed. - + &unix; Clients CUPS will also need to be @@ -190,9 +193,9 @@ devfs_system_ruleset="system" GNOME or KDE. Alternatively, one can access the local CUPS interface on the - client machine at http://localhost:631 and - click on Add Printer in the Administration - section. When presented with the Device + client machine at and + click on Add Printer in the Administration + section. When presented with the Device drop-down box, simply select the networked CUPS printer, if it was automatically discovered, or select ipp or @@ -201,9 +204,9 @@ devfs_system_ruleset="system" CUPS printer, usually in one of the two following syntaxes: - ipp://server-name-or-ip/printers/printername + ipp://server-name-or-ip/printers/printername - http://server-name-or-ip:631/printers/printername + http://server-name-or-ip:631/printers/printername If the CUPS clients have difficulty finding other CUPS @@ -212,14 +215,14 @@ devfs_system_ruleset="system" /usr/local/etc/cups/client.conf with a single entry as follows: - ServerName (server-ip) + ServerName server-ip - In this case, (server-ip) would be replaced by the local + In this case, server-ip would be replaced by the local IP address of the CUPS server on the network. - + - + &windows; Clients Versions of &windows; prior to XP did not have the @@ -233,7 +236,7 @@ devfs_system_ruleset="system" Printer and then enter the URI in the following syntax: - http://server-name-or-ip:631/printers/printername + http://server-name-or-ip:631/printers/printername If one has an older version of &windows; without native IPP printing support, then the general @@ -242,19 +245,19 @@ devfs_system_ruleset="system" net/samba3 and CUPS together, which is a topic outside the scope of this chapter. - - + + - + CUPS Troubleshooting Difficulties with CUPS often lies in permissions. First, double check the &man.devfs.8; permissions as outlined above. Next, check the actual - permissions of the devices created in the filesystem. It is + permissions of the devices created in the file system. It is also helpful to make sure your user is a member of the - cups group. If the permissions check boxes - in the Administration section of the + cups group. If the permissions check boxes + in the Administration section of the CUPS web interface do not seem to be working, another fix might be to manually backup the main CUPS configuration file located at @@ -348,33 +351,32 @@ CUPS-Delete-Class CUPS-Accept-Jobs CUPS-Reject-Jobs CUPS-Set-Default> Order deny,allow </Limit> </Policy> - + - + Fine Tuning CUPS-Related Ports If CUPS is going to serve as the primary printing system, then one may choose to optionally add certain knobs to /etc/make.conf that will emphasize CUPS over other printing - options. Some of these "knobs" that one may want to add + options. Some of these knobs that one may want to add are: WITH_CUPS=YES CUPS_OVERWRITE_BASE=YES WITHOUT_LPR=YES - The first knob, WITH_CUPS, adds + The first knob, WITH_CUPS, adds CUPS support to ports where - applicable. The second knob, CUPS_OVERWRITE_BASE, will fix + applicable. The second knob, CUPS_OVERWRITE_BASE, will fix certain symlinks and paths that would otherwise apply to the default &os; printing system, LPR, and will prevent these fixes from being reverted upon the next - "buildworld" system upgrade. The third knob, WITHOUT_LPR, will + buildworld system upgrade. The third knob, WITHOUT_LPR, will prevent LPR support from being added to ports where applicable. - - +