[jira] [Commented] (IVY-730) Improve documentation for building Ivy

["Gintas Grigelionis (JIRA)" <ji...@apache.org>]

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

Gintas Grigelionis commented on IVY-730:
----------------------------------------

Is this still relevant?

> 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)