[kde-doc-english] [kate] doc/kate: Typo corrections, improvements to grammar, and changing some text (kate, XML) to entities.
Yuri Chornoivan
yurchor at ukr.net
Sat Oct 26 17:13:33 UTC 2013
Git commit 75dcaaa3069f6f5f6dbfc24db04793efdd51d66c by Yuri Chornoivan, on behalf of David Palser.
Committed on 26/10/2013 at 17:13.
Pushed by yurchor into branch 'master'.
Typo corrections, improvements to grammar, and changing some text (kate, XML) to entities.
M +88 -88 doc/kate/plugins.docbook
http://commits.kde.org/kate/75dcaaa3069f6f5f6dbfc24db04793efdd51d66c
diff --git a/doc/kate/plugins.docbook b/doc/kate/plugins.docbook
index b28e7cd..f927ba0 100644
--- a/doc/kate/plugins.docbook
+++ b/doc/kate/plugins.docbook
@@ -9,7 +9,7 @@
<title>Working with Plugins</title>
-<para>&kate; offers several types of plugins. There are plugins for &kate; editor
+<para>&kate; offers several types of plugin. There are plugins for the &kate; editor
component, which are available to any application using the editor component,
such as KDevelop, Quanta, Kile, &kwrite; and many others. There are also plugins
only available in the &kate; editor itself. There are two types of these plugins:
@@ -19,11 +19,11 @@ language. There are subtle differences in these, described below.</para>
<para>You can enable any type of plugin in the <link
linkend="configuring-kate-configdialog">configuration dialog</link>, which also
provides access to additional configuration options for plugins that require
-that.</para>
+it.</para>
<para>There are many plugins for various purposes available
and you can search the web for more. A few plugins are shipped with the
-editor component, for inserting automatic braces, insert files,
+editor component, for inserting automatic braces, inserting files,
and exporting text as &HTML;.</para>
&plugins-part-sections;
@@ -46,7 +46,7 @@ and exporting text as &HTML;.</para>
<guimenuitem>Expand abbreviation</guimenuitem>
</menuchoice></term>
<listitem><para>
-Converts the selected text to a pair of opening and closing &HTML; or XML tags.
+Converts the selected text to a pair of opening and closing &HTML; or &XML; tags.
For example, if <userinput>div</userinput> is selected, this item will replace
that with <computeroutput><div></div></computeroutput>.
</para></listitem>
@@ -66,11 +66,11 @@ Wraps the selected text with the tag provided on the
<varlistentry id="scripts-emmet-select-tag-inwards">
<term><menuchoice>
<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
-<guimenuitem>Select HTML/XML tag contents inwards</guimenuitem>
+<guimenuitem>Select &HTML;/&XML; tag contents inwards</guimenuitem>
</menuchoice></term>
<listitem><para>
-When the cursor is inside a pair of &HTML;/XML tags, this option will change the
-selection to include the contents of those &HTML;/XML tags, without selecting the
+When the cursor is inside a pair of &HTML;/&XML; tags, this option will change the
+selection to include the contents of those &HTML;/&XML; tags, without selecting the
tags themselves.
</para></listitem>
</varlistentry>
@@ -78,11 +78,11 @@ tags themselves.
<varlistentry id="scripts-emmet-select-tag-outwards">
<term><menuchoice>
<guimenu>Tools</guimenu><guisubmenu>Scripts</guisubmenu><guisubmenu>Emmet</guisubmenu>
-<guimenuitem>Select &HTML;/XML tag contents outwards</guimenuitem>
+<guimenuitem>Select &HTML;/&XML; tag contents outwards</guimenuitem>
</menuchoice></term>
<listitem><para>
-When the cursor is inside a pair of &HTML;/XML tags, this item will change the
-selection to include the contents of those &HTML;/XML tags, including the tags
+When the cursor is inside a pair of &HTML;/&XML; tags, this item will change the
+selection to include the contents of those &HTML;/&XML; tags, including the tags
themselves.
</para></listitem>
</varlistentry>
@@ -93,7 +93,7 @@ themselves.
<guimenuitem>Move cursor to matching tag</guimenuitem>
</menuchoice></term>
<listitem><para>
-If the cursor is inside an opening &HTML;/XML tag, this item will move it to the
+If the cursor is inside an opening &HTML;/&XML; tag, this item will move it to the
closing tag. If the cursor is inside the closing tag, it will instead move it
to the opening tag.
</para></listitem>
@@ -106,7 +106,7 @@ to the opening tag.
</menuchoice></term>
<listitem><para>
If the selected portion is not a comment, this item will enclose that portion
-in &HTML;/XML comments (⪚
+in &HTML;/&XML; comments (⪚
<computeroutput><!-- selected text --></computeroutput>). If the selected
portion is a comment, the comment tags will be removed instead.
</para></listitem>
@@ -120,7 +120,7 @@ portion is a comment, the comment tags will be removed instead.
<guimenuitem>Delete tag under cursor</guimenuitem>
</menuchoice></term>
<listitem><para>
-If the cursor is presently inside a &HTML;/XML tag, this item will delete the
+If the cursor is presently inside a &HTML;/&XML; tag, this item will delete the
entire tag.
</para></listitem>
</varlistentry>
@@ -516,8 +516,8 @@ definition.</para></listitem>
<para>User-defined text expansions.</para>
<para>Each text expansion is a simple function which must return a string.
-This string will be inserted into a document by the expandAtCursor action.
-For example if you have a function <quote>foo</quote> in the
+This string will be inserted into a document by the <command>expandAtCursor</command> action.
+For example, if you have a function <quote>foo</quote> in the
<filename>all.expand</filename> file which is defined as:</para>
<informalexample><programlisting>
@@ -672,11 +672,11 @@ functions offered by a plugin, as generated by <command>pydoc</command>.</para>
<para>The File Templates plugin allows you to create files based on other
files.</para>
- <para>When you first install Kate, you need to enable the plugin:</para>
+ <para>When you first install &kate;, you need to enable the plugin:</para>
<orderedlist>
<listitem>
<para>
- Click <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Kate</guimenuitem></menuchoice>
+ Click <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kate;</guimenuitem></menuchoice>
</para>
</listitem>
<listitem>
@@ -728,7 +728,7 @@ functions offered by a plugin, as generated by <command>pydoc</command>.</para>
<guimenuitem>Any File...</guimenuitem>
</menuchoice>
</term>
- <listitem><para>Presents you with Open File dialog that allows
+ <listitem><para>Presents you with an Open File dialog that allows
you to use any file as a template. If the chosen file has the
extension <filename>katetemplate</filename> it will be parsed
for template information and macros.</para></listitem>
@@ -753,8 +753,8 @@ functions offered by a plugin, as generated by <command>pydoc</command>.</para>
<guimenuitem>New From Template</guimenuitem>
</menuchoice>
</term>
- <listitem><para>The remainder of submenus contains links to
- templates. Click a menuitem to create a file as described by
+ <listitem><para>The remainder of submenus contain links to
+ templates. Click a menu item to create a file as described by
the menu item text.</para></listitem>
</varlistentry>
@@ -773,9 +773,9 @@ functions offered by a plugin, as generated by <command>pydoc</command>.</para>
<sect2 id="katefiletemplates-use">
<title>Using a &kate; Template</title>
- <para>When creating a file from a template that contain template
- macros, some macros appears as editable variables in the text. Such
- variables appears as underlined words in the text.</para>
+ <para>When creating a file from a template that contains template
+ macros, some macros appear as editable variables in the text. Such
+ variables appear as underlined words in the text.</para>
<para>The first variable will be selected, so you just have to type to edit
it. If the document text contains more instances of the same variable,
they are changed as you edit. To move to the next editable variable,
@@ -795,7 +795,7 @@ functions offered by a plugin, as generated by <command>pydoc</command>.</para>
you.</para> <para>Alternatively, you can create a template manually by
adding template information to the top of any file, add text and macros,
and save it with the <filename>katetemplate</filename> extension.</para>
- <para>The template menu gets automatically updated if you chose to store
+ <para>The template menu is automatically updated if you chose to store
your template in the template directory.</para>
</sect2>
@@ -806,8 +806,8 @@ functions offered by a plugin, as generated by <command>pydoc</command>.</para>
<guimenuitem>Manage Templates...</guimenuitem></menuchoice>. Select the
template you want to work on and click <guibutton>Edit...</guibutton>,
and the template file will be opened. Close the dialog, edit the template
- file as desired, save it and close it. Changes to templates takes
- immediate effect, you can activate the template to test your changes after
+ file as desired, save it and close it. Changes to templates take
+ immediate effect; you can activate the template to test your changes after
saving it.</para>
</sect2>
@@ -843,14 +843,14 @@ functions offered by a plugin, as generated by <command>pydoc</command>.</para>
<listitem><para>This is the name that will be set for the
document, and displayed in the file list and title bar. If the
name contains <userinput>%N</userinput> that will be replaced
- with a number, increasing if more documents has the same
+ with a number, incrementing if more documents have the same
name.</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>Highlight</varname></term>
- <listitem><para>The plug-in will try to set the Highlight for
+ <listitem><para>The plugin will try to set the Highlight for
the new document to the value of this variable. The value
- should be the name, as found in the
+ should be the name, as found in
<menuchoice><guimenu>Tools</guimenu>
<guimenuitem>Highlighting</guimenuitem>
</menuchoice>.</para>
@@ -859,15 +859,15 @@ functions offered by a plugin, as generated by <command>pydoc</command>.</para>
<varlistentry>
<term><varname>Description</varname></term>
<listitem><para>A short informative description of the
- template. This is currently used to set a Whatsthis string for
- the menu item, but may be used for more purposes in the
+ template. This is currently used to set a <guimenuitem>What's this?</guimenuitem> string for
+ the menu item, but may be used for additional purposes in the
future.</para></listitem>
</varlistentry>
<varlistentry><term>Author</term>
<listitem><para>A string identifying the author, for example
in the form <userinput>Name <email address></userinput>.
- This is currently used to set a Whatsthis string for the menu
- item, but may be used for more purposes in the
+ This is currently used to set a <guimenuitem>What's this?</guimenuitem> string for the menu
+ item, but may be used for additional purposes in the
future.</para></listitem>
</varlistentry>
</variablelist>
@@ -916,14 +916,14 @@ functions offered by a plugin, as generated by <command>pydoc</command>.</para>
</listitem>
</varlistentry>
<varlistentry><term><literal>hostname</literal></term>
- <listitem><para>Expands to the 'hostname' of your computer.</para>
+ <listitem><para>Expands to the hostname of your computer.</para>
</listitem>
</varlistentry>
<varlistentry><term><literal>index</literal></term>
<listitem><para>Expands to 'i'.</para></listitem>
</varlistentry>
<varlistentry><term><literal>fullname</literal></term>
- <listitem><para>Expands to your full name, as defined by the
+ <listitem><para>Expands to your full name, as defined in the
owner addressee in your standard &kde;
addressbook.</para></listitem>
</varlistentry>
@@ -943,7 +943,7 @@ functions offered by a plugin, as generated by <command>pydoc</command>.</para>
</varlistentry> -->
<varlistentry>
<term>email</term>
- <listitem><para>Expands to your email address, as defined by
+ <listitem><para>Expands to your email address, as defined in
the owner address in your standard &kde;
addressbook.</para></listitem>
</varlistentry>
@@ -955,7 +955,7 @@ functions offered by a plugin, as generated by <command>pydoc</command>.</para>
</varlistentry>-->
</variablelist>
</para>
- <para>Any macro not in the above list is treated as a editable variable
+ <para>Any macro not in the above list is treated as an editable variable
no matter the prefix.
If the same variable occurs multiple times in the template, they can be
edited at once after creating a document from the template.</para>
@@ -965,7 +965,7 @@ functions offered by a plugin, as generated by <command>pydoc</command>.</para>
<title>Setting the cursor position</title>
<para>The special macro <userinput>${cursor}</userinput> will be replaced
with a vertical bar and added to the end of the list of editable variables,
- independent on its location in the text.</para>
+ independent of its location in the text.</para>
</sect3>
</sect2>
@@ -989,9 +989,9 @@ functions offered by a plugin, as generated by <command>pydoc</command>.</para>
<title>&XML; Validation</title>
-<para>This plugin checks &XML; files for well-formedness and validity.</para>
+<para>This plugin checks &XML; files for validity and being well-formed.</para>
<para>This plugin checks the current file. A list of warnings and errors
-will appears at the bottom of &kate;'s main window. You can click on an error message
+will appear at the bottom of &kate;'s main window. You can click on an error message
to jump to the corresponding place in the file. If the file has a <quote>DOCTYPE</quote>
the DTD given with this doctype will be used to check the file for validity. The
DTD is expected at a position relative to the current file, ⪚ if the doctype
@@ -999,7 +999,7 @@ refers to <quote>DTD/xhtml1-transitional.dtd</quote> and the file is <filename>/
the DTD is expected to be located at <filename>/home/peter/DTD/xhtml1-transitional.dtd</filename>.
However, remote DTDs specified via http are supported.</para>
-<para>If the file has no doctype it will be checked for well-formedness.</para>
+<para>If the file has no doctype it will be checked for being well-formed.</para>
<para>To learn more about &XML; check out the <ulink url="http://www.w3.org/XML/"> official W3C &XML; pages</ulink>.</para>
@@ -1008,11 +1008,11 @@ is part of libxml2. If this command is not correctly installed on your system, t
will not work.</para>
<note><para>A temporary file needs to be written to the same folder as the file
-that should be checked, so you need to have write access to that folder.</para></note>
+that is being checked is in, so you need to have write access to that folder.</para></note>
-<para>To load this plugin open &kate;s configuration dialog under <menuchoice><guimenu>Settings</guimenu>
+<para>To load this plugin open &kate;'s configuration dialog under <menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Configure &kate;...</guimenuitem></menuchoice>.
-Then select <guilabel>XML Validation</guilabel> which will appear
+Then select <guilabel>&XML; Validation</guilabel> which will appear
in the <guilabel>Application</guilabel> / <guilabel>Plugins</guilabel> section and close the dialog.
</para>
@@ -1023,8 +1023,8 @@ in the <guilabel>Application</guilabel> / <guilabel>Plugins</guilabel> section a
<varlistentry>
<term>
<menuchoice>
-<guimenu>XML</guimenu>
-<guimenuitem>Validate XML</guimenuitem>
+<guimenu>&XML;</guimenu>
+<guimenuitem>Validate &XML;</guimenuitem>
</menuchoice>
</term>
<listitem><para>This will start the check, as described above.</para></listitem>
@@ -1036,7 +1036,7 @@ in the <guilabel>Application</guilabel> / <guilabel>Plugins</guilabel> section a
<sect2 id="xmlcheck-thanks-and-acknowledgements">
<title>Thanks and Acknowledgments</title>
<para>
-&kate; Plugin <quote>XML Validation</quote> copyright 2002 &Daniel.Naber;
+&kate; Plugin <quote>&XML; Validation</quote> copyright 2002 &Daniel.Naber;
&Daniel.Naber.mail;.
</para>
<para>Documentation copyright 2002 &Daniel.Naber;</para>
@@ -1073,10 +1073,10 @@ To produce your own meta DTDs, get <command>dtdparse</command> from
<para>Start &kate; and open the configuration dialog under <menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Configure &kate;...</guimenuitem></menuchoice>.
-Then select <guilabel>XML Completion</guilabel> which will appear
+Then select <guilabel>&XML; Completion</guilabel> which will appear
in the <guilabel>Application</guilabel>/<guilabel>Plugins</guilabel> section and close the dialog. After
-that, select <menuchoice><guimenu>XML</guimenu><guimenuitem>Assign Meta DTD...</guimenuitem></menuchoice>.
-If your document contains no <quote>DOCTYPE</quote> or the doctype is unknown, you'll have to
+that, select <menuchoice><guimenu>&XML;</guimenu><guimenuitem>Assign Meta DTD...</guimenuitem></menuchoice>.
+If your document contains no <quote>DOCTYPE</quote> or the doctype is unknown, you will have to
select a meta DTD from the file system. Otherwise the meta DTD that
matches the current document's DOCTYPE will be loaded automatically.</para>
@@ -1093,7 +1093,7 @@ this to insert the top level element (⪚ <quote><html></quote>).</para><
<varlistentry>
<term><keycap><</keycap><keycap>/</keycap>(less than key + slash)</term>
-<listitem><para>Entering these characters will offer closing the current element
+<listitem><para>Entering these characters will offer to close the current element
(nearest open one to the left of the cursor). Press &Enter; to accept the suggestion.
Unlike the <guimenuitem>Close Element</guimenuitem> menu item, this works only with
a DTD assigned.</para></listitem>
@@ -1102,7 +1102,7 @@ a DTD assigned.</para></listitem>
<varlistentry>
<term><keycap>"</keycap> (quote key)</term>
<listitem><para>The quote key will trigger a list of possible attribute
-values (if there are some) if you are inside a tag.</para></listitem>
+values (if there are any) if you are inside a tag.</para></listitem>
</varlistentry>
<varlistentry>
@@ -1140,7 +1140,7 @@ into &kate; and following the instructions.</para>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Return</keycap></keycombo>
</shortcut>
-<guimenu>XML</guimenu>
+<guimenu>&XML;</guimenu>
<guimenuitem>Insert Element...</guimenuitem>
</menuchoice>
</term>
@@ -1160,7 +1160,7 @@ using <guimenuitem>Assign Meta DTD...</guimenuitem>.
<shortcut>
<keycombo action="simul">&Ctrl;<keycap><</keycap></keycombo>
</shortcut>
-<guimenu>XML</guimenu>
+<guimenu>&XML;</guimenu>
<guimenuitem>Close Element</guimenuitem>
</menuchoice>
</term>
@@ -1173,7 +1173,7 @@ it cannot find an open tag nothing will happen.</para></listitem>
<varlistentry>
<term>
<menuchoice>
-<guimenu>XML</guimenu>
+<guimenu>&XML;</guimenu>
<guimenuitem>Assign Meta DTD...</guimenuitem>
</menuchoice>
</term>
@@ -1213,7 +1213,7 @@ You will have to repeat it when you start &kate; the next time.</para></listitem
<term>
<menuchoice>
<guimenu>File</guimenu>
-<guimenuitem>Export as HTML...</guimenuitem>
+<guimenuitem>Export as &HTML;...</guimenuitem>
</menuchoice>
</term>
<listitem>
@@ -1227,11 +1227,11 @@ Export your file in &HTML; format so your document can be viewed as a web page.
<term>
<menuchoice>
<guimenu>Edit</guimenu>
-<guimenuitem>Copy as HTML...</guimenuitem>
+<guimenuitem>Copy as &HTML;...</guimenuitem>
</menuchoice>
</term>
<listitem>
-<para>Copies selected text with the syntax highlight as HTML text.</para>
+<para>Copies selected text with the syntax highlight as &HTML; text.</para>
</listitem>
</varlistentry>
@@ -1309,7 +1309,7 @@ search inside a folder and optionally its subfolders.
<listitem><para>
There are two available options. If enabled, <guilabel>Match case</guilabel>
will restrict search results to only those that have the exact same combination
-of upper and lower-case letters as your search query. <guilabel>Regular
+of upper and lower case letters as your search query. <guilabel>Regular
expressions</guilabel> permits you to use
<link linkend="regular-expressions">regular expressions</link> instead of simple
text as your search query.
@@ -1350,7 +1350,7 @@ enter <userinput>~/development/kde/kate/</userinput> if you wished to search the
<varlistentry>
<term><guiicon>Open file dialog</guiicon></term>
<listitem><para>
-Press this button to locate for the folder in your desktop's folder browser.
+Press this button to locate the folder in your desktop's folder browser.
</para></listitem>
</varlistentry>
@@ -1511,7 +1511,7 @@ files from a displayed folder in the current frame.</para>
</menuchoice>
</term>
<listitem>
-<para>Toggle the display of &kate;'s Filesystem Browser</para>
+<para>Toggle the display of &kate;'s Filesystem Browser.</para>
</listitem>
</varlistentry>
@@ -1521,7 +1521,7 @@ files from a displayed folder in the current frame.</para>
<sect2 id="fsbrowser-interface">
<title>Interface</title>
-<para>From top down, the Filesystem Browser consist of the following
+<para>From the top down, the Filesystem Browser consists of the following
elements:</para>
<variablelist>
@@ -1581,7 +1581,7 @@ available in Detailed View.</para></listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Show Hidden Files</guimenuitem></term>
-<listitem><para>Displays files normally hidden by your operating system.</para></listitem>
+<listitem><para>Displays files normally hidden by your &OS;.</para></listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Automatically synchronize with current document</guimenuitem></term>
@@ -1598,7 +1598,7 @@ to the folder of the document currently open in the editing area every time it c
<varlistentry>
<term>A Location Entry</term>
<listitem>
-<para>This displays a breadcrumb navigation to the currently open folder, like
+<para>This displays a breadcrumb navigation to the currently open folder, similarly to
&dolphin;. You can click on a any folder to browse to it, or click on one of the
arrows to the left of a folder to select any folders beneath it. You may also
select from your list of Places by clicking the leftmost icon in the breadcrumb
@@ -1649,7 +1649,7 @@ of <link linkend="configuring-kate-configdialog">&kate;'s configuration</link>.<
<variablelist>
<varlistentry>
<term><guilabel>Toolbar</guilabel></term>
-<listitem><para>Configure the buttons on the file system browser toolbar
+<listitem><para>Configure the buttons on the Filesystem Browser toolbar
by moving the ones you want enabled to the <guilabel>Selected Actions</guilabel>
list, and order them using the arrow buttons at the side of the list.</para>
</listitem>
@@ -1857,7 +1857,7 @@ from disk.</para></listitem>
<sect2 id="snippets-intro">
<title>Introduction</title>
<para>Kate Snippets is a plugin used to save you some time by adding support for
-so-called "snippets" (re-usable source code, machine code or text). The plugin
+so-called <quote>snippets</quote> (re-usable source code, machine code or text). The plugin
also supports code completion and QtScript.</para>
</sect2>
@@ -1882,8 +1882,8 @@ that are for the currently opened file type.</para></listitem>
<screeninfo>Kate Snippets Panel</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="snippets-panel.png" format="PNG"/></imageobject>
-<textobject><phrase>The Kate snippets panel.</phrase></textobject>
-<caption><para>The panel for Kate Snippets.</para></caption>
+<textobject><phrase>The &kate; snippets panel.</phrase></textobject>
+<caption><para>The panel for &kate; Snippets.</para></caption>
</mediaobject>
</screenshot>
@@ -1918,7 +1918,7 @@ when finished.</para>
</screenshot>
<para>To create a new snippet repository, click <guibutton>New Snippet File</guibutton>.
-You should now see dialog that asks for name of the snippet file, license and
+You should now see a dialog that asks for the name of the snippet file, license and
author. After choosing the desired options, click <guibutton>Create</guibutton>,
and the snippet editor will open.</para>
@@ -1994,7 +1994,7 @@ occurrence.</para>
<screeninfo>Kate Snippets in Action</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="snippets-usage.png" format="PNG"/></imageobject>
-<textobject><phrase>Accessing Kate Snippets from a tool view and a drop down menu.</phrase></textobject>
+<textobject><phrase>Accessing &kate; Snippets from a tool view and a drop down menu.</phrase></textobject>
<caption><para>Selecting from a list of snippets.</para></caption>
</mediaobject>
</screenshot>
@@ -2005,7 +2005,7 @@ occurrence.</para>
<listitem><para>By choosing the snippet from the tool view.</para></listitem>
<listitem><para>While writing, you can press <keycombo action="simul">&Ctrl;
<keysym>Space</keysym></keycombo>, which will display all the snippets in a
-convenient window from which you can choose from. You may enter the beginning
+convenient window from which you can choose. You may enter the beginning
of the snippets name before or after pressing this key combination, which provides
functionality similar to code completion.</para></listitem>
</itemizedlist>
@@ -2019,7 +2019,7 @@ to the next variable, and so on.</para>
<sect2 id="snippets-ack">
<title>Thanks and Acknowledgments</title>
-<para>Kate Snippets was written by Joseph Wenninger.</para>
+<para>&kate; Snippets was written by Joseph Wenninger.</para>
<para>Special thanks to Google Code-In 2011 participant Martin Gergov for
writing much of this section.</para>
</sect2>
@@ -2064,9 +2064,9 @@ compile actions.</para>
<para>The <guilabel>Build Output</guilabel> tool view has three tabs:</para>
<itemizedlist>
-<listitem><para><guilabel>Errors & Warnings</guilabel></para></listitem>
-<listitem><para><guilabel>Output</guilabel></para></listitem>
<listitem><para><guilabel>Target Settings</guilabel></para></listitem>
+<listitem><para><guilabel>Output</guilabel></para></listitem>
+<listitem><para><guilabel>Errors & Warnings</guilabel></para></listitem>
</itemizedlist>
<sect3 id="build-using-target-settings">
@@ -2220,7 +2220,7 @@ writing much of this section.</para>
<para>The Structured Query Language (SQL) is a specialized language for updating,
deleting, and requesting information from databases.</para>
-<para>The Kate SQL Plugin allows you to:</para>
+<para>The &kate; SQL Plugin allows you to:</para>
<itemizedlist>
<listitem><para>Create a database</para></listitem>
@@ -2250,14 +2250,14 @@ In the Plugin Manager panel on the right, check SQL Plugin and click OK.
<para>Select <guibutton>Add Connection</guibutton> from the <guimenu>SQL</guimenu>
menu or toolbar, and then select the Qt database driver you want to use (including
QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7, and QPSQL). If you can't see
-the desired driver, you need to install it. Then, press <guibutton>Next</guibutton>
+the desired driver, you need to install it. Then, press <guibutton>Next</guibutton>.
</para>
<para>If the database you selected uses a file, simply indicate the database's
location and press the <guibutton>Next</guibutton> button. If it requires connecting
to a server, you must enter the hostname of the server, your username and password,
and any other information that particular driver may require. Then press
-<guibutton>Next</guibutton></para>
+<guibutton>Next</guibutton>.</para>
<para>Finally, give a name to your connection, and press <guibutton>Finish</guibutton>.</para>
@@ -2269,7 +2269,7 @@ and any other information that particular driver may require. Then press
<sect3 id="sql-querying-insert-delete-update">
<title>INSERT/DELETE/UPDATE</title>
-<para>You can insert, delete, and update data using the SQL plugin just like
+<para>You can insert, delete, and update data using the SQL plugin just as
you would from the command line or from within a program. Simply enter a query
and press the <guibutton>Run query</guibutton>.</para>
@@ -2319,7 +2319,7 @@ SELECT * FROM <replaceable>table_name</replaceable>
</programlisting></para>
</example>
-<para>In the <guilabel>SQL Data Output</guilabel> tool view, there are some buttons:</para>
+<para>In the <guilabel>SQL Data Output</guilabel> tool view, there are several buttons:</para>
<variablelist>
@@ -2335,24 +2335,24 @@ SELECT * FROM <replaceable>table_name</replaceable>
<varlistentry>
<term><guibutton>Copy</guibutton></term>
-<listitem><para>Selects all table contents and copies them to the clipboard buffer.</para></listitem>
+<listitem><para>Selects all of the table contents and copies it to the clipboard buffer.</para></listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Export</guibutton></term>
-<listitem><para>Exports all table contents to a file, the clipboard, or the
+<listitem><para>Exports all of the table contents to a file, the clipboard, or the
current document in the Comma Separated Values format.</para></listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Clear</guibutton></term>
-<listitem><para>Removes everything from table view</para></listitem>
+<listitem><para>Removes everything from the table view</para></listitem>
</varlistentry>
</variablelist>
<para>You can now change the colors displayed in the table in the <guilabel>SQL</guilabel>
-section of <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Kate</guimenuitem>
+section of <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kate;</guimenuitem>
</menuchoice>.</para>
</sect3>
@@ -2369,7 +2369,7 @@ database driver you are using.</para>
<guimenuitem>Refresh</guimenuitem>. To generate a query on any entry in the list,
right-click on an entry, select <guisubmenu>Generate</guisubmenu>, and select the
query type (<guimenuitem>SELECT</guimenuitem>, <guimenuitem>UPDATE</guimenuitem>,
-<guimenuitem>INSERT</guimenuitem>, and <guimenuitem>DELETE</guimenuitem>) from
+<guimenuitem>INSERT</guimenuitem>, or <guimenuitem>DELETE</guimenuitem>) from
the submenu that appears.</para>
</sect2>
@@ -2410,7 +2410,7 @@ Edits the current connection's settings.
<listitem><para>
All database connections you have created are listed between the
<guimenuitem>Edit connection</guimenuitem> and <guimenuitem>Run query</guimenuitem>
-menu items. Select one to run queries or make modification to it.
+menu items. Select one to run queries or make modifications to it.
</para></listitem>
</varlistentry>
@@ -2457,7 +2457,7 @@ Project Debugger.</para>
<important>
<para>Previous experience with &gdb; is strongly recommended. For more
information on using &gdb;, visit <ulink url="http://www.gnu.org/s/gdb/">the
-&gdb; website</ulink></para>
+&gdb; website</ulink>.</para>
</important>
<para>You can enable the &gdb; plugin in
@@ -2474,7 +2474,7 @@ the <command><parameter>-ggdb</parameter></command> command line argument.
</tip>
<para>After these preparations are made, open the source file in &kappname;,
-enter the path to the executable in <guilabel>Settings</guilabel> tab of the
+enter the path to the executable in the <guilabel>Settings</guilabel> tab of the
<guilabel>Debug View</guilabel> tool view, and select
<menuchoice><guimenu>Debug</guimenu><guimenuitem>Start Debugging</guimenuitem></menuchoice>
from the menu to get started.</para>
@@ -2722,7 +2722,7 @@ test program.</para></caption>
<sect2 id="gdb-other">
<title>Call Stack and Locals</title>
-<para>The <guilabel>Call Stack</guilabel> tool view contains list of formated
+<para>The <guilabel>Call Stack</guilabel> tool view contains a list of the formatted
backtrace returned from &gdb;.</para>
<screenshot id="screenshot-gdb-call-stack">
More information about the kde-doc-english
mailing list