2006-03-10 20:10:50 +01:00
|
|
|
<!-- $PostgreSQL: pgsql/doc/src/sgml/notation.sgml,v 1.27 2006/03/10 19:10:48 momjian Exp $ -->
|
2000-03-31 05:27:42 +02:00
|
|
|
|
2001-02-03 20:03:27 +01:00
|
|
|
<sect1 id="notation">
|
2003-09-09 01:02:28 +02:00
|
|
|
<title>Conventions</title>
|
1998-09-30 07:41:54 +02:00
|
|
|
|
1999-05-27 17:49:08 +02:00
|
|
|
<para>
|
2003-09-09 01:02:28 +02:00
|
|
|
This book uses the following typographical conventions to mark
|
2003-09-09 01:17:15 +02:00
|
|
|
certain portions of text: new terms, foreign phrases, and other
|
2003-09-09 01:02:28 +02:00
|
|
|
important passages are emphasized in <emphasis>italics</>.
|
|
|
|
Everything that represents input or output of the computer, in
|
|
|
|
particular commands, program code, and screen output, is shown in a
|
2003-09-09 01:17:15 +02:00
|
|
|
monospaced font (<literal>example</literal>). Within such
|
|
|
|
passages, italics (<replaceable>example</replaceable>) indicate
|
|
|
|
placeholders; you must insert an actual value instead of the placeholder.
|
|
|
|
On occasion, parts of program code are emphasized in bold face
|
2003-09-09 01:02:28 +02:00
|
|
|
(<emphasis role="bold"><literal>example</></>), if they have been
|
|
|
|
added or changed since the preceding example.
|
1999-05-27 17:49:08 +02:00
|
|
|
</para>
|
1998-09-30 07:41:54 +02:00
|
|
|
|
1999-05-27 17:49:08 +02:00
|
|
|
<para>
|
2003-09-09 01:02:28 +02:00
|
|
|
The following conventions are used in the synopsis of a command:
|
|
|
|
brackets (<literal>[</literal> and <literal>]</literal>) indicate
|
|
|
|
optional parts. (In the synopsis of a Tcl command, question marks
|
|
|
|
(<literal>?</>) are used instead, as is usual in Tcl.) Braces
|
|
|
|
(<literal>{</literal> and <literal>}</literal>) and vertical lines
|
|
|
|
(<literal>|</literal>) indicate that you must choose one
|
|
|
|
alternative. Dots (<literal>...</>) mean that the preceding element
|
|
|
|
can be repeated.
|
1999-05-27 17:49:08 +02:00
|
|
|
</para>
|
1998-10-25 02:24:36 +02:00
|
|
|
|
1999-05-27 17:49:08 +02:00
|
|
|
<para>
|
2003-09-09 01:02:28 +02:00
|
|
|
Where it enhances the clarity, SQL commands are preceded by the
|
|
|
|
prompt <literal>=></>, and shell commands are preceded by the
|
|
|
|
prompt <literal>$</>. Normally, prompts are not shown, though.
|
1999-05-27 17:49:08 +02:00
|
|
|
</para>
|
1998-10-25 02:24:36 +02:00
|
|
|
|
1999-05-27 17:49:08 +02:00
|
|
|
<para>
|
2003-09-09 01:02:28 +02:00
|
|
|
An <firstterm>administrator</firstterm> is generally a person who is
|
|
|
|
in charge of installing and running the server. A <firstterm>user</firstterm>
|
|
|
|
could be anyone who is using, or wants to use, any part of the
|
|
|
|
<productname>PostgreSQL</productname> system. These terms should not
|
2003-09-13 00:17:24 +02:00
|
|
|
be interpreted too narrowly; this book does not have fixed
|
2003-09-09 01:02:28 +02:00
|
|
|
presumptions about system administration procedures.
|
1999-05-27 17:49:08 +02:00
|
|
|
</para>
|
1998-10-25 02:24:36 +02:00
|
|
|
</sect1>
|