1. debian/docs/koha-common.xml does not list koha-create 2. debian/docs/koha-common.xml does list koha-remove, but on one system I tested it was not displayed, this needs some more investigation 3. debian/docs/koha-foreach.xml uses koha-list in the synopsis of the command. The arguments are the same, but doh...
4. koha-run-backups does not have a man page
Created attachment 12611 [details] [review] Bug 8568 - Fix some errors in docs for scripts provided by the Debian packages 1. Create a page for koha-run-backups 2. Fix the synopsis for koha-foreach 3. Add koha-create and koha-run-backups to koha-common To test - Convert the changed xml files to man pages with $ xsltproc /usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl koha-x.xml - View generated pages with e.g. $ man -l koha-x.8" (Replace x with the names of the changed files) - Check that the changes make sense
I could not recreate issue 2 above, with the missing man page for koha-remove, so the attached patch is for issues 1, 3 and 4.
Created attachment 12688 [details] [review] Bug 8568 - Fix some errors in docs for scripts provided by the Debian packages 1. Create a page for koha-run-backups 2. Fix the synopsis for koha-foreach 3. Add koha-create and koha-run-backups to koha-common To test - Convert the changed xml files to man pages with $ xsltproc /usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl koha-x.xml - View generated pages with e.g. $ man -l koha-x.8" (Replace x with the names of the changed files) - Check that the changes make sense Signed-off-by: Frédéric Demians <f.demians@tamil.fr> Works as described. I was able to produce the 3 man files, load them with man command, and see the added information properly formated.
QA comment: doc only patch, passed QA
Patch pushed to master
Pushed to 3.8.x, will be in 3.8.7
Works with 3.10.