Docs: document that psql's "\i -" means read from stdin.

This has worked that way for a long time, maybe always, but you would
not have known it from the documentation.  Also back-patch the notes
I added to HEAD earlier today about behavior of the "-f -" switch,
which likewise have been valid for many releases.

diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml
index 4bc9e610a0c92a5ecfb80f6fa973c1b6f6f6c5d9..b15f75e7d8482cca617eccc195190d80665116a2 100644 (file)
--- a/doc/src/sgml/ref/psql-ref.sgml
+++ b/doc/src/sgml/ref/psql-ref.sgml
@@ -180,7 +180,10 @@ EOF
 
       
        If filename is -
-       (hyphen), then standard input is read.
+       (hyphen), then standard input is read until an EOF indication
+       or \q meta-command.  Note however that Readline
+       is not used in this case (much as if -n had been
+       specified).
       
 
       
@@ -1764,6 +1767,13 @@ hello 10
         class="parameter">filename and executes it as
         though it had been typed on the keyboard.
         
+        
+        If filename is -
+        (hyphen), then standard input is read until an EOF indication
+        or \q meta-command.  This can be used to intersperse
+        interactive input with input from files.  Note that Readline behavior
+        will be used only if it is active at the outermost level.
+        
         
         
         If you want to see the lines on the screen as they are read you