complete on the spooldir field

1 files changed, 284 insertions, 233 deletions

diff --git a/perl-install/printer.pm b/perl-install/printer.pm
index b86e4de61..873c4d8bf 100644
--- a/perl-install/printer.pm
+++ b/perl-install/printer.pm
@@ -1,242 +1,293 @@
 package printer;
+#-#####################################################################################
+
+=head1 NAME 
+
+printer - supply methods for manage the printer related files directory handles
+
+=head1 SYNOPSIS
+
+use printer;
+
+=head1 DESCRIPTION
+
+Use the source.
+
+=cut
+
+#-#####################################################################################
 
 use diagnostics;
 use strict;
 
-use vars qw(%thedb %printer_type %printer_type_inv @papersize_type);
 
-########################################################################################
-# misc imports
-########################################################################################
+#-#####################################################################################
+
+=head2 Exported variable
+
+=cut
+
+#-#####################################################################################
+use vars qw(%thedb %printer_type %printer_type_inv @papersize_type %fields $spooldir);
+
+#-#####################################################################################
+
+=head2 Imports
+
+=cut
+
+#-#####################################################################################
 use Data::Dumper;
 use commands;
-########################################################################################
-# pixel imports
-########################################################################################
-#
-########################################################################################
-# EXAMPLES AND TYPES
-########################################################################################
-
-# An entry in the 'printerdb' file, which describes each type of 
-# supported printer                                              
-
-#ex:
-#StartEntry: DeskJet550
-#  GSDriver: cdj550 
-#  Description: {HP DeskJet 550C/560C/6xxC series}
-#  About: { \
-#	    This driver supports the HP inkjet printers which have \
-#	    color capability using both black and color cartridges \
-#	    simultaneously. Known to work with the 682C and the 694C. \
-#	    Other 600 and 800 series printers may work \
-#	    if they have this feature. \
-#	    If your printer seems to be saturating the paper with ink, \
-#	    try added an extra GS option of '-dDepletion=2'. \
-#	    Ghostscript supports several optional parameters for \
-#	    this driver: see the document 'devices.doc' \
-#	    in the ghostscript directory under /usr/doc. \
-#	  }
-#  Resolution: {300} {300} {}
-#  BitsPerPixel:  {3} {Normal color printing with color cartridge}
-#  BitsPerPixel:  {8} {Floyd-Steinberg B&W printing for better greys}
-#  BitsPerPixel: {24} {Floyd-Steinberg Color printing (best, but slow)}
-#  BitsPerPixel: {32} {Sometimes provides better output than 24}
-#EndEntry
-
-my %ex_printerdb_entry = 
-  (
-   ENTRY    => "DeskJet550",                               #Human-readable name of the entry
-   GSDRIVER => "cdj550",                                   #gs driver used by this printer
-   DESCR    => "HP DeskJet 550C/560C/6xxC series",         #Single line description of printer
-   ABOUT    => "
-   This driver supports the HP inkjet printers which have 
-   color capability using both black and color cartridges 
-        ...",                                             #Lengthy description of printer
-   RESOLUTION   => [                                       #List of resolutions supported
-		    {
-		     XDPI    => 300,
-		     YDPI    => 300,
-		     DESCR   => "commentaire",
-		    },
-		   ],
-   BITSPERPIXEL => [                                       #List of color depths supported
-		    {
-		     DEPTH => 3,
-		     DESCR => "Normal color printing with color cartridge",
-		    },
-		   ],
-  )
-;
-  
-
-
-# A printcap entry 
-# Only represents a subset of possible options available 
-# Sufficient for the simple configuration we are interested in 
-
-# there is also some text in the template (.in) file in the spooldir
-
-#ex:
-## /etc/printcap
-##
-## Please don't edit this file directly unless you know what you are doing!
-## Be warned that the control-panel printtool requires a very strict format!
-## Look at the printcap(5) man page for more info.
-##
-## This file can be edited with the printtool in the control-panel.
-#
-###PRINTTOOL3## LOCAL uniprint NAxNA letter {} U_NECPrinwriter2X necp2x6 1
-#lpname:\
-#	 :sd=/var/spool/lpd/lpnamespool:\
-#	 :mx#45:\
-#	 :sh:\
-#	 :lp=/dev/device:\
-#	 :if=/var/spool/lpd/lpnamespool/filter:
-###PRINTTOOL3## REMOTE st800 360x180 a4 {} EpsonStylus800 Default 1
-#remote:\
-#	 :sd=/var/spool/lpd/remotespool:\
-#	 :mx#47:\
-#	 :sh:\
-#	 :rm=remotehost:\
-#	 :rp=remotequeue:\
-#	 :if=/var/spool/lpd/remotespool/filter:
-###PRINTTOOL3## SMB la75plus 180x180 letter {} DECLA75P Default {}
-#smb:\
-#	 :sd=/var/spool/lpd/smbspool:\
-#	 :mx#46:\
-#	 :sh:\
-#	 :if=/var/spool/lpd/smbspool/filter:\
-#	 :af=/var/spool/lpd/smbspool/acct:\
-#	 :lp=/dev/null:
-###PRINTTOOL3## NCP ap3250 180x180 letter {} EpsonAP3250 Default {}
-#ncp:\
-#	 :sd=/var/spool/lpd/ncpspool:\
-#	 :mx#46:\
-#	 :sh:\
-#	 :if=/var/spool/lpd/ncpspool/filter:\
-#	 :af=/var/spool/lpd/ncpspool/acct:\
-#	 :lp=/dev/null:
-
-
-my %ex_printcap_entry = 
-  (
-   QUEUE    => "lpname",                            #Queue name, can have multi separated by '|'
-
-   #if you want something different from the default
-   SPOOLDIR => "/var/spool/lpd/lpnamespool/",        #Spool directory
-   IF       => "/var/spool/lpd/lpnamespool/filter", #input filter
-   
-   # commentaire inserer dans le printcap pour que printtool retrouve ses petits
-   DBENTRY      => "DeskJet670",                    #entry in printer database for this printer  
 
-   RESOLUTION   => "NAxNA",                         #ghostscript resolution to use
-   PAPERSIZE    => "letter",                        #Papersize
-   BITSPERPIXEL => "necp2x6",                       #ghostscript color option                    
-   CRLF         => 1 ,                            #Whether or not to do CR/LF xlation         
+#-#####################################################################################
+
+=head2 pixel imports
+
+=cut
+
+#-#####################################################################################
+
+#-#####################################################################################
+
+=head2 Examples and types
+
+=over 4
+
+=item *
+
+an entry in the 'printerdb' file, which describes each type of 
+supported printer:
+
+	StartEntry: DeskJet550
+	  GSDriver: cdj550 
+	  Description: {HP DeskJet 550C/560C/6xxC series}
+	  About: { \
+		     This driver supports the HP inkjet printers which have \
+		     color capability using both black and color cartridges \
+		     simultaneously. Known to work with the 682C and the 694C. \
+		     Other 600 and 800 series printers may work \
+		     if they have this feature. \
+		     If your printer seems to be saturating the paper with ink, \
+		     try added an extra GS option of '-dDepletion=2'. \
+		     Ghostscript supports several optional parameters for \
+		     this driver: see the document 'devices.doc' \
+		     in the ghostscript directory under /usr/doc. \
+		   }
+	  Resolution: {300} {300} {}
+	  BitsPerPixel:  {3} {Normal color printing with color cartridge}
+	  BitsPerPixel:  {8} {Floyd-Steinberg B&W printing for better greys}
+	  BitsPerPixel: {24} {Floyd-Steinberg Color printing (best, but slow)}
+	  BitsPerPixel: {32} {Sometimes provides better output than 24}
+	EndEntry
+
+Example of data-struct:
+
+	my %ex_printerdb_entry = 
+	  (
+	   ENTRY    => "DeskJet550",                               #-Human-readable name of the entry
+	   GSDRIVER => "cdj550",                                   #-gs driver used by this printer
+	   DESCR    => "HP DeskJet 550C/560C/6xxC series",         #-Single line description of printer
+	   ABOUT    => "
+	   This driver supports the HP inkjet printers which have 
+	   color capability using both black and color cartridges 
+		...",                                              #-Lengthy description of printer
+	   RESOLUTION   => [                                       #-List of resolutions supported
+			    {
+			     XDPI    => 300,
+			     YDPI    => 300,
+			     DESCR   => "commentaire",
+			    },
+			   ],
+	   BITSPERPIXEL => [                                       #-List of color depths supported
+			    {
+			     DEPTH => 3,
+			     DESCR => "Normal color printing with color cartridge",
+			    },
+			   ],
+	  )
+	;
+
+=item *
+
+A printcap entry only represents a subset of possible options available       
+Sufficient for the simple configuration we are interested in 
+there is also some text in the template (.in) file in the spooldir
+
+	# /etc/printcap                                                          
+	#                                                                        
+	# Please don't edit this file directly unless you know what you are doing
+	# Be warned that the control-panel printtool requires a very strict forma
+	# Look at the printcap(5) man page for more info.                        
+	#                                                                        
+	# This file can be edited with the printtool in the control-panel.       
+										 
+	##PRINTTOOL3## LOCAL uniprint NAxNA letter {} U_NECPrinwriter2X necp2x6 1
+	lpname:\                                                                 
+		:sd=/var/spool/lpd/lpnamespool:\                                 
+		:mx#45:\                                                         
+		:sh:\                                                            
+		:lp=/dev/device:\                                                
+		:if=/var/spool/lpd/lpnamespool/filter:                           
+	##PRINTTOOL3## REMOTE st800 360x180 a4 {} EpsonStylus800 Default 1       
+	remote:\                                                                 
+		:sd=/var/spool/lpd/remotespool:\                                 
+		:mx#47:\                                                         
+		:sh:\                                                            
+		:rm=remotehost:\                                                 
+		:rp=remotequeue:\                                                
+		:if=/var/spool/lpd/remotespool/filter:                           
+	##PRINTTOOL3## SMB la75plus 180x180 letter {} DECLA75P Default {}        
+	smb:\                                                                    
+		:sd=/var/spool/lpd/smbspool:\                                    
+		:mx#46:\                                                         
+		:sh:\                                                            
+		:if=/var/spool/lpd/smbspool/filter:\                             
+		:af=/var/spool/lpd/smbspool/acct:\                               
+		:lp=/dev/null:                                                   
+	##PRINTTOOL3## NCP ap3250 180x180 letter {} EpsonAP3250 Default {}       
+	ncp:\                                                                    
+		:sd=/var/spool/lpd/ncpspool:\                                    
+		:mx#46:\                                                         
+		:sh:\                                                            
+		:if=/var/spool/lpd/ncpspool/filter:\                             
+		:af=/var/spool/lpd/ncpspool/acct:\                               
+		:lp=/dev/null:                                                   
+
+Example of data-struct:
+
+	my %ex_printcap_entry = 
+	  (
+	   QUEUE    => "lpname",                            #-Queue name, can have multi separated by '|'
+	
+	   #-if you want something different from the default
+	   SPOOLDIR => "/var/spool/lpd/lpnamespool/",        #-Spool directory
+	   IF       => "/var/spool/lpd/lpnamespool/filter",  #-input filter
+	   
+	   #- commentaire inserer dans le printcap pour que printtool retrouve ses petits
+	   DBENTRY      => "DeskJet670",                    #-entry in printer database for this printer  
+	
+	   RESOLUTION   => "NAxNA",                         #-ghostscript resolution to use
+	   PAPERSIZE    => "letter",                        #-Papersize
+	   BITSPERPIXEL => "necp2x6",                       #-ghostscript color option                    
+	   CRLF         => 1 ,                              #-Whether or not to do CR/LF xlation         
+	
+	   TYPE         => "LOCAL",
+	
+	   #- LOCAL
+	   DEVICE   => "/dev/device",                       #-Print device
+	   
+	   #- REMOTE (lpd) printers only 
+	   REMOTEHOST   => "remotehost",                     #-Remote host (not used for all entries)
+	   REMOTEQUEUE  => "remotequeue",                    #-Queue on the remote machine                
+	
+	
+	   #-SMB (LAN Manager) only 
+	   #- in spooldir/.config
+	   #-share='\\hostname\printername'
+	   #-hostip=1.2.3.4
+	   #-user='user'
+	   #-password='passowrd'
+	   #-workgroup='AS3'
+	   SMBHOST   => "hostname",                              #-Server name (NMB name, can have spaces)
+	   SMBHOSTIP => "1.2.3.4",                               #-Can optional specify and IP address for host
+	   SMBSHARE  => "printername",                           #-Name of share on the SMB server             
+	   SMBUSER   => "user",                                  #-User to log in as on SMB server             
+	   SMBPASSWD => "passowrd",                              #-Corresponding password                      
+	   SMBWORKGROUP => "AS3",                                #-SMB workgroup name                          
+	   AF        => "/var/spool/lpd/smbspool/acct",           #-accounting filter (needed for smbprint)
+	
+	   #- NCP (NetWare) only 
+	   #- in spooldir/.config
+	   #-server=printerservername
+	   #-queue=queuename
+	   #-user=user
+	   #-password=pass
+	   NCPHOST   => "printerservername",            #-Server name (NCP name)                      
+	   NCPQUEUE  => "queuename",                    #-Queue on server                             
+	   NCPUSER   => "user",                         #-User to log in as on NCP server             
+	   NCPPASSWD => "pass",                         #-Corresponding password                      
+			
+	  )
+	;
 
-   TYPE         => "LOCAL",
+=cut 
 
-   # LOCAL
-   DEVICE   => "/dev/device",                       #Print device
-   
-   # REMOTE (lpd) printers only 
-   REMOTEHOST   => "remotehost",                     #Remote host (not used for all entries)
-   REMOTEQUEUE  => "remotequeue",                    #Queue on the remote machine                
-
-
-   #SMB (LAN Manager) only 
-   # in spooldir/.config
-   #share='\\hostname\printername'
-   #hostip=1.2.3.4
-   #user='user'
-   #password='passowrd'
-   #workgroup='AS3'
-   SMBHOST   => "hostname",                              #Server name (NMB name, can have spaces)
-   SMBHOSTIP => "1.2.3.4",                               #Can optional specify and IP address for host
-   SMBSHARE  => "printername",                           #Name of share on the SMB server             
-   SMBUSER   => "user",                                  #User to log in as on SMB server             
-   SMBPASSWD => "passowrd",                              #Corresponding password                      
-   SMBWORKGROUP => "AS3",                                #SMB workgroup name                          
-   AF        => "/var/spool/lpd/smbspool/acct",           #accounting filter (needed for smbprint)
-
-   # NCP (NetWare) only 
-   # in spooldir/.config
-   #server=printerservername
-   #queue=queuename
-   #user=user
-   #password=pass
-   NCPHOST   => "printerservername",            #Server name (NCP name)                      
-   NCPQUEUE  => "queuename",                    #Queue on server                             
-   NCPUSER   => "user",                         #User to log in as on NCP server             
-   NCPPASSWD => "pass",                         #Corresponding password                      
-		
-  )
-;
-
-########################################################################################
-# INTERN CONSTANT
-########################################################################################
+#-#####################################################################################
+
+=head2 Intern constant
+
+=cut
+
+#-#####################################################################################
 my $PRINTER_NONE   = "NONE";
 my $PRINTER_LOCAL  = "LOCAL";
 my $PRINTER_LPRREM = "REMOTE";
 my $PRINTER_SMB    = "SMB";
 my $PRINTER_NCP    = "NCP";   
 
