[SCM] freeplane packaging branch, master, updated. debian/1.1.3-2-52-g4b68a3f
Felix Natter
fnatter at gmx.net
Sat Apr 6 15:27:34 UTC 2013
The following commit has been merged in the master branch:
commit eb60eed3d8fb45055da814a5875a56ada47b78cb
Author: Felix Natter <fnatter at gmx.net>
Date: Tue Mar 26 20:05:41 2013 +0100
move manpage source to docbook xml, describe command line options
diff --git a/debian/control b/debian/control
index 98c2a41..d2e258c 100644
--- a/debian/control
+++ b/debian/control
@@ -3,7 +3,7 @@ Section: editors
Priority: extra
Maintainer: Debian Java Maintainers <pkg-java-maintainers at lists.alioth.debian.org>
Uploaders: Felix Natter <fnatter at gmx.net>
-Build-Depends: cdbs, debhelper (>= 7), docbook-to-man, imagemagick, ant, default-jdk, quilt
+Build-Depends: cdbs, debhelper (>= 7), docbook-xsl, docbook-xml, xsltproc, imagemagick, ant, default-jdk, quilt
Build-Depends-Indep: javahelp2, groovy, libcommons-lang-java, libcommons-io-java, libjgoodies-forms-java, simplyhtml (>=0.16.05), libbatik-java, librhino-java, libfop-java, libxerces2-java, libxml-commons-external-java, libjaxp1.3-java, libjlatexmath-java, libknopflerfish-osgi-framework-java, libjsyntaxpane-java (>=0.9.6~r156)
Standards-Version: 3.9.4
Vcs-Git: git://git.debian.org/pkg-java/freeplane.git
diff --git a/debian/freeplane.1.xml b/debian/freeplane.1.xml
new file mode 100644
index 0000000..4c7ce4f
--- /dev/null
+++ b/debian/freeplane.1.xml
@@ -0,0 +1,198 @@
+<?xml version='1.0'?>
+
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+ <!-- Fill in your name for FIRSTNAME and SURNAME. -->
+ <!ENTITY dhfirstname "<firstname>Eric</firstname>">
+ <!ENTITY dhsurname "<surname>Lavarde</surname>">
+ <!-- Please adjust the date whenever revising the manpage. -->
+ <!ENTITY dhdate "<date>March 25th, 2013</date>">
+ <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
+ allowed: see man(7), man(1). -->
+ <!ENTITY dhsection "<manvolnum>1</manvolnum>">
+ <!ENTITY dhemail "<email>deb at zorglub.s.bawue.de</email>">
+ <!ENTITY dhusername "Eric Lavarde">
+ <!ENTITY dhucpackage "<refentrytitle>FREEPLANE</refentrytitle>">
+ <!ENTITY dhpackage "freeplane">
+
+ <!ENTITY debian "<productname>Debian</productname>">
+ <!ENTITY gnu "<acronym>GNU</acronym>">
+ <!ENTITY gpl "&gnu; <acronym>GPL</acronym>">
+ <!ENTITY version "1.2.23">
+]>
+
+<refentry>
+
+ <refentryinfo>
+ <address>
+ &dhemail;
+ </address>
+ <authorgroup>
+ <author>
+ &dhfirstname;
+ &dhsurname;
+ &dhemail;
+ </author>
+ <author>
+ <firstname>Felix</firstname>
+ <surname>Natter</surname>
+ <email>fnatter at gmx.net</email>
+ </author>
+ </authorgroup>
+ <copyright>
+ <year>2013</year>
+ <holder>&dhusername; and Felix Natter</holder>
+ </copyright>
+ &dhdate;
+ </refentryinfo>
+
+ <refmeta>
+ &dhucpackage;
+ &dhsection;
+ <refmiscinfo class="source">Freeplane &version;</refmiscinfo>
+ <refmiscinfo class="manual">User Commands</refmiscinfo>
+ </refmeta>
+ <refnamediv>
+ <refname>&dhpackage;</refname>
+
+ <refpurpose>Program to create, edit, print and export Mind Maps including scripting and more.</refpurpose>
+ </refnamediv>
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>freeplane</command>
+ <arg><option>-X <replaceable>menukey</replaceable></option></arg>
+ <arg><option>-S</option></arg>
+ <arg><option>-N</option></arg>
+ <arg><option>-h</option></arg>
+ <arg><option>--help</option></arg>
+ <arg><replaceable>file1</replaceable></arg>
+ <arg><replaceable>file2</replaceable></arg>
+ <arg><replaceable>...</replaceable></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+ <refsect1>
+ <title>DESCRIPTION</title>
+
+ <para><command>&dhpackage;</command> is a program that allows you to
+ work with mind maps including automatic/conditional styles, scripting,
+ add-ons, LaTeX, search/filtering, different export features and some
+ (see
+ http://freeplane.sourceforge.net/wiki/index.php/Home#Application_areas).</para>
+
+ <para>This manual page was written for the &debian; distribution
+ because the original program does not have a manual page.
+ Instead, it has documentation in the
+ <application>Help</application> menu and
+ the <command>Freeplane</command> wiki
+ (http://freeplane.sourceforge.net/wiki/index.php/Main_Page).
+ </para>
+
+ </refsect1>
+ <refsect1>
+ <title>OPTIONS</title>
+
+ <variablelist>
+
+ <varlistentry>
+ <term>
+ <option>-X <replaceable>menukey</replaceable></option>
+ </term>
+ <listitem>
+ <para>execute menu item with
+ key <replaceable>menukey</replaceable>. Use devtools add-on to
+ find the menu keys</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>
+ <option>-S</option>
+ </term>
+ <listitem>
+ <para>stop after executing menu items</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>
+ <option>-N</option>
+ </term>
+ <listitem>
+ <para>set the 'nonInteractive' system property to 'true'</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>
+ <option>-h</option>
+ <option>--help</option>
+ </term>
+ <listitem>
+ <para>Show summary of options.</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para>You can find more detailled descriptions of all command line options and
+ environment variables as well as help for batch execution commands
+ (-X/-S/-N) in the Wiki page:
+ http://freeplane.sourceforge.net/wiki/index.php/Command-line_options
+ </para>
+
+ </refsect1>
+
+ <refsect1>
+ <title>ENVIRONMENT VARIABLES</title>
+
+ <variablelist>
+ <varlistentry>
+ <term>JAVA_OPTS</term>
+ <listitem>
+ <para>Set Java Properties, e.g. set the freeplane user config
+ directory in Freeplane <1.3.3:
+ <command>JAVA_OPTS=-Dorg.freeplane.userfpdir=$HOME/blabla freeplane</command>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>DEBUG</term>
+ <listitem>
+ <para>Start Freeplane in debug mode (if you have problems starting):
+ <command>DEBUG=true freeplane</command></para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect1>
+
+ <refsect1>
+ <title>SEE ALSO</title>
+
+ <para>Much documentation is available from the Freeplane wiki
+ under http://freeplane.org/.</para>
+ <para>There is an open discussion forum at
+ http://sourceforge.net/apps/phpbb/freeplane/viewforum.php?f=1, which is
+ the place to ask questions.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>AUTHOR</title>
+
+ <para>This manual page was written by &dhusername; &dhemail; for
+ the &debian; system (and may be used by others). Permission is
+ granted to copy, distribute and/or modify this document under
+ the terms of the &gnu; General Public License, Version 2 or any
+ later version published by the Free Software Foundation.
+ </para>
+ <para>
+ On Debian systems, the complete text of the GNU General Public
+ License, Version 2 can be found in /usr/share/common-licenses/GPL-2.
+ </para>
+
+ </refsect1>
+</refentry>
diff --git a/debian/freeplane.sgml b/debian/freeplane.sgml
deleted file mode 100644
index 2bf8a9b..0000000
--- a/debian/freeplane.sgml
+++ /dev/null
@@ -1,129 +0,0 @@
-<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
-
-<!-- Process this file with docbook-to-man to generate an nroff manual
- page: `docbook-to-man manpage.sgml > manpage.1'. You may view
- the manual page with: `docbook-to-man manpage.sgml | nroff -man |
- less'. A typical entry in a Makefile or Makefile.am is:
-
-manpage.1: manpage.sgml
- docbook-to-man $< > $@
-
-
- The docbook-to-man binary is found in the docbook-to-man package.
- Please remember that if you create the nroff version in one of the
- debian/rules file targets (such as build), you will need to include
- docbook-to-man in your Build-Depends control field.
-
- -->
-
- <!-- Fill in your name for FIRSTNAME and SURNAME. -->
- <!ENTITY dhfirstname "<firstname>Eric</firstname>">
- <!ENTITY dhsurname "<surname>Lavarde</surname>">
- <!-- Please adjust the date whenever revising the manpage. -->
- <!ENTITY dhdate "<date>January 23, 2010</date>">
- <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
- allowed: see man(7), man(1). -->
- <!ENTITY dhsection "<manvolnum>1</manvolnum>">
- <!ENTITY dhemail "<email>deb at zorglub.s.bawue.de</email>">
- <!ENTITY dhusername "Eric Lavarde">
- <!ENTITY dhucpackage "<refentrytitle>FREEPLANE</refentrytitle>">
- <!ENTITY dhpackage "freeplane">
-
- <!ENTITY debian "<productname>Debian</productname>">
- <!ENTITY gnu "<acronym>GNU</acronym>">
- <!ENTITY gpl "&gnu; <acronym>GPL</acronym>">
-]>
-
-<refentry>
- <refentryinfo>
- <address>
- &dhemail;
- </address>
- <author>
- &dhfirstname;
- &dhsurname;
- </author>
- <copyright>
- <year>2010</year>
- <holder>&dhusername;</holder>
- </copyright>
- &dhdate;
- </refentryinfo>
- <refmeta>
- &dhucpackage;
-
- &dhsection;
- </refmeta>
- <refnamediv>
- <refname>&dhpackage;</refname>
-
- <refpurpose>Program to create, edit, print and export Mind maps.</refpurpose>
- </refnamediv>
- <refsynopsisdiv>
- <cmdsynopsis>
- <command>&dhpackage;</command>
- </cmdsynopsis>
- </refsynopsisdiv>
- <refsect1>
- <title>DESCRIPTION</title>
-
- <para>This manual page documents briefly the
- <command>&dhpackage;</command> command.</para>
-
- <para>This manual page was written for the &debian; distribution
- because the original program does not have a manual page.
- Instead, it has documentation in the
- <application>Help</application> menu.</para>
-
- <para><command>&dhpackage;</command> is a program that allows
- you to create mind maps.</para>
-
- </refsect1>
- <refsect1>
- <title>OPTIONS</title>
-
- <para>No options, just start the program without any parameter.
- </para>
-
- </refsect1>
- <refsect1>
- <title>SEE ALSO</title>
-
- <para>Much documentation is available from the Freeplane wiki
- under http://freeplane.org/.</para>
-
- </refsect1>
-
- <refsect1>
- <title>AUTHOR</title>
-
- <para>This manual page was written by &dhusername; &dhemail; for
- the &debian; system (and may be used by others). Permission is
- granted to copy, distribute and/or modify this document under
- the terms of the &gnu; General Public License, Version 2 or any
- later version published by the Free Software Foundation.
- </para>
- <para>
- On Debian systems, the complete text of the GNU General Public
- License can be found in /usr/share/common-licenses/GPL.
- </para>
-
- </refsect1>
-</refentry>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:2
-sgml-indent-data:t
-sgml-parent-document:nil
-sgml-default-dtd-file:nil
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
--->
diff --git a/debian/rules b/debian/rules
index 2ac850b..aac174c 100755
--- a/debian/rules
+++ b/debian/rules
@@ -16,7 +16,13 @@ DEB_COMPRESS_EXCLUDE := .mm .pdf
DEB_DH_INSTALL_ARGS := -XLICENSE.txt
build:
- /usr/bin/docbook-to-man debian/freeplane.sgml > freeplane.1
+ xsltproc --nonet \
+ --param make.year.ranges 1 \
+ --param make.single.year.ranges 1 \
+ --param man.charmap.use.subset 0 \
+ http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl \
+ debian/freeplane.1.xml
+
convert freeplane_framework/script/freeplane.png freeplane.xpm
clean::
--
freeplane packaging
More information about the pkg-java-commits
mailing list