Bug#684434: RFS: yamcha/0.33-1 [ITP] -- General purpose chunker annotator

[Jakub Wilk <jwilk@debian.org>]

* Giulio Paci <giuliopaci@gmail.com>, 2012-12-11, 01:22:
> > src/darts.h looks like embedded copy of the Darts library. Please use 
> > the packaged version instead of the bundled one.
> Done: I added a patch to remove darts.h and fix yamcha accoringly. I 
> added darts to Built-Using and to the dependencies.

Support for ${source:Package} and ${source:Version}
variables was added to dpkg in 1.16.2, so please bump the version in
Build-Depends.

> > debian/patches/1002_manpages_fix.patch touches a file which starts 
> > with the following comment:
> >
> > .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.23.
>
> Unfortunately I have never been able to run help2man and to obtain good 
> looking (i.e., no lintian complaints) manpages.
> When using help2man my workflow is usually:
> 1) run help2man;
> 2) edit the files to fix issues (e.g., missing escapes, missing short 
> command description, ...);
> 3) on command updates re-run help2man and manually compare (and merge) 
> the new and old manpages.
> I really do not like this workflow, but is the best I have found up to 
> now.
>
> Do you have any suggestion?

In general, no, not really (other than ditching help2man completely). 

But in this case there are only two minor changes:

> -yamcha \- manual page for yamcha of 0.3
> +yamcha \- general purpose chunk annotator

This can be fixed by passing an option to help2man.

> -Copyright (C) 2001-2003 Taku Kudo All rights reserved.
> +Copyright (C) 2001\-2003 Taku Kudo All rights reserved.

Current version of help2man already takes care of this.

Also note that neither version for copyright years were up-to-date in 
.orig.tar, so you should re-run help2man anyway.

--
Jakub Wilk