Add man pages for TDE applications.

Signed-off-by: Michele Calgaro <[email protected]>
(cherry picked from commit 825599fcfff1d8e78368e2dfd9537499f48313a4)

5 files changed, 259 insertions, 0 deletions

diff --git a/doc/man/konq-plugins/CMakeLists.txt b/doc/man/konq-plugins/CMakeLists.txt
new file mode 100644
index 0000000..24ccd70
--- /dev/null
+++ b/doc/man/konq-plugins/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/konq-plugins/exif.py.1 b/doc/man/konq-plugins/exif.py.1
new file mode 100644
index 0000000..7317904
--- /dev/null
+++ b/doc/man/konq-plugins/exif.py.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 EXIF.PY 1 "February 4, 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
+exif.py \- extract EXIF information from digital camera image files
+.SH SYNOPSIS
+.B exif.py
+\fIimage-file\fP ...
+.SH DESCRIPTION
+This is a Python library for extracting EXIF tags from digital camera
+image files.  It contains a command-line testing and debugging interface,
+which reads EXIF tags from the given files and dumps them to the
+console.
+.PP
+This library is provided with the image conversion and transformation
+plugins for Konqueror.  The JPEG rotation/reflection tool \fBjpegorient\fP,
+part of the same set of plugins, makes use of this library.
+.PP
+This utility is part of the official TDE add-ons module.
+.SH SEE ALSO
+.BR jpegorient (1),
+.BR konqueror (1),
+.BR orient.py (1).
+.SH AUTHOR
+The EXIF extraction library was written by Thierry Bousch
+<[email protected]>, Gene Cash <[email protected]> and
+Leif Jensen <[email protected]>.
+.br
+This manual page was prepared by Ben Burton <[email protected]>
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/doc/man/konq-plugins/fsview.1 b/doc/man/konq-plugins/fsview.1
new file mode 100644
index 0000000..a1dd43b
--- /dev/null
+++ b/doc/man/konq-plugins/fsview.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 FSVIEW 1 "February 4, 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
+fsview \- a filesystem viewer that graphically shows disk usage
+.SH SYNOPSIS
+.B fsview
+.RI "[ " generic-options " ]"
+[ \fIfolder\fP ]
+.SH DESCRIPTION
+\fBFSView\fP is a tool for showing disc utilization in a graphical form, much
+like the UNIX command 'du'.  The visualisation type chosen is a
+treemap.  Each directory is represented by a rectangle whose area is
+proportional to its size.  Each directory rectangle contains smaller
+rectangles for its contents, and so on down.
+.PP
+FSView is provided both as a Konqueror plugin for viewing directories,
+and as a standalone executable.
+.PP
+This application is part of the official TDE add-ons module.
+.SH OPTIONS
+Below are the fsview-specific options.
+For a full summary of options, run \fIfsview \-\-help\fP.
+.TP
+\fIfolder\fP
+View the filesystem starting from this folder.
+.SH SEE ALSO
+.BR du (1),
+.BR kdirstat (1),
+.BR konqueror (1).
+.PP
+For a full featured graphical 'du', see KDirStat.  It's quite similar
+to FSView, but allows for lot of cleanup actions.
+.SH AUTHOR
+FSView was written by Josef Weidendorfer <[email protected]>.
+.br
+This manual page was prepared by Ben Burton <[email protected]>
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/doc/man/konq-plugins/jpegorient.1 b/doc/man/konq-plugins/jpegorient.1
new file mode 100644
index 0000000..3317c86
--- /dev/null
+++ b/doc/man/konq-plugins/jpegorient.1
@@ -0,0 +1,68 @@
+.\"                                      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 JPEGORIENT 1 "October 13, 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
+jpegorient \- change the orientations of JPEG images
+.SH SYNOPSIS
+.B jpegorient
+{ \fB\-90\fP | \fB\-180\fP | \fB\-270\fP | \fB\-v\fP | \fB\-h\fP }
+\fIimage-file\fP ...
+.SH DESCRIPTION
+This is a simple utility for changing the orientations of one or more
+JPEG images.
+It is provided as part of the image conversion and transformation
+plugins for Konqueror.
+.PP
+A single option must be passed before any filenames to specify how the
+orientations of the images are to be changed.  Each new image will be
+saved over the old one.
+.PP
+This utility makes use of
+.BR orient.py (1),
+which is designed to work with certain types of digital camera image
+files.  Instead of modifying the image data, it alters the EXIF
+tags stored with the image to reflect the new orientation.  For this
+reason only images with the correct types of EXIF tags can be changed
+using this tool.
+.PP
+This utility is part of the official TDE add-ons module.
+.SH OPTIONS
+.TP
+\fB\-90\fP
+Rotate each image by 90 degrees clockwise.
+.TP
+\fB\-180\fP
+Rotate each image by a half turn (i.e., 180 degrees).
+.TP
+\fB\-270\fP
+Rotate each image by 270 degrees clockwise (i.e., 90 degrees counter-clockwise).
+.TP
+\fB\-v\fP
+Flip each image vertically.
+.TP
+\fB\-h\fP
+Flip each image horizontally.
+.SH SEE ALSO
+.BR exif.py (1),
+.BR konqueror (1),
+.BR orient.py (1).
+.SH AUTHOR
+The image transformation plugins were written by
+Leif Jensen <[email protected]>.
+.br
+This manual page was prepared by Ben Burton <[email protected]>
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/doc/man/konq-plugins/orient.py.1 b/doc/man/konq-plugins/orient.py.1
new file mode 100644
index 0000000..024ec11
--- /dev/null
+++ b/doc/man/konq-plugins/orient.py.1
@@ -0,0 +1,88 @@
+.\"                                      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 ORIENT.PY 1 "October 13, 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
+orient.py \- change the orientation of a digital camera image file
+.SH SYNOPSIS
+.B orient.py
+.I image-file
+.br
+.B orient.py
+[1-8]
+.I image-file
+.SH DESCRIPTION
+This is a small script for changing the orientation of certain types
+of digital camera image files.  The image data is not modified, but
+rather the EXIF tags stored with the image are altered to reflect the
+new orientation.  For this reason only images with the correct types of
+EXIF tags can be changed using this script.
+.PP
+When called with with a numeric argument from 1 to 8, the orientation
+will be changed as described in the options section below.  When called
+with only a filename, the current orientation will be written to the
+console (also as a number from 1 to 8).
+.PP
+If the image contains no EXIF information or if the EXIF information is not
+of the correct type, an error will be displayed and this script will
+exit immediately.
+.PP
+This script is provided with the image conversion and transformation
+plugins for Konqueror.  For a more general-purpose JPEG rotation/reflection
+tool, see
+.BR jpegorient (1)
+which is also a part of this same set of plugins.
+.PP
+This utility is part of the official TDE add-ons module.
+.SH OPTIONS
+The possible orientations are represented by the numbers 1 to 8 as
+follows.
+.TP
+.B 1
+No change of orientation.
+.TP
+.B 2
+Flip horizontally.
+.TP
+.B 3
+Rotate by a half turn (i.e., 180 degrees).
+.TP
+.B 4
+Flip vertically.
+.TP
+.B 5
+Transpose image (i.e., reflect across the upper-left to lower-right
+diagonal axis).
+.TP
+.B 6
+Rotate by 90 degrees clockwise.
+.TP
+.B 7
+Transverse transpose image (i.e., reflect across the upper-right to
+lower-left diagonal axis).
+.TP
+.B 8
+Rotate by 270 degrees clockwise (i.e., 90 degrees counter-clockwise).
+.SH SEE ALSO
+.BR exif.py (1),
+.BR jpegorient (1),
+.BR konqueror (1).
+.SH AUTHOR
+The image transformation plugins were written by
+Leif Jensen <[email protected]>.
+.br
+This manual page was prepared by Ben Burton <[email protected]>
+for the Debian GNU/Linux system (but may be used by others).