[Pkg-shadow-devel] Review of Debian man-pages-3.35 patches: open topics: passwd.5 (passwd vs shadow)
Michael Kerrisk (man-pages)
mtk.manpages at gmail.com
Sun Jul 29 15:20:24 UTC 2012
On Thu, Jul 19, 2012 at 10:07 PM, Simon Paillard <spaillard at debian.org> wrote:
> Hi all,
> (with shadow maintainers in copy, feel free to CC linux-man at vger.kernel.org)
> On Sat, May 05, 2012 at 10:59:44AM +1200, Michael Kerrisk (man-pages) wrote:
>> I'm undecided about the patches below, and would welcome comments
>> about possibly upstreaming.
>> I have a sense of deja vu about this patch. Did we converse about it
>> once before Joey?
>> I'm sure that Andries rejected it for the same reason I do: the
>> information is covered better (and belongs) in the upstream passwd(5)
>> page. But it looks like Debian's problem is that they think someone
>> else's passwd page is better than the man-pages passwd(5) page.
> In Debian and its derivatives, passwd(5) is provided by passwd package, from
> shadow source package, as this package manages /etc/passwd.
> Moreover, shadow uses po4a and thus provides many translations already for
> In case of basic passwd (not shadow's one), there is no manpage (like Fedora),
> so no conflict.
> In other distribs:
> - Arch does like Debian (passwd.5 from shadow)
> - gentoo uses passwd from shadow, but keep passwd.5 from manpages
> - fedora, like mandriva and mageia don't use shadow, so provide passwd.5 from manpages
>> But, when I look at the passwd(5) page provided by default on my Ubuntu
>> system, and compare with the man-pages version, the man-pages version
>> seems substantially better. And for man-pages-3.41, I've improved it
>> still further (complete page attached):
>> I'd encourage you to drop the getpwent.3 patch, and to reconsider
>> adopting the man-pages passwd.5 page.
> Nicolas (shadow maintainer in Debian) said on IRC he'd agree with letting manpages
> providing passwd.5, but it cannot apply for all distribs.
> - shadow need to provide passwd.5, because its passwd is different from the
> one documented in manpages
> - manpages need to provide passwd.5, because not all distribs use passwd from
> Do you have suggestions ?
Where/who is upstream for the other version of the passwd.5 page.
Maybe the two upstreams can make a decision to consolidate in one
place? (I not know the history of how there came to be a passwd.5 in
man-pages and in another package.)
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
More information about the Pkg-shadow-devel