1.2.1 本手册中使用的约定

这本手册使用了一定文字格式的约定：

constant / 固定宽度

固定宽度字体用于命令名字和选择、SQL语句、数据库、表和列命名、C 和 Perl 代码、环境变量。例如：“为了了解mysqladmin如何工作，用--help选项调用它”。

'文件名'

有包围引号的固定宽度字体用于文件名和路径。例如：“发行版本被安装在'/usr/local/'目录下”。

'c'

有包围引号的固定宽度字体也用于指明字符序列。例如：“要指定一个通配符，使用'%'字符”。

斜体

斜体的字体被用于强调，like this 。

粗体 

粗体用于存取权限名字(例如，“不要轻易授权process权限”)并表达特别强调。

当命令显示出准备由一个特定的程序执行时，程序由命令所显示的提示符指出。例如，shell> 表明你从你的登录外壳执行一个命令，而mysql>表明你从mysql客户执行命令：

shell> 在这键入一个shell命令
mysql> 在这里键入一个mysql命令

shell命令用 Bourne shell语法显示。如果你正在使用csh风格的外壳，你可能需要用略微不同的方式发出命令。例如，设置一个环境变量和运行一个命令的序列在 Bourne shell语法看起来像这样：

shell> VARNAME=value some_command

对于csh，你将执行这样的序列：

shell> setenv VARNAME value
shell> some_command

数据库、表和列名字经常必须被代入命令中。为表明这种代入是必要的，本手册使用db_name、tbl_name和col_name。例如，你可能看到象这样的语句：

mysql> SELECT col_name FROM db_name.tbl_name;

这意味着如果你想输入类似的语句，你将提供你自己数据库、表和列的名字，也许像这样：

mysql> SELECT author_name FROM biblio_db.author_list;

SQL语句可以写成大写或小写的。当本手册显示SQL语句时，如果讨论这些关键字，大写被用于特定的关键字(强调它们)而小写被用于语句的其他部分。因此你可能在讨论SELECT语句时看到如下显示：

mysql> SELECT count(*) FROM tbl_name;

另一方面，在讨论COUNT()函数时，语句将写成这样：

mysql> select COUNT(*) from tbl_name;

如果不有意地特别强调，所有的关键字一律写成大写。

在句法描述中，方括号('['和']')被用来表示任选的词或子句：

DROP TABLE [IF EXISTS] tbl_name

当一个语法元素由很多选择组成时，各选择用垂直线分开('|')。当可能从一组选择中选择一个成员时，选择在方括号内被列出。当必须从一组选择中选择一个成员时，选择在花括号内被列出('{'和'}')：

TRIM([[BOTH | LEADING | TRAILING] [remstr] FROM] str)
{DESCRIBE | DESC} tbl_name {col_name | wild}

这本手册使用了一定文字格式的约定：

constant / 固定宽度

固定宽度字体用于命令名字和选择、SQL语句、数据库、表和列命名、C 和 Perl 代码、环境变量。例如：“为了了解mysqladmin如何工作，用--help选项调用它”。

'文件名'

有包围引号的固定宽度字体用于文件名和路径。例如：“发行版本被安装在'/usr/local/'目录下”。

'c'

有包围引号的固定宽度字体也用于指明字符序列。例如：“要指定一个通配符，使用'%'字符”。

斜体

斜体的字体被用于强调，like this 。

粗体 

粗体用于存取权限名字(例如，“不要轻易授权process权限”)并表达特别强调。

当命令显示出准备由一个特定的程序执行时，程序由命令所显示的提示符指出。例如，shell> 表明你从你的登录外壳执行一个命令，而mysql>表明你从mysql客户执行命令：

shell> 在这键入一个shell命令
mysql> 在这里键入一个mysql命令

shell命令用 Bourne shell语法显示。如果你正在使用csh风格的外壳，你可能需要用略微不同的方式发出命令。例如，设置一个环境变量和运行一个命令的序列在 Bourne shell语法看起来像这样：

shell> VARNAME=value some_command

对于csh，你将执行这样的序列：

shell> setenv VARNAME value
shell> some_command

数据库、表和列名字经常必须被代入命令中。为表明这种代入是必要的，本手册使用db_name、tbl_name和col_name。例如，你可能看到象这样的语句：

mysql> SELECT col_name FROM db_name.tbl_name;

这意味着如果你想输入类似的语句，你将提供你自己数据库、表和列的名字，也许像这样：

mysql> SELECT author_name FROM biblio_db.author_list;

SQL语句可以写成大写或小写的。当本手册显示SQL语句时，如果讨论这些关键字，大写被用于特定的关键字(强调它们)而小写被用于语句的其他部分。因此你可能在讨论SELECT语句时看到如下显示：

mysql> SELECT count(*) FROM tbl_name;

另一方面，在讨论COUNT()函数时，语句将写成这样：

mysql> select COUNT(*) from tbl_name;

如果不有意地特别强调，所有的关键字一律写成大写。

在句法描述中，方括号('['和']')被用来表示任选的词或子句：

DROP TABLE [IF EXISTS] tbl_name

当一个语法元素由很多选择组成时，各选择用垂直线分开('|')。当可能从一组选择中选择一个成员时，选择在方括号内被列出。当必须从一组选择中选择一个成员时，选择在花括号内被列出('{'和'}')：

TRIM([[BOTH | LEADING | TRAILING] [remstr] FROM] str)
{DESCRIBE | DESC} tbl_name {col_name | wild}