生成JavaDoc文档

JavaDoc是一种将注释生成HTML文档的技术,生成的HTML文档类似于Java的API,易读且清晰明了。在简略介绍JavaDoc写法之后,再看一下在Intellij Idea 中如何将代码中的注释生成HTML文档。

java中的注释有三种:

  1. 单行注释:在IDEA中快捷键为Ctrl+/
  2. 多行注释:在IDEA中快捷键为Ctrl+Shift+/
  3. 文档注释:

    @author 作者名

    @version 版本号

    @since 指明需要最早使用的jdk版本

    @param 参数名

    @return 返回值情况

    @throws 异常抛出情况

生成javadoc文档两种方式

javadoc命令

javadoc命令是用来生成自己API文档的

1.打开IDEA,右键要生成文档的类hello,打开其所在文件夹位置。

2.在该文件夹里打开命令窗口。

3.输入命令 javadoc -encoding utf-8 -charset utf-8 hello.java,也就是javadoc + 参数 +java类 。

4.完成。

直接在IDEA中生成javadoc

1.IDEA菜单栏的tools,选中Generate JavaDoc。

2.点击OK完成。

最后生成的API文档

原文地址:https://www.cnblogs.com/xiaoran991/p/12305876.html

时间: 2024-11-07 18:32:55

生成JavaDoc文档的相关文章

读thinking in java的收获(二) --eclipse生成javadoc文档

最开始学习java语言的时候学过生成javadoc不过当时只是用windows命令行生成.读了这里的javadoc温故而知新发现其实我们做的项目就用到了一些注释,只是没有用eclipse 生成这份文档,通过查阅,最终补全了这份知识. 一.书中的代码: <pre name="code" class="java">//:object/HelloDate.java package unit2; import java.util.Date; /** * The

eclipse中自动生成javadoc文档的方法

?这篇文章主要介绍了eclipse中自动生成javadoc文档的方法,是实用eclipse开发Java程序时非常实用的技巧,对于进行Java项目开发具有一定的参考借鉴价值,需要的朋友可以参考下 本文实例讲述了eclipse中自动生成javadoc文档的方法.分享给大家供大家参考.具体方法如下: 使用eclipse生成文档(javadoc)主要有三种方法: 1. 在项目列表中按右键,选择Export(导出),然后在Export(导出)对话框中选择java下的javadoc,提交到下一步. 在Jav

用IDEA生成javadoc文档

用IDEA生成javadoc文档 打开相应的选项面板 设置 -encoding是java代码编码,-charset是对生成文档所用的编码.-windowtitle就是对应html的<title>标签 1 -encoding UTF-8 -charset UTF-8 -windowtitle "test" 结果 原文地址:https://www.cnblogs.com/PikaBi/p/12264612.html

MyEclipse生成javadoc文档

一.右键项目,选择Export 二.选择java下面的javadoc 三.create javadoc for members with visibility解释 private 所有类和成员都生成 package除了前边带private的私有类和成员,其他都生成. protected 前边带protected和public的都生成. public 前边public的生成.(默认) 四.选好路径 五.选择引用文件和项目以生成链接.(全选就行,也就是下图的Select All,警告忽略) 六.Ex

eclipse中自动生成javadoc文档

使用eclipse生成文档(javadoc)主要有三种方法:  1,在项目列表中按右键,选择Export(导出),然后在Export(导出)对话框中选择java下的javadoc,提交到下一步.  在Javadoc Generation对话框中有两个地方要注意的:  javadoc command:应该选择jdk的bin/javadoc.exe  destination:为生成文档的保存路径,可自由选择.  按finish(完成)提交即可开始生成文档.  2,用菜单选择:File->Export

类的无参带参方法、变量作用域、JavaDoc文档注释、包

如何定义类的方法 public 返回值类型 方法名(){ //方法的主体 } return:  如果有返回值      跳出方法.返回结果. 如果一个方法有返回值的话,那调用这个方法就会得到这个方法的返回值 方法名一般采用驼峰命名法 Admin admin = new Admin(); 对象是通过类来创建出来的,所以对象的类型是  Admin    也就是说 类是对象的类型 admin.方法名();      //调用无参的构造方法 同一个类中的方法,直接使用方法名调用该方法 不同类的方法,首先

javadoc 生成帮助文档时,注意以下几点

参考:http://www.w3school.com.cn/tags/tag_pre.asp javadoc 生成帮助文档时,注意以下几点: 1.函数功能描述的结尾一定要有句号,英文句号或中文句号均可.不然会有方法摘要里会出现后边一大片内容. 2.换行用<p> 3.<pre> 元素可定义预格式化的文本.被包围在 pre 元素中的文本通常会保留空格和换行符.而文本也会呈现为等宽字体. public class JavadocDemo { /** * 这个函数的功能是返回你输入的字符串

(转)创建和查看Javadoc文档

原地址:http://jinnaxu-tju-edu-cn.iteye.com/blog/667177 Javadoc是Sun公司提供的一个技术,它从程序源代码中抽取类.方法.成员等注释形成一个和源代码配套的API帮助文档.也就是说,只要在编写程序时以一套特定的标签作注释,在程序编写完成后,通过Javadoc就可以同时形式程序的开发文档了. javadoc是生成一个java api文档生成工具,存在于jdk安装目录下的bin目录中. 说明:生成javadoc 不要求你的java代码是可编译的.唯

netbeans和eclipse导出javadoc文档

一.注释 (1)文档注释的格式化 生成的文档是 HTML 格式,而这些 HTML 格式的标识符并不是 javadoc 加的,而是我们在写注释的时候写上去的.比如,需要换行时,不是敲入一个回车符,而是写入 <br>,如果要分段,就应该在段前写入 <p>. 因此,格式化文档,就是在文档注释中添加相应的 HTML 标识. 文档注释的正文并不是直接复制到输出文件 (文档的 HTML 文件),而是读取每一行后,删掉前导的 * 号及 * 号以前的空格,再输入到文档的. 如 /** * This