shadow-4.1.2.1 man pages

Ken Moffat ken at linuxfromscratch.org
Mon Nov 3 13:47:09 PST 2008


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 (aeb at cwi.nl) and
> .\" Walter Harms (walter.harms at informatik.uni-oldenburg.de)
> .\"
> .\" 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



More information about the lfs-support mailing list