-########################################################################################
-# EXPORTED CONSTANT
-########################################################################################
+#-if we are in an panoramix config
+my $prefix = "";
 
+#-location of the printer database in an installed system
+my $PRINTER_DB_FILE    = "/usr/lib/rhs/rhs-printfilters/printerdb";
+my $PRINTER_FILTER_DIR = "/usr/lib/rhs/rhs-printfilters/";
 
-%printer_type = ("local"             => $PRINTER_LOCAL,
-		    "Remote lpd"        => $PRINTER_LPRREM,
-		    "SMB/Windows 95/NT" => $PRINTER_SMB,
-		    "NetWare"           => $PRINTER_NCP,   
-		   );                                 
 
-%printer_type_inv = reverse %printer_type;
 
-@papersize_type = qw(letter legal ledger a3 a4);
+#-#####################################################################################
 
+=head2 Exported constant
 
-########################################################################################
-# GLOBALS
-########################################################################################
+=cut
 
-#db of all entries in the printerdb file
+#-#####################################################################################
 
-#if we are in an panoramix config
-my $prefix = "";
+%printer_type = ("local"             => $PRINTER_LOCAL,
+		 "Remote lpd"        => $PRINTER_LPRREM,
+		 "SMB/Windows 95/NT" => $PRINTER_SMB,
+		 "NetWare"           => $PRINTER_NCP,   
+		);                                 
+%printer_type_inv = reverse %printer_type;
 
