adamburkegh commented on pull request #63: URL: https://github.com/apache/commons-cli/pull/63#issuecomment-933976112
Hi @garydgregory The current version of https://github.com/apache/commons-cli/blob/master/src/site/xdoc/usage.xml doesn't match the generated version on https://commons.apache.org/proper/commons-cli/usage.html . A quick way to see this is to search for `withArgName` in both files. There are about a dozen references in the prod website but only two in `usage.xml`. The current web version is being generated from a much older version of `usage.xml` before the bulk of the examples were updated. I had some more detail [in jira](https://issues.apache.org/jira/browse/CLI-308) but probably should have put more context here. The generation of the site by the antrun section in `pom.xml` is broken on master, and you get errors running the task, but doesn't fail the build. There is some other defaulting going on that means the old version is picked up. The fix in `pom.xml` is needed for doco generation to run properly from the current xml files in git. Without it the website doco won't update and will continue using a default file from ~2017. The documentation change to `usage.xml` is a small cleanup I just noticed on the way. The second commit to the generic apache xml and contributor files was my attempt to follow the dev guide. Hope that explains the intent better. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
