[system/khelpcenter] doc: doc: do not use a few deprecated entities

Luigi Toscano null at kde.org
Sun May 28 22:45:09 BST 2023


Git commit bb328a035fa996bcda10b115fd1650716c01f740 by Luigi Toscano.
Committed on 28/05/2023 at 20:53.
Pushed by ltoscano into branch 'master'.

doc: do not use a few deprecated entities

- &koffice; and &kword; can be safely replaced by &calligra; and
  &calligrawords;. The latters have been in KDocTools for a long
  time, for sure from 5.15.
- both &arts; and &DCOP; can be dropped: the glossary items
  do not use them at all anywway. So dropping the entites should help
  with consistency in case the translation uses a different spelling
  then the glossary one.

M  +1    -1    doc/fundamentals/tasks.docbook
M  +5    -5    doc/glossary/index.docbook

https://invent.kde.org/system/khelpcenter/-/commit/bb328a035fa996bcda10b115fd1650716c01f740

diff --git a/doc/fundamentals/tasks.docbook b/doc/fundamentals/tasks.docbook
index 19412873..dabcea67 100644
--- a/doc/fundamentals/tasks.docbook
+++ b/doc/fundamentals/tasks.docbook
@@ -664,7 +664,7 @@ writing parts of this section.</para>
 <title>Check Spelling</title>
 
 <para>&sonnet; is the spelling checker used by &kde; applications such as &kate;,
-&kmail;, and &kword;. It is a &GUI; frontend to various free spell checkers.</para>
+&kmail;, and &calligrawords;. It is a &GUI; frontend to various free spell checkers.</para>
 
 <para>To use &sonnet; you need to install a spell checker like
 <application>&GNU; Aspell</application>, <application>Enchant</application>,
diff --git a/doc/glossary/index.docbook b/doc/glossary/index.docbook
index b7f5d721..f880eb66 100644
--- a/doc/glossary/index.docbook
+++ b/doc/glossary/index.docbook
@@ -30,7 +30,7 @@ Project Neon
 				storage and retrieval system allows efficiency and extensibility not possible under &kde; 3, where each PIM component had 
 				its own system. Note that use of Akonadi does not change data storage formats (vcard, iCalendar, mbox, maildir etc.) - it 
 				just provides a new way of accessing and updating the data.&newpara;
-				The main reasons for design and development of Akonadi are of technical nature, ⪚ having a unique way to access PIM-data (contacts, calendars, emails..) from different applications (⪚ &kmail;, &kword; &etc;), thus eliminating the need to write similar code here and there.&newpara;
+				The main reasons for design and development of Akonadi are of technical nature, ⪚ having a unique way to access PIM-data (contacts, calendars, emails..) from different applications (⪚ &kmail;, &calligrawords; &etc;), thus eliminating the need to write similar code here and there.&newpara;
 				Another goal is to de-couple GUI applications like &kmail; from the direct access to external resources like mail-servers - which was a major reason for bug-reports/wishes with regard to performance/responsiveness in the past.&newpara;
 				More info:&newpara;
 				&linkstart;"https://community.kde.org/KDE_PIM/Akonadi"&linkmid;Akonadi for KDE's PIM&linkend;&newpara;
@@ -51,7 +51,7 @@ Project Neon
 			</glossdef>
 		</glossentry>
 		<glossentry id="gloss-arts"><!--remove it?-->
-			<glossterm>ARts</glossterm>
+			<glossterm>aRts</glossterm>
 			<glossdef><para>The sound framework in &kde; 2 and 3. Its single-tasking nature caused problems when two sources of sound were encountered. In the &plasma; desktop it is replaced by Phonon.&newpara;
 				More info:&newpara;
 				&linkstart;"https://en.wikipedia.org/wiki/ARts"&linkmid; Wikipedia: ARts&linkend;</para>
@@ -66,7 +66,7 @@ Project Neon
 				More info:&newpara;
 				&linkstart;"https://freedesktop.org/wiki/Software/dbus/"&linkmid;FreeDesktop.org: What is D-Bus?&linkend;&newpara;
 				&linkstart;"https://en.wikipedia.org/wiki/D-Bus"&linkmid;Wikipedia: D-Bus&linkend;</para>
-				<glossseealso otherterm="gloss-dcop">&DCOP;</glossseealso>
+				<glossseealso otherterm="gloss-dcop">DCOP</glossseealso>
 				<glossseealso otherterm="gloss-gnome">GNOME</glossseealso>
 				<glossseealso otherterm="gloss-kde">&kde;</glossseealso>
 				<glossseealso otherterm="gloss-qt">&Qt;</glossseealso>
@@ -83,7 +83,7 @@ Project Neon
 		</glossentry>
 		<glossentry id="gloss-flake">
 			<glossterm>Flake</glossterm>
-			<glossdef><para>Flake is a programming library to be used in &koffice;/Calligra. Functionally, it provides Shapes to display content and Tools to manipulate content. Shapes can be zoomed or rotated and can be grouped to work as a single Shape, around which text flow is possible.&newpara;
+			<glossdef><para>Flake is a programming library to be used in &calligra;. Functionally, it provides Shapes to display content and Tools to manipulate content. Shapes can be zoomed or rotated and can be grouped to work as a single Shape, around which text flow is possible.&newpara;
 				More info:&newpara;
 				&linkstart;"https://community.kde.org/Calligra/Libs/Flake"&linkmid;&kde; Community Wiki: Flake&linkend;</para>
 				<glossseealso otherterm="gloss-kde">&kde;</glossseealso>
@@ -187,7 +187,7 @@ otherterm="gloss-kbuildsycoca"><application>KBuildSycoca</application></glosssee
 				More info:&newpara;
 				&linkstart;"https://en.wikipedia.org/wiki/Phonon_(software)"&linkmid; Wikipedia: Phonon (software)&linkend;&newpara;
 				&linkstart;"https://phonon.kde.org/"&linkmid;Phonon website&linkend;</para>
-				<glossseealso otherterm="gloss-arts">&arts;</glossseealso>
+				<glossseealso otherterm="gloss-arts">aRts</glossseealso>
 				<glossseealso otherterm="gloss-kde">&kde;</glossseealso>
 			</glossdef>
 		</glossentry>


More information about the kde-doc-english mailing list