Build documentation for each subpackage separately

Signed-off-by: ormorph <[email protected]>
(cherry picked from commit 95c3cba08ea09ecabb84cfd662bec76668b89bf7)

2 files changed, 109 insertions, 0 deletions

diff --git a/doc/man/tdesu/CMakeLists.txt b/doc/man/tdesu/CMakeLists.txt
new file mode 100644
index 000000000..65c83b94f
--- /dev/null
+++ b/doc/man/tdesu/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/tdesu/tdesu.1 b/doc/man/tdesu/tdesu.1
new file mode 100644
index 000000000..fa8c45e09
--- /dev/null
+++ b/doc/man/tdesu/tdesu.1
@@ -0,0 +1,102 @@
+.TH TDESU 1 "May 2005" "Trinity Desktop Environment" "Runs a program with elevated privileges."
+.SH NAME
+tdesu \- Runs a program with elevated privileges.
+.SH SYNOPSIS
+\fBtdesu\fR [Qt\-options] [TDE\-options] [tdesu options] command 
+.SH DESCRIPTION
+Runs a program with elevated privileges.
+.PP
+TDE su is a graphical front end to the Unix \fBsu\fR utility. It allows you to run programs as another user by entering their password. It is not a SUID root program, but runs unprivileged. The system program \fBsu\fR is used for acquiring special privileges.
+.PP
+\fBtdesu\fR has the ability to store passwords for the convenience of users. The passwords are NOT written to disk, but stored in memory using a special program, \fBtdesud\fR. This is only done if the user specifies that the password be remembered. In this case, passwords are stored in memory for a certain period of time before being removed. \fBtdesud\fR runs in such a way that only the user who entered the password originally can use it, though no one, not even the user who originally entered the password, can retrieve the password that is stored by \fBtdesud\fR. Through these measures, users can avoid having to repeatedly enter root passwords or other passwords, without a significant risk to overall system security.
+.PP
+\fBtdesu\fR uses normally \fBsu\fR to gain root by using the root password. \fBtdesu\fR can also be configured to use other commands to gain root like sudo to use users password.
+.SH OPTIONS
+.SS Generic options:
+.TP
+.B  --help
+Show help about options
+.TP
+.B  --help-qt
+Show Qt specific options
+.TP
+.B  --help-tde
+Show TDE specific options
+.TP
+.B  --help-all
+Show all options
+.TP
+.B  --author
+Show author information
+.TP
+.B -v,  --version
+Show version information
+.TP
+.B  --license
+Show license information
+.SS
+.SS tdesu Options:
+.TP
+.TP
+.B -c <command>
+Specifies the command to run
+.TP
+.B -f <file>
+Run command under target uid if <file> is not writable
+.TP
+.B -u <user>
+Specifies the target uid [default is root]
+.TP
+.B -n
+Do not keep password
+.TP
+.B -s
+Stop the daemon (forgets all passwords)
+.TP
+.B -t
+Enable terminal output (no password keeping)
+.TP
+.B -p <prio>
+Set priority value: 0 <= prio <= 100, 0 is lowest [default is 50]
+.TP
+.B -r
+Use realtime scheduling
+.TP
+.B  --nonewdcop
+Let command use existing dcopserver
+.TP
+.B -i <icon name>
+Specify icon to use in the password dialog
+.TP
+.B -d
+Do not show the command to be run in the dialog
+.SS 
+.SS Arguments:
+.TP
+.B command
+Specifies the command to run
+
+.SH CONFIGURATION FILES
+.PP
+\fBtdesu\fR can be configured with a default configuration file /etc/trinity/tdesurc and with a per user configuration file in .trinity/share/config/tdesurc. Alternative a section could be added to kdeglobals.
+.SH EXAMPLE
+The configuration item for the configuration files is the following:
+.br
+[super-user-command] 
+.br
+super-user-command=sudo
+
+.SH SEE ALSO
+Full user documentation is available through the TDE Help Center. You can also enter the URL
+.BR help:/tdesu/
+directly into konqueror or you can run 
+.BR "`khelpcenter help:/tdesu/'"
+from the command-line.
+.br
+.SH AUTHORS
+.br
+Geert Jansen <[email protected]>
+.br
+Pietro Iglio <[email protected]>
+.PP
+This manual page was written by Christopher Martin <[email protected]> for Debian GNU/Linux, but may be used by others. It borrows from an earlier manpage by Karolina Lindqvist <pgd\[email protected]>.