-# location of the printer database in an installed system
-my $PRINTER_DB_FILE    = "/usr/lib/rhs/rhs-printfilters/printerdb";
-my $PRINTER_FILTER_DIR = "/usr/lib/rhs/rhs-printfilters/";
-my $SPOOLDIR           = "/var/spool/lpd/";
+%fields = ( 
+	   STANDARD => [qw(QUEUE SPOOLDIR IF )],
+	   SPEC     => [qw(DBENTRY RESOLUTION PAPERSIZE BITSPERPIXEL CRLF )],
+	   LOCAL    => [qw(DEVICE)],
+	   REMOTE   => [qw(REMOTEHOST REMOTEQUEUE)],
+	   SMB      => [qw(SMBHOST SMBHOSTIP SMBSHARE SMBUSER SMBPASSWD SMBWORKGROUP AF)],
+	   NCP      => [qw(NCPHOST NCPQUEUE NCPUSER NCPPASSWD)],
+	  );
+@papersize_type = qw(letter legal ledger a3 a4);
+$spooldir       = "/var/spool/lpd/";
+
+#-#####################################################################################
 
-########################################################################################
-# FUNCTIONS
-########################################################################################
+=head2 Functions
+
+=cut
+
+#-#####################################################################################
 
 sub set_prefix($) {
     $prefix = shift;
 }
