From f6689a328f07fe579d57c1a419fd8b53db7499c7 Mon Sep 17 00:00:00 2001 From: Peter Eisentraut Date: Wed, 12 Jan 2000 19:36:36 +0000 Subject: Fixed a few "fixes" and bugs. Adjusted messages and options to GNU suggestions. --- doc/src/sgml/ref/createuser.sgml | 4 +- doc/src/sgml/ref/dropuser.sgml | 4 +- doc/src/sgml/ref/psql-ref.sgml | 89 ++++++---------------------------------- 3 files changed, 17 insertions(+), 80 deletions(-) (limited to 'doc/src') diff --git a/doc/src/sgml/ref/createuser.sgml b/doc/src/sgml/ref/createuser.sgml index dc0eeb8edce..cf8ff8dfee2 100644 --- a/doc/src/sgml/ref/createuser.sgml +++ b/doc/src/sgml/ref/createuser.sgml @@ -1,5 +1,5 @@ @@ -177,7 +177,7 @@ createuser [ options ] [ - createuser: Creation of user "username" failed. + createuser: creation of user "username" failed Something went wrong. The user was not created. diff --git a/doc/src/sgml/ref/dropuser.sgml b/doc/src/sgml/ref/dropuser.sgml index 80a2a715762..398bde28e1c 100644 --- a/doc/src/sgml/ref/dropuser.sgml +++ b/doc/src/sgml/ref/dropuser.sgml @@ -1,5 +1,5 @@ @@ -127,7 +127,7 @@ dropuser [ options ] [ - dropuser: Deletion of user "username" failed. + dropuser: deletion of user "username" failed Something went wrong. The user was not removed. diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml index b24acf0e4f7..5c92e5fbd1b 100644 --- a/doc/src/sgml/ref/psql-ref.sgml +++ b/doc/src/sgml/ref/psql-ref.sgml @@ -1,5 +1,5 @@ @@ -352,7 +352,7 @@ testdb=> - The command form \d? is identical, but any comments + The command form \d+ is identical, but any comments associated with the table columns are shown as well. @@ -375,10 +375,6 @@ testdb=> Lists all available aggregate functions, together with the data type they operate on. If pattern (a regular expression) is specified, only matching aggregates are shown. - If the alternative command form \da? is used, - comments are listed for each function as well. The command form - \da+ will show more information about each aggregate - function, which is usually not of general interest. @@ -426,8 +422,7 @@ testdb=> If pattern (a regular expression) is specified, only matching functions are shown. If the form \df+ is used, additional information about - each function is shown. Comments for each function can be shown with - the \df? form. + each function, including language and description is shown. @@ -447,7 +442,7 @@ testdb=> If pattern is specified, it is a regular expression restricts the listing to those objects - whose name matches. If one appends a ? to the command name, + whose name matches. If one appends a + to the command name, each object is listed with its associated description, if any. @@ -476,10 +471,6 @@ testdb=> interpretation of the backslash as a new command, you might also wish to quote the argument.) - - If the form \do? is used, comments are listed for - each operator. - @@ -500,8 +491,7 @@ testdb=> Lists all data types or only those that match pattern. - The command forms \dT+ and \dT? show extra information - and the associated descriptions of the types, respectively. + The command form \dT+ shows extra information. @@ -648,7 +638,7 @@ Tue Oct 26 21:40:57 CEST 1999 List all the databases in the server as well as their owners. Append a - ? (question mark) to the command name to see any descriptions + + to the command name to see any descriptions for the databases as well. If your PostgreSQL installation was compiled with multibyte encoding support, the encoding scheme of each @@ -723,8 +713,6 @@ lo_import 152801 Shows a list of all PostgreSQL large objects currently stored in the database along with their owners. - Append a question mark to the command name (\lo_list?) to - see the the associated comments as well. @@ -1203,11 +1191,9 @@ Access permissions for database "test" If so configured, psql understands both standard - Unix short options, and GNU-style long options. Since the - latter are not available on all systems, you are advised to consider carefully - whether to use them, if you are writing scripts, etc. For support on the - PostgreSQL mailing lists, you are asked to only - use the standard short options. + Unix short options, and GNU-style long options. The latter + are not available on all systems, so you are advised to consider carefully + whether to use them. @@ -1301,7 +1287,7 @@ Access permissions for database "test" - -F, --field-sep separator + -F, --field-separator separator Use separator as the field separator. @@ -1358,7 +1344,7 @@ Access permissions for database "test" - -o, --out filename + -o, --output filename Put all query output into file filename. @@ -1400,8 +1386,7 @@ Access permissions for database "test" Specifies that psql should do its work quietly. - By default, it prints welcome messages, various informational output and - prompts for each query. + By default, it prints welcome messages and various informational output. If this option is used, none of this happens. This is useful with the option. Within psql you can also set the quiet variable to achieve the same effect. @@ -1511,35 +1496,7 @@ Access permissions for database "test" -V, --version - Shows version information about psql and your - PostgreSQL database server, if it could be reached. - - - - The output looks similar to this: - -~$ psql -V -Server: PostgreSQL 6.5.2 on i586-pc-linux-gnu, compiled by egcs -psql 6.6.0 on i586-pc-linux-gnu, compiled by gcc 2.8.1 (Oct 27 1999 15:15:04), long options, -readline, history, locale, assert checks - - The Server line is identical to the one returned by the - backend function version() and thus might vary - if you query different servers by using different connection - options. - - - - The psql line is compiled into the psql - binary. It shows you which PostgreSQL release - it was distributed with and what optional features were compiled into it. - Although in general (as in the example above) you can use psql - and database servers from different versions (if they don't differ too much) - this is not recommended or - even necessary. The optional features indicate only psql's - capabilities but if psql was configured with - the same source tree as the rest of the distribution, it gives you an - indication about other parts of the installation as well. + Shows the psql version. @@ -2149,26 +2106,6 @@ Field separator is "oo". - - History and Lineage - - - psql first appeared in Postgres95 - to complement and later replace the monitor program. (You see this - name here or there in really old files. The author has never had the pleasure to use this - program though.) An uncountable number of people have added features since to reflect - the enhancements in the actual database server. - - - - The present version is the result of a major clean-up and re-write in 1999 by - Peter Eisentraut in preparation for release 7.0. - Many people had again contributed their ideas. A bunch of features were stolen - from various shells (in case you hadn't noticed), in particular - tcsh. - - - <acronym>GNU</acronym> readline -- cgit v1.2.3