[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Undocumented 7 manpage in manpages.deb



Hi All,

Another change of name. Undocumented seems to be the name I was
looking for (thanks Ian). To be as clear as possible all `|' stuff is
removed to make this manpage mono-synaptical-proof and/or
professor-proof (We can argue about the differences). The section
where this manpage should go in is 7. I would like this manpage as
part of a convention. This manual page will be included in the
manpages package if the maintainer will be so kind to do so. Martin
Shulze <joey@infodrom.north.de> would you please include this
undocumented manpage in the manpages package, that is if no one
objects of course.


Proposal for convention: If no manual page is available for a
particular program and this is reported as a bug on debian-bugs, the
package maintainer may/should add a symbolic link from the requested
manpage to this undocumented one in the package containing the
particular program or a related package.

from /usr/man/man[1-9]

ln -s ../man7/undocumented.7 requested_man_page.[1-9]

or from /usr/X11R6/man/man[1-9]

ln -s ../../../man/man7/undocumented.7 requested_man_page.[1-9]

I think that's about it.

Erick

PS: formatted output and source included.

NAME
       undocumented  -  No  manpage  for this program, utility or
       function.

DESCRIPTION
       This program, utility or function does not have  a  useful
       manpage.  Please do not report this as a bug, because this
       has already been reported as a bug; when a manpage becomes
       available  it  will be included, and the bug report closed
       <http://www.debian.org/Bugs/>. If you are a competent  and
       accurate  writer and are willing to spend the time reading
       the source code and writing good manpages please  write  a
       better  man page than this one. Please contact the package
       maintainer in order to avoid several people working on the
       same manpage.

       Try the following options if you want more information.

       foo --help, foo -h, foo -?

       info foo

       whatis foo, apropos foo

       check     directories     /usr/doc/foo,
              /usr/doc/examples/foo, /usr/lib/foo

       dpkg --listfiles foo, dpkg --search foo

       locate '*foo*'

       find / -name '*foo*'

       If  you  still didn't find the information you are looking
       for you might consider posting a call for help to  debian-
       user@pixar.com.

SEE ALSO
       info(1),   whatis(1),   apropos(1),   dpkg(8),  locate(1),
       find(1).

AUTHOR
       Erick Branderhorst <branderhorst@heel.fgg.eur.nl>.

THANKS
       Kai  Henningsen,  Ian  Jackson,  David  H.  Silber,   Carl
       Streeter.

.\" Hey, Emacs!  This is an -*- nroff -*- source file.
.\"
.\" Copyright (C) 1996 Erick Branderhorst <branderhorst@heel.fgg.eur.nl>
.\"
.\" This is free software; you can redistribute it and/or modify it under
.\" the terms of the GNU General Public License as published by the Free
.\" Software Foundation; either version 2, or (at your option) any later
.\" version.
.\" 
.\" This is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\" 
.\" You should have received a copy of the GNU General Public License with
.\" your Debian GNU/Linux system, in /usr/doc/copyright/GPL, or with the
.\" dpkg source package as the file COPYING.  If not, write to the Free
.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.\" This manpage is created thanks to:
.\" Kai Henningsen <kai@khms.westfalen.de>,
.\" Ian Jackson <iwj10@cus.cam.ac.uk>,
.\" David H. Silber <dhs@firefly.com> &
.\" Carl Streeter <streeter@cae.wisc.edu>.
.\"
.TH undocumented 7 "8th February 1996" "Debian Project" "Debian GNU/Linux"
.SH NAME
undocumented \- No manpage for this program, utility or function.
.SH DESCRIPTION
This
.B program, utility
or 
.B function 
does not have a useful manpage.  Please do 
.B not 
report this as a bug, because this has already been reported as a bug;
when a manpage becomes available it will be included, and the bug
report closed <\c
.B http://www.debian.org/Bugs/\c
>. If you are a competent and accurate writer and are willing to spend
the time reading the source code and writing good manpages please
write a better man page than this one. Please 
.B contact 
the 
.B package maintainer 
in order to avoid several people working on the same manpage.

Try the following options if you want more information.

foo \-\-help, foo \-h, foo \-?
.TP 
info foo
.TP 
whatis foo, apropos foo
.TP 
check directories /usr/doc/foo, /usr/doc/examples/foo, /usr/lib/foo
.TP 
dpkg \-\-listfiles foo, dpkg \-\-search foo
.TP
locate '*foo*'
.TP
find / \-name '*foo*'
.PP
If you still didn't find the information you are looking for you might
consider posting a call for help to debian-user@pixar.com.
.SH SEE ALSO
.BR info (1),
.BR whatis (1),
.BR apropos (1),
.BR dpkg (8),
.BR locate (1),
.BR find (1),
.BR updatedb (1),
.BR undocumented (2).
.SH AUTHOR
Erick Branderhorst <branderhorst@heel.fgg.eur.nl>.
.SH THANKS
Kai Henningsen,
Ian Jackson, 
David H. Silber, 
Carl Streeter.
--
Erick Branderhorst@heel.fgg.eur.nl +31-10-4635142
Department of General Surgery (Intensive Care) University Hospital Rotterdam NL


Reply to: