docs: add more docs for optional arguments.

Author: fky2015

Diff for: bithesis.dtx

@@ -223,6 +223,37 @@
 %   \end{document}
 % \end{latex}
 %
+% 如您所见，在 \LaTeX 中，用户使用的命令通常以「\\」作为开头，后面依次跟随
+% 命令名称、若干可选参数和若干必需参数。如：
+%
+% \begin{latex}
+%   \MakeCover
+%   \BITSetup{}
+%   \FooBar[]{}
+% \end{latex}
+%
+% 同理，用户使用的环境通常以 begin 和 end 进行包裹，同样可以传入可选参数和必需参数：
+%
+% \begin{latex}
+%   \begin{abstract}
+%   \end{abstract}
+%
+%   \begin{abstract}[addTOC=false]
+%   \end{abstract}
+%
+%   \begin{foo}{param1}
+%   \end{foo}
+% \end{latex}
+%
+% 需要强调的是：以方框号表示的可选参数，在没有参数传入的时候，是可以忽略的。
+% 比如以下两个命令等价：
+% \begin{latex}
+%   \FooBar
+%   \FooBar[]
+% \end{latex}
+%
+% 环境同理。
+%
 % \subsection{模板选项}
 %
 % 所谓“模板选项”，指需要在引入文档类的时候指定的选项：
@@ -270,13 +301,13 @@
 % 本模板提供了一系列选项，可由您自行配置。载入文档类之后，以下所有选项均可通过统一的
 % 命令 \cs{BITSetup} 来设置。
 %
-% \cs{BITSetup} 的参数是一组由（英文）逗号隔开的选项列表，列表中的选项通常是 〈key〉 =
-% 〈value〉 的形式。部分选项的 〈value〉 可以省略。对于同一项，后面的设置将会覆盖前面的设
+% \cs{BITSetup} 的参数是一组由（英文）逗号隔开的选项列表，列表中的选项通常是 \meta{key} =
+% \meta{value} 的形式。部分选项的 \meta{value} 可以省略。对于同一项，后面的设置将会覆盖前面的设
 % 置。在下文的说明中，将用粗体表示默认值。
 %
 % \cs{BITSetup} 采用 LATEX3 风格的键值设置，支持不同类型以及多种层次的选项设定。键值列
 % 表中，“=”左右的空格不影响设置；但需注意，参数列表中不可以出现空行。
-% 与模板选项相同，布尔型的参数可以省略 〈选项〉 = true 中的“= true”。
+% 与模板选项相同，布尔型的参数可以省略 \meta{选项} = true 中的“= true”。
 % 另有一些选项包含子选项，如 cover 和 info 等。它们可以按如下两种等价方式来设定：
 %
 % \begin{latex}
@@ -664,6 +695,10 @@
 %     \begin{abstract}
 %        \meta{中文摘要}
 %     \end{abstract}
+%
+%     \begin{abstract}(*\oarg{可选参数}*)
+%        \meta{中文摘要}
+%     \end{abstract}
 %   \end{bitsyntax}
 % \end{function}
 %
@@ -672,18 +707,57 @@
 %     \begin{abstractEn}
 %        \meta{英文摘要}
 %     \end{abstractEn}
+%
+%     \begin{abstractEn}(*\oarg{可选参数}*)
+%        \meta{英文摘要}
+%     \end{abstractEn}
 %   \end{bitsyntax}
 % 
 %  摘要。
 %  
 %  摘要的最后会显示关键词，关键词通过 \cs{BITSetup} 录入。
+%
+% \end{function}
+%
+% \begin{function}{addTOC}
+%   \begin{bitsyntax}[emph={[1]addTOC}]
+%     addTOC = (*<(true)|false>*)
+%   \end{bitsyntax}
+%
+%  摘要的可选参数。
+%
+%  添加摘要到目录，默认开启。
 % \end{function}
 %
 % \begin{function}{\MakeTOC,\listoffigures,\listoftables}
 %
 %  绘制目录、插图目录与表格目录。
 % \end{function}
 %
