【问题标题】:Generic javadoc command that always generates all javadocs in a given tree?始终在给定树中生成所有 javadoc 的通用 javadoc 命令?
【发布时间】:2011-06-10 05:30:37
【问题描述】:

当我必须为一个新的、不熟悉的项目生成 javadocs 时,我发现我花了很长时间试图简单地编写正确的命令,指定所有的包、所有的源代码树等​​。这既费时又出错-prone:我可能错过了一些来源。

假设我有一个目录 myproj,在它下面有一些包(以及各种其他资源和东西),在这些包目录下最终有一些 src/ 目录,然后是很多 my/awesome/ java/project/package 类型结构。

是否有一个命令将始终递归遍历所有内容并在一个输出位置生成所有 javadocs?我不在乎需要多长时间。像javadoc -d doc -sourcepath . -subpackages * 这样的脑残会很棒。如果做不到这一点,无论目录结构是什么,生成所有 javadocs 的最简单方法是什么?

【问题讨论】:

    标签: java command-line javadoc


    【解决方案1】:

    使用find查找所有Java源文件,然后发送给javadoc

    find . -type f -name "*.java" | xargs javadoc -d outputdir 
    

    【讨论】:

    • 对于额外的标记,在 XP 上工作的命令? (这对我来说很蹩脚,更不用说。)如果不可能的话,我会MKS。
    • 最好在其中抛出一些内存参数以确保:find . -type f -name "*.java" | xargs javadoc -d outputdir -J-ms39m -J-mx40m
    • 它有效。但是如果你想在你的 javadoc 中添加媒体,它不会。
    【解决方案2】:

    在 Windows 上,您可以这样做:

    生成文件列表:

    dir /s /b *.java > file.lst
    

    生成 javadoc:

    javadoc -d outputdir @file.lst
    

    【讨论】:

    • 优秀的、原生的、功能等效的替代品。
    • 使用这个方法后有没有办法让Javadoc生成所有包的索引列表。使用简单的“javadoc -d [dir] @[file]”方法没有索引。
    • 如果某些路径的名称中有空格,知道如何让它工作吗?
    猜你喜欢
    • 1970-01-01
    • 2011-06-03
    • 1970-01-01
    • 2022-06-15
    • 2011-08-02
    • 2022-06-15
    • 1970-01-01
    • 2020-07-15
    • 2012-07-04
    相关资源
    最近更新 更多