On Mon, Nov 03, 2008 at 09:01:28PM +0100, Juan A. Moreno wrote: > On Monday 03 November 2008 20:08:12 Randy McMurchy wrote: > > Juan A. Moreno wrote these words on 11/03/08 12:52 CST: > > > What man pages are better? > > > > I would prefer to use the Shadow man pages. IMO, it's better to use > > man pages from the native package rather than the generic ones from > > the man-pages package. > > > > -- > > Randy > > > > rmlscsi: [bogomips 1003.23] [GNU ld version 2.16.1] [gcc (GCC) 4.0.3] > > [GNU C Library stable release version 2.3.6] [Linux 2.6.14.3 i686] > > 13:07:00 up 17:42, 1 user, load average: 0.34, 0.36, 0.19 > > I have compared the content of both versions of man pages. In the case of > passwd.5 their contents are diferent but similar, but look at the contents in > the case of getspnam.3. > > The version from shadow: > > juan [ ~/shadow-4.1.2.1/man ]$ cat getspnam.3 > .so man3/shadow.3 > > The version from man-pages: > > juan [ ~/man-pages-3.11/man3 ]$ cat getspnam.3 > .\" Copyright (c) 2003 Andries Brouwer ([EMAIL PROTECTED]) and > .\" Walter Harms ([EMAIL PROTECTED]) > .\" > .\" Distributed under GPL > .\" > .TH GETSPNAM 3 2008-07-09 "GNU" "Linux Programmer's Manual" > .SH NAME > getspnam, getspnam_r, getspent, getspent_r, setspent, endspent, > fgetspent, fgetspent_r, sgetspent, sgetspent_r, putspent, > lckpwdf, ulckpwdf \- get shadow password file entry > .SH SYNOPSIS > .nf > /* General shadow password file API */ > .br > .B #include <shadow.h> > .sp > .BI "struct spwd *getspnam(const char *" name ); > .sp > .B struct spwd *getspent(void); > .sp > .B void setspent(void); > .sp > ..... > ..... > > The shadow version doesn't seem like a man page at all. Wrong! That is absolutely normal for a page which is called by multiple names. It's similar to a symlink. Compare what is in shadow's man3/shadow.3. On my system, I see:
SHADOW(3) Library Calls SHADOW(3) NAME shadow, getspnam - encrypted password file routines ^^^^^^^^ SYNTAX #include <shadow.h> struct spwd *getspent(); struct spwd *getspnam(char *name); and ^^^^^^^^^ void setspent(); and so forth. ĸen > -- > http://linuxfromscratch.org/mailman/listinfo/lfs-support > FAQ: http://www.linuxfromscratch.org/lfs/faq.html > Unsubscribe: See the above information page -- das eine Mal als Tragödie, das andere Mal als Farce -- http://linuxfromscratch.org/mailman/listinfo/lfs-support FAQ: http://www.linuxfromscratch.org/lfs/faq.html Unsubscribe: See the above information page