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

tglsfdc · tglsfdc · commit 7bd149ce2aa6 · 2015-12-13T23:42:54.000-05:00
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
@@ -1838,6 +1838,13 @@ hello 10
         class="parameter">filename</replaceable> and executes it as
         though it had been typed on the keyboard.
         </para>
+        <para>
+        If <replaceable>filename</replaceable> is <literal>-</literal>
+        (hyphen), then standard input is read until an EOF indication
+        or <command>\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.
+        </para>
         <note>
         <para>
         If you want to see the lines on the screen as they are read you
