Bug#328137: [Pkg-shadow-devel] Bug#328137: passwd: update for useradd.8

[Christian Perrier]

Quoting Joerg Hoh (joerg at joerghoh.de):
> Package: passwd
> Version: 1:4.0.3-39
> Severity: wishlist
> 
> 
> Please include the following patch. It adds the the description of the
> return values to the manpage of useradd.

We are currently in the process of resyncing with upstream
versions. In current upstream versions, all documentation is using
DocBook XML and man pages are generated from these XML files.

This means that the patch, as is, is not likely to be applied.

On the other hand, I'm pretty convinced that upstream documentation
needs a big general overview. Neither the upstream author (Tomasz
Kloczko), nor the Debian maintainers (with only one exception) are
native English speakers and there are probably a lot of mistakes lying
in the documentation.

So, help would be greatly welcomed here, actually.

I don't really know what to do with your bug report. We ca n't apply
it and I don't want to reject help. Would you be OK if I sent you the
useradd.8.xml file so that you can make the suggested changes there
(and review it while you're at it)?

(it is likely that return codes are now described there, by the way)