使用文档注释来描述程序接口。
Use documentation comments to describe the programing interface.
该工具将跨这些模式文档注释元素/属性声明。
The tool will annotate element/attribute declarations across schema documents.
返回当前代码模型元素的文档注释。
Returns the document comment for the current code model element.
从文档注释中获得的文档内容和元数据都可以用于该插件。
The document's content and the metadata derived from annotations of the document are available to the plug-in.
此示例演示如何在代码中添加XML文档注释。
This example shows how to add XML documentation comments to your code.
编译此代码，以生成包含该文档注释的XML文件。
Compile the code to generate an XML file containing the documentation comments.
用新的XML文档注释添加其他使用该类型或成员的代码。
Add additional code that USES the type or member with the new XML documentation comments.
文档注释处理程序将有益于AST转换的维护者，而文档注释将有益于其用户。
Documenting your annotation handlers will benefit maintainers of the AST transformations, while documenting your annotations will benefit their users.
这是除了将文档注释直接置于源代码文件中之外的另一种可选方法。
This is an alternative to placing documentation comments directly in your source code file.
所以如果检查Listing4 中的方法旁边的文档注释，您会发现 @ejb-transaction type="Required"标记。
So if you examine the documentation comments surrounding the method in Listing 4, you find the @ejb-transaction type="Required" tag.
不过，它还具有文本文档的优势，因为模型中的每个对象都可以包括注释和文档之类的属性。
However, it also has the advantages of a text document, since each object in the model can include attributes like comments and documentation.
对于这种情况，注释在文档中包含一个特定的开始和结束位置。
In this case, the annotations contain a specific start and end position within the document.
在这个例子中，您没有在模型中产生任何文档：或许您应该产生注释。
In this example you did not produce any documentation in the model: perhaps you should generate comments.
图5中的例子展示注释如何出现在文档分析器中。
Figure 5 shows an example of how annotations appear in the document analyzer.
在每次迭代的结尾，将我们可交付使用的产品打包，并将支持文档以版本注释的形式一起交付给用户。
At the end of each iteration, our deliverables were packaged and delivered to the customer with supporting documentation in the form of release notes.
即使在准备从语义层面上处理这类注释之前，也可以在文档任务中加以利用。
Even before you get around to processing such annotations at the semantic level, you can use them in documentation tasks.
文档和注释是模型最重要的两个部分。
Documentation and annotation are the most important parts of models.
即使使用较老的API或者选择不那么时髦的东西，好的注释和文档也可以在需求和预期变化时帮助调整您的应用程序。
Even if you use an older API, or make choices that aren't all the rage, good comments and documentation will help you adapt your application as requirements and expectations change.
所有的注释、XML声明、以及文档类型声明，都必须删除。
All comments, the XML declaration, and the document type declaration MUST be removed.
他为需求文档添加注释，然后创建一个讨论条目以提出一个问题。
He adds a comment to the requirements document, and then creates a discussion entry to pose a question.
例如，文本节点、CDATA部件、注释、处理指令、属性、空格、文档类型和XML声明具有值。
For instance, text nodes, CDATA sections, comments, processing instructions, attributes, whitespace, document types, and XML declarations have values.
例如，注释可能被附加到文档中的一段文本上。
For example, annotations might be attached to a span of text in a document.
注释有益于为脚本记录文档。
注意，添加到XML模式的注释并不参与相应XML文档的验证。
Note that annotations added to the XML Schema do not participate in validation of corresponding XML documents.
是否要注释文档内容，或对它进行标记，使其能够在文档的其他版本中使用？
Will you want to comment any document content or mark it for use in different versions of a document?
然后可以用额外的元数据(如属性和分类)对文档和逻辑部分进行注释。
The document and the logical parts can then be annotated with additional metadata, such as properties and classification.
要运行它，通过用二进制文件位置来更换执行文档中的以下注释，您必须使用指向图像文件的有效URL来填充执行文档。
To run it you must complete the perform document with a valid URL pointing to the image file by replacing the following comment in the perform document with the binary file location.
现在，您可以将注释与文本文档的键COUNTRY关联起来。
Now you can relate the annotation with the key COUNTRY of the text document that it was found in.
在每日的编程成为急就章时，总是会忘记更新注释、文档、图示或其他次等级的工件。
In a hurry of typical day-to-day toil, it is so easy to change the code and miss to update the comments, documentation, diagrams and other secondary artifacts.
上面的代码会创建一个表，表中有文档描述和检查文档时输入的注释。
The code above creates a table with the document's description and the comment entered when the document was checked in.
应用推荐