Also show $tree in diagnostics.

[ira/wip.git] / testsuite / printing / README.vlp

diff --git a/testsuite/printing/README.vlp b/testsuite/printing/README.vlp
index e3cf31c7e4044a437826c551cbae294e0592072b..48d2c8c0a2b05fa304d0bc3f3f363751e999342e 100644 (file)
--- a/testsuite/printing/README.vlp
+++ b/testsuite/printing/README.vlp
@@ -1,2 +1,35 @@
-This file should contain some documentation on using the virtual
-line printer test program.
+Virtual line printer test program (vlp)
+=======================================
+
+This can be useful for testing/debugging Samba print code.  It gives you a 
+virtual full-function printer.
+
+Setup
+
+1) Configure and build Samba.  
+       For this to work, you need to add:
+               -DDEVELOPER
+       to your CFLAGS, and add:
+               --srcdir=<wherever your source is>
+       when running configure.  Generally      
+               ./configure --srcdir=`pwd` <other configure options>
+       should work. 
+
+2) Build and install vlp.
+       # cd testsuite/printing
+       # make -f Makefile.vlp vlp
+       # su
+       # cp vlp /usr/local/samba/bin
+
+3) Set up Samba to use vlp.
+       In your smb.conf file under [global], add the following option:
+               printing = vlp
+       and then add any number of print shares, without needing to make them 
+       really exist.  
+
+               [testprinter]
+                       printable = yes
+
+       is all you need for the most basic virtual printer.
+       
+