diff options
| author | Tom Lane <tgl@sss.pgh.pa.us> | 2015-12-13 23:42:54 -0500 |
|---|---|---|
| committer | Tom Lane <tgl@sss.pgh.pa.us> | 2015-12-13 23:42:54 -0500 |
| commit | 20f85bc50beae343d921e4992dcadce80b09c404 (patch) | |
| tree | a5bc0879e65116d3a9264cce49dac8dc6f2523bc | |
| parent | f2ce8f2b93cb73d8384064b5d4b4a69412871b8a (diff) | |
| download | postgresql-20f85bc50beae343d921e4992dcadce80b09c404.tar.gz postgresql-20f85bc50beae343d921e4992dcadce80b09c404.zip | |
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.
| -rw-r--r-- | doc/src/sgml/ref/psql-ref.sgml | 12 |
1 files changed, 11 insertions, 1 deletions
diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml index ecc509f84cb..de5ce8568ae 100644 --- a/doc/src/sgml/ref/psql-ref.sgml +++ b/doc/src/sgml/ref/psql-ref.sgml @@ -176,7 +176,10 @@ EOF <para> If <replaceable>filename</replaceable> is <literal>-</literal> - (hyphen), then standard input is read. + (hyphen), then standard input is read until an EOF indication + or <command>\q</> meta-command. Note however that Readline + is not used in this case (much as if <option>-n</option> had been + specified). </para> <para> @@ -1646,6 +1649,13 @@ Tue Oct 26 21:40:57 CEST 1999 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 |