[
https://issues.apache.org/jira/browse/IVY-730?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16178210#comment-16178210
]
Nicolas Lalevée commented on IVY-730:
-------------------------------------
It is still not well documented.
There only few lines there: https://ant.apache.org/ivy/download.cgi
We could improve it.
> Improve documentation for building Ivy
> --------------------------------------
>
> Key: IVY-730
> URL: https://issues.apache.org/jira/browse/IVY-730
> Project: Ivy
> Issue Type: Improvement
> Components: Documentation
> Reporter: Adrian Sandor
> Priority: Minor
>
> The source distribution currently doesn't contain easily accessible
> instructions for building the library or doing various tasks such as
> obtaining dependencies or integrating with Eclipse. Specifically:
> - There is a README file, but it only points to install.html, which contains
> instructions for installing the *binary* distribution
> - The current download page has a few instructions for building from source
> (followed by a broken link to http://ant.apache.org/ivy/downloads/latest/ ),
> but they are easily overlooked because people (well, at least I) go there to
> download stuff, and don't normally scroll down to see what else it says.
> Also, the download page is not included in the source distribution.
> - There is a dev.html page, included both on the site and in the source
> distribution, but it is not directly referenced. Users must currently find it
> on their own or be told about it. Also, that page doesn't mention the jar
> target for just building the library (but that also gets done when running
> the default target, so it's not too bad).
> - Apparently a common problem is having another version of Ivy being loaded
> by ant when running the build script. This is not detected, and causes errors
> such as:
> ivy:settings doesn't support the "override" attribute
> The documentation should advise the users to avoid this situation, and if
> possible, the build script should detect when it happens.
> Also see
> http://www.nabble.com/Re%3A-Possible-Ivy-resolver-bug-td15302716.html#a15370117
--
This message was sent by Atlassian JIRA
(v6.4.14#64029)