+% \begin{function}{symbols}
+%   \begin{bitsyntax}[emph={[1]symbols}]
+%     \begin{symbols}(*\oarg{可选参数}*)
+%        \item[BIT] 北京理工大学的英文缩写
+%        \item[\LaTeX] 一个很棒的排版系统
+%     \end{symbols}
+%   \end{bitsyntax}
+% 
+%  主要符号对照表。
+%  
+%  主要符号对照表类似于一个列表环境，用以添加文章中使用的关键符号与缩略词。
+%
+% \end{function}
+%
+% \begin{function}{addTOC}
+%   \begin{bitsyntax}[emph={[1]addTOC}]
+%     addTOC = (*<(true)|false>*)
+%   \end{bitsyntax}
+%
+%  主要符号对照表的可选参数。
+%
+%  添加主要符号对照表到目录，默认开启。
+% \end{function}
+%
 % \subsection{正文部分}
 %
 % \begin{function}{\mainmatter}
@@ -734,15 +808,26 @@
 %   \textbf{样式} & \multicolumn{1}{c}{\textit{注1.} 内容……}       \\ \bottomrule
 %   \end{tabular}
 % }
+%
+% \subfloat[][proof样式]{
+%   \begin{tabular}{@{}cc@{}}
+%   \toprule
+%   \textbf{名称} & proof \\ \midrule
+%   \textbf{含义} & 证明        \\
+%   \textbf{样式} & \multicolumn{1}{c}{\textit{证明. } 内容…… 「证毕符号」}       \\ \bottomrule
+%   \end{tabular}
+% }
 % \label{tab:theorem}
 % \end{table}
 %
 % \subsection{后置部分}
 %
-% \begin{function}{\mainmatter}
+% \begin{function}{\backmatter}
 %
 %   声明后置部分开始。
 %
+%   会取消章节标题的的编号。
+%
 % \end{function}
 %
 % \begin{function}{conclusion}
@@ -774,7 +859,7 @@
 %
 % \begin{function}{appendices}
 %   \begin{bitsyntax}[emph={[1]appendices}]
-%     \begin{appendices}
+%     \begin{appendices}(*\oarg{可选参数}*)
 %       \section{附录A 题目}
 %          \meta{附录A 内容}
 %       \section{附录B 题目}
@@ -785,6 +870,45 @@
 %  附录。
 % \end{function}
 %
+% \begin{function}{chapterLevel}
+%   \begin{bitsyntax}[emph={[1]chapterLevel}]
+%     chapterLevel = (*<(false)|true>*)
+%   \end{bitsyntax}
+%
+%  附录的可选参数。
+%
+%  开启后，可以使用以「chapter」为顶层的附录格式。
+%
+%  \begin{latex}
+%    \begin{appendices}[chapterLevel=true]
+%       \chapter{附录A 题目}
+%          \meta{附录A 内容}
+%       \chapter{附录B 题目}
+%          \meta{附录B 内容}
+%    \end{appendices}
+%  \end{latex}
+% \end{function}
+%
+% \begin{function}{title}
+%   \begin{bitsyntax}[emph={[1]title}]
+%     title = (*\meta{字符串}*)
+%   \end{bitsyntax}
+%
+%  附录的可选参数。
+%
+%  可以覆盖附录的标题名称，默认为「附录」。
+% \end{function}
+%
+% \begin{function}{TOCTitle}
+%   \begin{bitsyntax}[emph={[1]TOCTitle}]
+%     TOCTitle = (*\meta{字符串}*)
+%   \end{bitsyntax}
+%
+%  附录的可选参数。
+%
+%  可以覆盖附录在目录中的名称，默认为「附录」。
+% \end{function}
+%
 % \begin{function}{publications}
 %   \begin{bitsyntax}[emph={[1]publications}]
 %     \begin{publications}