在cmd把文档注释生成API文档
文档注释是什么?
文档注释就是指这种注释内容能够生成API帮助文档,JDK中javadoc命令能够提取这些注释信息并生成HTML文件。文档注释主要对类(或接口)、实例变量、静态变量、实例方法和静态方法等进行注释。
提示:文档是要给别人看的帮助文档,一般注释的实例变量、静态变量、实例方法和静态方法都
应该是非私有的,那些只给自己看的内容可以不用文档注释。
为什么要用文档注释?
文档注释是一套注释规范,使用JDK中javadoc命令生成HTML文件,方便维护和使用。
文档注释一般是给一些看不到源代码的人看的帮助文档。
怎么做
1、要有一个java文档


2.输入命令
javadoc -d apidoc Date.java

结果
得到一个生成的文件夹
如果生成成功则在当前apidoc目录下生成很多HTML文件,其中的index.html文件是文档的入口,双击此文件



文档注释是Java中用于生成API帮助文档的一种规范,通过Javadoc命令可以将这些注释转化为HTML文件。主要针对非私有的类、变量和方法进行注释,便于他人理解和维护。使用Javadoc时,需要先有包含文档注释的Java源代码,然后在命令行输入`javadoc -d apidoc Date.java`,成功后会在apidoc目录下生成HTML文档,其中index.html为入口点。

5177

被折叠的 条评论
为什么被折叠?



