Brief documentation on using the virtual printer code

1 files changed, 35 insertions, 2 deletions

diff --git a/testsuite/printing/README.vlp b/testsuite/printing/README.vlp
index e3cf31c7e40..48d2c8c0a2b 100644
--- 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.
+	
+