Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 11 Jul 2002 22:17:32 +0300
From:      Ruslan Ermilov <ru@FreeBSD.org>
To:        Tom Rhodes <trhodes@FreeBSD.org>
Cc:        cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org
Subject:   Re: cvs commit: doc/en_US.ISO8859-1/articles/committers-guide article.sgml doc/en_US.ISO8859-1/articles/console-server article.sgml doc/en_US.ISO8859-1/articles/contributing article.sgml doc/en_US.ISO8859-1/articles/fonts article.sgml doc/en_US.ISO8859-1/articles/formatting-media article.sgml doc/en_US.ISO8859-1/articles/laptop article.sgml ...
Message-ID:  <20020711191732.GB15253@sunbay.com>
In-Reply-To: <200207111908.g6BJ8VQ8092475@freefall.freebsd.org>
References:  <200207111908.g6BJ8VQ8092475@freefall.freebsd.org>

next in thread | previous in thread | raw e-mail | index | archive | help

--NMuMz9nt05w80d4+
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Thu, Jul 11, 2002 at 12:08:31PM -0700, Tom Rhodes wrote:
> trhodes     2002/07/11 12:08:31 PDT
>=20
[...]
>   FreeBSD documentation project prefers to use manual pages over man page=
s,
>   hence some documents should reflect this.
>  =20
>   Tossed around on: -doc -developers
>  =20
This is against current practice and traditions:

man(1):

:    Man formats and displays the on-line manual pages.  This version knows
:    about the MANPATH and PAGER environment variables, so you can have your
:    own set(s) of personal man pages and choose whatever program you like =
to
                            ^^^^^^^^^
:    display the formatted pages.

man(7):

: NAME
:        groff_man - groff `man' macros to support generation of man pages
                                                                 ^^^^^^^^^

mdoc(7):

:    Throughout the UNIX manual pages, a manual entry is simply referred to=
 as
:    a man page, regardless of actual length and without sexist intention.
       ^^^^^^^^

Both can be used interchangeably:

/home/ru/1/mdocNG > awk '{ print $1 }' *.manuals | xargs grep 'manual page'=
 | wc -l
     443
/home/ru/1/mdocNG > awk '{ print $1 }' *.manuals | xargs egrep 'man ?page' =
| wc -l
     368


Cheers,
--=20
Ruslan Ermilov		Sysadmin and DBA,
ru@sunbay.com		Sunbay Software AG,
ru@FreeBSD.org		FreeBSD committer,
+380.652.512.251	Simferopol, Ukraine

http://www.FreeBSD.org	The Power To Serve
http://www.oracle.com	Enabling The Information Age

--NMuMz9nt05w80d4+
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.7 (FreeBSD)

iD8DBQE9LdnMUkv4P6juNwoRAgRmAJwKxWfWfvaFDUtRu9Fbngh62HrAqwCdF7n4
ONBGhiXnDi9XlT4fdapEf28=
=Re0D
-----END PGP SIGNATURE-----

--NMuMz9nt05w80d4+--

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020711191732.GB15253>