From 7d136b3802b95da5e3ccca9e9e996c75842c949d Mon Sep 17 00:00:00 2001
From: David MacMahon <davidm@astro.berkeley.edu>
Date: Thu, 7 Jan 2010 10:53:50 -0800
Subject: [PATCH 1/2] Documentation for PLPLOT_DEV enrironment variable

This adds details to the docbook documentation about the newly supported
PLPLOT_DEV environment variable.
---
 doc/docbook/src/advanced.xml |   16 +++++++++++++---
 1 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/doc/docbook/src/advanced.xml b/doc/docbook/src/advanced.xml
index c40ab69..1ab1fcb 100644
--- a/doc/docbook/src/advanced.xml
+++ b/doc/docbook/src/advanced.xml
@@ -598,9 +598,10 @@ EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 	all internal data structures necessary for plotting and initializes
 	the output device driver.  The output device can be a terminal, disk
 	file, window system, pipe, or socket.  If the output device has not
-	already been specified when &plinit; is called, a list of valid
-	output devices is given and the user is prompted for a choice.  For
-	example:
+	already been specified when &plinit; is called, the output device
+	will be taken from the value of the PLPLOT_DEV environment variable.
+	If this variable is not set (or is empty), a list of valid output
+	devices is given and the user is prompted for a choice.  For example:
       </para>
       
       <para>
@@ -651,6 +652,15 @@ EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 	      &plparseopts;.
 	    </para>
 	  </listitem>
+	  <listitem>
+	    <para>
+	      The value of the <literal>PLPLOT_DEV</literal> environment
+	      variable.  Note that specifying the output device via &plsdev;
+	      or the <literal>-dev</literal> command line argument will
+	      override the value given by the <literal>PLPLOT_DEV</literal>
+	      environment variable.
+	    </para>
+	  </listitem>
 	</itemizedlist>
 	
       </para>
-- 
1.6.6

