[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-doc-english
Subject:    =?utf-8?q?=5Bsystem/khelpcenter/kf6=5D_doc=3A_doc=3A_do_not_use_a_few_deprecated_entities?=
From:       Luigi Toscano <null () kde ! org>
Date:       2023-05-28 21:58:45
Message-ID: 20230528215845.AEC181240B06 () leptone ! kde ! org
[Download RAW message or body]

Git commit 3db5afebf3a83b1881e9344f68d9825392e88612 by Luigi Toscano.
Committed on 28/05/2023 at 21:58.
Pushed by ltoscano into branch 'kf6'.

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.

(cherry picked from commit bb328a035fa996bcda10b115fd1650716c01f740)

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

https://invent.kde.org/system/khelpcenter/-/commit/3db5afebf3a83b1881e9344f68d9825392e88612


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, \
&eg; having a unique way to access PIM-data (contacts, calendars, emails..) from \
different applications (&eg; &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, &eg; having a unique way to access \
PIM-data (contacts, calendars, emails..) from different applications (&eg; &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>


[prev in list] [next in list] [prev in thread] [next in thread]