Update: add javadoc, fix some ref error

This commit is contained in:
yongliang
2023-10-15 13:25:06 +08:00
parent cc999a4092
commit 5c80da5487
4 changed files with 12 additions and 12 deletions

View File

@@ -62,7 +62,7 @@
4.1.3. 空代码块:应简洁表示
""""""""""""""""""""""""""""""""""""""""""""""""""
一个空的代码块或类似块的结构可以按照K & R风格如第 :ref:`4.1.2 <nonempty-blocks>` 所描述)。或者,你也可以在打开后立即关闭它,中间没有字符也不需要换行(即 ``{}`` **除非** 它是多块语句的一部分(直接包含多个块的语句,例如 ``if`` / ``else````try`` / ``catch`` / ``finally`` )。
一个空的代码块或类似块的结构可以按照K & R风格如第4.1.2节 :ref:`非空块K & R风格 <nonempty-blocks>` 所描述)。或者,你也可以在打开后立即关闭它,中间没有字符也不需要换行(即 ``{}`` **除非** 它是多块语句的一部分(直接包含多个块的语句,例如 ``if`` / ``else````try`` / ``catch`` / ``finally`` )。
例如:
@@ -194,7 +194,7 @@ Java代码的列限制为100个字符。这里的“字符”指的是任何Unic
- **例外:** 枚举常量之间的空白行在 :ref:`第4.8.1节 <enum-classes>` 中有描述。
- 2. 此文档的其他部分所要求的例如第3节 :ref:`源文件结构 <source-file-structure>` 和第3.3节 :ref:`导入语句 <import-statemnts>` )。
- 2. 此文档的其他部分所要求的例如第3节 :ref:`源文件结构 <source-file-structure>` 和第3.3节 :ref:`导入语句 <import-statements>` )。
单个空白行也可以出现在任何使用它可以提高代码可读性的位置,例如在语句之间以将代码组织成逻辑子部分。类的第一个成员或初始化器之前,或者最后一个成员或初始化器之后的空白行既不被鼓励也不被反对。

View File

@@ -73,7 +73,7 @@ Javadoc块的基本格式如下例所示
.. _non-required-javadoc:
7.3.4. 非必需的Javadoc译者注原文中并没有7.3.3节)
""""""""""""""""""""""""""""""""""""""""""""""""""
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
其他类和成员可根据需要或作者意愿添加Javadoc。