-#******************************************************************************
-# read function
-#******************************************************************************
+#-*****************************************************************************
+#- read function
+#-*****************************************************************************
 #------------------------------------------------------------------------------
-#Read the printer database from dbpath into memory
+#- Read the printer database from dbpath into memory
 #------------------------------------------------------------------------------
 sub read_printer_db(;$) {
     my ($dbpath) = @_;
     
-    #$dbpath = $dbpath ? $dbpath : $DB_PRINTER_FILTER;
+    #-$dbpath = $dbpath ? $dbpath : $DB_PRINTER_FILTER;
     $dbpath ||= $PRINTER_DB_FILE;
     $dbpath = "${prefix}$dbpath";
-      
 
     %thedb and return;
 
-    local *DBPATH;		#don't have to do close
+    local *DBPATH;		#-don't have to do close
     open DBPATH, "<$dbpath" or die "An error has occurred on $dbpath : $!";
       
     while (<DBPATH>) {
@@ -274,12 +325,12 @@ sub read_printer_db(;$) {
 }
 
 
-#******************************************************************************
-# write functions 
-#******************************************************************************
+#-******************************************************************************
+#- write functions 
+#-******************************************************************************
 
 #------------------------------------------------------------------------------
-# given the path queue_path, we create all the required spool directory
+#- given the path queue_path, we create all the required spool directory
 #------------------------------------------------------------------------------
 sub create_spool_dir($) {
     my ($queue_path) = @_;
@@ -289,7 +340,7 @@ sub create_spool_dir($) {
 	mkdir "$complete_path", 0755
 	  or die "An error has occurred - can't create $complete_path : $!";
 	
-	#redhat want that "drwxr-xr-x root lp"
+	#-redhat want that "drwxr-xr-x root lp"
 	my $gid_lp = (getpwnam("lp"))[3];
 	chown 0, $gid_lp, $complete_path 
 	  or die "An error has occurred - can't chgrp $complete_path to lp $!";
@@ -297,10 +348,10 @@ sub create_spool_dir($) {
 }
 
 #------------------------------------------------------------------------------
-#given the input spec file 'input', and the target output file 'output'
-#we set the fields specified by fieldname to the values in fieldval    
-#nval  is the number of fields to set                                  
-#Doesnt currently catch error exec'ing sed yet                         
+#-given the input spec file 'input', and the target output file 'output'
+#-we set the fields specified by fieldname to the values in fieldval    
+#-nval  is the number of fields to set                                  
+#-Doesnt currently catch error exec'ing sed yet                         
 #------------------------------------------------------------------------------
 sub create_config_file($$%) {
     my ($inputfile, $outpufile, %toreplace) = @_;
@@ -308,7 +359,7 @@ sub create_config_file($$%) {
     local *OUT;
     local *IN;
     
-    #TODO my $oldmask = umask 0755;
+    #-TODO my $oldmask = umask 0755;
 
     open IN , "<$in"  or die "Can't open $in $!";
     if ($::testing) {
@@ -333,14 +384,13 @@ sub create_config_file($$%) {
 
 
 #------------------------------------------------------------------------------
-#copy master filter to the spool dir
+#-copy master filter to the spool dir
 #------------------------------------------------------------------------------
 sub copy_master_filter($) {
     my ($queue_path) = @_;
     my $complete_path = "${prefix}${queue_path}filter";
     my $master_filter = "${prefix}${PRINTER_FILTER_DIR}master-filter";
 
-
     unless ($::testing) {
 	commands::cp($master_filter, $complete_path) or die "Can't copy $master_filter to $complete_path $!";
     } 
@@ -349,8 +399,8 @@ sub copy_master_filter($) {
 }
 
 #------------------------------------------------------------------------------
-# given a PrintCap Entry, create the spool dir and special 
-# rhs-printfilters related config files which are required
+#- given a PrintCap Entry, create the spool dir and special 
+#- rhs-printfilters related config files which are required
 #------------------------------------------------------------------------------
 my $intro_printcap_test="
 #
@@ -368,16 +418,16 @@ my $intro_printcap_test="
 sub configure_queue($) {
     my ($entry) = @_;
 
-    $entry->{SPOOLDIR} ||= "$SPOOLDIR";
-    $entry->{IF}       ||= "$SPOOLDIR$entry->{QUEUE}/filter";
-    $entry->{AF}       ||= "$SPOOLDIR$entry->{QUEUE}/acct";
+    $entry->{SPOOLDIR} ||= "$spooldir";
+    $entry->{IF}       ||= "$spooldir$entry->{QUEUE}/filter";
+    $entry->{AF}       ||= "$spooldir$entry->{QUEUE}/acct";
     
     my $queue_path      = "$entry->{SPOOLDIR}";
     create_spool_dir($queue_path);
 
     my $get_name_file = sub { 
 	my ($name) = @_; 
-	("${PRINTER_FILTER_DIR}$name.in)", "$entry->{SPOOLDIR}$name")
+	("${PRINTER_FILTER_DIR}$name.in", "$entry->{SPOOLDIR}$name")
     };
     my ($filein, $file);
     my %fieldname = ();
@@ -392,7 +442,7 @@ sub configure_queue($) {
       "NO" : "YES";
     create_config_file($filein,$file, %fieldname);
 
-    # successfully created general.cfg, now do postscript.cfg 
+    #- successfully created general.cfg, now do postscript.cfg 
     ($filein, $file) = &$get_name_file("postscript.cfg");
     %fieldname = ();
     $fieldname{gsdevice}       = $dbentry->{GSDRIVER};
@@ -415,7 +465,7 @@ sub configure_queue($) {
     $fieldname{topbotmar}      = "18";
     create_config_file($filein, $file, %fieldname);
 	
-    # finally, make textonly.cfg
+    #- finally, make textonly.cfg
     ($filein, $file) = &$get_name_file("textonly.cfg");
     %fieldname = ();
     $fieldname{textonlyoptions} = "";
@@ -426,7 +476,7 @@ sub configure_queue($) {
 	
     unless ($::testing) {
 	if ($entry->{TYPE} eq $PRINTER_SMB) {
-	    # simple config file required if SMB printer
+	    #- simple config file required if SMB printer
 	    my $config_file = "${prefix}${queue_path}.config";
 	    local *CONFFILE;
 	    open CONFFILE, ">$config_file" or die "Can't create $config_file $!";
@@ -436,7 +486,7 @@ sub configure_queue($) {
 	    print CONFFILE "password='$entry->{SMBPASSWD}'\n";
 	    print CONFFILE "workgroup='$entry->{SMBWORKGROUP}'\n";
 	} elsif ($entry->{TYPE} eq $PRINTER_NCP) {
-	    # same for NCP printer
+	    #- same for NCP printer
 	    my $config_file = "${prefix}${queue_path}.config";
 	    local *CONFFILE;
 	    open CONFFILE, ">$config_file" or die "Can't create $config_file $!";
@@ -449,7 +499,7 @@ sub configure_queue($) {
 
     copy_master_filter($queue_path);
 
-    #now the printcap file
+    #-now the printcap file
     local *PRINTCAP;
     if ($::testing) {
 	open PRINTCAP, ">${prefix}etc/printcap" or die "Can't open printcap file $!";
@@ -479,28 +529,23 @@ sub configure_queue($) {
 	print PRINTCAP "\t:rm=$entry->{REMOTEHOST}:\\\n";
 	print PRINTCAP "\t:rp=$entry->{REMOTEQUEUE}:\\\n";
     } else {
-	# (pcentry->Type == (PRINTER_SMB | PRINTER_NCP))
+	#- (pcentry->Type == (PRINTER_SMB | PRINTER_NCP))
 	print PRINTCAP "\t:lp=/dev/null:\\\n";
 	print PRINTCAP "\t:af=$entry->{SPOOLDIR}acct\\\n";
     }
 
-    # cheating to get the input filter!
+    #- cheating to get the input filter!
     print PRINTCAP "\t:if=$entry->{SPOOLDIR}filter:\n";
 	
 }
 
 
 #------------------------------------------------------------------------------
-#interface function 
+#- interface function 
 #------------------------------------------------------------------------------
 
-sub 
-#pixel stuff
-my ($o, $in);
-    
-
 #------------------------------------------------------------------------------
-#fonction de test
+#- fonction de test
 #------------------------------------------------------------------------------
 sub test {
     $::testing = 1;
@@ -532,7 +577,13 @@ sub test {
     #printer::configure_queue(\%printer::ex_printcap_entry, "/");
 }
 
-########################################################################################
-# Wonderful perl :(
-########################################################################################
+#-######################################################################################
+#- Wonderful perl :(
+#-######################################################################################
 1; # 
+
+=head1 AUTHOR
+
+pad.
+
+=cut