[ 
https://issues.apache.org/jira/browse/LUCENE-9278?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17059295#comment-17059295
 ] 

Tomoko Uchida commented on LUCENE-9278:
---------------------------------------

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: issues-unsubscr...@lucene.apache.org
For additional commands, e-mail: issues-h...@lucene.apache.org

Reply via email to