Mailing-List: contact dev-help@lucene.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@lucene.apache.org
Date: Wed, 1 Jun 2011 07:19:47 +0000 (UTC)
From: "Shai Erera (JIRA)" <jira@apache.org>
To: dev@lucene.apache.org
Message-ID: 
 <1076502361.58797.1306912787303.JavaMail.tomcat@hel.zones.apache.org>
In-Reply-To: 
 <896738383.55994.1306847087353.JavaMail.tomcat@hel.zones.apache.org>
Subject: [jira] [Commented] (LUCENE-3166) src/site should not be built under
 /docs
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit


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

Shai Erera commented on LUCENE-3166:
------------------------------------

bq. Does anyone have any opinions on this proposal?

Don't know if it counts (since I opened it), but +1 to follow this proposal !

> src/site should not be built under /docs
> ----------------------------------------
>
>                 Key: LUCENE-3166
>                 URL: https://issues.apache.org/jira/browse/LUCENE-3166
>             Project: Lucene - Java
>          Issue Type: Improvement
>          Components: general/javadocs, general/website
>            Reporter: Shai Erera
>            Priority: Blocker
>             Fix For: 3.3, 4.0
>
>
> I noticed that the source package contains a "docs" subdir with all the site's docs. Also, the root has index.html which nicely points to all those documents. However, it also points to the Javadocs which are absent. If you "ant javadocs", they are built under build/docs/api, which makes the links in index.html still invalid.
> Iterating on it shortly, Robert and I think that the following should be done:
> # have src/site docs built under src/site/build. Today they already are, but later "cp -r" under /docs, so we should remove the copy instruction.
> # have "ant docs" or "ant generate-docs" which generates javadocs + copy src/site/build under build/docs. Then all links will still work.
> # remove "docs" from svn and keep them under src/site/build.
> Marking it a blocker for 3.3 so we revisit before then.

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org