You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdesdk/doc/man/scripts/kdemangen.pl.1

52 lines
1.9 KiB

.\" Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH KDEMANGEN.PL 1 "October 15, 2004"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
kdemangen.pl \- automatically create a draft manpage for a TDE app
.SH SYNOPSIS
.B kdemangen.pl
.I /path/to/application
.SH DESCRIPTION
\fBkdemangen.pl\fP will automatically create a draft manpage for a TDE
application. Manpages are always better when hand-tailored, but this
should give you a fairly good start.
.PP
To create the manpage, it will use the \-\-author and \-\-help\-all
output for the application passed on the command line.
It will also use the description in the
Debian control file if one is available. To make use of this additional
feature, you must run kdemangen.pl from within the \fIdebian/\fP
subdirectory of the application sources.
.PP
The new manpage will be written to standard output.
.PP
This utility is part of the TDE Software Development Kit.
.SH WARNING
This utility will only work for a full TDE application that uses
TDECmdLineArgs (which most full TDE applications do).
.SH EXAMPLE
.RS
cd /path/to/tde/srcs/tdeedu/debian
.br
kdemangen /usr/bin/kstars > kstars.1
.RE
.SH AUTHOR
kdemangen.pl was written by Dominique Devriese <devriese@kde.org>.
.br
This manual page was prepared by Ben Burton <bab@debian.org>
for the Debian GNU/Linux system (but may be used by others).