Hi Jonas,
Le 2016-09-06 21:17, Jonas Smedegaard a écrit :
Hi Olivier,
Quoting treb...@tuxfamily.org (2016-09-06 20:39:59)
I made a proper man page, starting from the information given by the
"amsynth -h" output. I made a French translation of it as well. Please
find these attached to this email.
I'd like to enjoy this email to talk about the debian/README.debian
file. Is it still actual ? Should it be kept or dropped ?
Thanks for your contribution!
NB: I am not the package maintainer - just throwing ideas here...:
Hand-written man pages has a high risk of getting out of sync.
I can suggest to look at help2man, for automated man page generation.
Then there is the translation. Ideally upstream would a) adopt your
translation, and b) support localized --help output, and c) we could
then extend our help2man routine to also convert translations.
Until all that is in place, a way for the packaging to ensure not
shipping out-of-sync man pages (translated or not) would be to capture
--help output at build time, compute a checksum, and if checksum fails
then fail the build with a message explaining to double-check man pages
and if ok update checksum.
- Jonas
I agree to that idea. Unfortunately, I don't have the
competences/knowledge to do so.
So I did the best I could : sending the man pages upstream and asking
the upstream author (Nick) to have a read about what you said.
( https://github.com/amsynth/amsynth/pull/27 )
Hope that helps and thanks for sharing your idea.
Olivier
