diff options
author | Michele Calgaro <michele.calgaro@yahoo.it> | 2022-06-13 13:47:50 +0900 |
---|---|---|
committer | Michele Calgaro <michele.calgaro@yahoo.it> | 2022-06-13 15:42:17 +0900 |
commit | d8521af7be8cafc64525755758d25f0b70072ea5 (patch) | |
tree | 502917d6e35afa2e8aed5dfa71bbc129eb388f28 | |
parent | 3cb0d9a6cdab412d4845af7a7994187f0a5507bb (diff) | |
download | tdesdk-d8521af7be8cafc64525755758d25f0b70072ea5.tar.gz tdesdk-d8521af7be8cafc64525755758d25f0b70072ea5.zip |
Add man pages for TDE applications
Signed-off-by: Michele Calgaro <michele.calgaro@yahoo.it>
74 files changed, 3437 insertions, 14 deletions
diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index df842e47..af656c0a 100644 --- a/doc/CMakeLists.txt +++ b/doc/CMakeLists.txt @@ -1,12 +1,13 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# +add_subdirectory( man ) -tde_auto_add_subdirectories( ) +tde_conditional_add_subdirectory( BUILD_CERVISIA cervisia ) +#tde_conditional_add_subdirectory( BUILD_KAPPTEMPLATE kapptemplate ) +tde_conditional_add_subdirectory( BUILD_KBABEL kbabel ) +tde_conditional_add_subdirectory( BUILD_KBUGBUSTER kbugbuster ) +tde_conditional_add_subdirectory( BUILD_KOMPARE kompare ) +tde_conditional_add_subdirectory( BUILD_KUIVIEWER kuiviewer ) +tde_conditional_add_subdirectory( BUILD_SCRIPTS scripts ) +tde_conditional_add_subdirectory( BUILD_TDECACHEGRIND tdecachegrind ) +# tdesvn-build is under the script folder +tde_conditional_add_subdirectory( BUILD_SCRIPTS tdesvn-build ) +tde_conditional_add_subdirectory( BUILD_UMBRELLO umbrello ) diff --git a/doc/kapptemplate/Makefile.am b/doc/kapptemplate/Makefile.am deleted file mode 100644 index 07fc0b90..00000000 --- a/doc/kapptemplate/Makefile.am +++ /dev/null @@ -1,2 +0,0 @@ -KDE_LANG=en -KDE_MANS=AUTO diff --git a/doc/man/CMakeLists.txt b/doc/man/CMakeLists.txt new file mode 100644 index 00000000..a44506d4 --- /dev/null +++ b/doc/man/CMakeLists.txt @@ -0,0 +1,12 @@ +tde_conditional_add_subdirectory( BUILD_CERVISIA cervisia ) +tde_conditional_add_subdirectory( BUILD_KAPPTEMPLATE kapptemplate ) +tde_conditional_add_subdirectory( BUILD_KBABEL kbabel ) +tde_conditional_add_subdirectory( BUILD_KBUGBUSTER kbugbuster ) +tde_conditional_add_subdirectory( BUILD_KMTRACE kmtrace ) +tde_conditional_add_subdirectory( BUILD_KOMPARE kompare ) +tde_conditional_add_subdirectory( BUILD_KSPY kspy ) +tde_conditional_add_subdirectory( BUILD_KUIVIEWER kuiviewer ) +tde_conditional_add_subdirectory( BUILD_POXML poxml ) +tde_conditional_add_subdirectory( BUILD_SCRIPTS scripts ) +tde_conditional_add_subdirectory( BUILD_TDECACHEGRIND tdecachegrind ) +tde_conditional_add_subdirectory( BUILD_UMBRELLO umbrello ) diff --git a/doc/man/cervisia/CMakeLists.txt b/doc/man/cervisia/CMakeLists.txt new file mode 100644 index 00000000..24ccd704 --- /dev/null +++ b/doc/man/cervisia/CMakeLists.txt @@ -0,0 +1,7 @@ +file( GLOB _man_files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.1 ) + +INSTALL( + FILES ${_man_files} + DESTINATION ${MAN_INSTALL_DIR}/man1 + COMPONENT doc +) diff --git a/doc/man/cervisia/cvsaskpass.1 b/doc/man/cervisia/cvsaskpass.1 new file mode 100644 index 00000000..d4b7e5df --- /dev/null +++ b/doc/man/cervisia/cvsaskpass.1 @@ -0,0 +1,63 @@ +.\" 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 CVSASKPASS 1 "March 19, 2005" +.\" 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 +cvsaskpass \- prompt for a password for the CVS DCOP service +.SH SYNOPSIS +.B cvsaskpass +.RI "[ " generic-options " ]" +.I prompt +.SH DESCRIPTION +This utility displays a dialog box prompting the user for the password to +a CVS repository, then writes the password to standard output and exits. +You should not need to run this program directly \- it is designed for +the internal use of +.BR cvsservice (1). +.PP +The prompt should be of the following form: +.RS +.PP +\fIuser\fP@\fIhost\fP's password: +.RE +.PP +This will allow the dialog box to display the details of the CVS +repository to the user. +.PP +This utility is part of the CVS service provided with Cervisia, which in +turn is part of the TDE Software Development Kit. +.SH OPTIONS +For a full summary of options, run \fIcvsaskpass \-\-help\fP. +.SH RETURN VALUE +If a password was succefully obtained, 0 is returned. If no prompt was +supplied on the command-line or if the dialog was cancelled, 1 is returned. +.SH SEE ALSO +.BR cervisia (1), +.BR cvsservice (1), +.BR dcop (1). +.PP +Details of how to use the CVS service from within another script or C++ +program can be found in \fI/usr/share/doc/libcvsservice0/DESIGN\fP. +.SH AUTHOR +The CVS service was written by Christian Loose <christian.loose@kdemail.net>. +.br +Cervisia was written by Bernd Gehrmann <bernd@physik.hu-berlin.de>, +Christian Loose <christian.loose@kdemail.net>, +Andre Woebbeking <woebbeking@web.de>, +Carlos Woelz <carloswoelz@imap-mail.com> and others. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/cervisia/cvsservice.1 b/doc/man/cervisia/cvsservice.1 new file mode 100644 index 00000000..9d5c791d --- /dev/null +++ b/doc/man/cervisia/cvsservice.1 @@ -0,0 +1,79 @@ +.\" 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 CVSSERVICE 1 "March 19, 2005" +.\" 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 +cvsservice \- a DCOP service for accessing CVS repositories +.SH SYNOPSIS +.B cvsservice +.RI "[ " generic-options " ]" +.SH DESCRIPTION +The CVS service is a DCOP service for accessing and working with +remote CVS repositories. Applications may link with this library to +access the DCOP service directly from C++. Alternatively, scripts may +access the service using the standard +.BR dcop (1) +command-line tool. +.PP +DCOP is the Desktop Communication Protocol used throughout TDE. +.PP +The CVS DCOP service consists of the following three parts: +.TP +\fBCvsService\fP +The main interface to the functionality of the +.BR cvs (1) +command line client. There is one method for each CVS command, e.g., add, +checkout, commit, etc. The methods assemble the command line +arguments, create a CvsJob and return a DCOPRef object for it +to the caller. There is one instance of this service for each +application instance. +.TP +\fBRepository\fP +This DCOPObject manages the configuration data of the current +CVS repository. The data is automatically updated when other +service instances change it. +.TP +\fBCvsJob\fP +This class represents a CVS job. You can execute and cancel it, +and you can retrieve the output of the cvs client by either +connecting to the proper DCOP signals or by using the output() +method. There are two types of jobs. First the non-concurrent +job which has to run alone, like cvs update or import. Second +the jobs which can run concurrently like cvs log or annotate. +.PP +The CVS service is provided with Cervisia, which is part of the TDE +Software Development Kit. +.SH OPTIONS +For a full summary of options, run \fIcvsservice \-\-help\fP. +.SH SEE ALSO +.BR cervisia (1), +.BR cvs (1), +.BR cvsaskpass (1), +.BR dcop (1). +.PP +Details of how to use the CVS service from within a shell script, a C++ +program or through the JavaScript bindings can be found in +\fI/usr/share/doc/libcvsservice0/DESIGN\fP. +.SH AUTHOR +The CVS service was written by Christian Loose <christian.loose@kdemail.net>. +.br +Cervisia was written by Bernd Gehrmann <bernd@physik.hu-berlin.de>, +Christian Loose <christian.loose@kdemail.net>, +Andre Woebbeking <woebbeking@web.de>, +Carlos Woelz <carloswoelz@imap-mail.com> and others. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/kapptemplate/CMakeLists.txt b/doc/man/kapptemplate/CMakeLists.txt new file mode 100644 index 00000000..24ccd704 --- /dev/null +++ b/doc/man/kapptemplate/CMakeLists.txt @@ -0,0 +1,7 @@ +file( GLOB _man_files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.1 ) + +INSTALL( + FILES ${_man_files} + DESTINATION ${MAN_INSTALL_DIR}/man1 + COMPONENT doc +) diff --git a/doc/man/kapptemplate/kapptemplate.1 b/doc/man/kapptemplate/kapptemplate.1 new file mode 100644 index 00000000..1010ecd5 --- /dev/null +++ b/doc/man/kapptemplate/kapptemplate.1 @@ -0,0 +1,69 @@ +.\" 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 KAPPTEMPLATE 1 "January 31, 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 +kapptemplate \- creates a framework to develop a TDE application +.SH SYNOPSIS +.B kapptemplate +[ \fB\-\-noinit\fP ] [ \fB\-\-default\fP ] +.RB "[ " \-\-full\-app " | " \-\-kpart\-app " | " \-\-kpart\-plugin +.RB " | " \-\-existing " ]" +.PP +.B kapptemplate \-\-help +.SH DESCRIPTION +\fBKAppTemplate\fP is a shell script that will create the necessary +framework to develop various TDE applications. It takes care of the +autoconf/automake code as well as providing a skeleton and example of +what the code typically looks like. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.SS General Options +.TP +\-\-help +Display a full summary of options. +.TP +\-\-noinit +Don't run 'make \-f Makefile.cvs'. +.TP +\-\-default +Use default values instead of prompting. +.SS Framework Types +.TP +\-\-full\-app +Create a full featured TDE application. +.TP +\-\-kpart\-app +Create a full featured KPart application. +.TP +\-\-kpart\-plugin +Create a KPart plugin framework. +.TP +\-\-existing +Converting existing source to an automake/autoconf TDE framework. +.SH FILES +.TP +.I ~/.kapptemplate +Stores default values. +.SH SEE ALSO +The original documentation from the program author +is available in \fI/usr/share/doc/kapptemplate/\fP. +.SH AUTHOR +KAppTemplate was written by Kurt Granroth <granroth@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). diff --git a/doc/man/kbabel/CMakeLists.txt b/doc/man/kbabel/CMakeLists.txt new file mode 100644 index 00000000..24ccd704 --- /dev/null +++ b/doc/man/kbabel/CMakeLists.txt @@ -0,0 +1,7 @@ +file( GLOB _man_files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.1 ) + +INSTALL( + FILES ${_man_files} + DESTINATION ${MAN_INSTALL_DIR}/man1 + COMPONENT doc +) diff --git a/doc/man/kbabel/catalogmanager.1 b/doc/man/kbabel/catalogmanager.1 new file mode 100644 index 00000000..db8b1761 --- /dev/null +++ b/doc/man/kbabel/catalogmanager.1 @@ -0,0 +1,66 @@ +.\" 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 CATALOGMANAGER 1 "March 19, 2005" +.\" 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 +catalogmanager \- advanced catalog manager for KBabel +.SH SYNOPSIS +.B catalogmanager +.RI "[ " generic-options " ]" +[ \fB\-\-project\fP \fIconfig-file\fP ] +.SH DESCRIPTION +\fBCatalogManager\fP is part of a suite of programs for editing gettext +message files (PO-files). This suite is designed to help you translate fast +and consistently. +.PP +This suite includes KBabel, CatalogManager and KBabelDict. KBabel is an +advanced and easy to use PO-file editor with full navigational and editing +capabilities, syntax checking and statistics. CatalogManager (this program) +is a multi functional catalog manager which allows you to keep track of many +PO-files at once. KBabelDict is a dictionary to assist with searching +for common translations. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +Below are the catalogmanager-specific options. +For a full summary of options, run \fIcatalogmanager \-\-help\fP. +.TP +\fB\-\-project\fP \fIconfig-file\fP +Load the configuration from the given file. +.SH SEE ALSO +.BR kbabel (1), +.BR kbabeldict (1). +.PP +Full user documentation for KBabel is available through the TDE Help Centre. +You can also enter the URL +\fIhelp:/kbabel/\fP +directly into konqueror or you can run +`\fIkhelpcenter help:/kbabel/\fP' +from the command-line. +.PP +If the TDE Help Centre is not installed then you can install the package +\fItdesdk-doc-html\fP and read this documentation in HTML format from +\fI/usr/share/doc/tde/HTML/en/kbabel/\fP. +.SH AUTHOR +KBabel was written by Matthias Kiefer <kiefer@kde.org>, +Wolfram Diestel <wolfram@steloj.de>, Andrea Rizzi <rizzi@kde.org>, +Stanislav Visnovsky <visnovsky@kde.org>, Marco Wegner <dubbleu@web.de>, +Asgeir Frimannsson <asgeirf@redhat.com>, +Dwayne Bailey <dwayne@translate.org.za>, +Bram Schoenmakers <bramschoenmakers@kde.nl> and others. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/kbabel/kbabel.1 b/doc/man/kbabel/kbabel.1 new file mode 100644 index 00000000..047e3626 --- /dev/null +++ b/doc/man/kbabel/kbabel.1 @@ -0,0 +1,74 @@ +.\" 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 KBABEL 1 "March 19, 2005" +.\" 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 +kbabel \- a PO-file editor for TDE +.SH SYNOPSIS +.B kbabel +.RI "[ " generic-options " ]" +[ \fB\-\-gotomsgid\fP \fImsgid\fP ] [ \fB\-\-nosplash\fP ] +[ \fB\-\-project\fP \fIconfig-file\fP ] +.RI "[ " file " ]" +.SH DESCRIPTION +\fBKBabel\fP is part of a suite of programs for editing gettext message +files (PO-files). It is designed to help you translate fast and +consistently. +.PP +This suite includes KBabel, CatalogManager and KBabelDict. KBabel (this +program) is an advanced and easy to use PO-file editor with full navigational +and editing capabilities, syntax checking and statistics. CatalogManager is +a multi functional catalog manager which allows you to keep track of many +PO-files at once. KBabelDict is a dictionary to assist with searching +for common translations. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +Below are the kbabel-specific options. +For a full summary of options, run \fIkbabel \-\-help\fP. +.TP +\fB\-\-gotomsgid\fP \fImsgid\fP +Go to the entry with the given message ID. +.TP +.B \-\-nosplash +Disable splashscreen at startup. +.TP +\fB\-\-project\fP \fIconfig-file\fP +Load the configuration from the given file. +.SH SEE ALSO +.BR catalogmanager (1), +.BR kbabeldict (1). +.PP +Full user documentation is available through the TDE Help Centre. +You can also enter the URL +\fIhelp:/kbabel/\fP +directly into konqueror or you can run +`\fIkhelpcenter help:/kbabel/\fP' +from the command-line. +.PP +If the TDE Help Centre is not installed then you can install the package +\fItdesdk-doc-html\fP and read this documentation in HTML format from +\fI/usr/share/doc/tde/HTML/en/kbabel/\fP. +.SH AUTHOR +KBabel was written by Matthias Kiefer <kiefer@kde.org>, +Wolfram Diestel <wolfram@steloj.de>, Andrea Rizzi <rizzi@kde.org>, +Stanislav Visnovsky <visnovsky@kde.org>, Marco Wegner <dubbleu@web.de>, +Asgeir Frimannsson <asgeirf@redhat.com>, +Dwayne Bailey <dwayne@translate.org.za>, +Bram Schoenmakers <bramschoenmakers@kde.nl> and others. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/kbabel/kbabeldict.1 b/doc/man/kbabel/kbabeldict.1 new file mode 100644 index 00000000..ffd9b465 --- /dev/null +++ b/doc/man/kbabel/kbabeldict.1 @@ -0,0 +1,66 @@ +.\" 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 KBABELDICT 1 "March 19, 2005" +.\" 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 +kbabeldict \- the KBabel dictionary for translators +.SH SYNOPSIS +.B kbabeldict +.RI "[ " generic-options " ]" +.RB "[ " \-\-nosplash " ]" +.SH DESCRIPTION +\fBKBabelDict\fP is part of a suite of programs for editing gettext message +files (PO-files). This suite is designed to help you translate fast and +consistently. +.PP +This suite includes KBabel, CatalogManager and KBabelDict. KBabel is an +advanced and easy to use PO-file editor with full navigational and editing +capabilities, syntax checking and statistics. CatalogManager is a multi +functional catalog manager which allows you to keep track of many +PO-files at once. KBabelDict (this program) is a dictionary to assist +with searching for common translations. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +Below are the kbabeldict-specific options. +For a full summary of options, run \fIkbabeldict \-\-help\fP. +.TP +.B \-\-nosplash +Disable splashscreen at startup. +.SH SEE ALSO +.BR kbabel (1), +.BR catalogmanager (1). +.PP +Full user documentation for KBabel is available through the TDE Help Centre. +You can also enter the URL +\fIhelp:/kbabel/\fP +directly into konqueror or you can run +`\fIkhelpcenter help:/kbabel/\fP' +from the command-line. +.PP +If the TDE Help Centre is not installed then you can install the package +\fItdesdk-doc-html\fP and read this documentation in HTML format from +\fI/usr/share/doc/tde/HTML/en/kbabel/\fP. +.SH AUTHOR +KBabel was written by Matthias Kiefer <kiefer@kde.org>, +Wolfram Diestel <wolfram@steloj.de>, Andrea Rizzi <rizzi@kde.org>, +Stanislav Visnovsky <visnovsky@kde.org>, Marco Wegner <dubbleu@web.de>, +Asgeir Frimannsson <asgeirf@redhat.com>, +Dwayne Bailey <dwayne@translate.org.za>, +Bram Schoenmakers <bramschoenmakers@kde.nl> and others. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/kbugbuster/CMakeLists.txt b/doc/man/kbugbuster/CMakeLists.txt new file mode 100644 index 00000000..24ccd704 --- /dev/null +++ b/doc/man/kbugbuster/CMakeLists.txt @@ -0,0 +1,7 @@ +file( GLOB _man_files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.1 ) + +INSTALL( + FILES ${_man_files} + DESTINATION ${MAN_INSTALL_DIR}/man1 + COMPONENT doc +) diff --git a/doc/man/kbugbuster/kbugbuster.1 b/doc/man/kbugbuster/kbugbuster.1 new file mode 100644 index 00000000..29b9c38d --- /dev/null +++ b/doc/man/kbugbuster/kbugbuster.1 @@ -0,0 +1,50 @@ +.\" 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 KBUGBUSTER 1 "January 31, 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 +kbugbuster \- front end for the TDE bug tracking system +.SH SYNOPSIS +.B kbugbuster +.RI "[ " generic-options " ]" +[ \fB\-d, \-\-disconnected\fP ] +[ \fB\-\-pkg, \-\-package\fP \fIpkg\fP ] +[ \fB\-\-bug\fP \fInumber\fP ] +.SH DESCRIPTION +\fBKBugBuster\fP is a GUI front end for the TDE bug tracking system. +It allows the user to view and manipulate bug reports and provides a +variety of options for searching through reports. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +Below are the kbugbuster-specific options. +For a full summary of options, run \fIkbugbuster \-\-help\fP. +.TP +[ \fB\-d, \-\-disconnected\fP ] +Start in disconnected mode. +.TP +[ \fB\-\-pkg, \-\-package\fP \fIpkg\fP ] +Start with the bug list for the given package. +.TP +[ \fB\-\-bug\fP \fInumber\fP ] +Start with the given bug report. +.SH AUTHOR +KBugBuster was written by Martijn Klingens <klingens@kde.org>, +Simon Hausmann <hausmann@kde.org>, Cornelius Schumacher <schumacher@kde.org> +and David Faure <faure@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). diff --git a/doc/man/kmtrace/CMakeLists.txt b/doc/man/kmtrace/CMakeLists.txt new file mode 100644 index 00000000..24ccd704 --- /dev/null +++ b/doc/man/kmtrace/CMakeLists.txt @@ -0,0 +1,7 @@ +file( GLOB _man_files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.1 ) + +INSTALL( + FILES ${_man_files} + DESTINATION ${MAN_INSTALL_DIR}/man1 + COMPONENT doc +) diff --git a/doc/man/kmtrace/demangle.1 b/doc/man/kmtrace/demangle.1 new file mode 100644 index 00000000..8f4f3922 --- /dev/null +++ b/doc/man/kmtrace/demangle.1 @@ -0,0 +1,57 @@ +.\" 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 DEMANGLE 1 "February 25, 2003" +.\" 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 +demangle \- undo C++ name mangling for symbols +.SH SYNOPSIS +.B demangle +.SH DESCRIPTION +\fBDemangle\fP reads a list of C++ mangled symbol names from standard +input and converts these names to human-readable form on standard +output. +.PP +This utility is part of the TDE Software Development Kit. +.SH EXAMPLE +Create a file called \fInames\fP containing the following mangled symbol +names: +.PP +.RS +_ZNK6Object10metaObjectEv +.br +_ZN8QPtrListI5ArrowE5clearEv +.br +_ZTC4Kolf0_11TDEMainWindow +.RE +.PP +These names can then be demangled as follows: +.PP +.RS +\fIexample$\fP demangle < names +.br +Object::metaObject() const +.br +QPtrList<Arrow>::clear() +.br +construction vtable for TDEMainWindow-in-Kolf +.RE +.SH SEE ALSO +.BR kminspector (1), +.BR kmmatch (1), +.BR kmtrace (1). +.SH AUTHOR +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/kmtrace/kminspector.1 b/doc/man/kmtrace/kminspector.1 new file mode 100644 index 00000000..29cb70e5 --- /dev/null +++ b/doc/man/kmtrace/kminspector.1 @@ -0,0 +1,50 @@ +.\" 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 KMINSPECTOR 1 "February 25, 2003" +.\" 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 +kminspector \- run a program with the TDE memory leak tracer +.SH SYNOPSIS +.B kminspector +\fIprogram\fP [ \fIprogram-args\fP ] +.SH DESCRIPTION +\fBKMinspector\fP runs the given program, examines its memory +allocation behaviour using \fIlibktrace\fP and pipes the resulting +allocation tree through \fIless\fP. +.PP +The given program does not need to be specially compiled. +.PP +This utility is provided with KMtrace, +a TDE tool to assist with malloc debugging using +glibc's "mtrace" functionality. Unfortunately the mtrace that is part of +current (9/9/2000) glibc versions only logs the return-address of the +malloc/free call. The library included with KMtrace +logs a complete backtrace upon malloc/free. +.PP +This utility is part of the TDE Software Development Kit. +.SH SEE ALSO +.BR demangle (1), +.BR kmmatch (1), +.BR kmtrace (1). +.PP +Much more extensive documentation for KMtrace can be found in +\fI/usr/share/doc/kmtrace/README\fP. +.SH AUTHOR +KMtrace was written by Waldo Bastian <bastian@kde.org>, +Mike Haertel <mike@ai.mit.edu> and Andi Kleen <ak@suse.de>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/kmtrace/kmmatch.1 b/doc/man/kmtrace/kmmatch.1 new file mode 100644 index 00000000..d80c1554 --- /dev/null +++ b/doc/man/kmtrace/kmmatch.1 @@ -0,0 +1,52 @@ +.\" 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 KMMATCH 1 "February 26, 2003" +.\" 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 +kmmatch \- search for symbols in a map file +.SH SYNOPSIS +.B kmmatch +.I map-file call-file +.SH DESCRIPTION +\fBKMMatch\fP determines which symbols from a given set (\fIcall-file\fP) are +present in a given map file. +.PP +The \fImap-file\fP should contain output from \fInm\fP (which extracts +information from object files). It must \fBnot\fP contain any blank +lines or header information (such as the name of the object file); this +means you may need to strip the first few lines of \fInm\fP output from +the \fImap-file\fP. +.PP +The \fIcall-file\fP should contain a list of symbols (such as function +calls made by a program), one per line. +.PP +This utility will find which of the symbols in \fIcall-file\fP are +present in \fImap-file\fP and write them to standard error, one per +line, in the order in which they appear in \fIcall-file\fP. +.PP +Note that this utility is called \fBmatch\fP in the original TDE +distribution; it has been renamed to \fBkmmatch\fP in Debian to +avoid conflicts with unrelated packages. +.PP +This utility is part of the TDE Software Development Kit. +.SH SEE ALSO +.BR demangle (1), +.BR kminspector (1), +.BR kmtrace (1), +.BR nm (1). +.SH AUTHOR +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/kmtrace/kmtrace.1 b/doc/man/kmtrace/kmtrace.1 new file mode 100644 index 00000000..14f5f9fc --- /dev/null +++ b/doc/man/kmtrace/kmtrace.1 @@ -0,0 +1,72 @@ +.\" 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 KMTRACE 1 "February 25, 2003" +.\" 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 +kmtrace \- a TDE memory leak tracer +.SH SYNOPSIS +.B kmtrace +[ \fIgeneric-options\fP ] +[ \fB\-x, \-\-exclude\fP \fIfile\fP ] +[ \fB\-e, \-\-exe\fP \fIfile\fP ] +[ \fB\-t, \-\-tree\fP \fIfile\fP +[ \fB\-\-th, \-\-treethreshold\fP \fIvalue\fP ] +[ \fB\-\-td, \-\-treedepth\fP \fIvalue\fP ]] +[ \fItrace-log\fP ] +.SH DESCRIPTION +\fBKMtrace\fP is a TDE tool to assist with malloc debugging using +glibc's "mtrace" functionality. Unfortunately the mtrace that is part of +current (9/9/2000) glibc versions only logs the return-address of the +malloc/free call. The library included with KMtrace +logs a complete backtrace upon malloc/free. +.PP +KMtrace will investigate the trace log specified on the command line, +or \fIktrace.out\fP if no trace log is specified. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +Below are the kmtrace-specific options. +For a full summary of options, run \fIkmtrace \-\-help\fP. +.TP +\fB\-x, \-\-exclude\fP \fIfile\fP +File containing symbols to exclude from output. +.TP +\fB\-e, \-\-exe\fP \fIfile\fP +Executable to use for looking up unknown symbols. +.TP +\fB\-t, \-\-tree\fP \fIfile\fP +Write a tree of the allocations to the given file. +.TP +\fB\-\-th, \-\-treethreshold\fP \fIvalue\fP +When writing the allocations tree, hide subtrees allocating less than the +given memory amount. +.TP +\fB\-\-td, \-\-treedepth\fP \fIvalue\fP +When writing the allocations tree, hide subtrees that are deeper than the +specified depth. +.SH SEE ALSO +.BR demangle (1), +.BR kminspector (1), +.BR kmmatch (1). +.PP +Much more extensive documentation can be found in +\fI/usr/share/doc/kmtrace/README\fP. +.SH AUTHOR +KMtrace was written by Waldo Bastian <bastian@kde.org>, +Mike Haertel <mike@ai.mit.edu> and Andi Kleen <ak@suse.de>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/kompare/CMakeLists.txt b/doc/man/kompare/CMakeLists.txt new file mode 100644 index 00000000..24ccd704 --- /dev/null +++ b/doc/man/kompare/CMakeLists.txt @@ -0,0 +1,7 @@ +file( GLOB _man_files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.1 ) + +INSTALL( + FILES ${_man_files} + DESTINATION ${MAN_INSTALL_DIR}/man1 + COMPONENT doc +) diff --git a/doc/man/kompare/kompare.1 b/doc/man/kompare/kompare.1 new file mode 100644 index 00000000..e777752e --- /dev/null +++ b/doc/man/kompare/kompare.1 @@ -0,0 +1,79 @@ +.\" 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 KOMPARE 1 "March 25, 2005" +.\" 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 +kompare \- a TDE GUI for viewing differences between files +.SH SYNOPSIS +.B kompare +[ \fIgeneric-options\fP ] +.br +.B kompare +[ \fIgeneric-options\fP ] [ \fB\-c\fP ] \fIURL1 URL2\fP +.br +.B kompare +[ \fIgeneric-options\fP ] [ \fB\-o\fP [ \fB\-n\fP ]] \fIdiff\fP +.br +.B kompare +[ \fIgeneric-options\fP ] \fB\-b\fP \fIURL diff\fP +.SH DESCRIPTION +\fBKompare\fP is a graphical user interface for viewing the differences +between two files. It will also optionally create a diff file. +.PP +Depending upon what is passed on the command line, Kompare can compare +documents, display diff files and blend diff files back into original +documents. +.PP +If an url is given as - then Kompare will read the corresponding file +from standard input. Thus (for instance) Kompare can be used as: +.PP +.RS +cvs diff | kompare \-o \- +.RE +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +Below are the kompare-specific options. +For a full summary of options, run \fIkompare \-\-help\fP. +.TP +\fB\-b\fP \fIURL diff\fP +Blends \fIdiff\fP into URL. \fIdiff\fP is expected to be diff output and +\fIURL\fP the file or folder that the diff output needs to be blended into. +.TP +\fB\-c\fP \fIURL1 URL2\fP +Compares \fIURL1\fP with \fIURL2\fP. This is the default mode if two +URLs are passed. +.TP +\fB\-n\fP +Used with \fB\-o\fP to stop Kompare from checking for the original file. +.TP +\fB\-o\fP \fIdiff\fP +Opens the given diff file. This is the default mode if only one URL is +passed. +.br +Kompare will check to see if it can find +the original file(s). If it can, it will blend the original file(s) into +the diff output and show the result in the viewer. Passing \fB\-n\fP +will disable this check. +.SH SEE ALSO +The original documentation from the program author +is available in \fI/usr/share/doc/kompare/\fP. +.SH AUTHOR +Kompare was written by John Firebaugh <jfirebaugh@kde.org>, +Otto Bruggeman <otto.bruggeman@home.nl> and others. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/kspy/CMakeLists.txt b/doc/man/kspy/CMakeLists.txt new file mode 100644 index 00000000..24ccd704 --- /dev/null +++ b/doc/man/kspy/CMakeLists.txt @@ -0,0 +1,7 @@ +file( GLOB _man_files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.1 ) + +INSTALL( + FILES ${_man_files} + DESTINATION ${MAN_INSTALL_DIR}/man1 + COMPONENT doc +) diff --git a/doc/man/kspy/testkspy.1 b/doc/man/kspy/testkspy.1 new file mode 100644 index 00000000..afdc702a --- /dev/null +++ b/doc/man/kspy/testkspy.1 @@ -0,0 +1,46 @@ +.\" 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 TESTKSPY 1 "May 3, 2001" +.\" 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 +testkspy \- show off KSpy's capabilities +.SH SYNOPSIS +.B testkspy +.RI "[ " generic-options " ]" +.SH DESCRIPTION +\fBtestkspy\fP is a small application that shows off KSpy's capabilities. +It simply uses KSpy to spy on itself. +.PP +\fBKSpy\fP is a tiny library which can be used to graphically display +the TQObjects in use by a TQt/TDE app. In addition to the object tree, +you can also view the properties, signals and slots of any QObject. +.PP +Basically it provides much the same info as QObject::dumpObjectTree() and +QObject::dumpObjectInfo(), but in a much more convenient form. KSpy has +minimal overhead for the application, because the kspy library is +loaded dynamically using KLibLoader. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +For a full summary of options, run \fItestkspy \-\-help\fP. +.SH SEE ALSO +Instructions on using KSpy with your own applications can be found in +\fI/usr/share/doc/kspy/README\fP. +.SH AUTHOR +KSpy was written by Richard Moore <rich@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). diff --git a/doc/man/kuiviewer/CMakeLists.txt b/doc/man/kuiviewer/CMakeLists.txt new file mode 100644 index 00000000..24ccd704 --- /dev/null +++ b/doc/man/kuiviewer/CMakeLists.txt @@ -0,0 +1,7 @@ +file( GLOB _man_files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.1 ) + +INSTALL( + FILES ${_man_files} + DESTINATION ${MAN_INSTALL_DIR}/man1 + COMPONENT doc +) diff --git a/doc/man/kuiviewer/kuiviewer.1 b/doc/man/kuiviewer/kuiviewer.1 new file mode 100644 index 00000000..5439127a --- /dev/null +++ b/doc/man/kuiviewer/kuiviewer.1 @@ -0,0 +1,65 @@ +.\" 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 KUIVIEWER 1 "March 25, 2005" +.\" 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 +kuiviewer \- a viewer for Qt Designer user interface files +.SH SYNOPSIS +.B kuiviewer +.RI "[ " generic-options " ]" +.RI "[ " ui-file ... " ]" +.PP +.B kuiviewer +.RI "[ " generic-options " ]" +{ \fB\-s, \-\-takescreenshot\fP \fIfilename\fP } +[ \fB\-w, \-\-screenshotwidth\fP \fIint\fP ] +[ \fB\-h, \-\-screenshotheight\fP \fIint\fP ] +.I ui-file +.SH DESCRIPTION +\fBKUIViewer\fP is a utility to display and test the user interface (.ui) +files generated by \fBQt Designer\fP. The interfaces can be displayed in a +variety of different widget styles. +.PP +Normally KUIViewer launches a full GUI, allowing the user to interact with +the given interface. +By passing the \fB\-\-takescreenshot\fP option, you can make KUIViewer dump a +screenshot of the interface instead and exit immediately. Other options +are available to control precisely how this screenshot is constructed. +.PP +This application is part of the TDE Software Development Kit. +.SH OPTIONS +Below are the kuiviewer-specific options. +For a full summary of options, run \fIkuiviewer \-\-help\fP. +.TP +\fB\-s, \-\-takescreenshot\fP \fIfilename\fP +Take a screenshot of the given interface and exit immediately. +The \fIfilename\fP argument specifies where the screenshot will be saved. +This screenshot will be saved in PNG format. +.TP +\fB\-w, \-\-screenshotwidth\fP \fIint\fP +Before taking a screenshot, resize the interface to the given width. +.TP +\fB\-h, \-\-screenshotheight\fP \fIint\fP +Before taking a screenshot, resize the interface to the given height. +.SH SEE ALSO +.BR designer (1). +.SH AUTHOR +KUIViewer was written by Richard Moore <rich@kde.org>, +Ian Reinhart Geiser <geiseri@kde.org> and +Benjamin C. Meyer <ben+kuiviewer@meyerhome.net>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/poxml/CMakeLists.txt b/doc/man/poxml/CMakeLists.txt new file mode 100644 index 00000000..24ccd704 --- /dev/null +++ b/doc/man/poxml/CMakeLists.txt @@ -0,0 +1,7 @@ +file( GLOB _man_files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.1 ) + +INSTALL( + FILES ${_man_files} + DESTINATION ${MAN_INSTALL_DIR}/man1 + COMPONENT doc +) diff --git a/doc/man/poxml/po2xml.1 b/doc/man/poxml/po2xml.1 new file mode 100644 index 00000000..d2f7fe5d --- /dev/null +++ b/doc/man/poxml/po2xml.1 @@ -0,0 +1,40 @@ +.\" 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 PO2XML 1 "March 19, 2005" +.\" 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 +po2xml \- translates a DocBook XML file using a PO-file +.SH SYNOPSIS +.B po2xml +.I original-XML translated-PO +.SH DESCRIPTION +\fBpo2xml\fP is a command-line tool that translates the DocBook +XML file \fIoriginal-XML\fP using the gettext message file +\fItranslated-PO\fP. The resulting translated XML file is sent to standard +output. +.PP +This utility is part of the TDE Software Development Kit. +.SH SEE ALSO +.BR split2po (1), +.BR swappo (1), +.BR transxx (1), +.BR xml2pot (1). +.SH AUTHOR +The PO-XML tools were written by Stephan Kulow <coolo@kde.org> and +Peter Wells <pete@yamuna.demon.co.uk>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/poxml/split2po.1 b/doc/man/poxml/split2po.1 new file mode 100644 index 00000000..539e2f6c --- /dev/null +++ b/doc/man/poxml/split2po.1 @@ -0,0 +1,60 @@ +.\" 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 SPLIT2PO 1 "March 19, 2005" +.\" 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 +split2po \- creates a PO-file from two DocBook XML files +.SH SYNOPSIS +.B split2po +.I original-XML translated-XML +.SH DESCRIPTION +\fBsplit2po\fP is a command-line tool that takes the two given DocBook +XML files and produces a gettext message file (PO-file) that represents +the changes between them. The resulting PO-file is sent to standard +output. +.PP +.I translated-XML +must be the result of translating +.I original-XML +into another language. It is this translation that the resulting +PO-file will represent. +.PP +This utility is part of the TDE Software Development Kit. +.SH ENVIRONMENT VARIABLES +.TP +NO_CREDITS +If set, the "ROLES_OF_TRANSLATORS" and "CREDIT_FOR_TRANSLATORS" messages +will be omitted. By default these are always included at the end of +the PO-file, with empty message strings. +.br +These messages are used with TDE documentation, so you may wish to set +NO_CREDITS if you are working with some other type of non-TDE documentation. +.TP +REPORT_MISMATCHES +Set this variable to "no" if you wish mismatch reporting to be +suppressed. By default, any apparent mismatches between the two XML +files will be noted on standard error. +.SH SEE ALSO +.BR po2xml (1), +.BR swappo (1), +.BR transxx (1), +.BR xml2pot (1). +.SH AUTHOR +The PO-XML tools were written by Stephan Kulow <coolo@kde.org> and +Peter Wells <pete@yamuna.demon.co.uk>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/poxml/swappo.1 b/doc/man/poxml/swappo.1 new file mode 100644 index 00000000..bb1289d9 --- /dev/null +++ b/doc/man/poxml/swappo.1 @@ -0,0 +1,44 @@ +.\" 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 SWAPPO 1 "March 19, 2005" +.\" 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 +swappo \- swap msgid and msgstr fields in a PO-file +.SH SYNOPSIS +.B swappo +.I PO-file +.SH DESCRIPTION +\fBswappo\fP reads the given PO-file and swaps the \fImsgid\fP and +\fImsgstr\fP fields for every message. The result is a new PO-file that +translates in the opposite direction. For example, if \fIPO-file\fP +translates from English to French, the new PO-file will translate from +French to English. +.PP +The new PO-file will be written to standard output. The old PO-file +will remain untouched. +.PP +This utility is part of the TDE Software Development Kit. +.SH SEE ALSO +.BR po2xml (1), +.BR split2po (1), +.BR transxx (1), +.BR xml2pot (1). +.SH AUTHOR +The PO-XML tools were written by Stephan Kulow <coolo@kde.org> and +Peter Wells <pete@yamuna.demon.co.uk>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/poxml/transxx.1 b/doc/man/poxml/transxx.1 new file mode 100644 index 00000000..6dba2239 --- /dev/null +++ b/doc/man/poxml/transxx.1 @@ -0,0 +1,47 @@ +.\" 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 TRANSXX 1 "March 19, 2005" +.\" 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 +transxx \- create a basic fleshed-out PO-file from a PO-template file +.SH SYNOPSIS +.B transxx +[ \fB\-\-text\fP \fItranslation\fP ] +.I template +.SH DESCRIPTION +\fBtransxx\fP is a command-line tool that produces a basic fleshed-out +PO-file from a PO-template file. Some of the formatting and +structure of the \fImsgid\fP strings will be copied to the \fImsgstr\fP +strings, but otherwise text will be translated to "xx". +.PP +The fleshed-out PO-file is sent to standard output. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.TP +\fB\-\-text\fP \fItranslation\fP +Use the given translation everywhere instead of "xx". +.SH SEE ALSO +.BR po2xml (1), +.BR split2po (1), +.BR swappo (1), +.BR xml2pot (1). +.SH AUTHOR +The PO-XML tools were written by Stephan Kulow <coolo@kde.org> and +Peter Wells <pete@yamuna.demon.co.uk>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/poxml/xml2pot.1 b/doc/man/poxml/xml2pot.1 new file mode 100644 index 00000000..0b1a293d --- /dev/null +++ b/doc/man/poxml/xml2pot.1 @@ -0,0 +1,45 @@ +.\" 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 XML2POT 1 "March 19, 2005" +.\" 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 +xml2pot \- creates a PO-template file from a DocBook XML file +.SH SYNOPSIS +.B xml2pot +.I original-XML +.SH DESCRIPTION +\fBxml2pot\fP is a command-line tool that produces a gettext message +template file from the DocBook XML file \fIoriginal-XML\fP. +The template file is sent to standard output. +.PP +The resulting template file can be used to create gettext message files +(PO-files) for a variety of languages. These can then be used in conjunction +with +.BR po2xml (1) +to translate the original XML file into these other languages. +.PP +This utility is part of the TDE Software Development Kit. +.SH SEE ALSO +.BR po2xml (1), +.BR split2po (1), +.BR swappo (1), +.BR transxx (1). +.SH AUTHOR +The PO-XML tools were written by Stephan Kulow <coolo@kde.org> and +Peter Wells <pete@yamuna.demon.co.uk>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/CMakeLists.txt b/doc/man/scripts/CMakeLists.txt new file mode 100644 index 00000000..24ccd704 --- /dev/null +++ b/doc/man/scripts/CMakeLists.txt @@ -0,0 +1,7 @@ +file( GLOB _man_files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.1 ) + +INSTALL( + FILES ${_man_files} + DESTINATION ${MAN_INSTALL_DIR}/man1 + COMPONENT doc +) diff --git a/doc/man/scripts/adddebug.1 b/doc/man/scripts/adddebug.1 new file mode 100644 index 00000000..d78dad43 --- /dev/null +++ b/doc/man/scripts/adddebug.1 @@ -0,0 +1,45 @@ +.\" 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 ADDDEBUG 1 "January 31, 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 +adddebug \- modifies Makefile(s) to add debug info +.SH SYNOPSIS +.B adddebug +.RB "[ " \-k " ] [ " \-n " ] [ " \-r " ]" +.SH DESCRIPTION +\fBadddebug\fP modifies the \fIMakefile\fP in the current directory +(and optionally in its subdirectories) to add debug info (\fI\-g3\fP). +It will also remove optimisations (\fI\-O[1-9]?\fP), and can optionally +remove \fI\-DNDEBUG\fP and \fI\-DNO_DEBUG\fP as well. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.TP +.B \-k +Keep optimisations (do not remove \fI\-O[1-9]?\fP flags which are +removed by default). +.TP +.B \-n +Compile without \fINDEBUG\fP and \fINO_DEBUG\fP being defined (this +makes kdDebug calls work). +.TP +.B \-r +Recursively search through all subdirectories of the current directory +and operate on every Makefile that is found. +.SH AUTHOR +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/build-progress.sh.1 b/doc/man/scripts/build-progress.sh.1 new file mode 100644 index 00000000..28c9d901 --- /dev/null +++ b/doc/man/scripts/build-progress.sh.1 @@ -0,0 +1,56 @@ +.\" 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 BUILD-PROGRESS.SH 1 "June 16, 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 +build-progress.sh \- show kde-build progress in your konsole/xterm title bar +.SH SYNOPSIS +.B build-progress.sh +.SH DESCRIPTION +\fBbuild-progress.sh\fP can be used to watch the progress of a large TDE +build in the title bar of your konsole or xterm. +.PP +The TDE build must be running elsewhere as a separate process, and it +must be done using +.BR kde-build (1). +.PP +When you run build-progress.sh, it will sit in a permanent loop while +kde-build runs. The title bar of the konsole/xterm in which you ran +build-progress.sh will be continually updated with the directory in +which the TDE build is currently working. +.PP +You must run build-progress.sh from the top-level directory of the TDE +build tree. This directory must contain a file named +\fIkde-buildrc\fP (which is also used by kde-build). This +\fIkde-buildrc\fP must contain valid settings for +\fITDELOGDIR\fP and \fITDESRCDIR\fP, or else build-progress.sh will +fail to work. +.PP +This utility is part of the TDE Software Development Kit. +.SH FILES +.TP +\fIkde-buildrc\fP +This file must be contained in the current directory, which must be the +root of the TDE build tree. See +.BR kde-build (1) +for further information. +.SH SEE ALSO +.BR kde-build (1). +.SH AUTHOR +build-progress.sh was written by Malte Starostik <malte@kde.org> and others. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/cheatmake.1 b/doc/man/scripts/cheatmake.1 new file mode 100644 index 00000000..098449a0 --- /dev/null +++ b/doc/man/scripts/cheatmake.1 @@ -0,0 +1,72 @@ +.\" 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 CHEATMAKE 1 "September 27, 2002" +.\" 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 +cheatmake \- fool make into not rebuilding certain files +.SH SYNOPSIS +.B cheatmake hidechange +.I file +.br +.B cheatmake show +.br +.B cheatmake why +.I file +.SH DESCRIPTION +\fBcheatmake\fP is used to save time when recompiling. It can fool \fBmake\fP +into skipping files that haven't changed in a meaningful way. This can be +used for instance when you change a comment in a file but none of the actual +code. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +The different modes of operation are as follows. +.TP +\fBhidechange\fP \fIfile\fP +Hides the fact that the given file has changed by moving its timestamp +back into the past. Use this option with care! +.TP +\fBshow\fP +Lists which files make currently needs to rebuild. +.TP +\fBwhy\fP \fIfile\fP +Explains why make must rebuild the given file. +.SH ENVIRONMENT VARIABLES +One of the following variables (but not both) should be set if the +source +directory is different from the build directory. +If the build directory is simply a subdirectory of the source directory, +the simpler variable OBJ_SUBDIR should be used. +.TP +OBJ_SUBDIR +Indicates that the build directory is in the given subdirectory of the +source directory. For instance, if the source directory is \fItdesdk\fP +and the build directory is \fItdesdk/obj-i386-linux\fP, then OBJ_SUBDIR +should be set to \fIobj-i386-linux\fP. +.TP +OBJ_REPLACEMENT +A \fBsed\fP expression that is used to transform the source directory +into the build directory. +For instance, if the source directory is \fI~/src/tdesdk\fP and the +build directory is \fI~/src/tdesdk-obj\fP, then OBJ_REPLACEMENT could +be set to \fIs#tdesdk#tdesdk-obj#\fP. +.SH SEE ALSO +.BR make (1). +.SH AUTHOR +cheatmake was written by David Faure <faure@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). diff --git a/doc/man/scripts/create_cvsignore.1 b/doc/man/scripts/create_cvsignore.1 new file mode 100644 index 00000000..ce63f6f5 --- /dev/null +++ b/doc/man/scripts/create_cvsignore.1 @@ -0,0 +1,42 @@ +.\" 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 CREATE_CVSIGNORE 1 "March 20, 2005" +.\" 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 +create_cvsignore \- creates preliminary .cvsignore in current directory +.SH SYNOPSIS +.B create_cvsignore +[ \fB\-r\fP ] +.SH DESCRIPTION +\fBcreate_cvsignore\fP is used to create a preliminary \fI.cvsignore\fP +file in the current directory. It does this by adding some standard +stuff according to what it finds in \fIMakefile.am\fP. +.PP +No lines will be removed from any existing \fI.cvsignore\fP. +If there is not already a \fI.cvsignore\fP, it will be added to the CVS +repository. +.PP +Note that you must have a \fIMakefile.am\fP in the current directory for +this tool to work. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.TP +\fB-r\fP +Recursively process this directory and all directories beneath it. +.SH AUTHOR +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/create_makefile.1 b/doc/man/scripts/create_makefile.1 new file mode 100644 index 00000000..e128f23e --- /dev/null +++ b/doc/man/scripts/create_makefile.1 @@ -0,0 +1,69 @@ +.\" 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 CREATE_MAKEFILE 1 "September 26, 2002" +.\" 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 +create_makefile \- creates Makefile.in and Makefile from a Makefile.am +.SH SYNOPSIS +.B create_makefile +.I relativepath/Makefile +.br +.B create_makefile +.I relativepath +.SH DESCRIPTION +\fBcreate_makefile\fP creates the \fIMakefile.in\fP and \fIMakefile\fP +in a subdirectory containing a \fIMakefile.am\fP. +This script saves time compared to re-running configure completely. +.PP +Note that you must supply the path to the desired \fIMakefile\fP, not the +existing \fIMakefile.am\fP (though the final \fI/Makefile\fP may be omitted). +.PP +This script may be run from the toplevel directory (the +one containing \fIconfigure\fP) or from one of its subdirectories. +Note that \fIrelativepath\fP must be a relative path, not an absolute path. +.PP +If the source directory is different from the build directory (see the +environment variables below), it will be assumed that the \fIMakefile.am\fP +and \fIMakefile.in\fP belong beneath the source directory and that the +\fIMakefile\fP belongs beneath the build directory. +.PP +This utility is part of the TDE Software Development Kit. +.SH ENVIRONMENT VARIABLES +One of the following variables (but not both) should be set if the +source +directory is different from the build directory. +If the build directory is simply a subdirectory of the source directory, +the simpler variable OBJ_SUBDIR should be used. +.TP +OBJ_SUBDIR +Indicates that the build directory is in the given subdirectory of the +source directory. For instance, if the source directory is \fItdesdk\fP +and the build directory is \fItdesdk/obj-i386-linux\fP, then OBJ_SUBDIR +should be set to \fIobj-i386-linux\fP. +.TP +OBJ_REPLACEMENT +A \fBsed\fP expression that is used to transform the source directory +into the build directory. +For instance, if the source directory is \fI~/src/tdesdk\fP and the +build directory is \fI~/src/tdesdk-obj\fP, then OBJ_REPLACEMENT could +be set to \fIs#tdesdk#tdesdk-obj#\fP. +.SH SEE ALSO +.BR create_makefiles (1). +.SH AUTHOR +create_makefile was written by David Faure <faure@kde.org> and others. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/create_makefiles.1 b/doc/man/scripts/create_makefiles.1 new file mode 100644 index 00000000..2efc0379 --- /dev/null +++ b/doc/man/scripts/create_makefiles.1 @@ -0,0 +1,63 @@ +.\" 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 CREATE_MAKEFILES 1 "September 27, 2002" +.\" 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 +create_makefiles \- recreates all Makefiles beneath a directory +.SH SYNOPSIS +.B create_makefiles +.I dir +.SH DESCRIPTION +\fBcreate_makefiles\fP recreates all \fIMakefile\fPs in +\fIdir\fP and its (recursed) subdirectories from the corresponding +\fIMakefile.am\fP templates. +.PP +This script must be run from the toplevel directory (the +one containing \fIconfigure\fP). +This script saves time compared to re-running configure completely. +.PP +If the source directory is different from the build directory (see the +environment variables below), it will be assumed that each \fIMakefile.am\fP +and \fIMakefile.in\fP belongs beneath the source directory and that each +\fIMakefile\fP belongs beneath the build directory. +.PP +This utility is part of the TDE Software Development Kit. +.SH ENVIRONMENT VARIABLES +One of the following variables (but not both) should be set if the +source +directory is different from the build directory. +If the build directory is simply a subdirectory of the source directory, +the simpler variable OBJ_SUBDIR should be used. +.TP +OBJ_SUBDIR +Indicates that the build directory is in the given subdirectory of the +source directory. For instance, if the source directory is \fItdesdk\fP +and the build directory is \fItdesdk/obj-i386-linux\fP, then OBJ_SUBDIR +should be set to \fIobj-i386-linux\fP. +.TP +OBJ_REPLACEMENT +A \fBsed\fP expression that is used to transform the source directory +into the build directory. +For instance, if the source directory is \fI~/src/tdesdk\fP and the +build directory is \fI~/src/tdesdk-obj\fP, then OBJ_REPLACEMENT could +be set to \fIs#tdesdk#tdesdk-obj#\fP. +.SH SEE ALSO +.BR create_makefile (1). +.SH AUTHOR +create_makefiles was written by David Faure <faure@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). diff --git a/doc/man/scripts/cvs-clean.1 b/doc/man/scripts/cvs-clean.1 new file mode 100644 index 00000000..0706e485 --- /dev/null +++ b/doc/man/scripts/cvs-clean.1 @@ -0,0 +1,50 @@ +.\" 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 CVS-CLEAN 1 "March 20, 2005" +.\" 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 +cvs\-clean \- delete all files and directories not registered with CVS +.SH SYNOPSIS +.B cvs\-clean +[ \fB-n, \-\-dry-run\fP ] +[ \fB-h, \-\-help\fP ] +.SH DESCRIPTION +\fBcvs\-clean\fP recursively deletes everything in or beneath the +current directory that is not known to CVS (i.e., that has not been +checked out of or checked into a CVS repository). +.PP +A list of all files and directories that are deleted will be written to +the console. +.PP +This script behaves similarly to the \fIcvs-clean\fP target from the +file \fIadmin/Makefile.common\fP found in most TDE application sources. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.TP +\fB-n, \-\-dry-run\fP +Print the intended actions to the console, but do not change anything on +the filesystem. +.TP +\fB-h, \-\-help\fP +Display usage information. +.SH SEE ALSO +.BR cvs (1). +.SH AUTHOR +This utility was written by Oswald Buddenhagen <ossi@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). diff --git a/doc/man/scripts/cvs2dist.1 b/doc/man/scripts/cvs2dist.1 new file mode 100644 index 00000000..f0bc71a3 --- /dev/null +++ b/doc/man/scripts/cvs2dist.1 @@ -0,0 +1,201 @@ +.\" 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 CVS2DIST 1 "March 19, 2005" +.\" 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 +cvs2dist \- convert subdirectories within TDE CVS into standalone +source packages +.SH SYNOPSIS +.B cvsdist +.I path-to-module +.I directory-in-module +[ \fB\-n, \-\-name\fP \fIname\fP ] +[ \fB\-v, \-\-version\fP \fIversion\fP ] +[ \fB\-\-admin-dir\fP \fIdir\fP ] +[ \fB\-\-cvs-root\fP \fIroot\fP ] +[ \fB\-B, \-\-branch\fP \fIbranch\fP ] +[ \fB\-\-no-i18n\fP ] +[ \fB\-\-no-i18n-lang\fP \fIlanguages\fP ] +[ \fB\-\-log=\fP\fIlogfile\fP | \fB\-l\fP ] +[ \fB\-m, \-\-make-unpackaged\fP ] +[ \fB\-g, \-\-no-gzip\fP ] +[ \fB\-b, \-\-no-bz2, \-\-no-bzip2\fP ] +[ \fB\-o, \-\-only-directory\fP ] +[ \fB\-r, \-\-required-header\fP \fIheader\fP ] +[ \fB\-e, \-\-required-header-error-message\fP \fImessage\fP ] +[ \fB\-d, \-\-remove-hidden\fP ] +[ \fB\-\-replace-files\fP \fIpairs\fP ] +[[--] \fIaddfile\fP ... ] +.PP +.B cvsdist +\fB\-h, \-\-help\fP +.SH DESCRIPTION +Each module in the TDE CVS tree contains a large number of applications +all bundled together. +\fBcvs2dist\fP is used to extract a single application or component from +one of these large CVS modules and bundle it into a standalone package. +The application or component will be bundled into a standard +distribution tarball (with a configure script and so on) that users can +download, build and install. +.PP +By default, cvs2dist automatically tries to check out all translations +of strings and documentation from the corresponding parts of the +\fItde-i18n\fP CVS module and include them in the final packages. +This can be suppressed or modified using the options \-\-no-i18n or +\-\-no-i18n-lang. +.PP +The initial argument \fIpath-to-module\fP should specify where the CVS +module has been checked out on your system, and the second argument +\fIdirectory-in-module\fP should specify which directory within this +module is to be packaged (all subdirectories beneath it will be included +and so on). See the EXAMPLE section below for details. +.PP +Both gzip and bzip2 compressed tarballs will be created by default and +will be called \fIname[-version].tar.gz\fP and \fIname[-version].tar.bz2\fP. +The \fIname\fP component will be the last directory component of +\fIdirectory-in-module\fP unless otherwise specified by \-\-name, and +the \fIversion\fP component will not be included unless it is specified by +\-\-version. +.PP +Additional files from outside the CVS tree can be included in the final +packages by passing them after all other options (these are the +\fIaddfile\fP arguments displayed above). These additional files will +be placed in the top level directory of the final packages. +The \-\- that precedes them is optional. +.PP +Many options are available for customising these procedures, as seen below. +Note that cvs2dist will remove any temporary files that it creates. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.TP +\fB\-n, \-\-name\fP \fIname\fP +The name of the package (to be used in the names of the final tarballs +and directories). Specifically, the compressed tarballs will be called +\fIname-version.tar.gz\fP and \fIname-version.tar.bz2\fP (see the +\-\-version option below for further information). +This package name defaults to the last directory component of +\fIdirectory-in-module\fP. +.TP +\fB\-v, \-\-version\fP \fIversion\fP +The version of the package (to be used in the names of the final +tarballs and directories). If this is not supplied, no version is used +at all (i.e., the compressed tarballs will just be called \fIname.tar.gz\fP +and \fIname.tar.bz2\fP). +.TP +\fB\-\-admin-dir\fP \fIdir\fP +The location of \fIadmin/\fP on the filesystem. Symbolic links may +be used. Defaults to \fIpath-to-module/admin\fP. +.TP +\fB\-\-cvs-root\fP \fIroot\fP +The value to use as CVSROOT when checking out translations from CVS. +Defaults to the CVSROOT environment variable. +If \-\-no-i18n is passed then this option has no effect. +.TP +\fB\-B, \-\-branch\fP \fIbranch\fP +Use the given CVS branch for checking out translations from CVS. +If \-\-no-i18n is passed then this option has no effect. +.TP +\fB\-\-no-i18n\fP +Do not check out any translations from CVS. +.TP +\fB\-\-no-i18n-lang\fP \fIlanguages\fP +Exclude the given language(s) when checking out translations from CVS. +The list of languages should be comma-separated, +such as \fI\-\-no-i18n-lang uk,de,en_GB\fP . +.TP +\fB\-\-log=\fP\fIlogfile\fP +Log all proceedings to the given logfile. Note that the = is essential, +and may not be omitted. +.TP +\fB\-l\fP +Log all proceedings to the default logfile in the current directory. +.TP +\fB\-m, \-\-make-unpackaged\fP +In addition to the compressed tarballs, an unpacked distribution will be +created in the current directory. +.TP +\fB\-g, \-\-no-gzip\fP +Do not create a gzip package (\fIname-version.tar.gz\fP). +.TP +\fB\-b, \-\-no-bz2, \-\-no-bzip2\fP +Do not create a bzip2 package (\fIname-version.tar.bz2\fP). +.TP +\fB\-o, \-\-only-directory\fP +Alias for \-mgb. No packages will be created, only an unpacked directory. +.TP +\fB\-r, \-\-required-header\fP \fIheader\fP +When the user runs configure, an error will be generated if +\fIheader\fP is not found on the user's system. +.TP +\fB\-e, \-\-required-header-error-message\fP \fImessage\fP +The error to display to a user when the header passed with +\-\-required-header is not found on the user's system. Defaults to a +sensible message. +.TP +\fB\-d, \-\-remove-hidden\fP +Remove hidden files and directories (e.g., dotfiles) from the packages. +.TP +\fB\-h, \-\-help\fP +Display instructions on how to use cvs2dist. +.TP +\fB\-\-replace-files\fP \fIpairs\fP +Move one or more files around in the final distribution packages. +The \fIpairs\fP argument should be a comma-separated list of +replacements to make. Each replacement specifies a single file to move, and +should be of the form \fIsource\fP@\fIdest\fP. +.br +For each replacement, the source file will be moved to the +destination file (in particular, the source file will be deleted). +All filenames are relative to the top-level directory +of the package. Spaces in filenames are not allowed. +.br +Please be careful when using this option! Try to avoid the use of .. +in the filenames, since it may cause unexpected problems. +.br +An example of this option might be +\fI\-\-replace-files take_this_file@move_it_here,configure.in.bot.dist@configure.in.bot\fP . +.SH EXAMPLE +The following example creates packages of the kolf picture plugin from +the CVS source tree currently checked out in \fI/sources\fP. +.PP +.RS +\fIexample$\fP cvs2dist /sources/tdegames kolf/objects/picture +\-n kolf-picture \-v 0.9 \-r "kolf/game.h" \-\-log ~/tmp/extra-file +.RE +.PP +The packages will be named \fIkolf-picture-0.9\fP and +the process will be logged. For configure to succeed when a user builds +these packages, the header \fIkolf/game.h\fP must be installed or an +error will occur. The additional file \fI~/tmp/extra-file\fP will be +included in the packages even though it is not part of the CVS source tree. +.SH FILES +.TP +\fI~/.cvs2distrc\fP +Any options found in this file will be +added to the beginning of the command-line arguments. +.SH SEE ALSO +.BR cvs (1). +.PP +For the latest updates to this script, see the cvs2dist website +\fIhttp://www.katzbrown.com/shiritsu/programming/cvs2dist/\fP. +.SH AUTHOR +cvs2dist was written by Jason Katz-Brown <jason@katzbrown.com>, +Sebastian Stein <seb.stein@hpfsc.de>, Dominique Devriese <devriese@kde.org> +and Michael Buesch <mbuesch@freenet.de>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/cvsbackport.1 b/doc/man/scripts/cvsbackport.1 new file mode 100644 index 00000000..7181ac67 --- /dev/null +++ b/doc/man/scripts/cvsbackport.1 @@ -0,0 +1,52 @@ +.\" 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 CVSBACKPORT 1 "March 20, 2005" +.\" 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 +cvsbackport \- backport the last change in HEAD to a branch +.SH SYNOPSIS +.B cvsbackport +\fIfile\fP ... +.SH DESCRIPTION +For each file given on the command line, +\fBcvsbackport\fP will attempt to determine the last change made to +the file in HEAD and then backport that change to a CVS branch (the +branch name is hard-coded; see below). +.PP +The changes to be backported will be displayed on screen, and you will +have the chance to confirm or abort before any commits are made. +.PP +The files must be checked out from HEAD when you run this utility. +.PP +This utility is part of the TDE Software Development Kit. +.SH WARNINGS +The branch tag is hard-coded into the script (currently it is set to +KDE_3_4_BRANCH). +.PP +If you abort (i.e., you do not make the suggested commits), your files +will be checked out from the branch (and not from HEAD as they were +before). +.SH SEE ALSO +.BR cvsblame (1), +.BR cvsforwardport (1), +.BR cvslastchange (1), +.BR cvslastlog (1), +.BR cvsrevertlast (1). +.SH AUTHOR +This utility was written by Dirk Mueller and David Faure. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/cvscheck.1 b/doc/man/scripts/cvscheck.1 new file mode 100644 index 00000000..3d79c255 --- /dev/null +++ b/doc/man/scripts/cvscheck.1 @@ -0,0 +1,107 @@ +.\" 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 CVSCHECK 1 "March 26, 2005" +.\" 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 +cvscheck \- offline status report for files in a checked-out CVS module +.SH SYNOPSIS +.B cvscheck +[ \fB\-u, \-\-unknown\fP ] +[ \fB\-m, \-\-modified\fP ] +[ \fB\-\-missing\fP ] +[ \fB\-t, \-\-tagged\fP ] +[ \fB\-a, \-\-added\fP ] +[ \fB\-r, \-\-removed\fP ] +[ \fB\-c, \-\-conflicts\fP ] +[ \fB\-l, \-\-local\fP ] +[ \fIdir\fP ... ] +.SH DESCRIPTION +\fBcvscheck\fP prints information about the status of your local CVS +checkout without communicating with the server. This means it is +extremely fast and does not require a network connection. +.PP +The given directories and all of their subdirectories will be processed +recursively (though see the \-\-local option below). +If no directory is given, the current directory and its +recursed subdirectories will be used. +.PP +Each file with an interesting status will be printed with a status +character in front of its name. The status characters are as follows. +.TP +? \fIfoobar.c\fP +The file is not known to CVS. Maybe you should add it? +.TP +M \fIfoobar.c\fP +The file is for sure locally modified. +.TP +m \fIfoobar.c\fP +The file \fImight\fP have local changes. You should diff with the +server to make sure. +.TP +C \fIfoobar.c\fP +The file has a CVS conflict and therefore cannot be committed. +.TP +U \fIfoobar.c\fP +The file is in CVS but is somehow missing in your local checkout. +.TP +T \fIfoobar.c\fP +The file has an unusual sticky CVS tag. +.TP +A \fIfoobar.c\fP +You have "cvs add"ed this file but you have not yet committed. +.TP +R \fIfoobar.c\fP +You have "cvs remove"d this file but you have not yet committed. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +By default cvscheck will display the status for all files in and +beneath the requested directories. The following options however can be +used to display only files with a particular status and/or in a +particular directory. +.TP +\fB\-u, \-\-unknown\fP +Show only unknown (?) files. +.TP +\fB\-m, \-\-modified\fP +Show only modified (m/M) files. +.TP +\fB\-\-missing\fP +Show only missing (U) files. +.TP +\fB\-t, \-\-tagged\fP +Show only tagged (T) files. +.TP +\fB\-a, \-\-added\fP +Show only added (A) files. +.TP +\fB\-r, \-\-removed\fP +Show only removed (R) files. +.TP +\fB\-c, \-\-conflicts\fP +Show only conflict (C) files. +.TP +\fB\-l, \-\-local\fP +Do not recurse. That is, process the given directory but none of its +subdirectories. +.SH SEE ALSO +.BR cvs (1). +.SH AUTHOR +cvscheck was written by Dirk Mueller <mueller@kde.org> and +Sirtaj Singh Kang <taj@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). diff --git a/doc/man/scripts/cvsforwardport.1 b/doc/man/scripts/cvsforwardport.1 new file mode 100644 index 00000000..0ca6d29f --- /dev/null +++ b/doc/man/scripts/cvsforwardport.1 @@ -0,0 +1,52 @@ +.\" 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 CVSFORWARDPORT 1 "March 20, 2005" +.\" 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 +cvsforwardport \- forwardport the last change in a branch to HEAD +.SH SYNOPSIS +.B cvsforwardport +\fIfile\fP ... +.SH DESCRIPTION +For each file given on the command line, +\fBcvsforwardport\fP will attempt to determine the last change made to +the file in the primary CVS branch and then forwardport that change to HEAD. +The branch name is hard-coded; see below. +.PP +The changes to be forwardported will be displayed on screen, and you will +have the chance to confirm or abort before any commits are made. +.PP +The files must be checked out from the branch when you run this utility. +.PP +This utility is part of the TDE Software Development Kit. +.SH WARNINGS +The branch tag is hard-coded into the script (currently it is set to +KDE_3_4_BRANCH). +.PP +If you abort (i.e., you do not make the suggested commits), your files +will be checked out from HEAD (and not from the branch as they were +before). +.SH SEE ALSO +.BR cvsbackport (1), +.BR cvsblame (1), +.BR cvslastchange (1), +.BR cvslastlog (1), +.BR cvsrevertlast (1). +.SH AUTHOR +This utility was written by Dirk Mueller and David Faure. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/cvslastchange.1 b/doc/man/scripts/cvslastchange.1 new file mode 100644 index 00000000..b651e441 --- /dev/null +++ b/doc/man/scripts/cvslastchange.1 @@ -0,0 +1,59 @@ +.\" 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 CVSLASTCHANGE 1 "March 20, 2005" +.\" 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 +cvslastchange \- display the last committed changes for a file +.SH SYNOPSIS +.B cvslastchange +\fIfile\fP [ \fIrevision\fP ] +.br +.B cvslastchange +\fBM\fP +\fIdigits\fP -\fIdigits\fP +.I file revision +.SH DESCRIPTION +\fBcvslastchange\fP displays the last changes committed to the CVS +for the given file. +It does this by launching '\fIcvs log\fP' and '\fIcvs diff\fP'. +.PP +If a revision is passed, the changes committed for that particular revision +will be displayed. Otherwise the currently checked out revision will be used. +.PP +This tool works with other branches as well as with HEAD. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.TP +\fBM\fP +\fIdigits\fP -\fIdigits\fP +These options are currently ignored. +.SH ENVIRONMENT VARIABLES +.TP +CVSLASTCHANGE_KEEP_WHITESPACE +Define this variable if you do not want the whitespace to be modified +in any way when displaying changes. Usually the whitespace is tidied +up a little before the changes are displayed on screen. +.br +This variable is useful if you are using cvslastchange to extract a +patch that can be applied elsewhere. +.SH SEE ALSO +.BR cvsbackport (1), +.BR cvsblame (1), +.BR cvsforwardport (1), +.BR cvslastlog (1), +.BR cvsrevertlast (1). +.SH AUTHOR +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/cvslastlog.1 b/doc/man/scripts/cvslastlog.1 new file mode 100644 index 00000000..445a1a74 --- /dev/null +++ b/doc/man/scripts/cvslastlog.1 @@ -0,0 +1,39 @@ +.\" 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 CVSLASTLOG 1 "March 20, 2005" +.\" 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 +cvslastlog \- prints the log of the last commit for a file +.SH SYNOPSIS +.B cvslastlog +.I file +.SH DESCRIPTION +\fBcvslastlog\fP shows the log associated with the last CVS commit for the +given file. +It depends on the version of the local file, not the one on the server. +.PP +This utility is part of the TDE Software Development Kit. +.SH SEE ALSO +.BR cvsbackport (1), +.BR cvsblame (1), +.BR cvsforwardport (1), +.BR cvslastchange (1), +.BR cvsrevertlast (1). +.SH AUTHOR +cvslastlog was written by David Faure <faure@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). diff --git a/doc/man/scripts/cvsrevertlast.1 b/doc/man/scripts/cvsrevertlast.1 new file mode 100644 index 00000000..aedf45aa --- /dev/null +++ b/doc/man/scripts/cvsrevertlast.1 @@ -0,0 +1,38 @@ +.\" 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 CVSREVERTLAST 1 "March 20, 2005" +.\" 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 +cvsrevertlast \- revert files in CVS by one version +.SH SYNOPSIS +.B cvsrevertlast +\fIfile\fP ... +.SH DESCRIPTION +\fBcvsrevertlast\fP is used to revert all the files on the command line +by one version in CVS. The files will not be committed. +.PP +This utility is part of the TDE Software Development Kit. +.SH SEE ALSO +.BR cvsbackport (1), +.BR cvsblame (1), +.BR cvsforwardport (1), +.BR cvslastchange (1), +.BR cvslastlog (1). +.SH AUTHOR +This utility was written by Charles Samuels <charles@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). diff --git a/doc/man/scripts/cxxmetric.1 b/doc/man/scripts/cxxmetric.1 new file mode 100644 index 00000000..a8a855cd --- /dev/null +++ b/doc/man/scripts/cxxmetric.1 @@ -0,0 +1,34 @@ +.\" 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 CXXMETRIC 1 "January 31, 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 +cxxmetric \- simple source metrics for C and C++ +.SH SYNOPSIS +.B cxxmetric +.RI "[ " file " ... ]" +.SH DESCRIPTION +\fBcxxmetric\fP counts lines of code, comment and blank space and +calculates various other statistics for each given source file. +Source files must be in C or C++. +.PP +If no source files are specified then all C/C++ files in or beneath the +current directory will be used. +.PP +This utility is part of the TDE Software Development Kit. +.SH AUTHOR +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/extend_dmalloc.1 b/doc/man/scripts/extend_dmalloc.1 new file mode 100644 index 00000000..0078442e --- /dev/null +++ b/doc/man/scripts/extend_dmalloc.1 @@ -0,0 +1,43 @@ +.\" 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 EXTEND_DMALLOC 1 "April 29, 2001" +.\" 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 +extend_dmalloc \- analyse return-addresses from dmalloc logfiles +.SH SYNOPSIS +.B extend_dmalloc +.I dmalloc-log binary +.SH DESCRIPTION +\fBextend_dmalloc\fP will run +.BR gdb (1) +to get information on the return-addresses from a +.BR dmalloc (1) +logfile. Specifically it will examine any \fIra=\fP lines and try to +get the corresponding line numbers. +.PP +The argument \fIbinary\fP must be the binary that generated the log +\fIdmalloc-log\fP. +.PP +This utility is part of the TDE Software Development Kit. +.SH NOTES +You may wish to direct the output from extend_dmalloc to a file, since +otherwise gdb seems to prompt for a return as if you are at the end of a +page. +.SH AUTHOR +extend_dmalloc was written by Gray Watson <gray.watson@letters.com>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/extractattr.1 b/doc/man/scripts/extractattr.1 new file mode 100644 index 00000000..7e506e44 --- /dev/null +++ b/doc/man/scripts/extractattr.1 @@ -0,0 +1,61 @@ +.\" 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 EXTRACTATTR 1 "March 20, 2005" +.\" 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 +extractattr \- extract element attributes from UI and XML GUI files +.SH SYNOPSIS +.B extractattr +\fB\-\-attr=\fP\fIname\fP +[ \fB\-\-attr=\fP\fIname\fP ... ] +[ \fB\-\-context=\fP\fIname\fP ] +\fIfile\fP ... +.PP +.B extractattr \-\-help +.SH DESCRIPTION +\fBextractattr\fP finds all of the given element attributes within the +given files. It then writes the corresponding \fIi18n()\fP calls to +standard output (usually redirected to rc.cpp) so that xgettext can parse +them. Only the attributes specified by \fB\-\-attr\fP will be extracted. +.PP +Both Qt designer (.ui) files and XML GUI (.rc) files are understood. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.TP +\fB\-\-attr=\fP\fIname\fP +Specifies an attribute to be extracted. This option may be used +multiple times. +.br +The \fIname\fP argument must be of the form +\fIElement\fP,\fIattribute\fP or +\fIElement\fP,\fIattribute\fP,\fIcontext\fP. +.br +The context is optional, and is used in constructing the i18n() calls. +If specified it will override the default context set by \fB\-\-context\fP. +.TP +\fB\-\-context=\fP\fIname\fP +Give all i18n() calls the given context: i18n("\fIname\fP", ...). +.TP +\fB\-\-help\fP +Display a summary of options. +.SH EXAMPLE +extractattr \-\-attr=Title,data \-\-attr=Description,data,Stencils file.ui +.SH AUTHOR +This utility was written by Richard Evans <rich@ridas.com> and others. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/extractrc.1 b/doc/man/scripts/extractrc.1 new file mode 100644 index 00000000..130fdb08 --- /dev/null +++ b/doc/man/scripts/extractrc.1 @@ -0,0 +1,60 @@ +.\" 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 EXTRACTRC 1 "March 20, 2005" +.\" 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 +extractrc \- extract message strings from UI and XML GUI files +.SH SYNOPSIS +.B extractrc +[ \fB\-\-tag\-group=\fP\fIgroup\fP ] +[ \fB\-\-tag=\fP\fIname\fP ... ] +[ \fB\-\-context=\fP\fIname\fP ] +\fIfile\fP ... +.PP +.B extractrc \-\-help +.SH DESCRIPTION +\fBextractrc\fP finds all text tags and other message strings within the +given files. It then writes the corresponding \fIi18n()\fP calls to +standard output (usually redirected to rc.cpp) so that xgettext can parse +them. +.PP +It understands both Qt designer (.ui) files and XML GUI (.rc) files. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +Note that the old \fB\-\-lines\fP option is deprecated; source line +numbers are now always included in comments. +.TP +\fB\-\-tag\-group=\fP\fIgroup\fP +Use a predefined group of tags that we are interested in. +Valid groups are default, koffice and none. +The default group will be used if this option is omitted. +.TP +\fB\-\-tag=\fP\fIname\fP +Extract also the contents of the tag \fIname\fP. +This option may be used multiple times +(e.g., \-\-tag=tag_one \-\-tag=tag_two). +.TP +\fB\-\-context=\fP\fIname\fP +Give all i18n() calls the given context: i18n("\fIname\fP", ...). +.TP +\fB\-\-help\fP +Display a summary of options. +.SH AUTHOR +This utility was written by Richard Evans <rich@ridas.com> and others. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/findmissingcrystal.1 b/doc/man/scripts/findmissingcrystal.1 new file mode 100644 index 00000000..32b23294 --- /dev/null +++ b/doc/man/scripts/findmissingcrystal.1 @@ -0,0 +1,42 @@ +.\" 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 FINDMISSINGCRYSTAL 1 "February 6, 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 +findmissingcrystal \- determine which TDE Crystal icons are the same as +the TDE Classic hicolor icons +.SH SYNOPSIS +.B findmissingcrystal +.I module +.SH DESCRIPTION +\fBfindmissingcrystal\fP is a small utility that runs through the icons +in the given TDE module and determines which Crystal icons from that +module are identical to the old TDE Classic hicolor icons. +.PP +This script \fBmust\fP be run from the top-level directory of a TDE source +tree (i.e., the directory containing \fItdelibs\fP, \fItdebase\fP, etc.). +It is assumed that \fImodule\fP is a top-level module in the source tree, +and it is also assumed that the source tree contains the \fItdeartwork\fP +module (which contains the old hicolor icons). +.PP +For each Crystal icon in the given module, a message will be output +describing whether the icon is new (no matching hicolor icon was found), +different from the hicolor icon or the same as the hicolor icon. +.PP +This utility is part of the TDE Software Development Kit. +.SH AUTHOR +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/fixkdeincludes.1 b/doc/man/scripts/fixkdeincludes.1 new file mode 100644 index 00000000..6c5bea18 --- /dev/null +++ b/doc/man/scripts/fixkdeincludes.1 @@ -0,0 +1,73 @@ +.\" 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 FIXTDEINCLUDES 1 "January 31, 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 +fixkdeincludes \- reduce the number of #includes in TDE source files +.SH SYNOPSIS +.B fixkdeincludes +[ \fB\-v, \-\-verbose\fP ] +[ \fB\-e, \-\-experimental\fP ] +[ \fB\-m, \-\-modify\fP ] +[ \fIfile\fP ... ] +.br +.B fixkdeincludes \-\-help +.SH DESCRIPTION +\fBfixkdeincludes\fP tries to reduce the number of #includes in C++ source +files. Much of its processing is specific to TDE sources and so it +might not work so well with sources for non-TDE applications. +.PP +The following problems are identified by fixkdeincludes: +.PP +.RS +Including headers that are no longer supported but which exist for +compatibility with older Qt/KDE versions; +.PP +Including the same file multiple times; +.PP +Using #include <...> instead of #include "...". +.RE +.PP +There is also an experimental mode which tries removing each #include +one at a time (with a few exceptions) to see whether the source still +compiles. Note that this experimental mode will modify the original sources. +.PP +By default the sources will not be modified; the identified problems +will simply be written to standard output. +.PP +The list of C++ sources to examine should be given on the command-line. +If no files are given, all C++ sources in or beneath the current +directory will be examined (with the exception of directories whose +\fIMakefile.am\fP contains \-UTQT_NO_COMPAT or \-UTDE_NO_COMPAT). +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.TP +\fB\-v, \-\-verbose\fP +Verbose mode. Additional debugging information is written to standard output. +.TP +\fB\-e, \-\-experimental\fP +Experimental mode, as described above in detail. Note that this option +implies \fB\-\-modify\fP. +.TP +\fB\-m, \-\-modify\fP +As well as writing messages to standard output, actually modify the +original sources to fix any problems that were found. +.SH AUTHOR +fixkdeincludes was written by Dirk Mueller <mueller@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). diff --git a/doc/man/scripts/fixuifiles.1 b/doc/man/scripts/fixuifiles.1 new file mode 100644 index 00000000..17ce46a6 --- /dev/null +++ b/doc/man/scripts/fixuifiles.1 @@ -0,0 +1,63 @@ +.\" 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 FIXUIFILES 1 "March 20, 2005" +.\" 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 +fixuifiles \- remove undesirable features from TQt/TDE .ui files +.SH SYNOPSIS +.B fixuifiles +[ \fB\-v, \-\-verbose\fP ] +[ \fB\-\-omitqtcheck\fP ] +[ \fIfile\fP ... ] +.br +.B fixuifiles \-\-help +.SH DESCRIPTION +\fBfixuifiles\fP processes one or more TQt/TDE user interface definition +files (.ui files) and tries to remove some of the insanities found +therein. If no filenames are given, fixuifiles will process all .ui +files in or beneath the current directory. +.PP +The following problems are fixed: +.PP +.RS +Too high minimum Qt version; +.PP +Hardcoded untranslatable Alt+Letter accels (auto-added by Qt Designer); +.PP +Captions that are equal to class names (auto-added by Qt Designer). +.RE +.PP +The threshold Qt version can be set +using either a \fI.qt_minversion\fP file (containing simply the Qt version +number) or a \fIconfigure.in.in\fP file (containing an appropriate +MIN_CONFIG macro). These files may be in the directory containing the .ui +file or any parent directory. If no threshold Qt version is found, +a sensible default will be used. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.TP +\fB\-v, \-\-verbose\fP +Verbose mode. Additional debugging information is written to standard output. +.TP +\fB\-\-omitqtcheck\fP +Do not check the minimum Qt version. +.SH AUTHOR +fixuifiles was written by David Faure <faure@kde.org> and +Dirk Mueller <mueller@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). diff --git a/doc/man/scripts/kdedoc.1 b/doc/man/scripts/kdedoc.1 new file mode 100644 index 00000000..1911442c --- /dev/null +++ b/doc/man/scripts/kdedoc.1 @@ -0,0 +1,42 @@ +.\" 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 TDEDOC 1 "January 31, 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 +kdedoc \- view documentation for a TDE class +.SH SYNOPSIS +.B kdedoc +.I classname +.SH DESCRIPTION +\fBkdedoc\fP opens the documentation for the TDE class \fIclassname\fP +in kfm/konqueror. Note that the class name is case sensitive. It is +assumed that you have the tdelibs documentation installed. +.PP +This utility is part of the TDE Software Development Kit. +.SH EXAMPLES +To bring up help on the class TDEAboutDialog: +.PP +.RS +kdedoc TDEAboutDialog +.RE +.SH DEBIAN USERS +The tdelibs documentation is in the Debian package \fItdelibs4-doc\fP, +which will need to be installed. +.SH SEE ALSO +.BR qtdoc (1). +.SH AUTHOR +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/kdelnk2desktop.py.1 b/doc/man/scripts/kdelnk2desktop.py.1 new file mode 100644 index 00000000..41cce73a --- /dev/null +++ b/doc/man/scripts/kdelnk2desktop.py.1 @@ -0,0 +1,39 @@ +.\" 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 KDELNK2DESKTOP.PY 1 "November 14, 2002" +.\" 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 +kdelnk2desktop.py \- converts .kdelnk to .desktop +.SH SYNOPSIS +.B kdelnk2desktop.py +.RI "[ " kdelnk-file " ] ..." +.SH DESCRIPTION +\fBkdelnk2desktop.py\fP is used to convert +a \fI.kdelnk\fP file (used by KDE 1) into a \fI.desktop\fP +file (used by KDE 2 and later). +.PP +File \fIkdelnk-file\fP must have a name ending in \fI.kdelnk\fP. +After kdelnk2desktop.py is run, this will be replaced by a new file +ending in \fI.desktop\fP. The original \fIkdelnk-file\fP will be +removed. +.PP +This utility is part of the TDE Software Development Kit. +.SH WARNING +If \fIkdelnk-file\fP does not end in \fI.kdelnk\fP, +the results of this script are unpredictable. +.SH AUTHOR +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/kdemangen.pl.1 b/doc/man/scripts/kdemangen.pl.1 new file mode 100644 index 00000000..8acd79df --- /dev/null +++ b/doc/man/scripts/kdemangen.pl.1 @@ -0,0 +1,51 @@ +.\" 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). diff --git a/doc/man/scripts/licensecheck.1 b/doc/man/scripts/licensecheck.1 new file mode 100644 index 00000000..48728f2c --- /dev/null +++ b/doc/man/scripts/licensecheck.1 @@ -0,0 +1,37 @@ +.\" 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 LICENSECHECK 1 "January 31, 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 +licensecheck \- simple license checker for source files +.SH SYNOPSIS +.B licensecheck +.RB "[ " \-v " ]" +\fIfile\fP ... +.SH DESCRIPTION +\fBlicensecheck\fP examines the comments at the beginning of each given +source file and tries to determine which license the file is placed +under. It does this by searching for blocks of text that it recognises +as belonging to various licenses. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.TP +.B \-v +Verbose mode. +.SH AUTHOR +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/makeobj.1 b/doc/man/scripts/makeobj.1 new file mode 100644 index 00000000..50a9f864 --- /dev/null +++ b/doc/man/scripts/makeobj.1 @@ -0,0 +1,66 @@ +.\" 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 MAKEOBJ 1 "March 20, 2005" +.\" 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 +makeobj \- run make from the correct directory +.SH SYNOPSIS +.B makeobj +[ \fImake-argument\fP ... ] +.SH DESCRIPTION +\fBmakeobj\fP is a wrapper around \fBmake\fP which basically checks +whether it's in the source directory or the build directory and changes +to the correct directory before calling make. +.PP +The command-line arguments will (generally) be passed directly to make. +.PP +This script is useful if the source directory is different from the +build directory and the Makefiles are kept in the build directory, as is +common for instance when building the TDE sources. This script can however +be used in more standard scenarios (such as non-TDE projects for which the +source and build directories are the same), where it will behave just like +make. +.PP +One of the environment variables OBJ_SUBDIR or OBJ_REPLACEMENT +should be set to indicate where the build directory is in relation to +the source directory. +.PP +This utility is part of the TDE Software Development Kit. +.SH ENVIRONMENT VARIABLES +Note that only one of OBJ_SUBDIR and OBJ_REPLACEMENT should be used. +If the build directory is simply a subdirectory of the source directory, +the simpler variable OBJ_SUBDIR should be used. +.TP +OBJ_SUBDIR +Indicates that the build directory is in the given subdirectory of the +source directory. For instance, if the source directory is \fItdesdk\fP +and the build directory is \fItdesdk/obj-i386-linux\fP, then OBJ_SUBDIR +should be set to \fIobj-i386-linux\fP. +.TP +OBJ_REPLACEMENT +A \fBsed\fP expression that is used to transform the source directory +into the build directory. +For instance, if the source directory is \fI~/src/tdesdk\fP and the +build directory is \fI~/src/tdesdk-obj\fP, then OBJ_REPLACEMENT could +be set to \fIs#src/tdesdk#src/tdesdk-obj#\fP. +.SH SEE ALSO +.BR make (1), +.BR sed (1). +.SH AUTHOR +makeobj was written by Stephan Kulow <coolo@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). diff --git a/doc/man/scripts/package_crystalsvg.1 b/doc/man/scripts/package_crystalsvg.1 new file mode 100644 index 00000000..32d8644e --- /dev/null +++ b/doc/man/scripts/package_crystalsvg.1 @@ -0,0 +1,41 @@ +.\" 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 PACKAGE_CRYSTALSVG 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 +package_crystalsvg \- bundle up Crystal SVG sources from a TDE checkout +.SH SYNOPSIS +.B package_crystalsvg +.SH DESCRIPTION +\fBpackage_crystalsvg\fP assumes that the current directory contains one +or more checked-out TDE modules. It searches these modules for Crystal +SVG vector sources (.svgz or .svg.gz files) +and packages them up into a tarball. The tarball will also +contain \fIFILES\fP (describing the contents of the tarball and which +TDE modules/paths they were copied from) as well as some other bits and +pieces. +.PP +Note that you must at least have tdelibs checked out for this utility to +run. +.PP +The final tarball will be created in the current working directory. +.PP +This utility is part of the TDE Software Development Kit. +.SH AUTHOR +package_crystalsvg was written by Frans Englich <frans.englich@telia.com>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/png2mng.pl.1 b/doc/man/scripts/png2mng.pl.1 new file mode 100644 index 00000000..c86c1727 --- /dev/null +++ b/doc/man/scripts/png2mng.pl.1 @@ -0,0 +1,49 @@ +.\" 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 PNG2MNG.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 +png2mng.pl \- combine a set of PNG images into an animated MNG image +.SH SYNOPSIS +.B png2mng.pl +.I basename width height +.SH DESCRIPTION +\fBpng2mng.pl\fP reads a sequence of PNG images and combines them into +a single animated MNG image. +.PP +The individual PNG images should be numbered consecutively from zero up, +and should have names of the form +.I basenameXXXX +where +.I XXXX +is the four-digit sequence number (0000, 0001, 0002, etc). +The width and height of the PNG images should +also be included on the command line. +.PP +The final animated MNG image will be written to standard output. +.PP +This utility is part of the TDE Software Development Kit. +.SH EXAMPLE +The following example will combine the files hi32-action-kde-0000.png, +hi32-action-kde-0001.png, hi32-action-kde-0002.png, etc., and write +the resulting animated image to hi32-action-kde.mng: +.PP +.RS +png2mng.pl hi32-action-kde- 32 32 > hi32-action-kde.mng +.RE +.SH AUTHOR +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/pruneemptydirs.1 b/doc/man/scripts/pruneemptydirs.1 new file mode 100644 index 00000000..108c7e4d --- /dev/null +++ b/doc/man/scripts/pruneemptydirs.1 @@ -0,0 +1,65 @@ +.\" 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 PRUNEEMPTYDIRS 1 "September 27, 2002" +.\" 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 +pruneemptydirs \- detects stale source dirs in a CVS tree +.SH SYNOPSIS +.B pruneemptydirs +[ \fB\-f\fP ] +.SH DESCRIPTION +\fBpruneemptydirs\fP is used to clean up a local CVS tree. +It detects directories containing remnants of old stuff which has been +removed from the CVS. Such stale directories often break compilation. +The current directory and all directories beneath it will be examined. +.PP +Note that this tool does not remove anything; it simply prints what to +do as a series of remove commands. You can copy and paste these commands, +or use them with eval in a script. +.PP +This tool works better if the source directory is not the same as the +build directory, since it will not print directories containing old +executables. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.TP +\fB\-f\fP +Actually perform the deletions instead of just printing them out. +Use this option with care (no warranties, etc.)! +.SH ENVIRONMENT VARIABLES +One of the following variables (but not both) should be set if the source +directory is different from the build directory. +If the build directory is simply a subdirectory of the source directory, +the simpler variable OBJ_SUBDIR should be used. +.TP +OBJ_SUBDIR +Indicates that the build directory is in the given subdirectory of the +source directory. For instance, if the source directory is \fItdesdk\fP +and the build directory is \fItdesdk/obj-i386-linux\fP, then OBJ_SUBDIR +should be set to \fIobj-i386-linux\fP. +.TP +OBJ_REPLACEMENT +A \fBsed\fP expression that is used to transform the source directory +into the build directory. +For instance, if the source directory is \fI~/src/tdesdk\fP and the +build directory is \fI~/src/tdesdk-obj\fP, then OBJ_REPLACEMENT could +be set to \fIs#tdesdk#tdesdk-obj#\fP. +.SH AUTHOR +pruneemptydirs was written by David Faure <faure@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). diff --git a/doc/man/scripts/qtdoc.1 b/doc/man/scripts/qtdoc.1 new file mode 100644 index 00000000..3b7c09f6 --- /dev/null +++ b/doc/man/scripts/qtdoc.1 @@ -0,0 +1,50 @@ +.\" 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 QTDOC 1 "January 31, 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 +qtdoc \- view documentation for a Qt class +.SH SYNOPSIS +.B qtdoc +.RI "[ " classname " ]" +.SH DESCRIPTION +\fBqtdoc\fP opens a Qt help page in kfm/konqueror. +If \fIclassname\fP is given, it opens the help page for that class (note +that the class name is case insensitive). Otherwise the main Qt help +page is opened. It is assumed that you have the Qt documentation +installed. +.PP +This utility is part of the TDE Software Development Kit. +.SH ENVIRONMENT VARIABLES +.TP +QTDIR +The directory beneath which the Qt documentation is installed. +Thus the main Qt help page should be in \fI$QTDIR/doc/html/\fP. +If $QTDIR is not set, \fI/usr/share/qt3\fP will be assumed. +.SH EXAMPLES +To bring up help on class QString: +.PP +.RS +qtdoc QString +.RE +.SH DEBIAN USERS +The Qt documentation is in the Debian package \fIqt3-doc\fP, which will +need to be installed. +.SH SEE ALSO +.BR kdedoc (1). +.SH AUTHOR +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/tdekillall.1 b/doc/man/scripts/tdekillall.1 new file mode 100644 index 00000000..92bf4380 --- /dev/null +++ b/doc/man/scripts/tdekillall.1 @@ -0,0 +1,36 @@ +.\" 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 TDEKILLALL 1 "April 29, 2001" +.\" 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 +tdekillall \- kills processes started with tdeinit +.SH SYNOPSIS +.B tdekillall +[ \fB\-\fP\fIsignal\fP ] \fIprocess-name\fP +.SH DESCRIPTION +\fBtdekillall\fP kills all processes with a particular name +that were started through tdeinit. Specifically, it kills all processes +\fBtdeinit:\fP \fIprocess-name\fP. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.TP +\fB\-\fP\fIsignal\fP +Kill the processes with signal \fIsignal\fP. This option defaults to +SIGTERM. Run \fIkill \-l\fP for a list of possible signals. +.SH AUTHOR +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/scripts/zonetab2pot.py.1 b/doc/man/scripts/zonetab2pot.py.1 new file mode 100644 index 00000000..d6a4330a --- /dev/null +++ b/doc/man/scripts/zonetab2pot.py.1 @@ -0,0 +1,39 @@ +.\" 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 ZONETAB2POT.PY 1 "November 14, 2002" +.\" 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 +zonetab2pot.py \- converts a timezone list to a PO-file template +.SH SYNOPSIS +.B zonetab2pot.py +[ \fItimezone-list\fP ] +.SH DESCRIPTION +\fBzonetab2pot.py\fP reads the timezone list given on the command-line +and converts it to a gettext message file (PO-file) template containing +the names of the individual timezones. +.PP +The given timezone list should be in the same format as the system +\fIzone.tab\fP. If no timezone list is specified on the command-line, +\fI/usr/share/zoneinfo/zone.tab\fP will be used. +.PP +The new PO-file template will be written to standard output. +.PP +This utility is part of the TDE Software Development Kit. +.SH AUTHOR +zonetab2pot.py was written by Lukas Tinkl <lukas@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). diff --git a/doc/man/tdecachegrind/CMakeLists.txt b/doc/man/tdecachegrind/CMakeLists.txt new file mode 100644 index 00000000..24ccd704 --- /dev/null +++ b/doc/man/tdecachegrind/CMakeLists.txt @@ -0,0 +1,7 @@ +file( GLOB _man_files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.1 ) + +INSTALL( + FILES ${_man_files} + DESTINATION ${MAN_INSTALL_DIR}/man1 + COMPONENT doc +) diff --git a/doc/man/tdecachegrind/dprof2calltree.1 b/doc/man/tdecachegrind/dprof2calltree.1 new file mode 100644 index 00000000..88bcd0b0 --- /dev/null +++ b/doc/man/tdecachegrind/dprof2calltree.1 @@ -0,0 +1,60 @@ +.\" 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 DPROF2CALLTREE 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 +dprof2calltree \- convert perl's DProf profiling data to KCachegrind calltree format +.SH SYNOPSIS +.B dprof2calltree +\fB\-f\fP \fIinput\fP +[ \fB\-o\fP \fIoutput\fP ] +.SH DESCRIPTION +\fBdprof2calltree\fP reads the \fItmon.out\fP profiling data output by +Perl's Devel::DProf profiling package, and converts it into calltree format +for use by KCachegrind. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.TP +\fB\-f\fP \fIinput\fP +Specifies the DProf \fItmon.out\fP file to convert. +.TP +\fB\-o\fP \fIoutput\fP +Write the calltree output to the given file for use by KCachegrind. +If omitted, the output will be written to file of the form +\fIcachgrind.out.<input>\fP. +.SH EXAMPLE +If you run a perl script as: +.PP +.RS +perl -d:DProf yourscript.pl +.RE +.PP +then this will write profiling data to \fItmon.out\fP. You can then +work with this data in KCachegrind as follows: +.PP +.RS +dprof2calltree -f tmin.out -o cachegrind.out.foo +.br +tdecachegrind cachegrind.out.foo +.RE +.SH SEE ALSO +.BR tdecachegrind (1). +.SH AUTHOR +This converter was written by George Schlossnagle <george@omniti.com>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/tdecachegrind/hotshot2calltree.1 b/doc/man/tdecachegrind/hotshot2calltree.1 new file mode 100644 index 00000000..8c4d4441 --- /dev/null +++ b/doc/man/tdecachegrind/hotshot2calltree.1 @@ -0,0 +1,57 @@ +.\" 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 HOTSHOT2CALLTREE 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 +hotshot2calltree \- convert hotshot profiling data to KCachegrind calltree format +.SH SYNOPSIS +.B hotshot2calltree +[ \fB\-\-file\-limit\fP \fIlimit\fP ] +\fB\-o\fP \fIoutput\fP \fIinput\fP [ \fIinput\fP ... ] +.SH DESCRIPTION +\fBhotshot2calltree\fP reads one or more pstat profiling data files +as output by the hotshot python profiler, and converts them into +calltree format for use by KCachegrind. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.TP +\fB\-o\fP \fIoutput\fP +Write the calltree output into the given file for use by KCachegrind. +This may be \fB\-\fP if you wish to write to standard output. +.TP +\fIinput\fP ... +Read the hotshot profiling data from the given file(s). +.TP +\fB\-\-file\-limit\fP \fIlimit\fP +Stop after the given number of input files. +.SH EXAMPLE +Suppose that you have used hotshot to profile a python app, with results +dumped to the file \fIpythongrind.prof\fP. You may then work with this +data in KCachegrind as follows. +.PP +.RS +hotshot2cachegrind \-o cachegrind.out.0 pythongrind.prof +.br +tdecachegrind cachegrind.out.0 +.RE +.SH SEE ALSO +.BR tdecachegrind (1). +.SH AUTHOR +This converter was written by Jorg Beyer <job@webde-ag.de>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/tdecachegrind/memprof2calltree.1 b/doc/man/tdecachegrind/memprof2calltree.1 new file mode 100644 index 00000000..d4f52ead --- /dev/null +++ b/doc/man/tdecachegrind/memprof2calltree.1 @@ -0,0 +1,36 @@ +.\" 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 MEMPROF2CALLTREE 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 +memprof2calltree \- convert memprof profiling data to KCachegrind calltree format +.SH SYNOPSIS +.B memprof2calltree +.SH DESCRIPTION +\fBmemprof2calltree\fP reads the memory profiles of memprof and +converts them into calltree format for use by KCachegrind. +.PP +The memprof data must be supplied on standard input, and the +corresponding calltree data will be written to standard output. +.PP +This utility is part of the TDE Software Development Kit. +.SH SEE ALSO +.BR tdecachegrind (1). +.SH AUTHOR +This converter was written by Josef Weidendorfer <Josef.Weidendorfer@gmx.de>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/tdecachegrind/op2calltree.1 b/doc/man/tdecachegrind/op2calltree.1 new file mode 100644 index 00000000..0242e6cd --- /dev/null +++ b/doc/man/tdecachegrind/op2calltree.1 @@ -0,0 +1,43 @@ +.\" 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 OP2CALLTREE 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 +op2calltree \- convert OProfile profiling data to KCachegrind calltree format +.SH SYNOPSIS +.B op2calltree +.SH DESCRIPTION +\fBop2calltree\fP reads the profiling data output by OProfile v0.8 and +converts it into calltree format for use by KCachegrind. +.PP +The OProfile data must be supplied on standard input, and should be +obtained by running: +.PP +.RS +opreport \-gdf +.RE +.PP +This converter will then write a separate calltree data file for each +application, to a file of the form \fIoprof.out.<app>\fP. +.PP +This utility is part of the TDE Software Development Kit. +.SH SEE ALSO +.BR tdecachegrind (1). +.SH AUTHOR +This converter was written by Josef Weidendorfer <Josef.Weidendorfer@gmx.de>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/tdecachegrind/pprof2calltree.1 b/doc/man/tdecachegrind/pprof2calltree.1 new file mode 100644 index 00000000..b5cf9082 --- /dev/null +++ b/doc/man/tdecachegrind/pprof2calltree.1 @@ -0,0 +1,52 @@ +.\" 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 PPROF2CALLTREE 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 +pprof2calltree \- convert APD profiling data to KCachegrind calltree format +.SH SYNOPSIS +.B pprof2calltree +\fB\-f\fP \fIinput\fP +.SH DESCRIPTION +\fBpprof2calltree\fP reads the pprof profiling data output by +APD (http://pecl.php.net/apd/), and converts it into calltree format +for use by KCachegrind. +.PP +This utility is part of the TDE Software Development Kit. +.SH OPTIONS +.TP +\fB\-f\fP \fIinput\fP +Specifies the APD pprof trace file to convert. This generally has a +name of the form \fIpprof.XXXXX.Y\fP. The calltree output for +KCachegrind will then be written to the file \fIcachegrind.out.XXXXX.Y\fP. +.SH EXAMPLE +Suppose you profile a script with APD and obtain the pprof trace file +\fIpprof.12345.1\fP. You can then work with this data in KCachegrind as +follows. +.PP +.RS +pprof2calltree -f pprof.12345.1 +.br +tdecachegrind cachegrind.out.12345.1 +.RE +.PP +.SH SEE ALSO +.BR tdecachegrind (1). +.SH AUTHOR +This converter was written by George Schlossnagle <george@omniti.com>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/tdecachegrind/tdecachegrind.1 b/doc/man/tdecachegrind/tdecachegrind.1 new file mode 100644 index 00000000..d5f3ea06 --- /dev/null +++ b/doc/man/tdecachegrind/tdecachegrind.1 @@ -0,0 +1,67 @@ +.\" 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 TDECACHEGRIND 1 "March 25, 2005" +.\" 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 +tdecachegrind \- a visualisation tool for valgrind profiling output +.SH SYNOPSIS +.B tdecachegrind +.RI "[ " generic-options " ]" +[ \fB\-r\fP \fIexec\fP ] [ \fItrace-file\fP ] +.SH DESCRIPTION +\fBKCachegrind\fP is a visualisation tool for the profiling data generated +by \fBcalltree\fP, a profiling skin for \fBvalgrind\fP. Applications can be +profiled using calltree without being recompiled, and shared libraries +and plugin architectures are supported. +.PP +For visualising the output from other profiling tools, several converters +are available. On Debian systems these can be found in the +\fItdecachegrind-converters\fP package. +.PP +This application is part of the TDE Software Development Kit. +.SH OPTIONS +Below are the tdecachegrind-specific options. +For a full summary of options, run \fItdecachegrind \-\-help\fP. +.TP +\fB\-r\fP \fIexec\fP +Run the program \fIexec\fP under cachegrind. +.TP +\fItrace-file\fP +Visualise data from the given trace. +.SH SEE ALSO +.BR calltree (1), +.BR dprof2calltree (1), +.BR hotshot2calltree (1), +.BR memprof2calltree (1), +.BR op2calltree (1), +.BR pprof2calltree (1), +.BR valgrind (1). +.PP +Full user documentation is available through the TDE Help Centre. +You can also enter the URL +\fIhelp:/tdecachegrind/\fP +directly into konqueror or you can run +`\fIkhelpcenter help:/tdecachegrind/\fP' +from the command-line. +.PP +If the TDE Help Centre is not installed then you can install the package +\fItdesdk-doc-html\fP and read this documentation in HTML format from +\fI/usr/share/doc/tde/HTML/en/tdecachegrind/\fP. +.SH AUTHOR +KCachegrind was written by Josef Weidendorfer <Josef.Weidendorfer@gmx.de>. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/umbrello/CMakeLists.txt b/doc/man/umbrello/CMakeLists.txt new file mode 100644 index 00000000..24ccd704 --- /dev/null +++ b/doc/man/umbrello/CMakeLists.txt @@ -0,0 +1,7 @@ +file( GLOB _man_files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.1 ) + +INSTALL( + FILES ${_man_files} + DESTINATION ${MAN_INSTALL_DIR}/man1 + COMPONENT doc +) diff --git a/doc/man/umbrello/umbrello.1 b/doc/man/umbrello/umbrello.1 new file mode 100644 index 00000000..3c5d77d5 --- /dev/null +++ b/doc/man/umbrello/umbrello.1 @@ -0,0 +1,53 @@ +.\" 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 UMBRELLO 1 "March 19, 2005" +.\" 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 +umbrello \- a UML modelling tool and code generator +.SH SYNOPSIS +.B umbrello +.RI "[ " generic-options " ]" +[ \fIfile\fP ] +.SH DESCRIPTION +\fBUmbrello UML Modeller\fP is a Unified Modelling Language editor for TDE. +With UML you can create diagrams of software and other systems in an +industry standard format. Umbrello can also generate code from your +UML diagrams in a number of programming languages. +.PP +The program supports class diagrams, sequence diagrams, collaboration +diagrams, use case diagrams, state diagrams, activity diagrams, component +diagrams and deployment diagrams. +.PP +This application is part of the TDE Software Development Kit. +.SH OPTIONS +For a full summary of options, run \fIumbrello \-\-help\fP. +.SH SEE ALSO +Full user documentation is available through the TDE Help Centre. +You can also enter the URL +\fIhelp:/umbrello/\fP +directly into konqueror or you can run +`\fIkhelpcenter help:/umbrello/\fP' +from the command-line. +.PP +If the TDE Help Centre is not installed then you can install the package +\fItdesdk-doc-html\fP and read this documentation in HTML format from +\fI/usr/share/doc/tde/HTML/en/umbrello/\fP. +.SH AUTHOR +Umbrello was written by Paul Hensgen <phensgen@users.sourceforge.net> and +many others. +.br +This manual page was prepared by Ben Burton <bab@debian.org> +for the Debian GNU/Linux system (but may be used by others). diff --git a/scripts/CMakeLists.txt b/scripts/CMakeLists.txt index 17f9683c..4563f168 100644 --- a/scripts/CMakeLists.txt +++ b/scripts/CMakeLists.txt @@ -40,4 +40,4 @@ macro( _pod2man ) endforeach( ) endmacro() -_pod2man( kde-build tdesvn-build cvsversion cvscheck noncvslist cvsblame includemocs ) +_pod2man( kde-build tdesvn-build cvsversion noncvslist cvsblame includemocs ) |