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 | 6436445e9f311bc833d052c0fc39055fcbe09276 (patch) | |
| tree | 6c126a098332d22afa753e6abc221b8badd3d39c | |
| parent | 83497deb7d424952511aa933a954f36b487dd0cf (diff) | |
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 0cf84ca16cb..60571c5f7fc 100644 --- a/doc/src/sgml/ref/psql-ref.sgml +++ b/doc/src/sgml/ref/psql-ref.sgml @@ -179,7 +179,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> @@ -1688,6 +1691,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 |