Bug#836878: amSynth : package improvement

[trebmuh at tuxfamily.org]

Hi Jonas,

Le 2016-09-06 21:17, Jonas Smedegaard a écrit :
> Hi Olivier,
> 
> Quoting trebmuh at 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