[jira] [Commented] (CONNECTORS-194) Forrest doc build always gets an error because of relative references to javadoc roots

["Erlend Garåsen (JIRA)" <ji...@apache.org>]

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

Erlend Garåsen commented on CONNECTORS-194:
-------------------------------------------

I suggest that the path to the Javadoc root is changed from
http://incubator.apache.org/connectors/javadoc.html
to
http://incubator.apache.org/connectors/api/ (index.html)

Then it is much more easier to exclude those docs by creating rules in a cli.xconf file, for example:
<exclude pattern="api/**"/>

Take a look at the following part in the Forrest's faq:
http://forrest.apache.org/docs_0_80/faq.html#cli-xconf

> Forrest doc build always gets an error because of relative references to javadoc roots
> --------------------------------------------------------------------------------------
>
>                 Key: CONNECTORS-194
>                 URL: https://issues.apache.org/jira/browse/CONNECTORS-194
>             Project: ManifoldCF
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: ManifoldCF 0.1, ManifoldCF 0.2, ManifoldCF next
>            Reporter: Karl Wright
>
> Forrest is not very happy with generating a relative link to the javadoc roots, since the javadoc itself is not under Forrest's control.  Somebody needs to find a better way of handling this.

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