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

[-- Attachment #1 --]
On Thu, Jul 11, 2002 at 12:08:31PM -0700, Tom Rhodes wrote:
> trhodes     2002/07/11 12:08:31 PDT
> 
[...]
>   FreeBSD documentation project prefers to use manual pages over man pages,
>   hence some documents should reflect this.
>   
>   Tossed around on: -doc -developers
>   
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,
-- 
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

[-- Attachment #2 --]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.7 (FreeBSD)

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

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