[SCM] Calligra suite packaging branch, master, updated. debian/2.6.1-1-13-gc792561

[Adrien Grellier]

Gitweb-URL: http://git.debian.org/?p=pkg-kde/kde-std/calligra.git;a=commitdiff;h=16cdac7

The following commit has been merged in the master branch:
commit 16cdac78f13dbdecc007a66d074786ad1b05b638
Author: Adrien Grellier <adrien.grellier at laposte.net>
Date:   Fri May 3 22:39:36 2013 +0200

    add a basic man page for calligrauthor, as requested by lintian.
    
    Also add a documentation about man page on the README.source
---
 debian/README.source                               |   15 +++++++++++++++
 debian/calligraauthor.manpages                     |    1 +
 debian/changelog                                   |    1 +
 debian/man/{calligrawords.1 => calligraauthor.1}   |   19 +++++--------------
 .../man/{calligrawords.rst => calligraauthor.rst}  |    9 ++++-----
 5 files changed, 26 insertions(+), 19 deletions(-)

diff --git a/debian/README.source b/debian/README.source
index 727a9e5..9d6b42a 100644
--- a/debian/README.source
+++ b/debian/README.source
@@ -63,6 +63,21 @@ TODO finish the script to have an automatic way of updating the copyright file.
 
 .. _copyright_helper: git://anonscm.debian.org/users/modax/copyright-helper.git
 
+Man pages
+==========
+
+Upstream doesn't provide any man page, but the Debian policy specify to have 
+a man page for each binary. So I created very basic page in debian/man, but 
+it can be improved...
+
+I prefer to use the restructuredText_ format (.rst files), which is much more
+readable. To actually creates the man pages:
+
+..
+    rst2man calligraauthor.rst > calligraauthor.1
+
+.. _restructuredText: http://docutils.sourceforge.net/
+
 Dealing with bugs
 ==================
 
diff --git a/debian/calligraauthor.manpages b/debian/calligraauthor.manpages
new file mode 100644
index 0000000..68a7d8f
--- /dev/null
+++ b/debian/calligraauthor.manpages
@@ -0,0 +1 @@
+debian/man/calligraauthor.1
diff --git a/debian/changelog b/debian/changelog
index cf5b90c..efb617c 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -5,6 +5,7 @@ calligra (1:2.6.3-1) experimental; urgency=low
 
   [ Adrien Grellier ]
   * Make calligra-data Break/Replace kexi < 1:2.4 (Closes: #704597)
+  * Add a manpage for calligraauthor, as requested by lintian
 
   [ Lisandro Damián Nicanor Pérez Meyer ]
   * Make calligra-libs recommend libqca2-plugin-ossl for encryption
diff --git a/debian/man/calligrawords.1 b/debian/man/calligraauthor.1
similarity index 78%
copy from debian/man/calligrawords.1
copy to debian/man/calligraauthor.1
index 0b9ae83..2aba81e 100644
--- a/debian/man/calligrawords.1
+++ b/debian/man/calligraauthor.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructeredText.
 .
-.TH CALLIGRAWORDS 1 "11 septembre 2011" "" "office"
+.TH CALLIGRAWORDS 1 "13 mai 2013" "" "office"
 .SH NAME
 CalligraWords \- Calligra Word Processor
 .
@@ -35,45 +35,36 @@ level margin: \n[rst2man-indent\n[rst2man-indent-level]]
 calligrawords [Qt\-options] [KDE\-options] [Calligra\-options] [file]
 .SH DESCRIPTION
 .sp
-Words is a FrameMaker\-like word processing and desktop publishing
-application.  It is capable of creating demanding and professional
-looking documents.  It can be used for desktop publishing, but also for
-"normal" word processing, like writing letters, reports and so on.
+Calligra Author is a specialized tool for serious writers aiming to become what
+Krita is for painters. The application will support a writer in the process of
+creating an eBook from concept to publication.
 .SH OPTIONS
 .sp
 Generic options:
 .INDENT 0.0
 .TP
 .B \-\-help
-.
 Show help about options
 .TP
 .B \-\-help\-qt
-.
 Show Qt specific options
 .TP
 .B \-\-help\-kde
-.
 Show KDE specific options
 .TP
 .B \-\-help\-calligra
-.
 Show Calligra 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
 .UNINDENT
 .sp
@@ -82,7 +73,7 @@ Arguments:
 BfileP                  File to open
 .SH SEE ALSO
 .sp
-More detailed user documentation is available at I\%http://userbase.kde.org/WordsP.
+More detailed user documentation is available at I\%http://www.calligra.org/news/calligra\-announces\-author/P
 .SH AUTHOR
 This manual page was written by Adrien Grellier <adrien.grellier at laposte.net> for the Debian project (but may be used by others).
 .\" Generated by docutils manpage writer.
diff --git a/debian/man/calligrawords.rst b/debian/man/calligraauthor.rst
similarity index 73%
copy from debian/man/calligrawords.rst
copy to debian/man/calligraauthor.rst
index 55241fc..08fb774 100644
--- a/debian/man/calligrawords.rst
+++ b/debian/man/calligraauthor.rst
@@ -20,10 +20,9 @@ calligrawords [Qt-options] [KDE-options] [Calligra-options] [file]
 Description
 ===========
 
-Words is a FrameMaker-like word processing and desktop publishing
-application.  It is capable of creating demanding and professional
-looking documents.  It can be used for desktop publishing, but also for
-"normal" word processing, like writing letters, reports and so on.
+Calligra Author is a specialized tool for serious writers aiming to become what
+Krita is for painters. The application will support a writer in the process of 
+creating an eBook from concept to publication.
 
 Options
 =======
@@ -47,7 +46,7 @@ Arguments:
 SEE ALSO
 =========
 
-More detailed user documentation is available at http://userbase.kde.org/Words. 
+More detailed user documentation is available at http://www.calligra.org/news/calligra-announces-author/
 
 
 .. |date| date:: %y %B %Y

-- 
Calligra suite packaging