You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2950 lines
94 KiB
2950 lines
94 KiB
<?xml version="1.0" ?>
|
|
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
|
|
"dtd/kdex.dtd" [
|
|
<!ENTITY kappname "&kwrite;">
|
|
<!ENTITY package "tdebase">
|
|
<!ENTITY % addindex "IGNORE">
|
|
<!ENTITY % English "INCLUDE" > <!-- change language only here -->
|
|
]>
|
|
|
|
<book lang="&language;">
|
|
|
|
<bookinfo>
|
|
<title>The &kwrite; Handbook</title>
|
|
<authorgroup>
|
|
<author>&Thad.McGinnis; &Thad.McGinnis.mail;</author>
|
|
<author>&Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;</author>
|
|
<author>&Anders.Lund; &Anders.Lund.mail;</author>
|
|
<othercredit role="developer">
|
|
&Christoph.Cullmann; &Christoph.Cullmann.mail;
|
|
<!-- <contrib>Core Developer and Maintainer</contrib> -->
|
|
</othercredit>
|
|
|
|
<othercredit role="reviewer">
|
|
&Lauri.Watts; &Lauri.Watts.mail;
|
|
<!-- <contrib>Reviewer</contrib> -->
|
|
</othercredit>
|
|
|
|
<!-- TRANS:ROLES_OF_TRANSLATORS -->
|
|
|
|
</authorgroup>
|
|
|
|
<copyright>
|
|
<year>2000</year><year>2001</year>
|
|
<holder>&Thad.McGinnis;</holder>
|
|
</copyright>
|
|
<copyright>
|
|
<year>2005</year>
|
|
<holder>&Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;</holder>
|
|
<holder>&Anders.Lund; &Anders.Lund.mail;</holder>
|
|
</copyright>
|
|
<legalnotice>&FDLNotice;</legalnotice>
|
|
|
|
<date>2005-12-27</date>
|
|
<releaseinfo>4.5.0</releaseinfo>
|
|
|
|
<abstract>
|
|
<para>&kwrite; is a text editor for &tde;</para>
|
|
</abstract>
|
|
|
|
<keywordset>
|
|
<keyword>KDE</keyword>
|
|
<keyword>KWrite</keyword>
|
|
<keyword>text</keyword>
|
|
<keyword>editor</keyword>
|
|
</keywordset>
|
|
|
|
</bookinfo>
|
|
|
|
<chapter id="introduction">
|
|
<title>Introduction</title>
|
|
|
|
<para>
|
|
&kwrite; is more than a text editor for the &tde; Desktop. It is meant
|
|
to be a programmer's editor, and could be considered as at least a
|
|
partial alternative to more powerful editors. It may be best used in
|
|
conjunction with &konqueror; for source file browsing for different
|
|
languages. &kwrite; also works very well as a simple text editor. One
|
|
of &kwrite;'s main features is the colorized syntax, customized for many
|
|
different programming languages such as: C/C++, &Java;, Python, Perl,
|
|
Bash, Modula 2, &HTML;, and Ada.
|
|
</para>
|
|
|
|
</chapter>
|
|
|
|
<chapter id="on-screen-fundamentals">
|
|
<title>Some Fundamentals</title>
|
|
|
|
<para>
|
|
&kwrite; is very simple to use. Anyone that has used a text editor
|
|
should have no problems.
|
|
</para>
|
|
|
|
<sect1 id="drag-and-drop">
|
|
<title>Drag and Drop</title>
|
|
|
|
<para>
|
|
&kwrite; uses the &tde; Drag and Drop protocol. Files may be dragged and
|
|
dropped onto &kwrite; from the Desktop, &konqueror; or some remote &FTP;
|
|
site opened in one of &konqueror;'s windows.
|
|
</para>
|
|
</sect1>
|
|
|
|
<sect1 id="command-line-options">
|
|
<title>Command Line Options</title>
|
|
|
|
<para>
|
|
Though &kwrite; may most often be started from the &tde; program menu, or
|
|
a desktop icon, it can also be opened at the command line prompt of a
|
|
terminal window. There are a few useful options that are available when
|
|
doing this.
|
|
</para>
|
|
|
|
<sect2 id="specify-a-file">
|
|
<title>Specify a File</title>
|
|
|
|
<para>By specifying the path and name of a particular file the user can
|
|
have &kwrite; open (or create) that file immediately upon startup. This
|
|
option might look something like the following:</para>
|
|
|
|
<informalexample><screen>
|
|
<prompt>%</prompt> <userinput><command>kwrite</command>
|
|
<option><replaceable>/home/myhome/docs/myfile.txt</replaceable></option>
|
|
</userinput>
|
|
</screen>
|
|
</informalexample>
|
|
</sect2>
|
|
<sect2 id="editing-files-on-the-internet">
|
|
<title>Specify a file on the internet</title>
|
|
|
|
<para>The above-mentioned method could even be used to open files on the
|
|
internet (if the user has an active connection at the time.) An example of
|
|
this might look like the following:</para>
|
|
|
|
<informalexample><screen>
|
|
<prompt>%</prompt> <userinput><command>kwrite</command>
|
|
<option><replaceable>ftp://ftp.kde.org/pub/kde/Welcome.msg</replaceable>
|
|
</option></userinput>
|
|
</screen>
|
|
</informalexample>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="other-command-line-options">
|
|
<title>Other Command Line Options</title>
|
|
|
|
<para>The following command line help options are available</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><userinput><command>kwrite</command>
|
|
<option>--help</option></userinput></term>
|
|
<listitem><para>This lists the most basic options available at the command
|
|
line.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><userinput><command>kwrite</command>
|
|
<option>--help-qt</option></userinput></term>
|
|
<listitem><para>This lists the options available for changing the way
|
|
&kwrite; interacts with &Qt;.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><userinput><command>kwrite</command>
|
|
<option>--help-kde</option></userinput></term>
|
|
<listitem><para>This lists the options available for changing the way
|
|
&kwrite; interacts with &tde;.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><userinput><command>kwrite</command>
|
|
<option>--help-all</option></userinput></term>
|
|
<listitem><para>This lists all of the command line options.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><userinput><command>kwrite</command>
|
|
<option>--author</option></userinput></term>
|
|
<listitem><para>Lists &kwrite;'s authors in the terminal
|
|
window</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><userinput><command>kwrite</command>
|
|
<option>--version</option></userinput></term>
|
|
<listitem><para>Lists version information for &Qt;, &tde;, and &kwrite;. Also
|
|
available through <userinput><command>kwrite</command>
|
|
<option>-v</option></userinput> </para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><userinput><command>kwrite</command>
|
|
<option>--stdin</option></userinput></term>
|
|
<listitem><para>Causes &kwrite; to read the document content from STDIN. This
|
|
is similar to the common option <option>-</option> used in many command line
|
|
programs, and allows you to pipe command output into &kwrite;.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><userinput><command>kwrite</command>
|
|
<option>--encoding</option> <parameter>encoding</parameter>
|
|
<parameter>&URL;</parameter></userinput></term>
|
|
<listitem><para>Causes &kwrite; to use the specified encoding for the document.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><userinput><command>kwrite</command>
|
|
<option>--line</option> <parameter>line</parameter>
|
|
<parameter>&URL;</parameter></userinput></term>
|
|
<listitem><para>Navigate to the specified line after opening the document.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><userinput><command>kwrite</command>
|
|
<option>--column</option> <parameter>column</parameter>
|
|
<parameter>&URL;</parameter></userinput></term>
|
|
<listitem><para>Navigate to the specified column after opening the document.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</sect2>
|
|
</sect1>
|
|
|
|
<sect1 id="keybindings">
|
|
<title>Shortcuts</title>
|
|
|
|
<para>Many of the shortcuts are configurable by way of the <link
|
|
linkend="settings">Settings</link> menu. By default &kwrite; honors the
|
|
following shortcuts:</para>
|
|
<informaltable>
|
|
<tgroup cols="2">
|
|
<tbody>
|
|
|
|
<row><entry><para><keycombo
|
|
action="simul"><keycap>Insert</keycap></keycombo></para></entry>
|
|
<entry><para> Toggle between Insert and Overwrite mode. When in insert mode the
|
|
editor will add any typed characters to the text while pushing along any data to
|
|
the right of the text cursor. Overwrite mode causes the entry of each character
|
|
to eliminate the character immediately to the right of the text
|
|
cursor.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo action="simul"><keycap>Left
|
|
Arrow</keycap></keycombo></para></entry>
|
|
<entry><para>Move the cursor one character to the left </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo action="simul"><keycap>Right
|
|
Arrow</keycap></keycombo></para></entry>
|
|
<entry><para> Move the cursor one character to the right </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo action="simul"><keycap>Up
|
|
Arrow</keycap></keycombo></para></entry>
|
|
<entry><para> Move the cursor up one line </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo action="simul"><keycap>Down
|
|
Arrow</keycap></keycombo></para></entry>
|
|
<entry><para> Move the cursor down one line </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo action="simul"><keycap>Page
|
|
Up</keycap></keycombo></para></entry>
|
|
<entry><para> Move the cursor up one page </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo action="simul">&Alt;<keycap>Page
|
|
Up</keycap></keycombo></para></entry>
|
|
<entry><para>Previous Bookmark </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo action="simul"><keycap>Page
|
|
Down</keycap></keycombo></para></entry>
|
|
<entry><para>Move the cursor down one page </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo action="simul">&Alt;<keycap>Page
|
|
Down</keycap></keycombo></para></entry>
|
|
<entry><para>Next Bookmark </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul"><keycap>Backspace</keycap></keycombo></para></entry>
|
|
<entry><para> Delete the character to the left of the cursor </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul"><keycap>Home</keycap></keycombo></para></entry>
|
|
<entry><para> Move the cursor to the beginning of the line </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul"><keycap>End</keycap></keycombo></para></entry>
|
|
<entry><para> Move the cursor to the end of the line </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul"><keycap>Delete</keycap></keycombo></para></entry>
|
|
<entry><para>Delete the character to the right of the cursor (or any selected
|
|
text)</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo action="simul">&Shift;<keycap>Left
|
|
Arrow</keycap></keycombo></para></entry>
|
|
<entry><para> Mark text one character to the left </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo action="simul">&Shift;<keycap>Right
|
|
Arrow</keycap></keycombo></para></entry>
|
|
<entry><para> Mark text one character to the right </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul"><keycap>F1</keycap></keycombo></para></entry>
|
|
<entry><para> Help</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Shift;<keycap>F1</keycap></keycombo></para></entry>
|
|
<entry><para>What's this?</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul"><keycap>F3</keycap></keycombo></para></entry>
|
|
<entry><para><link linkend="find-again"> Find again</link></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Shift;<keycap>F3</keycap></keycombo></para></entry>
|
|
<entry><para><link linkend="find-previous"> Find Previous</link></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>A</keycap></keycombo></para></entry>
|
|
<entry><para>Select All</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo></para></entry>
|
|
<entry><para>Deselect</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;&Shift;<keycap>B</keycap></keycombo></para></entry>
|
|
<entry><para>Block Selection Mode</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>B</keycap></keycombo></para></entry>
|
|
<entry><para>Set a Bookmark</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>C</keycap></keycombo></para></entry>
|
|
<entry><para> Copy the marked text to the clipboard.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>D</keycap></keycombo></para></entry>
|
|
<entry><para> Comment</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;&Shift;<keycap>D</keycap></keycombo></para></entry>
|
|
<entry><para> Uncomment</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>F</keycap></keycombo></para></entry>
|
|
<entry><para><link linkend="find"> Find</link></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>G</keycap></keycombo></para></entry>
|
|
<entry><para> Go to line...</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>I</keycap></keycombo></para></entry>
|
|
<entry><para> Indent selection</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;&Shift;<keycap>I</keycap></keycombo></para></entry>
|
|
<entry><para> Unindent selection</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>J</keycap></keycombo></para></entry>
|
|
<entry><para>Join Lines</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>N</keycap></keycombo></para></entry>
|
|
<entry><para> <link linkend="new">New</link> document</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>O</keycap></keycombo></para></entry>
|
|
<entry><para><link linkend="open">Open a document</link> </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>P</keycap></keycombo></para></entry>
|
|
<entry><para><link linkend="print">Print</link> </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>Q</keycap></keycombo></para></entry>
|
|
<entry><para>Quit - close active copy of editor </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>R</keycap></keycombo></para></entry>
|
|
<entry><para><link linkend="replace"> Replace</link></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>S</keycap></keycombo></para></entry>
|
|
<entry><para>Invokes the <link
|
|
linkend="save"><guilabel>Save</guilabel></link> command.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>U</keycap></keycombo></para></entry>
|
|
<entry><para>Uppercase</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;&Shift;<keycap>U</keycap></keycombo></para></entry>
|
|
<entry><para>Lowercase</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Alt;&Ctrl;<keycap>U</keycap></keycombo></para></entry>
|
|
<entry><para>Capitalize</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>V</keycap></keycombo></para></entry>
|
|
<entry><para> Paste the clipboard text into line edit.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>W</keycap></keycombo></para></entry>
|
|
<entry><para><link linkend="close">Close</link> </para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>X</keycap></keycombo></para></entry>
|
|
<entry><para>Delete the marked text and copy it to the clipboard.
|
|
</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>Z</keycap></keycombo></para></entry>
|
|
<entry><para><link linkend="undo">Undo</link></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></para></entry>
|
|
<entry><para><link linkend="redo">Redo</link></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>-</keycap></keycombo></para></entry>
|
|
<entry><para>Collapse One Local Level</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;&Shift;<keycap>-</keycap></keycombo></para></entry>
|
|
<entry><para>Collapse Toplevel</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;<keycap>+</keycap></keycombo></para></entry>
|
|
<entry><para>Expand One Local Level</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul">&Ctrl;&Shift;<keycap>+</keycap></keycombo></para></entry>
|
|
<entry><para>Expand Toplevel</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul"><keycap>F5</keycap></keycombo></para></entry>
|
|
<entry><para><link linkend="reload"> Reload</link></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul"><keycap>F6</keycap></keycombo></para></entry>
|
|
<entry><para>Show/Hide Icon Border</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul"><keycap>F7</keycap></keycombo></para></entry>
|
|
<entry><para> Switch to Command Line</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul"><keycap>F9</keycap></keycombo></para></entry>
|
|
<entry><para> Show/Hide Folding Markers</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul"><keycap>F10</keycap></keycombo></para></entry>
|
|
<entry><para> Dynamic Word Wrap</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><keycombo
|
|
action="simul"><keycap>F11</keycap></keycombo></para></entry>
|
|
<entry><para> Show/Hide Line Numbers</para></entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
</sect1>
|
|
</chapter>
|
|
|
|
<chapter id="the-menu-entries">
|
|
<title>The Menu Entries</title>
|
|
|
|
<sect1 id="file">
|
|
<title>The <guimenu>File</guimenu> Menu</title>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term id="new">
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>New</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>
|
|
This starts a new Document in the editor. If there is a current
|
|
document with unsaved changes the user is given a chance to save it.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term id="open">
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>Open...</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
|
|
<listitem>
|
|
<!--
|
|
This is description of a standard dialog and so should go in the UG,
|
|
with a pointer to it. In fact, I'll probably nick this very stuff for
|
|
the UG
|
|
- Phil
|
|
<para>
|
|
This command opens a file. It does this by means of a dialog box which
|
|
allows the user to navigate the file system. The dialog operates like a
|
|
small file manager. Clicking on folders displayed in the central
|
|
window directs the dialog to enter that folder - displaying its
|
|
contents. There is an entry/dropdown box which can be used to type in
|
|
directly the location and name of the file or by clicking the arrow at
|
|
the side choose from a drop down box of recently used locations. Below
|
|
this is a filter which similarly may have data entered directly or
|
|
chosen from a drop down box of recent filter types. The filter facility
|
|
lets only files that meet its specifications be displayed in the central
|
|
window. If the filter contained text such as <literal
|
|
role="extension">*.txt</literal> then only files with the <literal
|
|
role="extension">txt</literal> extension would be visible in the
|
|
selection window. Below the filter is a status bar giving information
|
|
about the number of files and subfolders within the current
|
|
folder.
|
|
</para>
|
|
|
|
<para>
|
|
The toolbar, which is located at the top of the dialog, has left and
|
|
right arrow buttons that let the user move back and forth through
|
|
previously selected folders as well as an up arrow button for moving
|
|
up the folder tree. The button with the little house takes the user
|
|
to their home folder and the one with the two arrows curved in on
|
|
each other updates the view of the current folder. The flag button
|
|
lets the user set a new bookmark at the current folder or go to one
|
|
that was previously set.
|
|
</para>
|
|
|
|
<para>
|
|
The last button on the toolbar allows you to create a new folder, and
|
|
even change some basic settings for the dialog box, and finally there is
|
|
dropdown box with a list of some commonly frequented folders.
|
|
</para>
|
|
-->
|
|
<para>Displays a standard &tde; <guilabel>Open File</guilabel>
|
|
dialog. Use the file view to select the file you want to open, and
|
|
click on <guibutton>Open</guibutton> to open it. You can find more
|
|
information about the &tde; <guilabel>Open File</guilabel> dialog in
|
|
the &tde; User Guide.</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term id="open-recent">
|
|
<menuchoice>
|
|
<guimenu>File</guimenu>
|
|
<guisubmenu>Open Recent</guisubmenu>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This is a shortcut to open recently saved documents. Clicking on this
|
|
item opens a list to the side of the menu with several of the most
|
|
recently saved files. Clicking on a specific file will open it in
|
|
&kwrite; - if the file still resides at the same
|
|
location.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term id="save">
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>Save</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This saves the current document. If there has already been a save of
|
|
the document then this will overwrite the previously saved file without
|
|
asking for the user's consent. If it is the first save of a new
|
|
document the save as dialog (described below) will be invoked.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term id="save-as">
|
|
<menuchoice>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>Save As...</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This allows a document to be saved with a new file name. This is done by
|
|
means of the file dialog box described above in the <link
|
|
linkend="open">Open</link> section of this help file.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term id="reload">
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul"><keycap>F5</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>Reload</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Reloads the active file from disk. This command is useful if another program or
|
|
process has changed the file while you have it open in &kwrite;.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term id="print">
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>Print...</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Opens a simple print dialog allowing the user to specify what, where,
|
|
and how to print.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term id="export-as-html">
|
|
<menuchoice>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>Export as HTML...</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Export your file in HTML format so your document can be viewed as a web page.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term id="close">
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>Close</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Close the active file with this command. If you have made unsaved changes, you
|
|
will be prompted to save the file before &kwrite; closes it.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term id="quit">
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>Quit</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This will close the editor window, if you have more than one instance of
|
|
&kwrite; running, through the <guimenuitem>New View</guimenuitem> or
|
|
<guimenuitem>New Window</guimenuitem> menu items, those instances will
|
|
not be closed.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="edit">
|
|
<title>The <guimenu>Edit</guimenu> Menu</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term id="undo"><menuchoice>
|
|
<shortcut><keycombo
|
|
action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut>
|
|
<guimenu>Edit</guimenu>
|
|
<guimenuitem>Undo</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>This is used to eliminate or reverse the most recent user action
|
|
or operation.
|
|
<!--
|
|
Just what constitutes such an action may be better
|
|
understood by referring to the <link linkend="group-undos">Group
|
|
Undos</link> portion of this help file.
|
|
-->
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="redo"/><menuchoice>
|
|
<shortcut><keycombo
|
|
action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></shortcut>
|
|
<guimenu>Edit</guimenu><guimenuitem>Redo</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>This will reverse the most recent change (if any) made using Undo</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="cut"/><menuchoice>
|
|
<shortcut><keycombo
|
|
action="simul">&Ctrl;<keycap>X</keycap></keycombo></shortcut>
|
|
<guimenu>Edit</guimenu><guimenuitem>Cut</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>This command deletes the current selection and places it on the
|
|
clipboard.
|
|
The clipboard is a feature of &tde; that works invisibly to provide a way to
|
|
transfer data between applications.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="copy"/><menuchoice>
|
|
<shortcut><keycombo
|
|
action="simul">&Ctrl;<keycap>C</keycap></keycombo></shortcut>
|
|
<guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>This copies the currently selected text to the clipboard so that it may
|
|
be pasted elsewhere. The clipboard is a feature of &tde; that works invisibly
|
|
to provide a way to transfer data between applications.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="copy-as-html"/><menuchoice>
|
|
<guimenu>Edit</guimenu><guimenuitem>Copy as
|
|
HTML</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>This copies the currently selected text to the clipboard as HTML.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="paste"/><menuchoice>
|
|
<shortcut><keycombo
|
|
action="simul">&Ctrl;<keycap>V</keycap></keycombo></shortcut>
|
|
<guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>This will insert the contents of the clipboard at the cursor position.
|
|
The clipboard is feature of &tde; that works invisibly to provide a way to
|
|
transfer data between applications.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="select-all"/><menuchoice>
|
|
<shortcut><keycombo
|
|
action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut>
|
|
<guimenu>Edit</guimenu><guimenuitem>Select All</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>This will select the entire document. This could be very useful for
|
|
copying the entire file to another application.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="deselect"/><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Edit</guimenu><guimenuitem>Deselect</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>Deselects the selected text in the editor if any.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="block-selection-mode"/><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;&Shift;<keycap>B</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Edit</guimenu><guimenuitem>Bloc
|
|
Selection Mode</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>Toggles Selection Mode. When the Selection Mode is “BLOCK”, you can make
|
|
vertical selections, ie select column 5 to 10 in lines 9 to 15.
|
|
The status bar shows the current state of the Selection Mode, either “NORM” or
|
|
“BLK”.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="overwrite-mode"/><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul"><keycap>Insert</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Edit</guimenu><guimenuitem>Overwrite
|
|
Mode</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>Toggles the Insert/Overwrite modes. When the mode is "INS", you
|
|
insert characters where the cursor is. When the mode is "OVR", writing
|
|
characters will replace the current characters if your cursor is positioned
|
|
before any character. The status bar shows the current state of the Overwrite
|
|
Mode, either “INS” or “OVR”.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="find"/><menuchoice>
|
|
<shortcut><keycombo
|
|
action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut>
|
|
<guimenu>Edit</guimenu><guimenuitem>Find</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>This opens the find dialog which is used to specify the <guilabel>Text to
|
|
Find</guilabel> in the document. There is small text box for entering the search
|
|
pattern which also doubles as a dropdown box. Clicking on the dropdown arrow at
|
|
the side of the box makes available other recent search patterns. Other
|
|
parameters are included to make the search more efficient. Selecting
|
|
<guilabel>Case Sensitive</guilabel> will limit finds to entries that match the
|
|
case (upper or lower) of each of the characters in the search pattern.
|
|
<guilabel>Find Backwards</guilabel> directs the search to proceed in an upwardly
|
|
direction. The <guilabel>Selected Text</guilabel> option keeps the search
|
|
within currently selected text. Checking <guilabel>Whole Words Only</guilabel>
|
|
prevents the search from stopping on words that contain the searched for
|
|
pattern. The <guilabel>Search from Cursor</guilabel> option begins the search
|
|
from the current position of the cursor within the document rather than from
|
|
the beginning.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="find-again"/><menuchoice>
|
|
<shortcut><keycombo action="simul"><keycap>F3</keycap></keycombo></shortcut>
|
|
<guimenu>Edit</guimenu><guimenuitem>Find Next</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>This repeats the last find operation, if any, without calling the find
|
|
dialog box.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term id="find-previous">
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Shift;<keycap>F3</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Edit</guimenu>
|
|
<guimenuitem>Find Previous</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This repeats the last find operation, if any, without calling the find
|
|
dialog box, and searching backwards instead of forwards through the
|
|
document.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="replace"/><menuchoice>
|
|
<shortcut><keycombo
|
|
action="simul">&Ctrl;<keycap>R</keycap></keycombo></shortcut>
|
|
<guimenu>Edit</guimenu><guimenuitem>Replace...</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>This command opens the replace dialog box. The replace dialog is
|
|
almost identical to the above-mentioned find dialog. In addition to the features
|
|
in the find dialog it contains a <guilabel>Replace With:</guilabel> text
|
|
entry/dropdown box. Using this dialog the user can specify both the text to be
|
|
found and text with which to replace it. The additional <guilabel>Prompt
|
|
On Replace</guilabel> option allows the user to have &kwrite; ask for
|
|
confirmation before each replacement.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term id="go-to-line">
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Edit</guimenu>
|
|
<guimenuitem>Go to line</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>
|
|
This opens the goto line dialog box which is used to have the cursor
|
|
jump to a particular line (specified by number) in the document. The
|
|
line number may be entered directly into the text box or graphically by
|
|
clicking on the up or down arrow spin controls at the side of the text
|
|
box. The little up arrow will increase the line number and the down
|
|
arrow decrease it. There is also a slide control to the right of the
|
|
text box which allows the user to move the goto point in the document in
|
|
an analog manner.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
<sect1 id="view-menu">
|
|
<title>The <guimenu>View</guimenu> menu</title>
|
|
|
|
<para>The <guimenu>View</guimenu> menu allows you to manage settings
|
|
specific to the active editor, and to manage frames.</para>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<anchor id="view-new-window"/>
|
|
<menuchoice>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>New Window</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Opens a new window with the same text.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<anchor id="view-command-line"/>
|
|
<menuchoice>
|
|
<shortcut><keycombo
|
|
action="simul"><keycap>F7</keycap></keycombo></shortcut>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Switch to Command Line</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Displays the Katepart command line at the bottom of the window.
|
|
In the command line, type "help" to get help and "help list" to get a list of
|
|
commands.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<anchor id="view-schema"/>
|
|
<menuchoice>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Schema</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Select a font schema.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<anchor id="view-dynamic-word-wrap"/>
|
|
<menuchoice>
|
|
<shortcut><keycombo action="simul"><keycap>F10</keycap></keycombo></shortcut>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Dynamic Word Wrap</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>The text lines will be wrapped at the view
|
|
border on the screen.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<anchor id="view-dynamic-word-wrap-indicators"/>
|
|
<menuchoice>
|
|
<shortcut><keycombo action="simul"><keycap>F10</keycap></keycombo></shortcut>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Dynamic Word Wrap Indicators</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>Choose when and how the dynamic word wrap indicators should be
|
|
displayed. This is only available if the <guilabel>Dynamic Word
|
|
Wrap</guilabel> option is checked.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<anchor id="view-show-static-word-wrap"/>
|
|
<menuchoice>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Show Static Word Wrap Marker</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>If this option is checked, a vertical line will be drawn at the
|
|
word wrap column as defined in the <menuchoice>
|
|
<guimenu>Settings</guimenu>
|
|
<guimenuitem>Configure Editor...</guimenuitem></menuchoice> in the
|
|
Editing tab. Please note that the word wrap marker is only drawn if you
|
|
use a fixed pitch font.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<anchor id="view-show-icon-border"/>
|
|
<menuchoice>
|
|
<shortcut><keycombo action="simul"><keycap>F6</keycap></keycombo></shortcut>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Show Icon Border</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>This is a toggle item. Setting it on checked will make the
|
|
side of the active editor, and vice versa.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<anchor id="view-show-line-numbers"/>
|
|
<menuchoice>
|
|
<shortcut><keycombo action="simul"><keycap>F11</keycap></keycombo></shortcut>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Show Line Numbers</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>This is a toggle Item. Setting it on checked will make a pane displaying
|
|
the line numbers of the document visible in the left border of the active
|
|
editor, and vice versa.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<anchor id="view-scrollbar-marks"/>
|
|
<menuchoice>
|
|
<guimenu>View</guimenu>
|
|
<guisubmenu>Show Scrollbar Marks</guisubmenu>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>If this option is checked, the view will show marks on the vertical
|
|
scrollbar.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<anchor id="view-hide-folding-markers"/>
|
|
<menuchoice>
|
|
<shortcut><keycombo action="simul"><keycap>F9</keycap></keycombo></shortcut>
|
|
<guimenuitem>Hide Folding Markers</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>If this option is checked, the marks for code folding will be
|
|
hidden.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<anchor id="view-code-folding"/>
|
|
<menuchoice>
|
|
<guimenuitem>Code Folding</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
|
|
<keycap>Shift</keycap><keycap>-</keycap></keycombo></shortcut>
|
|
<guimenuitem>Collapse Toplevel</guimenuitem></menuchoice>
|
|
</term>
|
|
<listitem><para>Collapse all toplevel regions in the document.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
|
|
<keycap>Shift</keycap><keycap>+</keycap></keycombo></shortcut>
|
|
<guimenuitem>Expand Toplevel</guimenuitem></menuchoice>
|
|
</term>
|
|
<listitem><para>Expand all toplevel regions in the document.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
|
|
<keycap>-</keycap></keycombo></shortcut>
|
|
<guimenuitem>Collapse One Local Level</guimenuitem></menuchoice>
|
|
</term>
|
|
<listitem><para>Collapse the region closest to the cursor.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
|
|
<keycap>+</keycap></keycombo></shortcut>
|
|
<guimenuitem>Expand One Local Level</guimenuitem></menuchoice>
|
|
</term>
|
|
<listitem><para>Expand the region closest to the cursor.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="go">
|
|
<title>The <guimenu>Bookmarks</guimenu> Menu</title>
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term id="set-bookmark">
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Bookmarks</guimenu>
|
|
<guimenuitem>Set Bookmark</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Sets or removes a bookmark in the current line of the active document. (If it's
|
|
there, it is removed, otherwise one is set).
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term id="clear-bookmarks">
|
|
<menuchoice>
|
|
<guimenu>Bookmarks</guimenu>
|
|
<guimenuitem>Clear All Bookmarks</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This command will remove all the markers from the document as well as
|
|
the list of markers which is appended at the bottom of this menu item.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="bookmarks-previous">
|
|
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Alt</keycap>
|
|
<keycap>Page Up</keycap></keycombo></shortcut>
|
|
<guimenu>Bookmarks</guimenu><guimenuitem>Previous</guimenuitem></menuchoice>
|
|
</term>
|
|
<listitem><para>This will move the cursor to beginning of the first above line
|
|
with a bookmark. The menuitem text will include the line number and the first
|
|
piece of text on the line. This item is only available when there is a bookmark
|
|
in a line above the cursor.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="bookmarks-next">
|
|
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Alt</keycap>
|
|
<keycap>Page Down</keycap></keycombo></shortcut>
|
|
<guimenu>Bookmarks</guimenu><guimenuitem>Next</guimenuitem></menuchoice></term>
|
|
<listitem><para>This will move the cursor to beginning of the next line with a
|
|
bookmark. The menuitem text will include the line number and the first piece of
|
|
text on the line. This item is only available when there is a bookmark in a line
|
|
below the cursor.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<para>
|
|
At the bottom of this menu, a list of markers appears if any markers are
|
|
available for this window.
|
|
</para>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="tools">
|
|
<title>The <guimenu>Tools</guimenu> Menu</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><anchor id="tools-read-only"/><menuchoice>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Read Only Mode</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>Set the current document to Read Only mode. This prevents any text
|
|
addition and any changes in the document formatting.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="tools-filetype"/><menuchoice>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Filletype</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>Choose the filetype scheme you prefer for the active document. This
|
|
overwrites the global filetype mode set in <menuchoice>
|
|
<guimenu>Settings</guimenu>
|
|
<guimenuitem>Configure
|
|
Editor...</guimenuitem></menuchoice> in the Filetypes tab for your current
|
|
document only.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="tools-highlighting"/><menuchoice>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Highlighting</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>Choose the Highlighting scheme you prefer for the active document. This
|
|
overwrites the global highlighting mode set in <menuchoice>
|
|
<guimenu>Settings</guimenu>
|
|
<guimenuitem>Configure
|
|
Editor...</guimenuitem></menuchoice> for your current document only.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="tools-indentation"/><menuchoice>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Indentation</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>Choose the style of indentation you want for your active document.
|
|
This overwrites the global indentation mode set in <menuchoice>
|
|
<guimenu>Settings</guimenu>
|
|
<guimenuitem>Configure
|
|
Editor...</guimenuitem></menuchoice> for your current document only.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="tools-encoding"/><menuchoice>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Encoding</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>You can overwrite the default encoding set in <menuchoice>
|
|
<guimenu>Settings</guimenu>
|
|
<guimenuitem>Configure
|
|
Editor...</guimenuitem></menuchoice> in the <guilabel>Open/Save</guilabel> tab
|
|
to set a different encoding for your current document. The encoding you
|
|
set here will be only valid for your current document.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="tools-end-of-line"/><menuchoice>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>End of Line</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>Choose your prefered end of line mode for your active
|
|
document. This overwrites the global end of line mode set in <menuchoice>
|
|
<guimenu>Settings</guimenu>
|
|
<guimenuitem>Configure
|
|
Editor...</guimenuitem></menuchoice> for your current document only.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="Spelling..."/><menuchoice>
|
|
<guimenu>Tools</guimenu><guimenuitem>Spelling...</guimenuitem></menuchoice>
|
|
</term>
|
|
|
|
<listitem><para><action>This initiates the spellchecking program - a program
|
|
designed to help the user catch and correct any spelling errors.</action>
|
|
Clicking on this entry will start the checker and bring up the speller dialog
|
|
box through which the user can control the process. There are four settings
|
|
lined up vertically in the center of the dialog with their corresponding labels
|
|
just to the left. Starting at the top they are:</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Unknown word:</guilabel></term>
|
|
<listitem><para>Here, the spellchecker indicates the word currently under
|
|
consideration. This happens when the checker encounters a word not in its
|
|
dictionary - a file containing a list of correctly spelled words against which
|
|
it compares each word in the editor.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Replace with:</guilabel></term>
|
|
<listitem><para> If the checker has any similar words in its dictionary the
|
|
first one will be listed here. The user can accept the suggestion, type in his
|
|
or her own correction, or choose a different suggestion from the next
|
|
box.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Suggested Words:</guilabel></term>
|
|
<listitem><para> The checker may list here a number of possible replacements for
|
|
the word under consideration. Clicking on any one of the suggestions will cause
|
|
that word to be entered in the <guilabel>Replacement:</guilabel> box,
|
|
above.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Language:</guilabel></term>
|
|
<listitem><para> If you have installed multiple dictionaries, here you can
|
|
select which dictionary/language should be used.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
<para>On the right side of the dialog box are 5 buttons that allow the user to
|
|
control the spellcheck process. They are:</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guibutton>Add to Dictionary</guibutton></term>
|
|
<listitem><para>Pressing this button adds the word in the <guilabel>Misspelled
|
|
Word:</guilabel> box to the checker's dictionary. This means that in the future
|
|
the checker will always consider this word to be correctly
|
|
spelled.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guibutton>Replace</guibutton></term>
|
|
<listitem><para> This button has the checker replace the word under
|
|
consideration in the document with the word in the
|
|
<guilabel>Replacement:</guilabel> box.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guibutton>Replace All</guibutton></term>
|
|
<listitem><para> This button causes the checker to replace not only the current
|
|
<guilabel>Unknown word:</guilabel> but to automatically make the same
|
|
substitution for any other occurrences of this <guilabel>Misspelled
|
|
Word:</guilabel> in the document.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guibutton>Ignore</guibutton></term>
|
|
<listitem><para>Activating this button will have the checker move on without
|
|
making any changes.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guibutton>Ignore All</guibutton></term>
|
|
<listitem><para> This button tells the checker to do nothing with the current
|
|
<guilabel>Unknown word:</guilabel> and to pass over any other instances of
|
|
the same word.</para> <note><para>This only applies to the current spellcheck
|
|
run. If the checker is run again later it will stop on this same
|
|
word.</para></note></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
<!--<para>Located horizontally along the bottom of the spellcheck dialog is a
|
|
progress bar. As the checking process proceeds the bar will fill from left to
|
|
right providing a graphical representation of how far along in the document the
|
|
process has reached. In addition, the progress is displayed numerically in
|
|
the center of the progress bar.</para>//-->
|
|
|
|
<!--<note><para>A numerical display of the spellcheck
|
|
process is simultaneously displayed in the status bar of the editor. The <link
|
|
linkend="show-statusbar">status bar</link> is the horizontal strip at the bottom
|
|
of the editor just outside of the text entry area.</para></note>//-->
|
|
|
|
<para>Three more buttons are located horizontally along the bottom of the
|
|
spellcheck dialog. They are:</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guibutton>Help</guibutton></term>
|
|
<listitem><para> This invokes the &tde; help system starting at the &kwrite; help
|
|
pages (this document).</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guibutton>Finished</guibutton></term>
|
|
<listitem><para> This button ends the spellcheck process, and returns to the
|
|
document.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guibutton>Cancel</guibutton></term>
|
|
<listitem><para> This button cancels the spellcheck process, all modifications
|
|
are reverted, and you will return to your document.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><anchor id="tools-spelling-from-cursor"/><menuchoice>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Spelling (from cursor)...</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>This initiates the spellchecking program but it starts where your cursor
|
|
is instead of at the beginning of the document.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="tools-spellcheck-selection"/><menuchoice>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Spellcheck Selection...</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>Spellchecks the current selection.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="indent"/><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Tools</guimenu><guimenuitem>Indent</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>This increases the paragraph's indentation by one step. The size of the
|
|
step depends on the <link linkend="pref-indent"> indentation
|
|
settings</link>.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="unindent"/><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;&Shift;<keycap>I</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Tools</guimenu><guimenuitem>Unindent</guimenuitem></menuchoice></term>
|
|
|
|
<listitem>
|
|
<para>This reduces the paragraph's indentation by one step. The size of the step
|
|
|
|
depends on the <link linkend="pref-indent"> indentation settings</link>.</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="cleanindent"/><menuchoice>
|
|
<guimenu>Tools</guimenu><guimenuitem>Clean
|
|
Indentation</guimenuitem></menuchoice></term> <listitem>
|
|
<para>This cleans the indentation for the current selection or for the
|
|
line the cursor is currently in. Cleaning the indentation ensures that
|
|
all your selected text follows the indentation mode you choose.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="tools-align"/><menuchoice>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Align</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem>
|
|
<para>Causes a realign of the current line or selected lines using the
|
|
indentation mode and indentation settings in the doucment.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Comment</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>This adds one space to the beginning of the line
|
|
where the text cursor is located or to the beginning of any
|
|
selected lines.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;&Shift;<keycap>D</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Uncomment</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>This removes one space (if any exist) from the beginning of the
|
|
line where the text cursor is located or from the beginning of any
|
|
selected lines.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Uppercase</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Put the selected text or the letter after the cursor in
|
|
uppercase.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;&Shift;<keycap>U</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Lowercase</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Put the selected text or the letter after the cursor in
|
|
lowercase.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Alt;&Ctrl;<keycap>U</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Capitalize</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Capitalize the selected text or the current
|
|
word.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Delete Line</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Delete the current line.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Join Lines</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Joins the selected lines, or the current line and the line below
|
|
with one white space character as a separator. Leading/trailing white space on
|
|
joined lines is removed in the affected ends.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenu>Tools</guimenu>
|
|
<guimenuitem>Word Wrap Document</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Apply static word wrapping on all the document. That means that
|
|
a new line of text will automatically start when the current
|
|
line exceeds the length specified by the Wrap words at: option
|
|
in the Editing tab in <menuchoice>
|
|
<guimenu>Settings</guimenu><guimenuitem>Configure
|
|
Editor...</guimenuitem></menuchoice></para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="settings">
|
|
<title>The <guimenu>Settings</guimenu> Menu</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><anchor id="show-toolbar"/><menuchoice>
|
|
<guimenu>Settings</guimenu>
|
|
<guimenuitem>Show Toolbar</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
When checked, this displays a movable toolbar containing buttons used to
|
|
initiate frequently used commands. When unchecked the toolbar is hidden.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="show-statusbar"/><menuchoice>
|
|
<guimenu>Settings</guimenu><guimenuitem>Show
|
|
Statusbar</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>When checked, this displays a small bar at the bottom of the editor
|
|
containing information about the status of the current document. When unchecked
|
|
the statusbar is hidden.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="show-path"/><menuchoice>
|
|
<guimenu>Settings</guimenu><guimenuitem>Show
|
|
Path</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>When selected, this displays in the titlebar the path (its location in the
|
|
file system) of the current document. When unchecked the path is hidden.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="preferences"/><menuchoice>
|
|
<guimenu>Settings</guimenu>
|
|
<guimenuitem>Configure Editor...</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This menu item opens a dialog whereby several different <link
|
|
linkend="pref-dialog">settings</link> may be adjusted.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="choose-editor"/><menuchoice>
|
|
<guimenu>Settings</guimenu>
|
|
<guimenuitem>Choose Editor...</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Choose the default text editing component that you wish to use in &kwrite;. You
|
|
can choose <guilabel>System Default</guilabel>, <guilabel>Embedded
|
|
Advanced Text Editor</guilabel> or <guilabel>&Qt; Designer Based
|
|
Text Editor</guilabel> (note that the &Qt; Designer Based Text Editor is
|
|
only available if you have KDevelop installed on your system). If you choose
|
|
<guilabel>System Default</guilabel>, &kwrite; will honor your changes in
|
|
&kcontrolcenter;. All other choices will override that setting.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="configure-keybindings"/><menuchoice>
|
|
<guimenu>Settings</guimenu><guimenuitem>Configure
|
|
Shortcuts...</guimenuitem></menuchoice></term>
|
|
<listitem>
|
|
<para>This command opens a dialog box whereby the <link
|
|
linkend="keybindings">shortcuts</link> may be changed. A display window at the
|
|
top of the dialog box shows the list of commands (actions) that can have
|
|
keyboard shortcuts. Below the display are three radio buttons. The user may
|
|
choose between No Key, Default Key, and Custom Key. (Note that a set of radio
|
|
buttons only allows the selection of one of the offered items - in the way that
|
|
buttons on a car radio only offer the selection of one preset station. Also,
|
|
the Default Key selection is only available for those commands that actually
|
|
have a 'default' shortcut.) Selecting the Custom Key option activates the three
|
|
check boxes and key button at the bottom of the dialog. The user may then select
|
|
a key combination for the command in question by means of the check boxes and
|
|
key button. For example, with the About &tde; command selected in the display
|
|
window, the user could select &Ctrl; and <keycap>Alt</keycap>, click on the key
|
|
button, and then press the <keycap>K</keycap> key on the keyboard. This would
|
|
mean that anytime they held down the &Ctrl; and <keycap>Alt</keycap>
|
|
buttons and pressed <keycap>K</keycap> (while using
|
|
&kwrite;) the About &tde; display box would be called.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><anchor id="configure-toolbars"/><menuchoice>
|
|
<guimenu>Settings</guimenu><guimenuitem>Configure
|
|
Toolbars...</guimenuitem></menuchoice></term>
|
|
<listitem><para>This will open the dialog whereby the toolbar configuration may
|
|
be changed. The user can choose which shortcut buttons should appear on the
|
|
toolbar. A display window on the left lists the commands available to placed
|
|
on the toolbar. A display on the right lists those commands already on the
|
|
toolbar. A set of four arrow buttons between the two displays manipulates the
|
|
selections. The right pointing arrow places any command selected in the left
|
|
pane onto the right pane, <abbrev>i.e.</abbrev>, it is added to the toolbar.
|
|
The left arrow does just the opposite, removing any action selected in the right
|
|
|
|
window from the toolbar. The up and down pointing arrows change the position of
|
|
|
|
an action selected in the right window which changes the position of its button
|
|
|
|
in the toolbar.</para> </listitem>
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<!--
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice><guimenu>>Settings</guimenu><guimenuitem>Configure
|
|
Highlighting</guimenuitem></menuchoice></term>
|
|
<listitem><para>Opens a dialog box allowing configuration of the syntax
|
|
highlighting. The dialog is described in <xref
|
|
linkend="pref-highlighting"/>.</para></listitem>
|
|
</varlistentry> -->
|
|
|
|
<!--<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul"><keycap>F6</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Settings</guimenu>
|
|
<guimenuitem>Show Icon Border</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Toggle the display of a border on the left of the editing window, where
|
|
bookmarks are displayed next to the line they apply to.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>//-->
|
|
|
|
<!--<varlistentry>
|
|
<term id="vertical-selection">
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul"><keycap>F4</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Settings</guimenu>
|
|
<guimenuitem>Vertical Selection</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This is used to turn on or off the vertical selection feature. Vertical
|
|
selection allows text to be selected by column as well as by row. In other
|
|
words with this feature the user is able to select text contained in only
|
|
particular contiguous columns and rows. In affect the user can select a
|
|
rectangular area of text anywhere in the document.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry> //-->
|
|
|
|
<!--<varlistentry>
|
|
<term id="set-highlight">
|
|
<menuchoice>
|
|
<guimenu>Settings</guimenu>
|
|
<guisubmenu>Highlight Mode</guisubmenu>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This allows the user to choose the style of color highlighting which the
|
|
editor uses to display the text. The styles are selected by programming
|
|
language. The font/color information is not stored with the document.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry> //-->
|
|
|
|
<!--<varlistentry>
|
|
<term><anchor id="end-of-line"/>
|
|
<menuchoice>
|
|
<guimenu>Settings</guimenu><guisubmenu>End of
|
|
Line</guisubmenu></menuchoice></term>
|
|
<listitem>
|
|
<para>This opens a sub-menu from which the user can select the type of
|
|
<quote>end of
|
|
line</quote> code for &kwrite; to use, <abbrev>i.e.</abbrev>, the accepted
|
|
standard
|
|
used by &UNIX;, &Mac; or MSDOS/&Windows; systems.</para>
|
|
</listitem>
|
|
</varlistentry> //-->
|
|
|
|
</variablelist>
|
|
</sect1>
|
|
|
|
<sect1 id="help">
|
|
<title>The <guimenu>Help</guimenu> Menu</title>
|
|
|
|
&help.menu.documentation;
|
|
|
|
</sect1>
|
|
</chapter>
|
|
|
|
<chapter id="pref-dialog">
|
|
<title>Configure &kwrite;</title>
|
|
|
|
<para>
|
|
Selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
|
|
Editor...</guimenuitem></menuchoice> from the menu brings up the
|
|
<guilabel>Configure Editor</guilabel> dialog box. This dialog can be
|
|
used to alter a number of different settings. The settings available
|
|
for change vary according to which category the user chooses from a
|
|
vertical list on the left side of the dialog. By means of three buttons
|
|
along the bottom of the box the user can control the process.
|
|
</para>
|
|
|
|
<para>
|
|
They may invoke the <guilabel>Help</guilabel> system, accept the
|
|
current settings and close the dialog by means of the
|
|
<guibutton>OK</guibutton> button, or <guibutton>Cancel</guibutton> the
|
|
process. The categories <guilabel>Colors</guilabel>,
|
|
<guilabel>Fonts</guilabel> <guilabel>Indent</guilabel>,
|
|
<guilabel>Select</guilabel>, <guilabel>Edit</guilabel>,
|
|
<guilabel>Spelling</guilabel> and <guilabel>Highlighting</guilabel> are
|
|
detailed below.
|
|
</para>
|
|
|
|
<sect1 id="appearance">
|
|
<title>Appearance</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Word Wrap</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry id="appearance-settings">
|
|
<term><guilabel>Dynamic word wrap</guilabel></term>
|
|
<listitem><para>If this option is checked, the text lines
|
|
will be wrapped at the view border on the screen.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Dynamic word wrap indicators</guilabel></term>
|
|
<listitem><para>Choose when the Dynamic word wrap indicators
|
|
should be displayed.
|
|
</para></listitem></varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Vertically align dynamically wrapped lines
|
|
to indentation depth:
|
|
</guilabel></term>
|
|
<listitem><para>Enables the start of dynamically wrapped
|
|
lines to be aligned vertically to the indentation level of the first
|
|
line. This can help to make code and markup more
|
|
readable.</para><para>Additionally, this allows you to
|
|
set a maximum width of the screen, as a percentage,
|
|
after which dynamically wrapped lines will no longer be vertically aligned.
|
|
For example, at 50%, lines whose indentation levels are deeper than 50% of the
|
|
width of the screen will not have vertical alignment applied to subsequent
|
|
wrapped lines.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Code Folding</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Show folding markers (if available)
|
|
</guilabel></term>
|
|
<listitem><para>If this option is checked, the current view will display marks
|
|
for code folding, if code folding is available.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Borders</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Show icon border
|
|
</guilabel></term>
|
|
<listitem><para>If this is checked, you will see an icon border on the left
|
|
hand side. The icon border shows bookmark signs for instance.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Show line numbers
|
|
</guilabel></term>
|
|
<listitem><para>If this is checked, you will see line numbers on the left
|
|
hand side.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Show scrollbar marks
|
|
</guilabel></term>
|
|
<listitem><para>If this option is checked the current view
|
|
will show marks on the vertical scrollbar. These marks will
|
|
for instance show bookmarks.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Sort Bookmarks Menu
|
|
</guilabel></term>
|
|
<listitem><para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>By position
|
|
</guilabel></term>
|
|
<listitem><para>The bookmarks will be ordered by the line
|
|
numbers they are placed at.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>By creation
|
|
</guilabel></term>
|
|
<listitem><para>Each new bookmark will be added to the bottom,
|
|
independently from where it is placed in the document.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Show identation lines
|
|
</guilabel></term>
|
|
<listitem><para>If this is checked, the editor wil display
|
|
vertical lines to help identifying indent lines.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</sect1>
|
|
|
|
<sect1 id="prefcolors">
|
|
<title>Fonts & Colors</title>
|
|
|
|
<para>This section of the dialog lets you configure all fonts and colors in
|
|
any color scheme you have, as well creating new schemes or deleting existing
|
|
ones. Each scheme has settings for colors, fonts and normal and highlight text
|
|
styles.
|
|
</para>
|
|
|
|
<para>&kwrite; will preselect the currently active scheme for you, if you want to
|
|
work on a different scheme start by selecting that from the
|
|
<guilabel>Schema</guilabel> combobox.</para>
|
|
|
|
<sect2 id="prefcolors-colors">
|
|
<title>Colors</title>
|
|
|
|
<variablelist>
|
|
<varlistentry id="prefcolors-colors-text-background">
|
|
<term><guilabel>Text Area Background</guilabel></term>
|
|
<listitem>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry id="pref-colors-normal-text">
|
|
<term><guilabel>Normal text</guilabel></term>
|
|
<listitem><para>This is the default background for the editor area, it will be
|
|
the dominant color on the editor area.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="pref-colors-selected-text">
|
|
<term><guilabel>Selected Text</guilabel></term>
|
|
<listitem><para>This is the background for selected text. The default is
|
|
the global selection color, as set in your &tde; color preferences.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="pref-colors-current-line">
|
|
<term><guilabel>Current Line</guilabel></term>
|
|
<listitem><para>Set the color for the current line. Setting this a bit different
|
|
from the Normal text background helps to keep focus on the current line.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="pref-colors-marks">
|
|
<term><guilabel>Bookmark</guilabel></term>
|
|
<listitem><para>This combo lets you set overlay colors for various mark types.
|
|
The color is mixed into the background color of a marked line, so that a line
|
|
with more marks or a marked line that is current has a background that is a mix
|
|
of more colors. The mark colors are also used if you enable display of scrollbar
|
|
marks.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="prefcolors-colors-other-elements">
|
|
<term><guilabel>Other Elements</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Left Border Background</guilabel></term>
|
|
<listitem><para>This color is used for the marks, line numbers and folding
|
|
marker borders in the left side of the editor view when they are displayed.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Line Numbers</guilabel></term>
|
|
<listitem><para>This color is used to draw the line numbers on the left side of
|
|
the view when displayed.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Bracket Highlight</guilabel></term>
|
|
<listitem><para>This color is used to draw the background of matching brackets.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Word Wrap Markers</guilabel></term>
|
|
<listitem><para>This color is used to draw a pattern to the left of dynamically
|
|
wrapped lines when those are aligned vertically, as well as for the static word
|
|
wrap marker.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Tab Markers</guilabel></term>
|
|
<listitem><para>This color is used to draw white space indicators when enabled.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</sect2>
|
|
|
|
<sect2 id="prefcolors-fonts">
|
|
<title>Fonts</title>
|
|
<para>
|
|
Here you can choose the font for the schema. You can choose from
|
|
any font available on your system, and set a default size. A sample text
|
|
displays at the bottom of the dialog, so you can see the effect of your choices.
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2 id="prefcolors-normal-text-styles">
|
|
<title>Normal Text Styles</title>
|
|
<para>The normal text styles are inherited by the highlight text styles,
|
|
allowing the editor to present text in a very consistent way, for example comment
|
|
text is using the same style in allmost all of the text formats that kate can
|
|
highlight.</para>
|
|
<para>The name in the list of styles is using the style configured for
|
|
the item, providing you with an immediate preview when configuring a style.
|
|
</para>
|
|
<para>Each style lets you select common attributes as well as foreground
|
|
and background colors. To unset a background color, rightclick to use the
|
|
context menu.</para>
|
|
</sect2>
|
|
|
|
<sect2 id="prefcolors-highlighting-text-styles">
|
|
<title>Highlighting Text Styles</title>
|
|
<para>Here you can edit the text styles used by a specific highlight definition.
|
|
The editor preselects the highlight used by your current document. To work on a
|
|
different highlight, select one in the <guilabel>Highlight</guilabel> combobox
|
|
above the style list.
|
|
</para>
|
|
<para>The name in the list of styles is using the style configured for
|
|
the item, providing you with an immediate preview when configuring a style.
|
|
</para>
|
|
<para>Each style lets you select common attributes as well as foreground
|
|
and background colors. To unset a background color, rightclick to use the
|
|
context menu. In addition you can see if a style is equal to the default style
|
|
used for the item, and set it to that if not.</para>
|
|
<para>You will notice that many highlights contain other highlights represented
|
|
by groups in the style list. For example most highlights import the Alert
|
|
highlight, and many source code formats imports the Doxygen highlight. Editing
|
|
colors in those groups only affects the styles when used in the edited highlight
|
|
format.
|
|
</para>
|
|
</sect2>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="pref-cursor-selection">
|
|
<title>Cursor & Selection</title>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Text Cursor Movement</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Smart home</guilabel></term>
|
|
<listitem>
|
|
<para>When selected, pressing the home key will cause the cursor to
|
|
skip white space and go to the start of a line's text.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Wrap cursor</guilabel></term>
|
|
<listitem>
|
|
<para>When on, moving the insertion cursor using the <emphasis
|
|
role="bold">Left</emphasis> and <emphasis role="bold">Right</emphasis> keys will
|
|
go on to previous/next line at beginning/end of the line, similar to most
|
|
editors.</para><para>When off, the insertion cursor cannot be moved left of the
|
|
line start, but it can be moved off the line end, which can be very handy for
|
|
programmers. When this option is chosen, moving the cursor with the arrow keys
|
|
off the end of a line (to the right) causes it to jump down to the beginning of
|
|
the next line. Likewise when the cursor is moved past the beginning of a line
|
|
(to the left) it jumps up to the end of the preceding line. When this option is
|
|
not selected, moving the cursor right past the end of a line merely causes it to
|
|
continue horizontally in the same line and trying to move it left past the
|
|
beginning does nothing.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Page Up/Page Down moves cursor</guilabel></term>
|
|
<listitem>
|
|
<para>This option changes the behavior of the cursor when the user presses
|
|
the <keycap>Page Up</keycap> or <keycap>Page Down</keycap> key. If unselected
|
|
the text cursor will maintain its relative position within the visible text in
|
|
&kwrite; as new text becomes visible as a result of the operation. So if the
|
|
cursor is in the middle of the visible text when the operation occurs it will
|
|
remain there (except when one reaches the beginning or end.) With this option
|
|
selected, the first key press will cause the cursor to move to either the top or
|
|
bottom of the visible text as a new page of text is displayed.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Autocenter cursor (lines):</guilabel></term>
|
|
<listitem>
|
|
<para>Sets the number of lines to maintain visible above and below the cursor
|
|
when possible.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Selection Mode</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Normal</guilabel></term>
|
|
<listitem>
|
|
<para>Selections will be overwritten by typed text and will be lost on
|
|
cursor movement.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Persistent</guilabel></term>
|
|
<listitem>
|
|
<para>Selections will stay even after cursor movement and typing.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</sect1>
|
|
|
|
<sect1 id="pref-edit">
|
|
<title>Editing</title>
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Tabulators</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Insert spaces instead of tabulators</guilabel></term>
|
|
<listitem>
|
|
<para>When this is enabled the editor will insert a calculated number of spaces
|
|
according to the position in the text and the <option>tab-width</option> setting
|
|
when you press the <keycap>TAB</keycap> key.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Show tabulators</guilabel></term>
|
|
<listitem>
|
|
<para>When this is enabled &kwrite; will display a small dot as a visual
|
|
representation of tabulator characters.</para>
|
|
<note><para>This also causes dots to be drawn to indicate trailing white space.
|
|
This will be fixed in a future version of &kwrite;</para></note>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term id="pref-tab-width">Tab Width</term> <listitem><para>If the
|
|
<link linkend="pref-word-wrap"><guilabel>Replace Tabs By
|
|
Spaces</guilabel></link>
|
|
option is selected this entry determines the number of
|
|
spaces with which the editor will automatically replace
|
|
tabs.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term id="pref-word-wrap"><guilabel>Static Word Wrap</guilabel></term>
|
|
<listitem><para>
|
|
Word wrap is a feature that causes the editor to automatically start a new line
|
|
of text and move (wrap) the cursor to the beginning of that new line. &kwrite;
|
|
will automatically start a new line of text when the current line reaches the
|
|
length specified by the <link linkend="pref-wrap-words-at">Wrap Words
|
|
At:</link> option.</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Enable static word wrap</guilabel></term>
|
|
<listitem>
|
|
<para>Turns static word wrap on or off.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Show static word wrap markers
|
|
(if applicable)</guilabel></term>
|
|
<listitem>
|
|
<para>If this option is checked, a vertical line will be drawn at the word wrap
|
|
column as defined in the <menuchoice> <guimenu>Settings</guimenu>
|
|
<guimenuitem>Configure Editor...</guimenuitem></menuchoice> in the Editing tab.
|
|
Please note that the word wrap marker is only drawn if you use a fixed pitch
|
|
font.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term id="pref-wrap-words-at"><guilabel>Wrap words at:</guilabel></term>
|
|
<listitem>
|
|
<para>If the <link linkend="pref-word-wrap">Word Wrap</link> option is selected
|
|
this entry determines the length (in characters) at which the editor will
|
|
automatically start a new line.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Remove Trailing Spaces</guilabel></term>
|
|
<listitem><para>&kwrite; will automatically eliminate extra spaces
|
|
at the ends of lines of text.</para></listitem> </varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Auto Brackets</guilabel></term> <listitem><para>When
|
|
the user types a left bracket ([, (, or {) &kwrite; automatically enters the
|
|
right bracket (}, ), or ]) to the right of the cursor.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry> <term>Maximum <link linkend="undo">undo</link> steps:</term>
|
|
<listitem><para>Here the user may specify the number of steps &kwrite; will
|
|
retain in memory for purposes of undoing entries and actions. This means that
|
|
the higher the number of steps set the more memory &kwrite; will use for this.
|
|
Setting this entry to 10 would mean that the user would be be able reverse the
|
|
last ten operations, <abbrev>i.e.</abbrev> click the <guibutton>undo</guibutton>
|
|
button 10 times and obtain results.</para></listitem> </varlistentry>
|
|
|
|
<varlistentry> <term>Smart search text from:</term>
|
|
<listitem><para>This determines where &kwrite; will get the search
|
|
text from (this will be automatically entered into the Find Text
|
|
dialog):
|
|
<itemizedlist>
|
|
<listitem><para><emphasis role="bold">Nowhere:</emphasis> Don't guess the search
|
|
text.</para></listitem>
|
|
<listitem><para><emphasis role="bold">Selection Only:</emphasis> Use
|
|
the current text selection, if available.</para></listitem>
|
|
<listitem><para><emphasis role="bold">Selection, then Current Word:</emphasis>
|
|
Use the current selection if available, otherwise use the current word.
|
|
</para></listitem>
|
|
<listitem><para><emphasis role="bold">Current Word
|
|
Only:</emphasis> Use the word that the cursor is currently resting on, if
|
|
available.</para></listitem>
|
|
<listitem><para><emphasis role="bold">Current Word, then Selection:</emphasis>
|
|
Use the current word if available, otherwise use the current selection.
|
|
</para></listitem>
|
|
</itemizedlist>
|
|
Note that, in all the above modes, if a
|
|
search string has not been or cannot be determined, then the Find Text Dialog
|
|
will fall back to the last search text.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<!--<varlistentry>
|
|
<term id="pref-replace-tabs-by-spaces"><guilabel>Replace Tabs By
|
|
Spaces</guilabel></term> <listitem><para>&kwrite; will replace any tabs with
|
|
the number of spaces indicated in the <link linkend="pref-tab-width">Tab
|
|
Width:</link> entry.</para></listitem> </varlistentry>
|
|
|
|
<varlistentry> <term><guilabel>Show Tabs</guilabel></term>
|
|
<listitem><para>The editor will display a symbol to indicate
|
|
the presence
|
|
of a tab in the text.</para></listitem>
|
|
</varlistentry> -->
|
|
</variablelist>
|
|
</sect1>
|
|
|
|
<sect1 id="pref-indent">
|
|
<title>Indentation</title>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Automatic indentation</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Indentation mode:</guilabel></term>
|
|
<listitem>
|
|
<para>Select the automatic indentation mode you want to use as default. It is
|
|
strongly recommended to use <userinput>None</userinput> or
|
|
<userinput>Normal</userinput>here, and use filetype configurations to set other
|
|
indentation modes for text formats like C/C++ code or &XML;.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Insert leading Doxygen "*" when typing</guilabel></term>
|
|
<listitem>
|
|
<para>Automatically insert a leading "*" while typing within a doxygen
|
|
style comment. This setting is only enabled when applicable.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Indentation with Spaces</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Use spaces instead of tabs to indent</guilabel></term>
|
|
<listitem>
|
|
<para>This replaces tabs with the number of spaces set in <guilabel>Number of
|
|
spaces:</guilabel> below.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Emacs style mixed mode</guilabel></term>
|
|
<listitem>
|
|
<para>Use a mix of tabs and space characters for indentation.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Number of spaces:</guilabel></term>
|
|
<listitem>
|
|
<para>Set the number of spaces you want to use for indentation when you
|
|
check <guilabel>Use spaces instead of tabs to indent</guilabel>
|
|
above.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Keep Indent Profile</guilabel></term>
|
|
<listitem><para>When this is enabled, the editor will not unindent lines in a
|
|
selection further when the line with the least indentation becomes unindented.
|
|
If you sometimes unindent blocks of indented code, this may be helpful.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Keep Extra Spaces</guilabel></term>
|
|
<listitem><para>Indentations of more than the selected number of spaces
|
|
will not be shortened.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Keys to use</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Tab key indents</guilabel></term>
|
|
<listitem>
|
|
<para>This allows the <keycombo
|
|
action="simul"><keycap>tab</keycap></keycombo> key to be used to indent.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Backspace key indent</guilabel></term>
|
|
<listitem>
|
|
<para>This allows the <keycombo
|
|
action="simul"><keycap>backspace</keycap></keycombo> key to be used to
|
|
indent.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Tab Key Mode if Nothing Selected</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Insert indent characters</guilabel></term>
|
|
<listitem>
|
|
<para>This allows the <keycombo
|
|
action="simul"><keycap>Tab</keycap></keycombo> key insert indent
|
|
characters.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Insert tab character</guilabel></term>
|
|
<listitem>
|
|
<para>This allows the <keycombo
|
|
action="simul"><keycap>Tab</keycap></keycombo> key insert a tab.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Indent current line</guilabel></term>
|
|
<listitem>
|
|
<para>This allows the <keycombo
|
|
action="simul"><keycap>Tab</keycap></keycombo> key indent the current
|
|
line.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<!--<varlistentry>
|
|
<term><guilabel>Auto Indent</guilabel></term> <listitem><para>This causes
|
|
new lines to begin with the same indentation level as the previous
|
|
line.</para></listitem>
|
|
</varlistentry> -->
|
|
</variablelist>
|
|
</sect1>
|
|
|
|
<sect1 id="pref-open-save">
|
|
<title>Open & Save</title>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>File Format</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Encoding:</guilabel></term>
|
|
<listitem>
|
|
<para>This sets the default character encoding for your files.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>End of line:</guilabel></term>
|
|
<listitem>
|
|
<para>Choose your prefered end of line mode for your active
|
|
document. You have the choice between &UNIX;, DOS/&Windows; or Macintosh.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Automatic end of line detection</guilabel></term>
|
|
<listitem>
|
|
<para>Check this if you want the editor to autodetect the end of line
|
|
type. The first found end of line type will be used for the whole file.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Memory Usage</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Maximum loaded blocks per file:</guilabel></term>
|
|
<listitem>
|
|
<para>The editor will load given number of blocks (of around 2048 lines) of
|
|
text into memory; if the filesize is bigger than this the other blocks
|
|
are swapped to disk and loaded transparently as-needed.</para>
|
|
<para>This can cause little delays while navigating in the document; a
|
|
larger block count increases the editing speed at the cost of memory.
|
|
</para><para>For normal usage, just choose the highest possible block count:
|
|
limit it only if you have problems with the memory usage.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Automatic Cleanups on Load/Save</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Remove trailing spaces</guilabel></term>
|
|
<listitem>
|
|
<para>The editor will automatically eliminate extra spaces at the ends of lines
|
|
of text while loading/saving the file.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Folder Config File</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Search depth for config file:</guilabel></term>
|
|
<listitem>
|
|
<para>The editor will search the given number of folder levels upwards
|
|
for &kwrite; config file and load the settings line from it.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Backup on Save</guilabel></term>
|
|
<listitem><para>Backing up on save will cause &kwrite; to copy the disk file to
|
|
<prefix><filename><suffix>' before saving changes.
|
|
The suffix defaults to <emphasis role="bold">~</emphasis> and prefix is empty by
|
|
default.</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Local files</guilabel></term>
|
|
<listitem>
|
|
<para>Check this if you want backups of local files when
|
|
saving.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Remote files</guilabel></term>
|
|
<listitem>
|
|
<para>Check this if you want backups of remote files when saving.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Prefix</guilabel></term>
|
|
<listitem>
|
|
<para>Enter the prefix to prepend to the backup file names.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Suffix</guilabel></term>
|
|
<listitem>
|
|
<para>Enter the suffix to add to the backup file names.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</sect1>
|
|
|
|
<sect1 id="pref-highlighting">
|
|
<title>Highlighting</title>
|
|
<para>This group of options is used to customize the highlighting styles for
|
|
each programming language type. Any changes you made in other areas of this
|
|
dialog apply only to this type.</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Highlight:</guilabel></term>
|
|
<listitem><para>This is used to choose the language type to
|
|
configure.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Informations</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
View the properties of the chosen language highlighting rules:
|
|
author name and license.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Properties</guilabel></term>
|
|
<listitem>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>File extensions:</guilabel></term>
|
|
<listitem><para>This is the list of file extensions used to determine which
|
|
files to highlight using the current syntax highlight mode.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>MIME types:</guilabel></term>
|
|
<listitem><para>Clicking the wizard button will display a dialog with a list of
|
|
all available mime types to choose from.</para><para>The <emphasis
|
|
role="bold">File Extensions</emphasis> entry will automatically be edited as
|
|
well.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Priority:</guilabel></term>
|
|
<listitem><para>Set the priority of the highlight rule.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guibutton>Download...</guibutton></term>
|
|
<listitem>
|
|
<para>
|
|
Click this button to download new or updated syntax highlight descriptions
|
|
from the &kate; website.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
<!-- obsolete annma 24 December 2005
|
|
<para>The <guilabel>Configure
|
|
Highlighting</guilabel> dialog consists of
|
|
two pages, <guilabel>Defaults</guilabel> and <guilabel>Highlighting
|
|
Modes</guilabel>. The user can select which page to view by
|
|
clicking on the appropriate tab at the top of the dialog</para>
|
|
|
|
<para>Items available on the <guilabel>Defaults</guilabel> page are as
|
|
follows:</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Default Item Styles</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
The user can configure the default appearance for
|
|
particular items. This would allow a programmer to more easily identify
|
|
different items (types of entries) in their code.
|
|
</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Item</guilabel></term>
|
|
<listitem><para>This drop down box offers a variety of items that the user
|
|
might want to highlight. They include <guilabel>Normal</guilabel> for
|
|
text does not fit in any of the other categories, <guilabel>Comment</guilabel>,
|
|
<guilabel>String</guilabel>, <guilabel>Keyword</guilabel> and many more. Not
|
|
all of these entries will need to be configured for every language and so may be
|
|
selected as needed. The options in the rest of this section apply
|
|
to the entry selected in this box.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Normal</guilabel></term>
|
|
<listitem><para>This allows the user to choose the
|
|
item's normal (unselected) color. This is done by means
|
|
of a color selection dialog box, a further explanation of which
|
|
may be found in the <link linkend="prefcolors">Colors</link> section of <link
|
|
linkend="pref-dialog">Configure &kwrite;</link>.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Bold</guilabel></term>
|
|
<listitem><para>This option determines whether or
|
|
not the item should be displayed in bold text.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Italic</guilabel></term>
|
|
<listitem><para>This option determines whether or
|
|
not the item should be displayed in italic text.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Selected</guilabel></term>
|
|
<listitem><para>This allows the user to choose the
|
|
item's color when selected. This is done by means of a
|
|
color selection dialog box, a further explanation of which
|
|
may be found in the <link linkend="prefcolors">Colors</link> section of <link
|
|
linkend="pref-dialog">Configure &kwrite;</link>.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
<para>Items on the <guilabel>Highlight Modes</guilabel> tab allow the
|
|
user to define more specific highlighting depending on the language
|
|
style.</para>
|
|
|
|
<para>One need not set every available option, items not configured
|
|
specifically will use the default configuration specified on the
|
|
previous <guilabel>Defaults</guilabel> tab.</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Config Select</guilabel></term>
|
|
<listitem><para>This group of options is used to customize the
|
|
highlighting styles for each programming language type. Any changes you
|
|
made in other areas of this dialog apply only to this
|
|
type.</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Highlight</guilabel></term>
|
|
<listitem><para>This is used to choose the language
|
|
type to configure</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Item</guilabel></term>
|
|
<listitem><para>This is to choose the syntax item to
|
|
configure. Remember this only configures
|
|
<emphasis>this</emphasis> item for
|
|
<emphasis>this</emphasis>
|
|
language.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
<para>As an example, if the user wished to configure the
|
|
appearance of <quote>comments</quote> while writing C++, she or he
|
|
could choose C++ in the <guilabel>Highlight</guilabel> drop down box, and then
|
|
choose Comment in the <guilabel>Item</guilabel> drop down box. To have
|
|
<quote>comments</quote> look the same across all languages, the user would need
|
|
to configure this in the <guilabel>Defaults</guilabel> page of this dialog box
|
|
while leaving <quote>comments</quote> unconfigured within the more
|
|
specific <guilabel>Highlight Modes</guilabel> page.</para>
|
|
</listitem> </varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Item Style</guilabel></term>
|
|
<listitem><para>Here the user can configure the general
|
|
appearance of the above
|
|
selected item. Checking the
|
|
<guilabel>Default</guilabel> check box causes the
|
|
default style as configured on the previous tab to be set, or
|
|
the appearance can be configured directly. The available
|
|
options are the same as on the
|
|
<guilabel>Defaults</guilabel> tab:
|
|
<guilabel>Normal</guilabel>,
|
|
<guilabel>Selected</guilabel>, <guilabel>Bold</guilabel>
|
|
and <guilabel>Italic</guilabel>.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Highlight Auto Select</guilabel></term>
|
|
<listitem><para>&kwrite; can apply syntax highlighting
|
|
automatically, depending on the file extension or mime-type of the opened file.
|
|
The defaults are fairly comprehensive, but users that regularly edit files with
|
|
non-standard extensions can add them here. Wildcards are allowed in the
|
|
<guilabel>File Extensions</guilabel> text box. For example, the
|
|
default entry for the C++ language is
|
|
<userinput>*.cpp;*.cc;*.C;*.h</userinput>. Opening a file called
|
|
<filename>foo.h</filename> would automatically apply the
|
|
C++ style to it.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Item Font</guilabel></term>
|
|
<listitem><para>Here the user can choose the font for the
|
|
selected item.</para>
|
|
<para>The default style can be applied by checking the
|
|
<guilabel>Default</guilabel> check box or the user can
|
|
choose a specific font
|
|
<guilabel>Family</guilabel>, <guilabel>Size</guilabel>
|
|
and <guilabel>Charset</guilabel>. The available options are
|
|
the same as those on the <guilabel>Defaults</guilabel> tab.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>-->
|
|
</sect1>
|
|
|
|
<sect1 id="pref-filetypes">
|
|
<title>Filetypes</title>
|
|
<para>This page allows you to override the default configuration for documents
|
|
of specified mimetypes. When the editor loads a document, it will try if it
|
|
matches the file masks or mimetypes for one of the defined filetypes, and if so
|
|
apply the variables defined. If more filetypes match, the one with the highest
|
|
priority will be used.
|
|
</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Filetype:</guilabel></term>
|
|
<listitem><para>The filetype with the highest priority is the one displayed in
|
|
the first drop down box. If more filetypes were found, they are
|
|
also listed.</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>New</guilabel></term>
|
|
<listitem><para>This is used to create a new filetype. After
|
|
you click on this button, the fields below get empty and you
|
|
can fill the properties you want for the new filetype.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Delete</guilabel></term>
|
|
<listitem><para>To remove an existing filetype, select it from the drop down
|
|
box and press the Delete button.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem> </varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Properties of current filetype</guilabel></term>
|
|
<listitem><para>The filetype with the highest priority is the one displayed in
|
|
the first drop down box. If more filetypes were found, they are also
|
|
listed.</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Name:</guilabel></term>
|
|
<listitem><para>The name of the filetype will be the text of the corresponding
|
|
menu item. This name is displayed in the
|
|
<menuchoice><guimenu>Tools</guimenu><guimenuitem>Filetypes</guimenuitem>
|
|
</menuchoice ></para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Section:</guilabel></term>
|
|
<listitem><para>The section name is used to organize the file types in
|
|
menus. This is also used in the
|
|
<menuchoice><guimenu>Tools</guimenu><guimenuitem>Filetypes</guimenuitem>
|
|
</menuchoice> menu.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Variables:</guilabel></term>
|
|
<listitem><para>This string allows you to configure &kwrite;'s settings for the
|
|
files selected by this mimetype using &kwrite; variables. You can set almost any
|
|
configuration option, such as highlight, indent-mode, encoding,
|
|
etc.</para><para>For a full list of known variables, see the
|
|
manual.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>File extensions:</guilabel></term>
|
|
<listitem><para>The wildcards mask allows you to select files by filename. A
|
|
typical mask uses an asterisk and the file extension, for example
|
|
<filename>*.txt; *.text</filename>. The string is a semicolon-separated list of
|
|
masks.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>MIME types:</guilabel></term>
|
|
<listitem><para>Displays a wizard that helps you easily select
|
|
mimetypes.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Priority:</guilabel></term>
|
|
<listitem><para>Sets a priority for this file type. If more than one file type
|
|
selects the same file, the one with the highest priority will be
|
|
used.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</listitem> </varlistentry>
|
|
|
|
</variablelist>
|
|
</sect1>
|
|
|
|
<sect1 id="pref-shortcuts">
|
|
<title>Shortcuts</title>
|
|
<para>You can change here the shortcut keys configuration. Select an
|
|
action and click on <guilabel>Custom</guilabel> if you want a different shortcut
|
|
for this action.</para>
|
|
<para>The search line alllows you to look for a specific action and see
|
|
its associated shortcut.</para>
|
|
</sect1>
|
|
|
|
<sect1 id="pref-plugins">
|
|
<title>Plugins</title>
|
|
<para>This tab lists all available plugins and you can check those you
|
|
want to use. Once a plugin is checked, the
|
|
<guibutton>Configure</guibutton> button is enabled and you can click it
|
|
in order to configure the highlighted plugin.</para>
|
|
</sect1>
|
|
</chapter>
|
|
|
|
<chapter id="credits">
|
|
<title>Credits and Licenses</title>
|
|
|
|
<para>&kwrite; Copyright 2001 by the &kate; team.</para>
|
|
|
|
<para>
|
|
Based on the original &kwrite;, which was Copyright 2000 by Jochen Wilhelmy
|
|
<email>digisnap@cs.tu-berlin.de</email>
|
|
</para>
|
|
|
|
<para>Contributions:</para>
|
|
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>&Christoph.Cullmann; &Christoph.Cullmann.mail;</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>Michael Bartl <email>michael.bartl1@chello.at</email></para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>Phlip <email>phlip_cpp@my-deja.com</email></para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>&Anders.Lund; &Anders.Lund.mail;</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>Matt Newell <email>newellm@proaxis.com</email></para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>&Joseph.Wenninger; &Joseph.Wenninger.mail;</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>Jochen Wilhely <email>digisnap@cs.tu-berlin.de</email></para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>&Michael.Koch; &Michael.Koch.mail;</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>&Christian.Gebauer; &Christian.Gebauer.mail;</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>&Simon.Hausmann; &Simon.Hausmann.mail;</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>Glen Parker <email>glenebob@nwlink.com</email></para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>Scott Manson <email>sdmanson@altel.net</email></para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>&John.Firebaugh; &John.Firebaugh.mail;</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
<para>
|
|
Original documentation by &Thad.McGinnis; &Thad.McGinnis.mail;
|
|
</para>
|
|
|
|
<para>
|
|
Updated by &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; and
|
|
&Anders.Lund; &Anders.Lund.mail;
|
|
</para>
|
|
|
|
<para>
|
|
This version of the &kwrite; Handbook is based on the original by
|
|
&Cristian.Tibirna; &Cristian.Tibirna.mail;
|
|
</para>
|
|
|
|
<para>
|
|
Converted to docbook/proofreading by &Lauri.Watts; &Lauri.Watts.mail;
|
|
</para>
|
|
|
|
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
|
|
|
|
&underFDL;
|
|
&underGPL;
|
|
</chapter>
|
|
|
|
&documentation.index;
|
|
</book>
|