summaryrefslogtreecommitdiffstats
path: root/doc/src/sgml/notation.sgml
blob: c3798d5f1bed9f59806a24c45e9a522a7f9d46d8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
<!-- doc/src/sgml/notation.sgml -->

<sect1 id="notation">
 <title>Conventions</title>

 <para>
  The following conventions are used in the synopsis of a command:
  brackets (<literal>[</literal> and <literal>]</literal>) indicate
  optional parts.  Braces
  (<literal>{</literal> and <literal>}</literal>) and vertical lines
  (<literal>|</literal>) indicate that you must choose one
  alternative.  Dots (<literal>...</literal>) mean that the preceding element
  can be repeated.  All other symbols, including parentheses, should be
  taken literally.
 </para>

 <para>
  Where it enhances the clarity, SQL commands are preceded by the
  prompt <literal>=&gt;</literal>, and shell commands are preceded by the
  prompt <literal>$</literal>.  Normally, prompts are not shown, though.
 </para>

 <para>
  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
  be interpreted too narrowly; this book does not have fixed
  presumptions about system administration procedures.
 </para>
</sect1>