[kde-doc-english] [konversation/1.5] doc: Fix some issues in Konversation docs

Burkhard Lück lueck at hube-lueck.de
Sat Sep 28 12:49:07 UTC 2013


Git commit 9a61c52e2a36fcf2e479e699a04813a6fd390fcc by Burkhard Lück, on behalf of Antoni Bella Pérez.
Committed on 23/09/2013 at 19:20.
Pushed by lueck into branch '1.5'.

Fix some issues in Konversation docs
(cherry picked from commit 9de309db431c5315560e6b0da17cb5b21d06b2e4)
backport from master

M  +47   -41   doc/index.docbook

http://commits.kde.org/konversation/9a61c52e2a36fcf2e479e699a04813a6fd390fcc

diff --git a/doc/index.docbook b/doc/index.docbook
index 7dee3c5..7bb8984 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -171,7 +171,7 @@ revision history. (see installation appendix comment) -->
 <itemizedlist>
 <listitem><para>SSL support.</para></listitem>
 <listitem><para>User-friendly tabbed interface.</para></listitem>
-<listitem><para>Customizable Quick Buttons for often-used commands</para></listitem>
+<listitem><para>Customizable Quick Buttons for often-used commands.</para></listitem>
 <listitem><para>Automatic reconnect and rejoin.</para></listitem>
 <listitem><para>DCC send and receive.</para></listitem>
 <listitem><para>&Nickname; watch list.</para></listitem>
@@ -194,7 +194,7 @@ regular expression pattern.</para></listitem>
 <para>The &konversation; website is
 <ulink url="&konviwebsite;">&konviwebsite;</ulink>.
 Further information like a FAQ and tips and tricks you find in the 
-<ulink url="http://konversation.kde.org/wiki/Main_Page">&konversation; Wiki</ulink>
+<ulink url="http://konversation.kde.org/wiki/Main_Page">&konversation; Wiki</ulink>.
 </para>
 
 <para>Developers for &konversation; can often be contacted via &irc; at  <ulink url="irc://chat.freenode.net/konversation">irc.freenode.net channel #konversation</ulink>.
