* debian/manpages/assistant-qt4.1: new manpage written from scratch

    based on the output of "assistant -help"
  * debian/manpages/designer-qt4.1, debian/manpages/linguist-qt4.1:
    manpages stolen from the Qt3 packages and trivially adapted for Qt4
    (Closes: #322403)
  * debian/manpages/moc-qt4.1: escape some '-' characters
  * debian/qt4-dev-tools.manpages: install the new assistant-qt4.1,
    designer-qt4.1, and linguist-qt4.1 manpages

6 files changed, 164 insertions, 12 deletions

diff --git a/debian/changelog b/debian/changelog
index a2b9fcb..adda1b5 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,19 @@
+qt4-x11 (4.0.0-4) UNRELEASED; urgency=low
+
+  * debian/manpages/assistant-qt4.1: new manpage written from scratch
+    based on the output of "assistant -help"
+
+  * debian/manpages/designer-qt4.1, debian/manpages/linguist-qt4.1:
+    manpages stolen from the Qt3 packages and trivially adapted for Qt4
+    (Closes: #322403)
+
+  * debian/manpages/moc-qt4.1: escape some '-' characters
+
+  * debian/qt4-dev-tools.manpages: install the new assistant-qt4.1,
+    designer-qt4.1, and linguist-qt4.1 manpages
+
+ -- Brian Nelson <pyro@debian.org>  Thu, 11 Aug 2005 13:37:00 -0700
+
 qt4-x11 (4.0.0-3) unstable; urgency=low
 
   * debian/control: changed the xlibs-pic dependency to xlibs-static-pic
diff --git a/debian/manpages/assistant-qt4.1 b/debian/manpages/assistant-qt4.1
new file mode 100644
index 0000000..b9019e8
--- /dev/null
+++ b/debian/manpages/assistant-qt4.1
@@ -0,0 +1,44 @@
+.TH "ASSISTANT-QT4" 1 "4.0.0" "Trolltech AS" \" -*- nroff -*-
+.SH NAME
+assistant-qt4 \- on\-line documentation browser for Qt4
+.SH SYNOPSIS
+.B assistant [options]
+.SH DESCRIPTION
+This page documents the
+.B Qt Assistant
+for the Qt application framework, which is typically used to display the
+Qt Reference Documentation.
+.SH OPTIONS
+.TP
+.I "\-file Filename"
+assistant opens the specified file
+.TP
+.I \-server
+reads commands from a socket after assistant has started
+.TP
+.I "\-profile fileName"
+starts assistant and displays the profile specified in the file
+.I fileName
+.TP
+.I "\-addContentFile file"
+adds the content file 
+.I file
+to the set of documentation available by default
+.TP
+.I "\-removeContentFile file"
+removes the content file
+.I file
+from the documentation available by default
+.TP
+.I "\-hideSidebar"
+assistant will hide the sidebar
+.TP
+.I "-help"
+outputs some help text
+.SH "SEE ALSO"
+.BR /usr/share/qt4/doc/html/assistant-manual.html,
+.BR http://doc.trolltech.com
+.SH AUTHOR
+This manual page was written by Brian Nelson <pyro@debian.org> based on
+the output of
+.B "assistant -help".
diff --git a/debian/manpages/designer-qt4.1 b/debian/manpages/designer-qt4.1
new file mode 100644
index 0000000..d56b1d4
--- /dev/null
+++ b/debian/manpages/designer-qt4.1
@@ -0,0 +1,50 @@
+.TH "DESIGNER-QT4" "1" "4.0.0" "Troll Tech AS, Norway." ""
+.SH "NAME"
+.LP 
+designer\-qt4 \- Visual user interface designer for Qt4.
+.SH "DESCRIPTION"
+.LP 
+Qt Designer simplifies the process of designing and
+creating graphical user interfaces (GUI) using the
+award\-winning Qt toolkit. Qt Designer is easy to learn.
+There are tutorials, walkthrough examples and the
+reference documentation accelerating you through the
+learning phase. After that, Qt Designer greatly reduces
+the time and effort needed to develop even the most
+complex dialogs with an easy\-to\-use GUI and an integrated
+help system.
+
+ Qt Designer provides a rich set of features aimed at
+making the creation of dialogs as easy and smooth as
+possible without reducing the power of Qt. It offers all
+the strength of the Qt layout system with a well\-designed
+user interface. This, combined with the Qt Designer's
+undo/redo system makes it simple to try different
+arrangements of the widgets until the result satisfies
+you.
+
+ Using Qt Designer's convenient property editor along
+with the dynamic Qt property system it is easy to set the
+initial state of your widgets. Special editors for some
+widgets (like listboxes, comboboxes, etc.) allow you to
+fill these widgets with content without writing any code.
+Using the object hierarchy view, the parent\-child
+relationship between the widgets of a dialog can be
+understood at a glance.
+
+ Integrating dialogs into a Qt project is straightforward
+thanks to the User Interface Compiler (UIC), which
+generates C++ code from the XML dialog description on the
+fly. The programmer can easily extend the functionality
+of the generated classes by subclassing without touching
+generated code at all or running the risk of loosing
+their changes.
+.SH "ENVIRONMENT VARIABLES"
+.LP 
+.TP 
+\fBQTDIR\fP
+Specifies the Qt base directory.  On Debian systems this
+should be set to /usr/share/qt4.
+.SH "AUTHORS"
+.LP 
+TrollTech <http://www.trolltech.com/>
diff --git a/debian/manpages/linguist-qt4.1 b/debian/manpages/linguist-qt4.1
new file mode 100644
index 0000000..95ae95c
--- /dev/null
+++ b/debian/manpages/linguist-qt4.1
@@ -0,0 +1,39 @@
+.TH "LINGUIST-QT4" "1" "4.0.0" "Troll Tech AS, Norway." ""
+.SH "NAME"
+linguist-qt4 \- translation tool for Qt4.
+
+.SH "SYNPOSIS"
+.B linguist
+[
+.I TRANSLATION
+]
+
+.SH "DESCRIPTION"
+.B Qt Linguist
+is a tool for adding translations to Qt applications. It
+introduces the concept of a translation "context" which
+means a group of phrases that appear together on the
+screen e.g. in the same menu or dialog.
+
+The only parameter accepted on the command line is 
+.I TRANSLATION
+wich is the name of the translation file you wish to open.
+
+.SH FILES
+.I ~/.qt/qt_designerrc
+.RS
+Per user configuration file.
+
+.SH SEE ALSO
+.B Qt Linguist
+is too complex to be described completely in the "man" page
+format. If your system is properly configured, you can access
+the full documentation within
+.B Qt Linguist
+under the Help menu.
+
+.SH AUTHOR
+This manual page was originally written by Jeremy Lainé
+<jeremy.laine@m4x.org> for the Qt3 linguist, for the Debian GNU/Linux
+system (but may be used by others).  Brian Nelson <pyro@debian.org>
+trivially updated it for Qt4.
diff --git a/debian/manpages/moc-qt4.1 b/debian/manpages/moc-qt4.1
index 4d1d91c..131827a 100644
--- a/debian/manpages/moc-qt4.1
+++ b/debian/manpages/moc-qt4.1
@@ -12,7 +12,7 @@
 moc \- generate Qt meta object support code
 .SH SYNOPSIS
 .B moc
-[-o file] [-i] [-f] [-k] [-ldbg] [-nw] [-p path] [-q path] [-v] file
+[\-o file] [\-i] [\-f] [\-k] [\-ldbg] [\-nw] [\-p path] [\-q path] [\-v] file
 .SH DESCRIPTION
 This page documents the
 .B Meta Object Compiler
@@ -38,16 +38,16 @@ In brief, the meta object system is a structure used by Qt (see
 for component programming and run time type information.  It adds
 properties and inheritance information to (some) classes and
 provides a new type of communication between those instances of those
-classes, signal-slot
+classes, signal\-slot
 connections.
 .SH OPTIONS
 .TP
-.I "-o file"
+.I "\-o file"
 Write output to
 .I file
 rather than to stdout.
 .TP
-.I -f
+.I \-f
 Force the generation of an #include statement in the output.
 This is the default for files whose name matches the regular
 expression .[hH][^.]* (i.e. the extension starts with
@@ -58,38 +58,38 @@ or
 option is only useful if you have header files that do not follow the
 standard naming conventions.
 .TP
-.I "-i"
+.I "\-i"
 Do not generate an #include statement in the output.  This may be used
 to run
 .B moc
 on a C++ file containing one or more class declarations. You should then
 #include the meta object code in the .cpp file (see USAGE below).  If both
-.I -f
+.I \-f
 and
-.I -i
+.I \-i
 are present, the last one wins.
 .TP
-.I "-nw"
+.I "\-nw"
 Do not generate any warnings. Not recommended.
 .TP
-.I "-ldbg"
+.I "\-ldbg"
 Write a flood of lex debug information to stdout.
 .TP
-.I "-p path"
+.I "\-p path"
 Makes
 .B moc
 prepend
 .IR path /
 to the file name in the generated #include statement (if one is generated).
 .TP
-.I "-q path"
+.I "\-q path"
 Makes
 .B moc
 prepend
 .IR path /
 to the file name of qt #include files in the generated code.
 .TP
-.I "-v"
+.I "\-v"
 Displays the version of
 .B moc
 and Qt.
diff --git a/debian/qt4-dev-tools.manpages b/debian/qt4-dev-tools.manpages
new file mode 100644
index 0000000..a25ac7c
--- /dev/null
+++ b/debian/qt4-dev-tools.manpages
@@ -0,0 +1,3 @@
+debian/manpages/assistant-qt4.1
+debian/manpages/designer-qt4.1
+debian/manpages/linguist-qt4.1