[SCM] Calligra suite packaging branch, experimental, updated. debian/2.6.1-1-11-g16cdac7
Adrien Grellier
adrien-guest at alioth.debian.org
Fri May 3 20:40:43 UTC 2013
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 experimental 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:
BfileP File to open
.SH SEE ALSO
.sp
-More detailed user documentation is available at I\%http://userbase.kde.org/WordsP.
+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
More information about the pkg-kde-commits
mailing list