Still mostly empty but add info on PAGER env variable and general paging

 behavior from Brett McCormick.

diff --git a/doc/src/sgml/psql.sgml b/doc/src/sgml/psql.sgml
index 3019396de7aa3f0647a8e30a02cec1510a7fd4b0..28ff1cd9a24b369fb5c6de551684a884b066163c 100644 (file)
--- a/doc/src/sgml/psql.sgml
+++ b/doc/src/sgml/psql.sgml
@@ -2,7 +2,42 @@
 <Title><Command>psql</Command></Title>
 
 <Para>
-This section needs to be written. Volunteers?
+This section needs to be converted from the original psql man page. Volunteers?
 </Para>
 
+<Tip>
+<Para>
+To change the paging behavior of your results, set/unset your PAGER environment variable.
+</Para>
+</Tip>
+
+<Sect1>
+<Title>Paging To Screen</Title>
+
+<Note>
+<Title>Author</Title>
+<Para>
+From Brett McCormick on the mailing list 1998-04-04.
+</Para>
+</Note>
+
+<Para>
+To affect the paging behavior of your <Command>psql</Command> output,
+set or unset your PAGER environment variable.  I always have to set mine
+before it will pause.  And of course you have to do this before
+starting the program.
+
+<Para>
+In csh/tcsh or other C shells:
+
+<ProgramListing>
+  unsetenv PAGER
+</ProgramListing>
+
+while in sh/bash or other Bourne shells:
+
+<ProgramListing>
+  unset PAGER
+</ProgramListing>
+
 </Chapter>