@@ -374,11 +374,11 @@ the Input Line.  (The <userinput>#</userinput> is required.) You may also type <
 <para>
 <calloutlist>
 <callout arearefs="pt-identity-gen-1"><para>Click here to select an <guilabel>Identity</guilabel> to edit.</para></callout>
-<callout arearefs="pt-identity-gen-2"><para>Use these buttons to add,
-duplicate, rename, or remove an <guilabel>Identity</guilabel>.</para></callout>
+<callout arearefs="pt-identity-gen-2"><para>Use these buttons to <guibutton>Add</guibutton>,
+<guibutton>Duplicate</guibutton>, <guibutton>Rename</guibutton>, or <guibutton>Remove</guibutton> an <guilabel>Identity</guilabel>.</para></callout>
 <callout arearefs="pt-identity-gen-3"><para>Enter your real name here.  &irc; is not intended to keep you hidden from your friends or enemies. Keep this in mind if you are tempted to behave maliciously. A fake "real name" can be a good way to mask your gender from all the nerds out there, but the PC you use can always be traced so you will never be truly anonymous.</para></callout>
 <callout arearefs="pt-identity-gen-4"><para>Use these buttons to
-<guibutton>Add</guibutton> or <guilabel>Remove</guilabel> a &nickname;.</para></callout>
+<guibutton>Add</guibutton> or <guibutton>Remove</guibutton> a &nickname;.</para></callout>
 <callout arearefs="pt-identity-gen-5"><para>This is your list of &nickname;s.
 A &nickname; is the name that other users will know you by.
 You may use any name you desire.  The first character must be a letter.  Other characters may be letters, numbers, or the special characters <literal>-[]\`_^{}|</literal>.</para>
@@ -390,7 +390,7 @@ You may use any name you desire.  The first character must be a letter.  Other c
 According to RFC 2812, the maximum &nickname; length is 9, but
 this is actually determined by the server.  To determine the maximum for a server, connect to the server.  In the
 <interface>Server Messages</interface> tab, look for a <computeroutput>[Support]</computeroutput> message.
-For example</para>
+For example:</para>
 
 <para>
 <computeroutput>
@@ -595,8 +595,8 @@ and the <guilabel>Channels</guilabel> automatically joined when connected.
 If you have specified a group for your networks, networks are listed
 indented under the group.  Click on a network to select it.
 </para></callout>
-<callout arearefs="pt-serverlist-2"><para>Use these buttons to add a 
-<guibutton>New</guibutton> network, <guibutton>Edit</guibutton>
+<callout arearefs="pt-serverlist-2"><para>Use these buttons to <guibutton>Add</guibutton> a
+new network, <guibutton>Edit</guibutton>
 a highlighted network, or <guibutton>Delete</guibutton> a highlighted network.
 </para></callout>
 <callout arearefs="pt-serverlist-3"><para>Click this button to connect
@@ -698,7 +698,7 @@ correctly.</para>
 
 <anchor id="serverlist-addserver" />
 
-<para>When you click the <guibutton>Add</guibutton> button in the <guilabel>Servers</guilabel> frame, the Add Server screen appears.</para>
+<para>When you click the <guibutton>Add</guibutton> button in the <guilabel>Servers</guilabel> frame, the <guilabel>Add Server</guilabel> screen appears.</para>
 
 <para>
 <screenshot>
@@ -941,7 +941,7 @@ Channel
 <listitem>
 <para><inlinemediaobject><imageobject><imagedata fileref="led_blue_on.png" format="PNG"  /></imageobject></inlinemediaobject>
 <interface>Server Messages</interface>, <link linkend="list-channels">Channel List</link>, or
-<link linkend="urlcatcher">&URL; catcher</link>
+<link linkend="urlcatcher">&URL; catcher</link>.
 </para>
 </listitem>
 <listitem>
@@ -964,7 +964,7 @@ Channel
 	<guisubmenu>Settings</guisubmenu>
 	<guisubmenu>Configure Konversation</guisubmenu>
 </menuchoice> from the main menu, expand <guilabel>Interface</guilabel>,
-click on <guilabel>Chat Window</guilabel>, and uncheck <guilabel>Show box to change own nickname</guilabel>.
+click on <guilabel>Chat Window</guilabel>, and uncheck <guilabel>Show box to change own nickname</guilabel> box.
 </para></callout>
 
 <callout arearefs="pt-channeltour-6"><para>The channel topic is displayed here.
@@ -1061,15 +1061,20 @@ You can customize their definitions to whatever commands you wish.</para></callo
 </calloutlist>
 </para>
 
-<para><emphasis>Note </emphasis>You can control how messages are displayed in the
+<note>
+<para>
+You can control how messages are displayed in the
 message scroll of channel and query tabs.  For example, you can change the color
 of messages, play a sound when a message containing a string
 is received, or automatically reply to messages.
 See <link linkend="highlighting">
 Message highlighting</link> for more information.
 </para>
+</note>
 
-<para><emphasis>Note: </emphasis>Channel names sometimes begin with <userinput>&</userinput>, <userinput>+</userinput>,
+<note>
+<para>
+Channel names sometimes begin with <userinput>&</userinput>, <userinput>+</userinput>,
 or <userinput>!</userinput>.  The first character of a channel name determines the type of channel (RFC 2811) as follows:
 <itemizedlist>
 <listitem><para>
@@ -1089,6 +1094,7 @@ or <userinput>!</userinput>.  The first character of a channel name determines t
 </itemizedlist>
 Channel names are up to 50 characters long and may contain any characters except for space, comma, and Ctrl-G (^G or ASCII 7).
 </para>
+</note>
 
 </sect1>
 
@@ -1139,7 +1145,7 @@ join a channel.
 
 <para>The following is a short list of frequently-used &irc; commands.  See <ulink url="http://www.faqs.org/rfcs/rfc2812.html">RFC 2812</ulink> for a complete list of all commands, or
 visit <ulink url="http://www.irchelp.org/">irchelp.org</ulink>.  For a list of commands
-treated specially by &konversation;, see <link linkend="konvi-cmds">&konversation; commands</link>
+treated specially by &konversation;, see <link linkend="konvi-cmds">&konversation; commands</link>.
 </para>
 
 <para>
@@ -1174,7 +1180,7 @@ Synonym for <userinput><command>/leave</command></userinput></para></listitem>
 <varlistentry>
 <term><userinput><command>/me </command><replaceable>msg</replaceable></userinput></term>
 <listitem><para>Sends <userinput><replaceable>msg</replaceable></userinput> to the channel preceded by your &nickname;.  For example, if
-your &nickname; were <userinput><replaceable>Tux</replaceable></userinput>, typing <userinput><replaceable>/me brews a cup a tea.</replaceable></userinput> displays the message <interface>Tux brews a cup of tea.</interface>  Unless they've filtered against these types of messages, all users see it.  This kind of message is typically used to convey non-verbal information, such as your current emotional state, or what you are physically doing.  If you are leaving your workstation for a short time, use the /away command instead.</para></listitem>
+your &nickname; were <userinput><replaceable>Tux</replaceable></userinput>, typing <userinput><replaceable>/me brews a cup a tea.</replaceable></userinput> displays the message <interface>Tux brews a cup of tea.</interface>  Unless they've filtered against these types of messages, all users see it.  This kind of message is typically used to convey non-verbal information, such as your current emotional state, or what you are physically doing.  If you are leaving your workstation for a short time, use the <userinput><command>/away</command></userinput> command instead.</para></listitem>
 </varlistentry>
 
 <varlistentry>
@@ -1219,11 +1225,11 @@ Use <userinput><command>/query</command></userinput> for longer conversations.</
 A private conversation is one that only you and one other person can see.  Private conversations are called "queries" in &konversation;.  To initiate a private conversation,
 type <userinput><command>/query </command><replaceable>nick</replaceable></userinput> in any input line,
 where <replaceable>nick</replaceable> is the &nickname; of the person you want to talk with.  You can also
-click with the &RMB; on the person's &nickname; in the <guilabel>Nick Panel</guilabel> and choose
+click with the &RMB; on the person's &nickname; in the <interface>Nick Panel</interface> and choose
 <menuchoice>
 	<guisubmenu>Open Query</guisubmenu>
-</menuchoice>
-<action>. A new tab will be created</action>.  Announce yourself by sending a message.
+</menuchoice>.
+<action>A new tab will be created.</action>  Announce yourself by sending a message.
 </para>
 
 <para>
@@ -1236,7 +1242,7 @@ To leave the query, just close the tab.  Note however, that if the other person
 <menuchoice>
 	<guisubmenu>Window</guisubmenu>
 	<guisubmenu>Close All Open Queries</guisubmenu>
-</menuchoice> on the main menu, or 
+</menuchoice> on the main menu, or press
 press <keycap>F11</keycap>.</para>
 
 <para>
@@ -1440,7 +1446,7 @@ The <guilabel>Watched Nicknames</guilabel> screen appears.
 <para>
 <calloutlist>
 
-<callout arearefs="pt-notifylist-1"><para>Check this box to activate the nickname watcher feature.</para></callout>
+<callout arearefs="pt-notifylist-1"><para>Check this box to activate the &nickname; watcher feature.</para></callout>
 
 <callout arearefs="pt-notifylist-2"><para>If you want the
 <guilabel>Watched Nicks Online</guilabel> screen to automatically display when you
@@ -1448,7 +1454,7 @@ open &konversation;, check this box.</para></callout>
 
 <callout arearefs="pt-notifylist-3"><para>The &nickname;s of the users you want to monitor are listed here.  Each &nickname; has an associated &irc; network.</para></callout>
 
-<callout arearefs="pt-notifylist-4"><para>Click these buttons to add or remove &nickname;s from the list.</para></callout>
+<callout arearefs="pt-notifylist-4"><para>Click these buttons to <guibutton>Add</guibutton> or <guibutton>Remove</guibutton> &nickname;s from the list.</para></callout>
 
 <callout arearefs="pt-notifylist-5"><para>The <guilabel>Watched Nicks Online</guilabel> feature works by periodically polling the server.  This box sets how often that occurs.  Avoid numbers less than 20 seconds because it places excessive load on the server.</para></callout>
 
@@ -1626,7 +1632,7 @@ minimized in the system tray.</para>
 
 <callout arearefs="pt-osd-5"><para>Check the boxes here to select the types of messages you'd like to appear on screen.</para></callout>
 
-<callout arearefs="pt-osd-6"><para>Drag the OSD Preview to your desired position, then click the <guibutton>Apply</guibutton> button.</para></callout>
+<callout arearefs="pt-osd-6"><para>Drag the <interface>&osd; Preview</interface> to your desired position, then click the <guibutton>Apply</guibutton> button.</para></callout>
 
 </calloutlist>
 </para>
@@ -1720,7 +1726,7 @@ To change the &nickname; theme, choose
 <para>
 <calloutlist>
 
-<callout arearefs="pt-themes-1"><para>Click to select the <guilabel>Nicklist Themes</guilabel> screen.</para></callout>
+<callout arearefs="pt-themes-1"><para>Click here to select the <guilabel>Nicklist Themes</guilabel> screen.</para></callout>
 <callout arearefs="pt-themes-2"><para>Select a theme.</para></callout>
 <callout arearefs="pt-themes-3"><para>Sample icons are displayed here in the chosen theme.</para></callout>
 <callout arearefs="pt-themes-4"><para>If you have downloaded a nick theme
@@ -2014,12 +2020,12 @@ Next, click with the &RMB; on the &nickname; of the person again and choose
 <menuchoice>
 	<guisubmenu>Address Book Associations</guisubmenu>
 </menuchoice>.
-  <action>A submenu appears</action>.  If the &nickname; is not already associated with a contact,
+  <action>A submenu appears.</action>  If the &nickname; is not already associated with a contact,
 choose
 <menuchoice>
 	<guisubmenu>Create New Contact</guisubmenu>
 </menuchoice>.
-  <action>The <guilabel>Edit Contact</guilabel> screen appears</action>.
+  <action>The <guilabel>Edit Contact</guilabel> screen appears.</action>
 </para>
 
 <para>
@@ -2055,7 +2061,7 @@ If you know the person's real name, replace the &nickname; with the real name.
 </callout>
 
 <callout arearefs="pt-kimproxy-create-3">
-<para>Click here.  The <guilabel>Edit Instant Messaging Address</guilabel> window appears.</para></callout>
+<para>Click here.  The <guilabel>Edit Instant Messaging Addresses</guilabel> window appears.</para></callout>
 
 </calloutlist>
 </para>
@@ -2186,11 +2192,11 @@ also specify the <link linkend="webbrowser">web browser</link> to use.</para></c
 <para>When you click on a highlighted &URL; anywhere in &konversation;, it will launch the default
 &kde; application associated with the &MIME; type of the &URL;.  For example, when clicking on
 a &URL; beginning with <interface>http</interface>, &konqueror; is launched to display the
-web page.  You can specify an application different from the &kde; default.  For example, you can
-use Firefox instead.
+web page.  You can specify an application different from the <guilabel>Default Applications</guilabel>
+module of the &kde; &systemsettings;.  For example, you can use <application>Firefox</application> instead.
 </para>
 
-<para>To choose a different web browser, choose
+<para>To choose a different web browser from &konversation; app, choose
 <menuchoice>
 	<guisubmenu>Settings</guisubmenu>
 	<guisubmenu>Configure &konversation;</guisubmenu>
@@ -2387,7 +2393,7 @@ alternate forms of the command.  Commands not listed here are sent to the server
 <varlistentry>
 <term><userinput><command>/me</command> <replaceable>msg</replaceable></userinput></term>
 <listitem><para>Sends <userinput><replaceable>msg</replaceable></userinput> to the channel preceded by your &nickname;.  For example, if
-your &nickname; were <userinput><replaceable>Tux</replaceable></userinput>, typing <userinput><replaceable>/me brews a cup a tea.</replaceable></userinput> displays the message <interface>Tux brews a cup of tea.</interface>  Unless they've filtered against these types of messages, all users see it.  This kind of message is typically used to convey non-verbal information, such as your current emotional state, or what you are physically doing.  If you are leaving your workstation for a short time, use the /away command instead.</para></listitem>
+your &nickname; were <userinput><replaceable>Tux</replaceable></userinput>, typing <userinput><replaceable>/me brews a cup a tea.</replaceable></userinput> displays the message <interface>Tux brews a cup of tea.</interface>  Unless they've filtered against these types of messages, all users see it.  This kind of message is typically used to convey non-verbal information, such as your current emotional state, or what you are physically doing.  If you are leaving your workstation for a short time, use the <userinput><command>/away</command></userinput> command instead.</para></listitem>
 </varlistentry>
 
 <varlistentry>
@@ -2399,7 +2405,7 @@ the message is sent to all the channels and queries you have open on all the ser
 <varlistentry>
 <term><userinput><command>/join</command> <replaceable>channel</replaceable> <replaceable>[pwd]</replaceable></userinput></term>
 <listitem><para>Joins <userinput><replaceable>channel</replaceable></userinput>.  If the server permits it,
-and if the channel does not already exist, it is created and you are the channel operator.  If the channel requires a password in order to join, specify as <userinput><replaceable>pwd</replaceable></userinput>.  Most channel names begin with <userinput><replaceable>#</replaceable></userinput></para></listitem>
+and if the channel does not already exist, it is created and you are the channel operator.  If the channel requires a password in order to join, specify as <userinput><replaceable>pwd</replaceable></userinput>.  Most channel names begin with <userinput><replaceable>#</replaceable></userinput>.</para></listitem>
 </varlistentry>
 
 <varlistentry>
@@ -2518,11 +2524,11 @@ topic of the channel.  Changing a channel topic may fail if you lack sufficient
 <varlistentry>
 <term><userinput><command>/away </command> <replaceable>reason</replaceable></userinput></term>
 <listitem><para>If anyone tries to send you a private message or invite you to a channel, they will be told that you are
-away from your workstation for <userinput><replaceable>reason</replaceable></userinput>.  To change your state back to normal, enter <userinput><command>/away</command></userinput> without a reason.</para></listitem>
+away from your workstation for <userinput><replaceable>reason</replaceable></userinput>.  To change your state back to normal, enter <userinput><command>/away</command></userinput> without a <userinput><replaceable>reason</replaceable></userinput>.</para></listitem>
 </varlistentry>
 
 <varlistentry>
-<term><userinput><command>/aaway </command> <replaceable>reason</replaceable></userinput></term>
+<term><userinput><command>/aaway </command><replaceable>reason</replaceable></userinput></term>
 <listitem><para>Like the <userinput><command>/away</command></userinput> command above except that
 the command is sent to all the servers you have connected in &konversation;.</para></listitem>
 </varlistentry>
@@ -2711,7 +2717,7 @@ passing it <userinput><replaceable>uname -a</replaceable></userinput>.  This sen
 <para>To get a list of all available scripts, type the following command in a
 &konsole; screen.</para>
 
-<para><userinput><replaceable>ls `kde4-config --install data`/konversation/scripts</replaceable></userinput></para>
+<para><userinput>ls `kde4-config --install data`konversation/scripts</userinput></para>
 
 <para>You can write your own scripts.  Scripts are shell scripts and can be written in
 any shell language, such as bash, perl, or python.  When &konversation; runs a script, the
@@ -2747,7 +2753,7 @@ in the tab without sending it to other users, use <computeroutput>info</computer
 instead.  Look at the existing script files for more examples of writing scripts.</para>
 
 <para>To be able to run a script you have written, you must install it by copying
-it to <filename class="directory">`kde4-config --install data`/konversation/scripts</filename> or to <filename class="directory">`kde4-config --localprefix`/share/apps/konversation/scripts</filename>.  You must also give the file execute
+it to <filename class="directory">`kde4-config --install data`konversation/scripts</filename> or to <filename class="directory">`kde4-config --localprefix`share/apps/konversation/scripts</filename>.  You must also give the file execute
 privilege, for example <userinput><replaceable>chmod a+x myscript</replaceable></userinput>.</para>
 
 </sect1>
@@ -2761,10 +2767,10 @@ privilege, for example <userinput><replaceable>chmod a+x myscript</replaceable><
 <varlistentry>
 <term><userinput><command>/exec </command> <replaceable>bug</replaceable> [<replaceable>Bug Number|Search String</replaceable>]</userinput></term>
 <listitem>
-<para>This script is used to open your browser to search for the given string or bug number on kde's bugzilla.</para>
+  <para>This script is used to open your browser to search for the given string or bug number on <ulink url="https://bugs.kde.org/">&kde;'s Bugzilla</ulink>.</para>
 <para>Example: To open your browser to search for bug 123456</para>
 <para><userinput><command>/exec </command> <replaceable>bug 123456</replaceable></userinput></para>
-<para>Sample action: The default browser in your KDE System Settings should open to <replaceable>http://bugs.kde.org/show_bug.cgi?id=123456</replaceable></para>
+<para>Sample action: The default browser in your &kde; &systemsettings; should open to <replaceable>http://bugs.kde.org/show_bug.cgi?id=123456</replaceable></para>
 </listitem>
 </varlistentry>
 
@@ -2985,7 +2991,7 @@ or menu bars. -->
 			<guimenu>File</guimenu>
 			<guimenuitem>Quit</guimenuitem>
 		</menuchoice></term>
-		<listitem><para><action>Quits</action> &konversation;</para></listitem>
+		<listitem><para><action>Quits</action> &konversation;.</para></listitem>
 	</varlistentry>
 </variablelist>
 </para>
@@ -3110,7 +3116,7 @@ Clear Marker Lines Ctrl Shift R
 			<guimenuitem>Add Bookmark</guimenuitem>
 		</menuchoice></term>
 		<listitem><para>
-		    <action>Bookmarks current network & channel</action>
+		    <action>Bookmarks current network & channel.</action>
 		</para></listitem>
 	</varlistentry>
 	<varlistentry>
@@ -3128,7 +3134,7 @@ Clear Marker Lines Ctrl Shift R
 			<guimenuitem>New Bookmark Folder...</guimenuitem>
 			</menuchoice></term>
 		<listitem><para>
-				<action>Creates a new bookmark folder</action>
+				<action>Creates a new bookmark folder.</action>
 			</para></listitem>
 	</varlistentry>
 	<varlistentry>
@@ -3137,7 +3143,7 @@ Clear Marker Lines Ctrl Shift R
 				<guimenuitem>Edit Bookmarks...</guimenuitem>
 			</menuchoice></term>
 		<listitem><para>
-				<action>Opens bookmark editor</action>
+				<action>Opens bookmark editor.</action>
 			</para></listitem>
 	</varlistentry>
 </variablelist>



More information about the kde-doc-english mailing list