[kde-doc-english] [kde-baseapps/frameworks] /: Documentation update and cleanup (mostly metadata)

Luigi Toscano luigi.toscano at tiscali.it
Sun Sep 27 23:27:45 UTC 2015


Git commit bd31d7751cc693fd684ff2ee63b72301e59cc897 by Luigi Toscano.
Committed on 27/09/2015 at 23:20.
Pushed by ltoscano into branch 'frameworks'.

Documentation update and cleanup (mostly metadata)

Common:
- bump the remaining old DTDs to the current version;
- update product names and releases (with few exceptions);
- improve wording to match the community status ("by KDE" instead of
  "for KDE").

Documentation:
- remove "installation" section when available (as for the new convention);
- remove obsolete 'package' entity when defined.

Man pages:
- remove "K Desktop Environment";
- cleanup old option references in man.

Note: the kdepasswd documentation is about the now disabled "Password and
User Account" KCM, still available in plasma-desktop sources but probably
meant to be replaced by user-manager. So the document should be either
moved to plasma-desktop or removed if the modules is removed.

M  +0    -17   doc/konqueror/index.docbook
M  +3    -3    doc/konqueror/man-kbookmarkmerger.1.docbook
M  +2    -2    kdepasswd/docs/index.docbook
M  +4    -33   kfind/docs/index.docbook
M  +7    -7    kfind/docs/man-kfind.1.docbook

http://commits.kde.org/kde-baseapps/bd31d7751cc693fd684ff2ee63b72301e59cc897

diff --git a/doc/konqueror/index.docbook b/doc/konqueror/index.docbook
index 1f46658..2c9919a 100644
--- a/doc/konqueror/index.docbook
+++ b/doc/konqueror/index.docbook
@@ -4925,23 +4925,6 @@ to applet support)</para></listitem>
 
 </chapter>
 
-<appendix id="installation">
-<title>Installation</title>
-
-<para>&konqueror; is part of the kdebase package which is an essential part of
-&kde;.</para>
-
-<para>For instructions on acquiring &kde; please see <ulink
-url="http://www.kde.org">http://www.kde.org</ulink>.</para>
-
-<para>For further information about &konqueror; you might like to visit 
-<ulink url="http://www.konqueror.org">http://www.konqueror.org</ulink>.</para>
-
-
-<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
-&underFDL;
-</appendix>
-
 &documentation.index; 
 </book>
 
diff --git a/doc/konqueror/man-kbookmarkmerger.1.docbook b/doc/konqueror/man-kbookmarkmerger.1.docbook
index dab8905..9364bad 100644
--- a/doc/konqueror/man-kbookmarkmerger.1.docbook
+++ b/doc/konqueror/man-kbookmarkmerger.1.docbook
@@ -1,19 +1,19 @@
 <?xml version="1.0" ?>
 <!-- vim:set ts=4 noet syntax=xml: -->
-<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
 <!ENTITY % English "INCLUDE">
 <!ENTITY kbookmarkmerger "<command>kbookmarkmerger</command>">
 ]>
 
 <refentry lang="&language;">
 <refentryinfo>
-	<title>KDE User's Manual</title>
+	<title>kbookmarkmerger User's Manual</title>
 	<author>
 		&Frerich.Raabe;
 		&Frerich.Raabe.mail;
 	</author>
 	<date>February 1st, 2005</date>
-	<productname>K Desktop Environment</productname>
+	<productname>kbookmarkmerger</productname>
 </refentryinfo>
 
 <refmeta>
diff --git a/kdepasswd/docs/index.docbook b/kdepasswd/docs/index.docbook
index 2ecef47..557f458 100644
--- a/kdepasswd/docs/index.docbook
+++ b/kdepasswd/docs/index.docbook
@@ -1,6 +1,6 @@
 <?xml version="1.0" ?>
-<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
-"dtd/kdex.dtd" [
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
+"dtd/kdedbx45.dtd" [
   <!ENTITY % addindex "IGNORE">
   <!ENTITY % English "INCLUDE">
 ]>
diff --git a/kfind/docs/index.docbook b/kfind/docs/index.docbook
index d8f53b1..5b84f68 100644
--- a/kfind/docs/index.docbook
+++ b/kfind/docs/index.docbook
@@ -1,7 +1,6 @@
 <?xml version="1.0" ?>
 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
   <!ENTITY kappname "&kfind;">
-  <!ENTITY package "kdebase">
   <!ENTITY % addindex "IGNORE">
   <!ENTITY % English "INCLUDE"> 
 ]>
@@ -25,12 +24,12 @@
 
 <legalnotice>&FDLNotice;</legalnotice>
 
-<date>2013-05-29</date>
-<releaseinfo>&kde; 4.11</releaseinfo>
+<date>2015-09-28</date>
+<releaseinfo>Applications 15.08</releaseinfo>
 
 <abstract>
 <para>
-&kfind; is &kde;'s file find utility.
+&kfind; is a file find utility by &kde;.
 </para>
 </abstract>
 
@@ -47,7 +46,7 @@
 <title>Introduction</title>
 
 <para>
-&kfind; is the &kde; file find utility.
+&kfind; is a file find utility by &kde;.
 </para>
 
 <sect1 id="starting">
@@ -365,34 +364,6 @@ Documentation copyright 2001 &Dirk.Doerflinger;
 
 </chapter>
 
-<appendix id="installation">
-<title>Installation</title>
-
-<sect1 id="getting-kfind">
-<title>How to obtain &kfind;</title>
-
-&install.intro.documentation;
-
-</sect1>
-
-<sect1 id="requirements">
-<title>Requirements</title>
-
-<para>
-In order to successfully use &kfind;, you need &kde; 4.x.
-</para>
-
-</sect1>
-
-<sect1 id="compilation">
-<title>Compilation and Installation</title>
-
-&install.compile.documentation;
-
-</sect1>
-
-</appendix>
-
 &documentation.index;
 
 </book>
diff --git a/kfind/docs/man-kfind.1.docbook b/kfind/docs/man-kfind.1.docbook
index ef2eb3b..31222ea 100644
--- a/kfind/docs/man-kfind.1.docbook
+++ b/kfind/docs/man-kfind.1.docbook
@@ -1,14 +1,15 @@
 <?xml version="1.0" ?>
-<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
 <!ENTITY % English "INCLUDE">
 ]>
 
 <refentry lang="&language;">
 <refentryinfo>
-<title>KDE User's Manual</title>
+<title>kfind User's Manual</title>
 <author>&Lauri.Watts; &Lauri.Watts.mail;</author>
-<date>2010-10-06</date>
-<productname>K Desktop Environment</productname>
+<date>2015-09-28</date>
+<releaseinfo>Applications 15.08</releaseinfo>
+<productname>KDE Applications</productname>
 </refentryinfo>
 
 <refmeta>
@@ -18,15 +19,14 @@
 
 <refnamediv>
 <refname><command>kfind</command></refname>
-<refpurpose>file find utility for &kde;</refpurpose>
+<refpurpose>file find utility by &kde;</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
 <cmdsynopsis>
 <command>kfind</command>
 <group choice="opt"><option>searchpath</option></group>
-<arg choice="opt">KDE Generic Options</arg>
-<arg choice="opt">Qt Generic Options</arg>
+<arg choice="opt">options</arg>
 </cmdsynopsis>
 </refsynopsisdiv>
 


More information about the kde-doc-english mailing list