Bug#836878: amSynth : package improvement

[Jonas Smedegaard]

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

-- 
 * Jonas Smedegaard - idealist & Internet-arkitekt
 * Tlf.: +45 40843136  Website: http://dr.jones.dk/

 [x] quote me freely  [ ] ask before reusing  [ ] keep private
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 801 bytes
Desc: signature
URL: <http://lists.alioth.debian.org/pipermail/pkg-multimedia-maintainers/attachments/20160906/60cf3cbf/attachment.sig>