Working on my ebuild quizzes, it was pointed out that the following is redundant: $ echangelog "msg" $ repoman commit -m "msg" It is preferable to keep the commit messages the same in most cases; therefore, a simple, $ repoman commit -m "msg" will suffice. Repoman will notice the missing ChangeLog entry and add it itself.
Created attachment 386702 [details, diff] Patch to swap out echangelog for repoman I don't know how to build the HTML from XML, but the change was simple enough so maybe I didn't screw it up.
The page https://devmanual.gentoo.org/ebuild-writing/misc-files/changelog/index.html should also be updated with the new information.
This is not always accurate. echangelog (and ChangeLog) are used to provide detailed information about what really changed. Sometimes the commit message is enough, some other times it's best to add more details to the ChangeLog regarding that particular commit. So yes, while repoman commit -m "Foo" will also append "Foo" to ChangeLog (if you haven't edited yourself) we still need to reference the proper use to echangelog though. I believe the patch needs some rewording.
Created attachment 418024 [details, diff] 0001-ebuild-writing-misc-files-remove-ChangeLog-section.patch
Created attachment 418026 [details, diff] 0002-tools-reference-remove-the-echangelog-page.patch The original issue I reported is obsolete, but Stefan is right, this needs to be fixed in the devmanual as well. So here are some patches to remove the outdated (e)changelog stuff.
This is live on https://devmanual.gentoo.org/