[
https://issues.apache.org/jira/browse/LUCENE-9278?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17059295#comment-17059295
]
Tomoko Uchida edited comment on LUCENE-9278 at 3/14/20, 10:12 AM:
------------------------------------------------------------------
Currently the {{renderJavadoc}} task shares the output directories
{{lucene/build/docs}} and {{solr/build/docs}} with Ant {{documentation}} task,
it may be problematic while Ant and Gradle builds co-exist on the master. If we
move the output directory to {{_project_/build/docs/javadoc}} as suggested in
https://github.com/apache/lucene-solr/pull/1304 (this would be possible by
changing all relative paths to absolute urls), I think the work can be
continued without disturbing ant build?
{quote}
Which also begs the question how many things are still in ant that aren't
ported yet (I admit I lost track here).
{quote}
I believe I have ported the entire ant documentation task, except for
{{solr-invoke-javadoc}} macro which makes the external links from Solr javadocs
to Lucene javadocs (that is marked as TODO in the render-javadoc.gradle file).
was (Author: tomoko uchida):
Currently the {{renderJavadoc}} task shares the output directories
{{lucene/build/docs}} and {{solr/build/docs}} with Ant {{documentation}} task,
it may be problematic while Ant and Gradle builds co-exist on the master. If we
move the output directory to {{_project_/build/docs/javadoc}} as suggested in
https://github.com/apache/lucene-solr/pull/1304 (this would be possible by
changing all relative paths to absolute urls), I think the work can be
continued without disturbing and build?
{quote}
Which also begs the question how many things are still in ant that aren't
ported yet (I admit I lost track here).
{quote}
I believe I have ported the entire ant documentation task, except for
{{solr-invoke-javadoc}} macro which makes the external links from Solr javadocs
to Lucene javadocs (that is marked as TODO in the render-javadoc.gradle file).
> Make javadoc folder structure follow Gradle project path
> --------------------------------------------------------
>
> Key: LUCENE-9278
> URL: https://issues.apache.org/jira/browse/LUCENE-9278
> Project: Lucene - Core
> Issue Type: Task
> Components: general/build
> Reporter: Tomoko Uchida
> Priority: Major
> Time Spent: 1.5h
> Remaining Estimate: 0h
>
> Current javadoc folder structure is derived from Ant project name. e.g.:
> [https://lucene.apache.org/core/8_4_1/analyzers-icu/index.html]
> [https://lucene.apache.org/solr/8_4_1/solr-solrj/index.html]
> For Gradle build, it should also follow gradle project structure (path)
> instead of ant one, to keep things simple to manage [1]. Hence, it will look
> like this:
> [https://lucene.apache.org/core/9_0_0/analysis/icu/index.html]
> [https://lucene.apache.org/solr/9_0_0/solr/solrj/index.html]
> [1] The change was suggested at the conversation between Dawid Weiss and I on
> a github pr: [https://github.com/apache/lucene-solr/pull/1304]
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
