[kde-doc-english] [kmplot] doc: Update KmPlot handbook to 16.04
Burkhard Lück
lueck at hube-lueck.de
Sat Jun 18 12:13:50 UTC 2016
Git commit 77909322194eeb14bbe69759059c29d884f9ecc1 by Burkhard Lück.
Committed on 18/06/2016 at 12:13.
Pushed by lueck into branch 'master'.
Update KmPlot handbook to 16.04
remove entity package kdeedu + kappname
bump date + releaseinfo
remove chapter developers + appendix
rename chapter dcop to dbus
update man page to kf5
delete unused screenshots
REVIEW:127867
D +- -- doc/edu-logo.png
M +9 -79 doc/index.docbook
D +- -- doc/kfkt.png
D +- -- doc/ksys1.png
D +- -- doc/ksys2.png
D +- -- doc/ksys3.png
M +12 -10 doc/man-kmplot.1.docbook
http://commits.kde.org/kmplot/77909322194eeb14bbe69759059c29d884f9ecc1
diff --git a/doc/edu-logo.png b/doc/edu-logo.png
deleted file mode 100644
index 2e6d5d8..0000000
Binary files a/doc/edu-logo.png and /dev/null differ
diff --git a/doc/index.docbook b/doc/index.docbook
index 8e8d465..590e3d5 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -1,11 +1,8 @@
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
- <!ENTITY kappname "&kmplot;"><!-- replace kmplot here -->
- <!ENTITY package "kdeedu">
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE"><!-- change language only here -->
]>
-<!-- The language must NOT be changed here. -->
<book id="kmplot" lang="&language;">
@@ -46,14 +43,13 @@
<legalnotice>&FDLNotice;</legalnotice>
-<date>2013-08-23</date>
-<releaseinfo>1.2.1 (&kde; 4.11)</releaseinfo>
+<date>2016-05-08</date>
+<releaseinfo>1.2.1 (Applications 16.04)</releaseinfo>
<!-- Abstract about this handbook -->
<abstract>
-<para>&kmplot; is a mathematical function plotter for the &kde;
-Desktop.</para>
+<para>&kmplot; is a mathematical function plotter by &kde;.</para>
<para> <inlinemediaobject><imageobject><imagedata
fileref="edu-logo.png"
format="PNG"/></imageobject></inlinemediaobject> &kmplot; is part of
@@ -65,7 +61,7 @@ url="http://edu.kde.org/">http://edu.kde.org/</ulink></para></abstract>
<keyword>KDE</keyword>
<keyword>KmPlot</keyword>
<keyword>EDU</keyword>
-<keyword>edutainment</keyword>
+<keyword>education</keyword>
<keyword>plotting</keyword>
<keyword>math</keyword>
</keywordset>
@@ -75,8 +71,8 @@ url="http://edu.kde.org/">http://edu.kde.org/</ulink></para></abstract>
<chapter id="introduction">
<title>Introduction</title>
-<para>&kmplot; is a mathematical function plotter for the &kde;
- Desktop. It has a powerful built-in parser. You can plot different
+<para>&kmplot; is a mathematical function plotter by &kde;.
+ It has a powerful built-in parser. You can plot different
functions simultaneously and combine them to build new
functions.</para>
@@ -658,21 +654,6 @@ url="http://edu.kde.org/">http://edu.kde.org/</ulink></para></abstract>
<chapter id="reference">
<title>&kmplot; Reference</title>
-<!--
- <mediaobject>
- <imageobject>
- <imagedata fileref="kfkt.png" format="PNG"/>
- </imageobject>
- </mediaobject>
-
- <para>This menu entry or toolbar button opens the Functions Editor. Here
- you can enter up to 10 functions or
- function groups. The parser knows <firstterm>explicit</firstterm> and
- <firstterm>parametric</firstterm> form. With specific extensions it
- is possible to add first and second derivatives and to choose values
- for the function group parameter.</para>
- -->
-
<sect1 id="func-syntax">
<title>Function Syntax</title>
@@ -908,7 +889,7 @@ url="http://edu.kde.org/">http://edu.kde.org/</ulink></para></abstract>
</sect2>
</sect1>
-<sect1 id="func-extension">
+<sect1 id="func-extension"> <!--FIXME does this still work-->
<title>Extensions</title>
<para>An extension for a function is specified by entering a semicolon,
followed by the extension, after the function definition. The extension can be entered by using the &DBus; method parser addFunction. None of the extensions are available
@@ -1052,30 +1033,6 @@ for parametric functions but N and D[a,b] work for polar functions too. For exam
</para>
</sect1>
-<!--
-<sect1 id="coord-system">
- <title>Coordinate Systems</title>
-
- <para><inlinemediaobject>
- <imageobject>
- <imagedata fileref="ksys1.png" format="PNG"/>
- </imageobject>
- </inlinemediaobject></para>
-
- <para>
- <inlinemediaobject>
- <imageobject>
- <imagedata fileref="ksys2.png" format="PNG"/>
- </imageobject>
- </inlinemediaobject></para>
-
- <para>
- <inlinemediaobject>
- <imageobject>
- <imagedata fileref="ksys3.png" format="PNG"/>
- </imageobject>
- </inlinemediaobject></para>
- -->
<sect1 id="coord-area"><title>Plotting Area</title>
<para>
By default, explicitly given functions are plotted for the whole of the visible part of the
@@ -1399,12 +1356,11 @@ chapter of the &kde; Fundamentals documentation &kmplot; has these application s
</sect2>
</sect1>
-
</chapter>
-<chapter id="dcop">
+<chapter id="dbus">
<title>Scripting &kmplot;</title>
- <para>A new feature in &kde; 3.4 is that you can write scripts for &kmplot; using &DBus; in &kde; 4. For example, if you want to define a new function <userinput>f(x)=2sin x+3cos
+ <para>You can write scripts for &kmplot; using &DBus;. For example, if you want to define a new function <userinput>f(x)=2sin x+3cos
x</userinput>, set its line width to 20 and then draw it, you type in a console:</para>
<para><command>qdbus org.kde.kmplot-PID /parser org.kde.kmplot.Parser.addFunction "f(x)=2sin x+3cos x" ""</command>
As a result, the new function's id number will be returned, or -1 if the function could not be defined.</para>
@@ -1829,13 +1785,6 @@ x</userinput>, set its line width to 20 and then draw it, you type in a console:
</para>
</chapter>
-<chapter id="developers">
-<title>Developer's Guide to &kmplot;</title>
-
-<para>If you want to contribute to &kmplot; feel free to send a mail to
-&Klaus-Dieter.Moeller.mail;, <email>f_edemar at linux.se</email> or <email>david at bluehaze.org</email>. </para>
-</chapter>
-
<chapter id="credits">
<title>Credits and License</title>
@@ -1878,25 +1827,6 @@ Documentation copyright 2000--2002 by Klaus-Dieter Möller &Klaus-Dieter.Moe
</chapter>
-<appendix id="installation">
-<title>Installation</title>
-
-&install.intro.documentation;
-
-<mediaobject>
-<imageobject>
-<imagedata fileref="edu-logo.png" format="PNG"/>
-</imageobject>
-</mediaobject>
-
-<para>&kmplot; itself can be found on the <ulink
-url="http://edu.kde.org/kmplot">&kmplot; home page</ulink> and
-is part of the &kde;-Edu project</para>
-
-&install.compile.documentation;
-
-</appendix>
-
&documentation.index;
</book>
<!--
diff --git a/doc/kfkt.png b/doc/kfkt.png
deleted file mode 100644
index 3c094b1..0000000
Binary files a/doc/kfkt.png and /dev/null differ
diff --git a/doc/ksys1.png b/doc/ksys1.png
deleted file mode 100644
index b3d74c1..0000000
Binary files a/doc/ksys1.png and /dev/null differ
diff --git a/doc/ksys2.png b/doc/ksys2.png
deleted file mode 100644
index 5df65a9..0000000
Binary files a/doc/ksys2.png and /dev/null differ
diff --git a/doc/ksys3.png b/doc/ksys3.png
deleted file mode 100644
index f4c10f5..0000000
Binary files a/doc/ksys3.png and /dev/null differ
diff --git a/doc/man-kmplot.1.docbook b/doc/man-kmplot.1.docbook
index da16eeb..2fcee15 100644
--- a/doc/man-kmplot.1.docbook
+++ b/doc/man-kmplot.1.docbook
@@ -5,14 +5,15 @@
<refentry lang="&language;">
<refentryinfo>
-<title>&kde; User's Manual</title>
+<title>&kmplot; User's Manual</title>
<author><personname>
<firstname>Ben</firstname>
<surname>Burton</surname>
</personname>
<email>bab at debian.org</email></author>
-<date>2010-10-06</date>
-<productname>K Desktop Environment</productname>
+<date>2016-05-08</date>
+<releaseinfo>1.2.1 (Applications 16.04)</releaseinfo>
+<productname>KDE Applications</productname>
</refentryinfo>
<refmeta>
@@ -30,14 +31,12 @@
<command>kmplot</command>
<group choice="opt"><option>-f, --function <replaceable>argument</replaceable></option></group>
<group choice="opt"><option><replaceable>file</replaceable></option></group>
-<arg choice="opt">&kde; Generic Options</arg>
-<arg choice="opt">&Qt; Generic Options</arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
-<para>&kmplot; is a mathematical function plotter for &kde;. It has a powerful built-in parser. You can plot different functions simultaneously and combine them to build new functions.</para><para>&kmplot; supports parametric functions and functions in polar coordinates. Several grid modes are supported. Plots may be printed with high precision in the correct scale.</para><para>&kmplot; also provides some numerical and visual features, like filling and calculating the area between the plot and the first axis, finding maximum and minimum values, changing function parameters dynamically and plotting derivatives and integral functions.</para><para>&kmplot; is part of the &kde; edutainment module.</para>
+<para>&kmplot; is a mathematical function plotter by &kde;. It has a powerful built-in parser. You can plot different functions simultaneously and combine them to build new functions.</para><para>&kmplot; supports parametric functions and functions in polar coordinates. Several grid modes are supported. Plots may be printed with high precision in the correct scale.</para><para>&kmplot; also provides some numerical and visual features, like filling and calculating the area between the plot and the first axis, finding maximum and minimum values, changing function parameters dynamically and plotting derivatives and integral functions.</para><para>&kmplot; is part of the &kde; Education module.</para>
</refsect1>
<refsect1>
@@ -52,13 +51,16 @@
<refsect1>
<title>See Also</title>
-<para>More detailed user documentation is available from <ulink
+<simplelist>
+<member>More detailed user documentation is available from <ulink
url="help:/kmplot">help:/kmplot</ulink>
(either enter this <acronym>URL</acronym> into &konqueror;, or run
<userinput><command>khelpcenter</command>
-<parameter>help:/kmplot</parameter></userinput>).</para>
-
-<para>There is also further information available at <ulink url="http://edu.kde.org/kmplot/">the &kde; edutainment website</ulink>.</para>
+<parameter>help:/kmplot</parameter></userinput>).</member>
+<member>There is also further information available at <ulink url="http://edu.kde.org/kmplot/">the &kde; Education website</ulink>.</member>
+<member>kf5options(1)</member>
+<member>qt5options(1)</member>
+</simplelist>
</refsect1>
<refsect1>
More information about the kde-doc-english
mailing list