[plasma/plasma-desktop] doc: Documentation fixes: Use more entities, some punctuation
Antoni Bella Pérez
null at kde.org
Wed Oct 7 01:18:38 BST 2020
Git commit 044d75f15657d836ee243885a629b30e828b628a by Antoni Bella Pérez.
Committed on 06/10/2020 at 22:09.
Pushed by bellaperez into branch 'master'.
Documentation fixes: Use more entities, some punctuation
M +2 -3 doc/kcontrol/kcmaccess/index.docbook
M +1 -1 doc/kcontrol/kcmsmserver/index.docbook
M +2 -2 doc/kcontrol/keyboard/index.docbook
M +1 -1 doc/kcontrol/keys/index.docbook
M +1 -1 doc/kcontrol/solid-device-automounter/index.docbook
M +1 -1 doc/kcontrol/spellchecking/index.docbook
M +2 -2 doc/kfontview/index.docbook
M +3 -3 doc/knetattach/index.docbook
M +11 -11 doc/plasma-desktop/index.docbook
https://invent.kde.org/plasma/plasma-desktop/commit/044d75f15657d836ee243885a629b30e828b628a
diff --git a/doc/kcontrol/kcmaccess/index.docbook b/doc/kcontrol/kcmaccess/index.docbook
index 168743c0b..f952aab63 100644
--- a/doc/kcontrol/kcmaccess/index.docbook
+++ b/doc/kcontrol/kcmaccess/index.docbook
@@ -108,9 +108,8 @@ and <guilabel>Locking Keys</guilabel> to this panel.</para>
<para>
If this option is enabled, you can press and release the &Shift;,
&Alt; or &Ctrl; keys, and then press another key to get a key combo
-(example: <keycombo action="simul">&Ctrl; &Alt;
-<keycap>Del</keycap></keycombo> could be done with &Ctrl; then &Alt;
-then <keycap>Del</keycap>).
+(example: <keycombo action="simul">&Ctrl;&Alt;∇</keycombo> could
+be done with &Ctrl;, then &Alt; and then ∇).
</para>
<para>
diff --git a/doc/kcontrol/kcmsmserver/index.docbook b/doc/kcontrol/kcmsmserver/index.docbook
index 8379e4afa..028ebb11f 100644
--- a/doc/kcontrol/kcmsmserver/index.docbook
+++ b/doc/kcontrol/kcmsmserver/index.docbook
@@ -65,7 +65,7 @@ computer, or restarting the computer.</para>
<title>Default Leave Option</title>
<para>You can configure what should happen by default when you log out of
&plasma;. These options are not possible on all operating systems, and some of
-them may not appear unless you are using <application>SDDM</application> as your login manager.</para>
+them may not appear unless you are using &SDDM; as your login manager.</para>
<para>The options available are self explanatory, if you are in doubt,
leave the default settings. They are:</para>
diff --git a/doc/kcontrol/keyboard/index.docbook b/doc/kcontrol/keyboard/index.docbook
index 8fb38d7aa..281afc73e 100644
--- a/doc/kcontrol/keyboard/index.docbook
+++ b/doc/kcontrol/keyboard/index.docbook
@@ -44,7 +44,7 @@ system. </para>
<listitem>
<para>
Here you can set your keyboard model. This setting is independent of your
-keyboard layout and refers to the "hardware" model, i.e. the way your
+keyboard layout and refers to the "hardware" model, &ie; the way your
keyboard is manufactured. Modern keyboards that come with your computer usually
have two extra keys and are referred to as "104-key" models, which is
probably what you want if you do not know what kind of keyboard you have.
@@ -201,7 +201,7 @@ layouts (although the 4 spare layouts limit can be raised in the future).
you will then be able to set a few options regarding some special keys settings. You can
expand these options by clicking on the > symbol on the left of the option
then you choose your setting in the expanded list.</para>
-<para>This is a &GUI; to help creating custom keyboard layouts for X11 using XKB.
+<para>This is a &GUI; to help creating custom keyboard layouts for &X11; using XKB.
</para>
<para>For more information please refer to the <emphasis>Links</emphasis> section on the
<ulink url="https://www.freedesktop.org/wiki/Software/XKeyboardConfig">XKeyboardConfig
diff --git a/doc/kcontrol/keys/index.docbook b/doc/kcontrol/keys/index.docbook
index ece08aded..8dd813683 100644
--- a/doc/kcontrol/keys/index.docbook
+++ b/doc/kcontrol/keys/index.docbook
@@ -105,7 +105,7 @@ If an application has jumplist options they will be available as actions.
Scheme, set all shortcuts to none.</para>
<para>Global shortcuts can now be configured to jump to specific tasks within an application.</para>
-<para>By default you can open the application menu by just pressing the <keysym>Meta</keysym> key.
+<para>By default you can open the application menu by just pressing the &Meta; key.
</para>
</sect3>
diff --git a/doc/kcontrol/solid-device-automounter/index.docbook b/doc/kcontrol/solid-device-automounter/index.docbook
index d0400b42b..b5c1a9d67 100644
--- a/doc/kcontrol/solid-device-automounter/index.docbook
+++ b/doc/kcontrol/solid-device-automounter/index.docbook
@@ -50,7 +50,7 @@ manually mounted before</guilabel></term>
<listitem><para>
When this is checked, &plasma; will only automatically mount devices it
remembers. A device is <quote>remembered</quote> if it has ever been mounted before; ⪚
-plugging in a USB media player to charge is not sufficient to <quote>remember</quote> it.
+plugging in a &USB; media player to charge is not sufficient to <quote>remember</quote> it.
If the files are not accessed, &plasma;
will not automatically mount the player next time it is seen. Once they have
been accessed, however, &plasma; will remember to automatically make the contents
diff --git a/doc/kcontrol/spellchecking/index.docbook b/doc/kcontrol/spellchecking/index.docbook
index 7bed948c4..138d4a1a5 100644
--- a/doc/kcontrol/spellchecking/index.docbook
+++ b/doc/kcontrol/spellchecking/index.docbook
@@ -33,7 +33,7 @@
applications that use &sonnet;, which is a frontend to various free spell checkers.</para>
<para>To use &sonnet; you need to install spell checkers like ⪚
-<ulink url="http://aspell.net/">GNU Aspell</ulink>,
+<ulink url="http://aspell.net/">&GNU; Aspell</ulink>,
<ulink url="http://hspell.ivrix.org.il/">Hspell</ulink> or
<ulink url="https://hunspell.github.io/">Hunspell</ulink>
and additionally the corresponding dictionaries for your language.</para>
diff --git a/doc/kfontview/index.docbook b/doc/kfontview/index.docbook
index d7d6797dc..664abc90a 100644
--- a/doc/kfontview/index.docbook
+++ b/doc/kfontview/index.docbook
@@ -28,9 +28,9 @@
<para>
&kfontview; is an application to view and install different types of fonts:
<itemizedlist>
-<listitem><para>TrueType (<filename class="extension">.ttf</filename>)</para></listitem>
+<listitem><para>&TrueType; (<filename class="extension">.ttf</filename>)</para></listitem>
<listitem><para>OpenType (<filename class="extension">otf</filename>, <filename class="extension">.ttf</filename>)</para></listitem>
-<listitem><para>Postscript type 1 (file extension on &Windows; & OS/2 <filename class="extension">.pfb</filename>/<filename class="extension">.pfm</filename>; on &UNIX;/&Linux; <filename class="extension">.pfa</filename>/<filename class="extension">.afm</filename>)</para></listitem>
+<listitem><para>&PostScript; type 1 (file extension on &Windows; & OS/2 <filename class="extension">.pfb</filename>/<filename class="extension">.pfm</filename>; on &UNIX;/&Linux; <filename class="extension">.pfa</filename>/<filename class="extension">.afm</filename>)</para></listitem>
<listitem><para>BDF (Bitmap Distribution Format, file extension <filename class="extension">.bdf</filename>)</para></listitem>
<listitem><para>PCF (Portable Compiled Format, file extension <filename class="extension">.pcf</filename>)</para></listitem>
</itemizedlist>
diff --git a/doc/knetattach/index.docbook b/doc/knetattach/index.docbook
index 9ceb9137b..640b71e46 100644
--- a/doc/knetattach/index.docbook
+++ b/doc/knetattach/index.docbook
@@ -83,7 +83,7 @@ feature requests for it to the &kde; bugs website.
<para>
As you will see in the screenshot below, the Network Folder Wizard currently
allows you to add four types of network folders: WebDav, &FTP;,
-&Microsoft; &Windows; (Samba) network drives and SSH.
+&Microsoft; &Windows; (&Samba;) network drives and SSH.
Additionally you can select a recent connection for the list box.
<screenshot>
@@ -140,7 +140,7 @@ login password for the network share you've chosen to access.
<para>
Below is a list of the information needed by the wizard to create the network
folders. If an option is not
-available for a particular folder it does not have to be entered. The Samba
+available for a particular folder it does not have to be entered. The &Samba;
folders ⪚ do not require a <guilabel>Port</guilabel> entry.
</para>
@@ -180,7 +180,7 @@ Here you enter the port number you wish to connect to. The defaults are usually
sufficient.
<note>
<para>
-Not available for &Microsoft; &Windows; (Samba) folders.
+Not available for &Microsoft; &Windows; (&Samba;) folders.
</para>
</note>
</para>
diff --git a/doc/plasma-desktop/index.docbook b/doc/plasma-desktop/index.docbook
index 646911886..7139cf96a 100644
--- a/doc/plasma-desktop/index.docbook
+++ b/doc/plasma-desktop/index.docbook
@@ -57,7 +57,7 @@
<para><!--https://www.kde.org/workspaces/-->
&plasma; provides a modern and customizable environment for running your favorite applications
and accessing your information wherever it may be. Other common attributes of the &plasma; Desktop
-include advanced window management and desktop effects, support for KDE Plasma Widgets,
+include advanced window management and desktop effects, support for &kde; &plasma; Widgets,
integrated search, hardware management and a high degree of customizability.
</para>
@@ -288,7 +288,7 @@ where you can set entries to display and their visibility.
<para>
An icon located usually in the system tray is the <application>Device Notifier</application>.
-Plug in a <acronym>USB</acronym> disk and a dialog will open that allows you to
+Plug in a &USB; disk and a dialog will open that allows you to
open the device in &dolphin; or another associated application.
</para>
<para>
@@ -304,7 +304,7 @@ open the device in &dolphin; or another associated application.
</mediaobject>
</screenshot>
</para>
-<para>The <application>Device Notifier</application> is used for handling pluggable devices such as <acronym>USB</acronym> pendrives (also called flash drives or thumb drives), digital cameras, external <acronym>USB</acronym> hard drives, &etc; It also comes into play when a medium such as a &CD; or DVD is loaded into an optical drive.
+<para>The <application>Device Notifier</application> is used for handling pluggable devices such as &USB; pendrives (also called flash drives or thumb drives), digital cameras, external &USB; hard drives, &etc; It also comes into play when a medium such as a &CD; or DVD is loaded into an optical drive.
</para>
<para>When you plug in an external device, or load a new medium into a drive, the <guilabel>Notifier</guilabel> window pops up (you can also open it explicitly by clicking on its Panel icon.) It stays open while the cursor is over it, otherwise it hides itself after a few seconds.
</para>
@@ -527,7 +527,7 @@ you can use one Folder View as the whole desktop, effectively replicating the "o
&krunner; is a versatile mini command-line. You can use it to start applications,
open web pages, access bookmarks, search through your desktop data, calculate
short equations, and many more. Pressing <keycombo
-action="simul">&Alt;<keysym>Space</keysym></keycombo> or <keycombo
+action="simul">&Alt;&Space;</keycombo> or <keycombo
action="simul">&Alt;<keysym>F2</keysym></keycombo> opens the &krunner; dialog.
You just start typing and &krunner; will start searching matches as soon as
you've entered more than two characters. You can open the settings dialog to
@@ -549,7 +549,7 @@ navigate through the matches using the tab and arrow keys.
<para>Use the <inlinemediaobject><imageobject><imagedata fileref="krunner-configure.png" format="PNG"/>
</imageobject></inlinemediaobject> button to open the <guilabel>KRunner</guilabel> &systemsettings;
-module and configure where and what to search for in &krunner;
+module and configure where and what to search for in &krunner;.
</para>
<para>&krunner; supports <quote>Desktop Actions</quote> which are additional actions an application can
@@ -571,7 +571,7 @@ provided by &spectacle;:
</mediaobject>
</screenshot>
-<para>If you press the <keysym>Down</keysym> key in an empty &krunner; a history of the recent entities
+<para>If you press the &Down; key in an empty &krunner; a history of the recent entities
is shown. After invoking a search result, its query will move to the top, so repeatedly used
commands never fall out of the list.
</para>
@@ -647,12 +647,12 @@ means: Press &Alt; and <keycap>D</keycap>, release and press <keycap>A</keycap>.
</varlistentry>
<varlistentry>
-<term><keycombo action="simul"><keysym>Meta</keysym><keycap>=</keycap></keycombo></term>
+<term><keycombo action="simul">&Meta;<keycap>=</keycap></keycombo></term>
<listitem><para>Zoom out</para></listitem>
</varlistentry>
<varlistentry>
-<term><keycombo action="simul"><keysym>Meta</keysym><keycap>-</keycap></keycombo></term>
+<term><keycombo action="simul">&Meta;<keycap>-</keycap></keycombo></term>
<listitem><para>Zoom in</para></listitem>
</varlistentry>
@@ -687,12 +687,12 @@ means: Press &Alt; and <keycap>D</keycap>, release and press <keycap>A</keycap>.
</varlistentry>
<varlistentry>
-<term><keycombo action="simul"><keycap>Meta</keycap> </keycombo></term>
+<term><keycombo action="simul">&Meta; </keycombo></term>
<listitem><para>Next Activity</para></listitem>
</varlistentry>
<varlistentry>
-<term><keycombo action="simul"><keycap>Meta</keycap>&Shift; </keycombo></term>
+<term><keycombo action="simul">&Meta;&Shift; </keycombo></term>
<listitem><para>Previous Activity</para></listitem>
</varlistentry>
@@ -707,7 +707,7 @@ means: Press &Alt; and <keycap>D</keycap>, release and press <keycap>A</keycap>.
</varlistentry>
<varlistentry>
-<term><keycombo action="simul"><keysym>Meta</keysym> </keycombo></term>
+<term><keycombo action="simul">&Meta; </keycombo></term>
<listitem><para>Open the Activities panel</para></listitem>
</varlistentry>
More information about the kde-doc-english
mailing list