conventions

this book uses the following typographical conventions to mark certain portions of text: new terms, foreign phrases, and other important passages are emphasized in italics. everything that represents input or output of the computer, in particular commands, program code, and screen output, is shown in a monospaced font (example). within such passages, italics (example) indicate placeholders; you must insert an actual value instead of the placeholder. on occasion, parts of program code are emphasized in bold face (example), if they have been added or changed since the preceding example.

the following conventions are used in the synopsis of a command: brackets ([ and ]) indicate optional parts. (in the synopsis of a tcl command, question marks (?) are used instead, as is usual in tcl.) braces ({ and }) and vertical lines (|) indicate that you must choose one alternative. dots (...) mean that the preceding element can be repeated.

where it enhances the clarity, sql commands are preceded by the prompt =>, and shell commands are preceded by the prompt $. normally, prompts are not shown, though.

an administrator is generally a person who is in charge of installing and running the server. a user could be anyone who is using, or wants to use, any part of the postgresql system. these terms should not be interpreted too narrowly; this book does not have fixed presumptions about system administration procedures.