Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Should we remove -linksource from javadoc plugin? #25

Open
pavelhoral opened this issue May 13, 2022 · 0 comments
Open

Should we remove -linksource from javadoc plugin? #25

pavelhoral opened this issue May 13, 2022 · 0 comments

Comments

@pavelhoral
Copy link
Member

Wren:ICF Java Framework's Protobuf module produces 600+ MB of JavaDoc content because it contains generated sources.

$ du -hs *
72K     allclasses.html
128K    allclasses-index.html
8,0K    allpackages-index.html
244K    constant-values.html
12K     deprecated-list.html
4,0K    element-list
12K     help-doc.html
4,3M    index-all.html
4,0K    index.html
1,3M    jquery
44K     legal-notices
1,3M    member-search-index.js
52K     member-search-index.zip
8,0K    META-INF
24M     org
156K    overview-tree.html
4,0K    package-search-index.js
4,0K    package-search-index.zip
12K     resources
8,0K    script.js
16K     search.js
136K    serialized-form.html
677M    src-html
24K     stylesheet.css
32K     type-search-index.js
4,0K    type-search-index.zip

I think we should consider removing -linksource option from the JavaDoc plugin. I don't think JavaDoc need to have sources attached.

Creating this issue to gather any potential opinion on this before actually doing anything (being it removing the option, making it somehow configurable or delegating the issue downstream to ICF).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant