diff options
Diffstat (limited to 'tde-i18n-en_GB/docs/tdebase')
201 files changed, 12872 insertions, 50125 deletions
diff --git a/tde-i18n-en_GB/docs/tdebase/faq/about.docbook b/tde-i18n-en_GB/docs/tdebase/faq/about.docbook index 02fc73b3111..e407bc656d0 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/about.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/about.docbook @@ -5,64 +5,34 @@ --> <chapter id="about"> -<title ->About this <acronym ->FAQ</acronym -></title> +<title>About this <acronym>FAQ</acronym></title> <qandaset> <qandaentry> <question> -<para ->What can I do to help out with this <acronym ->FAQ</acronym ->?</para> +<para>What can I do to help out with this <acronym>FAQ</acronym>?</para> </question> <answer> -<para ->First, send us any errors that you may find. Also, any suggestions that you might have, are appreciated. Better yet, send us everything that you think is unclear, and if possible, send us what you think would be a clearer solution. Our email address is <email ->kde-doc-english@kde.org</email ->. </para> +<para>First, send us any errors that you may find. Also, any suggestions that you might have, are appreciated. Better yet, send us everything that you think is unclear, and if possible, send us what you think would be a clearer solution. Our email address is <email>kde-doc-english@kde.org</email>. </para> -<para ->Second, send us your solutions of those frequently-asked questions which are still not in this <acronym ->FAQ</acronym ->. We will put them in as soon as possible.</para> +<para>Second, send us your solutions of those frequently-asked questions which are still not in this <acronym>FAQ</acronym>. We will put them in as soon as possible.</para> -<para ->Last but not least, please make full use of this <acronym ->FAQ</acronym ->. Read this <acronym ->FAQ</acronym -> (and other relevant documentation) well before asking questions on the various &kde; mailing lists or newsgroups.</para> +<para>Last but not least, please make full use of this <acronym>FAQ</acronym>. Read this <acronym>FAQ</acronym> (and other relevant documentation) well before asking questions on the various &kde; mailing lists or newsgroups.</para> -<note -><para ->You might also want to consider becoming a <acronym ->FAQ</acronym -> maintainer. Please refer to <xref linkend="FAQ-maintainer-HOWTO"/> for more details. </para -></note> +<note><para>You might also want to consider becoming a <acronym>FAQ</acronym> maintainer. Please refer to <xref linkend="FAQ-maintainer-HOWTO"/> for more details. </para></note> </answer> </qandaentry> <qandaentry> <question id="FAQ-maintainer-HOWTO"> -<para ->How do I become a <acronym ->FAQ</acronym -> maintainer?</para> +<para>How do I become a <acronym>FAQ</acronym> maintainer?</para> </question> <answer> -<para ->Actually, it is very easy to become an <acronym ->FAQ</acronym -> maintainer, and we are always in need of fresh blood. :-) Just send us an email at <email ->kde-doc-english@kde.org</email ->. </para> +<para>Actually, it is very easy to become an <acronym>FAQ</acronym> maintainer, and we are always in need of fresh blood. :-) Just send us an email at <email>kde-doc-english@kde.org</email>. </para> </answer> </qandaentry> </qandaset> diff --git a/tde-i18n-en_GB/docs/tdebase/faq/configtde.docbook b/tde-i18n-en_GB/docs/tdebase/faq/configtde.docbook index 65168d58065..452e2bc04fd 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/configtde.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/configtde.docbook @@ -3,62 +3,24 @@ <!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd"> --> <chapter id="configure"> -<title ->Configuring &kde;</title> +<title>Configuring &kde;</title> <qandaset> <qandaentry> <question> -<para ->How do I set the language used by &kde;?</para> +<para>How do I set the language used by &kde;?</para> </question> <answer> -<para ->There are two ways to set the language &kde; uses in the messages it will display:</para> +<para>There are two ways to set the language &kde; uses in the messages it will display:</para> <variablelist> -<varlistentry -><term ->Using the <application ->&kde; Control Centre</application -></term> -<listitem -><para ->Fire up the <application ->&kde; Control Centre</application -> and select <guimenu ->Regional & Accessibility</guimenu -> followed by <guimenuitem ->Country/Region & Language</guimenuitem ->. You can select your language and location here. If &kde; cannot find a translation in the first language chosen, it will fall back on the default language. This is usually (American) English by default.</para> -<note -><para ->Using the <application ->&kde; Control Centre</application -> is the preferred way of choosing languages in &kde;.</para -></note -></listitem> +<varlistentry><term>Using the <application>&kde; Control Centre</application></term> +<listitem><para>Fire up the <application>&kde; Control Centre</application> and select <guimenu>Regional & Accessibility</guimenu> followed by <guimenuitem>Country/Region & Language</guimenuitem>. You can select your language and location here. If &kde; cannot find a translation in the first language chosen, it will fall back on the default language. This is usually (American) English by default.</para> +<note><para>Using the <application>&kde; Control Centre</application> is the preferred way of choosing languages in &kde;.</para></note></listitem> </varlistentry> -<varlistentry -><term ->Using the <envar ->LANG</envar -> environment variable</term> -<listitem -><para ->The second method uses the standard locale setting on your system. To change the language, simply set the environment variable <envar ->LANG</envar -> accordingly. For example, if your shell is <application ->bash</application ->, execute <userinput -><command ->export</command -> <envar ->LANG</envar ->=de</userinput -> to set German as the language used.</para -></listitem> +<varlistentry><term>Using the <envar>LANG</envar> environment variable</term> +<listitem><para>The second method uses the standard locale setting on your system. To change the language, simply set the environment variable <envar>LANG</envar> accordingly. For example, if your shell is <application>bash</application>, execute <userinput><command>export</command> <envar>LANG</envar>=de</userinput> to set German as the language used.</para></listitem> </varlistentry> </variablelist> </answer> @@ -66,280 +28,98 @@ <qandaentry> <question> -<para ->Is there any keyboard switcher for international keyboards for &kde;?</para> +<para>Is there any keyboard switcher for international keyboards for &kde;?</para> </question> <answer> -<para ->Yes, you can configure it using the <application ->&kde; Control Centre</application -> <guimenu ->Regional & Accessibility</guimenu -> <guimenuitem ->Keyboard Layout</guimenuitem -> configuration page. </para> +<para>Yes, you can configure it using the <application>&kde; Control Centre</application> <guimenu>Regional & Accessibility</guimenu> <guimenuitem>Keyboard Layout</guimenuitem> configuration page. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I replace the standard text login screen with the &kde; login screen?</para> +<para>How do I replace the standard text login screen with the &kde; login screen?</para> </question> <answer> -<note -><para ->Your distribution/&UNIX; flavour may have its own setup tools to change this (⪚ <application ->YaST</application -> on &SuSE; &Linux;). This will be the safest way to enable the &kde; login screen. However, if for some reason you do not wish to use these tools, the following instructions may be useful.</para -></note> -<para ->First, you need to change to the <quote ->xdm runlevel</quote -> (runlevel 5 on &RedHat; and &SuSE; systems) by editing your <filename ->/etc/inittab</filename -> file. In the file, you should have a line saying <userinput ->id:3:initdefault:</userinput ->. Change it to <userinput ->id:5:initdefault:</userinput ->. Now, at the end of the file, comment out the following line: <literal ->x:5:respawn:/usr/bin/X11/xdm -nodaemon</literal -> and replace it with <userinput ->x:5:respawn:<replaceable ->/opt/kde/</replaceable ->bin/tdm -nodaemon</userinput ->. <note -><para ->The location of &tdm; may differ on your system.</para -></note -></para> -<para ->For changes to take effect immediately, type <command ->init 5</command -> (for &RedHat; systems) at the shell prompt. <caution -><para ->It is risky to initiate a graphical login without checking beforehand whether it works. If it fails to work, you would be in for a hard time getting back....</para -></caution -></para> +<note><para>Your distribution/&UNIX; flavour may have its own setup tools to change this (⪚ <application>YaST</application> on &SuSE; &Linux;). This will be the safest way to enable the &kde; login screen. However, if for some reason you do not wish to use these tools, the following instructions may be useful.</para></note> +<para>First, you need to change to the <quote>xdm runlevel</quote> (runlevel 5 on &RedHat; and &SuSE; systems) by editing your <filename>/etc/inittab</filename> file. In the file, you should have a line saying <userinput>id:3:initdefault:</userinput>. Change it to <userinput>id:5:initdefault:</userinput>. Now, at the end of the file, comment out the following line: <literal>x:5:respawn:/usr/bin/X11/xdm -nodaemon</literal> and replace it with <userinput>x:5:respawn:<replaceable>/opt/kde/</replaceable>bin/tdm -nodaemon</userinput>. <note><para>The location of &tdm; may differ on your system.</para></note></para> +<para>For changes to take effect immediately, type <command>init 5</command> (for &RedHat; systems) at the shell prompt. <caution><para>It is risky to initiate a graphical login without checking beforehand whether it works. If it fails to work, you would be in for a hard time getting back....</para></caution></para> </answer> <answer> -<para ->For FreeBSD, you should edit the file <filename ->/etc/ttys</filename -> and change one of the lines that look like <programlisting ->ttyv8 "/usr/X11R6/bin/xdm -nodaemon" xterm off secure</programlisting -> to instead say <userinput ->ttyv8 "/usr/local/bin/tdm -nodaemon" xterm off secure</userinput ->.</para> +<para>For FreeBSD, you should edit the file <filename>/etc/ttys</filename> and change one of the lines that look like <programlisting>ttyv8 "/usr/X11R6/bin/xdm -nodaemon" xterm off secure</programlisting> to instead say <userinput>ttyv8 "/usr/local/bin/tdm -nodaemon" xterm off secure</userinput>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->I would like to click the &LMB; anywhere on the desktop and have the <guimenu ->K</guimenu -> menu displayed.</para> +<para>I would like to click the &LMB; anywhere on the desktop and have the <guimenu>K</guimenu> menu displayed.</para> </question> <answer> -<para ->Open the <application ->&kde; Control Centre</application -> and choose <menuchoice -><guisubmenu ->Desktop</guisubmenu -> <guisubmenu ->Behaviour</guisubmenu -></menuchoice ->. You can now choose the behaviour of mouse clicks on the desktop. To have the <guimenu ->K</guimenu -> menu open from a single &LMB; click, change the entry labelled <guilabel ->Left button</guilabel -> to say <guilabel ->Application Menu</guilabel ->.</para> +<para>Open the <application>&kde; Control Centre</application> and choose <menuchoice><guisubmenu>Desktop</guisubmenu> <guisubmenu>Behaviour</guisubmenu></menuchoice>. You can now choose the behaviour of mouse clicks on the desktop. To have the <guimenu>K</guimenu> menu open from a single &LMB; click, change the entry labelled <guilabel>Left button</guilabel> to say <guilabel>Application Menu</guilabel>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Where do I find information regarding &kde; themes?</para> +<para>Where do I find information regarding &kde; themes?</para> </question> <answer> -<para ->Go to <ulink url="http://kde.themes.org/" ->http://kde.themes.org/</ulink -> or <ulink url="http://www.kde-look.org" ->http://www.kde-look.org</ulink ->.</para> +<para>Go to <ulink url="http://kde.themes.org/">http://kde.themes.org/</ulink> or <ulink url="http://www.kde-look.org">http://www.kde-look.org</ulink>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I change &MIME; Types?</para> +<para>How do I change &MIME; Types?</para> </question> <answer> -<para ->If you are using &konqueror;, do this instead: first, open a &konqueror; window and choose <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure Konqueror</guimenuitem -></menuchoice ->, then <guilabel ->File Associations</guilabel ->. Find the type you want to change (⪚ <literal ->text/english</literal -> or <literal ->image/gif</literal ->), and set the application preference order to whatever you want.</para> +<para>If you are using &konqueror;, do this instead: first, open a &konqueror; window and choose <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror</guimenuitem></menuchoice>, then <guilabel>File Associations</guilabel>. Find the type you want to change (⪚ <literal>text/english</literal> or <literal>image/gif</literal>), and set the application preference order to whatever you want.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->&kde; (&tdm;) does not read my <filename ->.bash_profile</filename ->!</para> +<para>&kde; (&tdm;) does not read my <filename>.bash_profile</filename>!</para> </question> <answer> -<para ->The login managers<application ->xdm</application -> and &tdm; do not run a login shell, so <filename ->.profile</filename ->, <filename ->.bash_profile</filename ->, &etc; are not sourced. When the user logs in, <application ->xdm</application -> runs <command ->Xstartup</command -> as root and then <command ->Xsession</command -> as user. So the normal practice is to add statements in <filename ->Xsession</filename -> to source the user profile. Please edit your <filename ->Xsession</filename -> and <filename ->.xsession</filename -> files.</para> +<para>The login managers<application>xdm</application> and &tdm; do not run a login shell, so <filename>.profile</filename>, <filename>.bash_profile</filename>, &etc; are not sourced. When the user logs in, <application>xdm</application> runs <command>Xstartup</command> as root and then <command>Xsession</command> as user. So the normal practice is to add statements in <filename>Xsession</filename> to source the user profile. Please edit your <filename>Xsession</filename> and <filename>.xsession</filename> files.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I use &TrueType; fonts in &kde;?</para> +<para>How do I use &TrueType; fonts in &kde;?</para> </question> <answer> -<para ->You need to install &TrueType; font support into your &X-Window; configuration. Please take a look at <ulink url="http://x.themes.org/" ->x.themes.org</ulink -> for the fonts, and <ulink url="http://www.dcs.ed.ac.uk/home/jec/programs/xfsft/" ->xfsft: &TrueType; Font Support For X11</ulink -> or <ulink url="http://X-TT.dsl.gr.jp/" ->X-&TrueType; Server Project Home Page</ulink -> for the font servers.</para> +<para>You need to install &TrueType; font support into your &X-Window; configuration. Please take a look at <ulink url="http://x.themes.org/">x.themes.org</ulink> for the fonts, and <ulink url="http://www.dcs.ed.ac.uk/home/jec/programs/xfsft/">xfsft: &TrueType; Font Support For X11</ulink> or <ulink url="http://X-TT.dsl.gr.jp/">X-&TrueType; Server Project Home Page</ulink> for the font servers.</para> -<para ->If you have a bunch of &TrueType; fonts from &Microsoft; &Windows;, edit the <filename ->XF86Config</filename -> file to get the fonts from the font folder. Then just tell &kde; to use these new fonts with the font administrator utility.</para> +<para>If you have a bunch of &TrueType; fonts from &Microsoft; &Windows;, edit the <filename>XF86Config</filename> file to get the fonts from the font folder. Then just tell &kde; to use these new fonts with the font administrator utility.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Is it possible to enter, show and work with the Euro Symbol in &kde;?</para> +<para>Is it possible to enter, show and work with the Euro Symbol in &kde;?</para> </question> <answer> -<para ->Yes and no. For details, look here: <ulink url="http://www.koffice.org/kword/euro.php" ->http://www.koffice.org/kword/euro.php</ulink ->.</para> +<para>Yes and no. For details, look here: <ulink url="http://www.koffice.org/kword/euro.php">http://www.koffice.org/kword/euro.php</ulink>.</para> </answer> </qandaentry> <qandaentry> -<question -><para ->How do I run a program at &kde; startup?</para -></question> +<question><para>How do I run a program at &kde; startup?</para></question> -<answer -><para ->There are many ways to do that. If what you want to do is to run some scripts that would set some environment variables (for example, to start <command ->gpg-agent</command ->, <command ->ssh-agent</command -> and others), you can put these scripts into <filename class="directory" ->$<envar ->TDEHOME</envar ->/env/</filename -> and make sure their names end in <literal role="extension" ->.sh</literal ->. $<envar ->TDEHOME</envar -> is usually a folder named <filename class="directory" ->.kde</filename -> (note the period at the beginning) in your home folder. If you want scripts to be executed for all &kde; users, you can put them under <filename class="directory" ->$<envar ->TDEDIR</envar ->/env/</filename ->, where $<envar ->TDEDIR</envar -> is the prefix &kde; was installed to (you can find this out using the command <userinput -><command ->tde-config</command -> --prefix</userinput ->).</para> -<para ->If you wish to start a program after &kde; has started, you may want to use the <filename class="directory" ->Autostart</filename -> folder. To add entries to the <filename class="directory" ->Autostart</filename -> folder: <orderedlist> -<listitem -><para ->Open &konqueror;.</para> +<answer><para>There are many ways to do that. If what you want to do is to run some scripts that would set some environment variables (for example, to start <command>gpg-agent</command>, <command>ssh-agent</command> and others), you can put these scripts into <filename class="directory">$<envar>TDEHOME</envar>/env/</filename> and make sure their names end in <literal role="extension">.sh</literal>. $<envar>TDEHOME</envar> is usually a folder named <filename class="directory">.kde</filename> (note the period at the beginning) in your home folder. If you want scripts to be executed for all &kde; users, you can put them under <filename class="directory">$<envar>TDEDIR</envar>/env/</filename>, where $<envar>TDEDIR</envar> is the prefix &kde; was installed to (you can find this out using the command <userinput><command>tde-config</command> --prefix</userinput>).</para> +<para>If you wish to start a program after &kde; has started, you may want to use the <filename class="directory">Autostart</filename> folder. To add entries to the <filename class="directory">Autostart</filename> folder: <orderedlist> +<listitem><para>Open &konqueror;.</para> </listitem> -<listitem -><para ->Select <menuchoice -><guimenu ->Go</guimenu -><guimenuitem ->Autostart</guimenuitem -> </menuchoice -> from the menubar.</para> +<listitem><para>Select <menuchoice><guimenu>Go</guimenu><guimenuitem>Autostart</guimenuitem> </menuchoice> from the menubar.</para> </listitem> -<listitem -><para ->Right-click in the window view area and select <menuchoice -><guisubmenu ->Create New</guisubmenu -><guisubmenu ->File</guisubmenu -><guimenuitem ->Link to Application</guimenuitem -> </menuchoice -></para> +<listitem><para>Right-click in the window view area and select <menuchoice><guisubmenu>Create New</guisubmenu><guisubmenu>File</guisubmenu><guimenuitem>Link to Application</guimenuitem> </menuchoice></para> </listitem> -<listitem -><para ->Click on the <guilabel ->Application</guilabel -> tab in the window that appears and enter the name of the command to run in the <guilabel ->Command</guilabel -> text box.</para> +<listitem><para>Click on the <guilabel>Application</guilabel> tab in the window that appears and enter the name of the command to run in the <guilabel>Command</guilabel> text box.</para> </listitem> </orderedlist> </para> diff --git a/tde-i18n-en_GB/docs/tdebase/faq/contrib.docbook b/tde-i18n-en_GB/docs/tdebase/faq/contrib.docbook index 8bff6911cd5..4a5a5a7b8ee 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/contrib.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/contrib.docbook @@ -6,241 +6,92 @@ <chapter id="contribute"> -<title ->Contributing</title> +<title>Contributing</title> <qandaset> <qandaentry> <question> -<para ->How can I contribute to &kde;?</para> +<para>How can I contribute to &kde;?</para> </question> <answer> -<para ->&kde; is a free software project that lives from voluntary contributions. Everybody is encouraged to contribute to &kde;. Not only programmers are welcome. There are many ways in which you can help to improve &kde;:</para> +<para>&kde; is a free software project that lives from voluntary contributions. Everybody is encouraged to contribute to &kde;. Not only programmers are welcome. There are many ways in which you can help to improve &kde;:</para> <itemizedlist> -<listitem -><para ->Test the software.</para -></listitem> -<listitem -><para ->Send in bug reports. For more information on this, see <link linkend="bug-report" ->How do I submit a bug report?</link ->.</para -></listitem> -<listitem -><para ->Write documentation or help files. You can get some information by visiting the <ulink url="http://i18n.kde.org/doc/" ->&kde; Editorial Team Home Page</ulink ->.</para -></listitem> -<listitem -><para ->Translate programs, documentation, and help files. For more information on this, you should visit <ulink url="http://i18n.kde.org" ->The &kde; Translators' and Documenters' Web Site</ulink ->.</para -></listitem> -<listitem -><para ->Draw nice icons or compose sound effects. You can visit the <ulink url="http://artist.kde.org/" ->&kde; artists page</ulink -> to find out more.</para -></listitem> -<listitem -><para ->Write articles and books about &kde;. If you want to help spread the word about &kde;, simply send an email to <email ->kde-pr@kde.org</email ->. This will get you in touch with the &kde; public relations volunteers.</para -></listitem> -<listitem -><para ->Program new &kde; applications. Please refer to <xref linkend="programming"/> for more information.</para -></listitem> -<listitem -><para ->Of course, sponsors are also welcome. :-)</para -></listitem> +<listitem><para>Test the software.</para></listitem> +<listitem><para>Send in bug reports. For more information on this, see <link linkend="bug-report">How do I submit a bug report?</link>.</para></listitem> +<listitem><para>Write documentation or help files. You can get some information by visiting the <ulink url="http://i18n.kde.org/doc/">&kde; Editorial Team Home Page</ulink>.</para></listitem> +<listitem><para>Translate programs, documentation, and help files. For more information on this, you should visit <ulink url="http://i18n.kde.org">The &kde; Translators' and Documenters' Web Site</ulink>.</para></listitem> +<listitem><para>Draw nice icons or compose sound effects. You can visit the <ulink url="http://artist.kde.org/">&kde; artists page</ulink> to find out more.</para></listitem> +<listitem><para>Write articles and books about &kde;. If you want to help spread the word about &kde;, simply send an email to <email>kde-pr@kde.org</email>. This will get you in touch with the &kde; public relations volunteers.</para></listitem> +<listitem><para>Program new &kde; applications. Please refer to <xref linkend="programming"/> for more information.</para></listitem> +<listitem><para>Of course, sponsors are also welcome. :-)</para></listitem> </itemizedlist> -<para ->There are several places to look for more information if you want to get involved in the development. The first step is to subscribe to some of the <ulink url="http://www.kde.org/mailinglists/" ->mailing lists</ulink ->. You will soon see something that can be improved or added.</para> +<para>There are several places to look for more information if you want to get involved in the development. The first step is to subscribe to some of the <ulink url="http://www.kde.org/mailinglists/">mailing lists</ulink>. You will soon see something that can be improved or added.</para> </answer> </qandaentry> <qandaentry> <question id="bug-report"> -<para ->How do I submit a bug report?</para> +<para>How do I submit a bug report?</para> </question> <answer> -<para ->There is a bug tracking system available at <ulink url="http://bugs.kde.org" ->http://bugs.kde.org</ulink ->. The system features a wizard to submit new bug reports and a list of all known bugs.</para> -<para ->The easiest way to submit a bug is to select <menuchoice -><guimenu ->Help</guimenu -><guimenuitem ->Report Bug...</guimenuitem -></menuchoice -> from the menu bar of the application with the bug. This will open a small dialogue box with a link to the bug tracking system. Please make sure to follow the instructions of the bug reporting wizard.</para> +<para>There is a bug tracking system available at <ulink url="http://bugs.kde.org">http://bugs.kde.org</ulink>. The system features a wizard to submit new bug reports and a list of all known bugs.</para> +<para>The easiest way to submit a bug is to select <menuchoice><guimenu>Help</guimenu><guimenuitem>Report Bug...</guimenuitem></menuchoice> from the menu bar of the application with the bug. This will open a small dialogue box with a link to the bug tracking system. Please make sure to follow the instructions of the bug reporting wizard.</para> </answer> </qandaentry> <qandaentry> <question id="programming"> -<para ->I want to program for &kde;. What should I do first?</para> +<para>I want to program for &kde;. What should I do first?</para> </question> <answer> -<para ->Everybody is encouraged to develop software for &kde;. What you should do first depends strongly on your experience, ⪚ whether you have already learned C++ or have experience with the &Qt; toolkit and so on.</para> -<para ->To get into &kde; programming, you will need some basic tools: <application ->automake</application ->, <application ->autoconf</application ->, and <application ->egcs</application ->. You should look to <ulink url="http://developer.kde.org/" ->http://developer.kde.org/</ulink -> for more tips.</para> -<para ->Another excellent resource for learning &kde; programming is the &Qt; online tutorials. These are installed along with &Qt;. To view them, open <filename ->$<envar ->QTDIR</envar ->/doc/html/index.html</filename -> in &konqueror; and bookmark it. The tutorials can be found under "Using Qt". The source code for each lesson can be found in the <filename class="directory" ->$<envar ->QTDIR</envar ->/tutorial</filename -> directory.</para> -<para ->There is, however, one thing that everybody interested in programming for &kde; should do: <emphasis ->subscribe to the developers mailing list</emphasis ->. To subscribe, you have to send an email to <ulink url="mailto:kde-devel-request@kde.org" ->kde-devel-request@kde.org</ulink -> with the subject <userinput ->subscribe <replaceable ->your_email_address</replaceable -></userinput ->. <important -><para ->Please read <link linkend="subscribe" ->How to subscribe/unsubscribe to these lists</link -> carefully. Everything said there applies to the development list as well.</para -></important -></para> +<para>Everybody is encouraged to develop software for &kde;. What you should do first depends strongly on your experience, ⪚ whether you have already learned C++ or have experience with the &Qt; toolkit and so on.</para> +<para>To get into &kde; programming, you will need some basic tools: <application>automake</application>, <application>autoconf</application>, and <application>egcs</application>. You should look to <ulink url="http://developer.kde.org/">http://developer.kde.org/</ulink> for more tips.</para> +<para>Another excellent resource for learning &kde; programming is the &Qt; online tutorials. These are installed along with &Qt;. To view them, open <filename>$<envar>QTDIR</envar>/doc/html/index.html</filename> in &konqueror; and bookmark it. The tutorials can be found under "Using Qt". The source code for each lesson can be found in the <filename class="directory">$<envar>QTDIR</envar>/tutorial</filename> directory.</para> +<para>There is, however, one thing that everybody interested in programming for &kde; should do: <emphasis>subscribe to the developers mailing list</emphasis>. To subscribe, you have to send an email to <ulink url="mailto:kde-devel-request@kde.org">kde-devel-request@kde.org</ulink> with the subject <userinput>subscribe <replaceable>your_email_address</replaceable></userinput>. <important><para>Please read <link linkend="subscribe">How to subscribe/unsubscribe to these lists</link> carefully. Everything said there applies to the development list as well.</para></important></para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I get access to the <acronym ->CVS</acronym ->?</para> +<para>How do I get access to the <acronym>CVS</acronym>?</para> </question> <answer> -<para ->The &kde; project uses <acronym ->CVS</acronym -> to develop the core parts of the software. Usually, when you have changed one of the parts (⪚ fixed a bug), and you want to commit this change, the best way is to create a patch against a current snapshot and send this patch to the developer/maintainer of the respective program.</para> -<para ->If you are doing this more or less regularly, you can ask Stephan Kulow, <email ->coolo@kde.org</email -> for direct access to the <acronym ->CVS</acronym -> server. But be aware that more users will slow down <acronym ->CVS</acronym -> access for all developers, so we want to keep the number of people with direct <acronym ->CVS</acronym -> access reasonably small. But feel free to ask!</para> +<para>The &kde; project uses <acronym>CVS</acronym> to develop the core parts of the software. Usually, when you have changed one of the parts (⪚ fixed a bug), and you want to commit this change, the best way is to create a patch against a current snapshot and send this patch to the developer/maintainer of the respective program.</para> +<para>If you are doing this more or less regularly, you can ask Stephan Kulow, <email>coolo@kde.org</email> for direct access to the <acronym>CVS</acronym> server. But be aware that more users will slow down <acronym>CVS</acronym> access for all developers, so we want to keep the number of people with direct <acronym>CVS</acronym> access reasonably small. But feel free to ask!</para> </answer> </qandaentry> <qandaentry> <question> -<para ->I am just curious. Can I have read-only access to the <acronym ->CVS</acronym ->?</para> +<para>I am just curious. Can I have read-only access to the <acronym>CVS</acronym>?</para> </question> <answer> -<para ->Yes. It is possible to get read-only access to the <acronym ->CVS</acronym -> repository with <application ->cvsup</application -> or <application ->cvs</application -> utility. You can find more information about how to set up <application ->cvsup</application -> for the &kde; repository from <ulink url="http://developer.kde.org/source/cvsup.html" ->How to use <application ->cvsup</application -> to get &kde;</ulink ->.</para> -<para ->In addition, anonymous <acronym ->CVS</acronym -> service is also available. To find out more about how to set up and use anonymous <acronym ->CVS</acronym ->, please see <ulink url="http://developer.kde.org/source/anoncvs.html" ->here</ulink ->.</para> +<para>Yes. It is possible to get read-only access to the <acronym>CVS</acronym> repository with <application>cvsup</application> or <application>cvs</application> utility. You can find more information about how to set up <application>cvsup</application> for the &kde; repository from <ulink url="http://developer.kde.org/source/cvsup.html">How to use <application>cvsup</application> to get &kde;</ulink>.</para> +<para>In addition, anonymous <acronym>CVS</acronym> service is also available. To find out more about how to set up and use anonymous <acronym>CVS</acronym>, please see <ulink url="http://developer.kde.org/source/anoncvs.html">here</ulink>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Are there any <application ->cvs</application -> mirror sites for &kde;?</para> +<para>Are there any <application>cvs</application> mirror sites for &kde;?</para> </question> <answer> -<para ->Yes. The main &kde; server is normally very busy. Please take a look at <ulink url="http://developer.kde.org/source/cvsupmirrors.html" ->http://developer.kde.org/source/cvsupmirrors.html</ulink -> and <ulink url="http://developer.kde.org/source/anoncvs.html" ->http://developer.kde.org/source/anoncvs.html</ulink -> for the list of available mirrors.</para -> -<para ->Once you have selected a new <application ->cvsup</application -> server, simply replace <screen -> +<para>Yes. The main &kde; server is normally very busy. Please take a look at <ulink url="http://developer.kde.org/source/cvsupmirrors.html">http://developer.kde.org/source/cvsupmirrors.html</ulink> and <ulink url="http://developer.kde.org/source/anoncvs.html">http://developer.kde.org/source/anoncvs.html</ulink> for the list of available mirrors.</para> +<para>Once you have selected a new <application>cvsup</application> server, simply replace <screen> *default host=cvs.kde.org -</screen -> with <screen -> +</screen> with <screen> *default host=cvsup.your.new.host -</screen -> in your <application ->cvsup</application -> script.</para> -<para ->The instructions to change the anoncvs server can be found on <ulink url="http://developer.kde.org/source/anoncvs.html" ->http://developer.kde.org/source/anoncvs.html</ulink ->, too. </para> +</screen> in your <application>cvsup</application> script.</para> +<para>The instructions to change the anoncvs server can be found on <ulink url="http://developer.kde.org/source/anoncvs.html">http://developer.kde.org/source/anoncvs.html</ulink>, too. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I go about translating &kde; programs into my native language?</para> +<para>How do I go about translating &kde; programs into my native language?</para> </question> <answer> -<para ->Look at the <ulink url="http://i18n.kde.org" ->The &kde; Translators' and Documenters' Web Site</ulink -> to see whether your program is already translated (most are). Otherwise you will find information there on how to do it yourself.</para> +<para>Look at the <ulink url="http://i18n.kde.org">The &kde; Translators' and Documenters' Web Site</ulink> to see whether your program is already translated (most are). Otherwise you will find information there on how to do it yourself.</para> </answer> </qandaentry> </qandaset> diff --git a/tde-i18n-en_GB/docs/tdebase/faq/desktop.docbook b/tde-i18n-en_GB/docs/tdebase/faq/desktop.docbook index 93bddd4bcad..a523f222b83 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/desktop.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/desktop.docbook @@ -5,55 +5,29 @@ --> <chapter id="desktop"> -<title ->The desktop</title> +<title>The desktop</title> <qandaset> <qandaentry> <question> -<para ->How do I add an application to the desktop?</para> +<para>How do I add an application to the desktop?</para> </question> <answer> -<para ->Just choose the desired application from the <guimenu ->K</guimenu -> menu and drag and drop it to the Desktop. </para -> -<para ->For applications not listed in the <guimenu ->K</guimenu -> menu, use the &RMB; on the desktop and choose <menuchoice -><guimenuitem ->Create New</guimenuitem -><guisubmenu ->File</guisubmenu -> <guimenuitem ->Link to Application...</guimenuitem -></menuchoice -> and fill in the configuration for the application you want to link to. </para> +<para>Just choose the desired application from the <guimenu>K</guimenu> menu and drag and drop it to the Desktop. </para> +<para>For applications not listed in the <guimenu>K</guimenu> menu, use the &RMB; on the desktop and choose <menuchoice><guimenuitem>Create New</guimenuitem><guisubmenu>File</guisubmenu> <guimenuitem>Link to Application...</guimenuitem></menuchoice> and fill in the configuration for the application you want to link to. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I mount/unmount a device from the desktop?</para> +<para>How do I mount/unmount a device from the desktop?</para> </question> <answer> -<para ->First, make sure you are allowed to <command ->mount</command ->/<command ->umount</command -> the relevant device as a user. </para> -<para ->Then you can add any device via &RMB; on the desktop and then choosing <guimenuitem ->Create New</guimenuitem ->. </para> +<para>First, make sure you are allowed to <command>mount</command>/<command>umount</command> the relevant device as a user. </para> +<para>Then you can add any device via &RMB; on the desktop and then choosing <guimenuitem>Create New</guimenuitem>. </para> </answer> </qandaentry> @@ -61,90 +35,48 @@ <qandaentry> <question> -<para ->Where are the icons kept?</para> +<para>Where are the icons kept?</para> </question> <answer> -<para ->The icons can be found only in <filename class="directory" ->$<envar ->TDEDIRS</envar ->/share/icons</filename -> or <filename class="directory" ->$<envar ->HOME</envar ->/.trinity/share/icons</filename -> or <filename class="directory" ->$<envar ->HOME</envar ->/.kde2/share/icons</filename ->. To use icons stored in other locations, you must either copy them into one of the above-mentioned fixed &kde; locations or make symlinks.</para> +<para>The icons can be found only in <filename class="directory">$<envar>TDEDIRS</envar>/share/icons</filename> or <filename class="directory">$<envar>HOME</envar>/.trinity/share/icons</filename> or <filename class="directory">$<envar>HOME</envar>/.kde2/share/icons</filename>. To use icons stored in other locations, you must either copy them into one of the above-mentioned fixed &kde; locations or make symlinks.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I use the mouse scroll wheel in &kde;?</para> +<para>How do I use the mouse scroll wheel in &kde;?</para> </question> <answer> -<para ->Mouse wheel support comes with &Qt; 2.0 and above, so &kde; based on that will automatically support the use of the mouse scroll wheel.</para> +<para>Mouse wheel support comes with &Qt; 2.0 and above, so &kde; based on that will automatically support the use of the mouse scroll wheel.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Why can't I get system sound to work, like for opening windows?</para> +<para>Why can't I get system sound to work, like for opening windows?</para> </question> <answer> -<para ->System sound currently does not work on non-FreeBSD and non-&Linux; systems. This is being worked on. If you use FreeBSD or &Linux;, you have found a bug, so please report it.</para> +<para>System sound currently does not work on non-FreeBSD and non-&Linux; systems. This is being worked on. If you use FreeBSD or &Linux;, you have found a bug, so please report it.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I launch applications in a particular desktop?</para> +<para>How do I launch applications in a particular desktop?</para> </question> <answer> -<para ->&kde; comes with a program called &kstart;. To start an <application ->xterm</application -> on the second desktop and then activate it use: <userinput -><command ->kstart</command -> <option ->--desktop 2 --activate --window "xterm" </option ->xterm</userinput ->.</para> -<para ->Note that the <option ->--window</option -> option is important. It takes an argument which is a regular expression matching the title of the window to apply the settings to.</para> -<para ->Please read <command ->kstart</command -> <option ->--help-all</option -> for more magic available with &kstart; (and there is an abundance). </para> +<para>&kde; comes with a program called &kstart;. To start an <application>xterm</application> on the second desktop and then activate it use: <userinput><command>kstart</command> <option>--desktop 2 --activate --window "xterm" </option>xterm</userinput>.</para> +<para>Note that the <option>--window</option> option is important. It takes an argument which is a regular expression matching the title of the window to apply the settings to.</para> +<para>Please read <command>kstart</command> <option>--help-all</option> for more magic available with &kstart; (and there is an abundance). </para> </answer> </qandaentry> <qandaentry> <question> -<para ->Where do I save my files if I want them to appear directly on the desktop?</para> +<para>Where do I save my files if I want them to appear directly on the desktop?</para> </question> <answer> -<para -><filename class="directory" ->$<envar ->HOME</envar ->/Desktop</filename ->. You might need to refresh your desktop after you have saved your files.</para> +<para><filename class="directory">$<envar>HOME</envar>/Desktop</filename>. You might need to refresh your desktop after you have saved your files.</para> </answer> </qandaentry> </qandaset> diff --git a/tde-i18n-en_GB/docs/tdebase/faq/filemng.docbook b/tde-i18n-en_GB/docs/tdebase/faq/filemng.docbook index b4c08665d1b..07619947f8e 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/filemng.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/filemng.docbook @@ -1,359 +1,142 @@ <!-- <?xml version="1.0" ?> <!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" - "dtd/kdex.dtd" -> --> + "dtd/kdex.dtd"> --> <chapter id="filemanager"> -<title ->The File Manager and Web Browser</title> +<title>The File Manager and Web Browser</title> -<para ->The file manager and web browser of &kde; is &konqueror;. The &konqueror; home page is located at <ulink url="http://www.konqueror.org" ->http://www.konqueror.org</ulink -> where a &konqueror; specific <acronym ->FAQ</acronym -> can be found.</para> +<para>The file manager and web browser of &kde; is &konqueror;. The &konqueror; home page is located at <ulink url="http://www.konqueror.org">http://www.konqueror.org</ulink> where a &konqueror; specific <acronym>FAQ</acronym> can be found.</para> <qandaset> <qandaentry> <question> -<para ->How do I use &konqueror; as a web browser with a proxy?</para> +<para>How do I use &konqueror; as a web browser with a proxy?</para> </question> <answer> -<para ->&konqueror; can be used with &HTTP; and &FTP; proxies. To set up the proxy server in &konqueror;, just select <menuchoice -><guimenu ->Settings</guimenu -><guisubmenu ->Configure &konqueror;...</guisubmenu -></menuchoice -> from the &konqueror; menu and go to the <guilabel ->Proxy</guilabel -> tab.</para> +<para>&konqueror; can be used with &HTTP; and &FTP; proxies. To set up the proxy server in &konqueror;, just select <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure &konqueror;...</guisubmenu></menuchoice> from the &konqueror; menu and go to the <guilabel>Proxy</guilabel> tab.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How can I change the appearance of a folder in &konqueror;?</para> +<para>How can I change the appearance of a folder in &konqueror;?</para> </question> <answer> -<para ->Right-click the folder, select <guimenuitem ->Properties</guimenuitem ->, click on the large icon in the dialogue which appears and choose another icon.</para> -<para ->To change the icon displayed for entries in the <guimenu ->TDE Menu</guimenu ->, use the <application ->Menu Editor</application ->, located at <menuchoice -><guisubmenu ->Settings</guisubmenu -><guimenuitem ->Menu Editor</guimenuitem -></menuchoice ->. </para> +<para>Right-click the folder, select <guimenuitem>Properties</guimenuitem>, click on the large icon in the dialogue which appears and choose another icon.</para> +<para>To change the icon displayed for entries in the <guimenu>TDE Menu</guimenu>, use the <application>Menu Editor</application>, located at <menuchoice><guisubmenu>Settings</guisubmenu><guimenuitem>Menu Editor</guimenuitem></menuchoice>. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->How can I do non-anonymous &FTP; transfers with &konqueror;?</para> +<para>How can I do non-anonymous &FTP; transfers with &konqueror;?</para> </question> <answer> -<para ->Normally, if you enter a &URL; like <userinput ->ftp://<replaceable ->ftp.somehost.com</replaceable -></userinput ->, &konqueror; will attempt an anonymous login to the &FTP; server. If you want to login as a particular user, enter a &URL; like <userinput ->ftp://<replaceable ->username@ftp.somehost.com</replaceable -></userinput -> instead. &konqueror; will ask for your password and connect to the server.</para> +<para>Normally, if you enter a &URL; like <userinput>ftp://<replaceable>ftp.somehost.com</replaceable></userinput>, &konqueror; will attempt an anonymous login to the &FTP; server. If you want to login as a particular user, enter a &URL; like <userinput>ftp://<replaceable>username@ftp.somehost.com</replaceable></userinput> instead. &konqueror; will ask for your password and connect to the server.</para> </answer> </qandaentry> -<qandaentry -> <question -> <para ->What are <option ->%i</option -> and <option ->%m</option -> in the Execute line?</para -> </question -> <answer> -<para ->They are used by all &kde; applications (since they are implemented in <classname ->TDEApplication</classname -> and all good &kde; programs create a <classname ->TDEApplication</classname -> object before they even look at the command line arguments).</para -> <para ->A standard line for a &kde; application looks like this: <userinput -><command ->foo</command -> <option ->... %i %m -caption \"%c\"</option -></userinput ->. Pretty confusing, but it has been designed in that way so that it can integrate legacy, non-&kde; applications as smoothly as possible. &konqueror;, when executing the line above, will extend the command to <userinput -><command -><replaceable ->foo</replaceable -></command -> <option ->-icon something.png -miniicon something_mini.png -caption \"The Foo\"</option -></userinput ->. Both the icon and the mini-icon as well as "The Foo" are properties defined in the <filename ->.desktop</filename -> file. If the icons are not defined, they simply default to the executable name <replaceable ->foo</replaceable ->.</para> +<qandaentry> <question> <para>What are <option>%i</option> and <option>%m</option> in the Execute line?</para> </question> <answer> +<para>They are used by all &kde; applications (since they are implemented in <classname>TDEApplication</classname> and all good &kde; programs create a <classname>TDEApplication</classname> object before they even look at the command line arguments).</para> <para>A standard line for a &kde; application looks like this: <userinput><command>foo</command> <option>... %i %m -caption \"%c\"</option></userinput>. Pretty confusing, but it has been designed in that way so that it can integrate legacy, non-&kde; applications as smoothly as possible. &konqueror;, when executing the line above, will extend the command to <userinput><command><replaceable>foo</replaceable></command> <option>-icon something.png -miniicon something_mini.png -caption \"The Foo\"</option></userinput>. Both the icon and the mini-icon as well as "The Foo" are properties defined in the <filename>.desktop</filename> file. If the icons are not defined, they simply default to the executable name <replaceable>foo</replaceable>.</para> -<para ->This way a user can change these things in &kmenuedit; for his or her applications. The <option ->-caption</option -> option is important, because no user will accept that the menu item <guimenuitem ->Editor</guimenuitem -> starts something called <guilabel ->kedit-0.9pl4-build47</guilabel ->. Instead, he expects a window called <guilabel ->Editor</guilabel ->. Furthermore these names are localised, <abbrev ->i.e.</abbrev -> an American user launches <guimenuitem ->CD-Player</guimenuitem -> and gets a window called <guilabel ->CD-Player</guilabel -> while a German user launches <guimenuitem ->CD-Spieler</guimenuitem -> and gets a window called <guilabel ->CD-Spieler</guilabel ->.</para> +<para>This way a user can change these things in &kmenuedit; for his or her applications. The <option>-caption</option> option is important, because no user will accept that the menu item <guimenuitem>Editor</guimenuitem> starts something called <guilabel>kedit-0.9pl4-build47</guilabel>. Instead, he expects a window called <guilabel>Editor</guilabel>. Furthermore these names are localised, <abbrev>i.e.</abbrev> an American user launches <guimenuitem>CD-Player</guimenuitem> and gets a window called <guilabel>CD-Player</guilabel> while a German user launches <guimenuitem>CD-Spieler</guimenuitem> and gets a window called <guilabel>CD-Spieler</guilabel>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I specify the startup folder for &konqueror;?</para> +<para>How do I specify the startup folder for &konqueror;?</para> </question> <answer> -<para ->Using the &RMB;, click on the Home icon and choose <guimenuitem ->Properties</guimenuitem ->. Under the <guilabel ->Application</guilabel -> tab you will probably find something like <command ->kfmclient openProfile filemanagement</command ->; just append <filename class="directory" ->file:/whereever/you/want</filename -> with the folder you would like &konqueror; to start in.</para> +<para>Using the &RMB;, click on the Home icon and choose <guimenuitem>Properties</guimenuitem>. Under the <guilabel>Application</guilabel> tab you will probably find something like <command>kfmclient openProfile filemanagement</command>; just append <filename class="directory">file:/whereever/you/want</filename> with the folder you would like &konqueror; to start in.</para> </answer> </qandaentry> <qandaentry> <question id="nsbookmark"> -<para ->How do I import &Netscape; bookmarks?</para> +<para>How do I import &Netscape; bookmarks?</para> </question> <answer> -<para ->There is no need to import anything at all. &Netscape; bookmarks are automatically available under the <guimenu ->Bookmarks</guimenu -> menu in &konqueror; with no configuration on your part necessary. The <application ->Bookmark Editor</application -> is able to convert &Netscape; bookmarks to the format used by &konqueror;, if you want this.</para> +<para>There is no need to import anything at all. &Netscape; bookmarks are automatically available under the <guimenu>Bookmarks</guimenu> menu in &konqueror; with no configuration on your part necessary. The <application>Bookmark Editor</application> is able to convert &Netscape; bookmarks to the format used by &konqueror;, if you want this.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I fool a site into believing &konqueror; is &Netscape; or some other browser?</para> +<para>How do I fool a site into believing &konqueror; is &Netscape; or some other browser?</para> </question> <answer> -<para ->In &konqueror;, select <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure Konqueror...</guimenuitem -></menuchoice -> and in the configuration dialogue, select <guilabel ->Browser Identification</guilabel ->. Default and site-specific browser identifications can be set from here.</para> +<para>In &konqueror;, select <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror...</guimenuitem></menuchoice> and in the configuration dialogue, select <guilabel>Browser Identification</guilabel>. Default and site-specific browser identifications can be set from here.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I configure &konqueror; to run &Java; applets?</para> +<para>How do I configure &konqueror; to run &Java; applets?</para> </question> <answer> -<para ->Choose <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure &konqueror;...</guimenuitem -></menuchoice -> from &konqueror;'s menubar and then select <guilabel ->Java & Javascript</guilabel ->. Set the <guilabel ->Path to Java executable</guilabel -> correctly. If it doesn't work, please check the <ulink url="http://www.konqueror.org/javahowto/" ->Konqueror + Java HOWTO</ulink ->.</para> +<para>Choose <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &konqueror;...</guimenuitem></menuchoice> from &konqueror;'s menubar and then select <guilabel>Java & Javascript</guilabel>. Set the <guilabel>Path to Java executable</guilabel> correctly. If it doesn't work, please check the <ulink url="http://www.konqueror.org/javahowto/">Konqueror + Java HOWTO</ulink>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->What is this new <guilabel ->Smart</guilabel -> policy for JavaScript web popups?</para> +<para>What is this new <guilabel>Smart</guilabel> policy for JavaScript web popups?</para> </question> <answer> -<para ->This new policy attempts to block intrusive JavaScript popup windows. If the user does not click on a button or submit a form to trigger the popup, then the popup is not permitted. Some sites will open a second new window from within the first and in that case, the second window will not show. </para> +<para>This new policy attempts to block intrusive JavaScript popup windows. If the user does not click on a button or submit a form to trigger the popup, then the popup is not permitted. Some sites will open a second new window from within the first and in that case, the second window will not show. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->Why doesn't my banking site work with &konqueror;? It pops up a new window with the login screen in other browsers, but not in &konqueror;.</para> +<para>Why doesn't my banking site work with &konqueror;? It pops up a new window with the login screen in other browsers, but not in &konqueror;.</para> </question> <answer> -<para ->Make sure you have Javascript enabled, and the default JavaScript web popups policy set to <guilabel ->Ask</guilabel -> or <guilabel ->Allow</guilabel ->. The <guilabel ->Smart</guilabel -> policy is not always sufficient for some banks. Many banks also require &Java; support. You can find more help on enabling this at <ulink url="http://www.konqueror.org/" ->http://www.konqueror.org/</ulink ->. </para> +<para>Make sure you have Javascript enabled, and the default JavaScript web popups policy set to <guilabel>Ask</guilabel> or <guilabel>Allow</guilabel>. The <guilabel>Smart</guilabel> policy is not always sufficient for some banks. Many banks also require &Java; support. You can find more help on enabling this at <ulink url="http://www.konqueror.org/">http://www.konqueror.org/</ulink>. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->Why can't &konqueror; render &GIF; images?</para> +<para>Why can't &konqueror; render &GIF; images?</para> </question> <answer> -<para ->It is because you did not enable &GIF; support in &Qt;. Please see <xref linkend="gif"/> for more details.</para> +<para>It is because you did not enable &GIF; support in &Qt;. Please see <xref linkend="gif"/> for more details.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I rename files?</para> +<para>How do I rename files?</para> </question> <answer> -<para ->Simply <mousebutton ->right</mousebutton -> click on the file and select <guimenuitem ->Rename</guimenuitem -> or click once on an already selected file. The default keyboard shortcut to rename a file is <keycap ->F2</keycap ->.</para> +<para>Simply <mousebutton>right</mousebutton> click on the file and select <guimenuitem>Rename</guimenuitem> or click once on an already selected file. The default keyboard shortcut to rename a file is <keycap>F2</keycap>.</para> </answer> </qandaentry> <qandaentry> -<question -><para ->When I try to open a web page with &konqueror;, I get the message: <quote ->There appears to be a configuration error. You have associated Konqueror with text/html, but it cannot handle this file type.</quote -></para> +<question><para>When I try to open a web page with &konqueror;, I get the message: <quote>There appears to be a configuration error. You have associated Konqueror with text/html, but it cannot handle this file type.</quote></para> </question> <answer> -<para ->You need to make sure that the embedding settings for the text/html <acronym ->MIME</acronym -> type are correct: <orderedlist> -<listitem -><para ->In &konqueror;, go to <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure Konqueror</guimenuitem -></menuchoice -> and then to the <guilabel ->File Associations</guilabel -> page.</para -></listitem> -<listitem -><para ->Open text->html in the tree view.</para -></listitem> -<listitem -><para ->Click on the <guilabel ->Embedding</guilabel -> tab. Make sure that <guilabel ->Left Click Action</guilabel -> is set to <guilabel ->Show file in embedded viewer</guilabel ->, and that <guilabel ->TDEHTML (tdehtml)</guilabel -> is at the top of <guilabel ->Services Preference Order.</guilabel -></para -></listitem> +<para>You need to make sure that the embedding settings for the text/html <acronym>MIME</acronym> type are correct: <orderedlist> +<listitem><para>In &konqueror;, go to <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror</guimenuitem></menuchoice> and then to the <guilabel>File Associations</guilabel> page.</para></listitem> +<listitem><para>Open text->html in the tree view.</para></listitem> +<listitem><para>Click on the <guilabel>Embedding</guilabel> tab. Make sure that <guilabel>Left Click Action</guilabel> is set to <guilabel>Show file in embedded viewer</guilabel>, and that <guilabel>TDEHTML (tdehtml)</guilabel> is at the top of <guilabel>Services Preference Order.</guilabel></para></listitem> </orderedlist> </para> -<para ->Try opening a website in Konqueror. It should now work.</para> +<para>Try opening a website in Konqueror. It should now work.</para> </answer> </qandaentry> <qandaentry> -<question -><para ->How do I configure the programs that &konqueror; uses to open different types of files?</para -></question> +<question><para>How do I configure the programs that &konqueror; uses to open different types of files?</para></question> <answer> -<para ->In order to configure file associations, you should go to the &kcontrolcenter; and choose the item <guimenuitem ->File Associations</guimenuitem -> under the category <guimenu ->TDE Components</guimenu ->.</para> -<para ->Suppose the default <acronym ->PDF</acronym -> viewer is now &kghostview; and you would prefer to use <application ->KPDF</application -> as a viewer. You would simply type <userinput ->pdf</userinput -> in the search box at the top of the dialogue, choose <guimenuitem ->pdf</guimenuitem -> in the <guimenu ->application</guimenu -> group and move <application ->KPDF</application -> up. In the <guilabel ->Embedding</guilabel -> tab you can also choose which component other applications will use to display files (for example, when viewing files in &konqueror; or using &ark;'s embedded viewer). </para> +<para>In order to configure file associations, you should go to the &kcontrolcenter; and choose the item <guimenuitem>File Associations</guimenuitem> under the category <guimenu>TDE Components</guimenu>.</para> +<para>Suppose the default <acronym>PDF</acronym> viewer is now &kghostview; and you would prefer to use <application>KPDF</application> as a viewer. You would simply type <userinput>pdf</userinput> in the search box at the top of the dialogue, choose <guimenuitem>pdf</guimenuitem> in the <guimenu>application</guimenu> group and move <application>KPDF</application> up. In the <guilabel>Embedding</guilabel> tab you can also choose which component other applications will use to display files (for example, when viewing files in &konqueror; or using &ark;'s embedded viewer). </para> </answer> </qandaentry> diff --git a/tde-i18n-en_GB/docs/tdebase/faq/gettde.docbook b/tde-i18n-en_GB/docs/tdebase/faq/gettde.docbook index a059b9b7204..6f250409f90 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/gettde.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/gettde.docbook @@ -5,106 +5,68 @@ --> <chapter id="getting-kde"> -<title ->Getting &kde;</title> +<title>Getting &kde;</title> <qandaset> <qandaentry> <question id="where-to-get-kde"> -<para ->Where do I get &kde;?</para> +<para>Where do I get &kde;?</para> </question> <answer> <!-- This needs a rewrite including informations about the latest version (link to the info page?)--> -<para ->The main distribution site for &kde; is <ulink url="ftp://ftp.kde.org/" ->ftp.kde.org</ulink ->. However, this site is often under heavy load, so you might prefer to use <ulink url="http://download.kde.org/" ->download.kde.org</ulink -> which automatically redirects you to the mirror nearest to you. You can also have a look at the list of <ulink url="http://www.kde.org/ftpmirrors.html" -> &kde; mirror sites</ulink ->.</para> +<para>The main distribution site for &kde; is <ulink url="ftp://ftp.kde.org/">ftp.kde.org</ulink>. However, this site is often under heavy load, so you might prefer to use <ulink url="http://download.kde.org/">download.kde.org</ulink> which automatically redirects you to the mirror nearest to you. You can also have a look at the list of <ulink url="http://www.kde.org/ftpmirrors.html"> &kde; mirror sites</ulink>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Are there &Linux; distributions that include &kde;?</para> +<para>Are there &Linux; distributions that include &kde;?</para> </question> <answer> -<para ->Yes, major &Linux; distributions already ship &kde;. As building a distribution takes some time, they might not always contain the latest version, but for a start or to avoid downloading from the Internet, they do provide a good starting point. </para> -<para ->You can find an up-to-date list of distributions that ship with &kde; <ulink url="http://www.kde.org/download/distributions.php" ->here</ulink ->. </para> +<para>Yes, major &Linux; distributions already ship &kde;. As building a distribution takes some time, they might not always contain the latest version, but for a start or to avoid downloading from the Internet, they do provide a good starting point. </para> +<para>You can find an up-to-date list of distributions that ship with &kde; <ulink url="http://www.kde.org/download/distributions.php">here</ulink>. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->What is the current version?</para> +<para>What is the current version?</para> </question> <answer> -<para ->Currently, the latest stable version is 3.2</para> +<para>Currently, the latest stable version is 3.2</para> -<para ->The <ulink url="http://www.kde.org/info/3.2.php" ->&kde; 3.2 Info Page</ulink -> contains a lot of information specific to this release.</para> +<para>The <ulink url="http://www.kde.org/info/3.2.php">&kde; 3.2 Info Page</ulink> contains a lot of information specific to this release.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Where do I find &kde; snapshots?</para> +<para>Where do I find &kde; snapshots?</para> </question> <answer> -<para ->You can get the latest snapshots from <ulink url="ftp://ftp.kde.org/pub/kde/unstable/snapshots" ->ftp://ftp.kde.org/pub/kde/unstable/snapshots</ulink ->. You might also want to consider setting up your own <acronym ->CVS</acronym -> client in order to maintain the latest snapshot at all times. Please refer to <ulink url="http://developer.kde.org/source/anoncvs.html" ->Anonymous <acronym ->CVS</acronym -> and &kde;</ulink -> for further information. </para> +<para>You can get the latest snapshots from <ulink url="ftp://ftp.kde.org/pub/kde/unstable/snapshots">ftp://ftp.kde.org/pub/kde/unstable/snapshots</ulink>. You might also want to consider setting up your own <acronym>CVS</acronym> client in order to maintain the latest snapshot at all times. Please refer to <ulink url="http://developer.kde.org/source/anoncvs.html">Anonymous <acronym>CVS</acronym> and &kde;</ulink> for further information. </para> </answer> </qandaentry> <qandaentry> <question id="where-to-get-qt"> -<para ->Where do I get &Qt;?</para> +<para>Where do I get &Qt;?</para> </question> <answer> -<para ->&Qt; is a product of the Norwegian company Trolltech. You can always get the latest &Qt; version from their <ulink url="ftp://ftp.trolltech.com" ->&FTP; server</ulink ->.</para> -<para ->And with most up-to-date &Linux; distributions, &Qt; is already included. Please see <xref linkend="prerequisites"/> for the version of &Qt; you need.</para> +<para>&Qt; is a product of the Norwegian company Trolltech. You can always get the latest &Qt; version from their <ulink url="ftp://ftp.trolltech.com">&FTP; server</ulink>.</para> +<para>And with most up-to-date &Linux; distributions, &Qt; is already included. Please see <xref linkend="prerequisites"/> for the version of &Qt; you need.</para> </answer> </qandaentry> <qandaentry> <question id="qt"> -<para ->What is &Qt;, by the way?</para> +<para>What is &Qt;, by the way?</para> </question> <answer> -<para ->&Qt; is a C++-based class library to build user interfaces. It also includes many utility classes like string classes and classes to handle input and output. It provides most of the widgets you will see in a &kde; application: menus, buttons, sliders, &etc;. &Qt; is a cross-platform library that allows you to write code that will compile on &UNIX; systems as well as &Windows; and embedded devices. You can learn more about &Qt; at <ulink url="http://www.trolltech.com" ->http://www.trolltech.com</ulink ->.</para> +<para>&Qt; is a C++-based class library to build user interfaces. It also includes many utility classes like string classes and classes to handle input and output. It provides most of the widgets you will see in a &kde; application: menus, buttons, sliders, &etc;. &Qt; is a cross-platform library that allows you to write code that will compile on &UNIX; systems as well as &Windows; and embedded devices. You can learn more about &Qt; at <ulink url="http://www.trolltech.com">http://www.trolltech.com</ulink>.</para> </answer> </qandaentry> </qandaset> diff --git a/tde-i18n-en_GB/docs/tdebase/faq/index.docbook b/tde-i18n-en_GB/docs/tdebase/faq/index.docbook index 42bbbad73e4..ef21eec109a 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/index.docbook @@ -3,8 +3,7 @@ "dtd/kdex.dtd" [ <!ENTITY kappname "&kde; Frequently Asked Questions"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> <!ENTITY faq-about SYSTEM "about.docbook"> <!ENTITY faq-intro SYSTEM "intro.docbook"> <!ENTITY faq-gettde SYSTEM "gettde.docbook"> @@ -29,75 +28,40 @@ <book lang="&language;"> <bookinfo> -<title ->&kde; Frequently Asked Questions</title> +<title>&kde; Frequently Asked Questions</title> <authorgroup> <author> -<surname ->The &kde; Team</surname> +<surname>The &kde; Team</surname> </author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->1997</year> -<year ->1998</year> -<year ->1999</year> -<year ->2000</year> -<year ->2001</year> -<year ->2003</year> -<year ->2004</year> -<holder ->The &kde; Team</holder> +<year>1997</year> +<year>1998</year> +<year>1999</year> +<year>2000</year> +<year>2001</year> +<year>2003</year> +<year>2004</year> +<holder>The &kde; Team</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2004-09-07</date> -<releaseinfo ->3.3</releaseinfo> +<date>2004-09-07</date> +<releaseinfo>3.3</releaseinfo> <abstract> -<para ->This is a compilation of the most frequently asked questions about the K Desktop Environment. Please report any bugs, inconsistencies, or omissions you find in this &FAQ; to <email ->kde-doc-english@kde.org</email ->. Please do not mail your questions to this list. Post them to the &kde; mailing lists and newsgroups instead. They are monitored for this &FAQ;.</para -> </abstract> +<para>This is a compilation of the most frequently asked questions about the K Desktop Environment. Please report any bugs, inconsistencies, or omissions you find in this &FAQ; to <email>kde-doc-english@kde.org</email>. Please do not mail your questions to this list. Post them to the &kde; mailing lists and newsgroups instead. They are monitored for this &FAQ;.</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->FAQ</keyword> -<keyword ->question</keyword> -<keyword ->answer</keyword> +<keyword>KDE</keyword> +<keyword>FAQ</keyword> +<keyword>question</keyword> +<keyword>answer</keyword> </keywordset> </bookinfo> @@ -118,35 +82,20 @@ &faq-contrib; <chapter id="credits"> -<title ->Credits and Licence</title> +<title>Credits and Licence</title> -<para ->The current &FAQ; maintainers are:</para> +<para>The current &FAQ; maintainers are:</para> <itemizedlist> -<listitem -><para ->Rainer Endres <email ->endres@kde.org</email -></para -></listitem> +<listitem><para>Rainer Endres <email>endres@kde.org</email></para></listitem> </itemizedlist> -<para ->Many of the answers in this &FAQ; are taken from the various &kde; mailing lists and newsgroups. Here is a <emphasis ->big</emphasis -> thank you to all of you who have contributed answers that eventually appear in this &FAQ;.</para> +<para>Many of the answers in this &FAQ; are taken from the various &kde; mailing lists and newsgroups. Here is a <emphasis>big</emphasis> thank you to all of you who have contributed answers that eventually appear in this &FAQ;.</para> -<para ->Special thanks go to the former &FAQ; maintainer, who has written most of the stuff in here, and did a tremendous job: Mr. Lee Wee Tiong </para> +<para>Special thanks go to the former &FAQ; maintainer, who has written most of the stuff in here, and did a tremendous job: Mr. Lee Wee Tiong </para> -<para ->Conversion to British English: Malcolm Hunter <email ->malcolm.hunter@gmx.co.uk</email -></para -> +<para>Conversion to British English: Malcolm Hunter <email>malcolm.hunter@gmx.co.uk</email></para> &underFDL; </chapter> &documentation.index; diff --git a/tde-i18n-en_GB/docs/tdebase/faq/install.docbook b/tde-i18n-en_GB/docs/tdebase/faq/install.docbook index 275f771253b..3b0d78aa90d 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/install.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/install.docbook @@ -1,21 +1,12 @@ <!-- <?xml version="1.0" ?> <!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" - "dtd/kdex.dtd" -> --> + "dtd/kdex.dtd"> --> <chapter id="install"> -<title ->Installation instructions</title> +<title>Installation instructions</title> -<para ->These are the generic installation instructions for the K Desktop Environment. Please complement your reading with the <filename ->README</filename ->s and <filename ->INSTALL</filename ->s that come along with the package. Please read them carefully and try to help yourself out if anything goes wrong. If you need further assistance, consider joining the &kde; mailing lists (see our web site instructions for joining the &kde; <ulink url="http://www.kde.org/mailinglists/" ->mailing lists</ulink ->) or newsgroups.</para> +<para>These are the generic installation instructions for the K Desktop Environment. Please complement your reading with the <filename>README</filename>s and <filename>INSTALL</filename>s that come along with the package. Please read them carefully and try to help yourself out if anything goes wrong. If you need further assistance, consider joining the &kde; mailing lists (see our web site instructions for joining the &kde; <ulink url="http://www.kde.org/mailinglists/">mailing lists</ulink>) or newsgroups.</para> <qandaset> @@ -23,396 +14,210 @@ <qandaentry> <question> -<para ->To the would-be converts</para> +<para>To the would-be converts</para> </question> <answer> -<para ->So you have heard the rumours. Or you have seen the screenshots. And you are dying to get hold of &kde;. But you know next to nothing about this whole <quote ->alternative OS</quote -> business. Don't worry! You only need to do some (well, maybe not some) reading, that's all!</para> +<para>So you have heard the rumours. Or you have seen the screenshots. And you are dying to get hold of &kde;. But you know next to nothing about this whole <quote>alternative OS</quote> business. Don't worry! You only need to do some (well, maybe not some) reading, that's all!</para> -<para ->&kde; does not run on any version of &Microsoft; &Windows; or OS/2 (yet). To run &kde;, you need to have a &UNIX; system. Please refer to <xref linkend="platform"/> for more details.</para> +<para>&kde; does not run on any version of &Microsoft; &Windows; or OS/2 (yet). To run &kde;, you need to have a &UNIX; system. Please refer to <xref linkend="platform"/> for more details.</para> -<para ->Decide on a platform and set it up for your system. This <acronym ->FAQ</acronym -> can not help you with this, since &kde;<ulink url="http://www.kde.org" -> runs on many &UNIX;</ulink -> platforms. </para> +<para>Decide on a platform and set it up for your system. This <acronym>FAQ</acronym> can not help you with this, since &kde;<ulink url="http://www.kde.org"> runs on many &UNIX;</ulink> platforms. </para> <!-- Taken out because we can not help with all platforms and KDEisnotLINUX --> -<para ->Finally, you are ready to commence the &kde; installation. Please start reading from the next section. To get &kde;, please refer to <xref linkend="where-to-get-kde"/>. Last but not least, if you encounter any problems while installing &kde;, please do not hesitate to make use of the &kde; <link linkend="mailing-lists" ->mailing lists</link -> and <link linkend="newsgroups" ->newsgroups</link ->. But do bear this in mind: no question is too silly to ask, but some are too silly to answer, especially when they are already answered in this <acronym ->FAQ</acronym ->.</para> -<para ->Good luck and have fun!</para> +<para>Finally, you are ready to commence the &kde; installation. Please start reading from the next section. To get &kde;, please refer to <xref linkend="where-to-get-kde"/>. Last but not least, if you encounter any problems while installing &kde;, please do not hesitate to make use of the &kde; <link linkend="mailing-lists">mailing lists</link> and <link linkend="newsgroups">newsgroups</link>. But do bear this in mind: no question is too silly to ask, but some are too silly to answer, especially when they are already answered in this <acronym>FAQ</acronym>.</para> +<para>Good luck and have fun!</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Available package formats</para> +<para>Available package formats</para> </question> <answer> -<para ->You can find several kinds of binary and source packages for different distributions and operating systems on the &kde-ftp;. The binary packages are not made by the &kde; Team, but by the distributors themselves, or some dedicated individuals. Please refer to <ulink url="http://dot.kde.org/986933826/" ->&kde; Package Policy Explained</ulink -> for information about the &kde; Package Policy. The only <quote ->official</quote -> release is the source tar.bz2 packages. Please refer to the <filename ->README</filename ->s and <filename ->INSTALL</filename ->s in the several binaries folders. For a list of the available packages for a release, refer to the relevant info page. For the latest release this is the <ulink url="http://www.kde.org/info/3.2.php" ->&kde; 3.2 Info Page</ulink ->.</para> +<para>You can find several kinds of binary and source packages for different distributions and operating systems on the &kde-ftp;. The binary packages are not made by the &kde; Team, but by the distributors themselves, or some dedicated individuals. Please refer to <ulink url="http://dot.kde.org/986933826/">&kde; Package Policy Explained</ulink> for information about the &kde; Package Policy. The only <quote>official</quote> release is the source tar.bz2 packages. Please refer to the <filename>README</filename>s and <filename>INSTALL</filename>s in the several binaries folders. For a list of the available packages for a release, refer to the relevant info page. For the latest release this is the <ulink url="http://www.kde.org/info/3.2.php">&kde; 3.2 Info Page</ulink>.</para> </answer> </qandaentry> <qandaentry> <question id="prerequisites"> -<para ->Prerequisites</para> +<para>Prerequisites</para> </question> <answer> <!-- rewrite to make it more general, pointing to the according webpages? --> -<para ->For &kde; 3.2, you need the &Qt; library version 3.2 or greater. Please make sure you download the correct &Qt;. You will also need the header files, if you want to compile &kde; yourself. They are all available, at no cost, from <ulink url="http://www.trolltech.com/products/download" ->http://www.trolltech.com/download</ulink ->. In addition, there are optional libraries that might improve &kde; if installed on your system. An example is OpenSSL which will enable &konqueror; to browse web pages securely and is needed in a version ->=0.9.6. These should be provided by your distributor; if not, ask for an update.</para> +<para>For &kde; 3.2, you need the &Qt; library version 3.2 or greater. Please make sure you download the correct &Qt;. You will also need the header files, if you want to compile &kde; yourself. They are all available, at no cost, from <ulink url="http://www.trolltech.com/products/download">http://www.trolltech.com/download</ulink>. In addition, there are optional libraries that might improve &kde; if installed on your system. An example is OpenSSL which will enable &konqueror; to browse web pages securely and is needed in a version >=0.9.6. These should be provided by your distributor; if not, ask for an update.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Description of the base packages</para> +<para>Description of the base packages</para> </question> <answer> -<para ->The base distribution currently consists of eleven packages. Some are required, while others are optional. Each package is available in each of the aforementioned package formats.</para> +<para>The base distribution currently consists of eleven packages. Some are required, while others are optional. Each package is available in each of the aforementioned package formats.</para> <variablelist> <varlistentry> -<term ->tdelibs</term> +<term>tdelibs</term> <listitem> -<para ->Required</para> -<para ->This package contains shared libraries that are needed by all &kde; applications.</para> +<para>Required</para> +<para>This package contains shared libraries that are needed by all &kde; applications.</para> </listitem> </varlistentry> <varlistentry> -<term ->tdebase</term> +<term>tdebase</term> <listitem> -<para ->Required</para> -<para ->This package contains the base applications that form the core of the K Desktop Environment like the window manager, the terminal emulator, the control centre, the file manager, and the panel.</para> +<para>Required</para> +<para>This package contains the base applications that form the core of the K Desktop Environment like the window manager, the terminal emulator, the control centre, the file manager, and the panel.</para> </listitem> </varlistentry> <varlistentry> -<term ->&arts;</term> +<term>&arts;</term> <listitem> -<para ->Required</para> -<para ->The &arts; sound server. A powerful, network transparent sound server.</para> +<para>Required</para> +<para>The &arts; sound server. A powerful, network transparent sound server.</para> </listitem> </varlistentry> <varlistentry> -<term ->tdeaddons</term> +<term>tdeaddons</term> <listitem> -<para ->Optional</para> -<para ->Various plugins for &kate;, &kicker;, &knewsticker;, &konqueror; and &noatun; </para> +<para>Optional</para> +<para>Various plugins for &kate;, &kicker;, &knewsticker;, &konqueror; and &noatun; </para> </listitem> </varlistentry> <varlistentry> -<term ->tdeartwork</term> +<term>tdeartwork</term> <listitem> -<para ->Optional</para> -<para ->Additional wallpapers, themes, styles, sounds ...</para> +<para>Optional</para> +<para>Additional wallpapers, themes, styles, sounds ...</para> </listitem> </varlistentry> <varlistentry> -<term ->tdebindings</term> +<term>tdebindings</term> <listitem> -<para ->Optional</para> -<para ->Various bindings for other languages, including &Java;, Perl, Python, ...</para> +<para>Optional</para> +<para>Various bindings for other languages, including &Java;, Perl, Python, ...</para> </listitem> </varlistentry> <varlistentry> -<term ->tdegames</term> +<term>tdegames</term> <listitem> -<para ->Optional</para> -<para ->Various games like &kmahjongg;, &ksnake;, &kasteroids;, and &kpatience;.</para> +<para>Optional</para> +<para>Various games like &kmahjongg;, &ksnake;, &kasteroids;, and &kpatience;.</para> </listitem> </varlistentry> <varlistentry> -<term ->tdegraphics</term> +<term>tdegraphics</term> <listitem> -<para ->Optional</para> -<para ->Various graphics-related programs like &PostScript; previewer, &DVI; previewer, and a drawing program.</para> +<para>Optional</para> +<para>Various graphics-related programs like &PostScript; previewer, &DVI; previewer, and a drawing program.</para> </listitem> </varlistentry> <varlistentry> -<term ->tdeutils</term> +<term>tdeutils</term> <listitem> -<para ->Optional</para> -<para ->Various desktop tools like a calculator, an editor and other nifty stuff.</para> +<para>Optional</para> +<para>Various desktop tools like a calculator, an editor and other nifty stuff.</para> </listitem> </varlistentry> <varlistentry> -<term ->tdemultimedia</term> +<term>tdemultimedia</term> <listitem> -<para ->Optional</para> -<para ->Multimedia applications like a &CD; player and a mixer.</para> +<para>Optional</para> +<para>Multimedia applications like a &CD; player and a mixer.</para> </listitem> </varlistentry> <varlistentry> -<term ->tdenetwork</term> +<term>tdenetwork</term> <listitem> -<para ->Optional</para> -<para ->Network applications. Currently contains the mail program &kmail;, the news reader &knode;, and several other network-related programs.</para> +<para>Optional</para> +<para>Network applications. Currently contains the mail program &kmail;, the news reader &knode;, and several other network-related programs.</para> </listitem> </varlistentry> <varlistentry> -<term ->tdeadmin</term> +<term>tdeadmin</term> <listitem> -<para ->Optional</para> -<para ->System administration programs.</para> +<para>Optional</para> +<para>System administration programs.</para> </listitem> </varlistentry> <varlistentry> -<term ->tdeedu</term> +<term>tdeedu</term> <listitem> -<para ->Educational and entertaining applications for &kde;'s younger users. </para> +<para>Educational and entertaining applications for &kde;'s younger users. </para> </listitem> </varlistentry> <varlistentry> -<term ->tdetoys</term> +<term>tdetoys</term> <listitem> -<para ->Optional</para> -<para ->Toys!</para> +<para>Optional</para> +<para>Toys!</para> </listitem> </varlistentry> <varlistentry> -<term ->tdevelop</term> +<term>tdevelop</term> <listitem> -<para ->Optional</para> -<para ->A complete Integrated Development Environment for &kde; and Qt</para> +<para>Optional</para> +<para>A complete Integrated Development Environment for &kde; and Qt</para> </listitem> </varlistentry> </variablelist> -<para ->&arts; and then tdelibs should be installed before everything else, and tdeaddons last. The other packages can be installed in any arbitrary order.</para> +<para>&arts; and then tdelibs should be installed before everything else, and tdeaddons last. The other packages can be installed in any arbitrary order.</para> -<para ->Most package management tools will let you put all these packages in one folder and install them all at once, figuring out the dependencies as they go.</para> +<para>Most package management tools will let you put all these packages in one folder and install them all at once, figuring out the dependencies as they go.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Installation instructions for the different package formats</para> +<para>Installation instructions for the different package formats</para> </question> <answer> -<para -><important> -<para ->Please do not forget to read the <filename ->README</filename -> and <filename ->INSTALL</filename -> files if they are available.</para> -</important -></para> +<para><important> +<para>Please do not forget to read the <filename>README</filename> and <filename>INSTALL</filename> files if they are available.</para> +</important></para> <variablelist> <varlistentry> -<term ->Installation of the Debian packages</term> +<term>Installation of the Debian packages</term> <listitem> -<para ->The Debian packages install in accordance with the upcoming <acronym ->FHS</acronym -> (File Hierarchy Standard).</para> +<para>The Debian packages install in accordance with the upcoming <acronym>FHS</acronym> (File Hierarchy Standard).</para> <procedure> -<step performance="required" -><para ->become superuser</para -></step> -<step performance="required" -><para ->run <command ->dpkg <option ->-i <replaceable ->packagename.deb</replaceable -></option -></command -> for every package you want to install.</para -></step> +<step performance="required"><para>become superuser</para></step> +<step performance="required"><para>run <command>dpkg <option>-i <replaceable>packagename.deb</replaceable></option></command> for every package you want to install.</para></step> </procedure> </listitem> </varlistentry> <varlistentry> -<term ->Installation of the <acronym ->RPM</acronym -> packages</term> +<term>Installation of the <acronym>RPM</acronym> packages</term> <listitem> <procedure> -<title ->To install binary <acronym ->RPM</acronym ->s</title> -<step performance="required" -><para ->become superuser</para -></step> -<step performance="required" -><para ->execute <command ->rpm <option ->-ivh <replaceable ->packagename.rpm</replaceable -></option -></command -></para -></step> +<title>To install binary <acronym>RPM</acronym>s</title> +<step performance="required"><para>become superuser</para></step> +<step performance="required"><para>execute <command>rpm <option>-ivh <replaceable>packagename.rpm</replaceable></option></command></para></step> </procedure> </listitem> </varlistentry> <varlistentry> -<term ->Installation of the source <filename ->.tar.bz2</filename -> files</term> +<term>Installation of the source <filename>.tar.bz2</filename> files</term> <listitem> -<para ->Since there are always changes and updates to the way &kde; is compiled, please refer to <ulink url="http://developer.kde.org/build/index.html" ->Download and Install from Source</ulink -> for the most up to date installation instructions for the source packages. </para> -<para ->The general approach should work in most cases though. </para> -<para ->The source <filename ->.tar.bz2</filename -> package installs into <filename class="directory" ->/usr/local/kde</filename -> by default. You can override this setting by using the <option ->--prefix</option -> option of the <filename ->configure</filename -> script.</para> +<para>Since there are always changes and updates to the way &kde; is compiled, please refer to <ulink url="http://developer.kde.org/build/index.html">Download and Install from Source</ulink> for the most up to date installation instructions for the source packages. </para> +<para>The general approach should work in most cases though. </para> +<para>The source <filename>.tar.bz2</filename> package installs into <filename class="directory">/usr/local/kde</filename> by default. You can override this setting by using the <option>--prefix</option> option of the <filename>configure</filename> script.</para> <procedure> -<step performance="required" -><para ->unpack the packages with <command ->tar <option ->jxvf <replaceable ->packagename.tar.bz2</replaceable -></option -></command -></para -></step> -<step performance="required" -><para ->change folder to the package folder: <command ->cd <replaceable ->packagename</replaceable -></command -></para -></step> -<step performance="required" -><para ->configure the package: <command ->./configure</command -> <note -><para ->Some packages (notably tdebase) have special configuration options that might be applicable to your installation. Type <command ->./configure <option ->--help</option -></command -> to see the available options.</para -></note -></para -></step> -<step performance="required" -><para ->build the package: <command ->make</command -></para -></step> -<step performance="required" -><para ->install the package: <command ->su <option ->-c "make install"</option -></command -> (if you aren't already root). If you already are, just type <command ->make <option ->install</option -></command ->.</para -></step> +<step performance="required"><para>unpack the packages with <command>tar <option>jxvf <replaceable>packagename.tar.bz2</replaceable></option></command></para></step> +<step performance="required"><para>change folder to the package folder: <command>cd <replaceable>packagename</replaceable></command></para></step> +<step performance="required"><para>configure the package: <command>./configure</command> <note><para>Some packages (notably tdebase) have special configuration options that might be applicable to your installation. Type <command>./configure <option>--help</option></command> to see the available options.</para></note></para></step> +<step performance="required"><para>build the package: <command>make</command></para></step> +<step performance="required"><para>install the package: <command>su <option>-c "make install"</option></command> (if you aren't already root). If you already are, just type <command>make <option>install</option></command>.</para></step> </procedure> </listitem> </varlistentry> @@ -422,218 +227,78 @@ <qandaentry> <question> -<para ->Post-installation procedures</para> +<para>Post-installation procedures</para> </question> <answer> -<para ->First of all, please make sure that you have added &kde;'s binary installation folder (⪚ <filename class="directory" ->/usr/local/kde/bin</filename ->) to your <envar ->PATH</envar -> and &kde;'s library installation folder to your <envar ->LD_LIBRARY_PATH</envar -> (only necessary on systems that do not support rpath; on &Linux; &ELF;, it should work without). This environment variable may be called differently on some systems, ⪚ it is called <envar ->SHLIB_PATH</envar -> on &IRIX;. Then set the environment variable <envar ->TDEDIR</envar -> to the base of your &kde; tree, ⪚ <filename class="directory" ->/usr/local/kde</filename ->. <caution -> <para ->Please bear in mind that it is unwise to set <envar ->LD_LIBRARY_PATH</envar -> blindly. In the vast majority of cases it is unnecessary and can do more harm than good. There is a web page written by <ulink url="mailto:barr@cis.ohio-state.edu" ->Dave Barr</ulink -> explaining the evils of <envar ->LD_LIBRARY_PATH</envar -> and it can be found at <ulink url="http://www.cis.ohio-state.edu/~barr/ldpath.html" ->http://www.cis.ohio-state.edu/~barr/ldpath.html</ulink ->.</para> +<para>First of all, please make sure that you have added &kde;'s binary installation folder (⪚ <filename class="directory">/usr/local/kde/bin</filename>) to your <envar>PATH</envar> and &kde;'s library installation folder to your <envar>LD_LIBRARY_PATH</envar> (only necessary on systems that do not support rpath; on &Linux; &ELF;, it should work without). This environment variable may be called differently on some systems, ⪚ it is called <envar>SHLIB_PATH</envar> on &IRIX;. Then set the environment variable <envar>TDEDIR</envar> to the base of your &kde; tree, ⪚ <filename class="directory">/usr/local/kde</filename>. <caution> <para>Please bear in mind that it is unwise to set <envar>LD_LIBRARY_PATH</envar> blindly. In the vast majority of cases it is unnecessary and can do more harm than good. There is a web page written by <ulink url="mailto:barr@cis.ohio-state.edu">Dave Barr</ulink> explaining the evils of <envar>LD_LIBRARY_PATH</envar> and it can be found at <ulink url="http://www.cis.ohio-state.edu/~barr/ldpath.html">http://www.cis.ohio-state.edu/~barr/ldpath.html</ulink>.</para> </caution> </para> -<para ->Even though you can use most of the &kde; applications simply by calling them, you can only benefit fully from &kde;'s advanced features if you use the &kde; window manager and its helper programs.</para> -<para ->In order to make it easy for you, we have provided a simple script called <filename ->starttde</filename -> which gets installed in <filename class="directory" ->$<envar ->TDEDIR</envar ->/bin</filename -> and is therefore in your path.</para> -<para ->Edit the file <filename ->.xinitrc</filename -> in your home folder (make a backup copy first!), remove everything that looks like calling a window manager, and insert <command ->starttde</command -> instead. Restart the &X-Server;. If you use &tdm;/<application ->xdm</application ->, you will have to edit the file <filename ->.xsession</filename -> instead of <filename ->.xinitrc</filename ->. And if there is no <filename ->.xinitrc</filename -> or <filename ->.xsession</filename -> in your home folder, simply create a new one with just one line containing <command ->starttde</command ->. <note -> <para ->Some systems (notably &RedHat; &Linux;) use <filename ->.Xclients</filename -> instead.</para> -</note -></para> -<para ->This should present you with a new shining &kde; desktop. You can now start to explore the wonderful world of &kde;. In case you want to read some documentation first, there is a highly recommended <ulink url="http://www.kde.org/documentation/quickstart/index.html" ->Quick Start guide</ulink -> available. Furthermore, every application has an online help that is available via the <guimenu ->help</guimenu -> menu.</para> +<para>Even though you can use most of the &kde; applications simply by calling them, you can only benefit fully from &kde;'s advanced features if you use the &kde; window manager and its helper programs.</para> +<para>In order to make it easy for you, we have provided a simple script called <filename>starttde</filename> which gets installed in <filename class="directory">$<envar>TDEDIR</envar>/bin</filename> and is therefore in your path.</para> +<para>Edit the file <filename>.xinitrc</filename> in your home folder (make a backup copy first!), remove everything that looks like calling a window manager, and insert <command>starttde</command> instead. Restart the &X-Server;. If you use &tdm;/<application>xdm</application>, you will have to edit the file <filename>.xsession</filename> instead of <filename>.xinitrc</filename>. And if there is no <filename>.xinitrc</filename> or <filename>.xsession</filename> in your home folder, simply create a new one with just one line containing <command>starttde</command>. <note> <para>Some systems (notably &RedHat; &Linux;) use <filename>.Xclients</filename> instead.</para> +</note></para> +<para>This should present you with a new shining &kde; desktop. You can now start to explore the wonderful world of &kde;. In case you want to read some documentation first, there is a highly recommended <ulink url="http://www.kde.org/documentation/quickstart/index.html">Quick Start guide</ulink> available. Furthermore, every application has an online help that is available via the <guimenu>help</guimenu> menu.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Should I remove old version xyz before installing a new one?</para> +<para>Should I remove old version xyz before installing a new one?</para> </question> <answer> -<para ->In principle, this is not necessary. <acronym ->RPM</acronym -> and Debian packages should take care of all dependencies.</para> -<para ->If you compile the source code yourself, you should take more care. Instructions for running two different versions of &kde; on the same system are given at <ulink url="http://developer.kde.org/build/kde2-and-kde3.html" ->http://developer.kde.org/build/kde2-and-kde3.html</ulink ->. However, please note that running two different versions of &kde; from source can lead to problems if you are not careful. </para> +<para>In principle, this is not necessary. <acronym>RPM</acronym> and Debian packages should take care of all dependencies.</para> +<para>If you compile the source code yourself, you should take more care. Instructions for running two different versions of &kde; on the same system are given at <ulink url="http://developer.kde.org/build/kde2-and-kde3.html">http://developer.kde.org/build/kde2-and-kde3.html</ulink>. However, please note that running two different versions of &kde; from source can lead to problems if you are not careful. </para> </answer> </qandaentry> <qandaentry> <question id="starttde"> -<para ->How do I start &kde;?</para> +<para>How do I start &kde;?</para> </question> <answer> -<para ->The most comfortable method to start &kde; is to use the <filename ->starttde</filename -> script. Simply put the line <command ->starttde</command -> at the end of your <filename ->.xsession</filename -> file (or your <filename ->.xinitrc</filename -> or <filename ->.Xclients</filename -> file if you are not using &tdm; or <application ->xdm</application ->). Please also remove the lines that start your previous window manager. If there is no <filename ->.xsession</filename ->, <filename ->.xinitrc</filename ->, or <filename ->.Xclients</filename -> in your home folder, simply create a new one that contains just one line: <command ->starttde</command ->.</para> +<para>The most comfortable method to start &kde; is to use the <filename>starttde</filename> script. Simply put the line <command>starttde</command> at the end of your <filename>.xsession</filename> file (or your <filename>.xinitrc</filename> or <filename>.Xclients</filename> file if you are not using &tdm; or <application>xdm</application>). Please also remove the lines that start your previous window manager. If there is no <filename>.xsession</filename>, <filename>.xinitrc</filename>, or <filename>.Xclients</filename> in your home folder, simply create a new one that contains just one line: <command>starttde</command>.</para> </answer> </qandaentry> <!-- Still needed? <qandaentry> <question> -<para ->Whenever I start &kde;, it complains about "shadow passwords". +<para>Whenever I start &kde;, it complains about "shadow passwords". Why?</para> </question> <answer> -<para ->When your system uses shadow passwords, the screensaver can only +<para>When your system uses shadow passwords, the screensaver can only run properly if the suid bit is set. This bit gives the screensavers root privileges, which are needed to access the shadow passwords. -<caution -><para ->The screensavers might be configured to secure the -machine until the password is entered.</para -></caution -></para> +<caution><para>The screensavers might be configured to secure the +machine until the password is entered.</para></caution></para> <procedure> -<title ->Setting the suid bit on the screensavers</title> -<step performance="required" -><para ->become root</para -></step> -<step performance="required" -><para -><command ->chown root -$<envar ->TDEDIR</envar ->/bin/*.kss</command -></para -></step> -<step performance="required" -><para -><command ->chmod u+s -$<envar ->TDEDIR</envar ->/bin/*.kss</command -></para -></step> +<title>Setting the suid bit on the screensavers</title> +<step performance="required"><para>become root</para></step> +<step performance="required"><para><command>chown root +$<envar>TDEDIR</envar>/bin/*.kss</command></para></step> +<step performance="required"><para><command>chmod u+s +$<envar>TDEDIR</envar>/bin/*.kss</command></para></step> </procedure> -<para ->Alternatively, if you compile &kde; from source, you can use -<command ->./configure <option ->with-shadow</option -></command -> to +<para>Alternatively, if you compile &kde; from source, you can use +<command>./configure <option>with-shadow</option></command> to configure tdebase. Then the suid bit is set automatically during -<command ->make install</command ->.</para> +<command>make install</command>.</para> </answer> </qandaentry> --> <qandaentry> <question> -<para ->Is it possible to install &kde; in a user folder?</para> +<para>Is it possible to install &kde; in a user folder?</para> </question> <answer> -<para ->Yes, you can install &kde; in any folder you want. What you have to do depends on the kind of packages you want to install:</para> -<procedure -><title ->Source packages</title> -<step performance="required" -><para ->Configure and install the package using <command ->configure <option ->--prefix=<replaceable ->/users/myhome/kde</replaceable -></option ->; make; make install</command -> to install into <filename class="directory" ->/users/myhome/kde</filename ->.</para -></step> -<step performance="required" -><para ->Add the following to your init files. Please note that if it is not necessary for you to set <envar ->LD_LIBRARY_PATH</envar ->, it is better to leave it out.</para> +<para>Yes, you can install &kde; in any folder you want. What you have to do depends on the kind of packages you want to install:</para> +<procedure><title>Source packages</title> +<step performance="required"><para>Configure and install the package using <command>configure <option>--prefix=<replaceable>/users/myhome/kde</replaceable></option>; make; make install</command> to install into <filename class="directory">/users/myhome/kde</filename>.</para></step> +<step performance="required"><para>Add the following to your init files. Please note that if it is not necessary for you to set <envar>LD_LIBRARY_PATH</envar>, it is better to leave it out.</para> -<para ->For csh or tcsh:</para> -<programlisting ->setenv TDEDIR /users/myhome/kde +<para>For csh or tcsh:</para> +<programlisting>setenv TDEDIR /users/myhome/kde if ( $?LD_LIBRARY_PATH ) then setenv LD_LIBRARY_PATH $TDEDIR/lib:$LD_LIBRARY_PATH @@ -645,116 +310,54 @@ if ( ! $?LIBRARY_PATH ) then setenv LIBRARY_PATH $LD_LIBRARY_PATH endif </programlisting> -<para ->For <application ->bash</application ->:</para> -<programlisting ->TDEDIR=/users/myhome/kde +<para>For <application>bash</application>:</para> +<programlisting>TDEDIR=/users/myhome/kde PATH=$TDEDIR/bin:$PATH LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH LIBRARY_PATH=$LD_LIBRARY_PATH export TDEDIR PATH LD_LIBRARY_PATH LIBRARY_PATH -</programlisting -></step> +</programlisting></step> </procedure> -<procedure -><title -><acronym ->RPM</acronym -> packages</title> -<step performance="required" -><para -><command ->rpm</command -> allows you to use the <option ->--prefix</option -> option to select the folder you want to install to. For example, executing <command ->rpm <option ->-i --prefix=<replaceable ->/users/myhome/kde package.rpm</replaceable -></option -></command -> will install the package to <filename class="directory" ->/users/myhome/kde</filename ->.</para -></step> +<procedure><title><acronym>RPM</acronym> packages</title> +<step performance="required"><para><command>rpm</command> allows you to use the <option>--prefix</option> option to select the folder you want to install to. For example, executing <command>rpm <option>-i --prefix=<replaceable>/users/myhome/kde package.rpm</replaceable></option></command> will install the package to <filename class="directory">/users/myhome/kde</filename>.</para></step> </procedure> -<para -><note> -<para ->Although &kde; will run from a user folder, there are some problems with programs that require suid root, ⪚ the programs in the tdeadmin package. But since they are not meant to be run by users in the first place, this is nothing to worry about.</para> -<para ->However, on systems using shadow passwords, the screensavers have to be suid root to enable password access for unlocking the screen, so this option will not work.</para> -</note -></para> +<para><note> +<para>Although &kde; will run from a user folder, there are some problems with programs that require suid root, ⪚ the programs in the tdeadmin package. But since they are not meant to be run by users in the first place, this is nothing to worry about.</para> +<para>However, on systems using shadow passwords, the screensavers have to be suid root to enable password access for unlocking the screen, so this option will not work.</para> +</note></para> </answer> </qandaentry> <qandaentry> <question> -<para -><command ->starttde</command -> fails with <errorname ->can not connect to X server</errorname ->. What is wrong?</para> +<para><command>starttde</command> fails with <errorname>can not connect to X server</errorname>. What is wrong?</para> </question> <answer> -<para ->You probably tried to start the X server with <command ->starttde</command ->. The X server is started with <command ->startx</command ->. <command ->starttde</command -> is the script that should be run from your <filename ->.xinitrc</filename ->, <filename ->.xsession</filename ->, or <filename ->.Xclients</filename -> to activate the window manager and the necessary server daemons for &kde;. See also <xref linkend="starttde"/>.</para> +<para>You probably tried to start the X server with <command>starttde</command>. The X server is started with <command>startx</command>. <command>starttde</command> is the script that should be run from your <filename>.xinitrc</filename>, <filename>.xsession</filename>, or <filename>.Xclients</filename> to activate the window manager and the necessary server daemons for &kde;. See also <xref linkend="starttde"/>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->&kde; on &AIX;?</para> +<para>&kde; on &AIX;?</para> </question> <answer> -<para -><acronym ->IBM</acronym -> now officially support &kde; on &AIX;. You can find details at <ulink url="http://www.ibm.com/servers/aix/products/aixos/linux/index.html" ->http://www.ibm.com/servers/aix/products/aixos/linux/index.html</ulink ->. There is also some older information at <ulink url="http://space.twc.de/~stefan/kde/aix.html" ->http://space.twc.de/~stefan/kde/aix.html</ulink ->.</para> +<para><acronym>IBM</acronym> now officially support &kde; on &AIX;. You can find details at <ulink url="http://www.ibm.com/servers/aix/products/aixos/linux/index.html">http://www.ibm.com/servers/aix/products/aixos/linux/index.html</ulink>. There is also some older information at <ulink url="http://space.twc.de/~stefan/kde/aix.html">http://space.twc.de/~stefan/kde/aix.html</ulink>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->&kde; on a laptop?</para> +<para>&kde; on a laptop?</para> </question> <answer> -<para ->If you can get &X-Window; to run on your laptop, you should not have any problem getting &kde; to run on it. In addition, you might find the following links helpful:</para> +<para>If you can get &X-Window; to run on your laptop, you should not have any problem getting &kde; to run on it. In addition, you might find the following links helpful:</para> <itemizedlist> <listitem> -<para -><ulink url="http://www.linux-laptop.net/" ->http://www.linux-laptop.net/</ulink -></para> +<para><ulink url="http://www.linux-laptop.net/">http://www.linux-laptop.net/</ulink></para> </listitem> <listitem> -<para -><ulink url="http://www.sanpei.org/Laptop-X/note-list.html" ->http://www.sanpei.org/Laptop-X/note-list.html</ulink -></para> +<para><ulink url="http://www.sanpei.org/Laptop-X/note-list.html">http://www.sanpei.org/Laptop-X/note-list.html</ulink></para> </listitem> </itemizedlist> </answer> @@ -762,273 +365,114 @@ export TDEDIR PATH LD_LIBRARY_PATH LIBRARY_PATH <qandaentry> <question> -<para ->I have a neomagic chipset in my laptop. Is there anything special I should do to run &kde;?</para> +<para>I have a neomagic chipset in my laptop. Is there anything special I should do to run &kde;?</para> </question> <answer> -<para ->On some laptops using the 2160 chipset (MagicGraph 128XD) the following options in <filename ->XF86Config</filename -> are needed to avoid a lock-up of the graphic engine:</para> -<screen ->Option "XaaNoScanlineImageWriteRect" +<para>On some laptops using the 2160 chipset (MagicGraph 128XD) the following options in <filename>XF86Config</filename> are needed to avoid a lock-up of the graphic engine:</para> +<screen>Option "XaaNoScanlineImageWriteRect" Option "XaaNoScanlineCPUToScreenColorExpandFill"</screen> -<para ->If you have experienced desktop hangs while using &kde; please try this option.</para -> -</answer -> +<para>If you have experienced desktop hangs while using &kde; please try this option.</para> +</answer> </qandaentry> <qandaentry> <question> -<para ->I do not like the default &kde; folder after installation. How do I move it without breaking anything?</para> +<para>I do not like the default &kde; folder after installation. How do I move it without breaking anything?</para> </question> <answer> -<para ->Assuming the default is <filename class="directory" ->/opt/kde</filename -> and you want to move it to <filename class="directory" ->/usr/local/kde</filename ->, here's what you have to do:</para> +<para>Assuming the default is <filename class="directory">/opt/kde</filename> and you want to move it to <filename class="directory">/usr/local/kde</filename>, here's what you have to do:</para> <procedure> -<step performance="required" -><para ->change to superuser if you aren't already</para -></step> -<step performance="required" -><para -><command ->mv /opt/kde /usr/local/kde</command -></para -></step> -<step performance="required" -><para -><command ->ln -s /usr/local/kde /opt/kde</command -></para -></step> +<step performance="required"><para>change to superuser if you aren't already</para></step> +<step performance="required"><para><command>mv /opt/kde /usr/local/kde</command></para></step> +<step performance="required"><para><command>ln -s /usr/local/kde /opt/kde</command></para></step> </procedure> -<para ->This will put all your &kde; files in <filename class="directory" ->/usr/local/kde</filename -> but everything is still accessible from <filename class="directory" ->/opt/kde</filename ->.</para> +<para>This will put all your &kde; files in <filename class="directory">/usr/local/kde</filename> but everything is still accessible from <filename class="directory">/opt/kde</filename>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->What files can I delete from my &kde; install folder? Can all the <filename ->*.h</filename ->, <filename ->*.c</filename -> and <filename ->*.o</filename -> files be safely removed?</para> +<para>What files can I delete from my &kde; install folder? Can all the <filename>*.h</filename>, <filename>*.c</filename> and <filename>*.o</filename> files be safely removed?</para> </question> <answer> -<para ->There should not be any need to keep the <filename ->.c</filename -> and <filename ->.o</filename -> files, but you might want to keep the <filename ->.h</filename -> files, as they are used by includes if you ever want to compile your own &kde; programs. But if you wish to add patches to the source programs as they become available (rather than downloading everything again), then they should stay.</para -> +<para>There should not be any need to keep the <filename>.c</filename> and <filename>.o</filename> files, but you might want to keep the <filename>.h</filename> files, as they are used by includes if you ever want to compile your own &kde; programs. But if you wish to add patches to the source programs as they become available (rather than downloading everything again), then they should stay.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Will I lose my current settings when I upgrade &kde;?</para> +<para>Will I lose my current settings when I upgrade &kde;?</para> </question> <answer> -<para ->No. In most cases &kde; will be able to transport your settings intact. You may need to reenter passwords in some applications (such as &kmail; or &knode;) but most other settings will be safe.</para> +<para>No. In most cases &kde; will be able to transport your settings intact. You may need to reenter passwords in some applications (such as &kmail; or &knode;) but most other settings will be safe.</para> -<para ->There were mixed reports of results between some previous versions of &kde;. To be safe, you may like to back up your entire &kde; configuration. </para> +<para>There were mixed reports of results between some previous versions of &kde;. To be safe, you may like to back up your entire &kde; configuration. </para> -<para ->Settings are kept in the <filename class="directory" ->$<envar ->HOME</envar ->/.trinity</filename -> or <filename class="directory" ->$<envar ->HOME</envar ->/.kde2</filename -> subfolder in your home folder. Copy your old <filename class="directory" ->.kde</filename ->/<filename class="directory" ->.kde2</filename -> folder to a backup location, install &kde; 3.2, and then copy back any necessary mail and news settings. That said, most people can make a direct upgrade, without removing the old <filename class="directory" ->.kde</filename -> folder, without a hitch.</para> -<para ->You can override the use of <filename class="directory" ->$<envar ->HOME</envar ->/.trinity</filename -> by setting the $<envar ->TDEHOME</envar -> variable.</para -> +<para>Settings are kept in the <filename class="directory">$<envar>HOME</envar>/.trinity</filename> or <filename class="directory">$<envar>HOME</envar>/.kde2</filename> subfolder in your home folder. Copy your old <filename class="directory">.kde</filename>/<filename class="directory">.kde2</filename> folder to a backup location, install &kde; 3.2, and then copy back any necessary mail and news settings. That said, most people can make a direct upgrade, without removing the old <filename class="directory">.kde</filename> folder, without a hitch.</para> +<para>You can override the use of <filename class="directory">$<envar>HOME</envar>/.trinity</filename> by setting the $<envar>TDEHOME</envar> variable.</para> </answer> </qandaentry> <qandaentry id="greyscreen"> <question> -<para ->I upgraded &kde; and it seemed to go fine, but when I start it, I get a blank grey screen, and nothing happens. There are errors in the console about DCOPserver. What's going on?</para> +<para>I upgraded &kde; and it seemed to go fine, but when I start it, I get a blank grey screen, and nothing happens. There are errors in the console about DCOPserver. What's going on?</para> </question> <answer> -<para ->&kde; uses several temporary files during its operation. These are usually to be found in the following locations:</para> +<para>&kde; uses several temporary files during its operation. These are usually to be found in the following locations:</para> <itemizedlist> -<listitem -><para -><filename ->~/.DCOPserver-*</filename -> (there are usually two of these; one is a symlink to the other)</para -></listitem> -<listitem -><para -><filename ->~/.trinity/socket-<replaceable ->hostname</replaceable -></filename -></para -></listitem> -<listitem -><para -><filename ->~/.trinity/tmp-<replaceable ->hostname</replaceable -></filename -> which is normally a symlink to the next file:</para -></listitem> -<listitem -><para -><filename ->/tmp/tmp-kde-<replaceable ->USER</replaceable -></filename -></para -></listitem> -<listitem -><para -><filename ->~/.trinity/socket-<replaceable ->hostname</replaceable -></filename -> which is also normally a symlink to:</para -></listitem> -<listitem -><para -><filename ->/tmp/tdesocket-<replaceable ->USER</replaceable -></filename -></para -></listitem> +<listitem><para><filename>~/.DCOPserver-*</filename> (there are usually two of these; one is a symlink to the other)</para></listitem> +<listitem><para><filename>~/.trinity/socket-<replaceable>hostname</replaceable></filename></para></listitem> +<listitem><para><filename>~/.trinity/tmp-<replaceable>hostname</replaceable></filename> which is normally a symlink to the next file:</para></listitem> +<listitem><para><filename>/tmp/tmp-kde-<replaceable>USER</replaceable></filename></para></listitem> +<listitem><para><filename>~/.trinity/socket-<replaceable>hostname</replaceable></filename> which is also normally a symlink to:</para></listitem> +<listitem><para><filename>/tmp/tdesocket-<replaceable>USER</replaceable></filename></para></listitem> </itemizedlist> -<para ->If the symlinks get broken, usually because a <command ->cron</command -> or shutdown script is emptying out the <filename class="directory" ->/tmp</filename -> folder, then strange things will happen. These files, and the symlinks, will all be created automatically at the start of &kde; so you can safely remove them <emphasis ->while &kde; is not running</emphasis ->.</para> +<para>If the symlinks get broken, usually because a <command>cron</command> or shutdown script is emptying out the <filename class="directory">/tmp</filename> folder, then strange things will happen. These files, and the symlinks, will all be created automatically at the start of &kde; so you can safely remove them <emphasis>while &kde; is not running</emphasis>.</para> -<para ->If you are only getting a grey screen when you start &kde;, or if you get an error message telling you to <errorname ->Check your installation</errorname ->, then shut down X and delete all the files listed above, then try to restart X.</para> +<para>If you are only getting a grey screen when you start &kde;, or if you get an error message telling you to <errorname>Check your installation</errorname>, then shut down X and delete all the files listed above, then try to restart X.</para> -<para ->Normally (&ie; when not upgrading between &kde; versions) it's quite safe to leave these files intact, and you may shave a few seconds off your &kde; startup time by doing so.</para> +<para>Normally (&ie; when not upgrading between &kde; versions) it's quite safe to leave these files intact, and you may shave a few seconds off your &kde; startup time by doing so.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Compiling tdebase gives me a <errorname ->bin/sh: msgfmt: command not found</errorname -> error!</para> +<para>Compiling tdebase gives me a <errorname>bin/sh: msgfmt: command not found</errorname> error!</para> </question> <answer> -<para ->You need the &GNU; <application ->msgfmt</application -> which is part of the &GNU; i18n package <application ->gettext</application ->. You should be able to download it from any &GNU; mirror.</para> +<para>You need the &GNU; <application>msgfmt</application> which is part of the &GNU; i18n package <application>gettext</application>. You should be able to download it from any &GNU; mirror.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I uninstall &kde; applications compiled from source?</para> +<para>How do I uninstall &kde; applications compiled from source?</para> </question> <answer> -<para ->You can uninstall your programs by typing <command ->make uninstall</command -> in the folder where you did <command ->make install</command ->. If you have already deleted that folder, then there is only one way, and it is not good: go to <filename class="directory" ->$<envar ->TDEDIR</envar ->/bin</filename -> and start deleting files one by one.</para> -<para ->If you expect to find yourself in this situation, you might want to consider a program such as &GNU; <application ->stow</application ->, found at <ulink url="http://www.gnu.org/software/stow/stow.html" ->http://www.gnu.org/software/stow/stow.html</ulink ->.</para> +<para>You can uninstall your programs by typing <command>make uninstall</command> in the folder where you did <command>make install</command>. If you have already deleted that folder, then there is only one way, and it is not good: go to <filename class="directory">$<envar>TDEDIR</envar>/bin</filename> and start deleting files one by one.</para> +<para>If you expect to find yourself in this situation, you might want to consider a program such as &GNU; <application>stow</application>, found at <ulink url="http://www.gnu.org/software/stow/stow.html">http://www.gnu.org/software/stow/stow.html</ulink>.</para> </answer> </qandaentry> <qandaentry> <question id="gif"> -<para ->What is up with &GIF; support?</para> +<para>What is up with &GIF; support?</para> </question> <answer> -<para ->This has to do with issues with Unisys' &LZW; patent. &GIF; support is turned off from &Qt; 1.44 onwards by default. When you want to use &GIF;s and have the relevant license, recompile &Qt; with &GIF; support. <command ->./configure <option ->-gif</option -></command ->.</para> +<para>This has to do with issues with Unisys' &LZW; patent. &GIF; support is turned off from &Qt; 1.44 onwards by default. When you want to use &GIF;s and have the relevant license, recompile &Qt; with &GIF; support. <command>./configure <option>-gif</option></command>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I install &kde; themes?</para> +<para>How do I install &kde; themes?</para> </question> <answer> -<para ->Theme support in &kde; has been discontinued with this version. However, there are many opportunities to personalise and add eye candy to &kde; Look at, for example, <guilabel ->Appearance & Themes</guilabel -> in &kcontrol;. </para> +<para>Theme support in &kde; has been discontinued with this version. However, there are many opportunities to personalise and add eye candy to &kde; Look at, for example, <guilabel>Appearance & Themes</guilabel> in &kcontrol;. </para> </answer> </qandaentry> </qandaset> diff --git a/tde-i18n-en_GB/docs/tdebase/faq/intro.docbook b/tde-i18n-en_GB/docs/tdebase/faq/intro.docbook index 525629c101d..6b31d8982e0 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/intro.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/intro.docbook @@ -5,94 +5,57 @@ --> <chapter id="introduction"> -<title ->Introduction</title> +<title>Introduction</title> <qandaset> <qandaentry> <question> -<para ->What is &kde;?</para> +<para>What is &kde;?</para> </question> <answer> -<para ->&kde; is the K Desktop Environment. It is a project initiated by <ulink url="mailto:ettrich@kde.org" ->Matthias Ettrich</ulink -> in 1996. The aim of the &kde; project is to connect the power of the &UNIX; operating systems with the comfort of a modern user interface.</para> -<para ->In short, &kde; will bring &UNIX; to the desktop!</para> -<para ->If you want further information about &kde;, have a look at <ulink url="http://www.kde.org/whatiskde/index.html" ->What is &kde;?</ulink -></para> +<para>&kde; is the K Desktop Environment. It is a project initiated by <ulink url="mailto:ettrich@kde.org">Matthias Ettrich</ulink> in 1996. The aim of the &kde; project is to connect the power of the &UNIX; operating systems with the comfort of a modern user interface.</para> +<para>In short, &kde; will bring &UNIX; to the desktop!</para> +<para>If you want further information about &kde;, have a look at <ulink url="http://www.kde.org/whatiskde/index.html">What is &kde;?</ulink></para> </answer> </qandaentry> <qandaentry> <question id="platform"> -<para ->On which platforms can I expect &kde; to work?</para> +<para>On which platforms can I expect &kde; to work?</para> </question> <answer> -<para ->&kde; is a Desktop Environment for all flavours of &UNIX;. While it is true that most &kde; developers use &Linux;, &kde; runs smoothly on a wide range of systems. You may, however, need to tweak the source code a bit to get &kde; to compile on a not-so-popular variant of &UNIX;, or if you are not using the &GNU; development tools, in particular the &gcc; compiler.</para> -<para ->For an almost complete list of systems &kde; is running on, please refer to <ulink url="http://promo.kde.org/kde_systems.php" ->this list of systems for KDE</ulink -> </para> +<para>&kde; is a Desktop Environment for all flavours of &UNIX;. While it is true that most &kde; developers use &Linux;, &kde; runs smoothly on a wide range of systems. You may, however, need to tweak the source code a bit to get &kde; to compile on a not-so-popular variant of &UNIX;, or if you are not using the &GNU; development tools, in particular the &gcc; compiler.</para> +<para>For an almost complete list of systems &kde; is running on, please refer to <ulink url="http://promo.kde.org/kde_systems.php">this list of systems for KDE</ulink> </para> </answer> </qandaentry> <qandaentry> <question> -<para ->Is &kde; a window manager?</para> +<para>Is &kde; a window manager?</para> </question> <answer> -<para ->No, &kde; is not a window manager. While &kde; includes a very sophisticated window manager (&twin;), &kde; is much more than that. It is a full-blown Integrated Desktop Environment.</para> -<para ->&kde; provides a complete desktop environment, including a web browser, a file manager, a window manager, a help system, a configuration system, uncountable tools and utilities, and an ever increasing number of applications, including but not limited to mail and news clients, drawing programs, a &PostScript; and a &DVI; viewer and so forth.</para> +<para>No, &kde; is not a window manager. While &kde; includes a very sophisticated window manager (&twin;), &kde; is much more than that. It is a full-blown Integrated Desktop Environment.</para> +<para>&kde; provides a complete desktop environment, including a web browser, a file manager, a window manager, a help system, a configuration system, uncountable tools and utilities, and an ever increasing number of applications, including but not limited to mail and news clients, drawing programs, a &PostScript; and a &DVI; viewer and so forth.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Is &kde; a <acronym ->CDE</acronym ->, &Windows; 95 or &Mac; <acronym ->OS</acronym -> clone?</para> +<para>Is &kde; a <acronym>CDE</acronym>, &Windows; 95 or &Mac; <acronym>OS</acronym> clone?</para> </question> <answer> -<para ->No, &kde; is not a clone. Specifically &kde; is not a <acronym ->CDE</acronym -> or &Windows; clone. While the &kde; developers have and will continue to glean the best features from all existing desktop environments, &kde; is a truly unique environment that has and will continue to go its own way.</para> +<para>No, &kde; is not a clone. Specifically &kde; is not a <acronym>CDE</acronym> or &Windows; clone. While the &kde; developers have and will continue to glean the best features from all existing desktop environments, &kde; is a truly unique environment that has and will continue to go its own way.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Is &kde; free software?</para> +<para>Is &kde; free software?</para> </question> <answer> -<para ->Yes, &kde; is free software according to the &GNU; General Public Licence. All &kde; libraries are available under the <acronym ->LGPL</acronym -> making commercial software development for the &kde; desktop possible, but all &kde; applications are licensed under the <acronym ->GPL</acronym ->.</para> -<para ->&kde; uses the <link linkend="qt" ->&Qt; C++ crossplatform toolkit</link ->, which is also released (since version 2.2) under the <acronym ->GPL</acronym ->.</para> -<para ->It is absolutely legal to make &kde; and &Qt; available on &CD-ROM; free of charge. No runtime fees of any kind are incurred.</para> +<para>Yes, &kde; is free software according to the &GNU; General Public Licence. All &kde; libraries are available under the <acronym>LGPL</acronym> making commercial software development for the &kde; desktop possible, but all &kde; applications are licensed under the <acronym>GPL</acronym>.</para> +<para>&kde; uses the <link linkend="qt">&Qt; C++ crossplatform toolkit</link>, which is also released (since version 2.2) under the <acronym>GPL</acronym>.</para> +<para>It is absolutely legal to make &kde; and &Qt; available on &CD-ROM; free of charge. No runtime fees of any kind are incurred.</para> </answer> </qandaentry> </qandaset> diff --git a/tde-i18n-en_GB/docs/tdebase/faq/misc.docbook b/tde-i18n-en_GB/docs/tdebase/faq/misc.docbook index 103ad37b78a..d0047f27cad 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/misc.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/misc.docbook @@ -5,321 +5,192 @@ --> <chapter id="misc"> -<title ->Miscellaneous questions</title> +<title>Miscellaneous questions</title> <qandaset> <qandaentry> <question> -<para ->Why does &kde; use &Qt;?</para> +<para>Why does &kde; use &Qt;?</para> </question> <answer> -<para ->&Qt; is a very sophisticated toolkit that provides everything that is needed to build a modern user interface. &Qt; is written in C++, thus allowing object-oriented development which ensures efficiency and code reuse in a project the size and scope of &kde;. In our opinion there is no better toolkit available for &UNIX; systems and that it would have been a grave mistake to try to build &kde; on anything but the best.</para> +<para>&Qt; is a very sophisticated toolkit that provides everything that is needed to build a modern user interface. &Qt; is written in C++, thus allowing object-oriented development which ensures efficiency and code reuse in a project the size and scope of &kde;. In our opinion there is no better toolkit available for &UNIX; systems and that it would have been a grave mistake to try to build &kde; on anything but the best.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Why does &kde; not use gtk, xforms, xlib, whatever?</para> +<para>Why does &kde; not use gtk, xforms, xlib, whatever?</para> </question> <answer> -<para ->There are a number of toolkits available. To provide a consistent user interface and to keep used resources such as memory to a minimum, &kde; can use only one of them. &Qt; was selected for the reasons mentioned above.</para> +<para>There are a number of toolkits available. To provide a consistent user interface and to keep used resources such as memory to a minimum, &kde; can use only one of them. &Qt; was selected for the reasons mentioned above.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->But &Qt; isn't free, is it?</para> +<para>But &Qt; isn't free, is it?</para> </question> <answer> -<para ->It is! As of September 4, 2000, version 2.2 of the &Qt; libraries were licensed under the <acronym ->GPL</acronym ->, thereby fulfiling all aspects of <quote ->free software</quote ->.</para> +<para>It is! As of September 4, 2000, version 2.2 of the &Qt; libraries were licensed under the <acronym>GPL</acronym>, thereby fulfiling all aspects of <quote>free software</quote>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Does &kde; have terminal emulators with transparent background?</para> +<para>Does &kde; have terminal emulators with transparent background?</para> </question> <answer> -<para ->Yes and no. &konsole; has the ability to simulate transparency by redrawing the background of the window inside the &konsole; window. This gives the illusion of transparency, but if you place &konsole; on top of another window, the transparency is lost. <ulink url="http://www.eterm.org" ->Eterm</ulink -> should work fine under &kde; if you desire more complete transparency.</para> +<para>Yes and no. &konsole; has the ability to simulate transparency by redrawing the background of the window inside the &konsole; window. This gives the illusion of transparency, but if you place &konsole; on top of another window, the transparency is lost. <ulink url="http://www.eterm.org">Eterm</ulink> should work fine under &kde; if you desire more complete transparency.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I create icons for non-&kde; applications that I can put in the <guimenu ->K</guimenu -> menu? Where do these icons go?</para> +<para>How do I create icons for non-&kde; applications that I can put in the <guimenu>K</guimenu> menu? Where do these icons go?</para> </question> <answer> -<para ->Create them using your favourite image manipulator, for example, <application ->GIMP</application ->, or the <application ->&kde; Icon Editor</application -> and put them in <filename class="directory" ->$<envar ->TDEDIR</envar ->/share/icons(/mini)</filename -> or <filename class="directory" ->$<envar ->HOME</envar ->/.trinity/share/icons(/mini)</filename ->. </para> +<para>Create them using your favourite image manipulator, for example, <application>GIMP</application>, or the <application>&kde; Icon Editor</application> and put them in <filename class="directory">$<envar>TDEDIR</envar>/share/icons(/mini)</filename> or <filename class="directory">$<envar>HOME</envar>/.trinity/share/icons(/mini)</filename>. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->What about &kde; programs that do not have icons? How do I get them into the menu?</para> +<para>What about &kde; programs that do not have icons? How do I get them into the menu?</para> </question> <answer> -<para ->Use &kmenuedit;. To access it use the &RMB; on the <guibutton ->K</guibutton -> button and select <guimenu ->Menu Editor</guimenu ->.</para> +<para>Use &kmenuedit;. To access it use the &RMB; on the <guibutton>K</guibutton> button and select <guimenu>Menu Editor</guimenu>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Does &kde; have a graphical &FTP; client?</para> +<para>Does &kde; have a graphical &FTP; client?</para> </question> <answer> -<para ->Yes, and it is none other than your favourite file manager, &konqueror;. You can drag and drop remote files into local folders.</para> +<para>Yes, and it is none other than your favourite file manager, &konqueror;. You can drag and drop remote files into local folders.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I exit &kde;?</para> +<para>How do I exit &kde;?</para> </question> <answer> -<para ->Simply click on the <guibutton ->K</guibutton -> button and select <guimenu ->Logout</guimenu ->. In addition, if you <mousebutton ->right</mousebutton -> click on an empty area of the desktop, you will be presented with a menu containing logout as one of the options. <note -><para ->Depending on your configuration of the &X-Window;, <keycombo action="simul" ->&Ctrl;&Alt;&Backspace;</keycombo -> might also do the trick by killing the X server, but its use prevents session management and cannot be recommended.</para -></note -></para> +<para>Simply click on the <guibutton>K</guibutton> button and select <guimenu>Logout</guimenu>. In addition, if you <mousebutton>right</mousebutton> click on an empty area of the desktop, you will be presented with a menu containing logout as one of the options. <note><para>Depending on your configuration of the &X-Window;, <keycombo action="simul">&Ctrl;&Alt;&Backspace;</keycombo> might also do the trick by killing the X server, but its use prevents session management and cannot be recommended.</para></note></para> </answer> </qandaentry> <qandaentry> <question> -<para ->Is there a program that checks for new mails at my <acronym ->ISP</acronym -> if and only if I am online?</para> +<para>Is there a program that checks for new mails at my <acronym>ISP</acronym> if and only if I am online?</para> </question> <answer> -<para ->&korn; will do the job. If you are not connected, it will just sit there (idling).</para> +<para>&korn; will do the job. If you are not connected, it will just sit there (idling).</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Is it really necessary to upgrade to the latest version?</para> +<para>Is it really necessary to upgrade to the latest version?</para> </question> <answer> -<para ->We recommend to always use the latest stable release. If you don't, it will probably be difficult to get answers to your questions. If you have a problem with an old version, the answer will probably be <quote ->Please upgrade and try again</quote ->. Note that new versions also sometimes fix security problems.</para> +<para>We recommend to always use the latest stable release. If you don't, it will probably be difficult to get answers to your questions. If you have a problem with an old version, the answer will probably be <quote>Please upgrade and try again</quote>. Note that new versions also sometimes fix security problems.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I copy and paste in &kde;?</para> +<para>How do I copy and paste in &kde;?</para> </question> <answer> -<para ->The simplest method is to use your mouse:</para> +<para>The simplest method is to use your mouse:</para> <procedure> -<step performance="required" -><para ->Highlight the text you want to copy by holding down the &LMB; and dragging across the text.</para -></step> -<step performance="required" -><para ->Go to the destination area; depending on your configuration, you might need to click it using the &LMB; to give it focus.</para -></step> -<step performance="required" -><para ->Click the &MMB; to paste. If you have a two button mouse and are emulating a three button mouse, push both buttons simultaneously.</para -></step> +<step performance="required"><para>Highlight the text you want to copy by holding down the &LMB; and dragging across the text.</para></step> +<step performance="required"><para>Go to the destination area; depending on your configuration, you might need to click it using the &LMB; to give it focus.</para></step> +<step performance="required"><para>Click the &MMB; to paste. If you have a two button mouse and are emulating a three button mouse, push both buttons simultaneously.</para></step> </procedure> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I convert the default &RedHat; menus into a menu in the <guimenu ->K</guimenu -> menu?</para> +<para>How do I convert the default &RedHat; menus into a menu in the <guimenu>K</guimenu> menu?</para> </question> <answer> -<para ->Click on the <guibutton ->K</guibutton -> button and select <menuchoice -><guimenu ->System</guimenu -><guimenuitem ->Appfinder</guimenuitem -></menuchoice ->.</para> +<para>Click on the <guibutton>K</guibutton> button and select <menuchoice><guimenu>System</guimenu><guimenuitem>Appfinder</guimenuitem></menuchoice>.</para> </answer> </qandaentry> <qandaentry> <question id="CVS"> -<para ->What is <acronym ->CVS</acronym ->?</para> +<para>What is <acronym>CVS</acronym>?</para> </question> <answer> -<para ->It stands for Concurrent Versions System. It is a version control system and is based on <acronym ->RCS</acronym -> (Revision Control System), but offers more functionality. It is used to maintain source code under development. It will keep multiple versions of things (handy if you broke something and have to back up and get a clean old version), and allows people remote access over the Net to pick up the latest source code and even to check in new files if they have permission. It is also open source (you pay for support if you want it), and since it is free it is the system of choice for people writing more free products, such as &kde;.</para> +<para>It stands for Concurrent Versions System. It is a version control system and is based on <acronym>RCS</acronym> (Revision Control System), but offers more functionality. It is used to maintain source code under development. It will keep multiple versions of things (handy if you broke something and have to back up and get a clean old version), and allows people remote access over the Net to pick up the latest source code and even to check in new files if they have permission. It is also open source (you pay for support if you want it), and since it is free it is the system of choice for people writing more free products, such as &kde;.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Does &kde; support dual screen (Xinerama)?</para> +<para>Does &kde; support dual screen (Xinerama)?</para> </question> <answer> -<para ->Yes, you need to have a multi-headed X server (⪚ MetroX or XFree86 4.0 and above) and a &kde; ->= 2.2.1 </para> +<para>Yes, you need to have a multi-headed X server (⪚ MetroX or XFree86 4.0 and above) and a &kde; >= 2.2.1 </para> </answer> </qandaentry> <qandaentry> <question> -<para ->Why does Drag and Drop not work with Xinerama?</para> +<para>Why does Drag and Drop not work with Xinerama?</para> </question> <answer> -<para ->You should upgrade to XFree86 4.2.0 for this to work properly.</para> +<para>You should upgrade to XFree86 4.2.0 for this to work properly.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I check which version of &kde; I am using?</para> +<para>How do I check which version of &kde; I am using?</para> </question> <answer> -<para ->Fire up your <application ->&kde; Control Centre</application ->. It comes up with an Info Screen including the version of &kde; The &kde; version is also included in the application's <guimenuitem ->About</guimenuitem -> dialogue. </para> +<para>Fire up your <application>&kde; Control Centre</application>. It comes up with an Info Screen including the version of &kde; The &kde; version is also included in the application's <guimenuitem>About</guimenuitem> dialogue. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->Can I write commercial software for &kde;?</para> +<para>Can I write commercial software for &kde;?</para> </question> <answer> -<para ->You can use the &kde; libraries to write <quote ->commercial and closed source</quote -> as well as <quote ->commercial and open source</quote -> software. If you write open source software you can use the &Qt; free edition. But if you write closed source software you may not use the &Qt; free edition; you need to obtain the &Qt; professional edition from Troll Tech. </para -> <para ->If you want more information, please contact <ulink url="http://www.trolltech.com" ->Troll Tech</ulink -> directly.</para> +<para>You can use the &kde; libraries to write <quote>commercial and closed source</quote> as well as <quote>commercial and open source</quote> software. If you write open source software you can use the &Qt; free edition. But if you write closed source software you may not use the &Qt; free edition; you need to obtain the &Qt; professional edition from Troll Tech. </para> <para>If you want more information, please contact <ulink url="http://www.trolltech.com">Troll Tech</ulink> directly.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I go about creating themes and icons?</para> +<para>How do I go about creating themes and icons?</para> </question> <answer> -<para ->Go see <ulink url="http://artist.kde.org" ->http://artist.kde.org</ulink ->.</para> +<para>Go see <ulink url="http://artist.kde.org">http://artist.kde.org</ulink>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Is <application ->KLyX</application -> dead?</para> +<para>Is <application>KLyX</application> dead?</para> </question> <answer> -<para ->Yes. But future versions of <application ->LyX</application -> will be &GUI; independent. Check the progress of the various &GUI; frontends <ulink url="http://devel.lyx.org/guii.php3" ->here</ulink ->.</para> +<para>Yes. But future versions of <application>LyX</application> will be &GUI; independent. Check the progress of the various &GUI; frontends <ulink url="http://devel.lyx.org/guii.php3">here</ulink>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How can I get to know about development updates?</para> +<para>How can I get to know about development updates?</para> </question> <answer> -<para ->You might want to subscribe to the various &kde; mailing lists available, especially kde-cvs, which lists all commits done to the &kde; <acronym ->CVS</acronym -> repository. Check <ulink url="http://lists.kde.org" ->http://lists.kde.org</ulink -> if you want to read without subscribing.</para> +<para>You might want to subscribe to the various &kde; mailing lists available, especially kde-cvs, which lists all commits done to the &kde; <acronym>CVS</acronym> repository. Check <ulink url="http://lists.kde.org">http://lists.kde.org</ulink> if you want to read without subscribing.</para> </answer> </qandaentry> </qandaset> diff --git a/tde-i18n-en_GB/docs/tdebase/faq/moreinfo.docbook b/tde-i18n-en_GB/docs/tdebase/faq/moreinfo.docbook index ee77ff73614..a5fe88c3f7a 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/moreinfo.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/moreinfo.docbook @@ -5,243 +5,108 @@ --> <chapter id="more-info"> -<title ->Getting more information</title> +<title>Getting more information</title> <qandaset> <qandaentry> <question> -<para ->Where is the &kde; homepage?</para> +<para>Where is the &kde; homepage?</para> </question> <answer> -<para ->The &kde; homepage is located at <ulink url="http://www.kde.org" ->http://www.kde.org</ulink ->. If you prefer a local mirror, there are several to choose from. For a current list of web site mirrors sorted by location, please visit <ulink url="http://www.kde.org/mirrors/web.php" ->http://www.kde.org/mirrors/web.php</ulink ->.</para> +<para>The &kde; homepage is located at <ulink url="http://www.kde.org">http://www.kde.org</ulink>. If you prefer a local mirror, there are several to choose from. For a current list of web site mirrors sorted by location, please visit <ulink url="http://www.kde.org/mirrors/web.php">http://www.kde.org/mirrors/web.php</ulink>.</para> </answer> </qandaentry> <qandaentry> <question id="mailing-lists"> -<para ->Is there a &kde; mailing list?</para> +<para>Is there a &kde; mailing list?</para> </question> <answer> -<para ->There are several &kde; mailing lists. Each focuses on a different aspect of &kde;. Some are for developers, so they are not discussed in detail. Some of the more important lists that users might be interested in are:</para> +<para>There are several &kde; mailing lists. Each focuses on a different aspect of &kde;. Some are for developers, so they are not discussed in detail. Some of the more important lists that users might be interested in are:</para> <variablelist> -<varlistentry -><term ->kde</term> -<listitem -><para ->This is the main &kde; mailing list for general discussions.</para -></listitem> +<varlistentry><term>kde</term> +<listitem><para>This is the main &kde; mailing list for general discussions.</para></listitem> </varlistentry> -<varlistentry -><term ->kde-announce</term> -<listitem -><para ->This list is used to announce new versions of &kde; as well as new tools and applications.</para -></listitem> +<varlistentry><term>kde-announce</term> +<listitem><para>This list is used to announce new versions of &kde; as well as new tools and applications.</para></listitem> </varlistentry> -<varlistentry -><term ->kde-look</term> -<listitem -><para ->This is the list that deals with questions about look and feel, and general user interface considerations.</para -></listitem> +<varlistentry><term>kde-look</term> +<listitem><para>This is the list that deals with questions about look and feel, and general user interface considerations.</para></listitem> </varlistentry> </variablelist> -<para ->For the complete list of mailing lists available, please refer to <ulink url="http://www.kde.org/mailinglists/" ->http://www.kde.org/mailinglists/</ulink ->.</para> -<para ->Please note that it is not a good idea to ask questions which are already answered in this &FAQ;.</para> +<para>For the complete list of mailing lists available, please refer to <ulink url="http://www.kde.org/mailinglists/">http://www.kde.org/mailinglists/</ulink>.</para> +<para>Please note that it is not a good idea to ask questions which are already answered in this &FAQ;.</para> </answer> </qandaentry> <qandaentry> <question id="subscribe"> -<para ->How do I subscribe/unsubscribe to these lists?</para> +<para>How do I subscribe/unsubscribe to these lists?</para> </question> <answer> -<para ->To subscribe, send an email to list-request, that is:</para> +<para>To subscribe, send an email to list-request, that is:</para> <itemizedlist> -<listitem -><para -><ulink -url="mailto:kde-request@kde.org" ->kde-request@kde.org</ulink -></para -></listitem> -<listitem -><para -><ulink url="mailto:kde-announce-request@kde.org" ->kde-announce-request@kde.org</ulink -></para -></listitem> -<listitem -><para -><ulink -url="mailto:kde-user-request@kde.org" ->kde-user-request@kde.org</ulink -></para -></listitem> -<listitem -><para -><ulink url="mailto:kde-look-request@kde.org" ->kde-look-request@kde.org</ulink -></para -></listitem> +<listitem><para><ulink +url="mailto:kde-request@kde.org">kde-request@kde.org</ulink></para></listitem> +<listitem><para><ulink url="mailto:kde-announce-request@kde.org">kde-announce-request@kde.org</ulink></para></listitem> +<listitem><para><ulink +url="mailto:kde-user-request@kde.org">kde-user-request@kde.org</ulink></para></listitem> +<listitem><para><ulink url="mailto:kde-look-request@kde.org">kde-look-request@kde.org</ulink></para></listitem> </itemizedlist> -<para ->The email must contain <userinput ->subscribe <replaceable ->your_email_address</replaceable -></userinput -> in the subject.</para> -<para ->To unsubscribe, send an email to list-request, that is:</para> +<para>The email must contain <userinput>subscribe <replaceable>your_email_address</replaceable></userinput> in the subject.</para> +<para>To unsubscribe, send an email to list-request, that is:</para> <itemizedlist> -<listitem -><para -><ulink url="mailto:kde-request@kde.org" ->kde-request@kde.org</ulink -></para -></listitem> -<listitem -><para -><ulink url="mailto:kde-announce-request@kde.org" ->kde-announce-request@kde.org</ulink -></para -></listitem> -<listitem -><para -><ulink url="mailto:kde-user-request@kde.org" ->kde-user-request@kde.org</ulink -></para -></listitem> -<listitem -><para -><ulink url="mailto:kde-look-request@kde.org" ->kde-look-request@kde.org</ulink -></para -></listitem> +<listitem><para><ulink url="mailto:kde-request@kde.org">kde-request@kde.org</ulink></para></listitem> +<listitem><para><ulink url="mailto:kde-announce-request@kde.org">kde-announce-request@kde.org</ulink></para></listitem> +<listitem><para><ulink url="mailto:kde-user-request@kde.org">kde-user-request@kde.org</ulink></para></listitem> +<listitem><para><ulink url="mailto:kde-look-request@kde.org">kde-look-request@kde.org</ulink></para></listitem> </itemizedlist> -<para ->The email must contain <userinput ->unsubscribe <replaceable ->your_email_address</replaceable -></userinput -> in the subject. <important -><para ->Never send subscribe/unsubscribe request to the mailing lists directly! Use the list-request instead.</para -></important -></para> -<para ->There is also a complete list of all &kde;-related mailing lists, and a web interface for subscribing and unsubscribing located at <ulink url="http://master.kde.org/mailman/listinfo" ->http://master.kde.org/mailman/listinfo</ulink ->.</para> +<para>The email must contain <userinput>unsubscribe <replaceable>your_email_address</replaceable></userinput> in the subject. <important><para>Never send subscribe/unsubscribe request to the mailing lists directly! Use the list-request instead.</para></important></para> +<para>There is also a complete list of all &kde;-related mailing lists, and a web interface for subscribing and unsubscribing located at <ulink url="http://master.kde.org/mailman/listinfo">http://master.kde.org/mailman/listinfo</ulink>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Is there a mailing list archive?</para> +<para>Is there a mailing list archive?</para> </question> <answer> -<para ->Yes, there is a searchable mailing list archive hosted by <ulink url="http://www.progressive-comp.com" ->Progressive Computer Concepts</ulink ->. The &URL; is <ulink url="http://lists.kde.org" ->http://lists.kde.org</ulink ->. There you will see a folder listing of the mailing lists. Note that you can only do a subject/author search at this level. You probably will not find what you want doing this kind of search.</para> +<para>Yes, there is a searchable mailing list archive hosted by <ulink url="http://www.progressive-comp.com">Progressive Computer Concepts</ulink>. The &URL; is <ulink url="http://lists.kde.org">http://lists.kde.org</ulink>. There you will see a folder listing of the mailing lists. Note that you can only do a subject/author search at this level. You probably will not find what you want doing this kind of search.</para> -<para ->To do a body search, you have to enter one of the mailing lists. Just click on the folder you want to search (⪚ <quote ->kde</quote -> or <quote ->kde-user</quote ->) and then the pull-down menu by the search box will default to <quote ->Body</quote -> searches. To be thorough, you should probably search the <quote ->kde</quote ->, <quote ->kde-user</quote ->, and <quote ->kde-devel</quote -> folders. </para> +<para>To do a body search, you have to enter one of the mailing lists. Just click on the folder you want to search (⪚ <quote>kde</quote> or <quote>kde-user</quote>) and then the pull-down menu by the search box will default to <quote>Body</quote> searches. To be thorough, you should probably search the <quote>kde</quote>, <quote>kde-user</quote>, and <quote>kde-devel</quote> folders. </para> </answer> </qandaentry> <qandaentry> <question id="newsgroups"> -<para ->Is there a newsgroup about &kde;?</para> +<para>Is there a newsgroup about &kde;?</para> </question> <answer> -<para ->Yes, there is! It is at <literal ->comp.windows.x.kde</literal ->. In addition, there is also a German newsgroup at <literal ->de.alt.comp.kde</literal ->. Please note that it is not a good idea to ask questions which are already answered in this &FAQ;.</para> +<para>Yes, there is! It is at <literal>comp.windows.x.kde</literal>. In addition, there is also a German newsgroup at <literal>de.alt.comp.kde</literal>. Please note that it is not a good idea to ask questions which are already answered in this &FAQ;.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Are there any other &kde;-related &FAQ;s?</para> +<para>Are there any other &kde;-related &FAQ;s?</para> </question> <answer> -<para ->Yes. Here is a list of them:</para> +<para>Yes. Here is a list of them:</para> <itemizedlist> -<listitem -><para -><ulink -url="http://www.kde.org/info/faq.php" ->&kde; &FAQ;</ulink -></para -></listitem> -<listitem -><para -><ulink -url="http://konqueror.org/faq/" ->&konqueror; &FAQ;</ulink -></para -></listitem> -<listitem -><para -><ulink -url="http://www.arts-project.org/doc/manual/index.html" ->aRts sound server documentation</ulink -></para -></listitem> +<listitem><para><ulink +url="http://www.kde.org/info/faq.php">&kde; &FAQ;</ulink></para></listitem> +<listitem><para><ulink +url="http://konqueror.org/faq/">&konqueror; &FAQ;</ulink></para></listitem> +<listitem><para><ulink +url="http://www.arts-project.org/doc/manual/index.html">aRts sound server documentation</ulink></para></listitem> <!-- Removed because the kmail FAQ is part of the KMail manual and not a --> <!-- separate document -<listitem -><para -><ulink -url="http://kmail.kde.org/manual/faq.html" ->&kmail; -&FAQ;</ulink -></para -></listitem> +<listitem><para><ulink +url="http://kmail.kde.org/manual/faq.html">&kmail; +&FAQ;</ulink></para></listitem> --> </itemizedlist> diff --git a/tde-i18n-en_GB/docs/tdebase/faq/nontdeapps.docbook b/tde-i18n-en_GB/docs/tdebase/faq/nontdeapps.docbook index 8f4b3df5350..44b0272aee4 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/nontdeapps.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/nontdeapps.docbook @@ -5,59 +5,24 @@ --> <chapter id="non-kde-apps"> -<title ->&kde; with non-&kde; applications</title> +<title>&kde; with non-&kde; applications</title> <!-- FIXME: This seems to be obsolete. The only similar option is "Apply *colors* to --> <!-- non-kde apps" --> <qandaset> <qandaentry> <question> -<para ->My non-&kde; applications like &Emacs; and <application ->kterm</application -> are running amok with strange colours!</para> +<para>My non-&kde; applications like &Emacs; and <application>kterm</application> are running amok with strange colours!</para> </question> <answer> -<para ->Start the <application ->&kde; Control Centre</application -> and in <guimenu ->Appearance & Themes</guimenu -><guisubmenu ->Colours</guisubmenu -> uncheck the <guilabel ->Apply colours to non-TDE applications</guilabel -> checkbox and click <guibutton ->Apply</guibutton ->.</para> +<para>Start the <application>&kde; Control Centre</application> and in <guimenu>Appearance & Themes</guimenu><guisubmenu>Colours</guisubmenu> uncheck the <guilabel>Apply colours to non-TDE applications</guilabel> checkbox and click <guibutton>Apply</guibutton>.</para> </answer> </qandaentry> <qandaentry> -<question -><para ->How can I set my default web browser to be something other than &konqueror;?</para -></question> +<question><para>How can I set my default web browser to be something other than &konqueror;?</para></question> <answer> -<para ->If you are using &kde; 3.3 or later, open up the &kcontrolcenter; and navigate to the <menuchoice -><guimenu ->TDE Components</guimenu -><guimenuitem ->Component Chooser</guimenuitem -></menuchoice -> panel. Select <guilabel ->Web Browser</guilabel -> from the list on the left, then select <guilabel ->Open http and https URLs in the following browser:</guilabel -> and type in the name of the browser (⪚ <application ->mozilla</application ->, <application ->firefox</application ->, <application ->opera</application ->, &etc;) in the textbox.</para> +<para>If you are using &kde; 3.3 or later, open up the &kcontrolcenter; and navigate to the <menuchoice><guimenu>TDE Components</guimenu><guimenuitem>Component Chooser</guimenuitem></menuchoice> panel. Select <guilabel>Web Browser</guilabel> from the list on the left, then select <guilabel>Open http and https URLs in the following browser:</guilabel> and type in the name of the browser (⪚ <application>mozilla</application>, <application>firefox</application>, <application>opera</application>, &etc;) in the textbox.</para> </answer> </qandaentry> diff --git a/tde-i18n-en_GB/docs/tdebase/faq/notrelated.docbook b/tde-i18n-en_GB/docs/tdebase/faq/notrelated.docbook index b780a37ec31..c1b5011ed6c 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/notrelated.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/notrelated.docbook @@ -7,190 +7,84 @@ --> <chapter id="not-kde"> -<title ->Not really &kde;-related, but frequently asked nevertheless.</title> +<title>Not really &kde;-related, but frequently asked nevertheless.</title> <qandaset> <qandaentry> <question> -<para ->How do I change the screen resolution?</para> +<para>How do I change the screen resolution?</para> </question> <answer> -<para ->Use <keycombo action="simul" ->&Ctrl;&Alt;<keycap ->+</keycap -></keycombo -> and <keycombo action="simul" ->&Ctrl;&Alt;<keycap ->-</keycap -></keycombo -> to cycle through the resolutions you have defined in <filename ->XF86Config</filename -> (maybe under <filename class="directory" ->/etc/X11</filename ->; poke around first). If you prefer to get your hands dirty, you can always edit the file directly. By placing your favourite resolution at the beginning (or making it the only one listed), &X-Window; will always start up with that resolution. <caution -><para ->Always make a backup copy of your <filename ->XF86Config</filename -> file <emphasis ->before</emphasis -> you start editing it. Errors in this file can render &X-Window; unusable.</para -></caution> -<note -><para ->These instructions are only valid if you are running version 3.3.x of the XFree86 server. If you are running XFree86 4.x, you must consult with the <ulink url="http://xfree.org" ->XFree86(TM): Home Page</ulink ->.</para -></note -></para> +<para>Use <keycombo action="simul">&Ctrl;&Alt;<keycap>+</keycap></keycombo> and <keycombo action="simul">&Ctrl;&Alt;<keycap>-</keycap></keycombo> to cycle through the resolutions you have defined in <filename>XF86Config</filename> (maybe under <filename class="directory">/etc/X11</filename>; poke around first). If you prefer to get your hands dirty, you can always edit the file directly. By placing your favourite resolution at the beginning (or making it the only one listed), &X-Window; will always start up with that resolution. <caution><para>Always make a backup copy of your <filename>XF86Config</filename> file <emphasis>before</emphasis> you start editing it. Errors in this file can render &X-Window; unusable.</para></caution> +<note><para>These instructions are only valid if you are running version 3.3.x of the XFree86 server. If you are running XFree86 4.x, you must consult with the <ulink url="http://xfree.org">XFree86(TM): Home Page</ulink>.</para></note></para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I change the colour depth?</para> +<para>How do I change the colour depth?</para> </question> <answer> -<para ->There is no way you can do this on the fly. You can either start &X-Window; using <command ->startx <option -> -bpp <replaceable ->number</replaceable -></option -></command -> where <replaceable ->number</replaceable -> can be 8, 16, 24 or 32, depending on the depth you want. Alternatively, if you are using <application ->xdm</application ->/&tdm;, you need to edit <filename ->/etc/X11/xdm/Xservers</filename -> (may vary) and enter <userinput ->:0 local /usr/X11R6/bin/X -bpp 16</userinput -> for 16 bit colour depth.</para> -<para ->You can also edit the <filename ->XF86Config</filename -> file and add a line like <userinput ->DefaultColorDepth <replaceable ->number</replaceable -></userinput -> to Section "Screen". The next time you start X, it will run with the newly-configured colour depth.</para> +<para>There is no way you can do this on the fly. You can either start &X-Window; using <command>startx <option> -bpp <replaceable>number</replaceable></option></command> where <replaceable>number</replaceable> can be 8, 16, 24 or 32, depending on the depth you want. Alternatively, if you are using <application>xdm</application>/&tdm;, you need to edit <filename>/etc/X11/xdm/Xservers</filename> (may vary) and enter <userinput>:0 local /usr/X11R6/bin/X -bpp 16</userinput> for 16 bit colour depth.</para> +<para>You can also edit the <filename>XF86Config</filename> file and add a line like <userinput>DefaultColorDepth <replaceable>number</replaceable></userinput> to Section "Screen". The next time you start X, it will run with the newly-configured colour depth.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->What can I do if I am using a 2-button mouse?</para> +<para>What can I do if I am using a 2-button mouse?</para> </question> <answer> -<para ->Go buy a 3-button one, or use third button emulation. The third button is emulated by pressing both the &LMB; and the &RMB; together. You would need to enable <option ->Emulate3Buttons</option -> in your <filename ->XF86Config</filename -> file. </para> +<para>Go buy a 3-button one, or use third button emulation. The third button is emulated by pressing both the &LMB; and the &RMB; together. You would need to enable <option>Emulate3Buttons</option> in your <filename>XF86Config</filename> file. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->What is a "sticky" window?</para> +<para>What is a "sticky" window?</para> </question> <answer> -<para ->In a virtual desktop environment with multiple virtual desktops, a "sticky" window will stay put on the screen when you switch between desktops, as if sticking to the glass of the screen. <application ->Xclock</application -> is a typical candidate for sticking, as you need to run only one instance of it, and it always stays with you. </para> +<para>In a virtual desktop environment with multiple virtual desktops, a "sticky" window will stay put on the screen when you switch between desktops, as if sticking to the glass of the screen. <application>Xclock</application> is a typical candidate for sticking, as you need to run only one instance of it, and it always stays with you. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I replace the "X" mouse pointer with an arrow?</para> +<para>How do I replace the "X" mouse pointer with an arrow?</para> </question> <answer> -<para ->The various types of cursor available in X are defined in <filename class="headerfile" ->X11/cursorfont.h</filename ->. You can change it using <command ->xsetroot -cursor_name <replaceable ->name_of_cursor</replaceable -></command ->. For example, I have the following in my <filename ->.Xclients</filename ->:</para> -<screen ->xsetroot -cursor_name left_ptr +<para>The various types of cursor available in X are defined in <filename class="headerfile">X11/cursorfont.h</filename>. You can change it using <command>xsetroot -cursor_name <replaceable>name_of_cursor</replaceable></command>. For example, I have the following in my <filename>.Xclients</filename>:</para> +<screen>xsetroot -cursor_name left_ptr </screen> -<para ->This will create the common left-angled pointer. To see other alternatives, type <command ->xfd -fn cursor</command ->. And of course, do not forget that <command ->man xsetroot</command -> is your friend.</para> +<para>This will create the common left-angled pointer. To see other alternatives, type <command>xfd -fn cursor</command>. And of course, do not forget that <command>man xsetroot</command> is your friend.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I extract/install diff files?</para> +<para>How do I extract/install diff files?</para> </question> <answer> -<para ->To generate a context-diff suitable for patching, use <command ->diff -u <replaceable ->old-file new-file</replaceable -> > <replaceable ->patchfile</replaceable -></command ->. To apply the diff to a file (<abbrev ->i.e.</abbrev -> "patch the file"), execute <command ->patch < <replaceable ->patchfile</replaceable -></command ->.</para> +<para>To generate a context-diff suitable for patching, use <command>diff -u <replaceable>old-file new-file</replaceable> > <replaceable>patchfile</replaceable></command>. To apply the diff to a file (<abbrev>i.e.</abbrev> "patch the file"), execute <command>patch < <replaceable>patchfile</replaceable></command>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I get &Linux; to mount the floppy device for use with both DOS and ext2 formatted floppies?</para> +<para>How do I get &Linux; to mount the floppy device for use with both DOS and ext2 formatted floppies?</para> </question> <answer> -<para ->Just specify the filesystem type as auto in <filename ->/etc/fstab</filename ->. Auto detection works fine for DOS and ext2.</para> +<para>Just specify the filesystem type as auto in <filename>/etc/fstab</filename>. Auto detection works fine for DOS and ext2.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I start &kde; with the <keycap ->Num Lock</keycap -> on?</para> +<para>How do I start &kde; with the <keycap>Num Lock</keycap> on?</para> </question> <answer> -<para ->Have you tried <command ->man setleds</command ->? In addition, you might want to edit your <filename ->$<envar ->HOME</envar ->/.Xmodmap</filename -> and put the following lines in:</para> -<screen ->! redefines numeric keypad to be used without NumLock +<para>Have you tried <command>man setleds</command>? In addition, you might want to edit your <filename>$<envar>HOME</envar>/.Xmodmap</filename> and put the following lines in:</para> +<screen>! redefines numeric keypad to be used without NumLock keycode 79 = 7 keycode 80 = 8 keycode 81 = 9 @@ -210,76 +104,39 @@ keycode 86 = plus ! deactivates NumLock key keycode 77 = </screen> -<para ->Other possible alternatives:</para> +<para>Other possible alternatives:</para> <itemizedlist> -<listitem -><para -><application ->xkeycaps</application ->: <mousebutton ->right</mousebutton -> clicking should allow edits. You may have to do this as root.</para -></listitem> -<listitem -><para -><command ->man XF86Config</command -> and look under section Keyboard.</para -></listitem> -<listitem -><para ->Install <application ->NumLockX</application ->, which is available from <ulink url="http://dforce.sh.cvut.cz/~seli/en/numlockx" ->http://dforce.sh.cvut.cz/~seli/en/numlockx</ulink ->.</para -></listitem> +<listitem><para><application>xkeycaps</application>: <mousebutton>right</mousebutton> clicking should allow edits. You may have to do this as root.</para></listitem> +<listitem><para><command>man XF86Config</command> and look under section Keyboard.</para></listitem> +<listitem><para>Install <application>NumLockX</application>, which is available from <ulink url="http://dforce.sh.cvut.cz/~seli/en/numlockx">http://dforce.sh.cvut.cz/~seli/en/numlockx</ulink>.</para></listitem> </itemizedlist> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I take window or desktop screenshots?</para> +<para>How do I take window or desktop screenshots?</para> </question> <answer> -<para ->Use &ksnapshot;.</para> +<para>Use &ksnapshot;.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Is there a tool to make webpages?</para> +<para>Is there a tool to make webpages?</para> </question> <answer> -<para ->Yes, and there are a lot of them out there, including <application ->StarOffice</application ->, <application ->&Netscape; Composer</application ->, and <application ->XEmacs</application ->. There are also many &kde; applications. To find the most current list, go to <ulink url="http://kde-apps.org" ->kde-apps.org: The Latest in &kde; Applications</ulink -> and search for <emphasis ->web development</emphasis ->. Try as many as possible and choose the one most suitable to your needs.</para> +<para>Yes, and there are a lot of them out there, including <application>StarOffice</application>, <application>&Netscape; Composer</application>, and <application>XEmacs</application>. There are also many &kde; applications. To find the most current list, go to <ulink url="http://kde-apps.org">kde-apps.org: The Latest in &kde; Applications</ulink> and search for <emphasis>web development</emphasis>. Try as many as possible and choose the one most suitable to your needs.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->What do all those acronyms like AFAIK mean?</para> +<para>What do all those acronyms like AFAIK mean?</para> </question> <answer> -<para -><screen ->AAMOF: as a matter of fact +<para><screen>AAMOF: as a matter of fact AFAIK: as far as I know AISE: as I see it BFN: bye for now @@ -301,8 +158,7 @@ RTFM: read the fine manual SOP: standard operating procedure TIA: thanks in advance YMMV: your mileage may vary -</screen -></para> +</screen></para> </answer> </qandaentry> </qandaset> diff --git a/tde-i18n-en_GB/docs/tdebase/faq/panel.docbook b/tde-i18n-en_GB/docs/tdebase/faq/panel.docbook index e49ccb7189f..60718985eb0 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/panel.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/panel.docbook @@ -5,28 +5,16 @@ --> <chapter id="panel"> -<title ->The panel</title> +<title>The panel</title> <qandaset> <qandaentry> <question> -<para ->How do I add applications to the &kde; panel (&kicker;)?</para> +<para>How do I add applications to the &kde; panel (&kicker;)?</para> </question> <answer> -<para ->There are several ways to add an application to the panel, of which the easiest is to right-click on the panel, and from the context menu which appears, select <menuchoice -><guimenu ->Panel Menu</guimenu -><guisubmenu ->Add</guisubmenu -><guisubmenu ->Application Button</guisubmenu -></menuchoice -> and then the application for which you want to add a link.</para> -<para ->For more ways of adding buttons to the panel, refer to the &kicker; Handbook.</para> +<para>There are several ways to add an application to the panel, of which the easiest is to right-click on the panel, and from the context menu which appears, select <menuchoice><guimenu>Panel Menu</guimenu><guisubmenu>Add</guisubmenu><guisubmenu>Application Button</guisubmenu></menuchoice> and then the application for which you want to add a link.</para> +<para>For more ways of adding buttons to the panel, refer to the &kicker; Handbook.</para> </answer> </qandaentry> @@ -35,25 +23,13 @@ <!-- <qandaentry> <question> -<para ->Is it possible to change the <guibutton ->K</guibutton -> button of +<para>Is it possible to change the <guibutton>K</guibutton> button of the panel to another picture?</para> -</question ->/ +</question>/ <answer> -<para ->Look for -<filename ->$<envar ->HOME</envar ->/.trinity/share/apps/kicker/pics/go.png</filename -> and -<filename ->$<envar ->HOME</envar ->/.trinity/share/apps/kicker/pics/mini/go.png</filename> +<para>Look for +<filename>$<envar>HOME</envar>/.trinity/share/apps/kicker/pics/go.png</filename> and +<filename>$<envar>HOME</envar>/.trinity/share/apps/kicker/pics/mini/go.png</filename> and replace them. Do not forget to flatten the replacements to one layer, or else you will not see anything. Create the folders if they do not already exist. Then restart &kicker;.</para> @@ -62,43 +38,16 @@ they do not already exist. Then restart &kicker;.</para> --> <qandaentry> -<question -><para ->My desktop panel has disappeared. How can I get it back?</para> +<question><para>My desktop panel has disappeared. How can I get it back?</para> </question> <answer> -<para ->The panel disappearing is usually due to it crashing. This is most often caused by loading an applet that has a fatal bug or due to a bad installation of &kde; and/or the panel.</para> +<para>The panel disappearing is usually due to it crashing. This is most often caused by loading an applet that has a fatal bug or due to a bad installation of &kde; and/or the panel.</para> -<para ->The easiest way to get the panel back is to launch the <guilabel ->Run Command</guilabel -> window by pressing <keycombo action="simul" ->&Alt;<keycap ->F2</keycap -> </keycombo -> and entering <userinput -><command ->kicker</command -></userinput -> and then pressing the <guibutton ->OK</guibutton -> button.</para> +<para>The easiest way to get the panel back is to launch the <guilabel>Run Command</guilabel> window by pressing <keycombo action="simul">&Alt;<keycap>F2</keycap> </keycombo> and entering <userinput><command>kicker</command></userinput> and then pressing the <guibutton>OK</guibutton> button.</para> -<para ->If the panel continues to disappear, you may wish to either remove or edit by hand your <filename ->$<envar ->TDEHOME</envar ->/share/config/kickerrc</filename -> file, where <filename class="directory" ->$<envar ->TDEHOME</envar -></filename -> is usually <filename class="directory" ->~/.trinity</filename ->. If you choose to edit it by hand, start by removing the applet entry groups.</para> +<para>If the panel continues to disappear, you may wish to either remove or edit by hand your <filename>$<envar>TDEHOME</envar>/share/config/kickerrc</filename> file, where <filename class="directory">$<envar>TDEHOME</envar></filename> is usually <filename class="directory">~/.trinity</filename>. If you choose to edit it by hand, start by removing the applet entry groups.</para> </answer> </qandaentry> diff --git a/tde-i18n-en_GB/docs/tdebase/faq/tdeapps.docbook b/tde-i18n-en_GB/docs/tdebase/faq/tdeapps.docbook index 5b22a3f79d8..d894f7d4c6f 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/tdeapps.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/tdeapps.docbook @@ -5,128 +5,43 @@ --> <chapter id="applications"> -<title ->&kde; applications</title> +<title>&kde; applications</title> <qandaset> <qandaentry> <question> -<para ->&kppp;</para> +<para>&kppp;</para> </question> <answer> -<para ->Many &kde; users report problems using &kppp;. But before you complain about &kppp;, make sure you have already checked the following:</para> +<para>Many &kde; users report problems using &kppp;. But before you complain about &kppp;, make sure you have already checked the following:</para> <itemizedlist> -<listitem -><para ->Can you dialup to your <acronym ->ISP</acronym -> without using &kppp;? If you cannot, then perhaps &kppp; is not the culprit after all.</para -></listitem> -<listitem -><para ->Have you gone through the &kppp; documentation at least three times and followed its instructions and trouble-shooting suggestions?</para -></listitem> +<listitem><para>Can you dialup to your <acronym>ISP</acronym> without using &kppp;? If you cannot, then perhaps &kppp; is not the culprit after all.</para></listitem> +<listitem><para>Have you gone through the &kppp; documentation at least three times and followed its instructions and trouble-shooting suggestions?</para></listitem> </itemizedlist> -<para ->The &kppp; documentation can be accessed through the <application ->&kde; Help Centre</application ->. Last, but not least, the &kppp; homepage is at <ulink url="http://ktown.kde.org/~kppp/" ->http://ktown.kde.org/~kppp/</ulink ->.</para> -<para ->Now, if you still encounter problems, here's what might help you solve them:</para> +<para>The &kppp; documentation can be accessed through the <application>&kde; Help Centre</application>. Last, but not least, the &kppp; homepage is at <ulink url="http://ktown.kde.org/~kppp/">http://ktown.kde.org/~kppp/</ulink>.</para> +<para>Now, if you still encounter problems, here's what might help you solve them:</para> <variablelist> -<varlistentry -><term ->How do I change the &MTU; setting in &kppp;?</term> -<listitem -><para ->Open up the &kppp; dialogue box and select <guibutton ->Setup</guibutton ->. Choose an existing account and click <guibutton ->Edit</guibutton ->, or <guibutton ->New</guibutton -> to create a new dialup account. Select the <guilabel ->Dial</guilabel -> tab and click <guibutton ->Arguments</guibutton ->. Type what you want to change in the Argument textbox (⪚ <userinput ->mtu 296</userinput ->) and click <guibutton ->Add</guibutton ->. When you are satisfied, click <guibutton ->Close</guibutton ->.</para> -<para ->To check whether the options <quote ->took</quote ->, do one of the following:</para> +<varlistentry><term>How do I change the &MTU; setting in &kppp;?</term> +<listitem><para>Open up the &kppp; dialogue box and select <guibutton>Setup</guibutton>. Choose an existing account and click <guibutton>Edit</guibutton>, or <guibutton>New</guibutton> to create a new dialup account. Select the <guilabel>Dial</guilabel> tab and click <guibutton>Arguments</guibutton>. Type what you want to change in the Argument textbox (⪚ <userinput>mtu 296</userinput>) and click <guibutton>Add</guibutton>. When you are satisfied, click <guibutton>Close</guibutton>.</para> +<para>To check whether the options <quote>took</quote>, do one of the following:</para> <itemizedlist> <listitem> -<para ->In a terminal window, run <userinput -><command ->/sbin/ifconfig</command -> ppp0</userinput -> and look at the reported &MTU; in the output. It should match your request.</para> +<para>In a terminal window, run <userinput><command>/sbin/ifconfig</command> ppp0</userinput> and look at the reported &MTU; in the output. It should match your request.</para> </listitem> -<listitem -><para ->Add <option ->debug</option -> and <option ->kdebug</option -> (each on a separate line) to your <filename ->/etc/ppp/options</filename -> file and restart your &PPP; session. You will find debugging messages in <filename ->/var/log/messages</filename ->, including &MRU; and &MTU; settings.</para -></listitem> +<listitem><para>Add <option>debug</option> and <option>kdebug</option> (each on a separate line) to your <filename>/etc/ppp/options</filename> file and restart your &PPP; session. You will find debugging messages in <filename>/var/log/messages</filename>, including &MRU; and &MTU; settings.</para></listitem> </itemizedlist> -<para ->If you want, the &MRU; and &MTU; settings can be added to the <filename ->options</filename -> file, one complete setting per line, no quotes or dashes.</para -></listitem> +<para>If you want, the &MRU; and &MTU; settings can be added to the <filename>options</filename> file, one complete setting per line, no quotes or dashes.</para></listitem> </varlistentry> <varlistentry> -<term ->&kppp; connects at a slower speed than normal.</term> -<listitem -><para ->The following might do the trick:</para> +<term>&kppp; connects at a slower speed than normal.</term> +<listitem><para>The following might do the trick:</para> <itemizedlist> -<listitem -><para ->Try executing <command ->setserial spd_hi</command ->.</para -></listitem> -<listitem -><para ->The default &MTU; value is 1500, which maybe too large for a dialup connection. Try changing it to a smaller value like <userinput ->296</userinput -> or <userinput ->576</userinput ->.</para -></listitem> -<listitem -><para ->Check in your <filename class="directory" ->$<envar ->HOME</envar ->/.trinity/share/config</filename -> for the <filename ->kppprc</filename ->. Ensure the correct modem speed is actually defined there.</para -></listitem> -</itemizedlist -></listitem> +<listitem><para>Try executing <command>setserial spd_hi</command>.</para></listitem> +<listitem><para>The default &MTU; value is 1500, which maybe too large for a dialup connection. Try changing it to a smaller value like <userinput>296</userinput> or <userinput>576</userinput>.</para></listitem> +<listitem><para>Check in your <filename class="directory">$<envar>HOME</envar>/.trinity/share/config</filename> for the <filename>kppprc</filename>. Ensure the correct modem speed is actually defined there.</para></listitem> +</itemizedlist></listitem> </varlistentry> </variablelist> </answer> @@ -134,86 +49,30 @@ <qandaentry> <question> -<para ->&konsole;</para> +<para>&konsole;</para> </question> <answer> <variablelist> <varlistentry> -<term ->How do I page-up or page-down?</term> -<listitem -><para ->Use <keycombo action="simul" -> <keycap ->Shift</keycap -><keycap ->Page Up</keycap -></keycombo -> and <keycombo action="simul" -><keycap ->Shift</keycap -><keycap ->Pg Dn</keycap -></keycombo ->. </para -></listitem> +<term>How do I page-up or page-down?</term> +<listitem><para>Use <keycombo action="simul"> <keycap>Shift</keycap><keycap>Page Up</keycap></keycombo> and <keycombo action="simul"><keycap>Shift</keycap><keycap>Pg Dn</keycap></keycombo>. </para></listitem> </varlistentry> <varlistentry> -<term ->How do I perform a simple <quote ->copy</quote -> from &konsole; to anything else?</term> -<listitem -><para ->When I do a <command ->ls</command ->, first I select with the mouse the desired text, press <keycombo action="simul" ->&Ctrl;<keycap ->C</keycap -></keycombo ->, then I make the target application active, point the mouse to the relevant part and press <keycombo action="simul" ->&Ctrl;<keycap ->V</keycap -></keycombo ->. Alternatively, highlight the text by dragging with the &LMB; down and paste by clicking with the &MMB; (or both buttons if you are using a 2 button mouse with 3 button emulation). </para -></listitem> +<term>How do I perform a simple <quote>copy</quote> from &konsole; to anything else?</term> +<listitem><para>When I do a <command>ls</command>, first I select with the mouse the desired text, press <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>, then I make the target application active, point the mouse to the relevant part and press <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>. Alternatively, highlight the text by dragging with the &LMB; down and paste by clicking with the &MMB; (or both buttons if you are using a 2 button mouse with 3 button emulation). </para></listitem> </varlistentry> <varlistentry> -<term ->Why can't &konsole; find the <quote ->9x15</quote -> and the 2 <quote ->console</quote -> bitmap fonts installed with &kde;?</term> +<term>Why can't &konsole; find the <quote>9x15</quote> and the 2 <quote>console</quote> bitmap fonts installed with &kde;?</term> <listitem> -<para -><application ->FontConfig</application -> must find the three fonts installed in: <filename class="directory" ->$<envar ->TDEDIR</envar ->/share/fonts</filename ->. If the &kde; install does not install these fonts in a directory that already exists (⪚ <filename class="directory" ->/usr/share/fonts</filename ->) then you must add this directory to the configuration file <filename class="directory" ->/etc/fonts/local.conf</filename ->. This should be the first line after <quote -><fontconfig></quote ->. For example: <programlisting> +<para><application>FontConfig</application> must find the three fonts installed in: <filename class="directory">$<envar>TDEDIR</envar>/share/fonts</filename>. If the &kde; install does not install these fonts in a directory that already exists (⪚ <filename class="directory">/usr/share/fonts</filename>) then you must add this directory to the configuration file <filename class="directory">/etc/fonts/local.conf</filename>. This should be the first line after <quote><fontconfig></quote>. For example: <programlisting> <fontconfig> <dir>/usr/kde3/share/fonts</dir> </fontconfig> -</programlisting -> After adding the directory, run (as root): <userinput -><command ->fc-cache</command -> -v</userinput -> and check that it found the directory.</para> +</programlisting> After adding the directory, run (as root): <userinput><command>fc-cache</command> -v</userinput> and check that it found the directory.</para> </listitem> </varlistentry> @@ -223,16 +82,10 @@ <qandaentry> <question> -<para ->&kmail;</para> +<para>&kmail;</para> </question> <answer> -<para ->&kmail; has its own home page at <ulink url="http://kmail.kde.org" ->http://kmail.kde.org</ulink -> where an <acronym ->FAQ</acronym -> is available.</para> +<para>&kmail; has its own home page at <ulink url="http://kmail.kde.org">http://kmail.kde.org</ulink> where an <acronym>FAQ</acronym> is available.</para> </answer> </qandaentry> diff --git a/tde-i18n-en_GB/docs/tdebase/faq/tips.docbook b/tde-i18n-en_GB/docs/tdebase/faq/tips.docbook index 9f7b4e80e26..af3d0ad2b57 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/tips.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/tips.docbook @@ -5,199 +5,84 @@ --> <chapter id="tips"> -<title ->Useful tips</title> +<title>Useful tips</title> <qandaset> <qandaentry> <question> -<para ->Reading documentation in &kde;</para> +<para>Reading documentation in &kde;</para> </question> <answer> -<para ->Pop up the <guilabel ->Run Command</guilabel -> window (<keycombo action="simul" ->&Alt;<keycap ->F2</keycap -></keycombo -> by default) and type: <itemizedlist> +<para>Pop up the <guilabel>Run Command</guilabel> window (<keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> by default) and type: <itemizedlist> <listitem> -<para -><command ->man:<replaceable ->command</replaceable -></command -> for man pages. It even unpacks on the fly if the man pages are gzipped.</para> +<para><command>man:<replaceable>command</replaceable></command> for man pages. It even unpacks on the fly if the man pages are gzipped.</para> </listitem> <listitem> -<para -><command ->info:<replaceable ->command</replaceable -></command -> for info pages.</para> +<para><command>info:<replaceable>command</replaceable></command> for info pages.</para> </listitem> <listitem> -<para -><command ->help:<replaceable ->kdeappname</replaceable -></command -> for &kde; application help pages.</para> +<para><command>help:<replaceable>kdeappname</replaceable></command> for &kde; application help pages.</para> </listitem> </itemizedlist> </para> -<para ->You can also enter any of these in the <guilabel ->Location</guilabel -> text box in &konqueror;.</para> -<para ->Or you can use the <application ->&kde; Help Centre</application -> if you are using &kde; 2. Simply start the <application ->&kde; Help Centre</application -> by clicking on the icon (the blue book with the yellow key) on the toolbar. Once the <application ->&kde; Help Centre</application -> has loaded, the window on the left will contain an entry called <guilabel ->Unix manual pages</guilabel ->. Click once on this entry, and you can browse through all the installed manual pages on your system.</para> +<para>You can also enter any of these in the <guilabel>Location</guilabel> text box in &konqueror;.</para> +<para>Or you can use the <application>&kde; Help Centre</application> if you are using &kde; 2. Simply start the <application>&kde; Help Centre</application> by clicking on the icon (the blue book with the yellow key) on the toolbar. Once the <application>&kde; Help Centre</application> has loaded, the window on the left will contain an entry called <guilabel>Unix manual pages</guilabel>. Click once on this entry, and you can browse through all the installed manual pages on your system.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Move or resize windows quickly</para> +<para>Move or resize windows quickly</para> </question> <answer> -<para ->To move a window, use <keycombo action="simul" ->&Alt;<mousebutton ->left</mousebutton -></keycombo -> mouse button. <keycombo action="simul" ->&Alt;<mousebutton ->right</mousebutton -></keycombo -> mouse button will resize the window. Last but not least, <keycombo action="simul" ->&Alt;<mousebutton ->middle</mousebutton -></keycombo -> mouse button raises/lowers the window. The <application ->&kde; Control Centre</application -> allows you to change these mouse bindings.</para> +<para>To move a window, use <keycombo action="simul">&Alt;<mousebutton>left</mousebutton></keycombo> mouse button. <keycombo action="simul">&Alt;<mousebutton>right</mousebutton></keycombo> mouse button will resize the window. Last but not least, <keycombo action="simul">&Alt;<mousebutton>middle</mousebutton></keycombo> mouse button raises/lowers the window. The <application>&kde; Control Centre</application> allows you to change these mouse bindings.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Killing windows in &kde;</para> +<para>Killing windows in &kde;</para> </question> <answer> -<para ->There is a standard keybinding (<keycombo action="simul" ->&Ctrl;&Alt;&Esc;</keycombo ->) that gives you a skull & crossbones cursor. Click that cursor on a window to kill it. The keybindings are viewable/changeable from the <application ->&kde; Control Centre</application ->. <caution -><para ->Using this option kills the program forcibly. Data may be lost, and some processes related to the program may remain active. Use only as a last resort.</para -></caution> +<para>There is a standard keybinding (<keycombo action="simul">&Ctrl;&Alt;&Esc;</keycombo>) that gives you a skull & crossbones cursor. Click that cursor on a window to kill it. The keybindings are viewable/changeable from the <application>&kde; Control Centre</application>. <caution><para>Using this option kills the program forcibly. Data may be lost, and some processes related to the program may remain active. Use only as a last resort.</para></caution> <!-- fixme: use only if necessary; processes might remain --></para> </answer> </qandaentry> <qandaentry> <question> -<para ->What if something is so wrong that I ca not even get the skull & crossbones cursor? How do I get out of a total lockup?</para> +<para>What if something is so wrong that I ca not even get the skull & crossbones cursor? How do I get out of a total lockup?</para> </question> <answer> -<para ->These kind of locks tend to occur when an application locks up while it has a so called <quote ->mouse/keyboard grab</quote ->. When that happens you can try to select a virtual text console with <keycombo action="simul" ->&Ctrl;&Alt;<keycap ->F1</keycap -></keycombo -> and login. With the following command you will get a list of all running processes:</para> - -<screen -><userinput -> <command ->ps</command -> <option ->-aux</option -> | <command ->more</command -></userinput -></screen> - -<para ->By killing the process that has the mousegrab, your desktop will come to life again. Unfortunately you ca not see which process that is, so you will have to find out through trial and error. To kill a process use:</para> - -<screen -><userinput -> <command ->kill</command -> <option ->-9</option -> <replaceable ->pid</replaceable -></userinput -></screen> - -<para ->Here <replaceable ->pid</replaceable -> is the process id of the process, which is the first number on each line reported by <command ->ps</command -> <option ->-aux</option ->.</para> - -<para ->You can switch back to the desktop with <keycombo action="simul" ->&Ctrl;&Alt;<keycap ->F7</keycap -></keycombo -> (or <keycap ->F8</keycap -> through <keycap ->F9</keycap -> depending on your operating system) to see if things work again. When you press <keycombo action="simul" ->&Alt;<keycap ->Tab</keycap -></keycombo -> you should get a response from the window manager. If not, you need to get back to the text console and try to kill another process.</para> - -<para ->Good candidates to kill are: the application you were working with, &kicker;, &klipper; and &kdesktop;.</para> +<para>These kind of locks tend to occur when an application locks up while it has a so called <quote>mouse/keyboard grab</quote>. When that happens you can try to select a virtual text console with <keycombo action="simul">&Ctrl;&Alt;<keycap>F1</keycap></keycombo> and login. With the following command you will get a list of all running processes:</para> + +<screen><userinput> <command>ps</command> <option>-aux</option> | <command>more</command></userinput></screen> + +<para>By killing the process that has the mousegrab, your desktop will come to life again. Unfortunately you ca not see which process that is, so you will have to find out through trial and error. To kill a process use:</para> + +<screen><userinput> <command>kill</command> <option>-9</option> <replaceable>pid</replaceable></userinput></screen> + +<para>Here <replaceable>pid</replaceable> is the process id of the process, which is the first number on each line reported by <command>ps</command> <option>-aux</option>.</para> + +<para>You can switch back to the desktop with <keycombo action="simul">&Ctrl;&Alt;<keycap>F7</keycap></keycombo> (or <keycap>F8</keycap> through <keycap>F9</keycap> depending on your operating system) to see if things work again. When you press <keycombo action="simul">&Alt;<keycap>Tab</keycap></keycombo> you should get a response from the window manager. If not, you need to get back to the text console and try to kill another process.</para> + +<para>Good candidates to kill are: the application you were working with, &kicker;, &klipper; and &kdesktop;.</para> </answer> </qandaentry> <!-- fixme: how to do in KDE2.x <qandaentry> <question> -<para ->Switching window managers on the fly in &kde; 1.x</para> +<para>Switching window managers on the fly in &kde; 1.x</para> </question> <answer> -<para ->If you want to switch your window manager on the fly, type the -following into a terminal window: <command ->kwmcom -go:<replaceable ->blackbox</replaceable -></command ->. This switches to +<para>If you want to switch your window manager on the fly, type the +following into a terminal window: <command>kwmcom +go:<replaceable>blackbox</replaceable></command>. This switches to Blackbox, but you can substitute any window manager you like.</para> </answer> </qandaentry> diff --git a/tde-i18n-en_GB/docs/tdebase/faq/winmng.docbook b/tde-i18n-en_GB/docs/tdebase/faq/winmng.docbook index 4c1fd830618..f548851aaa1 100644 --- a/tde-i18n-en_GB/docs/tdebase/faq/winmng.docbook +++ b/tde-i18n-en_GB/docs/tdebase/faq/winmng.docbook @@ -7,67 +7,42 @@ <chapter id="windowmanager"> -<title ->The window manager</title> +<title>The window manager</title> -<para ->The default window manager provided by &kde; is the K Window Manager (&twin;). Please read <quote ->The K Window Manager Handbook</quote -> (which should be accessible from the <application ->&kde; Help Centre</application ->) for usage information.</para> +<para>The default window manager provided by &kde; is the K Window Manager (&twin;). Please read <quote>The K Window Manager Handbook</quote> (which should be accessible from the <application>&kde; Help Centre</application>) for usage information.</para> <qandaset> <qandaentry> <question> -<para ->Are there keyboard shortcuts for &twin; operations?</para> +<para>Are there keyboard shortcuts for &twin; operations?</para> </question> <answer> -<para ->Yes. Please refer to "The K Window Manager Handbook" for the list of shortcuts available.</para> +<para>Yes. Please refer to "The K Window Manager Handbook" for the list of shortcuts available.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Can I define my own set of keyboard shortcuts?</para> +<para>Can I define my own set of keyboard shortcuts?</para> </question> <answer> -<para ->Yes. Launch the <application ->&kde; Control Centre</application -> and select <menuchoice -><guimenu ->Regional & Accessibility</guimenu -><guimenuitem ->Keyboard Shortcuts</guimenuitem -></menuchoice -> to configure window manager bindings like maximising windows, &etc;. </para> +<para>Yes. Launch the <application>&kde; Control Centre</application> and select <menuchoice><guimenu>Regional & Accessibility</guimenu><guimenuitem>Keyboard Shortcuts</guimenuitem></menuchoice> to configure window manager bindings like maximising windows, &etc;. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->When I "iconify" a window, it disappears. Where does it go?</para> +<para>When I "iconify" a window, it disappears. Where does it go?</para> </question> <answer> -<para ->With many &X-Window; &GUI;s, the minimise button (a little dot) will erase the window that the program is running in and create, instead, an icon on the desktop. &kde; does not do this. Instead, when a window is iconified it is simply hidden (but the program is still running).</para> -<para ->There are a few ways to access <quote ->disappeared</quote -> windows:</para> +<para>With many &X-Window; &GUI;s, the minimise button (a little dot) will erase the window that the program is running in and create, instead, an icon on the desktop. &kde; does not do this. Instead, when a window is iconified it is simply hidden (but the program is still running).</para> +<para>There are a few ways to access <quote>disappeared</quote> windows:</para> <itemizedlist> <listitem> -<para ->If you are running the taskbar part of &kicker;, you can choose to have a list of tasks displayed on your desktop. Iconified tasks will have their names displayed in grey.</para> +<para>If you are running the taskbar part of &kicker;, you can choose to have a list of tasks displayed on your desktop. Iconified tasks will have their names displayed in grey.</para> </listitem> <listitem> -<para ->If you click the &MMB; on the root window (&ie;, the background of the desktop), &twin; will give you a list of all available tasks.</para> +<para>If you click the &MMB; on the root window (&ie;, the background of the desktop), &twin; will give you a list of all available tasks.</para> </listitem> </itemizedlist> </answer> @@ -75,51 +50,32 @@ <qandaentry> <question> -<para ->How do I maximise windows only vertically or horizontally?</para> +<para>How do I maximise windows only vertically or horizontally?</para> </question> <answer> -<para ->Provided your window is not already maximised, clicking on the maximise button with the &LMB;/&MMB;/&RMB; will maximise fully/vertically/horizontally respectively.</para> +<para>Provided your window is not already maximised, clicking on the maximise button with the &LMB;/&MMB;/&RMB; will maximise fully/vertically/horizontally respectively.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->What is <quote ->shading</quote -> a window?</para> +<para>What is <quote>shading</quote> a window?</para> </question> <answer> -<para ->By <quote ->shading</quote -> a window we mean <quote ->rolling up</quote -> the window leaving just the title bar visible. You can do this by double clicking on the window title bar.</para> +<para>By <quote>shading</quote> a window we mean <quote>rolling up</quote> the window leaving just the title bar visible. You can do this by double clicking on the window title bar.</para> </answer> </qandaentry> <!-- Not sure this is still applicable <qandaentry> <question> -<para ->Is it possible to have FVWM2-like shadow frameworks for the +<para>Is it possible to have FVWM2-like shadow frameworks for the placement of windows?</para> </question> <answer> -<para ->Yes. Run <application ->&kde; Control Center</application -> and select <guimenu ->Look and Feel</guimenu> -followed by <guisubmenu ->Window Behavior</guisubmenu -> and finally -<guimenuitem ->Advanced</guimenuitem ->. There is a dialog option that +<para>Yes. Run <application>&kde; Control Center</application> and select <guimenu>Look and Feel</guimenu> +followed by <guisubmenu>Window Behavior</guisubmenu> and finally +<guimenuitem>Advanced</guimenuitem>. There is a dialog option that allows you to set the placement policy you want.</para> </answer> </qandaentry> diff --git a/tde-i18n-en_GB/docs/tdebase/glossary/index.docbook b/tde-i18n-en_GB/docs/tdebase/glossary/index.docbook index 2d690b502df..9b7db6216bd 100644 --- a/tde-i18n-en_GB/docs/tdebase/glossary/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/glossary/index.docbook @@ -8,459 +8,175 @@ ]> -<glossary id="glossary" ->&glossary-tdeprinting; <glossdiv id="glossdiv-technologies"> - <title ->Technologies</title> +<glossary id="glossary">&glossary-tdeprinting; <glossdiv id="glossdiv-technologies"> + <title>Technologies</title> <glossentry id="gloss-ioslave"> - <glossterm -><acronym ->IO</acronym -> Slave</glossterm> - <glossdef -><para -><acronym ->IO</acronym -> Slaves enable &kde; applications to access remote resources as easily as local resources (making them <quote ->network transparent</quote ->). Remote resources (⪚ files) might be stored on <acronym ->SMB</acronym -> shares or similar.</para> -<glossseealso otherterm="gloss-smb" -><acronym ->SMB</acronym -></glossseealso -> <glossseealso otherterm="gloss-kde" ->&kde;</glossseealso -> </glossdef> + <glossterm><acronym>IO</acronym> Slave</glossterm> + <glossdef><para><acronym>IO</acronym> Slaves enable &kde; applications to access remote resources as easily as local resources (making them <quote>network transparent</quote>). Remote resources (⪚ files) might be stored on <acronym>SMB</acronym> shares or similar.</para> +<glossseealso otherterm="gloss-smb"><acronym>SMB</acronym></glossseealso> <glossseealso otherterm="gloss-kde">&kde;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-tdeio"> - <glossterm -><acronym ->TDEIO</acronym -></glossterm> - <glossdef -><para ->The &kde; Input/Output system which makes use of so-called <quote -><acronym ->IO</acronym -> Slaves</quote ->.</para> -<glossseealso otherterm="gloss-ioslave" -><acronym ->IO</acronym -> Slave</glossseealso -> <glossseealso otherterm="gloss-kde" ->&kde;</glossseealso -> </glossdef> + <glossterm><acronym>TDEIO</acronym></glossterm> + <glossdef><para>The &kde; Input/Output system which makes use of so-called <quote><acronym>IO</acronym> Slaves</quote>.</para> +<glossseealso otherterm="gloss-ioslave"><acronym>IO</acronym> Slave</glossseealso> <glossseealso otherterm="gloss-kde">&kde;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-tdeparts"> - <glossterm ->KParts</glossterm> - <glossdef -><para ->KParts is an embedding technology which allows &kde; applications to embed other &kde; applications. For example, the text view used by &konqueror; is a KPart.</para> - <glossseealso otherterm="gloss-konqueror" ->&konqueror;</glossseealso> + <glossterm>KParts</glossterm> + <glossdef><para>KParts is an embedding technology which allows &kde; applications to embed other &kde; applications. For example, the text view used by &konqueror; is a KPart.</para> + <glossseealso otherterm="gloss-konqueror">&konqueror;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-tdesycoca"> - <glossterm -><acronym ->KSycoca</acronym -></glossterm> - <glossdef -><para -><acronym ->KSycoca</acronym -> (&kde; <emphasis ->Sy</emphasis ->stem <emphasis ->Co</emphasis ->nfiguration <emphasis ->Ca</emphasis ->che) is a configuration cache which, for example, guarantees fast access to the menu entries.</para> + <glossterm><acronym>KSycoca</acronym></glossterm> + <glossdef><para><acronym>KSycoca</acronym> (&kde; <emphasis>Sy</emphasis>stem <emphasis>Co</emphasis>nfiguration <emphasis>Ca</emphasis>che) is a configuration cache which, for example, guarantees fast access to the menu entries.</para> <glossseealso -otherterm="gloss-tdebuildsycoca" -><application ->KBuildSycoca</application -></glossseealso> +otherterm="gloss-tdebuildsycoca"><application>KBuildSycoca</application></glossseealso> </glossdef> </glossentry> </glossdiv> <glossdiv id="glossdiv-xfree86"> - <title ->XFree86</title> + <title>XFree86</title> <glossentry id="gloss-antialiasing"> - <glossterm ->Antialiasing</glossterm> - <glossdef -><para ->If mentioned in context with &kde;, antialiasing often means the smoothing of the fonts visible on the screen. &Qt; version 2.3.0 or higher used together with XFree86 4.x makes this possible under &kde; as well.</para> -<glossseealso otherterm="gloss-kde" ->&kde;</glossseealso -> <glossseealso otherterm="gloss-qt" ->&Qt;</glossseealso -> </glossdef> + <glossterm>Antialiasing</glossterm> + <glossdef><para>If mentioned in context with &kde;, antialiasing often means the smoothing of the fonts visible on the screen. &Qt; version 2.3.0 or higher used together with XFree86 4.x makes this possible under &kde; as well.</para> +<glossseealso otherterm="gloss-kde">&kde;</glossseealso> <glossseealso otherterm="gloss-qt">&Qt;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-xserver"> - <glossterm ->&X-Server;</glossterm> - <glossdef -><para ->The &X-Server; represents a basic layer upon which the various &GUI;s like &kde; are built. It manages the basic mouse and keyboard input (from the local host as well as from remote hosts) and provides elementary graphic routines to draw rectangles and other primitives.</para> -<glossseealso otherterm="gloss-kde" ->&kde;</glossseealso -> <glossseealso otherterm="gloss-gui" ->&GUI;</glossseealso -> </glossdef> + <glossterm>&X-Server;</glossterm> + <glossdef><para>The &X-Server; represents a basic layer upon which the various &GUI;s like &kde; are built. It manages the basic mouse and keyboard input (from the local host as well as from remote hosts) and provides elementary graphic routines to draw rectangles and other primitives.</para> +<glossseealso otherterm="gloss-kde">&kde;</glossseealso> <glossseealso otherterm="gloss-gui">&GUI;</glossseealso> </glossdef> </glossentry> </glossdiv> <glossdiv id="glossdiv-applications"> - <title ->Applications</title> + <title>Applications</title> <glossentry id="gloss-tdebuildsycoca"> - <glossterm -><application ->KBuildSycoca</application -></glossterm> - <glossdef -><para -><application ->KBuildSycoca</application -> is a command line program and regenerates the so-called <acronym ->KSycoca</acronym ->. This is useful, for example, if some or all modules in &kcontrol; are missing.</para> -<glossseealso otherterm="gloss-tdesycoca" -><acronym ->KSycoca</acronym -></glossseealso -> <glossseealso otherterm="gloss-kcontrol" ->&kcontrol;</glossseealso -> </glossdef> + <glossterm><application>KBuildSycoca</application></glossterm> + <glossdef><para><application>KBuildSycoca</application> is a command line program and regenerates the so-called <acronym>KSycoca</acronym>. This is useful, for example, if some or all modules in &kcontrol; are missing.</para> +<glossseealso otherterm="gloss-tdesycoca"><acronym>KSycoca</acronym></glossseealso> <glossseealso otherterm="gloss-kcontrol">&kcontrol;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-kcontrol"> - <glossterm ->&kcontrol;</glossterm> - <glossdef -><para ->This is the project and filename of the &kde; control centre. &kcontrol; allows you to customise virtually every configuration option of &kde;.</para> - <glossseealso otherterm="gloss-kde" ->&kde;</glossseealso> + <glossterm>&kcontrol;</glossterm> + <glossdef><para>This is the project and filename of the &kde; control centre. &kcontrol; allows you to customise virtually every configuration option of &kde;.</para> + <glossseealso otherterm="gloss-kde">&kde;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-kicker"> - <glossterm ->&kicker;</glossterm> - <glossdef -><para ->&kicker; is the nickname as well as project name of the &kde; panel.</para> -<glossseealso otherterm="gloss-kde" ->&kde;</glossseealso -> <glossseealso otherterm="gloss-panel" ->Panel</glossseealso -> </glossdef> + <glossterm>&kicker;</glossterm> + <glossdef><para>&kicker; is the nickname as well as project name of the &kde; panel.</para> +<glossseealso otherterm="gloss-kde">&kde;</glossseealso> <glossseealso otherterm="gloss-panel">Panel</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-konqueror"> - <glossterm ->&konqueror;</glossterm> - <glossdef -><para ->&konqueror; is a filemanager, web browser, picture viewer and more, and a core part of the &kde; project. You can find more information about &konqueror; at <ulink url="http://www.konqueror.org" ->www.konqueror.org</ulink ->.</para> - <glossseealso otherterm="gloss-kde" ->&kde;</glossseealso> + <glossterm>&konqueror;</glossterm> + <glossdef><para>&konqueror; is a filemanager, web browser, picture viewer and more, and a core part of the &kde; project. You can find more information about &konqueror; at <ulink url="http://www.konqueror.org">www.konqueror.org</ulink>.</para> + <glossseealso otherterm="gloss-kde">&kde;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-ksirc"> - <glossterm ->&ksirc;</glossterm> - <glossdef -><para ->&ksirc; is the default <acronym ->IRC</acronym -> client, which is shipped with &kde;. You can use &ksirc; to chat with anyone on an <acronym ->IRC</acronym -> network.</para> - <glossseealso otherterm="gloss-irc" -><acronym ->IRC</acronym -></glossseealso> + <glossterm>&ksirc;</glossterm> + <glossdef><para>&ksirc; is the default <acronym>IRC</acronym> client, which is shipped with &kde;. You can use &ksirc; to chat with anyone on an <acronym>IRC</acronym> network.</para> + <glossseealso otherterm="gloss-irc"><acronym>IRC</acronym></glossseealso> </glossdef> - </glossentry -> + </glossentry> </glossdiv> <glossdiv id="glossdiv-desktop-terminology"> - <title ->Desktop Terminology</title> + <title>Desktop Terminology</title> <glossentry id="gloss-draganddrop"> - <glossterm ->Drag and Drop</glossterm> - <glossdef -><para ->This concept tries to replace many actions like copying files from one place to another by a certain mouse movement, ⪚ clicking on an icon in a &konqueror; window, moving the mouse to another window while keeping the mouse button pressed, and releasing the mouse button (<quote ->dropping</quote -> the object) copies files.</para> - <glossseealso otherterm="gloss-konqueror" ->&konqueror;</glossseealso> + <glossterm>Drag and Drop</glossterm> + <glossdef><para>This concept tries to replace many actions like copying files from one place to another by a certain mouse movement, ⪚ clicking on an icon in a &konqueror; window, moving the mouse to another window while keeping the mouse button pressed, and releasing the mouse button (<quote>dropping</quote> the object) copies files.</para> + <glossseealso otherterm="gloss-konqueror">&konqueror;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-gui"> - <glossterm ->&GUI;</glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->G</emphasis ->raphical <emphasis ->U</emphasis ->ser <emphasis ->I</emphasis ->nterface. Every desktop environment (like &kde;) is a &GUI;. Most &GUI;s feature mouse support and/or windows to manage the programs.</para> - <glossseealso otherterm="gloss-kde" ->&kde;</glossseealso> + <glossterm>&GUI;</glossterm> + <glossdef><para>Abbreviation for <emphasis>G</emphasis>raphical <emphasis>U</emphasis>ser <emphasis>I</emphasis>nterface. Every desktop environment (like &kde;) is a &GUI;. Most &GUI;s feature mouse support and/or windows to manage the programs.</para> + <glossseealso otherterm="gloss-kde">&kde;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-kde"> - <glossterm ->&kde;</glossterm> - <glossdef -><para ->Abbreviation for <quote ->K Desktop Environment</quote ->, a leading &GUI; for &UNIX;-based systems. You can find more detailled information at <ulink url="http://www.kde.org" ->www.kde.org</ulink ->.</para> - <glossseealso otherterm="gloss-gui" ->&GUI;</glossseealso> + <glossterm>&kde;</glossterm> + <glossdef><para>Abbreviation for <quote>K Desktop Environment</quote>, a leading &GUI; for &UNIX;-based systems. You can find more detailled information at <ulink url="http://www.kde.org">www.kde.org</ulink>.</para> + <glossseealso otherterm="gloss-gui">&GUI;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-gnome"> - <glossterm -><acronym ->GNOME</acronym -></glossterm> + <glossterm><acronym>GNOME</acronym></glossterm> <glossdef> - <para -><emphasis ->G</emphasis ->NU <emphasis ->N</emphasis ->etwork <emphasis ->O</emphasis ->bject <emphasis ->M</emphasis ->odel <emphasis ->E</emphasis ->nvironment, one of the leading &UNIX; &GUI;s.</para> - <glossseealso otherterm="gloss-gui" ->&GUI;</glossseealso> + <para><emphasis>G</emphasis>NU <emphasis>N</emphasis>etwork <emphasis>O</emphasis>bject <emphasis>M</emphasis>odel <emphasis>E</emphasis>nvironment, one of the leading &UNIX; &GUI;s.</para> + <glossseealso otherterm="gloss-gui">&GUI;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-panel"> - <glossterm ->Panel</glossterm> - <glossdef -><para ->Refers to the panel (also known as <quote ->&kicker;</quote ->) which often resides at the bottom of the screen.</para> -<glossseealso otherterm="gloss-kde" ->&kde;</glossseealso -> <glossseealso otherterm="gloss-kicker" ->&kicker;</glossseealso -> </glossdef> + <glossterm>Panel</glossterm> + <glossdef><para>Refers to the panel (also known as <quote>&kicker;</quote>) which often resides at the bottom of the screen.</para> +<glossseealso otherterm="gloss-kde">&kde;</glossseealso> <glossseealso otherterm="gloss-kicker">&kicker;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-ripping"> - <glossterm ->ripping</glossterm> - <glossdef -><para ->The process of reading audio data from a &cdrom; and storing it on the hard disk.</para> + <glossterm>ripping</glossterm> + <glossdef><para>The process of reading audio data from a &cdrom; and storing it on the hard disk.</para> </glossdef> </glossentry> </glossdiv> <glossdiv id="kde-development"> - <title ->&kde; Development</title> + <title>&kde; Development</title> <glossentry id="gloss-qt"> - <glossterm ->&Qt;</glossterm> - <glossdef -><para ->The &GUI; of &kde; is built on top of the &Qt; toolkit, which provides many graphical elements (so-called <quote ->Widgets</quote ->) which are used to construct the desktop. You can find more information about &Qt; at <ulink url="http://www.trolltech.com" ->www.trolltech.com</ulink ->.</para> -<glossseealso otherterm="gloss-kde" ->&kde;</glossseealso -> <glossseealso otherterm="gloss-gui" ->&GUI;</glossseealso -> <glossseealso otherterm="gloss-widget" ->Widget</glossseealso -> </glossdef> + <glossterm>&Qt;</glossterm> + <glossdef><para>The &GUI; of &kde; is built on top of the &Qt; toolkit, which provides many graphical elements (so-called <quote>Widgets</quote>) which are used to construct the desktop. You can find more information about &Qt; at <ulink url="http://www.trolltech.com">www.trolltech.com</ulink>.</para> +<glossseealso otherterm="gloss-kde">&kde;</glossseealso> <glossseealso otherterm="gloss-gui">&GUI;</glossseealso> <glossseealso otherterm="gloss-widget">Widget</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-i18n"> - <glossterm ->i18n</glossterm> - <glossdef -><para ->Abbreviation for <quote ->internationalisation</quote ->. &kde; supports many different languages, and several i18n techniques make it easy to translate the &GUI; as well as the accompanying documents of &kde; into all these languages. More information about the i18n process is available at <ulink url="http://i18n.kde.org" ->i18n.kde.org</ulink ->.</para> -<glossseealso otherterm="gloss-kde" ->&kde;</glossseealso -> <glossseealso otherterm="gloss-gui" ->&GUI;</glossseealso -> </glossdef> + <glossterm>i18n</glossterm> + <glossdef><para>Abbreviation for <quote>internationalisation</quote>. &kde; supports many different languages, and several i18n techniques make it easy to translate the &GUI; as well as the accompanying documents of &kde; into all these languages. More information about the i18n process is available at <ulink url="http://i18n.kde.org">i18n.kde.org</ulink>.</para> +<glossseealso otherterm="gloss-kde">&kde;</glossseealso> <glossseealso otherterm="gloss-gui">&GUI;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-l10n"> - <glossterm ->l10n</glossterm> - <glossdef -><para ->Abbreviation for <quote ->localisation</quote ->, the process of adapting a program to the local environment. This includes ⪚ the currency used for monetary values or the time format.</para> - <glossseealso otherterm="gloss-i18n" ->i18n</glossseealso> + <glossterm>l10n</glossterm> + <glossdef><para>Abbreviation for <quote>localisation</quote>, the process of adapting a program to the local environment. This includes ⪚ the currency used for monetary values or the time format.</para> + <glossseealso otherterm="gloss-i18n">i18n</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-widget"> - <glossterm ->Widget</glossterm> - <glossdef -><para ->Graphical elements like scrollbars, buttons or input fields which are used by &kde; to construct the &GUI;. </para> -<glossseealso otherterm="gloss-kde" ->&kde;</glossseealso -> <glossseealso otherterm="gloss-gui" ->&GUI;</glossseealso -> </glossdef> + <glossterm>Widget</glossterm> + <glossdef><para>Graphical elements like scrollbars, buttons or input fields which are used by &kde; to construct the &GUI;. </para> +<glossseealso otherterm="gloss-kde">&kde;</glossseealso> <glossseealso otherterm="gloss-gui">&GUI;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-cvs"> - <glossterm -><acronym ->CVS</acronym -></glossterm> + <glossterm><acronym>CVS</acronym></glossterm> <glossdef> - <para -><emphasis ->C</emphasis ->oncurrent <emphasis ->V</emphasis ->ersion <emphasis ->S</emphasis ->ystem. The <acronym ->CVS</acronym -> is a very elegant way of managing file versions that allow more than one developer to easily work on the same project. You can find a description of how to get the latest (developer) version of the &kde; sources via anonymous <acronym ->CVS</acronym -> on <ulink url="http://www.kde.org/anoncvs.html" ->http://www.kde.org/anoncvs.html</ulink ->. More about <acronym ->CVS</acronym -> is available at <ulink url="http://www.cvshome.org" ->www.cvshome.org</ulink ->. </para> + <para><emphasis>C</emphasis>oncurrent <emphasis>V</emphasis>ersion <emphasis>S</emphasis>ystem. The <acronym>CVS</acronym> is a very elegant way of managing file versions that allow more than one developer to easily work on the same project. You can find a description of how to get the latest (developer) version of the &kde; sources via anonymous <acronym>CVS</acronym> on <ulink url="http://www.kde.org/anoncvs.html">http://www.kde.org/anoncvs.html</ulink>. More about <acronym>CVS</acronym> is available at <ulink url="http://www.cvshome.org">www.cvshome.org</ulink>. </para> </glossdef> </glossentry> </glossdiv> <glossdiv id="glossdiv-misc"> - <title ->Miscellaneous</title> + <title>Miscellaneous</title> <glossentry id="gloss-rfc"> - <glossterm -><acronym ->RFC</acronym -></glossterm> - <glossdef -><para -><emphasis ->R</emphasis ->equest <emphasis ->F</emphasis ->or <emphasis ->C</emphasis ->omment. A common way to publish new protocol ideas or procedures for evaluation of the Internet community. Though <acronym ->RFC</acronym ->s are not mandatory, many applications try to adhere to them, once they have been approved by the community. More information about <acronym ->RFC</acronym ->s can be found at the <ulink url="http://www.rfc-editor.org" ->RFC Homepage</ulink ->.</para> + <glossterm><acronym>RFC</acronym></glossterm> + <glossdef><para><emphasis>R</emphasis>equest <emphasis>F</emphasis>or <emphasis>C</emphasis>omment. A common way to publish new protocol ideas or procedures for evaluation of the Internet community. Though <acronym>RFC</acronym>s are not mandatory, many applications try to adhere to them, once they have been approved by the community. More information about <acronym>RFC</acronym>s can be found at the <ulink url="http://www.rfc-editor.org">RFC Homepage</ulink>.</para> </glossdef> - </glossentry -> + </glossentry> </glossdiv> <glossdiv id="glossdiv-protocols"> - <title ->Various protocols</title> + <title>Various protocols</title> <glossentry id="gloss-smb"> - <glossterm -><acronym ->SMB</acronym -></glossterm> - <glossdef -><para -><emphasis ->S</emphasis ->erver <emphasis ->M</emphasis ->essage <emphasis ->B</emphasis ->lock. A network protocol used in &Microsoft; &Windows; networks to access the filesystems of other computers.</para> - <glossseealso otherterm="gloss-ioslave" -><acronym ->IO</acronym -> Slave</glossseealso> + <glossterm><acronym>SMB</acronym></glossterm> + <glossdef><para><emphasis>S</emphasis>erver <emphasis>M</emphasis>essage <emphasis>B</emphasis>lock. A network protocol used in &Microsoft; &Windows; networks to access the filesystems of other computers.</para> + <glossseealso otherterm="gloss-ioslave"><acronym>IO</acronym> Slave</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-irc"> - <glossterm -><acronym ->IRC</acronym -></glossterm> - <glossdef -><para -><emphasis ->I</emphasis ->nternet <emphasis ->R</emphasis ->elay <emphasis ->C</emphasis ->hat. A protocol defined in <acronym ->RFC</acronym -> 1459, which handles the specification to enable real time text chat.</para> - <glossseealso otherterm="gloss-rfc" -><acronym ->RFC</acronym -></glossseealso> + <glossterm><acronym>IRC</acronym></glossterm> + <glossdef><para><emphasis>I</emphasis>nternet <emphasis>R</emphasis>elay <emphasis>C</emphasis>hat. A protocol defined in <acronym>RFC</acronym> 1459, which handles the specification to enable real time text chat.</para> + <glossseealso otherterm="gloss-rfc"><acronym>RFC</acronym></glossseealso> </glossdef> </glossentry> <glossentry id="gloss-host"> - <glossterm ->host</glossterm> - <glossdef -><para ->This can either be a name from your <filename ->/etc/hosts</filename -> file (<systemitem class="systemname" ->mycomputer</systemitem ->), an Internet name (<systemitem class="systemname" ->www.kde.org</systemitem ->) or an IP-Address (<systemitem ->192.168.0.10</systemitem ->). </para> + <glossterm>host</glossterm> + <glossdef><para>This can either be a name from your <filename>/etc/hosts</filename> file (<systemitem class="systemname">mycomputer</systemitem>), an Internet name (<systemitem class="systemname">www.kde.org</systemitem>) or an IP-Address (<systemitem>192.168.0.10</systemitem>). </para> </glossdef> </glossentry> </glossdiv> diff --git a/tde-i18n-en_GB/docs/tdebase/glossary/tdeprintingglossary.docbook b/tde-i18n-en_GB/docs/tdebase/glossary/tdeprintingglossary.docbook index 17b6ddb88ac..c0869488cc5 100644 --- a/tde-i18n-en_GB/docs/tdebase/glossary/tdeprintingglossary.docbook +++ b/tde-i18n-en_GB/docs/tdebase/glossary/tdeprintingglossary.docbook @@ -11,1248 +11,442 @@ <glossary id="glossary"> --> <glossdiv id="glossdiv-printing"> - <title ->Printing</title> + <title>Printing</title> <glossentry id="gloss-acl"> - <glossterm -><acronym ->ACLs</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->A</emphasis ->ccess <emphasis ->C</emphasis ->ontrol <emphasis ->L</emphasis ->ists; ACLs are used to check for the access by a given (authenticated) user. A first rough support for ACLs for printing is available from &CUPS;; this will be refined in future versions. </para> - <glossseealso otherterm="gloss-authentication" ->Authentication</glossseealso> + <glossterm><acronym>ACLs</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>A</emphasis>ccess <emphasis>C</emphasis>ontrol <emphasis>L</emphasis>ists; ACLs are used to check for the access by a given (authenticated) user. A first rough support for ACLs for printing is available from &CUPS;; this will be refined in future versions. </para> + <glossseealso otherterm="gloss-authentication">Authentication</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-appsocketprotocol"> - <glossterm ->AppSocket Protocol</glossterm> - <glossdef -><para ->AppSocket is a protocol for the transfer of print data, also frequently called "Direct TCP/IP Printing". &Hewlett-Packard; have taken AppSocket, added a few minor extensions around it and been very successful in renaming and marketing it under the brand "&HP; JetDirect"...</para> -<glossseealso otherterm="gloss-hpjetdirectprotocol" ->&HP; JetDirect Protocol</glossseealso -> <glossseealso otherterm="gloss-directtcpipprinting" ->Direct TCP/IP Printing</glossseealso -> </glossdef> + <glossterm>AppSocket Protocol</glossterm> + <glossdef><para>AppSocket is a protocol for the transfer of print data, also frequently called "Direct TCP/IP Printing". &Hewlett-Packard; have taken AppSocket, added a few minor extensions around it and been very successful in renaming and marketing it under the brand "&HP; JetDirect"...</para> +<glossseealso otherterm="gloss-hpjetdirectprotocol">&HP; JetDirect Protocol</glossseealso> <glossseealso otherterm="gloss-directtcpipprinting">Direct TCP/IP Printing</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-apsfilter"> - <glossterm ->APSfilter</glossterm> - <glossdef -><para ->APSfilter is used mainly in the context of "classical" &UNIX; printing (BSD-style LPD). It is a sophisticated shell script, disguised as an "all-in-one" filtering program. In reality, APSfilter calls "real filters" to do the jobs needed. It sends printjobs automatically through these other filters, based on an initial file-type analysis of the printfile. It is written and maintained by Andreas Klemm. It is similar to Magicfilter and mostly uses Ghostscript for file conversions. Some Linux Distributions (like &SuSE;) use APSfilter, others Magicfilter (like &RedHat;), some have both for preference selection (like *BSD). &CUPS; has <emphasis ->no</emphasis -> need for APSfilter, as it runs its own file type recognition (based on &MIME; types) and applies its own filtering logic.</para> -<glossseealso otherterm="gloss-ghostscript" ->Ghostscript</glossseealso -> <glossseealso otherterm="gloss-magicfilter" ->Magicfilter</glossseealso -> <glossseealso otherterm="gloss-mimetypes" ->&MIME;-Types</glossseealso -> <glossseealso otherterm="gloss-printcap" ->printcap</glossseealso -> </glossdef> + <glossterm>APSfilter</glossterm> + <glossdef><para>APSfilter is used mainly in the context of "classical" &UNIX; printing (BSD-style LPD). It is a sophisticated shell script, disguised as an "all-in-one" filtering program. In reality, APSfilter calls "real filters" to do the jobs needed. It sends printjobs automatically through these other filters, based on an initial file-type analysis of the printfile. It is written and maintained by Andreas Klemm. It is similar to Magicfilter and mostly uses Ghostscript for file conversions. Some Linux Distributions (like &SuSE;) use APSfilter, others Magicfilter (like &RedHat;), some have both for preference selection (like *BSD). &CUPS; has <emphasis>no</emphasis> need for APSfilter, as it runs its own file type recognition (based on &MIME; types) and applies its own filtering logic.</para> +<glossseealso otherterm="gloss-ghostscript">Ghostscript</glossseealso> <glossseealso otherterm="gloss-magicfilter">Magicfilter</glossseealso> <glossseealso otherterm="gloss-mimetypes">&MIME;-Types</glossseealso> <glossseealso otherterm="gloss-printcap">printcap</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-authentication"> - <glossterm ->Authentication</glossterm> - <glossdef -><para ->Proving the identity of a certain person (maybe via username/password or by means of a certificate) is often called authentication. Once you are authenticated, you may or may not get access to a requested ressource, possibly based on ACLs.</para> - <glossseealso otherterm="gloss-acl" ->ACLs</glossseealso> + <glossterm>Authentication</glossterm> + <glossdef><para>Proving the identity of a certain person (maybe via username/password or by means of a certificate) is often called authentication. Once you are authenticated, you may or may not get access to a requested ressource, possibly based on ACLs.</para> + <glossseealso otherterm="gloss-acl">ACLs</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-bidirectionalcommunication"> - <glossterm ->Bi-directional communication</glossterm> - <glossdef -><para ->In the context of printing, a server or a host may receive additional information sent back from the printer (status messages &etc;), either upon a query or unrequested. AppSocket ( = &HP; JetDirect), &CUPS; and IPP support bi-directional communication, LPR/LPD and BSD-style printing do not...</para> -<glossseealso otherterm="gloss-appsocketprotocol" ->AppSocket Protocol</glossseealso -> <glossseealso otherterm="gloss-cups" ->&CUPS;</glossseealso -> <glossseealso otherterm="gloss-directtcpipprinting" ->Direct TCP/IP Printing</glossseealso -> <glossseealso otherterm="gloss-hpjetdirectprotocol" ->&HP; JetDirect</glossseealso -> <glossseealso otherterm="gloss-ipp" ->IPP</glossseealso -> <glossseealso otherterm="gloss-lprlpd" ->LPR/LPD</glossseealso -> </glossdef> + <glossterm>Bi-directional communication</glossterm> + <glossdef><para>In the context of printing, a server or a host may receive additional information sent back from the printer (status messages &etc;), either upon a query or unrequested. AppSocket ( = &HP; JetDirect), &CUPS; and IPP support bi-directional communication, LPR/LPD and BSD-style printing do not...</para> +<glossseealso otherterm="gloss-appsocketprotocol">AppSocket Protocol</glossseealso> <glossseealso otherterm="gloss-cups">&CUPS;</glossseealso> <glossseealso otherterm="gloss-directtcpipprinting">Direct TCP/IP Printing</glossseealso> <glossseealso otherterm="gloss-hpjetdirectprotocol">&HP; JetDirect</glossseealso> <glossseealso otherterm="gloss-ipp">IPP</glossseealso> <glossseealso otherterm="gloss-lprlpd">LPR/LPD</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-bsdstyleprinting"> - <glossterm ->BSD-style Printing</glossterm> - <glossdef -><para ->Generic term for different variants of the traditional &UNIX; printing method. Its first version appeared in the early 70s on BSD &UNIX; and was formally described in <ulink url="http://www.rfc.net/rfc1179.html" ->RFC 1179</ulink -> only as late as 1990. At the time when BSD "remote" printing was first designed, printers were serially or otherwise directly connected devices to a host (with the Internet hardly consisting of more than 100 nodes!); printers used hole-punched, continuous paper, fed through by a tractor mechanism, with simple rows of ASCII text mechanically hammered on to the medium, drawn from a cardboard box beneath the table. It came out like a zig-zag folded paper "snake". Remote printing consisted of a neighbouring host in the next room sending a file asking for printout. How technology has changed! Printers generally use cut-sheet media, they have built-in intelligence to compute the raster images of pages after pages that are sent to them using one of the powerful page description languages (PDL). Many are network nodes in their own right, with CPU, RAM, a hard disk and their own Operation System, and are hooked to a net with potentially millions of users... It is a vast proof of the flexible &UNIX; concept for doing things, that it made "Line Printing" reliably work even under these modern conditions. But time has finally come now to go for something new -- the IPP. It is strong proof of the flexibility of &UNIX;; that "Line Printing" works reliably, even under these modern conditions. But time has finally come now to go for something new -- the IPP. </para> -<glossseealso otherterm="gloss-ipp" ->IPP</glossseealso -> <glossseealso otherterm="gloss-cups" ->&CUPS;</glossseealso -> <glossseealso otherterm="gloss-lprlpd" ->LPR/LPD printing</glossseealso -> </glossdef> + <glossterm>BSD-style Printing</glossterm> + <glossdef><para>Generic term for different variants of the traditional &UNIX; printing method. Its first version appeared in the early 70s on BSD &UNIX; and was formally described in <ulink url="http://www.rfc.net/rfc1179.html">RFC 1179</ulink> only as late as 1990. At the time when BSD "remote" printing was first designed, printers were serially or otherwise directly connected devices to a host (with the Internet hardly consisting of more than 100 nodes!); printers used hole-punched, continuous paper, fed through by a tractor mechanism, with simple rows of ASCII text mechanically hammered on to the medium, drawn from a cardboard box beneath the table. It came out like a zig-zag folded paper "snake". Remote printing consisted of a neighbouring host in the next room sending a file asking for printout. How technology has changed! Printers generally use cut-sheet media, they have built-in intelligence to compute the raster images of pages after pages that are sent to them using one of the powerful page description languages (PDL). Many are network nodes in their own right, with CPU, RAM, a hard disk and their own Operation System, and are hooked to a net with potentially millions of users... It is a vast proof of the flexible &UNIX; concept for doing things, that it made "Line Printing" reliably work even under these modern conditions. But time has finally come now to go for something new -- the IPP. It is strong proof of the flexibility of &UNIX;; that "Line Printing" works reliably, even under these modern conditions. But time has finally come now to go for something new -- the IPP. </para> +<glossseealso otherterm="gloss-ipp">IPP</glossseealso> <glossseealso otherterm="gloss-cups">&CUPS;</glossseealso> <glossseealso otherterm="gloss-lprlpd">LPR/LPD printing</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-cups"> - <glossterm ->&CUPS;</glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->C</emphasis ->ommon <emphasis ->U</emphasis ->NIX <emphasis ->P</emphasis ->rinting <emphasis ->S</emphasis ->ystem; &CUPS; is the most modern &UNIX; and Linux printing system, also providing cross-platform print services to &Microsoft; &Windows; and Apple &MacOS; clients. Based on IPP, it does away with all the pitfalls of old-style BSD printing, providing authentication, encryption and ACLs, plus many more features. At the same time it is backward-compatible enough to serve all legacy clients that are not yet up to IPP, via LPR/LPD (BSD-style). &CUPS; is able to control any &PostScript; printer by utilizing the vendor-supplied PPD (PostScript Printer Description file), targeted originally for &Microsoft; Windows NT printing only. &kde; Printing is most powerful if based on &CUPS;.</para> -<glossseealso otherterm="gloss-acl" ->ACLs</glossseealso -> <glossseealso otherterm="gloss-authentication" ->Authentication</glossseealso -> <glossseealso otherterm="gloss-bsdstyleprinting" ->BSD-style printing</glossseealso -> <glossseealso otherterm="gloss-ipp" ->IPP</glossseealso -> <glossseealso otherterm="gloss-tdeprint" ->TDEPrint</glossseealso -> <glossseealso otherterm="gloss-lprlpd" ->LPR/LPD</glossseealso -> <glossseealso otherterm="gloss-ppd" ->PPD</glossseealso -> </glossdef> + <glossterm>&CUPS;</glossterm> + <glossdef><para>Abbreviation for <emphasis>C</emphasis>ommon <emphasis>U</emphasis>NIX <emphasis>P</emphasis>rinting <emphasis>S</emphasis>ystem; &CUPS; is the most modern &UNIX; and Linux printing system, also providing cross-platform print services to &Microsoft; &Windows; and Apple &MacOS; clients. Based on IPP, it does away with all the pitfalls of old-style BSD printing, providing authentication, encryption and ACLs, plus many more features. At the same time it is backward-compatible enough to serve all legacy clients that are not yet up to IPP, via LPR/LPD (BSD-style). &CUPS; is able to control any &PostScript; printer by utilizing the vendor-supplied PPD (PostScript Printer Description file), targeted originally for &Microsoft; Windows NT printing only. &kde; Printing is most powerful if based on &CUPS;.</para> +<glossseealso otherterm="gloss-acl">ACLs</glossseealso> <glossseealso otherterm="gloss-authentication">Authentication</glossseealso> <glossseealso otherterm="gloss-bsdstyleprinting">BSD-style printing</glossseealso> <glossseealso otherterm="gloss-ipp">IPP</glossseealso> <glossseealso otherterm="gloss-tdeprint">TDEPrint</glossseealso> <glossseealso otherterm="gloss-lprlpd">LPR/LPD</glossseealso> <glossseealso otherterm="gloss-ppd">PPD</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-cupsfaq"> - <glossterm -><acronym ->&CUPS;-FAQ</acronym -></glossterm> - <glossdef -><para ->Currently only available in German (translation is on the way), the <ulink url="http://www.danka.de/printpro/faq.html" ->&CUPS;-FAQ</ulink -> is a valuable resource to answer many questions that anyone new to &CUPS; printing might have at first. </para> - <glossseealso otherterm="gloss-tdeprinthandbook" ->TDEPrint Handbook</glossseealso> + <glossterm><acronym>&CUPS;-FAQ</acronym></glossterm> + <glossdef><para>Currently only available in German (translation is on the way), the <ulink url="http://www.danka.de/printpro/faq.html">&CUPS;-FAQ</ulink> is a valuable resource to answer many questions that anyone new to &CUPS; printing might have at first. </para> + <glossseealso otherterm="gloss-tdeprinthandbook">TDEPrint Handbook</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-cups-o-matic"> - <glossterm ->&CUPS;-O-Matic</glossterm> - <glossdef -><para ->&CUPS;-O-Matic was the first "Third Party" plugin for the &CUPS; printing software. It is available on the <ulink url="http://www.linuxprinting.org/cups-doc.html" ->Linuxprinting.org website</ulink -> to provide an online PPD-generating service. Together with the companion <application ->cupsomatic</application -> Perl-Script, that needs to be installed as an additional &CUPS; backend, it redirects output from the native <application ->pstops</application -> filter into a chain of suitable Ghostscript filters. Upon completion, it passes the resulting data back to a &CUPS; "backend" for sending to the printer. In this way, &CUPS;-O-Matic enables support for any printer known to have worked previously in a "classical" Ghostscript environment. If no native &CUPS; support for that printer is in sight... &CUPS;-O-Matic is now replaced by the more capable PPD-O-Matic.</para> -<glossseealso otherterm="gloss-cupsomatic" ->cupsomatic</glossseealso -> <glossseealso otherterm="gloss-PPD-O-Matic" ->PPD-O-Matic</glossseealso -> <glossseealso otherterm="gloss-foomatic" ->Foomatic</glossseealso -> </glossdef> + <glossterm>&CUPS;-O-Matic</glossterm> + <glossdef><para>&CUPS;-O-Matic was the first "Third Party" plugin for the &CUPS; printing software. It is available on the <ulink url="http://www.linuxprinting.org/cups-doc.html">Linuxprinting.org website</ulink> to provide an online PPD-generating service. Together with the companion <application>cupsomatic</application> Perl-Script, that needs to be installed as an additional &CUPS; backend, it redirects output from the native <application>pstops</application> filter into a chain of suitable Ghostscript filters. Upon completion, it passes the resulting data back to a &CUPS; "backend" for sending to the printer. In this way, &CUPS;-O-Matic enables support for any printer known to have worked previously in a "classical" Ghostscript environment. If no native &CUPS; support for that printer is in sight... &CUPS;-O-Matic is now replaced by the more capable PPD-O-Matic.</para> +<glossseealso otherterm="gloss-cupsomatic">cupsomatic</glossseealso> <glossseealso otherterm="gloss-PPD-O-Matic">PPD-O-Matic</glossseealso> <glossseealso otherterm="gloss-foomatic">Foomatic</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-cupsomatic"> - <glossterm ->cupsomatic</glossterm> - <glossdef -><para ->The Perl script <application ->cupsomatic</application -> (plus a working Perl installation on your system) is needed to make any &CUPS;-O-Matic (or PPD-O-Matic) generated PPD work with &CUPS;. It was written by Grant Taylor, author of the Linux Printing HOWTO and Maintainer of the <ulink url="http://www.linuxprinting.org/printer_list.cgi" ->printer database</ulink -> at the Linuxprinting.org website.</para> -<glossseealso otherterm="gloss-cups-o-matic" ->&CUPS;-O-Matic</glossseealso -> <glossseealso otherterm="gloss-foomatic" ->Foomatic</glossseealso -> <glossseealso otherterm="gloss-cupsomatic" ->cupsomatic</glossseealso -> </glossdef> + <glossterm>cupsomatic</glossterm> + <glossdef><para>The Perl script <application>cupsomatic</application> (plus a working Perl installation on your system) is needed to make any &CUPS;-O-Matic (or PPD-O-Matic) generated PPD work with &CUPS;. It was written by Grant Taylor, author of the Linux Printing HOWTO and Maintainer of the <ulink url="http://www.linuxprinting.org/printer_list.cgi">printer database</ulink> at the Linuxprinting.org website.</para> +<glossseealso otherterm="gloss-cups-o-matic">&CUPS;-O-Matic</glossseealso> <glossseealso otherterm="gloss-foomatic">Foomatic</glossseealso> <glossseealso otherterm="gloss-cupsomatic">cupsomatic</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-daemon"> - <glossterm -><acronym ->Daemon</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->D</emphasis ->isk <emphasis ->a</emphasis ->nd <emphasis ->e</emphasis ->xecution <emphasis ->mon</emphasis ->itor; <acronym ->Daemons</acronym -> are present on all &UNIX; systems to perform tasks independent of user intervention. Readers more familiar with &Microsoft; &Windows; might want to compare daemons and the tasks they are responsible with "services". One example of a daemon present on most legacy &UNIX; systems is the LPD (Line Printer Daemon); &CUPS; is widely seen as the successor to LPD in the &UNIX; world and it also operates through a daemon. </para> - <glossseealso otherterm="gloss-spooling" ->SPOOLing</glossseealso> + <glossterm><acronym>Daemon</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>D</emphasis>isk <emphasis>a</emphasis>nd <emphasis>e</emphasis>xecution <emphasis>mon</emphasis>itor; <acronym>Daemons</acronym> are present on all &UNIX; systems to perform tasks independent of user intervention. Readers more familiar with &Microsoft; &Windows; might want to compare daemons and the tasks they are responsible with "services". One example of a daemon present on most legacy &UNIX; systems is the LPD (Line Printer Daemon); &CUPS; is widely seen as the successor to LPD in the &UNIX; world and it also operates through a daemon. </para> + <glossseealso otherterm="gloss-spooling">SPOOLing</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-databaselinuxprinting"> - <glossterm ->Database, Linuxprinting.org</glossterm> - <glossdef -><para ->Already years ago, when Linux printing was still really difficult (only command line printing was known to most Linux users, no device specific print options were available for doing the jobs), Grant Taylor, author of the "Linux Printing HOWTO", collected most of the available information about printers, drivers and filters in his database. With the emerging &CUPS; concept, extending the use of PPDs even to non-PostScript printers, he realised the potential of this database: if one puts the different datablobs (with content that could be described along the lines "Which device prints with which Ghostscript or other filter?", "How well?", and "What command line switches are available?") into PPD-compatible files, he could have all the power of &CUPS; on top of the traditional printer "drivers". This has now developed into a broader concept, known as "Foomatic". Foomatic extends the capabilities of spoolers other than &CUPS; (LPR/LPD, LPRng, PDQ, PPR) to a certain degree ("stealing" some concepts from &CUPS;). The Linuxprinting Database is not a Linux-only stop -- people running other &UNIX; based OSes (like *BSD or &MacOS; X) will also find valuable information and software there. </para> -<glossseealso otherterm="gloss-foomatic" ->Foomatic</glossseealso -> <glossseealso otherterm="gloss-linuxprintingdatabase" ->Linuxprinting database</glossseealso -> </glossdef> + <glossterm>Database, Linuxprinting.org</glossterm> + <glossdef><para>Already years ago, when Linux printing was still really difficult (only command line printing was known to most Linux users, no device specific print options were available for doing the jobs), Grant Taylor, author of the "Linux Printing HOWTO", collected most of the available information about printers, drivers and filters in his database. With the emerging &CUPS; concept, extending the use of PPDs even to non-PostScript printers, he realised the potential of this database: if one puts the different datablobs (with content that could be described along the lines "Which device prints with which Ghostscript or other filter?", "How well?", and "What command line switches are available?") into PPD-compatible files, he could have all the power of &CUPS; on top of the traditional printer "drivers". This has now developed into a broader concept, known as "Foomatic". Foomatic extends the capabilities of spoolers other than &CUPS; (LPR/LPD, LPRng, PDQ, PPR) to a certain degree ("stealing" some concepts from &CUPS;). The Linuxprinting Database is not a Linux-only stop -- people running other &UNIX; based OSes (like *BSD or &MacOS; X) will also find valuable information and software there. </para> +<glossseealso otherterm="gloss-foomatic">Foomatic</glossseealso> <glossseealso otherterm="gloss-linuxprintingdatabase">Linuxprinting database</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-directtcpipprinting"> - <glossterm ->Direct TCP/IP Printing</glossterm> - <glossdef -><para ->This is a method that often uses TCP/IP port 9100 to connect to the printer. It works with many modern network printers and has a few advantages over LPR/LPD, as it is faster and provides some "backchannel feedback data" from the printer to the host sending the job.</para> -<glossseealso otherterm="gloss-appsocketprotocol" ->AppSocket Protocol</glossseealso -> <glossseealso otherterm="gloss-hpjetdirectprotocol" ->&HP; JetDirect Protocol</glossseealso -> </glossdef> + <glossterm>Direct TCP/IP Printing</glossterm> + <glossdef><para>This is a method that often uses TCP/IP port 9100 to connect to the printer. It works with many modern network printers and has a few advantages over LPR/LPD, as it is faster and provides some "backchannel feedback data" from the printer to the host sending the job.</para> +<glossseealso otherterm="gloss-appsocketprotocol">AppSocket Protocol</glossseealso> <glossseealso otherterm="gloss-hpjetdirectprotocol">&HP; JetDirect Protocol</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-drivers"> - <glossterm ->Drivers, Printer Drivers</glossterm> - <glossdef -><para ->The term "printer drivers", used in the same sense as on the &Microsoft; &Windows; platform, is not entirely applicable to a Linux or &UNIX; platform. A "driver" functionality is supplied on &UNIX; by different modular components working together. At the core of the printer drivers are "filters". Filters convert print files from a given input format to another format that is acceptable to the target printer. In many cases filters may be connected to a whole filter "chain", where only the result of the last conversion is sent to the printer. The actual transfer of the print data to the device is performed by a "backend". </para> -<glossseealso otherterm="gloss-filter" ->Filter</glossseealso -> <glossseealso otherterm="gloss-ppd" ->PPDs</glossseealso -> </glossdef> + <glossterm>Drivers, Printer Drivers</glossterm> + <glossdef><para>The term "printer drivers", used in the same sense as on the &Microsoft; &Windows; platform, is not entirely applicable to a Linux or &UNIX; platform. A "driver" functionality is supplied on &UNIX; by different modular components working together. At the core of the printer drivers are "filters". Filters convert print files from a given input format to another format that is acceptable to the target printer. In many cases filters may be connected to a whole filter "chain", where only the result of the last conversion is sent to the printer. The actual transfer of the print data to the device is performed by a "backend". </para> +<glossseealso otherterm="gloss-filter">Filter</glossseealso> <glossseealso otherterm="gloss-ppd">PPDs</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-easysoftwareproducts"> - <glossterm ->Easy Software Products</glossterm> - <glossdef -><para ->Mike Sweet's company, which has contributed a few substantial software products towards the Free Software community; amongst them the initial version of <ulink url="http://gimp-print.sf.net/" ->Gimp-Print,</ulink -> the <ulink url="http://www.easysw.com/epm/" ->EPM software packaging</ulink -> tool and <ulink url="http://www.easysw.com/htmldoc/" ->HTMLDOC</ulink -> (used by the "Linux Documentation Project" to build the PDF versions of the HOWTOs) -- but most importantly: <ulink url="http://www.cups.org/" ->&CUPS;</ulink -> (the 'Common &UNIX; Printing System'). ESP finance themselves by selling a commercial version of &CUPS;, called <ulink url="http://www.easysw.com/" ->ESP PrintPro,</ulink -> that includes some professional enhancements. </para> -<glossseealso otherterm="gloss-cups" ->&CUPS;</glossseealso -> <glossseealso otherterm="gloss-espprintpro" ->ESP PrintPro</glossseealso -> <glossseealso otherterm="gloss-esp" ->ESP</glossseealso -> <glossseealso otherterm="gloss-gimpprint" ->Gimp-Print</glossseealso -> </glossdef> + <glossterm>Easy Software Products</glossterm> + <glossdef><para>Mike Sweet's company, which has contributed a few substantial software products towards the Free Software community; amongst them the initial version of <ulink url="http://gimp-print.sf.net/">Gimp-Print,</ulink> the <ulink url="http://www.easysw.com/epm/">EPM software packaging</ulink> tool and <ulink url="http://www.easysw.com/htmldoc/">HTMLDOC</ulink> (used by the "Linux Documentation Project" to build the PDF versions of the HOWTOs) -- but most importantly: <ulink url="http://www.cups.org/">&CUPS;</ulink> (the 'Common &UNIX; Printing System'). ESP finance themselves by selling a commercial version of &CUPS;, called <ulink url="http://www.easysw.com/">ESP PrintPro,</ulink> that includes some professional enhancements. </para> +<glossseealso otherterm="gloss-cups">&CUPS;</glossseealso> <glossseealso otherterm="gloss-espprintpro">ESP PrintPro</glossseealso> <glossseealso otherterm="gloss-esp">ESP</glossseealso> <glossseealso otherterm="gloss-gimpprint">Gimp-Print</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-encryption"> - <glossterm ->Encryption</glossterm> - <glossdef -><para ->Encryption of confidential data is an all-important issue if you transfer it over the Internet or even within intranets. Printing via traditional protocols is not encrypted at all -- it is very easy to tap and eavesdrop ⪚ into &PostScript; or PCL data transfered over the wire. Therefore, in the design of IPP, provision was made for the easy plugin of encryption mechanisms (which can be provided by the same means as the encryption standards for HTTP traffic: SSL and TLS).</para> -<glossseealso otherterm="gloss-authentication" ->Authentication</glossseealso -> <glossseealso otherterm="gloss-cups" ->&CUPS;</glossseealso -> <glossseealso otherterm="gloss-ipp" ->IPP</glossseealso -> <glossseealso otherterm="gloss-ssl" ->SSL</glossseealso -> <glossseealso otherterm="gloss-tls" ->TLS</glossseealso -> </glossdef> + <glossterm>Encryption</glossterm> + <glossdef><para>Encryption of confidential data is an all-important issue if you transfer it over the Internet or even within intranets. Printing via traditional protocols is not encrypted at all -- it is very easy to tap and eavesdrop ⪚ into &PostScript; or PCL data transfered over the wire. Therefore, in the design of IPP, provision was made for the easy plugin of encryption mechanisms (which can be provided by the same means as the encryption standards for HTTP traffic: SSL and TLS).</para> +<glossseealso otherterm="gloss-authentication">Authentication</glossseealso> <glossseealso otherterm="gloss-cups">&CUPS;</glossseealso> <glossseealso otherterm="gloss-ipp">IPP</glossseealso> <glossseealso otherterm="gloss-ssl">SSL</glossseealso> <glossseealso otherterm="gloss-tls">TLS</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-epson"> - <glossterm -><acronym ->Epson</acronym -></glossterm> - <glossdef -><para ->Epson inkjets are among the best supported models by Free software drivers, as the company was not necessarily as secretive about their devices and handed technical specification documents to developers. The excellent print quality achieved by Gimp-Print on the Stylus series of printers can be attributed to this openness. They have also contracted Easy Software Products to maintain an enhanced version of Ghostscript ("ESP GhostScript") for improved support of their printer portfolio. </para> - <glossseealso otherterm="gloss-ghostscript" ->ESP Ghostscript</glossseealso> + <glossterm><acronym>Epson</acronym></glossterm> + <glossdef><para>Epson inkjets are among the best supported models by Free software drivers, as the company was not necessarily as secretive about their devices and handed technical specification documents to developers. The excellent print quality achieved by Gimp-Print on the Stylus series of printers can be attributed to this openness. They have also contracted Easy Software Products to maintain an enhanced version of Ghostscript ("ESP GhostScript") for improved support of their printer portfolio. </para> + <glossseealso otherterm="gloss-ghostscript">ESP Ghostscript</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-escapesequence"> - <glossterm ->Escape Sequences</glossterm> - <glossdef -><para ->The first ever printers printed ASCII data only. To initiate a new line, or eject a page, they included special command sequences, often carrying a leading [ESC]-character. &HP; evolved this concept through its series of PCL language editions until today, having now developed a full-blown Page Description Language (PDL) from these humble beginnings. </para> -<glossseealso otherterm="gloss-pcl" ->PCL</glossseealso -> <glossseealso otherterm="gloss-pdl" ->PDL</glossseealso -> </glossdef> + <glossterm>Escape Sequences</glossterm> + <glossdef><para>The first ever printers printed ASCII data only. To initiate a new line, or eject a page, they included special command sequences, often carrying a leading [ESC]-character. &HP; evolved this concept through its series of PCL language editions until today, having now developed a full-blown Page Description Language (PDL) from these humble beginnings. </para> +<glossseealso otherterm="gloss-pcl">PCL</glossseealso> <glossseealso otherterm="gloss-pdl">PDL</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-escp"> - <glossterm -><acronym ->ESC/P</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->E</emphasis ->pson <emphasis ->S</emphasis ->tandard <emphasis ->C</emphasis ->odes for <emphasis ->P</emphasis ->rinters. Besides &PostScript; and PCL, Epson's ESC/P printer language is one of the best known.</para> -<glossseealso otherterm="gloss-pcl" ->PCL</glossseealso -> <glossseealso otherterm="gloss-postscript" ->&PostScript;</glossseealso -> <glossseealso otherterm="gloss-hpgl" ->hpgl</glossseealso -> </glossdef> + <glossterm><acronym>ESC/P</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>E</emphasis>pson <emphasis>S</emphasis>tandard <emphasis>C</emphasis>odes for <emphasis>P</emphasis>rinters. Besides &PostScript; and PCL, Epson's ESC/P printer language is one of the best known.</para> +<glossseealso otherterm="gloss-pcl">PCL</glossseealso> <glossseealso otherterm="gloss-postscript">&PostScript;</glossseealso> <glossseealso otherterm="gloss-hpgl">hpgl</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-esp"> - <glossterm -><acronym ->ESP</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->E</emphasis ->asy <emphasis ->S</emphasis ->oftware <emphasis ->P</emphasis ->roducts; the company that developed &CUPS; (the "Common &UNIX; Printing System"). </para> -<glossseealso otherterm="gloss-easysoftwareproducts" ->Easy Software Products</glossseealso -> <glossseealso otherterm="gloss-cups" ->&CUPS;</glossseealso -> <glossseealso otherterm="gloss-espprintpro" ->ESP PrintPro</glossseealso -> </glossdef> + <glossterm><acronym>ESP</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>E</emphasis>asy <emphasis>S</emphasis>oftware <emphasis>P</emphasis>roducts; the company that developed &CUPS; (the "Common &UNIX; Printing System"). </para> +<glossseealso otherterm="gloss-easysoftwareproducts">Easy Software Products</glossseealso> <glossseealso otherterm="gloss-cups">&CUPS;</glossseealso> <glossseealso otherterm="gloss-espprintpro">ESP PrintPro</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-espghostscript"> - <glossterm -><acronym ->ESP</acronym -> Ghostscript</glossterm> - <glossdef -><para ->A Ghostscript version that is maintained by Easy Software Products. It includes pre-compiled Gimp-Print drivers for many inkjets (plus some other goodies). ESP Ghostscript will produce photographic quality prints in many cases, especially with the Epson Stylus model series. ESP Ghostscript is GPL-software. </para> -<glossseealso otherterm="gloss-easysoftwareproducts" ->Easy Software Products</glossseealso -> <glossseealso otherterm="gloss-cups" ->&CUPS;</glossseealso -> <glossseealso otherterm="gloss-espprintpro" ->ESP PrintPro</glossseealso -> </glossdef> + <glossterm><acronym>ESP</acronym> Ghostscript</glossterm> + <glossdef><para>A Ghostscript version that is maintained by Easy Software Products. It includes pre-compiled Gimp-Print drivers for many inkjets (plus some other goodies). ESP Ghostscript will produce photographic quality prints in many cases, especially with the Epson Stylus model series. ESP Ghostscript is GPL-software. </para> +<glossseealso otherterm="gloss-easysoftwareproducts">Easy Software Products</glossseealso> <glossseealso otherterm="gloss-cups">&CUPS;</glossseealso> <glossseealso otherterm="gloss-espprintpro">ESP PrintPro</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-espprintpro"> - <glossterm -><acronym ->ESP</acronym -> PrintPro</glossterm> - <glossdef -><para ->This professional enhancement to &CUPS; (the "Common &UNIX; Printing System") is sold by the developers of &CUPS; complete with more than 2,300 printer drivers for several commercial &UNIX; platforms. <ulink url="http://www.easysw.com/printpro/" ->ESP PrintPro</ulink -> is supposed to work "out of the box" with little or no configuration for users or admins. ESP also sell support contracts for &CUPS; and PrintPro. These sales help to feed the programmers who develop the Free version of &CUPS;. </para> - <glossseealso otherterm="gloss-cups" ->&CUPS;</glossseealso> + <glossterm><acronym>ESP</acronym> PrintPro</glossterm> + <glossdef><para>This professional enhancement to &CUPS; (the "Common &UNIX; Printing System") is sold by the developers of &CUPS; complete with more than 2,300 printer drivers for several commercial &UNIX; platforms. <ulink url="http://www.easysw.com/printpro/">ESP PrintPro</ulink> is supposed to work "out of the box" with little or no configuration for users or admins. ESP also sell support contracts for &CUPS; and PrintPro. These sales help to feed the programmers who develop the Free version of &CUPS;. </para> + <glossseealso otherterm="gloss-cups">&CUPS;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-filter"> - <glossterm ->Filter</glossterm> - <glossdef -><para ->Filters, in general, are programs that take some input data, work on it and pass it on as their output data. Filters may or may not change the data. Filters in the context of printing, are programs that convert a given file (destined for printing, but not suitable in the format it is presently) into a printable format. Sometimes whole "filter chains" have to be constructed to achieve the goal, piping the output of one filter as the input to the next. </para> -<glossseealso otherterm="gloss-ghostscript" ->Ghostscript</glossseealso -> <glossseealso otherterm="gloss-rip" ->RIP</glossseealso -> </glossdef> + <glossterm>Filter</glossterm> + <glossdef><para>Filters, in general, are programs that take some input data, work on it and pass it on as their output data. Filters may or may not change the data. Filters in the context of printing, are programs that convert a given file (destined for printing, but not suitable in the format it is presently) into a printable format. Sometimes whole "filter chains" have to be constructed to achieve the goal, piping the output of one filter as the input to the next. </para> +<glossseealso otherterm="gloss-ghostscript">Ghostscript</glossseealso> <glossseealso otherterm="gloss-rip">RIP</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-foomatic"> - <glossterm ->Foomatic</glossterm> - <glossdef -><para ->Foomatic started out as the wrapper name for a set of different tools available from <ulink url="http://www.linuxprinting.org/" ->Linuxprinting.org</ulink -> These tools aimed to make the usage of traditional Ghostscript and other print filters easier for users and extend the filters' capabilities by adding more command line switches or explain the driver's execution data. Foomatic's different incarnations are &CUPS;-O-Matic, PPD-O-Matic, PDQ-O-Matic, LPD-O-Matic, PPR-O-Matic, MF-O-Matic and Direct-O-Matic. All of these allow the generation of appropriate printer configuration files online, by simply selection the suitable model and suggested (or alternate) driver for that machine. More recently, Foomatic gravitated towards becoming a "meta-spooling" system, that allows configuration of the underlying print subsystem through a unified set of commands (however, this is much more complicated than TDEPrint's &GUI; interface, which performs a similar task with regards to different print subsystems). </para> -<glossseealso otherterm="gloss-cups-o-matic" ->&CUPS;-O-Matic</glossseealso -> <glossseealso otherterm="gloss-PPD-O-Matic" ->PPD-O-Matic</glossseealso -> <glossseealso otherterm="gloss-cupsomatic" ->cupsomatic</glossseealso -> </glossdef> + <glossterm>Foomatic</glossterm> + <glossdef><para>Foomatic started out as the wrapper name for a set of different tools available from <ulink url="http://www.linuxprinting.org/">Linuxprinting.org</ulink> These tools aimed to make the usage of traditional Ghostscript and other print filters easier for users and extend the filters' capabilities by adding more command line switches or explain the driver's execution data. Foomatic's different incarnations are &CUPS;-O-Matic, PPD-O-Matic, PDQ-O-Matic, LPD-O-Matic, PPR-O-Matic, MF-O-Matic and Direct-O-Matic. All of these allow the generation of appropriate printer configuration files online, by simply selection the suitable model and suggested (or alternate) driver for that machine. More recently, Foomatic gravitated towards becoming a "meta-spooling" system, that allows configuration of the underlying print subsystem through a unified set of commands (however, this is much more complicated than TDEPrint's &GUI; interface, which performs a similar task with regards to different print subsystems). </para> +<glossseealso otherterm="gloss-cups-o-matic">&CUPS;-O-Matic</glossseealso> <glossseealso otherterm="gloss-PPD-O-Matic">PPD-O-Matic</glossseealso> <glossseealso otherterm="gloss-cupsomatic">cupsomatic</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-ghostscript"> - <glossterm ->Ghostscript</glossterm> - <glossdef -><para ->Ghostscript is a &PostScript; Raster Image Processor (RIP) in software, originally developed by L. Peter Deutsch. There is always a <acronym ->GPL</acronym -> version of Ghostscript available for free usage and distribution (mostly 1 year old) while the current version is commercially sold under another licence. Ghostscript is widely used inside the Linux and &UNIX; world for transforming &PostScript; into raster data suitable for sending to non-&PostScript; devices.</para> -<glossseealso otherterm="gloss-postscript" ->&PostScript;</glossseealso -> <glossseealso otherterm="gloss-rip" ->RIP</glossseealso -> </glossdef> + <glossterm>Ghostscript</glossterm> + <glossdef><para>Ghostscript is a &PostScript; Raster Image Processor (RIP) in software, originally developed by L. Peter Deutsch. There is always a <acronym>GPL</acronym> version of Ghostscript available for free usage and distribution (mostly 1 year old) while the current version is commercially sold under another licence. Ghostscript is widely used inside the Linux and &UNIX; world for transforming &PostScript; into raster data suitable for sending to non-&PostScript; devices.</para> +<glossseealso otherterm="gloss-postscript">&PostScript;</glossseealso> <glossseealso otherterm="gloss-rip">RIP</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-gimpprint"> - <glossterm ->Gimp-Print</glossterm> - <glossdef -><para ->Contrary to its name, Gimp-Print is no longer just the plugin to be used for printing from the popular Gimp program -- its codebase can also serve to be compiled into... *...a set of PPDs and associated filters that integrate seamlessly into &CUPS;, supporting around 130 different printer models, providing photographic output quality in many cases; *...a Ghostscript filter that can be used with any other program that needs a software-RIP; *...a library that can be used by other software applications in need of rasterising functions. </para> -<glossseealso otherterm="gloss-lexmark" ->Lexmark Drivers</glossseealso -> <glossseealso otherterm="gloss-rip" ->RIP</glossseealso -> <glossseealso otherterm="gloss-ghostscript" ->Ghostscript</glossseealso -> </glossdef> + <glossterm>Gimp-Print</glossterm> + <glossdef><para>Contrary to its name, Gimp-Print is no longer just the plugin to be used for printing from the popular Gimp program -- its codebase can also serve to be compiled into... *...a set of PPDs and associated filters that integrate seamlessly into &CUPS;, supporting around 130 different printer models, providing photographic output quality in many cases; *...a Ghostscript filter that can be used with any other program that needs a software-RIP; *...a library that can be used by other software applications in need of rasterising functions. </para> +<glossseealso otherterm="gloss-lexmark">Lexmark Drivers</glossseealso> <glossseealso otherterm="gloss-rip">RIP</glossseealso> <glossseealso otherterm="gloss-ghostscript">Ghostscript</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-hp"> - <glossterm -><acronym ->&HP;</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->H</emphasis ->ewlett-<emphasis ->Packard</emphasis ->; one of the first companies to distribute their own Linux printer drivers. -- More recently, the Company has released their "HPIJS" package of drivers, including source code and a Free licence. This is the first printer manufacturer to do so. HPIJS supports most current models of HP Ink- and DeskJets. </para> + <glossterm><acronym>&HP;</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>H</emphasis>ewlett-<emphasis>Packard</emphasis>; one of the first companies to distribute their own Linux printer drivers. -- More recently, the Company has released their "HPIJS" package of drivers, including source code and a Free licence. This is the first printer manufacturer to do so. HPIJS supports most current models of HP Ink- and DeskJets. </para> </glossdef> </glossentry> <glossentry id="gloss-hpgl"> - <glossterm -><acronym ->&HP;/GL</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->&HP;</emphasis -> <emphasis ->G</emphasis ->raphical <emphasis ->L</emphasis ->anguage; a &HP; printer language mainly used for plotters; many CAD (Computer Aided Design) software programs output &HP;/GL files for printing.</para> -<glossseealso otherterm="gloss-escp" ->ESC/P</glossseealso -> <glossseealso otherterm="gloss-pcl" ->PCL</glossseealso -> <glossseealso otherterm="gloss-postscript" ->&PostScript;</glossseealso -> </glossdef> + <glossterm><acronym>&HP;/GL</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>&HP;</emphasis> <emphasis>G</emphasis>raphical <emphasis>L</emphasis>anguage; a &HP; printer language mainly used for plotters; many CAD (Computer Aided Design) software programs output &HP;/GL files for printing.</para> +<glossseealso otherterm="gloss-escp">ESC/P</glossseealso> <glossseealso otherterm="gloss-pcl">PCL</glossseealso> <glossseealso otherterm="gloss-postscript">&PostScript;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-hpjetdirectprotocol"> - <glossterm ->&HP; JetDirect Protocol</glossterm> - <glossdef -><para ->A term branded by &HP; to describe their implementation of print data transfer to the printer via an otherwise "AppSocket" or "Direct TCP/IP Printing" named protocol.</para> -<glossseealso otherterm="gloss-appsocketprotocol" ->AppSocket Protocol</glossseealso -> <glossseealso otherterm="gloss-directtcpipprinting" ->Direct TCP/IP Printing</glossseealso -> </glossdef> + <glossterm>&HP; JetDirect Protocol</glossterm> + <glossdef><para>A term branded by &HP; to describe their implementation of print data transfer to the printer via an otherwise "AppSocket" or "Direct TCP/IP Printing" named protocol.</para> +<glossseealso otherterm="gloss-appsocketprotocol">AppSocket Protocol</glossseealso> <glossseealso otherterm="gloss-directtcpipprinting">Direct TCP/IP Printing</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-ietf"> - <glossterm -><acronym ->IETF</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->I</emphasis ->nternet <emphasis ->E</emphasis ->ngineering <emphasis ->T</emphasis ->ask <emphasis ->F</emphasis ->orce; an assembly of Internet, software and hardware experts that discuss new networking technologies and very often arrive at conclusions that are regarded by many as standards. "TCP/IP" is the most famous example. IETF standards, as well as drafts, discussions, ideas and useful tutorials, are put in writing in the famous series of "RFCs", which are available to the public and included in most Linux and BSD distributions.</para> -<glossseealso otherterm="gloss-ipp" ->IPP</glossseealso -> <glossseealso otherterm="gloss-pwg" ->PWG</glossseealso -> <glossseealso otherterm="gloss-rfc" ->RFC</glossseealso -> </glossdef> + <glossterm><acronym>IETF</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>I</emphasis>nternet <emphasis>E</emphasis>ngineering <emphasis>T</emphasis>ask <emphasis>F</emphasis>orce; an assembly of Internet, software and hardware experts that discuss new networking technologies and very often arrive at conclusions that are regarded by many as standards. "TCP/IP" is the most famous example. IETF standards, as well as drafts, discussions, ideas and useful tutorials, are put in writing in the famous series of "RFCs", which are available to the public and included in most Linux and BSD distributions.</para> +<glossseealso otherterm="gloss-ipp">IPP</glossseealso> <glossseealso otherterm="gloss-pwg">PWG</glossseealso> <glossseealso otherterm="gloss-rfc">RFC</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-ipp"> - <glossterm -><acronym ->IPP</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->I</emphasis ->nternet <emphasis ->P</emphasis ->rinting <emphasis ->P</emphasis ->rotocol; defined in a series of RFCs accepted by the IETF with status "proposed standard"; was designed by the PWG. -- IPP is a completely new design for network printing, but it utilises a very well-known and proven method for the actual data transfer: HTTP 1.1! By not "re-inventing the wheel", and basing itself on an existing and robust Internet standard, IPP is able to relatively easily bolt other HTTP-compatible standard mechanisms into its framework: * Basic, Digest or Certificate authentication mechanisms; * SSL or TLS for encryption of transferred data; * LDAP for directory services (to publish data on printers, device-options, drivers, costs or also to the network; or to check for passwords while performing authentication). </para> -<glossseealso otherterm="gloss-cups" ->&CUPS;</glossseealso -> <glossseealso otherterm="gloss-pwg" ->PWG</glossseealso -> <glossseealso otherterm="gloss-ietf" ->IETF</glossseealso -> <glossseealso otherterm="gloss-rfc" ->RFC</glossseealso -> <glossseealso otherterm="gloss-tls" ->TLS</glossseealso -> </glossdef> + <glossterm><acronym>IPP</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>I</emphasis>nternet <emphasis>P</emphasis>rinting <emphasis>P</emphasis>rotocol; defined in a series of RFCs accepted by the IETF with status "proposed standard"; was designed by the PWG. -- IPP is a completely new design for network printing, but it utilises a very well-known and proven method for the actual data transfer: HTTP 1.1! By not "re-inventing the wheel", and basing itself on an existing and robust Internet standard, IPP is able to relatively easily bolt other HTTP-compatible standard mechanisms into its framework: * Basic, Digest or Certificate authentication mechanisms; * SSL or TLS for encryption of transferred data; * LDAP for directory services (to publish data on printers, device-options, drivers, costs or also to the network; or to check for passwords while performing authentication). </para> +<glossseealso otherterm="gloss-cups">&CUPS;</glossseealso> <glossseealso otherterm="gloss-pwg">PWG</glossseealso> <glossseealso otherterm="gloss-ietf">IETF</glossseealso> <glossseealso otherterm="gloss-rfc">RFC</glossseealso> <glossseealso otherterm="gloss-tls">TLS</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-tdeprint"> - <glossterm -><acronym ->TDEPrint</acronym -></glossterm> - <glossdef -><para ->The new printing functionality of &kde; since version 2.2 consists of several modules that translate the features and settings of different available print subsystems (&CUPS;, BSD-style LPR/LPD, RLPR...) into nice &kde; desktop &GUI; windows and dialogues to ease their usage. Most important for day-to-day usage is "kprinter", the new &GUI; print command. -- Note: TDEPrint does <emphasis ->not</emphasis -> implement its own spooling mechanism or its own &PostScript; processing; for this it relies on the selected <emphasis ->print subsystem</emphasis -> -- however it does add some functionality of its own on top of this foundation... </para> -<glossseealso otherterm="gloss-bsdstyleprinting" ->BSD-style printing</glossseealso -> <glossseealso otherterm="gloss-cups" ->&CUPS;</glossseealso -> <glossseealso otherterm="gloss-kprinter" ->kprinter</glossseealso -> <glossseealso otherterm="gloss-tdeprinthandbook" ->TDEPrint Handbook</glossseealso -> </glossdef> + <glossterm><acronym>TDEPrint</acronym></glossterm> + <glossdef><para>The new printing functionality of &kde; since version 2.2 consists of several modules that translate the features and settings of different available print subsystems (&CUPS;, BSD-style LPR/LPD, RLPR...) into nice &kde; desktop &GUI; windows and dialogues to ease their usage. Most important for day-to-day usage is "kprinter", the new &GUI; print command. -- Note: TDEPrint does <emphasis>not</emphasis> implement its own spooling mechanism or its own &PostScript; processing; for this it relies on the selected <emphasis>print subsystem</emphasis> -- however it does add some functionality of its own on top of this foundation... </para> +<glossseealso otherterm="gloss-bsdstyleprinting">BSD-style printing</glossseealso> <glossseealso otherterm="gloss-cups">&CUPS;</glossseealso> <glossseealso otherterm="gloss-kprinter">kprinter</glossseealso> <glossseealso otherterm="gloss-tdeprinthandbook">TDEPrint Handbook</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-tdeprinthandbook"> - <glossterm -><acronym ->TDEPrint Handbook...</acronym -></glossterm> - <glossdef -><para ->...is the name of the reference document that describes TDEPrint functions to users and administrators. You can load it into Konqueror by typing "help:/tdeprint" into the address field. The <ulink url="http://printing.kde.org/" ->TDEPrint website</ulink -> is the resource for updates to this documentation, as well as PDF versions suitable for printing it. It is authored and maintained by Kurt Pfeifle. </para> - <glossseealso otherterm="gloss-cupsfaq" ->&CUPS;-FAQ</glossseealso> + <glossterm><acronym>TDEPrint Handbook...</acronym></glossterm> + <glossdef><para>...is the name of the reference document that describes TDEPrint functions to users and administrators. You can load it into Konqueror by typing "help:/tdeprint" into the address field. The <ulink url="http://printing.kde.org/">TDEPrint website</ulink> is the resource for updates to this documentation, as well as PDF versions suitable for printing it. It is authored and maintained by Kurt Pfeifle. </para> + <glossseealso otherterm="gloss-cupsfaq">&CUPS;-FAQ</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-kprinter"> - <glossterm ->kprinter</glossterm> - <glossdef -><para -><emphasis ->kprinter</emphasis -> is the new powerful print utility that is natively used by all &kde; applications. Contrary to some common misconceptions, <emphasis ->kprinter</emphasis -> is <emphasis ->not</emphasis -> a &CUPS;-only tool, but supports different print subsystems. You can even switch to a different print subsystem "on the fly", in between two jobs, without re-configuration. Of course, due to the powerful features of &CUPS;, <emphasis ->kprinter</emphasis -> is best suited for use with a &CUPS; frontend. <emphasis ->kprinter</emphasis -> is the successor to "qtcups", which is no longer being actively maintained. It has inherited all the best features of qtcups and added several new ones. MOST IMPORTANT: you can use <emphasis ->kprinter</emphasis -> with all its features in all non-&kde; applications that allow a customized print command, like gv, Acrobat Reader, Netscape, Mozilla, Galeon, StarOffice, OpenOffice and all GNOME programs. <emphasis ->kprinter</emphasis -> can act as a "standalone" utility, started from an X-Terminal or a "Mini-CLI" to print many different files, from different folders, with different formats, in one job and simultaneously, without the need to first open the files in the applications! (File formats supported this way are &PostScript;, PDF, International and ASCII Text, as well as many different popular graphic formats, such as PNG, TIFF, JPEG, PNM, Sun RASTER, &etc;) </para> - <glossseealso otherterm="gloss-qtcups" ->QtCUPS</glossseealso> + <glossterm>kprinter</glossterm> + <glossdef><para><emphasis>kprinter</emphasis> is the new powerful print utility that is natively used by all &kde; applications. Contrary to some common misconceptions, <emphasis>kprinter</emphasis> is <emphasis>not</emphasis> a &CUPS;-only tool, but supports different print subsystems. You can even switch to a different print subsystem "on the fly", in between two jobs, without re-configuration. Of course, due to the powerful features of &CUPS;, <emphasis>kprinter</emphasis> is best suited for use with a &CUPS; frontend. <emphasis>kprinter</emphasis> is the successor to "qtcups", which is no longer being actively maintained. It has inherited all the best features of qtcups and added several new ones. MOST IMPORTANT: you can use <emphasis>kprinter</emphasis> with all its features in all non-&kde; applications that allow a customized print command, like gv, Acrobat Reader, Netscape, Mozilla, Galeon, StarOffice, OpenOffice and all GNOME programs. <emphasis>kprinter</emphasis> can act as a "standalone" utility, started from an X-Terminal or a "Mini-CLI" to print many different files, from different folders, with different formats, in one job and simultaneously, without the need to first open the files in the applications! (File formats supported this way are &PostScript;, PDF, International and ASCII Text, as well as many different popular graphic formats, such as PNG, TIFF, JPEG, PNM, Sun RASTER, &etc;) </para> + <glossseealso otherterm="gloss-qtcups">QtCUPS</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-lexmark"> - <glossterm -><acronym ->Lexmark</acronym -></glossterm> - <glossdef -><para ->was one of the first companies to distribute their own Linux printer drivers for some of their models. However, those drivers are binary only (no source code available), and therefore cannot be used to integrate into other Free printing software projects. </para> + <glossterm><acronym>Lexmark</acronym></glossterm> + <glossdef><para>was one of the first companies to distribute their own Linux printer drivers for some of their models. However, those drivers are binary only (no source code available), and therefore cannot be used to integrate into other Free printing software projects. </para> </glossdef> </glossentry> <glossentry id="gloss-linuxprintingorg"> - <glossterm ->Linuxprinting.org</glossterm> - <glossdef -><para ->Linuxprinting.org = not just for Linux; all &UNIX;-like OS-es, like *BSD and commercial Unices may find useful printing information on this site. This web site is the home for the interesting Foomatic project, that strives to develop the "Meta Print Spool and Driver Configuration Toolset" (being able to configure, through one common interface, different print subsystems and their required drivers) with the ability to transfer all queues, printers and configuration files seamlessly to another spooler without new configuration effort. -- Also, they maintain the Printing Database; a collection of driver and device information that enables everybody to find the most current information about printer models, and also generate online the configuration files for any spooler/driver/device combo known to work with one of the common Linux or &UNIX; print subsystems. </para> - <glossseealso otherterm="gloss-linuxprintingdatabase" ->Linuxprinting database</glossseealso> + <glossterm>Linuxprinting.org</glossterm> + <glossdef><para>Linuxprinting.org = not just for Linux; all &UNIX;-like OS-es, like *BSD and commercial Unices may find useful printing information on this site. This web site is the home for the interesting Foomatic project, that strives to develop the "Meta Print Spool and Driver Configuration Toolset" (being able to configure, through one common interface, different print subsystems and their required drivers) with the ability to transfer all queues, printers and configuration files seamlessly to another spooler without new configuration effort. -- Also, they maintain the Printing Database; a collection of driver and device information that enables everybody to find the most current information about printer models, and also generate online the configuration files for any spooler/driver/device combo known to work with one of the common Linux or &UNIX; print subsystems. </para> + <glossseealso otherterm="gloss-linuxprintingdatabase">Linuxprinting database</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-linuxprintingdatabase"> - <glossterm -><acronym ->Linuxprinting.org Database</acronym -></glossterm> - <glossdef -><para ->....Database containing printers and drivers that are suitable for them... ...a lot of information and documentation to be found... ...it is now also providing some tools and utilities for easing the integration of those drivers into a given system... ...the "Foomatic" family of utilities; being the toolset to make use of the database for most of the commonly used print subsystems, for generating "on the fly" working configurations for your printer model. </para> - <glossseealso otherterm="gloss-foomatic" ->Foomatic</glossseealso> + <glossterm><acronym>Linuxprinting.org Database</acronym></glossterm> + <glossdef><para>....Database containing printers and drivers that are suitable for them... ...a lot of information and documentation to be found... ...it is now also providing some tools and utilities for easing the integration of those drivers into a given system... ...the "Foomatic" family of utilities; being the toolset to make use of the database for most of the commonly used print subsystems, for generating "on the fly" working configurations for your printer model. </para> + <glossseealso otherterm="gloss-foomatic">Foomatic</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-lprlpd"> - <glossterm -><acronym ->LPR/LPD</acronym -> printing</glossterm> - <glossdef -><para ->LPR == some people translate <emphasis ->L</emphasis ->ine <emphasis ->P</emphasis ->rinting <emphasis ->R</emphasis ->equest, others: <emphasis ->L</emphasis ->ine <emphasis ->P</emphasis ->rinter <emphasis ->R</emphasis ->emote.</para> - <glossseealso otherterm="gloss-bsdstyleprinting" ->BSD-style printing</glossseealso> + <glossterm><acronym>LPR/LPD</acronym> printing</glossterm> + <glossdef><para>LPR == some people translate <emphasis>L</emphasis>ine <emphasis>P</emphasis>rinting <emphasis>R</emphasis>equest, others: <emphasis>L</emphasis>ine <emphasis>P</emphasis>rinter <emphasis>R</emphasis>emote.</para> + <glossseealso otherterm="gloss-bsdstyleprinting">BSD-style printing</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-magicfilter"> - <glossterm ->Magicfilter</glossterm> - <glossdef -><para ->Similarly to the APSfilter program, Magicfilter provides automatic file type recognition functions and, base on that, automatic file conversion to a printable format, depending on the target printer.</para> - <glossseealso otherterm="gloss-apsfilter" ->APSfilter</glossseealso> + <glossterm>Magicfilter</glossterm> + <glossdef><para>Similarly to the APSfilter program, Magicfilter provides automatic file type recognition functions and, base on that, automatic file conversion to a printable format, depending on the target printer.</para> + <glossseealso otherterm="gloss-apsfilter">APSfilter</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-mimetypes"> - <glossterm ->&MIME;-Types</glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->M</emphasis ->ultipurpose (or Multimedia) <emphasis ->I</emphasis ->nternet <emphasis ->M</emphasis ->ail <emphasis ->E</emphasis ->xtensions; &MIME;-Types were first used to allow the transport of binary data (like mail attachments containing graphics) over mail connections that were normally only transmitting ASCII characters: the data had to be encoded into an ASCII representation. Later this concept was extended to describe a data format in a platform independent, but at the same time non-ambiguous, way. From &Windows; everybody knows the .doc extensions for &Microsoft; Word files. This is handled ambiguously on the &Windows; platform: .doc extensions are also used for simple text files or for Adobe Framemaker files. And if a real Word file is renamed with a different extension, it can no longer be opened by the program. &MIME; typed files carry a recognition string with them, describing their file format based on <emphasis ->main_category/sub_category</emphasis ->. Inside IPP, print files are also described using the &MIME; type scheme. &MIME; types are registered with the IANA (Internet Assigning Numbers <emphasis ->Association</emphasis ->) to keep them unambiguous. &CUPS; has some &MIME; types of its own registered, like <emphasis ->application/vnd.cups-raster</emphasis -> (for the &CUPS;-internal raster image format). </para> -<glossseealso otherterm="gloss-cups" ->&CUPS;</glossseealso -> <glossseealso otherterm="gloss-easysoftwareproducts" ->Easy Software Products</glossseealso -> <glossseealso otherterm="gloss-espprintpro" ->ESP PrintPro</glossseealso -> <glossseealso otherterm="gloss-gimpprint" ->Gimp-Print</glossseealso -> </glossdef> + <glossterm>&MIME;-Types</glossterm> + <glossdef><para>Abbreviation for <emphasis>M</emphasis>ultipurpose (or Multimedia) <emphasis>I</emphasis>nternet <emphasis>M</emphasis>ail <emphasis>E</emphasis>xtensions; &MIME;-Types were first used to allow the transport of binary data (like mail attachments containing graphics) over mail connections that were normally only transmitting ASCII characters: the data had to be encoded into an ASCII representation. Later this concept was extended to describe a data format in a platform independent, but at the same time non-ambiguous, way. From &Windows; everybody knows the .doc extensions for &Microsoft; Word files. This is handled ambiguously on the &Windows; platform: .doc extensions are also used for simple text files or for Adobe Framemaker files. And if a real Word file is renamed with a different extension, it can no longer be opened by the program. &MIME; typed files carry a recognition string with them, describing their file format based on <emphasis>main_category/sub_category</emphasis>. Inside IPP, print files are also described using the &MIME; type scheme. &MIME; types are registered with the IANA (Internet Assigning Numbers <emphasis>Association</emphasis>) to keep them unambiguous. &CUPS; has some &MIME; types of its own registered, like <emphasis>application/vnd.cups-raster</emphasis> (for the &CUPS;-internal raster image format). </para> +<glossseealso otherterm="gloss-cups">&CUPS;</glossseealso> <glossseealso otherterm="gloss-easysoftwareproducts">Easy Software Products</glossseealso> <glossseealso otherterm="gloss-espprintpro">ESP PrintPro</glossseealso> <glossseealso otherterm="gloss-gimpprint">Gimp-Print</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-pcl"> - <glossterm -><acronym ->PCL</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->P</emphasis ->rinter <emphasis ->C</emphasis ->ontrol <emphasis ->L</emphasis ->anguage; developed by &HP;. PCL started off in version 1 as a simple command set for ASCII printing; now, in its versions PCL6 and PCL-X, it is capable of printing graphics and colour -- but outside the &Microsoft; &Windows; realm and &HP-UX; (&HP;'s own brand of &UNIX;), it is not commonly used...</para> -<glossseealso otherterm="gloss-escp" ->ESC/P</glossseealso -> <glossseealso otherterm="gloss-hpgl" ->&HP;/GL</glossseealso -> <glossseealso otherterm="gloss-pdl" ->PDL</glossseealso -> <glossseealso otherterm="gloss-postscript" ->&PostScript;</glossseealso -> </glossdef> + <glossterm><acronym>PCL</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>P</emphasis>rinter <emphasis>C</emphasis>ontrol <emphasis>L</emphasis>anguage; developed by &HP;. PCL started off in version 1 as a simple command set for ASCII printing; now, in its versions PCL6 and PCL-X, it is capable of printing graphics and colour -- but outside the &Microsoft; &Windows; realm and &HP-UX; (&HP;'s own brand of &UNIX;), it is not commonly used...</para> +<glossseealso otherterm="gloss-escp">ESC/P</glossseealso> <glossseealso otherterm="gloss-hpgl">&HP;/GL</glossseealso> <glossseealso otherterm="gloss-pdl">PDL</glossseealso> <glossseealso otherterm="gloss-postscript">&PostScript;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-pdl"> - <glossterm -><acronym ->PDL</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->P</emphasis ->age <emphasis ->D</emphasis ->escription <emphasis ->L</emphasis ->anguage; PDLs describe, in an abstract way, the graphical representation of a page. - Before it is actually transferred into toner or ink laid down on to paper, a PDL needs to be "interpreted" first. In &UNIX;, the most important PDL is &PostScript;. </para> -<glossseealso otherterm="gloss-escp" ->ESC/P</glossseealso -> <glossseealso otherterm="gloss-hpgl" ->&HP;/GL</glossseealso -> <glossseealso otherterm="gloss-pcl" ->PCL</glossseealso -> <glossseealso otherterm="gloss-postscript" ->&PostScript;</glossseealso -> </glossdef> + <glossterm><acronym>PDL</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>P</emphasis>age <emphasis>D</emphasis>escription <emphasis>L</emphasis>anguage; PDLs describe, in an abstract way, the graphical representation of a page. - Before it is actually transferred into toner or ink laid down on to paper, a PDL needs to be "interpreted" first. In &UNIX;, the most important PDL is &PostScript;. </para> +<glossseealso otherterm="gloss-escp">ESC/P</glossseealso> <glossseealso otherterm="gloss-hpgl">&HP;/GL</glossseealso> <glossseealso otherterm="gloss-pcl">PCL</glossseealso> <glossseealso otherterm="gloss-postscript">&PostScript;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-pixel"> - <glossterm ->Pixel</glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->Pic</emphasis ->ture <emphasis ->El</emphasis ->ement; this term describes the smallest part of a raster picture (either as printed on paper or as displayed on a monitor by cathode rays or LCD elements). As any graphical or image representation on those types of output devices is composed of pixels, the values of "ppi" (pixel per inch) and &dpi; (dots per inch) are one important parameter for the overall quality and resolution of an image.</para> -<glossseealso otherterm="gloss-filter" ->Filter</glossseealso -> <glossseealso otherterm="gloss-ghostscript" ->Ghostscript</glossseealso -> <glossseealso otherterm="gloss-postscript" ->&PostScript;</glossseealso -> <glossseealso otherterm="gloss-raster" ->Raster</glossseealso -> </glossdef> + <glossterm>Pixel</glossterm> + <glossdef><para>Abbreviation for <emphasis>Pic</emphasis>ture <emphasis>El</emphasis>ement; this term describes the smallest part of a raster picture (either as printed on paper or as displayed on a monitor by cathode rays or LCD elements). As any graphical or image representation on those types of output devices is composed of pixels, the values of "ppi" (pixel per inch) and &dpi; (dots per inch) are one important parameter for the overall quality and resolution of an image.</para> +<glossseealso otherterm="gloss-filter">Filter</glossseealso> <glossseealso otherterm="gloss-ghostscript">Ghostscript</glossseealso> <glossseealso otherterm="gloss-postscript">&PostScript;</glossseealso> <glossseealso otherterm="gloss-raster">Raster</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-pjl"> - <glossterm -><acronym ->PJL</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->P</emphasis ->rint <emphasis ->J</emphasis ->ob <emphasis ->L</emphasis ->anguage; developed by &HP; to control and influence default and per-job settings of a printer. It may not only be used for &HP;'s own (PCL-)printers; also many &PostScript; and other printers understand PJL commands sent to them inside a print job, or in a separate signal.</para> - <glossseealso otherterm="gloss-pcl" ->PCL</glossseealso> + <glossterm><acronym>PJL</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>P</emphasis>rint <emphasis>J</emphasis>ob <emphasis>L</emphasis>anguage; developed by &HP; to control and influence default and per-job settings of a printer. It may not only be used for &HP;'s own (PCL-)printers; also many &PostScript; and other printers understand PJL commands sent to them inside a print job, or in a separate signal.</para> + <glossseealso otherterm="gloss-pcl">PCL</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-postscript"> - <glossterm ->&PostScript;</glossterm> - <glossdef -><para ->&PostScript; (often shortened to "PS") is the de-facto standard in the &UNIX; world for printing files. It was developed by Adobe and licensed to printer manufacturers and software companies. As the &PostScript; specifications were published by Adobe, there are also "Third Party" implementations of &PostScript; generating and &PostScript; interpreting software available (one of the best-known in the Free software world being Ghostscript, a powerful PS-interpreter). </para> -<glossseealso otherterm="gloss-escp" ->ESC/P</glossseealso -> <glossseealso otherterm="gloss-hpgl" ->&HP;/GL</glossseealso -> <glossseealso otherterm="gloss-pcl" ->PCL</glossseealso -> <glossseealso otherterm="gloss-ppd" ->PPD</glossseealso -> </glossdef> + <glossterm>&PostScript;</glossterm> + <glossdef><para>&PostScript; (often shortened to "PS") is the de-facto standard in the &UNIX; world for printing files. It was developed by Adobe and licensed to printer manufacturers and software companies. As the &PostScript; specifications were published by Adobe, there are also "Third Party" implementations of &PostScript; generating and &PostScript; interpreting software available (one of the best-known in the Free software world being Ghostscript, a powerful PS-interpreter). </para> +<glossseealso otherterm="gloss-escp">ESC/P</glossseealso> <glossseealso otherterm="gloss-hpgl">&HP;/GL</glossseealso> <glossseealso otherterm="gloss-pcl">PCL</glossseealso> <glossseealso otherterm="gloss-ppd">PPD</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-ppd"> - <glossterm -><acronym ->PPD</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->P</emphasis ->ostScript <emphasis ->P</emphasis ->rinter <emphasis ->D</emphasis ->escription; PPDs are ASCII files storing all information about the special capabilities of a printer, plus definitions of the (PostScript- or PJL-) commands to call on a certain capability (like print duplexing). As the explanation of the acronym reveals, PPDs were originally only used for &PostScript; printers. &CUPS; has extended the PPD concept to all types of printers. PPDs for &PostScript; printers are provided by the printer vendors. They can be used with &CUPS; and TDEPrint to have access to the full features of any &PostScript; printer. The TDEPrint Team recommends using a PPD originally intended for use with &Microsoft; Windows NT. PPDs for non-PostScript printers <emphasis ->need</emphasis -> a companion "filter" to process the &PostScript; print files into a format digestible for the non-PostScript target device. Those PPD/filter combos are not (yet) available from the vendors. After the initiative by the &CUPS; developers to utilise PPDs, the Free Software community was creative enough to quickly come up with support for most of the currently used printer models, through PPDs and classical Ghostscript filters. But note: the printout quality varies from "hi-quality photographic output" (using Gimp-Print with most Epson inkjets) to "hardly readable" (using Foomatic-enabled Ghostscript filters for models rated as "paperweight" in the Linuxprinting.org database). </para> -<glossseealso otherterm="gloss-cups" ->&CUPS;</glossseealso -> <glossseealso otherterm="gloss-linuxprintingorg" ->Linuxprinting.org</glossseealso -> <glossseealso otherterm="gloss-postscript" ->&PostScript;</glossseealso -> </glossdef> + <glossterm><acronym>PPD</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>P</emphasis>ostScript <emphasis>P</emphasis>rinter <emphasis>D</emphasis>escription; PPDs are ASCII files storing all information about the special capabilities of a printer, plus definitions of the (PostScript- or PJL-) commands to call on a certain capability (like print duplexing). As the explanation of the acronym reveals, PPDs were originally only used for &PostScript; printers. &CUPS; has extended the PPD concept to all types of printers. PPDs for &PostScript; printers are provided by the printer vendors. They can be used with &CUPS; and TDEPrint to have access to the full features of any &PostScript; printer. The TDEPrint Team recommends using a PPD originally intended for use with &Microsoft; Windows NT. PPDs for non-PostScript printers <emphasis>need</emphasis> a companion "filter" to process the &PostScript; print files into a format digestible for the non-PostScript target device. Those PPD/filter combos are not (yet) available from the vendors. After the initiative by the &CUPS; developers to utilise PPDs, the Free Software community was creative enough to quickly come up with support for most of the currently used printer models, through PPDs and classical Ghostscript filters. But note: the printout quality varies from "hi-quality photographic output" (using Gimp-Print with most Epson inkjets) to "hardly readable" (using Foomatic-enabled Ghostscript filters for models rated as "paperweight" in the Linuxprinting.org database). </para> +<glossseealso otherterm="gloss-cups">&CUPS;</glossseealso> <glossseealso otherterm="gloss-linuxprintingorg">Linuxprinting.org</glossseealso> <glossseealso otherterm="gloss-postscript">&PostScript;</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-PPD-O-Matic"> - <glossterm ->PPD-O-Matic</glossterm> - <glossdef -><para ->PPD-O-Matic is a set of Perl scripts that run on the Linuxprinting.org web server and can be used online to generate PPDs for any printer that is known to print with Ghostscript. These PPDs can be hooked up to &CUPS;/TDEPrint, as well as used inside PPD-aware applications like StarOffice to determine all different parameters of your printjobs. It is now recommended, in most cases, to use "PPD-O-Matic" instead of the older &CUPS;-O-Matic. To generate a PPD, go to the <ulink url="http://www.linuxprinting.org/printer_list.cgi" ->printer database</ulink ->, select your printer model, follow the link to show the available Ghostscript filters for that printer, select one, click "generate" and finally save the file to your local system. Be sure to read the instructions. Make sure that your local system does indeed have Ghostscript and the filter, which you chose before generating the PPD, installed. </para> -<glossseealso otherterm="gloss-postscript" ->&PostScript;</glossseealso -> <glossseealso otherterm="gloss-cups-o-matic" ->&CUPS;-O-Matic</glossseealso -> <glossseealso otherterm="gloss-linuxprintingorg" ->Linuxprinting.org</glossseealso -> <glossseealso otherterm="gloss-foomatic" ->Foomatic</glossseealso -> </glossdef> + <glossterm>PPD-O-Matic</glossterm> + <glossdef><para>PPD-O-Matic is a set of Perl scripts that run on the Linuxprinting.org web server and can be used online to generate PPDs for any printer that is known to print with Ghostscript. These PPDs can be hooked up to &CUPS;/TDEPrint, as well as used inside PPD-aware applications like StarOffice to determine all different parameters of your printjobs. It is now recommended, in most cases, to use "PPD-O-Matic" instead of the older &CUPS;-O-Matic. To generate a PPD, go to the <ulink url="http://www.linuxprinting.org/printer_list.cgi">printer database</ulink>, select your printer model, follow the link to show the available Ghostscript filters for that printer, select one, click "generate" and finally save the file to your local system. Be sure to read the instructions. Make sure that your local system does indeed have Ghostscript and the filter, which you chose before generating the PPD, installed. </para> +<glossseealso otherterm="gloss-postscript">&PostScript;</glossseealso> <glossseealso otherterm="gloss-cups-o-matic">&CUPS;-O-Matic</glossseealso> <glossseealso otherterm="gloss-linuxprintingorg">Linuxprinting.org</glossseealso> <glossseealso otherterm="gloss-foomatic">Foomatic</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-printcap"> - <glossterm ->printcap</glossterm> - <glossdef -><para ->In BSD-style print systems, the "printcap" file holds the configuration information; the printing daemon reads this file to determine which printers are available, what filters are to be user for each, where the spooling folder is located, if there are banner pages to be used, and so on... Some applications also depend on read access to the printcap file, to obtain the names of available printers. </para> - <glossseealso otherterm="gloss-bsdstyleprinting" ->BSD-style printing</glossseealso> + <glossterm>printcap</glossterm> + <glossdef><para>In BSD-style print systems, the "printcap" file holds the configuration information; the printing daemon reads this file to determine which printers are available, what filters are to be user for each, where the spooling folder is located, if there are banner pages to be used, and so on... Some applications also depend on read access to the printcap file, to obtain the names of available printers. </para> + <glossseealso otherterm="gloss-bsdstyleprinting">BSD-style printing</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-printermib"> - <glossterm ->Printer-<acronym ->MIB</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->Printer</emphasis ->-<emphasis ->M</emphasis ->anagement <emphasis ->I</emphasis ->nformation <emphasis ->B</emphasis ->ase; the Printer-MIB defines a set of parameters that are to be stored inside the printer for access through the network. This is useful if many (in some cases, literally thousands) network printers are managed centrally with the help of SNMP (Simple Network Management Protocol).</para> -<glossseealso otherterm="gloss-pwg" ->PWG</glossseealso -> <glossseealso otherterm="gloss-snmp" ->SNMP</glossseealso -> </glossdef> + <glossterm>Printer-<acronym>MIB</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>Printer</emphasis>-<emphasis>M</emphasis>anagement <emphasis>I</emphasis>nformation <emphasis>B</emphasis>ase; the Printer-MIB defines a set of parameters that are to be stored inside the printer for access through the network. This is useful if many (in some cases, literally thousands) network printers are managed centrally with the help of SNMP (Simple Network Management Protocol).</para> +<glossseealso otherterm="gloss-pwg">PWG</glossseealso> <glossseealso otherterm="gloss-snmp">SNMP</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-pwg"> - <glossterm -><acronym ->PWG</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->P</emphasis ->rinter <emphasis ->W</emphasis ->orking <emphasis ->G</emphasis ->roup; the PWG is a loose grouping of representatives of the printer industry that has, in the past years, developed different standards in relation to network printing. These were later accepted by the IETF as RFC standards, like the "Printer-MIB" and the IPP.</para> -<glossseealso otherterm="gloss-postscript" ->&PostScript;</glossseealso -> <glossseealso otherterm="gloss-ipp" ->IPP</glossseealso -> <glossseealso otherterm="gloss-printermib" ->Printer-MIB</glossseealso -> <glossseealso otherterm="gloss-snmp" ->SNMP</glossseealso -> </glossdef> + <glossterm><acronym>PWG</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>P</emphasis>rinter <emphasis>W</emphasis>orking <emphasis>G</emphasis>roup; the PWG is a loose grouping of representatives of the printer industry that has, in the past years, developed different standards in relation to network printing. These were later accepted by the IETF as RFC standards, like the "Printer-MIB" and the IPP.</para> +<glossseealso otherterm="gloss-postscript">&PostScript;</glossseealso> <glossseealso otherterm="gloss-ipp">IPP</glossseealso> <glossseealso otherterm="gloss-printermib">Printer-MIB</glossseealso> <glossseealso otherterm="gloss-snmp">SNMP</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-printtdeioslave"> - <glossterm ->print:/ TDEIO Slave</glossterm> - <glossdef -><para ->You can use a syntax of "print:/..." to get quick access to TDEPrint resources. Typing "print:/manager" as a Konqueror URL address gives administrative access to TDEPrint. Konqueror uses &kde;'s famous "KParts" technology to achieve that. </para> -<glossseealso otherterm="gloss-ioslave" ->IO Slave</glossseealso -> <glossseealso otherterm="gloss-tdeparts" ->KParts</glossseealso -> </glossdef> + <glossterm>print:/ TDEIO Slave</glossterm> + <glossdef><para>You can use a syntax of "print:/..." to get quick access to TDEPrint resources. Typing "print:/manager" as a Konqueror URL address gives administrative access to TDEPrint. Konqueror uses &kde;'s famous "KParts" technology to achieve that. </para> +<glossseealso otherterm="gloss-ioslave">IO Slave</glossseealso> <glossseealso otherterm="gloss-tdeparts">KParts</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-printerdatabase"> - <glossterm ->Printer Database</glossterm> - <glossdef -><para ->.</para> - <glossseealso otherterm="gloss-linuxprintingdatabase" ->Linuxprinting Database</glossseealso> + <glossterm>Printer Database</glossterm> + <glossdef><para>.</para> + <glossseealso otherterm="gloss-linuxprintingdatabase">Linuxprinting Database</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-qtcups"> - <glossterm -><acronym ->Qt&CUPS;</acronym -></glossterm> - <glossdef -><para ->Qt&CUPS; and KUPS were the predecessors of TDEPrint; they are now deprecated and no longer maintained. What was good in qtcups is all inherited by "kprinter", the new TDE print dialogue (which is much improved over qtcups); what you liked about kups is now all in the TDEPrint Manager (accessible via the KDE Control Centre or via the URL "print:/manager" from Konqueror) -- with more functionality and less bugs... Its former developer, Michael Goffioul, is now the developer of TDEPrint -- a very nice and productive guy and quick bug fixer... </para> - <glossseealso otherterm="gloss-kprinter" ->kprinter</glossseealso> + <glossterm><acronym>Qt&CUPS;</acronym></glossterm> + <glossdef><para>Qt&CUPS; and KUPS were the predecessors of TDEPrint; they are now deprecated and no longer maintained. What was good in qtcups is all inherited by "kprinter", the new TDE print dialogue (which is much improved over qtcups); what you liked about kups is now all in the TDEPrint Manager (accessible via the KDE Control Centre or via the URL "print:/manager" from Konqueror) -- with more functionality and less bugs... Its former developer, Michael Goffioul, is now the developer of TDEPrint -- a very nice and productive guy and quick bug fixer... </para> + <glossseealso otherterm="gloss-kprinter">kprinter</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-raster"> - <glossterm ->Raster Image</glossterm> - <glossdef -><para ->Every picture on a physical medium is composed of a pattern of discrete dots in different colours and (maybe) sizes. This is called a "raster image". This is as opposed to a "vector image" where the graphic is described in terms of continuous curves, shades, forms and filled areas, represented by mathematical formula. Vector images normally have a smaller file size and may be scaled in size without any loss of information and quality --- but they cannot be output directly, but always have to be "rendered" or "rasterised" first to the given resolution that the output device is capable of... The rasterisation is done by a Raster Image Processor (RIP, often the Ghostscript software) or some other filtering instance.</para> -<glossseealso otherterm="gloss-pixel" ->Pixel</glossseealso -> <glossseealso otherterm="gloss-ghostscript" ->Ghostscript</glossseealso -> <glossseealso otherterm="gloss-postscript" ->&PostScript;</glossseealso -> <glossseealso otherterm="gloss-filter" ->Filter</glossseealso -> <glossseealso otherterm="gloss-rip" ->RIP</glossseealso -> </glossdef> + <glossterm>Raster Image</glossterm> + <glossdef><para>Every picture on a physical medium is composed of a pattern of discrete dots in different colours and (maybe) sizes. This is called a "raster image". This is as opposed to a "vector image" where the graphic is described in terms of continuous curves, shades, forms and filled areas, represented by mathematical formula. Vector images normally have a smaller file size and may be scaled in size without any loss of information and quality --- but they cannot be output directly, but always have to be "rendered" or "rasterised" first to the given resolution that the output device is capable of... The rasterisation is done by a Raster Image Processor (RIP, often the Ghostscript software) or some other filtering instance.</para> +<glossseealso otherterm="gloss-pixel">Pixel</glossseealso> <glossseealso otherterm="gloss-ghostscript">Ghostscript</glossseealso> <glossseealso otherterm="gloss-postscript">&PostScript;</glossseealso> <glossseealso otherterm="gloss-filter">Filter</glossseealso> <glossseealso otherterm="gloss-rip">RIP</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-rip"> - <glossterm -><acronym ->RIP</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->R</emphasis ->aster <emphasis ->I</emphasis ->mage <emphasis ->P</emphasis ->rocess(or); if used in the context of printing, "RIP" means a hardware or software instance that converts &PostScript; (or other print formats that are represented in one of the non-Raster PDLs) into a raster image format in such a way that it is acceptable for the "marking engine" of the printer. &PostScript; printers contain their own PostScript-RIPs. A RIP may or may not be located inside a printer. For many &UNIX; systems, Ghostscript is the package that provides a "RIP in software", running on the host computer, and pre-digesting the &PostScript; or other data to become ready to be sent to the printing device (hence you may perceive a "grain of truth" in the slogan "Ghostscript turns your printer into a &PostScript; machine", which of course is not correct in the true sense of the meaning).</para> -<glossseealso otherterm="gloss-filter" ->Filter</glossseealso -> <glossseealso otherterm="gloss-ghostscript" ->Ghostscript</glossseealso -> <glossseealso otherterm="gloss-postscript" ->&PostScript;</glossseealso -> <glossseealso otherterm="gloss-pdl" ->PDL</glossseealso -> <glossseealso otherterm="gloss-raster" ->Raster</glossseealso -> </glossdef> + <glossterm><acronym>RIP</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>R</emphasis>aster <emphasis>I</emphasis>mage <emphasis>P</emphasis>rocess(or); if used in the context of printing, "RIP" means a hardware or software instance that converts &PostScript; (or other print formats that are represented in one of the non-Raster PDLs) into a raster image format in such a way that it is acceptable for the "marking engine" of the printer. &PostScript; printers contain their own PostScript-RIPs. A RIP may or may not be located inside a printer. For many &UNIX; systems, Ghostscript is the package that provides a "RIP in software", running on the host computer, and pre-digesting the &PostScript; or other data to become ready to be sent to the printing device (hence you may perceive a "grain of truth" in the slogan "Ghostscript turns your printer into a &PostScript; machine", which of course is not correct in the true sense of the meaning).</para> +<glossseealso otherterm="gloss-filter">Filter</glossseealso> <glossseealso otherterm="gloss-ghostscript">Ghostscript</glossseealso> <glossseealso otherterm="gloss-postscript">&PostScript;</glossseealso> <glossseealso otherterm="gloss-pdl">PDL</glossseealso> <glossseealso otherterm="gloss-raster">Raster</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-rlpr"> - <glossterm -><acronym ->RLPR</acronym -> (Remote LPR)</glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->R</emphasis ->emote <emphasis ->L</emphasis ->ine <emphasis ->P</emphasis ->rinting <emphasis ->R</emphasis ->equest; this is a BSD-style printing system, that needs no root privileges to be installed, and no "printcap" to work: all parameters may be specified on the command line. RLPR comes in handy for many laptop users who are working in frequently changing environments. This is because it may be installed concurrently with every other printing sub system, and allows a very flexible and quick way to install a printer for direct access via LPR/LPD. TDEPrint has an "Add Printer Wizard" to make RLPR usage even easier. The kprinter command allows switching to RLPR "on the fly" at any time.</para> -<glossseealso otherterm="gloss-tdeprint" ->TDEPrint</glossseealso -> <glossseealso otherterm="gloss-kprinter" ->kprinter</glossseealso -> <glossseealso otherterm="gloss-printcap" ->printcap</glossseealso -> </glossdef> + <glossterm><acronym>RLPR</acronym> (Remote LPR)</glossterm> + <glossdef><para>Abbreviation for <emphasis>R</emphasis>emote <emphasis>L</emphasis>ine <emphasis>P</emphasis>rinting <emphasis>R</emphasis>equest; this is a BSD-style printing system, that needs no root privileges to be installed, and no "printcap" to work: all parameters may be specified on the command line. RLPR comes in handy for many laptop users who are working in frequently changing environments. This is because it may be installed concurrently with every other printing sub system, and allows a very flexible and quick way to install a printer for direct access via LPR/LPD. TDEPrint has an "Add Printer Wizard" to make RLPR usage even easier. The kprinter command allows switching to RLPR "on the fly" at any time.</para> +<glossseealso otherterm="gloss-tdeprint">TDEPrint</glossseealso> <glossseealso otherterm="gloss-kprinter">kprinter</glossseealso> <glossseealso otherterm="gloss-printcap">printcap</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-snmp"> - <glossterm -><acronym ->SNMP</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->S</emphasis ->imple <emphasis ->N</emphasis ->etwork <emphasis ->M</emphasis ->anagement <emphasis ->P</emphasis ->rotocol; SNMP is widely used to control all types of network node (Hosts, Routers, Switches, Gateways, Printers...) remotely.</para> -<glossseealso otherterm="gloss-pwg" ->PWG</glossseealso -> <glossseealso otherterm="gloss-printermib" ->Printer-MIB</glossseealso -> </glossdef> + <glossterm><acronym>SNMP</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>S</emphasis>imple <emphasis>N</emphasis>etwork <emphasis>M</emphasis>anagement <emphasis>P</emphasis>rotocol; SNMP is widely used to control all types of network node (Hosts, Routers, Switches, Gateways, Printers...) remotely.</para> +<glossseealso otherterm="gloss-pwg">PWG</glossseealso> <glossseealso otherterm="gloss-printermib">Printer-MIB</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-ssl"> - <glossterm -><acronym ->SSL(3)</acronym -> encryption</glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->S</emphasis ->ecure <emphasis ->S</emphasis ->ocket <emphasis ->L</emphasis ->ayer; <acronym ->SSL</acronym -> is a proprietary encryption method for data transfer over HTTP that was developed by Netscape. It is now being replaced by an IETF standard named TLS. </para> - <glossseealso otherterm="gloss-tls" -><acronym ->TLS</acronym -></glossseealso> + <glossterm><acronym>SSL(3)</acronym> encryption</glossterm> + <glossdef><para>Abbreviation for <emphasis>S</emphasis>ecure <emphasis>S</emphasis>ocket <emphasis>L</emphasis>ayer; <acronym>SSL</acronym> is a proprietary encryption method for data transfer over HTTP that was developed by Netscape. It is now being replaced by an IETF standard named TLS. </para> + <glossseealso otherterm="gloss-tls"><acronym>TLS</acronym></glossseealso> </glossdef> </glossentry> <glossentry id="gloss-spooling"> - <glossterm -><acronym ->SPOOL</acronym ->ing</glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->S</emphasis ->ynchronous <emphasis ->P</emphasis ->eripheral <emphasis ->O</emphasis ->perations <emphasis ->O</emphasis ->n<emphasis ->L</emphasis ->ine; <acronym ->SPOOL</acronym ->ing enables printing applications (and users) to continue their work as the job is being taken care of by a system <acronym ->daemon</acronym ->, which stores the file at a temporary location until the printer is ready to print. </para> - <glossseealso otherterm="gloss-daemon" -><acronym ->Daemon</acronym -></glossseealso> + <glossterm><acronym>SPOOL</acronym>ing</glossterm> + <glossdef><para>Abbreviation for <emphasis>S</emphasis>ynchronous <emphasis>P</emphasis>eripheral <emphasis>O</emphasis>perations <emphasis>O</emphasis>n<emphasis>L</emphasis>ine; <acronym>SPOOL</acronym>ing enables printing applications (and users) to continue their work as the job is being taken care of by a system <acronym>daemon</acronym>, which stores the file at a temporary location until the printer is ready to print. </para> + <glossseealso otherterm="gloss-daemon"><acronym>Daemon</acronym></glossseealso> </glossdef> </glossentry> <glossentry id="gloss-tls"> - <glossterm -><acronym ->TLS</acronym -> encryption</glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->T</emphasis ->ransport <emphasis ->L</emphasis ->ayer <emphasis ->S</emphasis ->ecurity; <acronym ->TLS</acronym -> is an encryption standard for data transfered over HTTP 1.1; it is defined in RFC 2246; although based on the former SSL development (from Netscape) it is not fully compatible with it. </para> - <glossseealso otherterm="gloss-ssl" -><acronym ->SSL(3)</acronym -></glossseealso> + <glossterm><acronym>TLS</acronym> encryption</glossterm> + <glossdef><para>Abbreviation for <emphasis>T</emphasis>ransport <emphasis>L</emphasis>ayer <emphasis>S</emphasis>ecurity; <acronym>TLS</acronym> is an encryption standard for data transfered over HTTP 1.1; it is defined in RFC 2246; although based on the former SSL development (from Netscape) it is not fully compatible with it. </para> + <glossseealso otherterm="gloss-ssl"><acronym>SSL(3)</acronym></glossseealso> </glossdef> </glossentry> <glossentry id="gloss-systemVstyleprinting"> - <glossterm ->System V-style printing</glossterm> - <glossdef -><para ->This is the second flavour of traditional &UNIX; printing (as opposed to BSD-style printing). It uses a different command set (lp, lpadmin,...) to BSD, but is not fundamentally different from it. However, the gap between the two is big enough to make the two incompatible, so that a BSD-client cannot simply print to a System V style print server without additional tweaking... IPP is supposed to resolve this weakness and more. </para> -<glossseealso otherterm="gloss-bsdstyleprinting" -><acronym ->BSD-style printing</acronym -></glossseealso -> <glossseealso otherterm="gloss-ipp" -><acronym ->IPP</acronym -></glossseealso -> </glossdef> + <glossterm>System V-style printing</glossterm> + <glossdef><para>This is the second flavour of traditional &UNIX; printing (as opposed to BSD-style printing). It uses a different command set (lp, lpadmin,...) to BSD, but is not fundamentally different from it. However, the gap between the two is big enough to make the two incompatible, so that a BSD-client cannot simply print to a System V style print server without additional tweaking... IPP is supposed to resolve this weakness and more. </para> +<glossseealso otherterm="gloss-bsdstyleprinting"><acronym>BSD-style printing</acronym></glossseealso> <glossseealso otherterm="gloss-ipp"><acronym>IPP</acronym></glossseealso> </glossdef> </glossentry> <glossentry id="gloss-turboprint"> - <glossterm ->TurboPrint</glossterm> - <glossdef -><para ->Shareware software providing photo quality printing for many inkjet printers. It is useful if you are unable to find a driver for your printer and may be hooked into either a traditional Ghostscript system or a modern &CUPS; system.</para> - <glossseealso otherterm="gloss-gimpprint" ->Gimp-Print</glossseealso> + <glossterm>TurboPrint</glossterm> + <glossdef><para>Shareware software providing photo quality printing for many inkjet printers. It is useful if you are unable to find a driver for your printer and may be hooked into either a traditional Ghostscript system or a modern &CUPS; system.</para> + <glossseealso otherterm="gloss-gimpprint">Gimp-Print</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-xpp"> - <glossterm -><acronym ->XPP</acronym -></glossterm> - <glossdef -><para ->Abbreviation for <emphasis ->X</emphasis -> <emphasis ->P</emphasis ->rinting <emphasis ->P</emphasis ->anel; <acronym ->XPP</acronym -> was the first Free graphical print command for &CUPS;, written by Till Kamppeter, and in some ways a model for the "kprinter" utility in &kde;.</para> + <glossterm><acronym>XPP</acronym></glossterm> + <glossdef><para>Abbreviation for <emphasis>X</emphasis> <emphasis>P</emphasis>rinting <emphasis>P</emphasis>anel; <acronym>XPP</acronym> was the first Free graphical print command for &CUPS;, written by Till Kamppeter, and in some ways a model for the "kprinter" utility in &kde;.</para> </glossdef> </glossentry> <!-- <glossentry id="gloss-1"> - <glossterm ->xxxx</glossterm> - <glossdef -><para ->.</para> - <glossseealso otherterm="gloss-1" ->xyz</glossseealso> + <glossterm>xxxx</glossterm> + <glossdef><para>.</para> + <glossseealso otherterm="gloss-1">xyz</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-3"> - <glossterm ->xxxx</glossterm> - <glossdef -><para ->.</para> - <glossseealso otherterm="gloss-1" ->xyz</glossseealso> + <glossterm>xxxx</glossterm> + <glossdef><para>.</para> + <glossseealso otherterm="gloss-1">xyz</glossseealso> </glossdef> </glossentry> <glossentry id="gloss-4"> - <glossterm ->xxxx</glossterm> - <glossdef -><para ->.</para> - <glossseealso otherterm="gloss-1" ->xyz</glossseealso> + <glossterm>xxxx</glossterm> + <glossdef><para>.</para> + <glossseealso otherterm="gloss-1">xyz</glossseealso> </glossdef> </glossentry> --> diff --git a/tde-i18n-en_GB/docs/tdebase/kate/advanced.docbook b/tde-i18n-en_GB/docs/tdebase/kate/advanced.docbook index 128a567ef87..44ef40da5df 100644 --- a/tde-i18n-en_GB/docs/tdebase/kate/advanced.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kate/advanced.docbook @@ -1,171 +1,65 @@ <chapter id="advanced-editing-tools"> <chapterinfo> <authorgroup> -<author ->&Anders.Lund; &Anders.Lund.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </chapterinfo> -<title ->Advanced Editing Tools</title> +<title>Advanced Editing Tools</title> <sect1 id="comment"> -<title ->Comment/Uncomment</title> - -<para ->The Comment and Uncomment commands, available from the <guimenu ->Tools</guimenu -> menu allow you to add or remove comment markers to the selection, or the current line if no text is selected, it comments are supported by the format of the text you are editing.</para> - -<para ->The rules for how commenting is done are defined in the syntax definitions, so if syntax highlighting is not used, commenting/uncommenting is not possible.</para> - -<para ->Some formats define single line comment markers, some multi line markers and some both. If multi line markers are not available, commenting out a selection that does not fully include its last line is not possible.</para> - -<para ->If a single line marker is available, commenting single lines is preferred where applicable, as this helps to avoid problems with nested comments.</para> - -<para ->When removing comment markers, no uncommented text should be selected. When removing multiline comment markers from a selection, any whitespace outside the comment markers is ignored.</para> - -<para -><indexterm -><primary ->comment</primary -></indexterm -> To place comment markers, use the <menuchoice -><guimenu ->Tools</guimenu -><guimenuitem ->Comment</guimenuitem -></menuchoice -> menu item or the related keyboard shortcut sequence, default is <keycombo action="simul" ->&Ctrl;<keycap ->#</keycap -></keycombo ->.</para> - -<para -><indexterm -><primary ->uncomment</primary -></indexterm -> To remove comment markers, use the <menuchoice -><guimenu ->Tools</guimenu -><guimenuitem ->Uncomment</guimenuitem -></menuchoice -> menu item or the related keyboard shortcut, default is <keycombo action="simul" ->&Ctrl;&Shift;<keycap ->#</keycap -></keycombo ->.</para> +<title>Comment/Uncomment</title> + +<para>The Comment and Uncomment commands, available from the <guimenu>Tools</guimenu> menu allow you to add or remove comment markers to the selection, or the current line if no text is selected, it comments are supported by the format of the text you are editing.</para> + +<para>The rules for how commenting is done are defined in the syntax definitions, so if syntax highlighting is not used, commenting/uncommenting is not possible.</para> + +<para>Some formats define single line comment markers, some multi line markers and some both. If multi line markers are not available, commenting out a selection that does not fully include its last line is not possible.</para> + +<para>If a single line marker is available, commenting single lines is preferred where applicable, as this helps to avoid problems with nested comments.</para> + +<para>When removing comment markers, no uncommented text should be selected. When removing multiline comment markers from a selection, any whitespace outside the comment markers is ignored.</para> + +<para><indexterm><primary>comment</primary></indexterm> To place comment markers, use the <menuchoice><guimenu>Tools</guimenu><guimenuitem>Comment</guimenuitem></menuchoice> menu item or the related keyboard shortcut sequence, default is <keycombo action="simul">&Ctrl;<keycap>#</keycap></keycombo>.</para> + +<para><indexterm><primary>uncomment</primary></indexterm> To remove comment markers, use the <menuchoice><guimenu>Tools</guimenu><guimenuitem>Uncomment</guimenuitem></menuchoice> menu item or the related keyboard shortcut, default is <keycombo action="simul">&Ctrl;&Shift;<keycap>#</keycap></keycombo>.</para> </sect1> <sect1 id="edit-command"> -<title ->Editing Command</title> - -<para ->This tool, available from the <menuchoice -><guimenu ->Tools</guimenu -><guimenuitem ->Editing Command</guimenuitem -></menuchoice -> menu item, provides access to a small set of <application ->vi</application ->/<application ->vim</application ->-like commands for editing the text. It is a no nonsense tool for advanced or experienced users, but do not let that hold you back from experiencing its powers!</para> - -<para ->Currently, the following commands are available:</para> +<title>Editing Command</title> + +<para>This tool, available from the <menuchoice><guimenu>Tools</guimenu><guimenuitem>Editing Command</guimenuitem></menuchoice> menu item, provides access to a small set of <application>vi</application>/<application>vim</application>-like commands for editing the text. It is a no nonsense tool for advanced or experienced users, but do not let that hold you back from experiencing its powers!</para> + +<para>Currently, the following commands are available:</para> <variablelist> <varlistentry> -<term -><command ->time</command -></term> +<term><command>time</command></term> <listitem> -<para ->This command will output the current time as known by your computer in the format <quote ->HH:MM:SS</quote -></para> - -<para ->To use it, launch the Editing Command Dialogue and type into the input box the word <userinput ->time</userinput -></para> +<para>This command will output the current time as known by your computer in the format <quote>HH:MM:SS</quote></para> + +<para>To use it, launch the Editing Command Dialogue and type into the input box the word <userinput>time</userinput></para> </listitem> </varlistentry> <varlistentry> -<term -><command ->char</command -></term> +<term><command>char</command></term> <listitem> -<para ->This command allows you to insert literal characters by their numerical identifier, in decimal, octal or hexadecimal form. To use it launch the Editing Command dialogue and type <userinput ->char: [number]</userinput -> in the entry box, then hit <guibutton ->OK</guibutton ->.</para -> +<para>This command allows you to insert literal characters by their numerical identifier, in decimal, octal or hexadecimal form. To use it launch the Editing Command dialogue and type <userinput>char: [number]</userinput> in the entry box, then hit <guibutton>OK</guibutton>.</para> <example> -<title -><command ->char</command -> examples</title> - -<para ->Input: <userinput ->char:234</userinput -></para> -<para ->Output: <computeroutput ->ê</computeroutput -></para> -<para ->Input: <userinput ->char:0x1234</userinput -></para> -<para ->Output: <computeroutput ->ê</computeroutput -></para> -<para ->Input: <userinput ->char:1232</userinput -></para> -<para ->Output: <computeroutput ->ê</computeroutput -></para> +<title><command>char</command> examples</title> + +<para>Input: <userinput>char:234</userinput></para> +<para>Output: <computeroutput>ê</computeroutput></para> +<para>Input: <userinput>char:0x1234</userinput></para> +<para>Output: <computeroutput>ê</computeroutput></para> +<para>Input: <userinput>char:1232</userinput></para> +<para>Output: <computeroutput>ê</computeroutput></para> </example> </listitem> @@ -175,157 +69,54 @@ <varlistentry> <term> -<indexterm -><primary ->replace, sed style</primary> -<secondary ->search, sed style</secondary -></indexterm> -<command ->s///[ig]</command -> <command ->%s///[ig]</command -></term> +<indexterm><primary>replace, sed style</primary> +<secondary>search, sed style</secondary></indexterm> +<command>s///[ig]</command> <command>%s///[ig]</command></term> <listitem> -<para ->This command does a sed-like search/replace operation on the current line, or on the whole file (<command ->%s///</command ->).</para> - -<para ->In short, the text is searched for text matching the <emphasis ->search pattern</emphasis ->, the regular expression between the first and the second slash, and when a match is found, the matching part of the text is replaced with the expression between the middle and last part of the string. Parentheses in the search pattern create <emphasis ->back references</emphasis ->, that is the command remembers which part of the match matched in the parentheses; these strings can be reused in the replace pattern, referred to as <userinput ->\1</userinput -> for the first set of parentheses, <userinput ->\2</userinput -> for the second and so on.</para> - -<para ->To search for a literal <literal ->(</literal -> or <literal ->)</literal ->, you need to <emphasis ->escape</emphasis -> it using a backslash character: <userinput ->\(\)</userinput -></para> - -<para ->If you put an <userinput ->i</userinput -> at the end of the expression, the matching will be case insensitive.</para> +<para>This command does a sed-like search/replace operation on the current line, or on the whole file (<command>%s///</command>).</para> + +<para>In short, the text is searched for text matching the <emphasis>search pattern</emphasis>, the regular expression between the first and the second slash, and when a match is found, the matching part of the text is replaced with the expression between the middle and last part of the string. Parentheses in the search pattern create <emphasis>back references</emphasis>, that is the command remembers which part of the match matched in the parentheses; these strings can be reused in the replace pattern, referred to as <userinput>\1</userinput> for the first set of parentheses, <userinput>\2</userinput> for the second and so on.</para> + +<para>To search for a literal <literal>(</literal> or <literal>)</literal>, you need to <emphasis>escape</emphasis> it using a backslash character: <userinput>\(\)</userinput></para> + +<para>If you put an <userinput>i</userinput> at the end of the expression, the matching will be case insensitive.</para> <example> -<title ->Replacing text in the current line</title> +<title>Replacing text in the current line</title> -<para ->Your friendly compiler just stopped, telling you that the class <classname ->myClass</classname -> mentioned in line 3902 in your source file is not defined.</para> +<para>Your friendly compiler just stopped, telling you that the class <classname>myClass</classname> mentioned in line 3902 in your source file is not defined.</para> -<para ->"Buckle!" you think, it is of course <classname ->MyClass</classname ->. You go to line 3902, and instead of trying to find the word in the text, you launch the Editing Command Dialogue, enter <userinput ->s/myclass/MyClass/i</userinput ->, hit the <guibutton ->OK</guibutton -> button, save the file and compile – successfully without the error.</para> +<para>"Buckle!" you think, it is of course <classname>MyClass</classname>. You go to line 3902, and instead of trying to find the word in the text, you launch the Editing Command Dialogue, enter <userinput>s/myclass/MyClass/i</userinput>, hit the <guibutton>OK</guibutton> button, save the file and compile – successfully without the error.</para> </example> <example> -<title ->Replacing text in the whole file</title> - -<para ->Imagine that you have a file, in which you mention a <quote ->Miss Jensen</quote -> several times, when someone comes in and tells you that she just got married to <quote ->Mr Jones</quote ->. You want, of course, to replace each and every occurrence of <quote ->Miss Jensen</quote -> with <quote ->Ms Jones</quote ->.</para> - -<para ->Launch the Editing Command dialogue, and type into the entry box: <userinput ->%s/Miss Jensen/Ms Jones/</userinput -> and hit return, you are done.</para> +<title>Replacing text in the whole file</title> + +<para>Imagine that you have a file, in which you mention a <quote>Miss Jensen</quote> several times, when someone comes in and tells you that she just got married to <quote>Mr Jones</quote>. You want, of course, to replace each and every occurrence of <quote>Miss Jensen</quote> with <quote>Ms Jones</quote>.</para> + +<para>Launch the Editing Command dialogue, and type into the entry box: <userinput>%s/Miss Jensen/Ms Jones/</userinput> and hit return, you are done.</para> </example> <example> -<title ->A More Advanced Example</title> - -<para ->This example makes use of <emphasis ->back references</emphasis -> as well as a <emphasis ->word class</emphasis -> (if you do not know what that is, please refer to the related documentation mentioned below).</para> - -<para ->Suppose you have the following line: <programlisting ->void MyClass::DoStringOps( String &foo, String &bar String *p, int &a, int &b )</programlisting> +<title>A More Advanced Example</title> + +<para>This example makes use of <emphasis>back references</emphasis> as well as a <emphasis>word class</emphasis> (if you do not know what that is, please refer to the related documentation mentioned below).</para> + +<para>Suppose you have the following line: <programlisting>void MyClass::DoStringOps( String &foo, String &bar String *p, int &a, int &b )</programlisting> </para> -<para ->Now you realise that this is not nice code, and decide that you want to use the <constant ->const</constant -> keyword for all <quote ->address of</quote -> arguments, those characterised by the & operator in front of the argument name. You would also like to simplify the white space, so that there is only 1 whitespace character between each word.</para> - -<para ->Launch the Editing Command Dialogue, and enter: <userinput ->s/\s+(\w+)\s+(&)/ const \1 \2/g</userinput -> and hit the <guibutton ->OK</guibutton -> button. The <userinput ->g</userinput -> at the end of the expression makes the regular expression recompile for each match to save the <emphasis ->backreferences</emphasis ->.</para> - -<para ->Output: <computeroutput ->void MyClass::DoStringOps( const String &foo, const String &bar String *p, const int &a, const int &b )</computeroutput -></para> - -<para ->Mission completed! Now, what happened? Well, we looked for some white space (<literal ->\s+</literal ->) followed by one or more alphabetic characters (<literal ->\w+</literal ->) followed by some more whitespace (<literal ->\s+</literal ->) followed by an ampersand, and in the process saved the alphabetic chunk and the ampersand for reuse in the replace operation. Then we replaced the matching part of our line with one whitespace followed by <quote ->const</quote -> followed by one whitespace followed by our saved alphabetical chunk (<literal ->\1</literal ->) followed by one whitespace followed by our saved ampersand (<literal ->\2</literal ->)</para> - -<para ->Now in some cases the alphabetical chunk was <quote ->String</quote ->, in some <quote ->int</quote ->, so using the character class <literal ->\w</literal -> and the <literal ->+</literal -> quantifier proved a valuable asset.</para> +<para>Now you realise that this is not nice code, and decide that you want to use the <constant>const</constant> keyword for all <quote>address of</quote> arguments, those characterised by the & operator in front of the argument name. You would also like to simplify the white space, so that there is only 1 whitespace character between each word.</para> + +<para>Launch the Editing Command Dialogue, and enter: <userinput>s/\s+(\w+)\s+(&)/ const \1 \2/g</userinput> and hit the <guibutton>OK</guibutton> button. The <userinput>g</userinput> at the end of the expression makes the regular expression recompile for each match to save the <emphasis>backreferences</emphasis>.</para> + +<para>Output: <computeroutput>void MyClass::DoStringOps( const String &foo, const String &bar String *p, const int &a, const int &b )</computeroutput></para> + +<para>Mission completed! Now, what happened? Well, we looked for some white space (<literal>\s+</literal>) followed by one or more alphabetic characters (<literal>\w+</literal>) followed by some more whitespace (<literal>\s+</literal>) followed by an ampersand, and in the process saved the alphabetic chunk and the ampersand for reuse in the replace operation. Then we replaced the matching part of our line with one whitespace followed by <quote>const</quote> followed by one whitespace followed by our saved alphabetical chunk (<literal>\1</literal>) followed by one whitespace followed by our saved ampersand (<literal>\2</literal>)</para> + +<para>Now in some cases the alphabetical chunk was <quote>String</quote>, in some <quote>int</quote>, so using the character class <literal>\w</literal> and the <literal>+</literal> quantifier proved a valuable asset.</para> </example> @@ -335,14 +126,7 @@ </variablelist> <warning> -<para ->This is extremely powerful, and though the actions can be undone by calling the <menuchoice -><guimenuitem ->Undo</guimenuitem -></menuchoice -> command several times (as required) I recommend you practise a bit before using this command for serious editing if you are not familiar with <application ->sed</application -> or perl regular expressions.</para> +<para>This is extremely powerful, and though the actions can be undone by calling the <menuchoice><guimenuitem>Undo</guimenuitem></menuchoice> command several times (as required) I recommend you practise a bit before using this command for serious editing if you are not familiar with <application>sed</application> or perl regular expressions.</para> </warning> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kate/configuring.docbook b/tde-i18n-en_GB/docs/tdebase/kate/configuring.docbook index e682f0c5e0d..fd370c1aba5 100644 --- a/tde-i18n-en_GB/docs/tdebase/kate/configuring.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kate/configuring.docbook @@ -1,89 +1,42 @@ <chapter id="configuring-kate"> <chapterinfo> <authorgroup> -<author -><personname -><firstname -></firstname -></personname -></author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author><personname><firstname></firstname></personname></author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </chapterinfo> -<title ->Configuring &kate;</title> +<title>Configuring &kate;</title> <sect1 id="configuring-overview"> -<title ->Overview</title> +<title>Overview</title> <para> <indexterm> -<primary ->configure</primary> -<secondary ->settings</secondary> -<tertiary ->preferences</tertiary -></indexterm> +<primary>configure</primary> +<secondary>settings</secondary> +<tertiary>preferences</tertiary></indexterm> <anchor id="find"/> <anchor id="find-again"/> <anchor id="replace"/> <anchor id="undo"/> <anchor id="redo"/> &kate; offers several means of tweaking the application to behave as desired. The most important ones are: </para> <variablelist> <varlistentry> -<term id="configure" ->The Configuration Dialogue</term> -<listitem -><para ->The main configuration tool, allowing you to configure the &kate; application, the editor component and the usage of plugins.</para -></listitem> -</varlistentry> -<varlistentry> -<term id="settings" ->The <guimenu ->Settings</guimenu -> Menu</term> -<listitem -><para ->Allows you to change often used settings, and to launch the configuration dialogues.</para -></listitem> -</varlistentry> -<varlistentry> -<term ->The <guimenu ->View</guimenu -> Menu</term> -<listitem -><para ->Allows you to split the current frame, as well as to display the icons and line numbers pane for the currently edited document.</para -></listitem> +<term id="configure">The Configuration Dialogue</term> +<listitem><para>The main configuration tool, allowing you to configure the &kate; application, the editor component and the usage of plugins.</para></listitem> +</varlistentry> +<varlistentry> +<term id="settings">The <guimenu>Settings</guimenu> Menu</term> +<listitem><para>Allows you to change often used settings, and to launch the configuration dialogues.</para></listitem> +</varlistentry> +<varlistentry> +<term>The <guimenu>View</guimenu> Menu</term> +<listitem><para>Allows you to split the current frame, as well as to display the icons and line numbers pane for the currently edited document.</para></listitem> </varlistentry> </variablelist> -<para ->The embedded &konsole; is using the configuration defined in the &kcontrolcenter;, and may be configured by clicking the <mousebutton ->right</mousebutton -> mouse button and choosing from the <guimenuitem ->Settings</guimenuitem -> sub menu.</para> +<para>The embedded &konsole; is using the configuration defined in the &kcontrolcenter;, and may be configured by clicking the <mousebutton>right</mousebutton> mouse button and choosing from the <guimenuitem>Settings</guimenuitem> sub menu.</para> </sect1> <sect1 id="configuring-kate-configdialog"> -<title ->The Main Configuration Dialogue</title> +<title>The Main Configuration Dialogue</title> <mediaobject> <imageobject> @@ -91,83 +44,42 @@ </imageobject> </mediaobject> -<para ->The &kate; configuration dialogue displays a tree of topics on the left, and a configuration page corresponding to the selected topic on the right. The tree groups the pages of the dialogue into logical groups.</para> +<para>The &kate; configuration dialogue displays a tree of topics on the left, and a configuration page corresponding to the selected topic on the right. The tree groups the pages of the dialogue into logical groups.</para> <sect2 id="config-dialog"> -<title ->The &kate; group</title> -<para ->This group contains pages to configure the main &kate; application</para> +<title>The &kate; group</title> +<para>This group contains pages to configure the main &kate; application</para> <sect3 id="config-dialog-general"> -<title ->The General Page</title> -<para ->Global Options for &kate;</para> +<title>The General Page</title> +<para>Global Options for &kate;</para> <variablelist> <varlistentry> -<term ->Application Mode</term> +<term>Application Mode</term> <listitem> -<para -><indexterm -><primary ->MDI</primary -><secondary ->SDI</secondary -></indexterm> -This group lets you choose between &kate; <acronym ->MDI</acronym -> and &kate; <acronym ->SDI</acronym -> mode, selecting the appropriate button.</para> - <para ->&kate; <acronym ->MDI</acronym -> (Multiple Document Interface), which is the default mode, makes &kate; use a single window for all open files. You can choose the document to edit from the File List (docked into the &kate; window by default) or by selecting the document from the <guimenu ->Document</guimenu -> menu.</para> -<para ->&kate; <acronym ->SDI</acronym -> (Single Document Interface) will make &kate; open each document in a window of its own, and the File List/File Selector will have a separate window.</para> - <para ->If you change this setting, you will need to restart &kate; for it to take effect.</para> +<para><indexterm><primary>MDI</primary><secondary>SDI</secondary></indexterm> +This group lets you choose between &kate; <acronym>MDI</acronym> and &kate; <acronym>SDI</acronym> mode, selecting the appropriate button.</para> + <para>&kate; <acronym>MDI</acronym> (Multiple Document Interface), which is the default mode, makes &kate; use a single window for all open files. You can choose the document to edit from the File List (docked into the &kate; window by default) or by selecting the document from the <guimenu>Document</guimenu> menu.</para> +<para>&kate; <acronym>SDI</acronym> (Single Document Interface) will make &kate; open each document in a window of its own, and the File List/File Selector will have a separate window.</para> + <para>If you change this setting, you will need to restart &kate; for it to take effect.</para> </listitem> </varlistentry> <varlistentry> -<term ->At Startup</term -> -<listitem -><para ->These options determine how and if &kate; will restore your editing session when launched after a normal shutdown (if restored by the session manager, &kate; will always attempt to restore your session as close as possible to what it was when you last used &kate;).</para> +<term>At Startup</term> +<listitem><para>These options determine how and if &kate; will restore your editing session when launched after a normal shutdown (if restored by the session manager, &kate; will always attempt to restore your session as close as possible to what it was when you last used &kate;).</para> <variablelist> <varlistentry> <term> <anchor id="config-dialog-general-reopen-files"/> -<guibutton ->Reopen Files</guibutton -></term> -<listitem -><para ->If this option is enabled, files open when you last closed &kate; will be reopened. Bookmarks will be restored, and the cursor position, icon border and line numbers settings for the last editor used with the document will be re-established</para -></listitem -> -</varlistentry> -<varlistentry> -<term -><guibutton ->Restore View Configuration</guibutton -></term> -<listitem -><para ->If this option is enabled, &kate; will attempt to restore your frames exactly as you left them.</para -></listitem> +<guibutton>Reopen Files</guibutton></term> +<listitem><para>If this option is enabled, files open when you last closed &kate; will be reopened. Bookmarks will be restored, and the cursor position, icon border and line numbers settings for the last editor used with the document will be re-established</para></listitem> +</varlistentry> +<varlistentry> +<term><guibutton>Restore View Configuration</guibutton></term> +<listitem><para>If this option is enabled, &kate; will attempt to restore your frames exactly as you left them.</para></listitem> </varlistentry> </variablelist> @@ -176,55 +88,24 @@ This group lets you choose between &kate; <acronym </varlistentry> <varlistentry> -<term -><guibutton ->Restrict to single instance</guibutton -></term> -<listitem -><para ->Enabling this means you can only have one running instance of &kate; running at any given time. If you attempt to start another one, the current instance will take over and also open files as requested. For example, if you use &kate; for displaying sources for web pages in Konqueror, they will all be opened in an existing instance of &kate; if this option is enabled.</para -></listitem> +<term><guibutton>Restrict to single instance</guibutton></term> +<listitem><para>Enabling this means you can only have one running instance of &kate; running at any given time. If you attempt to start another one, the current instance will take over and also open files as requested. For example, if you use &kate; for displaying sources for web pages in Konqueror, they will all be opened in an existing instance of &kate; if this option is enabled.</para></listitem> </varlistentry> <varlistentry> -<term -><guibutton ->Show Contents While Resizing Frames</guibutton -></term -> <listitem -><para ->If this option is enabled, the windows will be fully repainted while dragging the frame splitters. If unchecked, a so-called <quote ->rubber band</quote -> (indicating the new size of the frame) will be used instead.</para -></listitem> +<term><guibutton>Show Contents While Resizing Frames</guibutton></term> <listitem><para>If this option is enabled, the windows will be fully repainted while dragging the frame splitters. If unchecked, a so-called <quote>rubber band</quote> (indicating the new size of the frame) will be used instead.</para></listitem> </varlistentry> <varlistentry> <term> <anchor id="config-dialog-general-sync-konsole"/> -<guibutton ->Sync Konsole with Active Document</guibutton -></term> -<listitem -><para ->This will cause the built-in &konsole; to <command ->cd</command -> into the directory of the active document when launched and when a new document gets the focus. If not enabled, you have to do all your navigation in the &konsole; on your own. </para -></listitem -> -</varlistentry> - -<varlistentry> -<term -><guibutton ->Number of Recent Files</guibutton -></term> -<listitem -><para ->Unsurprisingly, this allows you to decide how long the <guimenu ->Open Recent</guimenu -> files menu should grow.</para -></listitem> +<guibutton>Sync Konsole with Active Document</guibutton></term> +<listitem><para>This will cause the built-in &konsole; to <command>cd</command> into the directory of the active document when launched and when a new document gets the focus. If not enabled, you have to do all your navigation in the &konsole; on your own. </para></listitem> +</varlistentry> + +<varlistentry> +<term><guibutton>Number of Recent Files</guibutton></term> +<listitem><para>Unsurprisingly, this allows you to decide how long the <guimenu>Open Recent</guimenu> files menu should grow.</para></listitem> </varlistentry> </variablelist> @@ -234,126 +115,83 @@ This group lets you choose between &kate; <acronym </sect2> <sect2 id="config-dialog-editor"> -<title ->The Editor Group</title> -<para ->This group contains all pages related to the editor component of &kate;</para> +<title>The Editor Group</title> +<para>This group contains all pages related to the editor component of &kate;</para> <sect3 id="config-dialog-editor-colors"> -<title ->The <guilabel ->Colours</guilabel -> Page</title -> <para ->This page allows you to change the background and selection background colours of the editor. Initially, &kate; will use the colours as set in the &kcontrolcenter; <menuchoice -><guimenu ->Look'n'Feel</guimenu -><guimenuitem ->Colours</guimenuitem -> </menuchoice -> page.</para> - -<para ->To change a colour, press the associated button and select the desired colour in the colour chooser.</para> - -<note -><para ->Choosing the background colour may render Syntax Highlighted text unreadable. You should use a light colour for the background, and a dark colour for the selection background. </para> -<para ->Otherwise, you will probably need to change the <link linkend="config-dialog-editor-highlight-default-styles" ->Default Styles</link ->.</para> +<title>The <guilabel>Colours</guilabel> Page</title> <para>This page allows you to change the background and selection background colours of the editor. Initially, &kate; will use the colours as set in the &kcontrolcenter; <menuchoice><guimenu>Look'n'Feel</guimenu><guimenuitem>Colours</guimenuitem> </menuchoice> page.</para> + +<para>To change a colour, press the associated button and select the desired colour in the colour chooser.</para> + +<note><para>Choosing the background colour may render Syntax Highlighted text unreadable. You should use a light colour for the background, and a dark colour for the selection background. </para> +<para>Otherwise, you will probably need to change the <link linkend="config-dialog-editor-highlight-default-styles">Default Styles</link>.</para> </note> </sect3> <sect3 id="config-dialog-editor-fonts"> -<title ->The Fonts Page</title -> <!-- FIXME LINKS //--> +<title>The Fonts Page</title> <!-- FIXME LINKS //--> -<para ->This page allows you to choose the default fonts for &kate;. The settings will be used for the &kwrite; and for viewing text files in &konqueror; as well.</para> +<para>This page allows you to choose the default fonts for &kate;. The settings will be used for the &kwrite; and for viewing text files in &konqueror; as well.</para> -<para ->The page presents two tabs, one for the editor font and one for the printing font. Select a tab and choose the desired font. The default is to use the &kde; global setting for fixed font.</para> +<para>The page presents two tabs, one for the editor font and one for the printing font. Select a tab and choose the desired font. The default is to use the &kde; global setting for fixed font.</para> -<tip -><para ->As it is not currently possible to use individual fonts for documents, nor to change the font for printing from the print dialogue, be careful. A fixed-width font is strongly recommended. </para -></tip> +<tip><para>As it is not currently possible to use individual fonts for documents, nor to change the font for printing from the print dialogue, be careful. A fixed-width font is strongly recommended. </para></tip> </sect3> <sect3 id="config-dialog-editor-indent"> -<title ->The Indent Page</title> -<para ->This page allows you to change the behaviour of indentation.</para> +<title>The Indent Page</title> +<para>This page allows you to change the behaviour of indentation.</para> <variablelist> -<title ->Indent Options</title> +<title>Indent Options</title> <varlistentry> <term> <anchor id="config-dialog-editor-indent-auto-indent"/> -<guibutton ->Auto indent</guibutton> +<guibutton>Auto indent</guibutton> </term> <listitem> -<para ->If checked, &kate; will automatically indent new lines equal to the previous line. If the previous line is blank, the nearest above line with contents is used.</para> +<para>If checked, &kate; will automatically indent new lines equal to the previous line. If the previous line is blank, the nearest above line with contents is used.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="config-dialog-editor-indent-indent-with-spaces"/> -<guibutton ->Indent with Spaces</guibutton> +<guibutton>Indent with Spaces</guibutton> </term> <listitem> -<para ->If checked, &kate; will indent with spaces rather than tabs.</para> +<para>If checked, &kate; will indent with spaces rather than tabs.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="config-dialog-editor-indent-backspace-key-indents"/> -<guibutton ->Backspace key indents</guibutton> +<guibutton>Backspace key indents</guibutton> </term> <listitem> -<para ->If this is checked, &kate; will unindent equal to the nearest above line with contents when you press the <keycap ->Backspace</keycap -> key if the part of the line preceding the cursor contains only whitespace.</para> +<para>If this is checked, &kate; will unindent equal to the nearest above line with contents when you press the <keycap>Backspace</keycap> key if the part of the line preceding the cursor contains only whitespace.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="config-dialog-editor-indent-tab-key-indents"/> -<guibutton ->Tab key indents</guibutton> +<guibutton>Tab key indents</guibutton> </term> <listitem> -<para ->If this is checked, &kate; will indent the current line equal to the nearest above line with content when you press the <keycap ->Tab</keycap -> key, if the part of the line preceding the cursor contains only whitespace.</para> +<para>If this is checked, &kate; will indent the current line equal to the nearest above line with content when you press the <keycap>Tab</keycap> key, if the part of the line preceding the cursor contains only whitespace.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="config-dialog-editor-indent-keep-extra-spaces"/> -<guibutton ->Keep extra spaces</guibutton> +<guibutton>Keep extra spaces</guibutton> </term> <listitem> -<para ->With this behaviour checked, &kate; will leave whitespace behind the cursor after indenting.</para> +<para>With this behaviour checked, &kate; will leave whitespace behind the cursor after indenting.</para> </listitem> </varlistentry> @@ -362,42 +200,31 @@ This group lets you choose between &kate; <acronym </sect3> <sect3 id="config-dialog-editor-select"> -<title ->The Select Page</title> +<title>The Select Page</title> -<para ->This page provides options for fine tuning the select behaviour of &kate;</para> +<para>This page provides options for fine tuning the select behaviour of &kate;</para> <variablelist> -<title ->Select Options</title> +<title>Select Options</title> <varlistentry> <term> <anchor id="config-dialog-editor-select-persistent-selections"/> -<guibutton ->Persistent Selections</guibutton> +<guibutton>Persistent Selections</guibutton> </term> <listitem> -<para ->When Persistent Selections is enabled, key input will not cause the selection to be removed/diminished.</para -> -<note -><para ->This option partly conflicts with the Overwrite Selection option. If both are enabled, pasting text or pressing any other keys than the arrow keys will cause the selection to be overwritten.</para -></note> +<para>When Persistent Selections is enabled, key input will not cause the selection to be removed/diminished.</para> +<note><para>This option partly conflicts with the Overwrite Selection option. If both are enabled, pasting text or pressing any other keys than the arrow keys will cause the selection to be overwritten.</para></note> </listitem> </varlistentry> <varlistentry> <term> <anchor id="config-dialog-editor-select-overwrite-selections"/> -<guibutton ->Overwrite Selection</guibutton> +<guibutton>Overwrite Selection</guibutton> </term> <listitem> -<para ->If this is enabled, any text insertion, whether typed or pasted will cause the selected text to be deleted and replaced with the inserted text.</para> +<para>If this is enabled, any text insertion, whether typed or pasted will cause the selected text to be deleted and replaced with the inserted text.</para> </listitem> </varlistentry> @@ -405,12 +232,10 @@ This group lets you choose between &kate; <acronym <varlistentry> <term> <anchor id="config-dialog-editor-select-mouse-autocopy"/> -<guibutton ->Mouse Autocopy</guibutton> +<guibutton>Mouse Autocopy</guibutton> </term> <listitem> -<para ->If enabled, any text selected by moving the mouse with the left button pressed will +<para>If enabled, any text selected by moving the mouse with the left button pressed will be copied to the clipboard, ready for pasting.</para> </listitem> </varlistentry> @@ -420,132 +245,81 @@ be copied to the clipboard, ready for pasting.</para> </sect3> <sect3 id="config-dialog-editor-edit"> -<title ->The Edit Page</title> -<para ->This page contains miscellaneous options for fine-tuning the behaviour of the &kate; editor component.</para> +<title>The Edit Page</title> +<para>This page contains miscellaneous options for fine-tuning the behaviour of the &kate; editor component.</para> <variablelist> -<title ->Editor Options</title> +<title>Editor Options</title> <varlistentry> <term> <anchor id="config-dialog-editor-edit-word-wrap"/> -<guibutton ->Word Wrap</guibutton> +<guibutton>Word Wrap</guibutton> </term> <listitem> -<para ->Word Wrap as used here means dynamically format the text by breaking lines at an appropriate place, rather than soft wrapping lines in the editor for easier reading.</para> -<para ->If enabled, &kate; will insert a line break as defined by the <link linkend="document-end-of-line" ->End of Line</link -> setting for the document when the line extends the length set in <link linkend="config-dialog-editor-edit-wrap-words-at" ->Wrap Words At</link -> option described below.</para> +<para>Word Wrap as used here means dynamically format the text by breaking lines at an appropriate place, rather than soft wrapping lines in the editor for easier reading.</para> +<para>If enabled, &kate; will insert a line break as defined by the <link linkend="document-end-of-line">End of Line</link> setting for the document when the line extends the length set in <link linkend="config-dialog-editor-edit-wrap-words-at">Wrap Words At</link> option described below.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="config-dialog-editor-edit-wrap-words-at"/> -<guibutton ->Wrap Words At</guibutton> +<guibutton>Wrap Words At</guibutton> </term> <listitem> -<para ->This option decides the max length of lines if the <link linkend="config-dialog-editor-edit-word-wrap" ->Word Wrap</link -> option is enabled.</para> +<para>This option decides the max length of lines if the <link linkend="config-dialog-editor-edit-word-wrap">Word Wrap</link> option is enabled.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="config-dialog-editor-edit-replace-tabs-with-spaces"/> -<guibutton ->Replace Tabs with Spaces</guibutton> +<guibutton>Replace Tabs with Spaces</guibutton> </term> <listitem> -<para ->If enabled, &kate; will replace inserted <keycap ->Tab</keycap -> characters with a number of single whitespace characters as defined in <link linkend="config-dialog-editor-edit-tab-indent-width" ->Tab Width</link ->.</para> +<para>If enabled, &kate; will replace inserted <keycap>Tab</keycap> characters with a number of single whitespace characters as defined in <link linkend="config-dialog-editor-edit-tab-indent-width">Tab Width</link>.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="config-dialog-editor-edit-remove-trailing-spaces"/> -<guibutton ->Remove trailing spaces</guibutton> +<guibutton>Remove trailing spaces</guibutton> </term> <listitem> -<para ->If enabled, &kate; will remove any whitespace at the rear end of a line each time the cursor is moved off that line.</para> +<para>If enabled, &kate; will remove any whitespace at the rear end of a line each time the cursor is moved off that line.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="config-dialog-editor-edit-tab-indent-width"/> -<guibutton ->Tab/Indent Width</guibutton> +<guibutton>Tab/Indent Width</guibutton> </term> <listitem> -<para ->Sets the tab width, which is also used to decide the amount of indentation when <link linkend="config-dialog-editor-indent-auto-indent" ->Auto Indent</link -> is enabled, or indentation is otherwise called for.</para> -<para ->Depending on the <link linkend="config-dialog-editor-indent" ->Indent</link -> settings indentation may be caused by pressing the <keycap ->Tab</keycap -> and <keycap ->Backspace</keycap -> keys, and activating the <link linkend="edit-indent" -><guimenu ->Edit</guimenu -> <guimenuitem ->Indent</guimenuitem -></link -> menu entry will call for indent as well.</para> +<para>Sets the tab width, which is also used to decide the amount of indentation when <link linkend="config-dialog-editor-indent-auto-indent">Auto Indent</link> is enabled, or indentation is otherwise called for.</para> +<para>Depending on the <link linkend="config-dialog-editor-indent">Indent</link> settings indentation may be caused by pressing the <keycap>Tab</keycap> and <keycap>Backspace</keycap> keys, and activating the <link linkend="edit-indent"><guimenu>Edit</guimenu> <guimenuitem>Indent</guimenuitem></link> menu entry will call for indent as well.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="config-dialog-editor-edit-auto-brackets"/> -<guibutton ->Auto Brackets</guibutton> +<guibutton>Auto Brackets</guibutton> </term> <listitem> -<para ->If this is enabled, &kate; will automatically insert a right bracket immediately to the right of the cursor when a left bracket is inserted from the keyboard. The supported bracket types are <keycap ->(</keycap ->, <keycap ->{</keycap ->, <keycap ->[</keycap ->and <keycap -><</keycap -></para> +<para>If this is enabled, &kate; will automatically insert a right bracket immediately to the right of the cursor when a left bracket is inserted from the keyboard. The supported bracket types are <keycap>(</keycap>, <keycap>{</keycap>, <keycap>[</keycap>and <keycap><</keycap></para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="config-dialog-editor-edit-group-undos"/> -<guibutton ->Group undos</guibutton> +<guibutton>Group undos</guibutton> </term> <listitem> -<para ->If enabled, &kate; will group any number of similar editing actions (for example typing, backspacing, pasting) in one entry in the undo history, so they can all be undone at once.</para> +<para>If enabled, &kate; will group any number of similar editing actions (for example typing, backspacing, pasting) in one entry in the undo history, so they can all be undone at once.</para> </listitem> </varlistentry> @@ -553,28 +327,20 @@ be copied to the clipboard, ready for pasting.</para> <varlistentry> <term> <anchor id="config-dialog-editor-edit-show-tabs"/> -<guibutton ->Show Tabs</guibutton> +<guibutton>Show Tabs</guibutton> </term> <listitem> -<para ->If enabled, &kate; will draw a small dot at the start of a <keycap ->Tab</keycap -> character in the editor to indicate its presence.</para> +<para>If enabled, &kate; will draw a small dot at the start of a <keycap>Tab</keycap> character in the editor to indicate its presence.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="config-dialog-editor-edit-smart-home"/> -<guibutton ->Smart Home</guibutton> +<guibutton>Smart Home</guibutton> </term> <listitem> -<para ->This will make &kate; move the cursor to the first non-whitespace character of the current line rather than to the absolute beginning, when the <keycap ->Home</keycap -> key (or other key assigned to that function) is pressed.</para> +<para>This will make &kate; move the cursor to the first non-whitespace character of the current line rather than to the absolute beginning, when the <keycap>Home</keycap> key (or other key assigned to that function) is pressed.</para> </listitem> </varlistentry> @@ -582,17 +348,11 @@ be copied to the clipboard, ready for pasting.</para> <varlistentry> <term> <anchor id="config-dialog-editor-edit-page-up-down-moves-cursor"/> -<guibutton ->Page Up/Down moves cursor</guibutton> +<guibutton>Page Up/Down moves cursor</guibutton> </term> <listitem> -<para ->If enabled, the cursor will be moved to the first/last visible -line when <keycap ->Page Up</keycap ->/<keycap ->Page Down</keycap -> (or +<para>If enabled, the cursor will be moved to the first/last visible +line when <keycap>Page Up</keycap>/<keycap>Page Down</keycap> (or other key assigned to those functions) is pressed, rather than being kept at its relative position.</para> </listitem> @@ -601,15 +361,11 @@ kept at its relative position.</para> <varlistentry> <term> <anchor id="config-dialog-editor-edit-wrap-cursor"/> -<guibutton ->Wrap Cursor</guibutton> +<guibutton>Wrap Cursor</guibutton> </term> <listitem> -<para ->If enabled, moving the cursor past the end of a line will cause it to continue to the next/previous line if any.</para> -<para ->If not enabled, the cursor cannot be moved right of the beginning of the line, but it may be moved past the end of line, and when text is inserted &kate; will automatically insert whitespace up to that position. This is sometimes very handy for programmers, for example.</para -> +<para>If enabled, moving the cursor past the end of a line will cause it to continue to the next/previous line if any.</para> +<para>If not enabled, the cursor cannot be moved right of the beginning of the line, but it may be moved past the end of line, and when text is inserted &kate; will automatically insert whitespace up to that position. This is sometimes very handy for programmers, for example.</para> </listitem> </varlistentry> @@ -618,58 +374,34 @@ kept at its relative position.</para> </sect3> <sect3 id="config-dialog-editor-keyboard"> -<title ->The Keyboard Page</title> +<title>The Keyboard Page</title> -<para ->Here you can configure the keyboard shortcuts for the internal commands of the &kate; editor component. These includes commands for moving around in the document and selecting text. For keys related to copying and pasting text, see The Configure Keys Dialogue </para> +<para>Here you can configure the keyboard shortcuts for the internal commands of the &kate; editor component. These includes commands for moving around in the document and selecting text. For keys related to copying and pasting text, see The Configure Keys Dialogue </para> -<para ->You may change the keys for a command, or add an alternate key.</para> +<para>You may change the keys for a command, or add an alternate key.</para> <procedure> -<title ->To change the key(s) for a command, follow this procedure:</title> +<title>To change the key(s) for a command, follow this procedure:</title> <step> -<para ->Select the command for which you want to configure the keys.</para> +<para>Select the command for which you want to configure the keys.</para> </step> <step> -<para ->Choose the <guibutton ->None</guibutton -> option in the pane below the list if you don't want a key for this command.</para> -<para ->Choose the <guibutton ->Default</guibutton -> option to use the default key(s) for the command</para> -<para ->Choose the <guibutton ->Custom</guibutton -> option to select a custom key for the command, or set an alternate one.</para> +<para>Choose the <guibutton>None</guibutton> option in the pane below the list if you don't want a key for this command.</para> +<para>Choose the <guibutton>Default</guibutton> option to use the default key(s) for the command</para> +<para>Choose the <guibutton>Custom</guibutton> option to select a custom key for the command, or set an alternate one.</para> </step> <step> -<para ->If you choose the <guibutton ->Custom</guibutton -> option, the key entering button at the right of the pane will be enabled. To set a key, press it. The &kde; Define Shortcut Dialogue will appear. In this dialogue:</para> +<para>If you choose the <guibutton>Custom</guibutton> option, the key entering button at the right of the pane will be enabled. To set a key, press it. The &kde; Define Shortcut Dialogue will appear. In this dialogue:</para> </step> <step> <procedure> <step> -<para ->Choose whether to set the default or alternate key. <guilabel ->Default</guilabel -> does not mean that you change the application default for this action, rather it sets the custom standard key for it.</para> +<para>Choose whether to set the default or alternate key. <guilabel>Default</guilabel> does not mean that you change the application default for this action, rather it sets the custom standard key for it.</para> </step> <step> -<para ->Press the desired key sequence, it will be visualised for you in the dialogue for your confirmation. </para> +<para>Press the desired key sequence, it will be visualised for you in the dialogue for your confirmation. </para> -<para ->If you are of an adventurous nature, try playing around with the <guibutton ->Multikey</guibutton -> option. Using it will allow you to have &Emacs;-like key sequences (one key enters a group, the next performs the action), apart from the fact that instead of just doing the job, &kde; will pop up a menu to choose from in an undefined and most likely inappropriate place. You will now be in no doubt as to whether pressing the next key in the sequence will work, or you have to type the menu accelerator (both will work).</para> +<para>If you are of an adventurous nature, try playing around with the <guibutton>Multikey</guibutton> option. Using it will allow you to have &Emacs;-like key sequences (one key enters a group, the next performs the action), apart from the fact that instead of just doing the job, &kde; will pop up a menu to choose from in an undefined and most likely inappropriate place. You will now be in no doubt as to whether pressing the next key in the sequence will work, or you have to type the menu accelerator (both will work).</para> </step> </procedure> </step> @@ -677,142 +409,77 @@ kept at its relative position.</para> </sect3> <sect3 id="config-dialog-editor-spelling"> -<title ->The Spelling Page</title> -<para ->This page allows you to configure how &tdespell; behaves with &kate;</para> +<title>The Spelling Page</title> +<para>This page allows you to configure how &tdespell; behaves with &kate;</para> </sect3> <sect3 id="config-dialog-editor-hl"> -<title ->The Highlighting Page</title> +<title>The Highlighting Page</title> -<para ->This page allows you to fine tune the colour and syntax type selection of &kate;</para> +<para>This page allows you to fine tune the colour and syntax type selection of &kate;</para> <para> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="configdialog02.png"/></imageobject> +<imageobject><imagedata format="PNG" fileref="configdialog02.png"/></imageobject> </mediaobject> </para> -<para ->For more in depth information on the syntax highlighting system, see ??</para> +<para>For more in depth information on the syntax highlighting system, see ??</para> -<para ->The page consists of two tabs, one for setting the <guibutton ->Default styles</guibutton -> and one for managing the <guibutton ->Highlight Modes</guibutton ->. Both tabs display a list of contexts in which the default colours and font are used to visualise the look of each style. The context name is painted using the current properties of the context.</para> +<para>The page consists of two tabs, one for setting the <guibutton>Default styles</guibutton> and one for managing the <guibutton>Highlight Modes</guibutton>. Both tabs display a list of contexts in which the default colours and font are used to visualise the look of each style. The context name is painted using the current properties of the context.</para> -<para ->The list has four or five columns, each with the following purpose:</para> +<para>The list has four or five columns, each with the following purpose:</para> <variablelist> <varlistentry> -<term ->Context</term> -<listitem -><para ->Displays the context name, painted using the style properties for the context.</para -></listitem> +<term>Context</term> +<listitem><para>Displays the context name, painted using the style properties for the context.</para></listitem> </varlistentry> <varlistentry> -<term ->Bold</term> -<listitem -><para ->The state of this checkbox decides if the context should be rendered using a boldface font.</para -></listitem> +<term>Bold</term> +<listitem><para>The state of this checkbox decides if the context should be rendered using a boldface font.</para></listitem> </varlistentry> <varlistentry> -<term ->Italic</term> -<listitem -><para ->The state of this checkbox decides if the context should be rendered using italic font.</para -></listitem> +<term>Italic</term> +<listitem><para>The state of this checkbox decides if the context should be rendered using italic font.</para></listitem> </varlistentry> <varlistentry> -<term ->Normal</term> -<listitem -><para ->This button displays the colour for drawing the style in normal mode, when the text is not selected that is. To change the colour, click the button.</para -></listitem> +<term>Normal</term> +<listitem><para>This button displays the colour for drawing the style in normal mode, when the text is not selected that is. To change the colour, click the button.</para></listitem> </varlistentry> <varlistentry> -<term ->Selected</term> -<listitem -><para ->This button displays the colour for drawing the style when the text is selected. To change the colour, click the button.</para -></listitem> +<term>Selected</term> +<listitem><para>This button displays the colour for drawing the style when the text is selected. To change the colour, click the button.</para></listitem> </varlistentry> <varlistentry> -<term ->Using Default</term> -<listitem -><para ->This checkbox, only available in the <guibutton ->Highlight Modes</guibutton -> tab shows if the style is using its default values. It will automatically become unchecked if you change any properties of the style. Check it to reset a style to using defaults.</para -></listitem -> +<term>Using Default</term> +<listitem><para>This checkbox, only available in the <guibutton>Highlight Modes</guibutton> tab shows if the style is using its default values. It will automatically become unchecked if you change any properties of the style. Check it to reset a style to using defaults.</para></listitem> </varlistentry> </variablelist> <sect4 id="config-dialog-editor-highlight-default-styles"> -<title ->The Default Styles Tab</title> -<para ->To change any of the default styles, set its properties as desired.</para> +<title>The Default Styles Tab</title> +<para>To change any of the default styles, set its properties as desired.</para> </sect4> <sect4 id="config-dialog-editor-highlight-highlight-modes"> -<title ->The Highlight Modes Tab</title -> - -<para -><indexterm -><primary ->syntax highlighting, configuring</primary -></indexterm -> Here you can change the most important properties of each available highlight mode. First, use the <guibutton ->Highlight</guibutton -> dropdown to choose a mode to work on.</para -> <para ->Highlight modes are initially chosen based on the &MIME; type and extension of the file. To change the list for the current selection, edit the <guibutton ->File Extensions</guibutton -> and <guibutton ->Mime Types</guibutton -> entries. Alternatively, press the wizard button to the right of the <guibutton ->Mime Types</guibutton -> entry. This will show a dialogue displaying all available &MIME; types to choose from. Using it will edit the &MIME; types as well as the file extensions.</para> +<title>The Highlight Modes Tab</title> + +<para><indexterm><primary>syntax highlighting, configuring</primary></indexterm> Here you can change the most important properties of each available highlight mode. First, use the <guibutton>Highlight</guibutton> dropdown to choose a mode to work on.</para> <para>Highlight modes are initially chosen based on the &MIME; type and extension of the file. To change the list for the current selection, edit the <guibutton>File Extensions</guibutton> and <guibutton>Mime Types</guibutton> entries. Alternatively, press the wizard button to the right of the <guibutton>Mime Types</guibutton> entry. This will show a dialogue displaying all available &MIME; types to choose from. Using it will edit the &MIME; types as well as the file extensions.</para> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="mimetypechooser.png"/></imageobject> +<imageobject><imagedata format="PNG" fileref="mimetypechooser.png"/></imageobject> </mediaobject> -<para ->The &MIME; type chooser dialogue displays a tree of available &MIME; types, with a description and the patterns for the &MIME; type. To include a &MIME; type, check the box beside it. </para> +<para>The &MIME; type chooser dialogue displays a tree of available &MIME; types, with a description and the patterns for the &MIME; type. To include a &MIME; type, check the box beside it. </para> -<para ->You can change the style properties of any context as described above.</para -> +<para>You can change the style properties of any context as described above.</para> -<para ->At the bottom of the tab, below the highlight properties, you see a button labelled <guibutton ->Download</guibutton ->. Pressing it will attempt to connect to the &kate; website and fetch a list of available syntax highlight modes which you can update or add.</para> +<para>At the bottom of the tab, below the highlight properties, you see a button labelled <guibutton>Download</guibutton>. Pressing it will attempt to connect to the &kate; website and fetch a list of available syntax highlight modes which you can update or add.</para> </sect4> @@ -821,41 +488,20 @@ kept at its relative position.</para> </sect2> <sect2 id="config-dialog-plugins"> -<title ->The Plugins Group</title -> +<title>The Plugins Group</title> -<para -><indexterm -><primary ->plugins, configuring</primary -></indexterm -> This group contains pages related to plugins. Apart from the Manager configuration page, some plugins provide individual configuration options. For information on these, see the documentation for the individual plugins.</para> +<para><indexterm><primary>plugins, configuring</primary></indexterm> This group contains pages related to plugins. Apart from the Manager configuration page, some plugins provide individual configuration options. For information on these, see the documentation for the individual plugins.</para> <sect3 id="config-dialog-plugins-manager"> -<title ->The Plugin Manager Page</title -> - -<para ->This page provides the means of loading/unloading plugins, and minimal information about individual plugins.</para> - -<para ->To load an unloaded plugin, select it in the <guibutton ->Available Plugins</guibutton -> pane and use the arrow buttons to move it to the <guibutton ->Loaded Plugins</guibutton -> pane.</para> - -<para ->To unload a loaded plugin, select it in the <guibutton ->Loaded Plugins</guibutton -> pane and use the arrow buttons to move it to the <guibutton ->Available buttons</guibutton -> pane.</para> - -<para ->To view a minimal description and information about a plugin, select it and the information will be available below the lists.</para> +<title>The Plugin Manager Page</title> + +<para>This page provides the means of loading/unloading plugins, and minimal information about individual plugins.</para> + +<para>To load an unloaded plugin, select it in the <guibutton>Available Plugins</guibutton> pane and use the arrow buttons to move it to the <guibutton>Loaded Plugins</guibutton> pane.</para> + +<para>To unload a loaded plugin, select it in the <guibutton>Loaded Plugins</guibutton> pane and use the arrow buttons to move it to the <guibutton>Available buttons</guibutton> pane.</para> + +<para>To view a minimal description and information about a plugin, select it and the information will be available below the lists.</para> </sect3> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kate/fundamentals.docbook b/tde-i18n-en_GB/docs/tdebase/kate/fundamentals.docbook index bf0979d4aa6..a73127b55e1 100644 --- a/tde-i18n-en_GB/docs/tdebase/kate/fundamentals.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kate/fundamentals.docbook @@ -1,226 +1,95 @@ <chapter id="fundamentals"> <chapterinfo> <authorgroup> -<author -><personname -><firstname -></firstname -></personname -></author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author><personname><firstname></firstname></personname></author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </chapterinfo> -<title ->The Fundamentals</title> +<title>The Fundamentals</title> -<para ->If you have ever used a text editor, you will have no problem using &kate;. In the next two sections, <link linkend="starting-kate" ->Starting &kate; </link -> and in <link linkend="working-with-kate" ->Working with &kate;</link ->, we'll show you everything you need to get up and running quickly. </para> +<para>If you have ever used a text editor, you will have no problem using &kate;. In the next two sections, <link linkend="starting-kate">Starting &kate; </link> and in <link linkend="working-with-kate">Working with &kate;</link>, we'll show you everything you need to get up and running quickly. </para> <sect1 id="starting-kate"> -<title ->Starting &kate;</title> +<title>Starting &kate;</title> -<para ->You can start &kate; from the <guimenu ->TDE menu</guimenu -> or from the command line. </para> +<para>You can start &kate; from the <guimenu>TDE menu</guimenu> or from the command line. </para> <sect2 id="starting-from-the-menu"> -<title ->From the Menu</title> -<para ->Open the &kde; program menu by clicking on the <guiicon ->big K</guiicon -> icon on the toolbar at the bottom left of your screen. This will raise the <guimenu ->program menu</guimenu ->. Move your cursor up the menu to the <guimenu ->Editors</guimenu -> menu item. A list of available editors will appear. Choose <guimenuitem ->&kate;</guimenuitem ->. </para> - -<para ->Unless you configure &kate; not to, it will load the last files you edited. See <link linkend="configure" ->Configuring &kate;</link -> to learn how to toggle this feature on and off. </para> +<title>From the Menu</title> +<para>Open the &kde; program menu by clicking on the <guiicon>big K</guiicon> icon on the toolbar at the bottom left of your screen. This will raise the <guimenu>program menu</guimenu>. Move your cursor up the menu to the <guimenu>Editors</guimenu> menu item. A list of available editors will appear. Choose <guimenuitem>&kate;</guimenuitem>. </para> + +<para>Unless you configure &kate; not to, it will load the last files you edited. See <link linkend="configure">Configuring &kate;</link> to learn how to toggle this feature on and off. </para> </sect2> <sect2 id="starting-from-the-command-line"> -<title ->From the Command Line</title> +<title>From the Command Line</title> -<para ->You can start &kate; by typing its name on the command line. If you give it a file name, as in the example below, it will open or create that file. </para> +<para>You can start &kate; by typing its name on the command line. If you give it a file name, as in the example below, it will open or create that file. </para> <informalexample> -<screen -><prompt ->%</prompt -><userinput -><command ->kate</command -> <option -><replaceable ->myfile.txt</replaceable -></option -></userinput -> +<screen><prompt>%</prompt><userinput><command>kate</command> <option><replaceable>myfile.txt</replaceable></option></userinput> </screen> </informalexample> -<para ->If you have an active connection, and permission, you can take advantage of &kde;'s network transparency to open files on the internet. </para> +<para>If you have an active connection, and permission, you can take advantage of &kde;'s network transparency to open files on the internet. </para> <informalexample> -<screen -><prompt ->%</prompt -><userinput -><command ->kate</command -> <option -><replaceable ->ftp://ftp.kde.org/pub/kde/README_FIRST</replaceable -></option -></userinput -> +<screen><prompt>%</prompt><userinput><command>kate</command> <option><replaceable>ftp://ftp.kde.org/pub/kde/README_FIRST</replaceable></option></userinput> </screen> </informalexample> <sect3 id="command-line-options"> -<title ->Command Line Options</title> -<para ->&kate; accepts following command line options:</para> +<title>Command Line Options</title> +<para>&kate; accepts following command line options:</para> <variablelist> <varlistentry> -<term -><userinput -><command ->kate</command -> <option ->--help</option -></userinput -></term> +<term><userinput><command>kate</command> <option>--help</option></userinput></term> <listitem> -<para ->This lists the most basic options available at the command line. </para> +<para>This lists the most basic options available at the command line. </para> </listitem> </varlistentry> <varlistentry> -<term -><userinput -><command ->kate</command -> <option ->--help-qt</option -></userinput -></term> +<term><userinput><command>kate</command> <option>--help-qt</option></userinput></term> <listitem> -<para ->This lists the options available for changing the way &kate; interacts with &Qt;. </para> +<para>This lists the options available for changing the way &kate; interacts with &Qt;. </para> </listitem> </varlistentry> <varlistentry> -<term -><userinput -><command ->kate</command -> <option ->--help-kde</option -></userinput -></term> +<term><userinput><command>kate</command> <option>--help-kde</option></userinput></term> <listitem> -<para ->This lists the options available for changing the way &kate; interacts with &kde;. </para> +<para>This lists the options available for changing the way &kate; interacts with &kde;. </para> </listitem> </varlistentry> <varlistentry> -<term -><userinput -><command ->kate</command -> <option ->--help-all</option -></userinput -></term> +<term><userinput><command>kate</command> <option>--help-all</option></userinput></term> <listitem> -<para ->This lists all of the command line options. </para> +<para>This lists all of the command line options. </para> </listitem> </varlistentry> <varlistentry> -<term -><userinput -><command ->kate</command -> <option ->--author</option -></userinput -></term> +<term><userinput><command>kate</command> <option>--author</option></userinput></term> <listitem> -<para ->Lists &kate;'s authors in the terminal window. </para> +<para>Lists &kate;'s authors in the terminal window. </para> </listitem> </varlistentry> <varlistentry> -<term -><userinput -><command ->kate</command -> <option ->--version</option -></userinput -></term> +<term><userinput><command>kate</command> <option>--version</option></userinput></term> <listitem> -<para ->Lists version information for &Qt;, &kde;, and &kate;. Also available through <userinput -><command ->kate</command -> <option ->-V</option -></userinput -> </para> +<para>Lists version information for &Qt;, &kde;, and &kate;. Also available through <userinput><command>kate</command> <option>-V</option></userinput> </para> </listitem> </varlistentry> <varlistentry> -<term -><userinput -><command ->kate</command -> <option ->--license</option -></userinput -></term> +<term><userinput><command>kate</command> <option>--license</option></userinput></term> <listitem> -<para ->Shows licence information. </para> +<para>Shows licence information. </para> </listitem> </varlistentry> </variablelist> @@ -228,529 +97,189 @@ </sect2> <sect2 id="drag-and-drop"> -<title ->Drag and Drop</title> -<para ->&kate; uses the &kde; Drag and Drop protocol. Files may be dragged and dropped onto &kate; from the Desktop, &konqueror; or some remote ftp site opened in one of &konqueror;'s windows. </para> +<title>Drag and Drop</title> +<para>&kate; uses the &kde; Drag and Drop protocol. Files may be dragged and dropped onto &kate; from the Desktop, &konqueror; or some remote ftp site opened in one of &konqueror;'s windows. </para> </sect2> </sect1> <sect1 id="working-with-kate"> -<title ->Working with &kate;</title> -<para -><link linkend="quick-start" ->Quick Start</link -> will show you how to toggle four simple options that will let you configure some of &kate;'s more powerful features right away. <link linkend="keystroke-commands" -> Keystroke Commands</link -> lays out some of the default keystroke shortcuts for those who can't or don't want to use a mouse. </para> +<title>Working with &kate;</title> +<para><link linkend="quick-start">Quick Start</link> will show you how to toggle four simple options that will let you configure some of &kate;'s more powerful features right away. <link linkend="keystroke-commands"> Keystroke Commands</link> lays out some of the default keystroke shortcuts for those who can't or don't want to use a mouse. </para> <sect2 id="quick-start"> -<title ->Quick Start</title> +<title>Quick Start</title> -<para ->This section will describe some of the items on the <guimenu ->Settings</guimenu -> menu so that you can quickly configure &kate; to work the way you want it. </para> +<para>This section will describe some of the items on the <guimenu>Settings</guimenu> menu so that you can quickly configure &kate; to work the way you want it. </para> -<para ->When you start &kate; for the first time you'll see two windows with white backgrounds. Above the two windows is a toolbar with the usual labelled icons. And above that, a menu bar. </para> +<para>When you start &kate; for the first time you'll see two windows with white backgrounds. Above the two windows is a toolbar with the usual labelled icons. And above that, a menu bar. </para> -<para ->The left-hand window is a dockable side bar. It combines the Filelist and Fileselector windows. Switch between the two by clicking on the tabs at the top of the window. </para> +<para>The left-hand window is a dockable side bar. It combines the Filelist and Fileselector windows. Switch between the two by clicking on the tabs at the top of the window. </para> -<para ->If you've started &kate; with a file, the right-hand window will show the file you are editing and the Filelist on the side bar will show the name of the file. Use the Fileselector window to open files. </para> +<para>If you've started &kate; with a file, the right-hand window will show the file you are editing and the Filelist on the side bar will show the name of the file. Use the Fileselector window to open files. </para> -<para ->You can toggle the Filelist and Fileselector window on and off in <guimenu ->Settings</guimenu -> menu. This menu offers you your first glimpse into &kate;'s power and flexibility. In this section we'll look at four items: </para> +<para>You can toggle the Filelist and Fileselector window on and off in <guimenu>Settings</guimenu> menu. This menu offers you your first glimpse into &kate;'s power and flexibility. In this section we'll look at four items: </para> <variablelist> <varlistentry> -<term -><menuchoice -><guimenuitem ->Show Toolbar</guimenuitem -></menuchoice -></term> +<term><menuchoice><guimenuitem>Show Toolbar</guimenuitem></menuchoice></term> <listitem> -<para ->Toggles the toolbar on and off. </para> +<para>Toggles the toolbar on and off. </para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> -<guimenuitem ->Show Filelist</guimenuitem> +<guimenuitem>Show Filelist</guimenuitem> </menuchoice> </term> <listitem> -<para ->Toggles the Filelist on and off. If the Filelist/Fileselector window is not open, &kate; launches the side bar as a separate, undocked, window. To dock the window grab the two thin parallel lines above the tabs by clicking on them with your &LMB; and holding the button down. Drag the the window into &kate;'s editing window and release the &LMB; when you have positioned the Filelist/Fileselector window as you prefer. </para> +<para>Toggles the Filelist on and off. If the Filelist/Fileselector window is not open, &kate; launches the side bar as a separate, undocked, window. To dock the window grab the two thin parallel lines above the tabs by clicking on them with your &LMB; and holding the button down. Drag the the window into &kate;'s editing window and release the &LMB; when you have positioned the Filelist/Fileselector window as you prefer. </para> <tip> -<para ->If you have grabbed the two parallel lines successfully your mouse pointer will turn into two crossed arrows as you drag. </para> +<para>If you have grabbed the two parallel lines successfully your mouse pointer will turn into two crossed arrows as you drag. </para> </tip> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenuitem ->Show Fileselector</guimenuitem -></menuchoice -></term> +<term><menuchoice><guimenuitem>Show Fileselector</guimenuitem></menuchoice></term> <listitem> -<para ->Toggles the Fileselector on and off. This menu item is the same as <guimenuitem ->Show Filelist</guimenuitem -> with one difference. Toggling it on launches the window with the Fileselector on top. </para> +<para>Toggles the Fileselector on and off. This menu item is the same as <guimenuitem>Show Filelist</guimenuitem> with one difference. Toggling it on launches the window with the Fileselector on top. </para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenuitem ->Show Console</guimenuitem -></menuchoice -></term> +<term><menuchoice><guimenuitem>Show Console</guimenuitem></menuchoice></term> <listitem> -<para ->Toggles a console emulator on and off at the bottom of &kate;'s window. In other words, it gives you a command line within the application. </para> +<para>Toggles a console emulator on and off at the bottom of &kate;'s window. In other words, it gives you a command line within the application. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="keystroke-commands"> -<title ->Keystroke Commands</title> +<title>Keystroke Commands</title> -<para ->Many of &kate;'s keystroke commands (shortcuts) are configurable by way of the <link linkend="settings" ->Settings</link -> menu. By default &kate; honours the following key bindings. </para> +<para>Many of &kate;'s keystroke commands (shortcuts) are configurable by way of the <link linkend="settings">Settings</link> menu. By default &kate; honours the following key bindings. </para> <informaltable> <tgroup cols="2"> <tbody> -<row -><entry -><para -><keycap ->Insert</keycap -></para -></entry> -<entry -><para ->Toggle between Insert and Overwrite mode. When in insert mode the editor will add any typed characters to the text and push any previously typed 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><entry><para><keycap>Insert</keycap></para></entry> +<entry><para>Toggle between Insert and Overwrite mode. When in insert mode the editor will add any typed characters to the text and push any previously typed 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 -><keycap ->Left Arrow</keycap -></keycombo -></para -></entry> -<entry -><para ->Move the cursor one character to the left </para -></entry> +<entry><para><keycombo><keycap>Left Arrow</keycap></keycombo></para></entry> +<entry><para>Move the cursor one character to the left </para></entry> </row> <row> -<entry -><para -><keycombo -><keycap ->Right Arrow</keycap -></keycombo -></para -></entry> -<entry -><para ->Move the cursor one character to the right </para -></entry> +<entry><para><keycombo><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> +<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> +<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> +<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" -><keycap ->Page Down</keycap -></keycombo -></para -></entry> -<entry -><para ->Move the cursor down one page </para -></entry> +<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" -><keycap ->Backspace</keycap -></keycombo -></para -></entry> -<entry -><para ->Delete the character to the left of the cursor </para -></entry> +<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> +<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> +<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> +<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> +<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> +<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> +<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 -><link linkend="whats-this" ->What's this?</link -></para -></entry> +<entry><para><keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo></para></entry> +<entry><para><link linkend="whats-this">What's this?</link></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> +<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" -><keycap ->F3</keycap -></keycombo -></para -></entry> -<entry -><para -><link linkend="find-again" ->Find again</link -></para -></entry> +<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" ->&Ctrl;<keycap ->B</keycap -></keycombo -></para -></entry> -<entry -><para ->Set a Bookmark</para -></entry> +<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> +<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 ->N</keycap -></keycombo -></para -></entry> -<entry -><para -><link linkend="new" ->New</link -> document</para -></entry> +<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 ->P</keycap -></keycombo -></para -></entry> -<entry -><para -><link linkend="print" ->Print</link -> </para -></entry> +<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> +<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> +<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 ->Save your file.</para -></entry> +<entry><para><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></para></entry> +<entry><para>Save your file.</para></entry> </row> <row> -<entry -><para -><keycombo action="simul" ->&Ctrl;<keycap ->V</keycap -></keycombo -></para -></entry> -<entry -><para ->Paste.</para -></entry> +<entry><para><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></para></entry> +<entry><para>Paste.</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> +<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> +<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> +<entry><para><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></para></entry> +<entry><para><link linkend="redo">Redo</link></para></entry> </row> </tbody> </tgroup> @@ -761,72 +290,38 @@ <sect1 id="fundamentals-getting-help"> -<title ->Getting Help</title> +<title>Getting Help</title> <sect2> -<title ->With &kate;</title> +<title>With &kate;</title> <variablelist> <varlistentry> -<term ->This manual</term -> +<term>This manual</term> <listitem> -<para ->Offers detailed documentation on all menu commands, configuration options, tools, dialogues, plugins &etc; as well as descriptions of of the &kate; window, the editor and various concepts used in the application.</para> - -<para ->Press <keycap ->F1</keycap -> or use the <menuchoice -><guimenu ->Help</guimenu -></menuchoice -> <guisubmenu ->Contents</guisubmenu -> menu topic to view this manual.</para -></listitem> +<para>Offers detailed documentation on all menu commands, configuration options, tools, dialogues, plugins &etc; as well as descriptions of of the &kate; window, the editor and various concepts used in the application.</para> + +<para>Press <keycap>F1</keycap> or use the <menuchoice><guimenu>Help</guimenu></menuchoice> <guisubmenu>Contents</guisubmenu> menu topic to view this manual.</para></listitem> </varlistentry> <varlistentry id="whats-this"> -<term ->What's This Help</term -> +<term>What's This Help</term> <listitem> -<para ->What's This help offers immediate help with single elements of graphical windows, such as buttons or other window areas.</para> - -<para ->We strive to provide What's This help for any elements for which it makes sense. It is available throughout the configuration dialogue, and in many other dialogues as well.</para> - -<para ->To employ What's This help, press <keycombo ->&Shift;<keycap ->F1</keycap -></keycombo -> or use the <menuchoice -><guimenu ->Help</guimenu -><guimenuitem ->What's This</guimenuitem -></menuchoice -> menu item to enable What's This mode. The cursor will turn into an arrow with a question mark, and you can now click any element in the window to read the What's This help for that element, if it is available.</para> +<para>What's This help offers immediate help with single elements of graphical windows, such as buttons or other window areas.</para> + +<para>We strive to provide What's This help for any elements for which it makes sense. It is available throughout the configuration dialogue, and in many other dialogues as well.</para> + +<para>To employ What's This help, press <keycombo>&Shift;<keycap>F1</keycap></keycombo> or use the <menuchoice><guimenu>Help</guimenu><guimenuitem>What's This</guimenuitem></menuchoice> menu item to enable What's This mode. The cursor will turn into an arrow with a question mark, and you can now click any element in the window to read the What's This help for that element, if it is available.</para> </listitem> </varlistentry> <varlistentry> -<term ->Help Buttons in Dialogues</term> +<term>Help Buttons in Dialogues</term> <listitem> -<para ->Some dialogues have a <guibutton ->Help</guibutton -> Button. Pressing it will start the &khelpcenter; and open the relevant documentation.</para> +<para>Some dialogues have a <guibutton>Help</guibutton> Button. Pressing it will start the &khelpcenter; and open the relevant documentation.</para> </listitem> </varlistentry> </variablelist> @@ -834,13 +329,9 @@ </sect2> <sect2> -<title ->With Your Text Files</title> +<title>With Your Text Files</title> -<para ->&kate; does not (yet!) provide any means for reading document related documentation. Depending on the file you are editing, you may find the <link linkend="kate-mdi-tools-konsole" ->Built in &konsole;</link -> helpful for viewing related &UNIX; manual pages or info documentation, or you can use &konqueror;.</para> +<para>&kate; does not (yet!) provide any means for reading document related documentation. Depending on the file you are editing, you may find the <link linkend="kate-mdi-tools-konsole">Built in &konsole;</link> helpful for viewing related &UNIX; manual pages or info documentation, or you can use &konqueror;.</para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kate/highlighting.docbook b/tde-i18n-en_GB/docs/tdebase/kate/highlighting.docbook index cef036728ef..2785ea10b09 100644 --- a/tde-i18n-en_GB/docs/tdebase/kate/highlighting.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kate/highlighting.docbook @@ -1,191 +1,103 @@ <appendix id="highlight"> <appendixinfo> <authorgroup> -<author -><personname -><firstname -></firstname -></personname -></author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author><personname><firstname></firstname></personname></author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </appendixinfo> -<title ->Working with Syntax Highlighting</title> +<title>Working with Syntax Highlighting</title> <sect1 id="highlight-overview"> -<title ->Overview</title> +<title>Overview</title> -<para ->Syntax Highlighting is what makes the editor automatically display text in different styles/colours, depending on the function of the string in relation to the purpose of the file. In program source code for example, control statements may be rendered bold, while data types and comments get different colours from the rest of the text. This greatly enhances the readability of the text, and thus helps the author to be more efficient and productive.</para> +<para>Syntax Highlighting is what makes the editor automatically display text in different styles/colours, depending on the function of the string in relation to the purpose of the file. In program source code for example, control statements may be rendered bold, while data types and comments get different colours from the rest of the text. This greatly enhances the readability of the text, and thus helps the author to be more efficient and productive.</para> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="highlighted.png"/></imageobject> -<textobject -><phrase ->A perl function, rendered with syntax highlighting.</phrase -></textobject> -<caption -><para ->A perl function, rendered with syntax highlighting.</para> +<imageobject><imagedata format="PNG" fileref="highlighted.png"/></imageobject> +<textobject><phrase>A perl function, rendered with syntax highlighting.</phrase></textobject> +<caption><para>A perl function, rendered with syntax highlighting.</para> </caption> </mediaobject> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="unhighlighted.png"/></imageobject> -<textobject -><phrase ->The same perl function, without highlighting.</phrase -></textobject> -<caption -><para ->The same perl function, without highlighting.</para -></caption> +<imageobject><imagedata format="PNG" fileref="unhighlighted.png"/></imageobject> +<textobject><phrase>The same perl function, without highlighting.</phrase></textobject> +<caption><para>The same perl function, without highlighting.</para></caption> </mediaobject> -<para ->Of the two examples, which is easiest to read?</para> +<para>Of the two examples, which is easiest to read?</para> -<para ->&kate; comes with a flexible, configurable and capable system for doing syntax highlighting, and the standard distribution provides definitions for a wide range of programming languages, markup and scripting languages and other text file formats. In addition you can provide your own definitions in simple &XML; files.</para> +<para>&kate; comes with a flexible, configurable and capable system for doing syntax highlighting, and the standard distribution provides definitions for a wide range of programming languages, markup and scripting languages and other text file formats. In addition you can provide your own definitions in simple &XML; files.</para> -<para ->&kate; will automatically detect the right syntax rules when you open a file, based on the &MIME; Type of the file, determined by its extension, or, if it has none, the contents. Should you experience a bad choice, you can manually set the syntax to use from the <menuchoice -><guimenu ->Documents</guimenu -><guisubmenu ->Highlight Mode</guisubmenu -></menuchoice -> menu.</para> +<para>&kate; will automatically detect the right syntax rules when you open a file, based on the &MIME; Type of the file, determined by its extension, or, if it has none, the contents. Should you experience a bad choice, you can manually set the syntax to use from the <menuchoice><guimenu>Documents</guimenu><guisubmenu>Highlight Mode</guisubmenu></menuchoice> menu.</para> -<para ->The styles and colours used by each syntax highlight definition, as well as which &MIME;types it should be used for, can be configured using the <link linkend="config-dialog-editor-hl" -> Highlight</link -> page of the <link linkend="config-dialog" ->Config Dialogue</link ->.</para> +<para>The styles and colours used by each syntax highlight definition, as well as which &MIME;types it should be used for, can be configured using the <link linkend="config-dialog-editor-hl"> Highlight</link> page of the <link linkend="config-dialog">Config Dialogue</link>.</para> <note> -<para ->Syntax highlighting is there to enhance the readability of correct text, but you cannot trust it to validate your text. Marking text for syntax is difficult depending on the format you are using, and in some cases the authors of the syntax rules will be proud if 98% of text gets correctly rendered, though most often you need a rare style to see the incorrect 2%.</para> +<para>Syntax highlighting is there to enhance the readability of correct text, but you cannot trust it to validate your text. Marking text for syntax is difficult depending on the format you are using, and in some cases the authors of the syntax rules will be proud if 98% of text gets correctly rendered, though most often you need a rare style to see the incorrect 2%.</para> </note> <tip> -<para ->You can download updated or additional syntax highlight definitions from the &kate; website by clicking the <guibutton ->Download</guibutton -> button in the <link linkend="config-dialog-editor-hl" ->Highlight Page</link -> of the <link linkend="config-dialog" ->Config Dialogue</link ->.</para> +<para>You can download updated or additional syntax highlight definitions from the &kate; website by clicking the <guibutton>Download</guibutton> button in the <link linkend="config-dialog-editor-hl">Highlight Page</link> of the <link linkend="config-dialog">Config Dialogue</link>.</para> </tip> </sect1> <sect1 id="katehighlight-system"> -<title ->The &kate; Syntax Highlight System</title> +<title>The &kate; Syntax Highlight System</title> -<para ->This section will discuss the &kate; syntax highlighting mechanism in more detail. It is for you if you want to know know about it, or if you want to change or create syntax definitions.</para> +<para>This section will discuss the &kate; syntax highlighting mechanism in more detail. It is for you if you want to know know about it, or if you want to change or create syntax definitions.</para> <sect2 id="katehighlight-howitworks"> -<title ->How it Works</title> - -<para ->Whenever you open a file, one of the first things the &kate; editor does is detect which syntax definition to use for the file. While reading the text of the file, and while you type away in it, the syntax highlighting system will analyse the text using the rules defined by the syntax definition and mark in it where different contexts and styles begin and end.</para> - -<para ->When you type in the document, the new text is analysed and marked on the fly, so that if you delete a character that is marked as the beginning or end of a context, the style of surrounding text changes accordingly.</para> - -<para ->The syntax definitions used by the &kate; syntax highlighting system are &XML; files, containing <itemizedlist> -<listitem -><para ->Rules for detecting the role of text, organised into context blocks</para -></listitem> -<listitem -><para ->Keyword lists</para -></listitem> -<listitem -><para ->Style Item definitions</para -></listitem> +<title>How it Works</title> + +<para>Whenever you open a file, one of the first things the &kate; editor does is detect which syntax definition to use for the file. While reading the text of the file, and while you type away in it, the syntax highlighting system will analyse the text using the rules defined by the syntax definition and mark in it where different contexts and styles begin and end.</para> + +<para>When you type in the document, the new text is analysed and marked on the fly, so that if you delete a character that is marked as the beginning or end of a context, the style of surrounding text changes accordingly.</para> + +<para>The syntax definitions used by the &kate; syntax highlighting system are &XML; files, containing <itemizedlist> +<listitem><para>Rules for detecting the role of text, organised into context blocks</para></listitem> +<listitem><para>Keyword lists</para></listitem> +<listitem><para>Style Item definitions</para></listitem> </itemizedlist> </para> -<para ->When analysing the text, the detection rules are evaluated in the order in which they are defined, and if the beginning of the current string matches a rule, the related context is used. The start point in the text is moved to the final point at which that rule matched and a new loop of the rules begins, starting in the context set by the matched rule.</para> +<para>When analysing the text, the detection rules are evaluated in the order in which they are defined, and if the beginning of the current string matches a rule, the related context is used. The start point in the text is moved to the final point at which that rule matched and a new loop of the rules begins, starting in the context set by the matched rule.</para> </sect2> <sect2 id="highlight-system-rules"> -<title ->Rules</title> +<title>Rules</title> -<para ->The detection rules are the heart of the highlighting detection system. A rule is a string, character or <link linkend="regular-expressions" ->regular expression</link -> against which to match the text being analysed. It contains information about which style to use for the matching part of the text. It may switch the working context of the system either to an explicitly mentioned context or to the previous context used by the text.</para> +<para>The detection rules are the heart of the highlighting detection system. A rule is a string, character or <link linkend="regular-expressions">regular expression</link> against which to match the text being analysed. It contains information about which style to use for the matching part of the text. It may switch the working context of the system either to an explicitly mentioned context or to the previous context used by the text.</para> -<para ->Rules are organised in context groups. A context group is used for main text concepts within the format, for example quoted text strings or comment blocks in program source code. This ensures that the highlighting system does not need to loop through all rules when it is not necessary, and that some character sequences in the text can be treated differently depending on the current context. </para> +<para>Rules are organised in context groups. A context group is used for main text concepts within the format, for example quoted text strings or comment blocks in program source code. This ensures that the highlighting system does not need to loop through all rules when it is not necessary, and that some character sequences in the text can be treated differently depending on the current context. </para> </sect2> <sect2 id="highlight-context-styles-keywords"> -<title ->Context Styles and Keywords</title> +<title>Context Styles and Keywords</title> -<para ->In some programming languages, integer numbers are treated differently than floating point ones by the compiler (the program that converts the source code to a binary executable), and there may be characters having a special meaning within a quoted string. In such cases, it makes sense to render them differently from the surroundings so that they are easy to identify while reading the text. So even if they do not represent special contexts, they may be seen as such by the syntax highlighting system, so that they can be marked for different rendering.</para> +<para>In some programming languages, integer numbers are treated differently than floating point ones by the compiler (the program that converts the source code to a binary executable), and there may be characters having a special meaning within a quoted string. In such cases, it makes sense to render them differently from the surroundings so that they are easy to identify while reading the text. So even if they do not represent special contexts, they may be seen as such by the syntax highlighting system, so that they can be marked for different rendering.</para> -<para ->A syntax definition may contain as many styles as required to cover the concepts of the format it is used for.</para> +<para>A syntax definition may contain as many styles as required to cover the concepts of the format it is used for.</para> -<para ->In many formats, there are lists of words that represent a specific concept. For example in programming languages, the control statements is one concept, data type names another, and built in functions of the language a third. The &kate; Syntax Highlighting System can use such lists to detect and mark words in the text to emphasise concepts of the text formats.</para> +<para>In many formats, there are lists of words that represent a specific concept. For example in programming languages, the control statements is one concept, data type names another, and built in functions of the language a third. The &kate; Syntax Highlighting System can use such lists to detect and mark words in the text to emphasise concepts of the text formats.</para> </sect2> <sect2 id="kate-highlight-system-default-styles"> -<title ->Default Styles</title> +<title>Default Styles</title> -<para ->If you open a C++ source file, a &Java; source file and an <acronym ->HTML</acronym -> document in &kate;, you will see that even though the formats are different, and thus different words are chosen for special treatment, the colours used are the same. This is because &kate; has a predefined list of Default Styles, that are employed by the individual syntax definitions.</para> +<para>If you open a C++ source file, a &Java; source file and an <acronym>HTML</acronym> document in &kate;, you will see that even though the formats are different, and thus different words are chosen for special treatment, the colours used are the same. This is because &kate; has a predefined list of Default Styles, that are employed by the individual syntax definitions.</para> -<para ->This makes it easy to recognise similar concepts in different text formats. For example comments are present in almost any programming, scripting or markup language, and when they are rendered using the same style in all languages, you do not have to stop and think to identify them within the text.</para> +<para>This makes it easy to recognise similar concepts in different text formats. For example comments are present in almost any programming, scripting or markup language, and when they are rendered using the same style in all languages, you do not have to stop and think to identify them within the text.</para> <tip> -<para ->All styles in a syntax definition use one of the default styles. A few syntax definitions use more styles that there are defaults, so if you use a format often, it may be worth launching the configuration dialogue to see if some concepts are using the same style. For example there is only one default style for strings, but as the perl programming language operates with two types of strings, you can enhance the highlighting by configuring those to be slightly different.</para> +<para>All styles in a syntax definition use one of the default styles. A few syntax definitions use more styles that there are defaults, so if you use a format often, it may be worth launching the configuration dialogue to see if some concepts are using the same style. For example there is only one default style for strings, but as the perl programming language operates with two types of strings, you can enhance the highlighting by configuring those to be slightly different.</para> </tip> </sect2> @@ -193,74 +105,47 @@ </sect1> <sect1 id="katehighlight-xml-format"> -<title ->The Highlight Definition &XML; Format</title> +<title>The Highlight Definition &XML; Format</title> <sect2> -<title ->Overview</title> - -<para ->This section is an overview of the Highlight Definition &XML; format. It will describe the main components and their meaning and usage, and go into detail with the detection rules.</para> - -<para ->The formal definition, aka the <acronym ->DTD</acronym -> is stored in the file <filename ->language.dtd</filename -> which should be installed on your system in the folder <filename ->$<envar ->TDEDIR</envar ->/share/apps/kate/syntax</filename ->.</para> +<title>Overview</title> + +<para>This section is an overview of the Highlight Definition &XML; format. It will describe the main components and their meaning and usage, and go into detail with the detection rules.</para> + +<para>The formal definition, aka the <acronym>DTD</acronym> is stored in the file <filename>language.dtd</filename> which should be installed on your system in the folder <filename>$<envar>TDEDIR</envar>/share/apps/kate/syntax</filename>.</para> <variablelist> -<title ->Main components of &kate; Highlight Definitions</title> +<title>Main components of &kate; Highlight Definitions</title> <varlistentry> -<term ->The General Section</term> +<term>The General Section</term> <listitem> -<para ->The General Section contains information on the comment format of the described language, and defines whether keywords are case sensitive.</para -> +<para>The General Section contains information on the comment format of the described language, and defines whether keywords are case sensitive.</para> </listitem> </varlistentry> <varlistentry> -<term ->Highlighting</term> +<term>Highlighting</term> <listitem> -<para ->The Highlighting section contains all data required to analyse and render the text. This includes:</para> +<para>The Highlighting section contains all data required to analyse and render the text. This includes:</para> <variablelist> <varlistentry> -<term ->ItemDatas</term> -<listitem -><para ->Contains ItemData elements, each defining a style.</para -></listitem -> +<term>ItemDatas</term> +<listitem><para>Contains ItemData elements, each defining a style.</para></listitem> </varlistentry> <varlistentry> -<term ->Keyword lists</term> +<term>Keyword lists</term> <listitem> -<para ->Each list has a name, and may contain any number of items.</para> +<para>Each list has a name, and may contain any number of items.</para> </listitem> </varlistentry> <varlistentry> -<term ->Contexts</term> +<term>Contexts</term> <listitem> -<para ->Contains contexts, which again contain the syntax detection rules.</para> +<para>Contains contexts, which again contain the syntax detection rules.</para> </listitem> </varlistentry> </variablelist> @@ -275,347 +160,175 @@ </sect1> <sect1 id="kate-highlight-rules-detailled"> -<title ->Highlight Detection Rules</title> - -<para ->This section describes the syntax detection rules.</para> - -<para ->Each rule can match zero or more characters at the beginning of the string they are asked to test. If the rule matches, the matching characters are assigned the style or <emphasis ->attribute</emphasis -> defined by the rule, and a rule may ask that the current context is switched.</para> - -<para ->The <emphasis ->attribute</emphasis -> and <emphasis ->context</emphasis -> attributes are common to all rules.</para> - -<para ->A rule looks like this:</para> - -<programlisting -><RuleName attribute="(identifier)" context="(identifier|order)" [rule specific attributes] /></programlisting> - -<para ->The <emphasis ->attribute</emphasis -> identifies the style to use for matched characters by name or index, and the <emphasis ->context</emphasis -> identifies the context to use from here.</para> - -<para ->The <emphasis ->attribute</emphasis -> can be identified either by name, or by its zero-based index in the ItemDatas group.</para> - -<para ->The <emphasis ->context</emphasis -> can be identified by:</para> +<title>Highlight Detection Rules</title> + +<para>This section describes the syntax detection rules.</para> + +<para>Each rule can match zero or more characters at the beginning of the string they are asked to test. If the rule matches, the matching characters are assigned the style or <emphasis>attribute</emphasis> defined by the rule, and a rule may ask that the current context is switched.</para> + +<para>The <emphasis>attribute</emphasis> and <emphasis>context</emphasis> attributes are common to all rules.</para> + +<para>A rule looks like this:</para> + +<programlisting><RuleName attribute="(identifier)" context="(identifier|order)" [rule specific attributes] /></programlisting> + +<para>The <emphasis>attribute</emphasis> identifies the style to use for matched characters by name or index, and the <emphasis>context</emphasis> identifies the context to use from here.</para> + +<para>The <emphasis>attribute</emphasis> can be identified either by name, or by its zero-based index in the ItemDatas group.</para> + +<para>The <emphasis>context</emphasis> can be identified by:</para> <itemizedlist> <listitem> -<para ->An <emphasis ->identifier</emphasis ->, currently only its zero-based index in the contexts group.</para> +<para>An <emphasis>identifier</emphasis>, currently only its zero-based index in the contexts group.</para> </listitem> <listitem> -<para ->An <emphasis ->order</emphasis -> telling the engine to stay in the current context (<userinput ->#stay</userinput ->), or to pop back to a previous context used in the string (<userinput ->#pop</userinput ->).</para -> -<para ->To go back more steps, the #pop keyword can be repeated: <userinput ->#pop#pop#pop</userinput -></para -> +<para>An <emphasis>order</emphasis> telling the engine to stay in the current context (<userinput>#stay</userinput>), or to pop back to a previous context used in the string (<userinput>#pop</userinput>).</para> +<para>To go back more steps, the #pop keyword can be repeated: <userinput>#pop#pop#pop</userinput></para> </listitem> </itemizedlist> -<para ->Some rules can have <emphasis ->child rules</emphasis -> which are then evaluated if and only if the parent rule matched. The entire matched string will be given the attribute defined by the parent rule. A rule with child rules looks like this:</para> +<para>Some rules can have <emphasis>child rules</emphasis> which are then evaluated if and only if the parent rule matched. The entire matched string will be given the attribute defined by the parent rule. A rule with child rules looks like this:</para> -<programlisting -><RuleName (attributes)> +<programlisting><RuleName (attributes)> <ChildRuleName (attributes) /> ... </RuleName> </programlisting> -<para ->Rule specific attributes varies and are described in the following list.</para -> +<para>Rule specific attributes varies and are described in the following list.</para> <variablelist> -<title ->The Rules in Detail</title> +<title>The Rules in Detail</title> <varlistentry> -<term ->DetectChar</term> +<term>DetectChar</term> <listitem> -<para ->Detect a single specific character. Commonly used for example to find the ends of quoted strings.</para -> -<programlisting -><DetectChar char="(character)" (common attributes) /></programlisting> -<para ->The <userinput ->char</userinput -> attribute defines the character to match.</para -> +<para>Detect a single specific character. Commonly used for example to find the ends of quoted strings.</para> +<programlisting><DetectChar char="(character)" (common attributes) /></programlisting> +<para>The <userinput>char</userinput> attribute defines the character to match.</para> </listitem> </varlistentry> <varlistentry> -<term ->Detect2Chars</term> +<term>Detect2Chars</term> <listitem> -<para ->Detect two specific characters in a defined order.</para> -<programlisting -><Detect2Chars char="(character)" char1="(character)" (common attributes) /></programlisting> -<para ->The <userinput ->char</userinput -> attribute defines the first character to match, <userinput ->char1</userinput -> the second.</para> +<para>Detect two specific characters in a defined order.</para> +<programlisting><Detect2Chars char="(character)" char1="(character)" (common attributes) /></programlisting> +<para>The <userinput>char</userinput> attribute defines the first character to match, <userinput>char1</userinput> the second.</para> </listitem> </varlistentry> <varlistentry> -<term ->AnyChar</term> +<term>AnyChar</term> <listitem> -<para ->Detect one character of a set of specified characters.</para> -<programlisting -><AnyChar String="(string)" (common attributes) /></programlisting> -<para ->The <userinput ->String</userinput -> attribute defines the set of characters.</para> +<para>Detect one character of a set of specified characters.</para> +<programlisting><AnyChar String="(string)" (common attributes) /></programlisting> +<para>The <userinput>String</userinput> attribute defines the set of characters.</para> </listitem> </varlistentry> <varlistentry> -<term ->StringDetect</term> +<term>StringDetect</term> <listitem> -<para ->Detect an exact string.</para> -<programlisting -><StringDetect String="(string)" [insensitive="TRUE|FALSE;"] (common attributes) /></programlisting> -<para ->The <userinput ->String</userinput -> attribute defines the string to match. The <userinput ->insensitive</userinput -> attribute defaults to <userinput ->FALSE</userinput -> and is fed to the string comparison function. If the value is <userinput ->TRUE</userinput -> insensitive comparing is used.</para -> +<para>Detect an exact string.</para> +<programlisting><StringDetect String="(string)" [insensitive="TRUE|FALSE;"] (common attributes) /></programlisting> +<para>The <userinput>String</userinput> attribute defines the string to match. The <userinput>insensitive</userinput> attribute defaults to <userinput>FALSE</userinput> and is fed to the string comparison function. If the value is <userinput>TRUE</userinput> insensitive comparing is used.</para> </listitem> </varlistentry> <varlistentry> -<term ->RegExpr</term> +<term>RegExpr</term> <listitem> -<para ->Matches against a regular expression.</para> -<programlisting -><RegExpr String="(string)" [insensitive="TRUE|FALSE;"] [minimal="TRUE|FALSE"] (common attributes) /></programlisting> -<para ->The <userinput ->String</userinput -> attribute defines the regular expression.</para> -<para -><userinput ->insensitive</userinput -> defaults to <userinput ->FALSE</userinput -> and is fed to the regular expression engine.</para> -<para -><userinput ->minimal</userinput -> defaults to <userinput ->FALSE</userinput -> and is fed to the regular expression engine.</para> -<para ->Because the rules are always matched against the beginning of the current string, a regular expression starting with a caret (<literal ->^</literal ->) indicates that the rule should only be matched against the start of a line.</para> -<para ->See <link linkend="regular-expressions" ->Regular Expressions</link -> for more information on those.</para -> +<para>Matches against a regular expression.</para> +<programlisting><RegExpr String="(string)" [insensitive="TRUE|FALSE;"] [minimal="TRUE|FALSE"] (common attributes) /></programlisting> +<para>The <userinput>String</userinput> attribute defines the regular expression.</para> +<para><userinput>insensitive</userinput> defaults to <userinput>FALSE</userinput> and is fed to the regular expression engine.</para> +<para><userinput>minimal</userinput> defaults to <userinput>FALSE</userinput> and is fed to the regular expression engine.</para> +<para>Because the rules are always matched against the beginning of the current string, a regular expression starting with a caret (<literal>^</literal>) indicates that the rule should only be matched against the start of a line.</para> +<para>See <link linkend="regular-expressions">Regular Expressions</link> for more information on those.</para> </listitem> </varlistentry> <varlistentry> -<term ->Keyword</term> +<term>Keyword</term> <listitem> -<para ->Detect a keyword from a specified list.</para> -<programlisting -><keyword String="(list name)" (common attributes) /></programlisting> -<para ->The <userinput ->String</userinput -> attribute identifies the keyword list by name. A list with that name must exist.</para> +<para>Detect a keyword from a specified list.</para> +<programlisting><keyword String="(list name)" (common attributes) /></programlisting> +<para>The <userinput>String</userinput> attribute identifies the keyword list by name. A list with that name must exist.</para> </listitem> </varlistentry> <varlistentry> -<term ->Int</term> +<term>Int</term> <listitem> -<para ->Detect an integer number.</para> -<para -><programlisting -><Int (common attributes) /></programlisting -></para> -<para ->This rule has no specific attributes. Child rules are typically used to detect combinations of <userinput ->L</userinput -> and <userinput ->U</userinput -> after the number, indicating the integer type in program code.</para> +<para>Detect an integer number.</para> +<para><programlisting><Int (common attributes) /></programlisting></para> +<para>This rule has no specific attributes. Child rules are typically used to detect combinations of <userinput>L</userinput> and <userinput>U</userinput> after the number, indicating the integer type in program code.</para> </listitem> </varlistentry> <varlistentry> -<term ->Float</term> +<term>Float</term> <listitem> -<para ->Detect a floating point number.</para> -<para -><programlisting -><Float (common attributes) -/></programlisting -></para -> -<para ->This rule has no specific attributes.</para> +<para>Detect a floating point number.</para> +<para><programlisting><Float (common attributes) +/></programlisting></para> +<para>This rule has no specific attributes.</para> </listitem> </varlistentry> <varlistentry> -<term ->HlCOct</term> +<term>HlCOct</term> <listitem> -<para ->Detect an octal point number representation.</para> -<para -><programlisting -><HlCOct (common attributes) /></programlisting -></para> -<para ->This rule has no specific attributes.</para> +<para>Detect an octal point number representation.</para> +<para><programlisting><HlCOct (common attributes) /></programlisting></para> +<para>This rule has no specific attributes.</para> </listitem> </varlistentry> <varlistentry> -<term ->HlCHex</term> +<term>HlCHex</term> <listitem> -<para ->Detect a hexadecimal number representation.</para> -<para -><programlisting -><Int (common attributes) /></programlisting -></para> -<para ->This rule has no specific attributes.</para> +<para>Detect a hexadecimal number representation.</para> +<para><programlisting><Int (common attributes) /></programlisting></para> +<para>This rule has no specific attributes.</para> </listitem> </varlistentry> <varlistentry> -<term ->HlCStringChar</term> +<term>HlCStringChar</term> <listitem> -<para ->Detect an escaped character.</para> -<para -><programlisting -><HlCStringChar (common attributes) -/></programlisting -></para> -<para ->This rule has no specific attributes.</para> - -<para ->It matches letteral representations of invisible characters commonly used in program code, for example <userinput ->\n</userinput -> (newline) or <userinput ->\t</userinput -> (TAB).</para> - -<para ->The following characters will match if they follow a backslash (<literal ->\</literal ->): <userinput ->abefnrtv"'?</userinput ->. Additionally, escaped hexadecimal numbers like for example <userinput ->\xff</userinput -> and escaped octal numbers, for example <userinput ->\033</userinput -> will match.</para> +<para>Detect an escaped character.</para> +<para><programlisting><HlCStringChar (common attributes) +/></programlisting></para> +<para>This rule has no specific attributes.</para> + +<para>It matches letteral representations of invisible characters commonly used in program code, for example <userinput>\n</userinput> (newline) or <userinput>\t</userinput> (TAB).</para> + +<para>The following characters will match if they follow a backslash (<literal>\</literal>): <userinput>abefnrtv"'?</userinput>. Additionally, escaped hexadecimal numbers like for example <userinput>\xff</userinput> and escaped octal numbers, for example <userinput>\033</userinput> will match.</para> </listitem> </varlistentry> <varlistentry> -<term ->RangeDetect</term> +<term>RangeDetect</term> <listitem> -<para ->Detect a string with defined start and end characters.</para> -<programlisting -><RangeDetect char="(character)" char1="(character)" (common attributes) /></programlisting> -<para -><userinput ->char</userinput -> defines the character starting the range, <userinput ->char2</userinput -> the character ending the range.</para> -<para ->Useful to detect for example small quoted strings and the like, but note that since the hl engine works on one line at a time, this will not find strings spanning over a line break.</para> +<para>Detect a string with defined start and end characters.</para> +<programlisting><RangeDetect char="(character)" char1="(character)" (common attributes) /></programlisting> +<para><userinput>char</userinput> defines the character starting the range, <userinput>char2</userinput> the character ending the range.</para> +<para>Useful to detect for example small quoted strings and the like, but note that since the hl engine works on one line at a time, this will not find strings spanning over a line break.</para> </listitem> </varlistentry> <varlistentry> -<term ->LineContinue</term> +<term>LineContinue</term> <listitem> -<para ->Matches at end of line.</para> -<programlisting -><LineContinue (common attributes) /></programlisting> -<para ->This rule has no specific attributes.</para> -<para ->This rule is useful for switching context at end of line.</para> +<para>Matches at end of line.</para> +<programlisting><LineContinue (common attributes) /></programlisting> +<para>This rule has no specific attributes.</para> +<para>This rule is useful for switching context at end of line.</para> </listitem> </varlistentry> diff --git a/tde-i18n-en_GB/docs/tdebase/kate/index.docbook b/tde-i18n-en_GB/docs/tdebase/kate/index.docbook index d9202e714c9..62956cc7782 100644 --- a/tde-i18n-en_GB/docs/tdebase/kate/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kate/index.docbook @@ -13,125 +13,70 @@ <!ENTITY plugins-chapter SYSTEM "plugins.docbook"> <!ENTITY regexp-appendix SYSTEM "regular-expressions.docbook"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -><!-- change language only here --> + <!ENTITY % British-English "INCLUDE"><!-- change language only here --> ]> <book lang="&language;"> -<title ->The &kate; Handbook</title> +<title>The &kate; Handbook</title> <bookinfo> <authorgroup> -<author ->&Anders.Lund; &Anders.Lund.mail;</author> -<author ->&Seth.Rothberg; &Seth.Rothberg.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Anders.Lund; &Anders.Lund.mail;</author> +<author>&Seth.Rothberg; &Seth.Rothberg.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->2000</year> -<year ->2001</year> -<holder ->&Seth.Rothberg;</holder> +<year>2000</year> +<year>2001</year> +<holder>&Seth.Rothberg;</holder> </copyright> <copyright> -<year ->2002</year -><year ->2003</year> -<holder ->&Anders.Lund;</holder> +<year>2002</year><year>2003</year> +<holder>&Anders.Lund;</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2002-01-26</date> -<releaseinfo ->2.00.00</releaseinfo> +<date>2002-01-26</date> +<releaseinfo>2.00.00</releaseinfo> <abstract> -<para ->&kate; is a programmer's text editor for &kde; 2.2 and above.</para> +<para>&kate; is a programmer's text editor for &kde; 2.2 and above.</para> -<para ->This handbook documents &kate; Version 1.0</para> +<para>This handbook documents &kate; Version 1.0</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->tdebase</keyword> -<keyword ->Kate</keyword> -<keyword ->text</keyword> -<keyword ->editor</keyword> -<keyword ->programmer</keyword> -<keyword ->programming</keyword> -<keyword ->projects</keyword> -<keyword ->MDI</keyword> -<keyword ->Multi</keyword> -<keyword ->Document</keyword> -<keyword ->Interface</keyword> -<keyword ->terminal</keyword> -<keyword ->console</keyword> +<keyword>KDE</keyword> +<keyword>tdebase</keyword> +<keyword>Kate</keyword> +<keyword>text</keyword> +<keyword>editor</keyword> +<keyword>programmer</keyword> +<keyword>programming</keyword> +<keyword>projects</keyword> +<keyword>MDI</keyword> +<keyword>Multi</keyword> +<keyword>Document</keyword> +<keyword>Interface</keyword> +<keyword>terminal</keyword> +<keyword>console</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->Welcome to &kate;, a programmer's text editor for &kde; version 2.2 and above. Some of &kate;'s many features include configurable syntax highlighting for languages ranging from C and C++ to <acronym ->HTML</acronym -> to bash scripts, the ability to create and maintain projects, a multiple document interface (<acronym ->MDI</acronym ->), and a self-contained terminal emulator. </para> +<para>Welcome to &kate;, a programmer's text editor for &kde; version 2.2 and above. Some of &kate;'s many features include configurable syntax highlighting for languages ranging from C and C++ to <acronym>HTML</acronym> to bash scripts, the ability to create and maintain projects, a multiple document interface (<acronym>MDI</acronym>), and a self-contained terminal emulator. </para> -<para ->But &kate; is more than a programmer's editor. Its ability to open several files at once makes it ideal for editing &UNIX;'s many configuration files. This document was written in &kate;. </para> +<para>But &kate; is more than a programmer's editor. Its ability to open several files at once makes it ideal for editing &UNIX;'s many configuration files. This document was written in &kate;. </para> <para> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="kate.png"/></imageobject> -<caption -><para ->Editing this manual...</para -></caption> +<imageobject><imagedata format="PNG" fileref="kate.png"/></imageobject> +<caption><para>Editing this manual...</para></caption> </mediaobject> </para> @@ -153,253 +98,123 @@ <chapter id="credits"> -<title ->Credits and Licence</title> +<title>Credits and Licence</title> -<para ->&kate;. Program copyright 2000, 2001, 2002 by the &kate; developer team. </para> +<para>&kate;. Program copyright 2000, 2001, 2002 by the &kate; developer team. </para> <variablelist> -<title ->The &kate; team:</title> +<title>The &kate; team:</title> <varlistentry> -<term ->&Christoph.Cullmann; &Christoph.Cullmann.mail;</term> -<listitem -><para ->Project Manager & Core Developer</para -></listitem> +<term>&Christoph.Cullmann; &Christoph.Cullmann.mail;</term> +<listitem><para>Project Manager & Core Developer</para></listitem> </varlistentry> <varlistentry> -<term ->&Anders.Lund; &Anders.Lund.mail;</term> -<listitem -><para ->Core Developer, Perl syntax highlighting, documentation</para -></listitem> +<term>&Anders.Lund; &Anders.Lund.mail;</term> +<listitem><para>Core Developer, Perl syntax highlighting, documentation</para></listitem> </varlistentry> <varlistentry> -<term ->&Joseph.Wenninger; &Joseph.Wenninger.mail;</term> -<listitem -><para ->Core Developer, syntax highlighting</para -></listitem> +<term>&Joseph.Wenninger; &Joseph.Wenninger.mail;</term> +<listitem><para>Core Developer, syntax highlighting</para></listitem> </varlistentry> <varlistentry> -<term ->Michael Bartl <email ->michael.bartl1@chello.at</email -></term> -<listitem -><para ->Core Developer</para -></listitem> +<term>Michael Bartl <email>michael.bartl1@chello.at</email></term> +<listitem><para>Core Developer</para></listitem> </varlistentry> <varlistentry> -<term ->Phlip <email ->phlip_cpp@my-deja.com</email -></term> -<listitem -><para ->The project compiler</para -></listitem> +<term>Phlip <email>phlip_cpp@my-deja.com</email></term> +<listitem><para>The project compiler</para></listitem> </varlistentry> <varlistentry> -<term ->&Waldo.Bastian; &Waldo.Bastian.mail;</term> -<listitem -><para ->The cool buffer system</para -></listitem> +<term>&Waldo.Bastian; &Waldo.Bastian.mail;</term> +<listitem><para>The cool buffer system</para></listitem> </varlistentry> <varlistentry> -<term ->Matt Newell <email ->newellm@proaxis.com</email -></term> -<listitem -><para ->Testing...</para -></listitem> +<term>Matt Newell <email>newellm@proaxis.com</email></term> +<listitem><para>Testing...</para></listitem> </varlistentry> <varlistentry> -<term ->Michael McCallum <email ->gholam@xtra.co.nz</email -></term> -<listitem -><para ->Core Developer</para -></listitem> +<term>Michael McCallum <email>gholam@xtra.co.nz</email></term> +<listitem><para>Core Developer</para></listitem> </varlistentry> <varlistentry> -<term ->Jochen Wilhemly <email ->digisnap@cs.tu-berlin.de</email -></term> -<listitem -><para ->KWrite Author</para -></listitem> +<term>Jochen Wilhemly <email>digisnap@cs.tu-berlin.de</email></term> +<listitem><para>KWrite Author</para></listitem> </varlistentry> <varlistentry> -<term ->&Michael.Koch; &Michael.Koch.mail;</term> -<listitem -><para ->KWrite port to KParts</para -></listitem> +<term>&Michael.Koch; &Michael.Koch.mail;</term> +<listitem><para>KWrite port to KParts</para></listitem> </varlistentry> <varlistentry> -<term ->Christian Gebauer <email ->gebauer@bigfoot.com</email -></term> -<listitem -><para ->Unspecified</para -></listitem> +<term>Christian Gebauer <email>gebauer@bigfoot.com</email></term> +<listitem><para>Unspecified</para></listitem> </varlistentry> <varlistentry> -<term ->&Simon.Hausmann; &Simon.Hausmann.mail;</term> -<listitem -><para ->Unspecified</para -></listitem> +<term>&Simon.Hausmann; &Simon.Hausmann.mail;</term> +<listitem><para>Unspecified</para></listitem> </varlistentry> <varlistentry> -<term ->Glen Parker <email ->glenebob@nwlink.com</email -></term> -<listitem -><para ->KWrite Undo History, KSpell integration</para -></listitem> +<term>Glen Parker <email>glenebob@nwlink.com</email></term> +<listitem><para>KWrite Undo History, KSpell integration</para></listitem> </varlistentry> <varlistentry> -<term ->Scott Manson <email ->sdmanson@alltel.net</email -></term> -<listitem -><para ->KWrite XML syntax highlighting support</para -></listitem> +<term>Scott Manson <email>sdmanson@alltel.net</email></term> +<listitem><para>KWrite XML syntax highlighting support</para></listitem> </varlistentry> <varlistentry> -<term ->&John.Firebaugh; &John.Firebaugh.mail;</term> -<listitem -><para ->Various Patches</para -></listitem> +<term>&John.Firebaugh; &John.Firebaugh.mail;</term> +<listitem><para>Various Patches</para></listitem> </varlistentry> </variablelist> <variablelist> -<title ->Many other people have contributed:</title> +<title>Many other people have contributed:</title> <varlistentry> -<term ->Matteo Merli <email ->merlim@libero.it</email -></term> -<listitem -><para ->Highlighting for RPM Spec-Files, Diff and more</para -></listitem> +<term>Matteo Merli <email>merlim@libero.it</email></term> +<listitem><para>Highlighting for RPM Spec-Files, Diff and more</para></listitem> </varlistentry> <varlistentry> -<term ->Rocky Scaletta <email ->rocky@purdue.edu</email -></term> -<listitem -><para ->Highlighting for VHDL</para -></listitem> +<term>Rocky Scaletta <email>rocky@purdue.edu</email></term> +<listitem><para>Highlighting for VHDL</para></listitem> </varlistentry> <varlistentry> -<term ->Yury Lebedev </term> -<listitem -><para ->Highlighting for SQL</para -></listitem> +<term>Yury Lebedev </term> +<listitem><para>Highlighting for SQL</para></listitem> </varlistentry> <varlistentry> -<term ->Chris Ross</term> -<listitem -><para ->Highlighting for Ferite</para -></listitem> +<term>Chris Ross</term> +<listitem><para>Highlighting for Ferite</para></listitem> </varlistentry> <varlistentry> -<term ->Nick Roux</term> -<listitem -><para ->Highlighting for ILERPG</para -></listitem> +<term>Nick Roux</term> +<listitem><para>Highlighting for ILERPG</para></listitem> </varlistentry> <varlistentry> -<term ->John Firebaugh</term> -<listitem -><para ->Highlighting for Java, and much more</para -></listitem> +<term>John Firebaugh</term> +<listitem><para>Highlighting for Java, and much more</para></listitem> </varlistentry> <varlistentry> -<term ->Carsten Niehaus</term> -<listitem -><para ->Highlighting for LaTeX</para -></listitem> +<term>Carsten Niehaus</term> +<listitem><para>Highlighting for LaTeX</para></listitem> </varlistentry> <varlistentry> -<term ->Per Wigren</term> -<listitem -><para ->Highlighting for Makefiles, Python</para -></listitem> +<term>Per Wigren</term> +<listitem><para>Highlighting for Makefiles, Python</para></listitem> </varlistentry> <varlistentry> -<term ->Jan Fritz</term> -<listitem -><para ->Highlighting for Python</para -></listitem> +<term>Jan Fritz</term> +<listitem><para>Highlighting for Python</para></listitem> </varlistentry> <varlistentry> -<term ->&Daniel.Naber;</term> -<listitem -><para ->Small bugfixes, XML plugin</para -></listitem> +<term>&Daniel.Naber;</term> +<listitem><para>Small bugfixes, XML plugin</para></listitem> </varlistentry> </variablelist> -<para ->Documentation copyright 2000,2001 &Seth.Rothberg; &Seth.Rothberg.mail;</para> +<para>Documentation copyright 2000,2001 &Seth.Rothberg; &Seth.Rothberg.mail;</para> -<para ->Documentation copyright 2002, 2003 &Anders.Lund; &Anders.Lund.mail;</para> +<para>Documentation copyright 2002, 2003 &Anders.Lund; &Anders.Lund.mail;</para> -<para ->Conversion to British English: John Knight <email ->anarchist_tomato@herzeleid.net</email -></para -> +<para>Conversion to British English: John Knight <email>anarchist_tomato@herzeleid.net</email></para> &underFDL; &underGPL; </chapter> &highlighting-appendix; @@ -407,8 +222,7 @@ ®exp-appendix; <appendix id="installation"> -<title ->Installation</title> +<title>Installation</title> &install.intro.documentation; diff --git a/tde-i18n-en_GB/docs/tdebase/kate/mdi.docbook b/tde-i18n-en_GB/docs/tdebase/kate/mdi.docbook index 38ddee1ee8e..76b3536507d 100644 --- a/tde-i18n-en_GB/docs/tdebase/kate/mdi.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kate/mdi.docbook @@ -1,88 +1,38 @@ <chapter id="kate-mdi"> <chapterinfo> <authorgroup> -<author ->&Anders.Lund; &Anders.Lund.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </chapterinfo> -<title ->Working With the &kate; <acronym ->MDI</acronym -></title> +<title>Working With the &kate; <acronym>MDI</acronym></title> <sect1 id="kate-mdi-overview"> -<title ->Overview</title> +<title>Overview</title> -<para ->Window, View, Document, Frame, Editor... What are they all in the terminology of &kate;, and how do you get the most out of it? This chapter will explain all of that, and even more.</para> +<para>Window, View, Document, Frame, Editor... What are they all in the terminology of &kate;, and how do you get the most out of it? This chapter will explain all of that, and even more.</para> <sect2 id="kate-mdi-overview-mainwindow"> -<title ->The Main Window</title> +<title>The Main Window</title> -<para -><indexterm -><primary ->Main window</primary -></indexterm -> The &kate; Main Window is a standard &kde; application window, with the addition of dockable subwindows, or tool windows. It has a Menubar with all the common menus, and some more, and a toolbar providing access to commonly used commands.</para> +<para><indexterm><primary>Main window</primary></indexterm> The &kate; Main Window is a standard &kde; application window, with the addition of dockable subwindows, or tool windows. It has a Menubar with all the common menus, and some more, and a toolbar providing access to commonly used commands.</para> -<para ->The most important part of the window is the Editing Area, by default displaying a single text editor component, in which you can work with your documents.</para> +<para>The most important part of the window is the Editing Area, by default displaying a single text editor component, in which you can work with your documents.</para> -<para ->The docking capabilities of the window is used for the tool windows:</para> +<para>The docking capabilities of the window is used for the tool windows:</para> <itemizedlist> -<listitem -><para -><link linkend="kate-mdi-tools-file-list" ->The File List</link -></para -></listitem> -<listitem -><para -><link linkend="kate-mdi-tools-file-selector" ->The File Selector</link -></para -></listitem> -<listitem -><para -><link linkend="kate-mdi-tools-konsole" ->The Built in Terminal Emulator</link -></para -></listitem> +<listitem><para><link linkend="kate-mdi-tools-file-list">The File List</link></para></listitem> +<listitem><para><link linkend="kate-mdi-tools-file-selector">The File Selector</link></para></listitem> +<listitem><para><link linkend="kate-mdi-tools-konsole">The Built in Terminal Emulator</link></para></listitem> </itemizedlist> -<para ->And possibly other tool windows, for example provided by plugins.</para> +<para>And possibly other tool windows, for example provided by plugins.</para> -<para -><indexterm -><primary ->Tool Windows</primary -></indexterm -> The Tool Windows can be placed anywhere you want them inside or outside the main window by dragging the handle bar in the top of them with the &LMB; pressed, and stacked in shared tab windows if desired.</para> +<para><indexterm><primary>Tool Windows</primary></indexterm> The Tool Windows can be placed anywhere you want them inside or outside the main window by dragging the handle bar in the top of them with the &LMB; pressed, and stacked in shared tab windows if desired.</para> -<para ->When dragging a docked window, a black rectangle will be displayed to indicate where the window will be placed if you release the mouse button, unless you move the mouse cursor outside the main window, in which case the dragged window will become a free floating top level window.</para> +<para>When dragging a docked window, a black rectangle will be displayed to indicate where the window will be placed if you release the mouse button, unless you move the mouse cursor outside the main window, in which case the dragged window will become a free floating top level window.</para> </sect2> @@ -91,137 +41,60 @@ <sect1 id="kate-mdi-editor"> -<title ->The Editor area</title> +<title>The Editor area</title> -<para -><indexterm -><primary ->Editing Area</primary -></indexterm -> &kate; is capable of having more than one document open at the same time, and also of splitting the editing area into any number of frames, similar to how for example &konqueror; or the popular <application ->emacs</application -> text editor works. This way you can view several documents at the same time, or more instances of the same document, handy for example if your document contains definitions in the top that you want to see often for reference. Or you could view a program source header in one frame, while editing the implementation file in another.</para> +<para><indexterm><primary>Editing Area</primary></indexterm> &kate; is capable of having more than one document open at the same time, and also of splitting the editing area into any number of frames, similar to how for example &konqueror; or the popular <application>emacs</application> text editor works. This way you can view several documents at the same time, or more instances of the same document, handy for example if your document contains definitions in the top that you want to see often for reference. Or you could view a program source header in one frame, while editing the implementation file in another.</para> -<para ->When a document is available in more than one editor, changes made in one editor will immediately be reflected in the others as well. This includes changing the text as well as selecting text. Search operations or cursor movement is only reflected in the current editor.</para> +<para>When a document is available in more than one editor, changes made in one editor will immediately be reflected in the others as well. This includes changing the text as well as selecting text. Search operations or cursor movement is only reflected in the current editor.</para> -<para ->It is currently not possible to have more instances of the same document open in the sense that one instance will be edited while the other will not.</para> +<para>It is currently not possible to have more instances of the same document open in the sense that one instance will be edited while the other will not.</para> -<para ->When splitting an editor into two frames, it is divided into two equally sized frames, both displaying the current document of that editor. The new frame will be at the bottom (in the case of a horizontal split) or at the right (for a vertical split). The new frame gets the focus, which is visualised by a small green led in the focused frame.</para> +<para>When splitting an editor into two frames, it is divided into two equally sized frames, both displaying the current document of that editor. The new frame will be at the bottom (in the case of a horizontal split) or at the right (for a vertical split). The new frame gets the focus, which is visualised by a small green led in the focused frame.</para> </sect1> <sect1 id="kate-mdi-tools-file-list"> -<title ->The File List</title> - -<para -><indexterm -><primary ->File list</primary -></indexterm -> The file list displays a list of all documents currently open in &kate;. Modified files will have a small <guiicon ->floppy disk</guiicon -> icon on their left to indicate that state.</para> - -<para ->If two or more files with the same name (located in different folders) are open, the names of the second will be prepended <quote -><2></quote -> and so on. The tool-tip for the file will display its full name including the path, allowing you to choose the desired one.</para -> <para ->To display a document in the currently active frame, click the document name in the list.</para> - -<para ->The default location in the &kate; window is to the left of the editing area, in a dockable tab window shared with the <link linkend="kate-mdi-tools-file-selector" ->File Selector</link ->.</para> +<title>The File List</title> + +<para><indexterm><primary>File list</primary></indexterm> The file list displays a list of all documents currently open in &kate;. Modified files will have a small <guiicon>floppy disk</guiicon> icon on their left to indicate that state.</para> + +<para>If two or more files with the same name (located in different folders) are open, the names of the second will be prepended <quote><2></quote> and so on. The tool-tip for the file will display its full name including the path, allowing you to choose the desired one.</para> <para>To display a document in the currently active frame, click the document name in the list.</para> + +<para>The default location in the &kate; window is to the left of the editing area, in a dockable tab window shared with the <link linkend="kate-mdi-tools-file-selector">File Selector</link>.</para> </sect1> <sect1 id="kate-mdi-tools-file-selector"> -<title ->The File Selector</title> +<title>The File Selector</title> -<para -><indexterm -><primary ->File selector</primary -></indexterm -> The File Selector is a folder viewer, allowing you to open files from a displayed folder in the current frame.</para> +<para><indexterm><primary>File selector</primary></indexterm> The File Selector is a folder viewer, allowing you to open files from a displayed folder in the current frame.</para> -<para ->From top down, the file selector consist of the following elements:</para> +<para>From top down, the file selector consist of the following elements:</para> <variablelist> <varlistentry> -<term ->A Toolbar</term> +<term>A Toolbar</term> <listitem> -<para ->This contains standard navigations tool buttons:</para> +<para>This contains standard navigations tool buttons:</para> <variablelist> <varlistentry> -<term -><guibutton ->Home</guibutton -></term> -<listitem -><para ->Pressing it will cause the folder view to <command ->cd</command -> to your home folder.</para -></listitem> +<term><guibutton>Home</guibutton></term> +<listitem><para>Pressing it will cause the folder view to <command>cd</command> to your home folder.</para></listitem> </varlistentry> <varlistentry> -<term -><guibutton ->Up</guibutton -></term> -<listitem -><para ->This will cause the folder view to <command ->cd</command -> to the immediate parent of the currently displayed folder if possible.</para -></listitem> +<term><guibutton>Up</guibutton></term> +<listitem><para>This will cause the folder view to <command>cd</command> to the immediate parent of the currently displayed folder if possible.</para></listitem> </varlistentry> <varlistentry> -<term -><guibutton ->Back</guibutton -></term> -<listitem -><para ->Causes the folder view to <command ->cd</command -> to the previously displayed folder in the history. This button is disabled, if there is no previous item.</para -></listitem> +<term><guibutton>Back</guibutton></term> +<listitem><para>Causes the folder view to <command>cd</command> to the previously displayed folder in the history. This button is disabled, if there is no previous item.</para></listitem> </varlistentry> <varlistentry> -<term -><guibutton ->Forward</guibutton -></term> -<listitem -><para ->Causes the folder view to <command ->cd</command -> to the next folder in the history. This button is disabled, if there is no next folder.</para -></listitem> +<term><guibutton>Forward</guibutton></term> +<listitem><para>Causes the folder view to <command>cd</command> to the next folder in the history. This button is disabled, if there is no next folder.</para></listitem> </varlistentry> <varlistentry> -<term -><guibutton ->Sync</guibutton -></term> -<listitem -><para ->This button will cause the folder view to <command ->cd</command -> to the folder of the currently active document if possible. This button is disabled, if the active document is a new, unsaved file, or the folder in which it resides can not be decided.</para -></listitem -> +<term><guibutton>Sync</guibutton></term> +<listitem><para>This button will cause the folder view to <command>cd</command> to the folder of the currently active document if possible. This button is disabled, if the active document is a new, unsaved file, or the folder in which it resides can not be decided.</para></listitem> </varlistentry> </variablelist> @@ -229,43 +102,24 @@ </varlistentry> <varlistentry> -<term ->A &URL; entry</term> +<term>A &URL; entry</term> <listitem> -<para ->Here you can type the path of a folder to browse. The &URL; entry maintains a list of previously typed paths. To choose one use the arrow button to the right of the entry.</para> -<tip -><para ->The &URL; entry has folder auto-completion. The completion method can be set using the &RMB; menu of the text entry.</para -></tip> -</listitem -> +<para>Here you can type the path of a folder to browse. The &URL; entry maintains a list of previously typed paths. To choose one use the arrow button to the right of the entry.</para> +<tip><para>The &URL; entry has folder auto-completion. The completion method can be set using the &RMB; menu of the text entry.</para></tip> +</listitem> </varlistentry> <varlistentry> -<term ->A Folder View</term> -<listitem -><para ->This is a standard &kde; folder view.</para -></listitem> +<term>A Folder View</term> +<listitem><para>This is a standard &kde; folder view.</para></listitem> </varlistentry> <varlistentry> -<term ->A Filter Entry</term> +<term>A Filter Entry</term> <listitem> -<para ->The Filter entry allows you to enter a filter for the files displayed in the folder view. The filter uses standard globs; patterns must be separated by white space. Example: <userinput ->*.cpp *.h *.moc</userinput -></para> -<para ->To display all files, enter a single asterisk <userinput ->*</userinput ->.</para> -<para ->The filter entry saves the last 10 filters entered between sessions, to use one, press the arrow button on the right of the entry and select the desired filter string.</para -> +<para>The Filter entry allows you to enter a filter for the files displayed in the folder view. The filter uses standard globs; patterns must be separated by white space. Example: <userinput>*.cpp *.h *.moc</userinput></para> +<para>To display all files, enter a single asterisk <userinput>*</userinput>.</para> +<para>The filter entry saves the last 10 filters entered between sessions, to use one, press the arrow button on the right of the entry and select the desired filter string.</para> </listitem> </varlistentry> @@ -275,33 +129,13 @@ <sect1 id="kate-mdi-tools-konsole"> -<title ->The Built in Terminal Emulator</title> - -<para -><indexterm -><primary ->Terminal emulator</primary -></indexterm -> The built in Terminal Emulator is a copy of the &kde; &konsole; terminal application, for your convenience. It is available from the <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Show Terminal Emulator</guimenuitem -></menuchoice -> menu item or by pressing the <keycombo action="simul" -><keycap ->F7</keycap -></keycombo -> key, and will get the focus whenever displayed. Additionally, if the <link linkend="config-dialog-general-sync-konsole" ->Sync &konsole; with active document</link -> option is enabled, it will change into the directory of the current document if possible when it is displayed, or when the current document changes.</para> - -<para ->The default location in the &kate; window is at the bottom, below the editing area.</para> - -<para ->You can configure the &konsole; using it's &RMB; menu, for more information, see the &konsole; manual.</para> +<title>The Built in Terminal Emulator</title> + +<para><indexterm><primary>Terminal emulator</primary></indexterm> The built in Terminal Emulator is a copy of the &kde; &konsole; terminal application, for your convenience. It is available from the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Show Terminal Emulator</guimenuitem></menuchoice> menu item or by pressing the <keycombo action="simul"><keycap>F7</keycap></keycombo> key, and will get the focus whenever displayed. Additionally, if the <link linkend="config-dialog-general-sync-konsole">Sync &konsole; with active document</link> option is enabled, it will change into the directory of the current document if possible when it is displayed, or when the current document changes.</para> + +<para>The default location in the &kate; window is at the bottom, below the editing area.</para> + +<para>You can configure the &konsole; using it's &RMB; menu, for more information, see the &konsole; manual.</para> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kate/menus.docbook b/tde-i18n-en_GB/docs/tdebase/kate/menus.docbook index b59173e1e7c..b9d6d439ad1 100644 --- a/tde-i18n-en_GB/docs/tdebase/kate/menus.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kate/menus.docbook @@ -1,663 +1,289 @@ <chapter id="menu-entries"> <chapterinfo> <authorgroup> -<author -><personname -><firstname -></firstname -></personname -></author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author><personname><firstname></firstname></personname></author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </chapterinfo> -<title ->Menu Entries</title> +<title>Menu Entries</title> <sect1 id="file-menu"> -<title ->The <guimenu ->File</guimenu -> Menu</title> +<title>The <guimenu>File</guimenu> Menu</title> <variablelist> <varlistentry> <term> <anchor id="new"/> -<menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->N</keycap -></keycombo -> </shortcut -> <guimenu ->File</guimenu -> <guimenuitem ->New</guimenuitem -> </menuchoice> +<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo> </shortcut> <guimenu>File</guimenu> <guimenuitem>New</guimenuitem> </menuchoice> </term> <listitem> -<para ->This command <action ->starts a new document</action -> in the editing window. In the <guibutton ->Filelist</guibutton -> on the left the new file is named <emphasis ->Untitled</emphasis ->. </para> +<para>This command <action>starts a new document</action> in the editing window. In the <guibutton>Filelist</guibutton> on the left the new file is named <emphasis>Untitled</emphasis>. </para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="open"/> -<menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->O</keycap -></keycombo -> </shortcut -> <guimenu ->File</guimenu -> <guimenuitem ->Open</guimenuitem -> </menuchoice> +<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> </shortcut> <guimenu>File</guimenu> <guimenuitem>Open</guimenuitem> </menuchoice> </term> <listitem> -<para ->This command does not <action ->open a file</action ->. It launches &kde;'s open file dialogue box which waits for you to select the files you want to open. </para> - -<para ->The open file dialogue box works like a simple version of &konqueror;. Use your &LMB; to click on a file name to select it. Double-click on a file name to open that file. Once you've selected a file name, you can also press the <guibutton ->OK</guibutton -> button to open the file. </para> +<para>This command does not <action>open a file</action>. It launches &kde;'s open file dialogue box which waits for you to select the files you want to open. </para> + +<para>The open file dialogue box works like a simple version of &konqueror;. Use your &LMB; to click on a file name to select it. Double-click on a file name to open that file. Once you've selected a file name, you can also press the <guibutton>OK</guibutton> button to open the file. </para> <tip> -<para ->Select multiple files by holding down the &Ctrl; or the &Shift; key along with the &LMB;. <keycombo action="simul" -> &Ctrl;<mousebutton ->Left</mousebutton -> </keycombo -> click selects one file at a time. <keycombo action="simul" -> &Shift;<mousebutton ->Left</mousebutton -> </keycombo -> click selects a contiguous set of files. </para> +<para>Select multiple files by holding down the &Ctrl; or the &Shift; key along with the &LMB;. <keycombo action="simul"> &Ctrl;<mousebutton>Left</mousebutton> </keycombo> click selects one file at a time. <keycombo action="simul"> &Shift;<mousebutton>Left</mousebutton> </keycombo> click selects a contiguous set of files. </para> </tip> -<para ->Clicking on a folder name in the file selection window opens that folder and displays its contents. Clicking on a file name shows a thumbnail view of the file in the preview window to the right of the file system window. </para> +<para>Clicking on a folder name in the file selection window opens that folder and displays its contents. Clicking on a file name shows a thumbnail view of the file in the preview window to the right of the file system window. </para> -<para ->Use the buttons and combo box on the toolbar above the file selection window to move through the file system or to adjust the properties of the open file dialogue box. </para> +<para>Use the buttons and combo box on the toolbar above the file selection window to move through the file system or to adjust the properties of the open file dialogue box. </para> -<para ->Below the file selection window is the Location combo box. Type the name of the file you want to edit here. If you click the arrow on the right of the drop down box, you can choose from recently used files. Open several files at once by quoting each file name. </para> +<para>Below the file selection window is the Location combo box. Type the name of the file you want to edit here. If you click the arrow on the right of the drop down box, you can choose from recently used files. Open several files at once by quoting each file name. </para> -<para ->Below the Location combo box is the Filter combo box. Enter file masks here to filter the kinds of files shown in the selection window. For example, typing the filter <literal role="extension" ->*.txt</literal -> and pressing <keycap ->Enter</keycap -> will limit the display to files with a <literal role="extension" ->.txt</literal -> extension. The Filter combo contains a list of your most recently used filters. </para> +<para>Below the Location combo box is the Filter combo box. Enter file masks here to filter the kinds of files shown in the selection window. For example, typing the filter <literal role="extension">*.txt</literal> and pressing <keycap>Enter</keycap> will limit the display to files with a <literal role="extension">.txt</literal> extension. The Filter combo contains a list of your most recently used filters. </para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="open-recent"/> -<menuchoice -><guimenu ->File</guimenu -> <guimenuitem ->Open Recent</guimenuitem -> </menuchoice> +<menuchoice><guimenu>File</guimenu> <guimenuitem>Open Recent</guimenuitem> </menuchoice> </term> <listitem> -<para ->This command allows you to <action ->open a file</action -> from a submenu that contains a list of recently edited files. </para> +<para>This command allows you to <action>open a file</action> from a submenu that contains a list of recently edited files. </para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="save"/> -<menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->S</keycap -></keycombo -> </shortcut -> <guimenu ->File</guimenu -> <guimenuitem ->Save</guimenuitem -> </menuchoice> +<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> </shortcut> <guimenu>File</guimenu> <guimenuitem>Save</guimenuitem> </menuchoice> </term> <listitem> -<para ->This command <action ->saves your file</action ->. Use it often. If the file is <emphasis ->Untitled</emphasis -> then <guimenuitem ->Save</guimenuitem -> becomes <guimenuitem ->Save As</guimenuitem ->. </para> +<para>This command <action>saves your file</action>. Use it often. If the file is <emphasis>Untitled</emphasis> then <guimenuitem>Save</guimenuitem> becomes <guimenuitem>Save As</guimenuitem>. </para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="save-as"/> -<menuchoice -><guimenu ->File</guimenu -> <guimenuitem ->Save As</guimenuitem -> </menuchoice> +<menuchoice><guimenu>File</guimenu> <guimenuitem>Save As</guimenuitem> </menuchoice> </term> <listitem> -<para -><action ->Name and rename files</action -> with this command. It launches the save file dialogue box. This dialogue works just as the open file dialogue box does. You can use it to navigate through your file system, preview existing files, or filter your file view with file masks. </para> - -<para ->Type the name you want to give the file you are saving in the Location combo box and press the <guibutton ->OK</guibutton -> button. </para> +<para><action>Name and rename files</action> with this command. It launches the save file dialogue box. This dialogue works just as the open file dialogue box does. You can use it to navigate through your file system, preview existing files, or filter your file view with file masks. </para> + +<para>Type the name you want to give the file you are saving in the Location combo box and press the <guibutton>OK</guibutton> button. </para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="save-all"/> -<menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->L</keycap -></keycombo -> </shortcut -> <guimenu ->File</guimenu -> <guimenuitem ->Save All</guimenuitem -> </menuchoice> +<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo> </shortcut> <guimenu>File</guimenu> <guimenuitem>Save All</guimenuitem> </menuchoice> </term> <listitem> -<para ->This command <action ->saves all open files</action ->. </para> +<para>This command <action>saves all open files</action>. </para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="reload"/> -<menuchoice -><shortcut -> <keycombo action="simul" -><keycap ->F5</keycap -></keycombo -> </shortcut -> <guimenu ->File</guimenu -> <guimenuitem ->Reload</guimenuitem -> </menuchoice> +<menuchoice><shortcut> <keycombo action="simul"><keycap>F5</keycap></keycombo> </shortcut> <guimenu>File</guimenu> <guimenuitem>Reload</guimenuitem> </menuchoice> </term> <listitem> -<para -><action ->Reloads the active file from disk</action ->. This command is useful if another program or process has changed the file while you have it open in &kate; </para> +<para><action>Reloads the active file from disk</action>. This command is useful if another program or process has changed the file while you have it open in &kate; </para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="open-with"/> -<menuchoice -><guimenu ->File</guimenu -> <guimenuitem ->Open with</guimenuitem -> </menuchoice> +<menuchoice><guimenu>File</guimenu> <guimenuitem>Open with</guimenuitem> </menuchoice> </term> <listitem> -<para ->This command launches the open with dialogue box that allows you to <action ->select another application to open the active file</action ->. Your file will still be open in &kate;. </para> +<para>This command launches the open with dialogue box that allows you to <action>select another application to open the active file</action>. Your file will still be open in &kate;. </para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="print"/> -<menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->P</keycap -></keycombo -> </shortcut -> <guimenu ->File</guimenu -> <guimenuitem ->Print</guimenuitem -> </menuchoice> +<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo> </shortcut> <guimenu>File</guimenu> <guimenuitem>Print</guimenuitem> </menuchoice> </term> <listitem> -<para -><action ->Print the active file</action ->. </para> +<para><action>Print the active file</action>. </para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="close"/> -<menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->W</keycap -></keycombo -> </shortcut -> <guimenu ->File</guimenu -> <guimenuitem ->Close</guimenuitem -> </menuchoice> +<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo> </shortcut> <guimenu>File</guimenu> <guimenuitem>Close</guimenuitem> </menuchoice> </term> <listitem> -<para -><action ->Close the active file</action -> with this command. If you have made unsaved changes, you will be prompted to save the file before &kate; closes it. </para> +<para><action>Close the active file</action> with this command. If you have made unsaved changes, you will be prompted to save the file before &kate; closes it. </para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="close-all"/> -<menuchoice -><guimenu ->File</guimenu -> <guimenuitem ->Close All</guimenuitem -> </menuchoice> +<menuchoice><guimenu>File</guimenu> <guimenuitem>Close All</guimenuitem> </menuchoice> </term> <listitem> -<para ->This command <action ->closes all the files you have open</action -> in &kate;. </para> +<para>This command <action>closes all the files you have open</action> in &kate;. </para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="new-window"/> -<menuchoice -><guimenu ->File</guimenu -> <guimenuitem ->New Window</guimenuitem -> </menuchoice> +<menuchoice><guimenu>File</guimenu> <guimenuitem>New Window</guimenuitem> </menuchoice> </term> <listitem> -<para -><action ->Opens another instance of &kate;</action ->. The new instance will be identical to your previous instance. </para> +<para><action>Opens another instance of &kate;</action>. The new instance will be identical to your previous instance. </para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="quit"/> -<menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->Q</keycap -></keycombo -> </shortcut -> <guimenu ->File</guimenu -> <guimenuitem ->Quit</guimenuitem -> </menuchoice> +<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem> </menuchoice> </term> <listitem> -<para ->This command <action ->closes &kate;</action -> and any files you were editing. If you have made unsaved changes to any of the files you were editing, you will be prompted to save them. </para> +<para>This command <action>closes &kate;</action> and any files you were editing. If you have made unsaved changes to any of the files you were editing, you will be prompted to save them. </para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="edit-menu"> -<title ->The <guimenu ->Edit</guimenu -> Menu</title> -<para ->The <guimenu ->Edit</guimenu -> menu contains a host of commands, all to work with the currently active document.</para> +<title>The <guimenu>Edit</guimenu> Menu</title> +<para>The <guimenu>Edit</guimenu> menu contains a host of commands, all to work with the currently active document.</para> <variablelist> -<title ->Menu Entries</title> +<title>Menu Entries</title> <varlistentry> <term> <anchor id="edit-undo"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;<keycap ->Z</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Undo</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Undo</guimenuitem> </menuchoice> </term> <listitem> -<para ->Undo the last editing command (typing, copying, cutting etc.)</para> -<note -><para ->If grouped undo is enabled, this may undo several editing commands of the same type, like typing in characters.</para -></note> +<para>Undo the last editing command (typing, copying, cutting etc.)</para> +<note><para>If grouped undo is enabled, this may undo several editing commands of the same type, like typing in characters.</para></note> </listitem> </varlistentry> <varlistentry> <term> <anchor id="edit-redo"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;&Shift;<keycap ->Z</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Redo</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Redo</guimenuitem> </menuchoice> </term> <listitem> -<para ->Redo the last undo step.</para> +<para>Redo the last undo step.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="edit-cut"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;<keycap ->X</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Cut</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Cut</guimenuitem> </menuchoice> </term> <listitem> -<para ->Removes selected text if any, and places a copy of the removed text in the clipboard.</para> +<para>Removes selected text if any, and places a copy of the removed text in the clipboard.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="edit-copy"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;<keycap ->C</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Copy</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Copy</guimenuitem> </menuchoice> </term> <listitem> -<para ->Copies selected text, if any, to the clipboard.</para> +<para>Copies selected text, if any, to the clipboard.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="edit-paste"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;<keycap ->V</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Paste</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Paste</guimenuitem> </menuchoice> </term> <listitem> -<para ->Copies the first item in the clipboard into the editor at cursor position.</para> -<note -><para ->If Overwrite Selection is enabled, the pasted text will overwrite the selection, if any.</para -></note> +<para>Copies the first item in the clipboard into the editor at cursor position.</para> +<note><para>If Overwrite Selection is enabled, the pasted text will overwrite the selection, if any.</para></note> </listitem> </varlistentry> <varlistentry> <term> <anchor id="edit-select-all"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;<keycap ->A</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Select All</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Select All</guimenuitem> </menuchoice> </term> <listitem> -<para ->Selects all text in the editor.</para> +<para>Selects all text in the editor.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="edit-deselect"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;&Shift;<keycap ->A</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Deselect</guimenuitem -> </menuchoice> +<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> +<para>Deselects the selected text in the editor if any.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="edit-toggle-block-selection"/> -<menuchoice -><shortcut -><keycombo action="simul" -><keycap ->F4</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Toggle Block Selection</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul"><keycap>F4</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Toggle Block Selection</guimenuitem> </menuchoice> </term> <listitem> -<para ->Toggles Selection Mode. When the Selection Mode is <quote ->BLOCK</quote ->, you can make vertical selections, ie select column 5 to 10 in lines 9 to 15.</para> -<para ->The status bar shows the current state of the Selection Mode, either <quote ->NORM</quote -> or <quote ->BLK</quote ->.</para> +<para>Toggles Selection Mode. When the Selection Mode is <quote>BLOCK</quote>, you can make vertical selections, ie select column 5 to 10 in lines 9 to 15.</para> +<para>The status bar shows the current state of the Selection Mode, either <quote>NORM</quote> or <quote>BLK</quote>.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="edit-find"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;<keycap ->F</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Find</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Find</guimenuitem> </menuchoice> </term> <listitem> -<para ->Launch the Find Dialogue to allow you to search for text in the edited document.</para> +<para>Launch the Find Dialogue to allow you to search for text in the edited document.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="edit-find-next"/> -<menuchoice -><shortcut -><keycombo action="simul" -><keycap ->F3</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Find Next</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul"><keycap>F3</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Find Next</guimenuitem> </menuchoice> </term> <listitem> -<para ->Go to the nearest downwards match of the last text or regular expression searched for, starting from cursor position</para> +<para>Go to the nearest downwards match of the last text or regular expression searched for, starting from cursor position</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="edit-find-previous"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Shift;<keycap ->F3</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Find Previous</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Shift;<keycap>F3</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Find Previous</guimenuitem> </menuchoice> </term> <listitem> -<para ->Go to the nearest upwards match of the last text or regular expression searched for, starting from cursor position</para> +<para>Go to the nearest upwards match of the last text or regular expression searched for, starting from cursor position</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="edit-replace"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;<keycap ->R</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Replace</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Replace</guimenuitem> </menuchoice> </term> <listitem> -<para ->Launch the Replace Dialogue to replace one or more instances of a defined text with something else.</para> +<para>Launch the Replace Dialogue to replace one or more instances of a defined text with something else.</para> </listitem> </varlistentry> @@ -665,129 +291,54 @@ <varlistentry> <term> <anchor id="edit-indent"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;<keycap ->I</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Indent</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Indent</guimenuitem> </menuchoice> </term> -<listitem -><!-- FIXME LINK --> -<para ->Adds one indent step to the current line, or all lines covered by a possible selection.</para> -<para ->The indentation depends on the settings in the Indent Page of the Configuration Dialogue.</para> +<listitem><!-- FIXME LINK --> +<para>Adds one indent step to the current line, or all lines covered by a possible selection.</para> +<para>The indentation depends on the settings in the Indent Page of the Configuration Dialogue.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="edit-unindent"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;&Shift;<keycap ->I</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Unindent</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>I</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Unindent</guimenuitem> </menuchoice> </term> <listitem> -<para ->Removes one indent step from the current line, or all lines covered by a possible selection.</para> -<para ->The indentation depends on the settings in the Indent Page of the Configuration Dialogue.</para> +<para>Removes one indent step from the current line, or all lines covered by a possible selection.</para> +<para>The indentation depends on the settings in the Indent Page of the Configuration Dialogue.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="edit-comment"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;<keycap ->#</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Comment</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>#</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Comment</guimenuitem> </menuchoice> </term> <listitem> -<para ->Enclose or prepend the current line, or any selected text, with (a) comment marker(s), according to the rules defined by the syntax rules for the document. Does nothing if no comment rules are defined.</para> -<para ->This is interesting mostly when working with source code, for example with C/C++, perl, python &etc;, as well as with markup text like <acronym ->HTML</acronym ->, &XML;, <acronym ->CSS</acronym -> and so on.</para> +<para>Enclose or prepend the current line, or any selected text, with (a) comment marker(s), according to the rules defined by the syntax rules for the document. Does nothing if no comment rules are defined.</para> +<para>This is interesting mostly when working with source code, for example with C/C++, perl, python &etc;, as well as with markup text like <acronym>HTML</acronym>, &XML;, <acronym>CSS</acronym> and so on.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="edit-uncomment"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;&Shift;<keycap ->#</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem -></guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>#</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem></guimenuitem> </menuchoice> </term> <listitem> -<para ->Remove comment marker(s) from the current line, or a possible selection, according to the syntax rules for the document. </para> -<para ->See also <link linkend="edit-comment" -><guimenu ->Edit</guimenu -><guimenuitem ->Comment</guimenuitem -></link -></para> +<para>Remove comment marker(s) from the current line, or a possible selection, according to the syntax rules for the document. </para> +<para>See also <link linkend="edit-comment"><guimenu>Edit</guimenu><guimenuitem>Comment</guimenuitem></link></para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="edit-go-to-line"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;<keycap ->G</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Go to line...</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Go to line...</guimenuitem> </menuchoice> </term> <listitem> -<para ->Launches the Go To Line Dialogue, allowing you to enter the number of a line to find in the document</para> +<para>Launches the Go To Line Dialogue, allowing you to enter the number of a line to find in the document</para> </listitem> </varlistentry> @@ -796,97 +347,44 @@ </sect1> <sect1 id="document-menu"> -<title ->The <guimenu ->Document</guimenu ->Menu</title> -<para ->The <guimenu ->Document</guimenu -> menu has two purposes:</para> +<title>The <guimenu>Document</guimenu>Menu</title> +<para>The <guimenu>Document</guimenu> menu has two purposes:</para> <itemizedlist> -<listitem -><para ->Allowing you to change the document-specific settings for the currently active document.</para -></listitem> -<listitem -><para ->Choosing which of the open documents to work on</para -></listitem> +<listitem><para>Allowing you to change the document-specific settings for the currently active document.</para></listitem> +<listitem><para>Choosing which of the open documents to work on</para></listitem> </itemizedlist> -<para ->A menu entry for each open document will be available below the entries documented here. Clicking one of these will bring the requested document to focus. If you have multiple frames, an editor for that document will be displayed in the currently active frame.</para> +<para>A menu entry for each open document will be available below the entries documented here. Clicking one of these will bring the requested document to focus. If you have multiple frames, an editor for that document will be displayed in the currently active frame.</para> <variablelist> -<title ->Menu items</title> +<title>Menu items</title> <varlistentry> <term> <anchor id="document-back"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Alt;<keycap ->Left</keycap -></keycombo -></shortcut -> <guimenu ->Document</guimenu -> <guimenuitem ->Back</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Alt;<keycap>Left</keycap></keycombo></shortcut> <guimenu>Document</guimenu> <guimenuitem>Back</guimenuitem> </menuchoice> </term> <listitem> -<para ->This will bring the previous document in the stack in focus. If you have multiple frames, an editor for the document will be displayed in the currently active frame.</para -> <para ->The order is the order in which documents were opened, rather than a logical history. This behaviour may change in future versions of &kate;.</para> +<para>This will bring the previous document in the stack in focus. If you have multiple frames, an editor for the document will be displayed in the currently active frame.</para> <para>The order is the order in which documents were opened, rather than a logical history. This behaviour may change in future versions of &kate;.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="document-forward"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Alt;<keycap ->Right</keycap -></keycombo -></shortcut -> <guimenu ->Document</guimenu -> <guimenuitem ->Forward</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Alt;<keycap>Right</keycap></keycombo></shortcut> <guimenu>Document</guimenu> <guimenuitem>Forward</guimenuitem> </menuchoice> </term> <listitem> -<para ->This will bring the previous document in the stack in focus. If you have multiple frames, an editor for the document will be displayed in the currently active frame.</para> -<para ->The order is the order in which the documents were opened, rather than a logical history. This behaviour may change in future versions of &kate;.</para> +<para>This will bring the previous document in the stack in focus. If you have multiple frames, an editor for the document will be displayed in the currently active frame.</para> +<para>The order is the order in which the documents were opened, rather than a logical history. This behaviour may change in future versions of &kate;.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="document-highlight-mode"/> -<menuchoice -><guimenu ->Document</guimenu -> <guisubmenu ->Highlight Mode</guisubmenu -> </menuchoice> +<menuchoice><guimenu>Document</guimenu> <guisubmenu>Highlight Mode</guisubmenu> </menuchoice> </term> <listitem> -<para ->The <guimenu ->Highlight Mode</guimenu -> menu allows you to manually decide which syntax rules to use for highlighting and <link linkend="edit-comment" -><guimenuitem ->comment</guimenuitem -></link ->'ing the active document. The menu groups the available syntax rule sets into logical groups.</para> +<para>The <guimenu>Highlight Mode</guimenu> menu allows you to manually decide which syntax rules to use for highlighting and <link linkend="edit-comment"><guimenuitem>comment</guimenuitem></link>'ing the active document. The menu groups the available syntax rule sets into logical groups.</para> <!-- FIXME link to syntax rules chapter, when written :) --> </listitem> </varlistentry> @@ -894,53 +392,27 @@ <varlistentry> <term> <anchor id="document-end-of-line"/> -<menuchoice -><guimenu ->Document</guimenu -> <guisubmenu ->End of Line</guisubmenu -> </menuchoice> +<menuchoice><guimenu>Document</guimenu> <guisubmenu>End of Line</guisubmenu> </menuchoice> </term> <listitem> -<para ->This menu allows you to manually set the End of Line mode for the active document. Changing the mode will replace all line separators in the document with the character sequence for the new mode.</para> +<para>This menu allows you to manually set the End of Line mode for the active document. Changing the mode will replace all line separators in the document with the character sequence for the new mode.</para> -<para ->The available modes are:</para> +<para>The available modes are:</para> <variablelist> <varlistentry> -<term -><guimenuitem ->Unix</guimenuitem -></term> +<term><guimenuitem>Unix</guimenuitem></term> <listitem> -<para ->On &UNIX; systems, end of line is a single newline character.</para -></listitem> +<para>On &UNIX; systems, end of line is a single newline character.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->DOS</guimenuitem -></term> -<listitem -><para ->On <acronym ->DOS</acronym -> (and &Windows;) systems, end of line is represented by a carriage return followed by a newline.</para -></listitem> +<term><guimenuitem>DOS</guimenuitem></term> +<listitem><para>On <acronym>DOS</acronym> (and &Windows;) systems, end of line is represented by a carriage return followed by a newline.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Mac</guimenuitem -></term> -<listitem -><para ->On &Mac; systems, end of line is represented by a by a carriage return.</para -></listitem> +<term><guimenuitem>Mac</guimenuitem></term> +<listitem><para>On &Mac; systems, end of line is represented by a by a carriage return.</para></listitem> </varlistentry> </variablelist> </listitem> @@ -949,157 +421,69 @@ </sect1> <sect1 id="view-menu"> -<title ->The <guimenu ->View</guimenu -> menu</title> +<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> +<para>The <guimenu>View</guimenu> menu allows you to manage settings specific to the active editor, and to manage frames.</para> <variablelist> -<title ->Menu Items</title> +<title>Menu Items</title> <varlistentry> <term> <anchor id="view-split-vertical"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;&Shift;<keycap ->L</keycap -></keycombo -></shortcut -> <guimenu ->View</guimenu -> <guimenuitem ->Split Vertical</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>L</keycap></keycombo></shortcut> <guimenu>View</guimenu> <guimenuitem>Split Vertical</guimenuitem> </menuchoice> </term> <listitem> -<para ->This will split the frame (which may be the main editing area) in two equally sized frames, the new one to the left of the current one. The new frame gets the focus, and will display the same document as the old one.</para> -<para ->See also <link linkend="kate-mdi" ->Working with the &kate; MDI</link -></para> +<para>This will split the frame (which may be the main editing area) in two equally sized frames, the new one to the left of the current one. The new frame gets the focus, and will display the same document as the old one.</para> +<para>See also <link linkend="kate-mdi">Working with the &kate; MDI</link></para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="view-split-horizontal"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;&Shift;<keycap ->T</keycap -></keycombo -></shortcut -> <guimenu ->View</guimenu -> <guimenuitem ->Split Horizontal</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>T</keycap></keycombo></shortcut> <guimenu>View</guimenu> <guimenuitem>Split Horizontal</guimenuitem> </menuchoice> </term> <listitem> -<para ->Splits the current frame (which may be the main editing area) in two equally sized frames, the new one at the bottom half. The new frame gets the focus, and displays the same document as the old one.</para> -<para ->See also <link linkend="kate-mdi" ->Working with the &kate; MDI</link -></para> +<para>Splits the current frame (which may be the main editing area) in two equally sized frames, the new one at the bottom half. The new frame gets the focus, and displays the same document as the old one.</para> +<para>See also <link linkend="kate-mdi">Working with the &kate; MDI</link></para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="view-close-current"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;&Shift;<keycap ->R</keycap -></keycombo -></shortcut -> <guimenu ->View</guimenu -> <guimenuitem ->Close Current</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>R</keycap></keycombo></shortcut> <guimenu>View</guimenu> <guimenuitem>Close Current</guimenuitem> </menuchoice> </term> <listitem> -<para ->Closes the active frame. This is disabled, if there is only one frame (the main editing area).</para -> <para ->No documents get closed by closing a frame – they will still be available in the <link linkend="document-menu" -><guimenu ->Documents</guimenu -> Menu</link -> as well as in the File List.</para -> <para ->See also <link linkend="kate-mdi" ->Working with the &kate; MDI</link -></para> +<para>Closes the active frame. This is disabled, if there is only one frame (the main editing area).</para> <para>No documents get closed by closing a frame – they will still be available in the <link linkend="document-menu"><guimenu>Documents</guimenu> Menu</link> as well as in the File List.</para> <para>See also <link linkend="kate-mdi">Working with the &kate; MDI</link></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> +<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> +<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> +<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> +<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-go"/> -<menuchoice -><guimenu ->View</guimenu -> <guisubmenu ->Go</guisubmenu -> </menuchoice> +<menuchoice><guimenu>View</guimenu> <guisubmenu>Go</guisubmenu> </menuchoice> </term> <listitem> @@ -1108,48 +492,22 @@ <varlistentry> <term> <anchor id="view-go-next-view"/> -<menuchoice -><shortcut -><keycombo action="simul" -><keycap ->F8</keycap -></keycombo -></shortcut -> <guimenuitem ->Next View</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul"><keycap>F8</keycap></keycombo></shortcut> <guimenuitem>Next View</guimenuitem> </menuchoice> </term> <listitem> -<para ->Move focus to the next frame; the order is following order of creation rather than that of visual logic. This behaviour may change in a future version of &kate;</para> -<para ->See also <link linkend="kate-mdi" ->Working with the &kate; MDI</link -></para> +<para>Move focus to the next frame; the order is following order of creation rather than that of visual logic. This behaviour may change in a future version of &kate;</para> +<para>See also <link linkend="kate-mdi">Working with the &kate; MDI</link></para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="view-go-previous-view"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Shift;<keycap ->F8</keycap -></keycombo -></shortcut -> <guimenuitem ->Previous View</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Shift;<keycap>F8</keycap></keycombo></shortcut> <guimenuitem>Previous View</guimenuitem> </menuchoice> </term> <listitem> -<para ->Move focus to the previous frame; the order is following order of creation rather than that of visual logic. This behaviour may change in a future version of &kate;</para> -<para ->See also <link linkend="kate-mdi" ->Working with the &kate; MDI</link -></para> +<para>Move focus to the previous frame; the order is following order of creation rather than that of visual logic. This behaviour may change in a future version of &kate;</para> +<para>See also <link linkend="kate-mdi">Working with the &kate; MDI</link></para> </listitem> </varlistentry> @@ -1166,59 +524,33 @@ </sect1> <sect1 id="bookmarks-menu"> -<title ->The <guimenu ->Bookmarks</guimenu -> Menu</title> +<title>The <guimenu>Bookmarks</guimenu> Menu</title> -<para ->The <guimenu ->Bookmarks</guimenu -> menu allows you to work with the bookmarks in the currently active document.</para> +<para>The <guimenu>Bookmarks</guimenu> menu allows you to work with the bookmarks in the currently active document.</para> -<para ->Below the entries described here, one entry for each bookmark in the active document will be available. The text will be the first few words of the marked line. Choose an item to move the cursor to the start of that line. The editor will scroll as necessary to make that line visible.</para> +<para>Below the entries described here, one entry for each bookmark in the active document will be available. The text will be the first few words of the marked line. Choose an item to move the cursor to the start of that line. The editor will scroll as necessary to make that line visible.</para> <variablelist> -<title ->Menu Items</title> +<title>Menu Items</title> <varlistentry> <term> <anchor id="bookmarks-toggle-bookmark"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;<keycap ->B</keycap -></keycombo -></shortcut -> <guimenu ->Bookmarks</guimenu -> <guimenuitem ->Toggle Bookmark</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo></shortcut> <guimenu>Bookmarks</guimenu> <guimenuitem>Toggle 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> +<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> <anchor id="bookmarks-clear-bookmarks"/> -<menuchoice -><guimenu ->Bookmarks</guimenu -> <guimenuitem ->Clear Bookmarks</guimenuitem -> </menuchoice> +<menuchoice><guimenu>Bookmarks</guimenu> <guimenuitem>Clear Bookmarks</guimenuitem> </menuchoice> </term> <listitem> -<para ->Clears (removes) all bookmarks of the active document.</para> +<para>Clears (removes) all bookmarks of the active document.</para> </listitem> </varlistentry> @@ -1229,30 +561,12 @@ <sect1 id="tools-menu"> -<title ->The <guimenu ->Tools</guimenu -> Menu</title> - -<para ->The <guimenu ->Tools</guimenu -> menu contains commands of two categories: <itemizedlist> -<listitem -><para ->Tools doing advanced editing of the current document, for example <link linkend="tools-menu-editing-command" -><guimenuitem ->Editing Command</guimenuitem -></link ->.</para> +<title>The <guimenu>Tools</guimenu> Menu</title> + +<para>The <guimenu>Tools</guimenu> menu contains commands of two categories: <itemizedlist> +<listitem><para>Tools doing advanced editing of the current document, for example <link linkend="tools-menu-editing-command"><guimenuitem>Editing Command</guimenuitem></link>.</para> </listitem> -<listitem -><para ->Tools adding functionality to the application, for example the <link linkend="tools-menu-find-in-files" -><guimenuitem ->Find in Files</guimenuitem -></link -> tool.</para> +<listitem><para>Tools adding functionality to the application, for example the <link linkend="tools-menu-find-in-files"><guimenuitem>Find in Files</guimenuitem></link> tool.</para> </listitem> </itemizedlist> </para> @@ -1262,62 +576,30 @@ <varlistentry> <term> <anchor id="tools-menu-editing-command"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;<keycap ->M</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Editing Command...</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Editing Command...</guimenuitem> </menuchoice> </term> -<listitem -><!-- FIXME LINK, DOCUMENT THAT TODO: add a minimal desc here--> -<para ->Launch the Editing Command Dialogue</para> +<listitem><!-- FIXME LINK, DOCUMENT THAT TODO: add a minimal desc here--> +<para>Launch the Editing Command Dialogue</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="tools-menu-find-in-files"/> -<menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;&Shift;<keycap ->F</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Find in Files...</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Find in Files...</guimenuitem> </menuchoice> </term> <listitem> -<para ->Launch the Find In Files Dialogue to search for a specified text in files on disk.</para> +<para>Launch the Find In Files Dialogue to search for a specified text in files on disk.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="tools-menu-apply-word-wrap"/> -<menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Apply Word Wrap</guimenuitem -> </menuchoice> +<menuchoice><guimenu>Edit</guimenu> <guimenuitem>Apply Word Wrap</guimenuitem> </menuchoice> </term> -<listitem -><!-- FIXME LINKS TEST MORE? //--> -<para ->Apply word wrap to ? according to the settings in the ? </para> +<listitem><!-- FIXME LINKS TEST MORE? //--> +<para>Apply word wrap to ? according to the settings in the ? </para> </listitem> </varlistentry> @@ -1325,16 +607,10 @@ <varlistentry> <term> <anchor id="tools-menu-spelling"/> -<menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Spelling...</guimenuitem -> </menuchoice> +<menuchoice><guimenu>Edit</guimenu> <guimenuitem>Spelling...</guimenuitem> </menuchoice> </term> <listitem> -<para ->Spell check the current document using the &kde; spell checker</para> +<para>Spell check the current document using the &kde; spell checker</para> </listitem> </varlistentry> @@ -1346,111 +622,61 @@ <sect1 id="settings-menu"> -<title ->The <guimenu ->Settings</guimenu -> Menu</title> +<title>The <guimenu>Settings</guimenu> Menu</title> -<para ->The <guimenu ->Settings</guimenu -> menu allows you to change the properties of the main window, such as showing/hiding toolbars and boxes, and provides access to the configuration dialogues.</para> +<para>The <guimenu>Settings</guimenu> menu allows you to change the properties of the main window, such as showing/hiding toolbars and boxes, and provides access to the configuration dialogues.</para> <variablelist> <varlistentry> <term> <anchor id="settings-show-toolbar"/> -<menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Show Toolbar</guimenuitem -> </menuchoice> +<menuchoice><guimenu>Settings</guimenu> <guimenuitem>Show Toolbar</guimenuitem> </menuchoice> </term> <listitem> -<para ->Toggles the display of the main toolbar.</para> +<para>Toggles the display of the main toolbar.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="settings-show-filelist"/> -<menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Show Filelist</guimenuitem -> </menuchoice> +<menuchoice><guimenu>Settings</guimenu> <guimenuitem>Show Filelist</guimenuitem> </menuchoice> </term> <listitem> -<para ->Toggle the display of the &kate; Filelist</para> +<para>Toggle the display of the &kate; Filelist</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="settings-show-fileselector"/> -<menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Show Fileselector</guimenuitem -> </menuchoice> +<menuchoice><guimenu>Settings</guimenu> <guimenuitem>Show Fileselector</guimenuitem> </menuchoice> </term> <listitem> -<para ->Toggle the display of the &kate; File Selector</para> +<para>Toggle the display of the &kate; File Selector</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="settings-show-konsole"/> -<menuchoice -><shortcut -><keycombo action="simul" -><keycap ->F7</keycap -></keycombo -></shortcut -> <guimenu ->Settings</guimenu -> <guimenuitem ->Show Konsole</guimenuitem -> </menuchoice> +<menuchoice><shortcut><keycombo action="simul"><keycap>F7</keycap></keycombo></shortcut> <guimenu>Settings</guimenu> <guimenuitem>Show Konsole</guimenuitem> </menuchoice> </term> <listitem> -<para ->Toggles the display of the built in terminal emulator.</para> -<para ->When activated the first time, the terminal will be created.</para> -<para ->When the terminal emulator is displayed, it will get the focus, so that you can start typing in commands immediately. If the <link linkend="config-dialog-general-sync-konsole" ->Sync Konsole with Active Document</link -> option is enabled in the <link linkend="config-dialog-general" ->General Page</link -> of the <link linkend="config-dialog" ->Main configuration dialogue</link -> the shell session will change to the directory of the active document, if it is a local file.</para> +<para>Toggles the display of the built in terminal emulator.</para> +<para>When activated the first time, the terminal will be created.</para> +<para>When the terminal emulator is displayed, it will get the focus, so that you can start typing in commands immediately. If the <link linkend="config-dialog-general-sync-konsole">Sync Konsole with Active Document</link> option is enabled in the <link linkend="config-dialog-general">General Page</link> of the <link linkend="config-dialog">Main configuration dialogue</link> the shell session will change to the directory of the active document, if it is a local file.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="settings-configure-shortcuts"/> -<menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Configure Shortcuts</guimenuitem -> </menuchoice> +<menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure Shortcuts</guimenuitem> </menuchoice> </term> <listitem> -<para ->Display the the familiar &kde; Keyboard Shortcut Configuration Dialogue.</para> +<para>Display the the familiar &kde; Keyboard Shortcut Configuration Dialogue.</para> </listitem> </varlistentry> @@ -1458,34 +684,20 @@ <varlistentry> <term> <anchor id="settings-configure-toolbars"/> -<menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Configure Toolbars</guimenuitem -> </menuchoice> +<menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure Toolbars</guimenuitem> </menuchoice> </term> <listitem> -<para ->Display the the familiar &kde; Toolbar Configuration Dialogue.</para> +<para>Display the the familiar &kde; Toolbar Configuration Dialogue.</para> </listitem> </varlistentry> <varlistentry> <term> <anchor id="settings-configure-kate"/> -<menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Configure &kate;</guimenuitem -> </menuchoice> +<menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure &kate;</guimenuitem> </menuchoice> </term> <listitem> -<para ->Launch the <link linkend="config-dialog" ->Main Configuration Dialogue</link -></para> +<para>Launch the <link linkend="config-dialog">Main Configuration Dialogue</link></para> </listitem> </varlistentry> @@ -1496,20 +708,11 @@ <sect1 id="help-menu"> -<title ->The <guimenu ->Help</guimenu -> Menu</title> +<title>The <guimenu>Help</guimenu> Menu</title> -<para ->The <guimenu ->Help</guimenu -> menu provides access to the online help available for &kate;; as well as to the usual about dialogues.</para> +<para>The <guimenu>Help</guimenu> menu provides access to the online help available for &kate;; as well as to the usual about dialogues.</para> -<para ->As well as the standard &kde; <guimenu ->Help</guimenu -> menu items described below, if you have installed the tdeaddons package with additional &kate; plugins, you will have a menu entry to show the Plugins User Manuals.</para> +<para>As well as the standard &kde; <guimenu>Help</guimenu> menu items described below, if you have installed the tdeaddons package with additional &kate; plugins, you will have a menu entry to show the Plugins User Manuals.</para> &help.menu.documentation; </sect1> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/kate/part.docbook b/tde-i18n-en_GB/docs/tdebase/kate/part.docbook index f0e11a9d57c..24d3c81be3d 100644 --- a/tde-i18n-en_GB/docs/tdebase/kate/part.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kate/part.docbook @@ -1,303 +1,136 @@ <chapter id="kate-part"> <chapterinfo> <authorgroup> -<author -><personname -><firstname -></firstname -></personname -></author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author><personname><firstname></firstname></personname></author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </chapterinfo> -<title ->Working with the &kate; editor</title> +<title>Working with the &kate; editor</title> <sect1 id="kate-part-overview"> -<title ->Overview</title> +<title>Overview</title> -<para ->The &kate; editor is the editing area of the &kate; window. This editor is also used by &kwrite;, and it can be used in &konqueror; for displaying text files from your local computer, or from the network.</para> +<para>The &kate; editor is the editing area of the &kate; window. This editor is also used by &kwrite;, and it can be used in &konqueror; for displaying text files from your local computer, or from the network.</para> -<para ->The editor is composed of the following components:</para> +<para>The editor is composed of the following components:</para> <variablelist> <varlistentry> -<term ->The editing area</term> -<listitem -><para ->This is where the text of your document is located.</para -></listitem> +<term>The editing area</term> +<listitem><para>This is where the text of your document is located.</para></listitem> </varlistentry> <varlistentry> -<term ->The Scroll bars</term> +<term>The Scroll bars</term> <listitem> -<para ->The scroll bars indicate the position of the visible part of the document text, and can be used to move around the document. Dragging the scrollbars will not cause the insertion cursor to be moved.</para> -<para ->The scroll bars are displayed and hidden as required.</para> +<para>The scroll bars indicate the position of the visible part of the document text, and can be used to move around the document. Dragging the scrollbars will not cause the insertion cursor to be moved.</para> +<para>The scroll bars are displayed and hidden as required.</para> </listitem> </varlistentry> <varlistentry> -<term ->The Icon Border</term> +<term>The Icon Border</term> <listitem> -<para ->The icon border is a small pane on the left side of the editor, displaying a small icon next to marked lines.</para> -<para ->You can set or remove a <link linkend="kate-part-bookmarks" ->bookmark</link -> in a visible line by clicking the &LMB; in the icon border next to that line.</para> -<para ->The display of the icon border can be toggled using the <menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Show Icon Border</guimenuitem -></menuchoice -> menu item.</para -> +<para>The icon border is a small pane on the left side of the editor, displaying a small icon next to marked lines.</para> +<para>You can set or remove a <link linkend="kate-part-bookmarks">bookmark</link> in a visible line by clicking the &LMB; in the icon border next to that line.</para> +<para>The display of the icon border can be toggled using the <menuchoice><guimenu>View</guimenu> <guimenuitem>Show Icon Border</guimenuitem></menuchoice> menu item.</para> </listitem> </varlistentry> <varlistentry> -<term ->The Line Numbers Pane</term> +<term>The Line Numbers Pane</term> <listitem> -<para ->The Line numbers pane shows the line numbers of all visible lines in the document.</para -> -<para ->The display of the Line Numbers Pane can be toggled using the <menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Show Line Numbers</guimenuitem -></menuchoice -> menu item.</para> +<para>The Line numbers pane shows the line numbers of all visible lines in the document.</para> +<para>The display of the Line Numbers Pane can be toggled using the <menuchoice><guimenu>View</guimenu> <guimenuitem>Show Line Numbers</guimenuitem></menuchoice> menu item.</para> </listitem> </varlistentry> </variablelist> <itemizedlist> -<title ->Also in this Chapter:</title> -<listitem -><para -><link linkend="kate-part-navigation" ->Navigating in the Text</link -> </para -></listitem> -<listitem -><para -><link linkend="kate-part-selection" ->Working with the Selection</link -></para -></listitem> -<listitem -><para -><link linkend="kate-part-copy-and-paste" ->Copying and Pasting Text</link -></para -></listitem> -<listitem -><para -><link linkend="kate-part-find-replace" ->Finding and Replacing Text</link -></para -></listitem> -<listitem -><para -><link linkend="kate-part-bookmarks" ->Using Bookmarks</link -></para -></listitem> -<listitem -><para -><link linkend="kate-part-auto-wrap" ->Automatically Wrapping Text</link -></para -></listitem> +<title>Also in this Chapter:</title> +<listitem><para><link linkend="kate-part-navigation">Navigating in the Text</link> </para></listitem> +<listitem><para><link linkend="kate-part-selection">Working with the Selection</link></para></listitem> +<listitem><para><link linkend="kate-part-copy-and-paste">Copying and Pasting Text</link></para></listitem> +<listitem><para><link linkend="kate-part-find-replace">Finding and Replacing Text</link></para></listitem> +<listitem><para><link linkend="kate-part-bookmarks">Using Bookmarks</link></para></listitem> +<listitem><para><link linkend="kate-part-auto-wrap">Automatically Wrapping Text</link></para></listitem> </itemizedlist> </sect1> <sect1 id="kate-part-navigation"> -<title ->Navigating in the Text</title> +<title>Navigating in the Text</title> -<para ->This section is not yet documented.</para> +<para>This section is not yet documented.</para> </sect1> <sect1 id="kate-part-selection"> -<title ->Working with the Selection</title> +<title>Working with the Selection</title> -<para ->There are two basic ways of selecting text in &kate;: using the mouse, and using the keyboard.</para> +<para>There are two basic ways of selecting text in &kate;: using the mouse, and using the keyboard.</para> -<para ->To select using the mouse, hold down the &LMB; while dragging the mouse cursor from where the selection should start, to the desired end point. The text gets selected as you drag.</para> +<para>To select using the mouse, hold down the &LMB; while dragging the mouse cursor from where the selection should start, to the desired end point. The text gets selected as you drag.</para> -<para ->Double-clicking a word will select that word.</para> +<para>Double-clicking a word will select that word.</para> -<para ->Triple-clicking in a line will select the entire line.</para> +<para>Triple-clicking in a line will select the entire line.</para> -<para ->If &Shift; is held down while clicking, text will be selected:</para> +<para>If &Shift; is held down while clicking, text will be selected:</para> <itemizedlist> -<listitem -><para ->If nothing is already selected, from the text cursor position to the mouse cursor position.</para -></listitem> -<listitem -><para ->If there is a selection, from and including that selection to the mouse cursor position</para -></listitem> +<listitem><para>If nothing is already selected, from the text cursor position to the mouse cursor position.</para></listitem> +<listitem><para>If there is a selection, from and including that selection to the mouse cursor position</para></listitem> </itemizedlist> <note> -<para ->When selecting text by dragging the mouse, the selected text is copied to the clipboard, and can be pasted by clicking the middle mouse button in the editor, or in any other application to which you want to paste the text. </para> +<para>When selecting text by dragging the mouse, the selected text is copied to the clipboard, and can be pasted by clicking the middle mouse button in the editor, or in any other application to which you want to paste the text. </para> </note> -<para ->To select using the keyboard, hold down the &Shift; key while using the navigation keys (The Arrow keys, <keycap ->Page Up</keycap ->, <keycap ->Page Down</keycap ->, <keycap ->Home</keycap -> and <keycap ->End</keycap ->, possibly in combination with &Ctrl; to extend the move of the text cursor).</para> - -<para ->See also the section <link linkend="kate-part-navigation" ->Navigating in the Text</link -> in this Chapter.</para> - -<para ->To <action ->Copy</action -> the current selection, use the <menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Copy</guimenuitem -></menuchoice -> menu item or the keyboard shortcut (defaults to <keycombo action="simul" ->&Ctrl;<keycap ->C</keycap -></keycombo ->).</para> - -<para ->To <action ->Deselect</action -> the current selection, use the <menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Deselect</guimenuitem -></menuchoice -> menu item, or the keyboard shortcut (default is <keycombo action="simul" ->&Ctrl;&Shift;<keycap ->A</keycap -></keycombo ->), or click with the &LMB; in the editor.</para> +<para>To select using the keyboard, hold down the &Shift; key while using the navigation keys (The Arrow keys, <keycap>Page Up</keycap>, <keycap>Page Down</keycap>, <keycap>Home</keycap> and <keycap>End</keycap>, possibly in combination with &Ctrl; to extend the move of the text cursor).</para> + +<para>See also the section <link linkend="kate-part-navigation">Navigating in the Text</link> in this Chapter.</para> + +<para>To <action>Copy</action> the current selection, use the <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Copy</guimenuitem></menuchoice> menu item or the keyboard shortcut (defaults to <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>).</para> + +<para>To <action>Deselect</action> the current selection, use the <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Deselect</guimenuitem></menuchoice> menu item, or the keyboard shortcut (default is <keycombo action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo>), or click with the &LMB; in the editor.</para> <sect2 id="kate-part-selection-block"> -<title ->Using Block Selection</title> - -<para ->When Block Selection is enabled, you can make <quote ->vertical selections</quote -> in the text, meaning selecting limited columns from multiple lines. This is handy for working with tab separated lines for example.</para> - -<para ->Block Selection can be toggled using the <menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Toggle Block Selection</guimenuitem -></menuchoice -> menu item. The default keyboard shortcut is <keycap ->F4</keycap -></para> +<title>Using Block Selection</title> + +<para>When Block Selection is enabled, you can make <quote>vertical selections</quote> in the text, meaning selecting limited columns from multiple lines. This is handy for working with tab separated lines for example.</para> + +<para>Block Selection can be toggled using the <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Toggle Block Selection</guimenuitem></menuchoice> menu item. The default keyboard shortcut is <keycap>F4</keycap></para> </sect2> <sect2 id="kate-part-seleciton-overwrite"> -<title ->Using Overwrite Selection</title> +<title>Using Overwrite Selection</title> -<para ->If Overwrite Selection is enabled, typing or pasting text into the selection will cause the selected text to be replaced. If not enabled, new text will be added at the position of the text cursor.</para> +<para>If Overwrite Selection is enabled, typing or pasting text into the selection will cause the selected text to be replaced. If not enabled, new text will be added at the position of the text cursor.</para> -<para ->Overwrite Selection is enabled by default.</para> +<para>Overwrite Selection is enabled by default.</para> -<para ->To change the setting for this option, use the <link linkend="config-dialog-editor-select" ->Select Page</link -> of the <link linkend="config-dialog" ->Configuration Dialogue</link ->.</para> +<para>To change the setting for this option, use the <link linkend="config-dialog-editor-select">Select Page</link> of the <link linkend="config-dialog">Configuration Dialogue</link>.</para> </sect2> <sect2 id="kate-part-selection-persistent"> -<title ->Using Persistent Selection</title> +<title>Using Persistent Selection</title> -<para ->When Persistent selection is enabled, typing characters or moving the cursor will not cause the Selection to become deselected. This means that you can move the cursor away from the selection and type text.</para> +<para>When Persistent selection is enabled, typing characters or moving the cursor will not cause the Selection to become deselected. This means that you can move the cursor away from the selection and type text.</para> -<para ->Persistent Selection is disabled by default.</para> +<para>Persistent Selection is disabled by default.</para> -<para ->Persistent Selection can be enabled in the <link linkend="config-dialog-editor-select" ->Select Page</link -> of the <link linkend="config-dialog" ->Configuration Dialogue</link ->.</para> +<para>Persistent Selection can be enabled in the <link linkend="config-dialog-editor-select">Select Page</link> of the <link linkend="config-dialog">Configuration Dialogue</link>.</para> <warning> -<para ->If Persistent Selection and Overwrite Selection are both enabled, typing or pasting text when the text cursor is inside the selection will cause it to be replaced and deselected.</para> +<para>If Persistent Selection and Overwrite Selection are both enabled, typing or pasting text when the text cursor is inside the selection will cause it to be replaced and deselected.</para> </warning> </sect2> @@ -306,325 +139,152 @@ <sect1 id="kate-part-copy-and-paste"> -<title ->Copying and Pasting Text</title> - -<para ->To copy text, select it and use the <menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Copy</guimenuitem -></menuchoice -> menu item. Additionally, selecting text with the mouse will cause selected text to be copied to the clipboard.</para> - -<para ->To paste the text currently in the clipboard, use the <menuchoice -> <guimenu ->Edit</guimenu -><guimenuitem ->Paste</guimenuitem -></menuchoice -> menu item.</para> - -<para ->Additionally, text selected with the mouse may be pasted by clicking the <mousebutton ->middle</mousebutton -> mouse button at the desired position.</para> +<title>Copying and Pasting Text</title> + +<para>To copy text, select it and use the <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Copy</guimenuitem></menuchoice> menu item. Additionally, selecting text with the mouse will cause selected text to be copied to the clipboard.</para> + +<para>To paste the text currently in the clipboard, use the <menuchoice> <guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice> menu item.</para> + +<para>Additionally, text selected with the mouse may be pasted by clicking the <mousebutton>middle</mousebutton> mouse button at the desired position.</para> <tip> -<para ->If you are using the &kde; desktop, you can retrieve earlier copied text from any application using the &klipper; icon in the &kicker; icon tray.</para> +<para>If you are using the &kde; desktop, you can retrieve earlier copied text from any application using the &klipper; icon in the &kicker; icon tray.</para> </tip> </sect1> <sect1 id="kate-part-find-replace"> -<title ->Finding and Replacing Text</title> +<title>Finding and Replacing Text</title> <sect2 id="find-replace-dialog"> -<title ->The <guilabel ->Find Text</guilabel -> and <guilabel ->Replace Text</guilabel -> Dialogues</title> +<title>The <guilabel>Find Text</guilabel> and <guilabel>Replace Text</guilabel> Dialogues</title> -<para ->The Find and Replace Text dialogues in &kate; are very much the same, except the Replace Text dialogue offers the means of entering a replacement string along with a few extra options.</para> +<para>The Find and Replace Text dialogues in &kate; are very much the same, except the Replace Text dialogue offers the means of entering a replacement string along with a few extra options.</para> -<para ->The dialogues offer the following common options:</para> +<para>The dialogues offer the following common options:</para> <variablelist> <varlistentry> -<term -><guilabel ->Text to Find</guilabel -></term> -<listitem -><para ->This is where to enter the search string. The interpretation of the string depends on some of the options described below.</para -></listitem> +<term><guilabel>Text to Find</guilabel></term> +<listitem><para>This is where to enter the search string. The interpretation of the string depends on some of the options described below.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Regular Expression</guilabel -></term> +<term><guilabel>Regular Expression</guilabel></term> <listitem> -<para ->If checked, the search string is interpreted as a regular expression. A button for using a graphical tool to create or edit the expression will be enabled.</para -> -<para ->See <link linkend="regular-expressions" ->Regular Expressions</link -> for more on these.</para -> +<para>If checked, the search string is interpreted as a regular expression. A button for using a graphical tool to create or edit the expression will be enabled.</para> +<para>See <link linkend="regular-expressions">Regular Expressions</link> for more on these.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Case Insensitive</guilabel -></term> +<term><guilabel>Case Insensitive</guilabel></term> <listitem> -<para ->If enabled, the search will be case insensitive.</para> +<para>If enabled, the search will be case insensitive.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Whole Words Only</guilabel -></term> +<term><guilabel>Whole Words Only</guilabel></term> <listitem> -<para ->If checked, the search will only match if there is a word boundary at both ends of the string matching, meaning not an alphanumeric character - either some other visible character or a line end.</para> +<para>If checked, the search will only match if there is a word boundary at both ends of the string matching, meaning not an alphanumeric character - either some other visible character or a line end.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->From Beginning</guilabel -></term> +<term><guilabel>From Beginning</guilabel></term> <listitem> -<para ->If checked, the search will start at the beginning of the first line in the document, otherwise it will start at cursor position.</para> +<para>If checked, the search will start at the beginning of the first line in the document, otherwise it will start at cursor position.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Find Backwards</guilabel -></term> +<term><guilabel>Find Backwards</guilabel></term> <listitem> -<para ->If checked, the search will look for the first match above the starting point, either cursor position or the beginning of the document, if the <guilabel ->From Beginning</guilabel -> option is enabled.</para> +<para>If checked, the search will look for the first match above the starting point, either cursor position or the beginning of the document, if the <guilabel>From Beginning</guilabel> option is enabled.</para> </listitem> </varlistentry> </variablelist> -<para ->The <guilabel ->Replace Text</guilabel -> Dialogue offers some additional options:</para> +<para>The <guilabel>Replace Text</guilabel> Dialogue offers some additional options:</para> <variablelist> <varlistentry> -<term -><guilabel ->Replace With</guilabel -></term> -<listitem -><para ->This is where to enter the replacement string.</para -></listitem -> +<term><guilabel>Replace With</guilabel></term> +<listitem><para>This is where to enter the replacement string.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Selected Text</guilabel -></term> +<term><guilabel>Selected Text</guilabel></term> <listitem> -<para ->This option is disabled if no text is selected, or if the <guilabel ->Prompt on Replace</guilabel -> option is enabled. If checked, all matches of the search string within the selected text will be replaced with the replace string.</para> +<para>This option is disabled if no text is selected, or if the <guilabel>Prompt on Replace</guilabel> option is enabled. If checked, all matches of the search string within the selected text will be replaced with the replace string.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Prompt on Replace</guilabel -></term> -<listitem -><para ->If checked, a small dialogue will prompt you for what to do for each time a match is found. It offers the following options: <variablelist> +<term><guilabel>Prompt on Replace</guilabel></term> +<listitem><para>If checked, a small dialogue will prompt you for what to do for each time a match is found. It offers the following options: <variablelist> <varlistentry> -<term -><guibutton ->Yes</guibutton -></term> -<listitem -><para ->Activate this to replace the current match (which is selected in the editor).</para -></listitem -> +<term><guibutton>Yes</guibutton></term> +<listitem><para>Activate this to replace the current match (which is selected in the editor).</para></listitem> </varlistentry> <varlistentry> -<term -><guibutton ->No</guibutton -></term> -<listitem -><para ->Activate to skip the current match, and try to find another one.</para -></listitem> +<term><guibutton>No</guibutton></term> +<listitem><para>Activate to skip the current match, and try to find another one.</para></listitem> </varlistentry> <varlistentry> -<term -><guibutton ->All</guibutton -></term> -<listitem -><para ->Activate to cancel prompting, and just replace all matches.</para -></listitem -> +<term><guibutton>All</guibutton></term> +<listitem><para>Activate to cancel prompting, and just replace all matches.</para></listitem> </varlistentry> <varlistentry> -<term -><guibutton ->Close</guibutton -></term> -<listitem -><para ->Activate this skip the current match and end the searching.</para -></listitem -> +<term><guibutton>Close</guibutton></term> +<listitem><para>Activate this skip the current match and end the searching.</para></listitem> </varlistentry> </variablelist> -</para -></listitem> +</para></listitem> </varlistentry> </variablelist> <note> -<para ->There is currently no way to use minimal matching when searching for a regular expression. This will be added in a future version of &kate;</para -> +<para>There is currently no way to use minimal matching when searching for a regular expression. This will be added in a future version of &kate;</para> </note> </sect2> <sect2 id="finding-text"> -<title ->Finding Text</title> - -<para ->To find text, launch the <guilabel ->Find Text</guilabel -> Dialogue with <keycombo action="simul" ->&Ctrl;<keycap ->F</keycap -></keycombo ->or from the <menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Find...</guimenuitem -></menuchoice -> menu item,enter a search string, set the <link linkend="find-replace-dialog" ->options</link -> as desired and hit <guibutton ->Ok</guibutton ->. If no matches is found between the starting point for the search (either the text cursor position or the beginning of the document) you will be prompted for permission to continue from the start (or end, if you are searching backwards) of the document.</para> - -<para ->If a match is found it is selected and the <guilabel ->Find Text</guilabel -> Dialogue is hidden, but stay tuned, finding further matches is very easy:</para> - -<para ->To find the next match in the search direction, use the <menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Find Next</guimenuitem -></menuchoice -> command or press <keycap ->F3</keycap ->.</para> - -<para ->To find the next match in the opposite direction, use the <menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Find Previous</guimenuitem -></menuchoice -> command or press <keycombo action="simul" ->&Shift;<keycap ->F3</keycap -></keycombo ->.</para> - -<para ->If no match is found before reaching the document border, you will be prompted for permission to cross that.</para> +<title>Finding Text</title> + +<para>To find text, launch the <guilabel>Find Text</guilabel> Dialogue with <keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>or from the <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Find...</guimenuitem></menuchoice> menu item,enter a search string, set the <link linkend="find-replace-dialog">options</link> as desired and hit <guibutton>Ok</guibutton>. If no matches is found between the starting point for the search (either the text cursor position or the beginning of the document) you will be prompted for permission to continue from the start (or end, if you are searching backwards) of the document.</para> + +<para>If a match is found it is selected and the <guilabel>Find Text</guilabel> Dialogue is hidden, but stay tuned, finding further matches is very easy:</para> + +<para>To find the next match in the search direction, use the <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Find Next</guimenuitem></menuchoice> command or press <keycap>F3</keycap>.</para> + +<para>To find the next match in the opposite direction, use the <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Find Previous</guimenuitem></menuchoice> command or press <keycombo action="simul">&Shift;<keycap>F3</keycap></keycombo>.</para> + +<para>If no match is found before reaching the document border, you will be prompted for permission to cross that.</para> </sect2> <sect2> -<title ->Replacing Text</title> - -<para ->To replace text, launch the <guilabel ->Replace text</guilabel -> Dialogue using the <menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Replace</guimenuitem -></menuchoice -> command, or the <keycombo action="simul" ->&Ctrl;<keycap ->R</keycap -></keycombo -> shortcut, enter a search string and optionally a replace string (if the replace string is empty, each match will be replaced with ""), set the <link linkend="find-replace-dialog" ->options</link -> as desired and hit the <guibutton ->Ok</guibutton -> button.</para> +<title>Replacing Text</title> + +<para>To replace text, launch the <guilabel>Replace text</guilabel> Dialogue using the <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Replace</guimenuitem></menuchoice> command, or the <keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo> shortcut, enter a search string and optionally a replace string (if the replace string is empty, each match will be replaced with ""), set the <link linkend="find-replace-dialog">options</link> as desired and hit the <guibutton>Ok</guibutton> button.</para> <tip> -<para ->If you are using a regular expression to find the text to replace, you can employ backreferences to reuse text captured in parenthesised subpatterns of the expression.</para> -<para ->See <xref linkend="regular-expressions"/> for more on these.</para> +<para>If you are using a regular expression to find the text to replace, you can employ backreferences to reuse text captured in parenthesised subpatterns of the expression.</para> +<para>See <xref linkend="regular-expressions"/> for more on these.</para> </tip> </sect2> @@ -632,100 +292,48 @@ </sect1> <sect1 id="kate-part-bookmarks"> -<title ->Using Bookmarks</title> +<title>Using Bookmarks</title> -<para ->The bookmarks feature allows you to mark certain lines, to be able to easily find them again.</para> +<para>The bookmarks feature allows you to mark certain lines, to be able to easily find them again.</para> -<para ->You can set or remove a bookmark in a line in two ways:</para> +<para>You can set or remove a bookmark in a line in two ways:</para> <itemizedlist> <listitem> -<para ->Moving the insertion cursor to that line, and activate the <menuchoice -><guimenu ->Bookmarks</guimenu -><guimenuitem ->Toggle Bookmark</guimenuitem -></menuchoice -> (<keycombo action="simul" ->&Ctrl;<keycap ->B</keycap -></keycombo ->) command.</para -> +<para>Moving the insertion cursor to that line, and activate the <menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Toggle Bookmark</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo>) command.</para> </listitem> <listitem> -<para ->Clicking in the Icon Border next to that line.</para> +<para>Clicking in the Icon Border next to that line.</para> </listitem> </itemizedlist> -<para ->Bookmarks are available in the <guimenu ->Bookmarks</guimenu -> menu. The individual bookmarks are available as menu items, labelled with the line number of the line with the bookmark, and the first few characters of the text in the line. To move the insertion cursor to the beginning of a bookmarked line, open the menu and select the bookmark.</para> +<para>Bookmarks are available in the <guimenu>Bookmarks</guimenu> menu. The individual bookmarks are available as menu items, labelled with the line number of the line with the bookmark, and the first few characters of the text in the line. To move the insertion cursor to the beginning of a bookmarked line, open the menu and select the bookmark.</para> <tip> -<para ->If the <link linkend="config-dialog-general-reopen-files" ->Reopen Files</link -> option in the <link linkend="config-dialog" ->Config Dialogue</link -> is enabled (or if &kate; was started by the session manager), your bookmarks will be restored when the document is reopened.</para> +<para>If the <link linkend="config-dialog-general-reopen-files">Reopen Files</link> option in the <link linkend="config-dialog">Config Dialogue</link> is enabled (or if &kate; was started by the session manager), your bookmarks will be restored when the document is reopened.</para> </tip> </sect1> <sect1 id="kate-part-auto-wrap"> -<title ->Automatically Wrapping text</title> - -<para ->This feature allows you to have the text formatted in a very simple way: the text will be wrapped, so that no lines exceed a maximum number of characters per line, unless there is a longer string of non-whitespace characters.</para> - -<para ->To enable/disable it, check/uncheck the <guibutton ->Word Wrap</guibutton -> checkbox in the <link linkend="config-dialog-editor-edit" ->edit page</link -> of the <link linkend="config-dialog" ->configuration dialogue</link ->.</para> - -<para ->To set the maximum line width (maximum characters per line), use the <link linkend="config-dialog-editor-edit-wrap-words-at" -><guibutton ->Wrap Words At</guibutton -></link -> option in the <link linkend="config-dialog-editor-edit" ->edit page</link -> of the <link linkend="config-dialog" ->configuration dialogue</link ->.</para> - -<para ->If enabled, it has the following effects: <itemizedlist> -<listitem -><para ->While typing, the editor will automatically insert a hard line break after the last whitespace character at a position before the maximum line width is reached.</para -></listitem> -<listitem -><para ->While loading a document, the editor will wrap the text in a similar way, so that no lines are longer than the maximum line width, if they contain any whitespace allowing that.</para -></listitem> +<title>Automatically Wrapping text</title> + +<para>This feature allows you to have the text formatted in a very simple way: the text will be wrapped, so that no lines exceed a maximum number of characters per line, unless there is a longer string of non-whitespace characters.</para> + +<para>To enable/disable it, check/uncheck the <guibutton>Word Wrap</guibutton> checkbox in the <link linkend="config-dialog-editor-edit">edit page</link> of the <link linkend="config-dialog">configuration dialogue</link>.</para> + +<para>To set the maximum line width (maximum characters per line), use the <link linkend="config-dialog-editor-edit-wrap-words-at"><guibutton>Wrap Words At</guibutton></link> option in the <link linkend="config-dialog-editor-edit">edit page</link> of the <link linkend="config-dialog">configuration dialogue</link>.</para> + +<para>If enabled, it has the following effects: <itemizedlist> +<listitem><para>While typing, the editor will automatically insert a hard line break after the last whitespace character at a position before the maximum line width is reached.</para></listitem> +<listitem><para>While loading a document, the editor will wrap the text in a similar way, so that no lines are longer than the maximum line width, if they contain any whitespace allowing that.</para></listitem> </itemizedlist> </para> -<note -><para ->There is currently no way to set word wrap for document types, or even to enable or disable the feature on document level. This will be fixed in a future version of &kate;</para -></note> +<note><para>There is currently no way to set word wrap for document types, or even to enable or disable the feature on document level. This will be fixed in a future version of &kate;</para></note> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kate/plugins.docbook b/tde-i18n-en_GB/docs/tdebase/kate/plugins.docbook index 6431b95829c..5f0bbaa1ffe 100644 --- a/tde-i18n-en_GB/docs/tdebase/kate/plugins.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kate/plugins.docbook @@ -1,32 +1,11 @@ <chapter id="plugins"> <chapterinfo> <authorgroup> -<author -><personname -><firstname -></firstname -></personname -></author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author><personname><firstname></firstname></personname></author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </chapterinfo> -<title ->Working with Plugins</title> -<para ->This chapter will describe topics related to using plugins</para> +<title>Working with Plugins</title> +<para>This chapter will describe topics related to using plugins</para> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/kate/regular-expressions.docbook b/tde-i18n-en_GB/docs/tdebase/kate/regular-expressions.docbook index c692da92cd5..5adc38a3f0c 100644 --- a/tde-i18n-en_GB/docs/tdebase/kate/regular-expressions.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kate/regular-expressions.docbook @@ -1,491 +1,162 @@ <appendix id="regular-expressions"> <appendixinfo> <authorgroup> -<author ->&Anders.Lund; &Anders.Lund.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </appendixinfo> -<title ->Regular Expressions</title> +<title>Regular Expressions</title> -<synopsis ->This Appendix contains a brief but hopefully sufficient and -covering introduction to the world of <emphasis ->regular -expressions</emphasis ->. It documents regular expressions in the form +<synopsis>This Appendix contains a brief but hopefully sufficient and +covering introduction to the world of <emphasis>regular +expressions</emphasis>. It documents regular expressions in the form available within &kate;, which is not compatible with the regular expressions of perl, nor with those of for example -<command ->grep</command ->.</synopsis> +<command>grep</command>.</synopsis> <sect1> -<title ->Introduction</title> - -<para -><emphasis ->Regular Expressions</emphasis -> provides us with a way to describe some possible contents of a text string in a way understood by a small piece of software, so that it can investigate if a text matches, and also in the case of advanced applications with the means of saving pieces or the matching text.</para> - -<para ->An example: Say you want to search a text for paragraphs that starts with either of the names <quote ->Henrik</quote -> or <quote ->Pernille</quote -> followed by some form of the verb <quote ->say</quote ->.</para> - -<para ->With a normal search, you would start out searching for the first name, <quote ->Henrik</quote -> maybe followed by <quote ->sa</quote -> like this: <userinput ->Henrik sa</userinput ->, and while looking for matches, you would have to discard those not being the beginning of a paragraph, as well as those in which the word starting with the letters <quote ->sa</quote -> was not either <quote ->says</quote ->, <quote ->said</quote -> or so. And then of cause repeat all of that with the next name...</para> - -<para ->With Regular Expressions, that task could be accomplished with a single search, and with a larger degree of preciseness.</para> - -<para ->To achieve this, Regular Expressions defines rules for expressing in details a generalisation of a string to match. Our example, which we might literally express like this: <quote ->A line starting with either <quote ->Henrik</quote -> or <quote ->Pernille</quote -> (possibly following up to 4 blanks or tab characters) followed by a whitespace followed by <quote ->sa</quote -> and then either <quote ->ys</quote -> or <quote ->id</quote -></quote -> could be expressed with the following regular expression:</para -> <para -><userinput ->^[ \t]{0,4}(Henrik|Pernille) sa(ys|id)</userinput -></para> - -<para ->The above example demonstrates all four major concepts of modern Regular Expressions, namely:</para> +<title>Introduction</title> + +<para><emphasis>Regular Expressions</emphasis> provides us with a way to describe some possible contents of a text string in a way understood by a small piece of software, so that it can investigate if a text matches, and also in the case of advanced applications with the means of saving pieces or the matching text.</para> + +<para>An example: Say you want to search a text for paragraphs that starts with either of the names <quote>Henrik</quote> or <quote>Pernille</quote> followed by some form of the verb <quote>say</quote>.</para> + +<para>With a normal search, you would start out searching for the first name, <quote>Henrik</quote> maybe followed by <quote>sa</quote> like this: <userinput>Henrik sa</userinput>, and while looking for matches, you would have to discard those not being the beginning of a paragraph, as well as those in which the word starting with the letters <quote>sa</quote> was not either <quote>says</quote>, <quote>said</quote> or so. And then of cause repeat all of that with the next name...</para> + +<para>With Regular Expressions, that task could be accomplished with a single search, and with a larger degree of preciseness.</para> + +<para>To achieve this, Regular Expressions defines rules for expressing in details a generalisation of a string to match. Our example, which we might literally express like this: <quote>A line starting with either <quote>Henrik</quote> or <quote>Pernille</quote> (possibly following up to 4 blanks or tab characters) followed by a whitespace followed by <quote>sa</quote> and then either <quote>ys</quote> or <quote>id</quote></quote> could be expressed with the following regular expression:</para> <para><userinput>^[ \t]{0,4}(Henrik|Pernille) sa(ys|id)</userinput></para> + +<para>The above example demonstrates all four major concepts of modern Regular Expressions, namely:</para> <itemizedlist> -<listitem -><para ->Patterns</para -></listitem> -<listitem -><para ->Assertions</para -></listitem> -<listitem -><para ->Quantifiers</para -></listitem> -<listitem -><para ->Back references</para -></listitem> +<listitem><para>Patterns</para></listitem> +<listitem><para>Assertions</para></listitem> +<listitem><para>Quantifiers</para></listitem> +<listitem><para>Back references</para></listitem> </itemizedlist> -<para ->The caret (<literal ->^</literal ->) starting the expression is an assertion, being true only if the following matching string is at the start of a line.</para> - -<para ->The stings <literal ->[ \t]</literal -> and <literal ->(Henrik|Pernille) sa(ys|id)</literal -> are patterns. The first one is a <emphasis ->character class</emphasis -> that matches either a blank or a (horizontal) tab character; the other pattern contains first a subpattern matching either <literal ->Henrik</literal -> <emphasis ->or</emphasis -> <literal ->Pernille</literal ->, then a piece matching the exact string <literal -> sa</literal -> and finally a subpattern matching either <literal ->ys</literal -> <emphasis ->or</emphasis -> <literal ->id</literal -></para> - -<para ->The string <literal ->{0,4}</literal -> is a quantifier saying <quote ->anywhere from 0 up to 4 of the previous</quote ->.</para> - -<para ->Because regular expression software supporting the concept of <emphasis ->back references</emphasis -> saves the entire matching part of the string as well as sub-patterns enclosed in parentheses, given some means of access to those references, we could get our hands on either the whole match (when searching a text document in an editor with a regular expression, that is often marked as selected) or either the name found, or the last part of the verb.</para> - -<para ->All together, the expression will match where we wanted it to, and only there.</para> - -<para ->The following sections will describe in details how to construct and use patterns, character classes, assertions, quantifiers and back references, and the final section will give a few useful examples.</para> +<para>The caret (<literal>^</literal>) starting the expression is an assertion, being true only if the following matching string is at the start of a line.</para> + +<para>The stings <literal>[ \t]</literal> and <literal>(Henrik|Pernille) sa(ys|id)</literal> are patterns. The first one is a <emphasis>character class</emphasis> that matches either a blank or a (horizontal) tab character; the other pattern contains first a subpattern matching either <literal>Henrik</literal> <emphasis>or</emphasis> <literal>Pernille</literal>, then a piece matching the exact string <literal> sa</literal> and finally a subpattern matching either <literal>ys</literal> <emphasis>or</emphasis> <literal>id</literal></para> + +<para>The string <literal>{0,4}</literal> is a quantifier saying <quote>anywhere from 0 up to 4 of the previous</quote>.</para> + +<para>Because regular expression software supporting the concept of <emphasis>back references</emphasis> saves the entire matching part of the string as well as sub-patterns enclosed in parentheses, given some means of access to those references, we could get our hands on either the whole match (when searching a text document in an editor with a regular expression, that is often marked as selected) or either the name found, or the last part of the verb.</para> + +<para>All together, the expression will match where we wanted it to, and only there.</para> + +<para>The following sections will describe in details how to construct and use patterns, character classes, assertions, quantifiers and back references, and the final section will give a few useful examples.</para> </sect1> <sect1 id="regex-patterns"> -<title ->Patterns</title> +<title>Patterns</title> -<para ->Patterns consists of literal strings and character classes. Patterns may contain sub-patterns, which are patterns enclosed in parentheses.</para> +<para>Patterns consists of literal strings and character classes. Patterns may contain sub-patterns, which are patterns enclosed in parentheses.</para> <sect2> -<title ->Escaping characters</title> +<title>Escaping characters</title> -<para ->In patterns as well as in character classes, some characters have a special meaning. To literally match any of those characters, they must be marked or <emphasis ->escaped</emphasis -> to let the regular expression software know that it should interpret such characters in their literal meaning.</para> +<para>In patterns as well as in character classes, some characters have a special meaning. To literally match any of those characters, they must be marked or <emphasis>escaped</emphasis> to let the regular expression software know that it should interpret such characters in their literal meaning.</para> -<para ->This is done by prepending the character with a backslash (<literal ->\</literal ->).</para> +<para>This is done by prepending the character with a backslash (<literal>\</literal>).</para> -<para ->The regular expression software will silently ignore escaping a character that does not have any special meaning in the context, so escaping for example a <quote ->j</quote -> (<userinput ->\j</userinput ->) is safe. If you are in doubt whether a character could have a special meaning, you can therefore escape it safely.</para> +<para>The regular expression software will silently ignore escaping a character that does not have any special meaning in the context, so escaping for example a <quote>j</quote> (<userinput>\j</userinput>) is safe. If you are in doubt whether a character could have a special meaning, you can therefore escape it safely.</para> -<para ->Escaping of cause includes the backslash character it self, to literally match a such, you would write <userinput ->\\</userinput ->.</para> +<para>Escaping of cause includes the backslash character it self, to literally match a such, you would write <userinput>\\</userinput>.</para> </sect2> <sect2> -<title ->Character Classes and abbreviations</title> - -<para ->A <emphasis ->character class</emphasis -> is an expression that matches one of a defined set of characters. In Regular Expressions, character classes are defined by putting the legal characters for the class in square brackets, <literal ->[]</literal ->, or by using one of the abbreviated classes described below.</para> - -<para ->Simple character classes just contains one or more literal characters, for example <userinput ->[abc]</userinput -> (matching either of the letters <quote ->a</quote ->, <quote ->b</quote -> or <quote ->c</quote ->) or <userinput ->[0123456789]</userinput -> (matching any digit).</para> - -<para ->Because letters and digits have a logical order, you can abbreviate those by specifying ranges of them: <userinput ->[a-c]</userinput -> is equal to <userinput ->[abc]</userinput -> and <userinput ->[0-9]</userinput -> is equal to <userinput ->[0123456789]</userinput ->. Combining these constructs, for example <userinput ->[a-fynot1-38]</userinput -> is completely legal (the last one would match, of cause, either of <quote ->a</quote ->,<quote ->b</quote ->,<quote ->c</quote ->,<quote ->d</quote ->, <quote ->e</quote ->,<quote ->f</quote ->,<quote ->y</quote ->,<quote ->n</quote ->,<quote ->o</quote ->,<quote ->t</quote ->, <quote ->1</quote ->,<quote ->2</quote ->,<quote ->3</quote -> or <quote ->8</quote ->).</para> - -<para ->As capital letters are different characters from their non-capital equivalents, to create a caseless character class matching <quote ->a</quote -> or <quote ->b</quote ->, in any case, you need to write it <userinput ->[aAbB]</userinput ->.</para> - -<para ->It is of cause possible to create a <quote ->negative</quote -> class matching as <quote ->anything but</quote -> To do so put a caret (<literal ->^</literal ->) at the beginning of the class: </para> - -<para -><userinput ->[^abc]</userinput -> will match any character <emphasis ->but</emphasis -> <quote ->a</quote ->, <quote ->b</quote -> or <quote ->c</quote ->.</para> - -<para ->In addition to literal characters, some abbreviations are defined, making life still a bit easier: <variablelist> +<title>Character Classes and abbreviations</title> + +<para>A <emphasis>character class</emphasis> is an expression that matches one of a defined set of characters. In Regular Expressions, character classes are defined by putting the legal characters for the class in square brackets, <literal>[]</literal>, or by using one of the abbreviated classes described below.</para> + +<para>Simple character classes just contains one or more literal characters, for example <userinput>[abc]</userinput> (matching either of the letters <quote>a</quote>, <quote>b</quote> or <quote>c</quote>) or <userinput>[0123456789]</userinput> (matching any digit).</para> + +<para>Because letters and digits have a logical order, you can abbreviate those by specifying ranges of them: <userinput>[a-c]</userinput> is equal to <userinput>[abc]</userinput> and <userinput>[0-9]</userinput> is equal to <userinput>[0123456789]</userinput>. Combining these constructs, for example <userinput>[a-fynot1-38]</userinput> is completely legal (the last one would match, of cause, either of <quote>a</quote>,<quote>b</quote>,<quote>c</quote>,<quote>d</quote>, <quote>e</quote>,<quote>f</quote>,<quote>y</quote>,<quote>n</quote>,<quote>o</quote>,<quote>t</quote>, <quote>1</quote>,<quote>2</quote>,<quote>3</quote> or <quote>8</quote>).</para> + +<para>As capital letters are different characters from their non-capital equivalents, to create a caseless character class matching <quote>a</quote> or <quote>b</quote>, in any case, you need to write it <userinput>[aAbB]</userinput>.</para> + +<para>It is of cause possible to create a <quote>negative</quote> class matching as <quote>anything but</quote> To do so put a caret (<literal>^</literal>) at the beginning of the class: </para> + +<para><userinput>[^abc]</userinput> will match any character <emphasis>but</emphasis> <quote>a</quote>, <quote>b</quote> or <quote>c</quote>.</para> + +<para>In addition to literal characters, some abbreviations are defined, making life still a bit easier: <variablelist> <varlistentry> -<term -><userinput ->\a</userinput -></term> -<listitem -><para ->This matches the <acronym ->ASCII</acronym -> bell character (BEL, 0x07).</para -></listitem> +<term><userinput>\a</userinput></term> +<listitem><para>This matches the <acronym>ASCII</acronym> bell character (BEL, 0x07).</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->\f</userinput -></term> -<listitem -><para ->This matches the <acronym ->ASCII</acronym -> form feed character (FF, 0x0C).</para -></listitem> +<term><userinput>\f</userinput></term> +<listitem><para>This matches the <acronym>ASCII</acronym> form feed character (FF, 0x0C).</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->\n</userinput -></term> -<listitem -><para ->This matches the <acronym ->ASCII</acronym -> line feed character (LF, 0x0A, Unix newline).</para -></listitem> +<term><userinput>\n</userinput></term> +<listitem><para>This matches the <acronym>ASCII</acronym> line feed character (LF, 0x0A, Unix newline).</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->\r</userinput -></term> -<listitem -><para ->This matches the <acronym ->ASCII</acronym -> carriage return character (CR, 0x0D).</para -></listitem> +<term><userinput>\r</userinput></term> +<listitem><para>This matches the <acronym>ASCII</acronym> carriage return character (CR, 0x0D).</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->\t</userinput -></term> -<listitem -><para ->This matches the <acronym ->ASCII</acronym -> horizontal tab character (HT, 0x09).</para -></listitem> +<term><userinput>\t</userinput></term> +<listitem><para>This matches the <acronym>ASCII</acronym> horizontal tab character (HT, 0x09).</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->\v</userinput -></term> -<listitem -><para ->This matches the <acronym ->ASCII</acronym -> vertical tab character (VT, 0x0B).</para -></listitem> +<term><userinput>\v</userinput></term> +<listitem><para>This matches the <acronym>ASCII</acronym> vertical tab character (VT, 0x0B).</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->\xhhhh</userinput -></term> - -<listitem -><para ->This matches the Unicode character corresponding to the hexadecimal number hhhh (between 0x0000 and 0xFFFF). \0ooo (&ie;, \zero ooo) matches the <acronym ->ASCII</acronym ->/Latin-1 character corresponding to the octal number ooo (between 0 and 0377).</para -></listitem> +<term><userinput>\xhhhh</userinput></term> + +<listitem><para>This matches the Unicode character corresponding to the hexadecimal number hhhh (between 0x0000 and 0xFFFF). \0ooo (&ie;, \zero ooo) matches the <acronym>ASCII</acronym>/Latin-1 character corresponding to the octal number ooo (between 0 and 0377).</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->.</userinput -> (dot)</term> -<listitem -><para ->This matches any character (including newline).</para -></listitem> +<term><userinput>.</userinput> (dot)</term> +<listitem><para>This matches any character (including newline).</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->\d</userinput -></term> -<listitem -><para ->This matches a digit. Equal to <literal ->[0-9]</literal -></para -></listitem> +<term><userinput>\d</userinput></term> +<listitem><para>This matches a digit. Equal to <literal>[0-9]</literal></para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->\D</userinput -></term> -<listitem -><para ->This matches a non-digit. Equal to <literal ->[^0-9]</literal -> or <literal ->[^\d]</literal -></para -></listitem> +<term><userinput>\D</userinput></term> +<listitem><para>This matches a non-digit. Equal to <literal>[^0-9]</literal> or <literal>[^\d]</literal></para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->\s</userinput -></term> -<listitem -><para ->This matches a whitespace character. Practically equal to <literal ->[ \t\n\r]</literal -></para -></listitem> +<term><userinput>\s</userinput></term> +<listitem><para>This matches a whitespace character. Practically equal to <literal>[ \t\n\r]</literal></para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->\S</userinput -></term> -<listitem -><para ->This matches a non-whitespace. Practically equal to <literal ->[^ \t\r\n]</literal ->, and equal to <literal ->[^\s]</literal -></para -></listitem> +<term><userinput>\S</userinput></term> +<listitem><para>This matches a non-whitespace. Practically equal to <literal>[^ \t\r\n]</literal>, and equal to <literal>[^\s]</literal></para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->\w</userinput -></term> -<listitem -><para ->Matches any <quote ->word character</quote -> - in this case any letter or digit. Note that underscore (<literal ->_</literal ->) is not matched, as is the case with perl regular expressions. Equal to <literal ->[a-zA-Z0-9]</literal -></para -></listitem> +<term><userinput>\w</userinput></term> +<listitem><para>Matches any <quote>word character</quote> - in this case any letter or digit. Note that underscore (<literal>_</literal>) is not matched, as is the case with perl regular expressions. Equal to <literal>[a-zA-Z0-9]</literal></para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->\W</userinput -></term> -<listitem -><para ->Matches any non-word character - anything but letters or numbers. Equal to <literal ->[^a-zA-Z0-9]</literal -> or <literal ->[^\w]</literal -></para -></listitem> +<term><userinput>\W</userinput></term> +<listitem><para>Matches any non-word character - anything but letters or numbers. Equal to <literal>[^a-zA-Z0-9]</literal> or <literal>[^\w]</literal></para></listitem> </varlistentry> @@ -493,69 +164,31 @@ expressions of perl, nor with those of for example </para> -<para ->The abbreviated classes can be put inside a custom class, for example to match a word character, a blank or a dot, you could write <userinput ->[\w \.]</userinput -></para -> +<para>The abbreviated classes can be put inside a custom class, for example to match a word character, a blank or a dot, you could write <userinput>[\w \.]</userinput></para> -<note -> <para ->The POSIX notation of classes, <userinput ->[:<class name>:]</userinput -> is currently not supported.</para -> </note> +<note> <para>The POSIX notation of classes, <userinput>[:<class name>:]</userinput> is currently not supported.</para> </note> <sect3> -<title ->Characters with special meanings inside character classes</title> +<title>Characters with special meanings inside character classes</title> -<para ->The following characters has a special meaning inside the <quote ->[]</quote -> character class construct, and must be escaped to be literally included in a class:</para> +<para>The following characters has a special meaning inside the <quote>[]</quote> character class construct, and must be escaped to be literally included in a class:</para> <variablelist> <varlistentry> -<term -><userinput ->]</userinput -></term> -<listitem -><para ->Ends the character class. Must be escaped unless it is the very first character in the class (may follow an unescaped caret)</para -></listitem> +<term><userinput>]</userinput></term> +<listitem><para>Ends the character class. Must be escaped unless it is the very first character in the class (may follow an unescaped caret)</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->^</userinput -> (caret)</term> -<listitem -><para ->Denotes a negative class, if it is the first character. Must be escaped to match literally if it is the first character in the class.</para -></listitem -> +<term><userinput>^</userinput> (caret)</term> +<listitem><para>Denotes a negative class, if it is the first character. Must be escaped to match literally if it is the first character in the class.</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->-</userinput -> (dash)</term> -<listitem -><para ->Denotes a logical range. Must always be escaped within a character class.</para -></listitem> +<term><userinput>-</userinput> (dash)</term> +<listitem><para>Denotes a logical range. Must always be escaped within a character class.</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->\</userinput -> (backslash)</term> -<listitem -><para ->The escape character. Must always be escaped.</para -></listitem> +<term><userinput>\</userinput> (backslash)</term> +<listitem><para>The escape character. Must always be escaped.</para></listitem> </varlistentry> </variablelist> @@ -566,240 +199,110 @@ expressions of perl, nor with those of for example <sect2> -<title ->Alternatives: matching <quote ->one of</quote -></title> - -<para ->If you want to match one of a set of alternative patterns, you can separate those with <literal ->|</literal -> (vertical bar character).</para> - -<para ->For example to find either <quote ->John</quote -> or <quote ->Harry</quote -> you would use an expression <userinput ->John|Harry</userinput ->.</para> +<title>Alternatives: matching <quote>one of</quote></title> + +<para>If you want to match one of a set of alternative patterns, you can separate those with <literal>|</literal> (vertical bar character).</para> + +<para>For example to find either <quote>John</quote> or <quote>Harry</quote> you would use an expression <userinput>John|Harry</userinput>.</para> </sect2> <sect2> -<title ->Sub Patterns</title> +<title>Sub Patterns</title> -<para -><emphasis ->Sub patterns</emphasis -> are patterns enclosed in parentheses, and they have several uses in the world of regular expressions.</para> +<para><emphasis>Sub patterns</emphasis> are patterns enclosed in parentheses, and they have several uses in the world of regular expressions.</para> <sect3> -<title ->Specifying alternatives</title> - -<para ->You may use a sub pattern to group a set of alternatives within a larger pattern. The alternatives are separated by the character <quote ->|</quote -> (vertical bar).</para> - -<para ->For example to match either of the words <quote ->int</quote ->, <quote ->float</quote -> or <quote ->double</quote ->, you could use the pattern <userinput ->int|float|double</userinput ->. If you only want to find one if it is followed by some whitespace and then some letters, put the alternatives inside a subpattern: <userinput ->(int|float|double)\s+\w+</userinput ->.</para> +<title>Specifying alternatives</title> + +<para>You may use a sub pattern to group a set of alternatives within a larger pattern. The alternatives are separated by the character <quote>|</quote> (vertical bar).</para> + +<para>For example to match either of the words <quote>int</quote>, <quote>float</quote> or <quote>double</quote>, you could use the pattern <userinput>int|float|double</userinput>. If you only want to find one if it is followed by some whitespace and then some letters, put the alternatives inside a subpattern: <userinput>(int|float|double)\s+\w+</userinput>.</para> </sect3> <sect3> -<title ->Capturing matching text (back references)</title> - -<para ->If you want to use a back reference, use a sub pattern to have the desired part of the pattern remembered.</para> - -<para ->For example, it you want to find two occurrences of the same word separated by a comma and possibly some whitespace, you could write <userinput ->(\w+),\s*\1</userinput ->. The sub pattern <literal ->\w+</literal -> would find a chunk of word characters, and the entire expression would match if those were followed by a comma, 0 or more whitespace and then an equal chunk of word characters. (The string <literal ->\1</literal -> references <emphasis ->the first sub pattern enclosed in parentheses</emphasis ->)</para> - -<!-- <para ->See also <link linkend="backreferences" ->Back references</link ->.</para -> --> +<title>Capturing matching text (back references)</title> + +<para>If you want to use a back reference, use a sub pattern to have the desired part of the pattern remembered.</para> + +<para>For example, it you want to find two occurrences of the same word separated by a comma and possibly some whitespace, you could write <userinput>(\w+),\s*\1</userinput>. The sub pattern <literal>\w+</literal> would find a chunk of word characters, and the entire expression would match if those were followed by a comma, 0 or more whitespace and then an equal chunk of word characters. (The string <literal>\1</literal> references <emphasis>the first sub pattern enclosed in parentheses</emphasis>)</para> + +<!-- <para>See also <link linkend="backreferences">Back references</link>.</para> --> </sect3> <sect3 id="lookahead-assertions"> -<title ->Lookahead Assertions</title> - -<para ->A lookahead assertion is a sub pattern, starting with either <literal ->?=</literal -> or <literal ->?!</literal ->.</para> - -<para ->For example to match the literal string <quote ->Bill</quote -> but only if not followed by <quote -> Gates</quote ->, you could use this expression: <userinput ->Bill(?! Gates)</userinput ->. (This would find <quote ->Bill Clinton</quote -> as well as <quote ->Billy the kid</quote ->, but silently ignore the other matches.)</para> - -<para ->Sub patterns used for assertions are not captured.</para> - -<para ->See also <link linkend="assertions" ->Assertions</link -></para> +<title>Lookahead Assertions</title> + +<para>A lookahead assertion is a sub pattern, starting with either <literal>?=</literal> or <literal>?!</literal>.</para> + +<para>For example to match the literal string <quote>Bill</quote> but only if not followed by <quote> Gates</quote>, you could use this expression: <userinput>Bill(?! Gates)</userinput>. (This would find <quote>Bill Clinton</quote> as well as <quote>Billy the kid</quote>, but silently ignore the other matches.)</para> + +<para>Sub patterns used for assertions are not captured.</para> + +<para>See also <link linkend="assertions">Assertions</link></para> </sect3> </sect2> <sect2 id="special-characters-in-patterns"> -<title ->Characters with a special meaning inside patterns</title> +<title>Characters with a special meaning inside patterns</title> -<para ->The following characters have meaning inside a pattern, and must be escaped if you want to literally match them: <variablelist> +<para>The following characters have meaning inside a pattern, and must be escaped if you want to literally match them: <variablelist> <varlistentry> -<term -><userinput ->\</userinput -> (backslash)</term> -<listitem -><para ->The escape character.</para -></listitem> +<term><userinput>\</userinput> (backslash)</term> +<listitem><para>The escape character.</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->^</userinput -> (caret)</term> -<listitem -><para ->Asserts the beginning of the string.</para -></listitem> +<term><userinput>^</userinput> (caret)</term> +<listitem><para>Asserts the beginning of the string.</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->$</userinput -></term> -<listitem -><para ->Asserts the end of string.</para -></listitem> +<term><userinput>$</userinput></term> +<listitem><para>Asserts the end of string.</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->()</userinput -> (left and right parentheses)</term> -<listitem -><para ->Denotes sub patterns.</para -></listitem> +<term><userinput>()</userinput> (left and right parentheses)</term> +<listitem><para>Denotes sub patterns.</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->{}</userinput -> (left and right curly braces)</term> -<listitem -><para ->Denotes numeric quantifiers.</para -></listitem> +<term><userinput>{}</userinput> (left and right curly braces)</term> +<listitem><para>Denotes numeric quantifiers.</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->[]</userinput -> (left and right square brackets)</term> -<listitem -><para ->Denotes character classes.</para -></listitem> +<term><userinput>[]</userinput> (left and right square brackets)</term> +<listitem><para>Denotes character classes.</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->|</userinput -> (vertical bar)</term> -<listitem -><para ->logical OR. Separates alternatives.</para -></listitem> +<term><userinput>|</userinput> (vertical bar)</term> +<listitem><para>logical OR. Separates alternatives.</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->+</userinput -> (plus sign)</term> -<listitem -><para ->Quantifier, 1 or more.</para -></listitem> +<term><userinput>+</userinput> (plus sign)</term> +<listitem><para>Quantifier, 1 or more.</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->*</userinput -> (asterisk)</term> -<listitem -><para ->Quantifier, 0 or more.</para -></listitem> +<term><userinput>*</userinput> (asterisk)</term> +<listitem><para>Quantifier, 0 or more.</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->?</userinput -> (question mark)</term> -<listitem -><para ->An optional character. Can be interpreted as a quantifier, 0 or 1.</para -></listitem> +<term><userinput>?</userinput> (question mark)</term> +<listitem><para>An optional character. Can be interpreted as a quantifier, 0 or 1.</para></listitem> </varlistentry> </variablelist> @@ -811,125 +314,58 @@ expressions of perl, nor with those of for example </sect1> <sect1 id="quantifiers"> -<title ->Quantifiers</title> - -<para -><emphasis ->Quantifiers</emphasis -> allows a regular expression to match a specified number or range of numbers of either a character, character class or sub pattern.</para> - -<para ->Quantifiers are enclosed in curly brackets (<literal ->{</literal -> and <literal ->}</literal ->) and have the general form <literal ->{[minimum-occurrences][,[maximum-occurrences]]}</literal -> </para> - -<para ->The usage is best explained by example: <variablelist> +<title>Quantifiers</title> + +<para><emphasis>Quantifiers</emphasis> allows a regular expression to match a specified number or range of numbers of either a character, character class or sub pattern.</para> + +<para>Quantifiers are enclosed in curly brackets (<literal>{</literal> and <literal>}</literal>) and have the general form <literal>{[minimum-occurrences][,[maximum-occurrences]]}</literal> </para> + +<para>The usage is best explained by example: <variablelist> <varlistentry> -<term -><userinput ->{1}</userinput -></term> -<listitem -><para ->Exactly 1 occurrence</para -></listitem> +<term><userinput>{1}</userinput></term> +<listitem><para>Exactly 1 occurrence</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->{0,1}</userinput -></term> -<listitem -><para ->Zero or 1 occurrences</para -></listitem> +<term><userinput>{0,1}</userinput></term> +<listitem><para>Zero or 1 occurrences</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->{,1}</userinput -></term> -<listitem -><para ->The same, with less work;)</para -></listitem> +<term><userinput>{,1}</userinput></term> +<listitem><para>The same, with less work;)</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->{5,10}</userinput -></term> -<listitem -><para ->At least 5 but maximum 10 occurrences.</para -></listitem> +<term><userinput>{5,10}</userinput></term> +<listitem><para>At least 5 but maximum 10 occurrences.</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->{5,}</userinput -></term> -<listitem -><para ->At least 5 occurrences, no maximum.</para -></listitem> +<term><userinput>{5,}</userinput></term> +<listitem><para>At least 5 occurrences, no maximum.</para></listitem> </varlistentry> </variablelist> </para> -<para ->Additionally, there are some abbreviations: <variablelist> +<para>Additionally, there are some abbreviations: <variablelist> <varlistentry> -<term -><userinput ->*</userinput -> (asterisk)</term> -<listitem -><para ->similar to <literal ->{0,}</literal ->, find any number of occurrences.</para -></listitem> +<term><userinput>*</userinput> (asterisk)</term> +<listitem><para>similar to <literal>{0,}</literal>, find any number of occurrences.</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->+</userinput -> (plus sign)</term> -<listitem -><para ->similar to <literal ->{1,}</literal ->, at least 1 occurrence.</para -></listitem> +<term><userinput>+</userinput> (plus sign)</term> +<listitem><para>similar to <literal>{1,}</literal>, at least 1 occurrence.</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->?</userinput -> (question mark)</term> -<listitem -><para ->similar to <literal ->{0,1}</literal ->, zero or 1 occurrence.</para -></listitem> +<term><userinput>?</userinput> (question mark)</term> +<listitem><para>similar to <literal>{0,1}</literal>, zero or 1 occurrence.</para></listitem> </varlistentry> </variablelist> @@ -938,98 +374,39 @@ expressions of perl, nor with those of for example <sect2> -<title ->Greed</title> +<title>Greed</title> -<para ->When using quantifiers with no maximum, regular expressions defaults to match as much of the searched string as possible, commonly known as <emphasis ->greedy</emphasis -> behaviour.</para> +<para>When using quantifiers with no maximum, regular expressions defaults to match as much of the searched string as possible, commonly known as <emphasis>greedy</emphasis> behaviour.</para> -<para ->Modern regular expression software provides the means of <quote ->turning off greediness</quote ->, though in a graphical environment it is up to the interface to provide you with access to this feature. For example a search dialogue providing a regular expression search could have a check box labelled <quote ->Minimal matching</quote -> as well as it ought to indicate if greediness is the default behaviour.</para> +<para>Modern regular expression software provides the means of <quote>turning off greediness</quote>, though in a graphical environment it is up to the interface to provide you with access to this feature. For example a search dialogue providing a regular expression search could have a check box labelled <quote>Minimal matching</quote> as well as it ought to indicate if greediness is the default behaviour.</para> </sect2> <sect2> -<title ->In context examples</title> +<title>In context examples</title> -<para ->Here are a few examples of using quantifiers</para> +<para>Here are a few examples of using quantifiers</para> <variablelist> <varlistentry> -<term -><userinput ->^\d{4,5}\s</userinput -></term> -<listitem -><para ->Matches the digits in <quote ->1234 go</quote -> and <quote ->12345 now</quote ->, but neither in <quote ->567 eleven</quote -> nor in <quote ->223459 somewhere</quote -></para -></listitem> +<term><userinput>^\d{4,5}\s</userinput></term> +<listitem><para>Matches the digits in <quote>1234 go</quote> and <quote>12345 now</quote>, but neither in <quote>567 eleven</quote> nor in <quote>223459 somewhere</quote></para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->\s+</userinput -></term> -<listitem -><para ->Matches one or more whitespace characters</para -></listitem> +<term><userinput>\s+</userinput></term> +<listitem><para>Matches one or more whitespace characters</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->(bla){1,}</userinput -></term> -<listitem -><para ->Matches all of <quote ->blablabla</quote -> and the <quote ->bla</quote -> in <quote ->blackbird</quote -> or <quote ->tabla</quote -></para -></listitem> +<term><userinput>(bla){1,}</userinput></term> +<listitem><para>Matches all of <quote>blablabla</quote> and the <quote>bla</quote> in <quote>blackbird</quote> or <quote>tabla</quote></para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->/?></userinput -></term> -<listitem -><para ->Matches <quote ->/></quote -> in <quote -><closeditem/></quote -> as well as <quote ->></quote -> in <quote -><openitem></quote ->.</para -></listitem> +<term><userinput>/?></userinput></term> +<listitem><para>Matches <quote>/></quote> in <quote><closeditem/></quote> as well as <quote>></quote> in <quote><openitem></quote>.</para></listitem> </varlistentry> </variablelist> @@ -1039,164 +416,56 @@ expressions of perl, nor with those of for example </sect1> <sect1 id="assertions"> -<title ->Assertions</title> - -<para -><emphasis ->Assertions</emphasis -> allows a regular expression to match only under certain controlled conditions.</para> - -<para ->An assertion does not need a character to match, it rather investigates the surroundings of a possible match before acknowledging it. For example the <emphasis ->word boundary</emphasis -> assertion does not try to find a non word character opposite a word one at its position, instead it makes sure that there is not a word character. This means that the assertion can match where there is no character, &ie; at the ends of a searched string.</para> - -<para ->Some assertions actually does have a pattern to match, but the part of the string matching that will not be a part of the result of the match of the full expression.</para> - -<para ->Regular Expressions as documented here supports the following assertions: <variablelist> - -<varlistentry -> -<term -><userinput ->^</userinput -> (caret: beginning of string)</term -> -<listitem -><para ->Matches the beginning of the searched string.</para -> <para ->The expression <userinput ->^Peter</userinput -> will match at <quote ->Peter</quote -> in the string <quote ->Peter, hey!</quote -> but not in <quote ->Hey, Peter!</quote -> </para -> </listitem> +<title>Assertions</title> + +<para><emphasis>Assertions</emphasis> allows a regular expression to match only under certain controlled conditions.</para> + +<para>An assertion does not need a character to match, it rather investigates the surroundings of a possible match before acknowledging it. For example the <emphasis>word boundary</emphasis> assertion does not try to find a non word character opposite a word one at its position, instead it makes sure that there is not a word character. This means that the assertion can match where there is no character, &ie; at the ends of a searched string.</para> + +<para>Some assertions actually does have a pattern to match, but the part of the string matching that will not be a part of the result of the match of the full expression.</para> + +<para>Regular Expressions as documented here supports the following assertions: <variablelist> + +<varlistentry> +<term><userinput>^</userinput> (caret: beginning of string)</term> +<listitem><para>Matches the beginning of the searched string.</para> <para>The expression <userinput>^Peter</userinput> will match at <quote>Peter</quote> in the string <quote>Peter, hey!</quote> but not in <quote>Hey, Peter!</quote> </para> </listitem> </varlistentry> <varlistentry> -<term -><userinput ->$</userinput -> (end of string)</term> -<listitem -><para ->Matches the end of the searched string.</para> - -<para ->The expression <userinput ->you\?$</userinput -> will match at the last you in the string <quote ->You didn't do that, did you?</quote -> but nowhere in <quote ->You didn't do that, right?</quote -></para> +<term><userinput>$</userinput> (end of string)</term> +<listitem><para>Matches the end of the searched string.</para> + +<para>The expression <userinput>you\?$</userinput> will match at the last you in the string <quote>You didn't do that, did you?</quote> but nowhere in <quote>You didn't do that, right?</quote></para> </listitem> </varlistentry> <varlistentry> -<term -><userinput ->\b</userinput -> (word boundary)</term> -<listitem -><para ->Matches if there is a word character at one side and not a word character at the other.</para> -<para ->This is useful to find word ends, for example both ends to find a whole word. The expression <userinput ->\bin\b</userinput -> will match at the separate <quote ->in</quote -> in the string <quote ->He came in through the window</quote ->, but not at the <quote ->in</quote -> in <quote ->window</quote ->.</para -></listitem> +<term><userinput>\b</userinput> (word boundary)</term> +<listitem><para>Matches if there is a word character at one side and not a word character at the other.</para> +<para>This is useful to find word ends, for example both ends to find a whole word. The expression <userinput>\bin\b</userinput> will match at the separate <quote>in</quote> in the string <quote>He came in through the window</quote>, but not at the <quote>in</quote> in <quote>window</quote>.</para></listitem> </varlistentry> <varlistentry> -<term -><userinput ->\B</userinput -> (non word boundary)</term> -<listitem -><para ->Matches wherever <quote ->\b</quote -> does not.</para> -<para ->That means that it will match for example within words: The expression <userinput ->\Bin\B</userinput -> will match at in <quote ->window</quote -> but not in <quote ->integer</quote -> or <quote ->I'm in love</quote ->.</para> +<term><userinput>\B</userinput> (non word boundary)</term> +<listitem><para>Matches wherever <quote>\b</quote> does not.</para> +<para>That means that it will match for example within words: The expression <userinput>\Bin\B</userinput> will match at in <quote>window</quote> but not in <quote>integer</quote> or <quote>I'm in love</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term -><userinput ->(?=PATTERN)</userinput -> (Positive lookahead)</term> -<listitem -><para ->A lookahead assertion looks at the part of the string following a possible match. The positive lookahead will prevent the string from matching if the text following the possible match does not match the <emphasis ->PATTERN</emphasis -> of the assertion, but the text matched by that will not be included in the result.</para> -<para ->The expression <userinput ->handy(?=\w)</userinput -> will match at <quote ->handy</quote -> in <quote ->handyman</quote -> but not in <quote ->That came in handy!</quote -></para> +<term><userinput>(?=PATTERN)</userinput> (Positive lookahead)</term> +<listitem><para>A lookahead assertion looks at the part of the string following a possible match. The positive lookahead will prevent the string from matching if the text following the possible match does not match the <emphasis>PATTERN</emphasis> of the assertion, but the text matched by that will not be included in the result.</para> +<para>The expression <userinput>handy(?=\w)</userinput> will match at <quote>handy</quote> in <quote>handyman</quote> but not in <quote>That came in handy!</quote></para> </listitem> </varlistentry> <varlistentry> -<term -><userinput ->(?!PATTERN)</userinput -> (Negative lookahead)</term> - -<listitem -><para ->The negative lookahead prevents a possible match to be acknowledged if the following part of the searched string does match its <emphasis ->PATTERN</emphasis ->.</para> -<para ->The expression <userinput ->const \w+\b(?!\s*&)</userinput -> will match at <quote ->const char</quote -> in the string <quote ->const char* foo</quote -> while it can not match <quote ->const QString</quote -> in <quote ->const QString& bar</quote -> because the <quote ->&</quote -> matches the negative lookahead assertion pattern.</para> +<term><userinput>(?!PATTERN)</userinput> (Negative lookahead)</term> + +<listitem><para>The negative lookahead prevents a possible match to be acknowledged if the following part of the searched string does match its <emphasis>PATTERN</emphasis>.</para> +<para>The expression <userinput>const \w+\b(?!\s*&)</userinput> will match at <quote>const char</quote> in the string <quote>const char* foo</quote> while it can not match <quote>const QString</quote> in <quote>const QString& bar</quote> because the <quote>&</quote> matches the negative lookahead assertion pattern.</para> </listitem> </varlistentry> @@ -1208,11 +477,9 @@ expressions of perl, nor with those of for example <!-- TODO sect1 id="backreferences"> -<title ->Back References</title> +<title>Back References</title> -<para -></para> +<para></para> </sect1 --> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/arts/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/arts/index.docbook index 7e2945de9fb..d6dc0909822 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/arts/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/arts/index.docbook @@ -3,292 +3,140 @@ "dtd/kdex.dtd" [ <!ENTITY midi-kcontrol SYSTEM "midi.docbook"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride;</author> -<author ->&Jost.Schenck;</author> +<author>&Mike.McBride;</author> +<author>&Jost.Schenck;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-04-01</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-04-01</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->sound server</keyword> -<keyword ->sound</keyword> -<keyword ->aRts</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>sound server</keyword> +<keyword>sound</keyword> +<keyword>aRts</keyword> </keywordset> </articleinfo> <sect1 id="sndserver"> -<title ->Sound System</title> +<title>Sound System</title> -<para ->This control module is used to configure the settings for the &arts; sound server (the &kde; sound server).</para> +<para>This control module is used to configure the settings for the &arts; sound server (the &kde; sound server).</para> <sect2 id="sndserver-general"> -<title ->&arts;</title> +<title>&arts;</title> -<para ->The top option, labelled <guilabel ->Start aRts soundserver on KDE startup</guilabel ->, enables (or disables) the &arts; sound server.</para> +<para>The top option, labelled <guilabel>Start aRts soundserver on KDE startup</guilabel>, enables (or disables) the &arts; sound server.</para> <tip> -<para ->You can find out more about &arts; in general by typing <userinput ->help:/artsbuilder</userinput -> into the &konqueror; location bar, or by finding the &arts-builder; documentation in &khelpcenter;. </para> +<para>You can find out more about &arts; in general by typing <userinput>help:/artsbuilder</userinput> into the &konqueror; location bar, or by finding the &arts-builder; documentation in &khelpcenter;. </para> </tip> -<para ->The rest of the panel consists of options for the &arts; sound server.</para> +<para>The rest of the panel consists of options for the &arts; sound server.</para> <variablelist> <varlistentry> -<term -><guilabel ->Enable network transparency</guilabel -></term> +<term><guilabel>Enable network transparency</guilabel></term> <listitem> -<para ->If this option is enabled, then sound requests from the network will be honoured by the sound server. If this option is disabled, the sound server will only honour requests from the local computer.</para> +<para>If this option is enabled, then sound requests from the network will be honoured by the sound server. If this option is disabled, the sound server will only honour requests from the local computer.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Exchange security and reference info over the X11 server</guilabel -></term> -<listitem -><para ->If you have enabled network transparency, this option will allow the exchange of security and reference information. If in doubt, and you have enabled network transparency, this option should be checked.</para -></listitem -> +<term><guilabel>Exchange security and reference info over the X11 server</guilabel></term> +<listitem><para>If you have enabled network transparency, this option will allow the exchange of security and reference information. If in doubt, and you have enabled network transparency, this option should be checked.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Run soundserver with realtime priority</guilabel -></term> -<listitem -><para ->Enabling this option will give the sound server priority over other applications, which will help alleviate any problems delivering uninterrupted sound.</para> -<note -><para ->This option may require permissions you do not have as a regular user.</para> -<para ->This option also relies on certain real time support from your system which may not be available.</para> -<para ->If you do not have the necessary permissions, or your system does not have the real time support necessary, enabling this option will not cause problems.</para -></note -></listitem> +<term><guilabel>Run soundserver with realtime priority</guilabel></term> +<listitem><para>Enabling this option will give the sound server priority over other applications, which will help alleviate any problems delivering uninterrupted sound.</para> +<note><para>This option may require permissions you do not have as a regular user.</para> +<para>This option also relies on certain real time support from your system which may not be available.</para> +<para>If you do not have the necessary permissions, or your system does not have the real time support necessary, enabling this option will not cause problems.</para></note></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Autosuspend if idle for:</guilabel -></term> +<term><guilabel>Autosuspend if idle for:</guilabel></term> <listitem> -<para ->Normally &arts; locks the sound card device, so that other applications cannot use it. If you enable this option, then if &arts; has been idle for the amount of time you set, it will suspend itself, allowing any application access to the sound hardware. If &arts; receives another request, it will unsuspend, and continue as normal. Enabling this option may cause a small delay when you start an &arts; application.</para> +<para>Normally &arts; locks the sound card device, so that other applications cannot use it. If you enable this option, then if &arts; has been idle for the amount of time you set, it will suspend itself, allowing any application access to the sound hardware. If &arts; receives another request, it will unsuspend, and continue as normal. Enabling this option may cause a small delay when you start an &arts; application.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Display messages using:</guilabel -></term> +<term><guilabel>Display messages using:</guilabel></term> <listitem> -<para ->The application that will be used to display messages from the &arts; server. The default is <application ->artsmessage</application -> and this should probably not be changed unless you have thoroughly read the &arts; documentation.</para> +<para>The application that will be used to display messages from the &arts; server. The default is <application>artsmessage</application> and this should probably not be changed unless you have thoroughly read the &arts; documentation.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Message Display</guilabel -></term> +<term><guilabel>Message Display</guilabel></term> <listitem> -<para ->You can select how detailed the messages are that &arts; displays to you. You can choose to see only error messages, debug messages that are useful to the developers (you probably only want that level if you are a developer, or one has asked you to set this). Or you can choose to see generally informational messages when &arts; is doing something such as suspending itself. </para> +<para>You can select how detailed the messages are that &arts; displays to you. You can choose to see only error messages, debug messages that are useful to the developers (you probably only want that level if you are a developer, or one has asked you to set this). Or you can choose to see generally informational messages when &arts; is doing something such as suspending itself. </para> </listitem> </varlistentry> </variablelist> -<para ->At the bottom of this page is a button that allows you to <guibutton ->Test Sound</guibutton ->.</para> +<para>At the bottom of this page is a button that allows you to <guibutton>Test Sound</guibutton>.</para> </sect2> <sect2 id="sndserver-soundio"> -<title ->Sound I/O</title> +<title>Sound I/O</title> -<para ->I/O means Input and Output, and this panel allows you to configure how &kde; and &arts; interact with your sound hardware.</para> +<para>I/O means Input and Output, and this panel allows you to configure how &kde; and &arts; interact with your sound hardware.</para> -<para ->The first option you can configure in the <guilabel ->Sound I/O</guilabel -> panel is the <guilabel ->Sound I/O method:</guilabel ->. It tells &arts; which sound system to use for input and output of sound. Current choices are <acronym ->ALSA</acronym -> (Advanced &Linux; Sound Architecture), <acronym ->OSS</acronym -> (Open Sound System), <acronym ->ESD</acronym -> (Enlightenment Sound Daemon), no audio at all and autodetect. In most cases <quote ->Autodetect</quote -> will be perfect for you.</para> +<para>The first option you can configure in the <guilabel>Sound I/O</guilabel> panel is the <guilabel>Sound I/O method:</guilabel>. It tells &arts; which sound system to use for input and output of sound. Current choices are <acronym>ALSA</acronym> (Advanced &Linux; Sound Architecture), <acronym>OSS</acronym> (Open Sound System), <acronym>ESD</acronym> (Enlightenment Sound Daemon), no audio at all and autodetect. In most cases <quote>Autodetect</quote> will be perfect for you.</para> -<para ->Other options are:</para> +<para>Other options are:</para> <variablelist> <varlistentry> -<term -><guilabel ->Enable full duplex operation</guilabel -></term> -<listitem -><para ->This option allows the sound server to play and record sound at the same time. This option should be enabled if you use applications (such as Internet telephones) which require simultaneous record and playback.</para -></listitem> +<term><guilabel>Enable full duplex operation</guilabel></term> +<listitem><para>This option allows the sound server to play and record sound at the same time. This option should be enabled if you use applications (such as Internet telephones) which require simultaneous record and playback.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Use custom sound device:</guilabel -></term> +<term><guilabel>Use custom sound device:</guilabel></term> <listitem> -<para ->Normally, the sound server defaults to using the device called <filename class="devicefile" ->/dev/dsp</filename -> for sound output. This should work in most cases. An exception is, for instance, if you are using devfs, then you should use <filename class="devicefile" ->/dev/sound/dsp</filename -> instead. Other alternatives are things like <filename class="devicefile" ->/dev/dsp0</filename -> or <filename class="devicefile" ->/dev/dsp1</filename -> if you have a soundcard that supports multiple outputs or you have multiple soundcards.</para> +<para>Normally, the sound server defaults to using the device called <filename class="devicefile">/dev/dsp</filename> for sound output. This should work in most cases. An exception is, for instance, if you are using devfs, then you should use <filename class="devicefile">/dev/sound/dsp</filename> instead. Other alternatives are things like <filename class="devicefile">/dev/dsp0</filename> or <filename class="devicefile">/dev/dsp1</filename> if you have a soundcard that supports multiple outputs or you have multiple soundcards.</para> <tip> -<para ->If you often use non-&arts; aware applications, and you have a soundcard that supports it, try setting &arts; to use a different device than <filename class="devicefile" ->/dev/dsp</filename ->. This way, other applications will be able to use the default device, while &arts; is still running, without giving any error messages.</para> +<para>If you often use non-&arts; aware applications, and you have a soundcard that supports it, try setting &arts; to use a different device than <filename class="devicefile">/dev/dsp</filename>. This way, other applications will be able to use the default device, while &arts; is still running, without giving any error messages.</para> </tip> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Use custom sampling rate:</guilabel -></term> +<term><guilabel>Use custom sampling rate:</guilabel></term> <listitem> -<para ->Normally, the sound server defaults to using a sampling rate of 44100 Hz (<acronym ->CD</acronym -> quality), which is supported on almost all hardware. If you are using certain Yamaha soundcards, you might need to configure this to 48000 Hz here; if you are using old SoundBlaster cards, like SoundBlaster Pro, you might need to change this to 22050 Hz. All other values are possible too and may make sense in certain contexts (&ie; professional studio equipment).</para -> +<para>Normally, the sound server defaults to using a sampling rate of 44100 Hz (<acronym>CD</acronym> quality), which is supported on almost all hardware. If you are using certain Yamaha soundcards, you might need to configure this to 48000 Hz here; if you are using old SoundBlaster cards, like SoundBlaster Pro, you might need to change this to 22050 Hz. All other values are possible too and may make sense in certain contexts (&ie; professional studio equipment).</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Other custom options:</guilabel -></term> -<listitem -><para ->There are some options offered by &arts; which may not be available in this control module, so you can add command line options here which will be passed directly to <application ->artsd</application ->. The options will be appended, so they will override the choices made in the <acronym ->GUI</acronym ->. To see the possible choices, open a &konsole; window, and type <userinput -><command ->artsd</command -> <option ->-h</option -></userinput ->.</para> +<term><guilabel>Other custom options:</guilabel></term> +<listitem><para>There are some options offered by &arts; which may not be available in this control module, so you can add command line options here which will be passed directly to <application>artsd</application>. The options will be appended, so they will override the choices made in the <acronym>GUI</acronym>. To see the possible choices, open a &konsole; window, and type <userinput><command>artsd</command> <option>-h</option></userinput>.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Sound quality:</guilabel -></term> +<term><guilabel>Sound quality:</guilabel></term> <listitem> -<para ->These settings allow you to configure the quality of the sounds that will be played.</para> +<para>These settings allow you to configure the quality of the sounds that will be played.</para> <tip> -<para ->Note that a higher sound quality causes a higher <acronym ->CPU</acronym -> usage.</para> -<para ->If you find sound is slow, or using too much <acronym ->CPU</acronym ->, try reducing this setting.</para> +<para>Note that a higher sound quality causes a higher <acronym>CPU</acronym> usage.</para> +<para>If you find sound is slow, or using too much <acronym>CPU</acronym>, try reducing this setting.</para> </tip> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Audio Buffer Size (response time)</guilabel -></term> -<listitem -><para ->This slider determines how quickly the sound server can use your computer's resources. The faster the response time, the higher the <acronym ->CPU</acronym -> load will be.</para> -<tip -><para ->I would recommend that you start with the sound server set at 250 ms, and use &kde; for a while. If you notice that the sound does not work correctly, increase the responsiveness one step at a time until the problems disappear.</para -></tip> +<term><guilabel>Audio Buffer Size (response time)</guilabel></term> +<listitem><para>This slider determines how quickly the sound server can use your computer's resources. The faster the response time, the higher the <acronym>CPU</acronym> load will be.</para> +<tip><para>I would recommend that you start with the sound server set at 250 ms, and use &kde; for a while. If you notice that the sound does not work correctly, increase the responsiveness one step at a time until the problems disappear.</para></tip> </listitem> </varlistentry> @@ -297,13 +145,9 @@ </sect2> <sect2> -<title ->Mixer</title> +<title>Mixer</title> -<para ->If you have installed the optional tdemultimedia package, a &kcontrol; panel allowing configuration of the mixer will also appear here. If installed, you can read about this in <ulink url="help:/kcontrol/mixer/index.html" ->its own manual</ulink ->.</para> +<para>If you have installed the optional tdemultimedia package, a &kcontrol; panel allowing configuration of the mixer will also appear here. If installed, you can read about this in <ulink url="help:/kcontrol/mixer/index.html">its own manual</ulink>.</para> </sect2> &midi-kcontrol; </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/arts/midi.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/arts/midi.docbook index 5c2ae385ad5..b3e2fe90bce 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/arts/midi.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/arts/midi.docbook @@ -1,47 +1,16 @@ <sect2 id="midi"> <sect2info> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </sect2info> -<title -><acronym ->MIDI</acronym -> Configuration</title> +<title><acronym>MIDI</acronym> Configuration</title> -<para ->This module is used to determine which <acronym ->MIDI</acronym -> device &kde; should use. You can also install a <acronym ->MIDI</acronym -> wrapper around the device if you want.</para> +<para>This module is used to determine which <acronym>MIDI</acronym> device &kde; should use. You can also install a <acronym>MIDI</acronym> wrapper around the device if you want.</para> -<para ->The use of this module is simple. Click once on the <acronym ->MIDI</acronym -> device that you would like to use from the list.</para> +<para>The use of this module is simple. Click once on the <acronym>MIDI</acronym> device that you would like to use from the list.</para> -<para ->If you want to use a <acronym ->MIDI</acronym -> mapper, simply mark the checkbox below the list labelled <guilabel ->Use MIDI Mapper</guilabel ->. This will allow you to select the map in the text box below. You can click on the folder icon to browse your filesystem to find the map if you need it.</para> +<para>If you want to use a <acronym>MIDI</acronym> mapper, simply mark the checkbox below the list labelled <guilabel>Use MIDI Mapper</guilabel>. This will allow you to select the map in the text box below. You can click on the folder icon to browse your filesystem to find the map if you need it.</para> </sect2>
\ No newline at end of file diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/background/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/background/index.docbook index 904bd97986e..92572b7a831 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/background/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/background/index.docbook @@ -2,179 +2,103 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mark.Donohoe;</author> -<author ->&Martin.R.Jones;</author> -<!-- <author ->&Duncan.H;</author -> --> -<author ->&Mike.McBride;</author> - -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mark.Donohoe;</author> +<author>&Martin.R.Jones;</author> +<!-- <author>&Duncan.H;</author> --> +<author>&Mike.McBride;</author> + +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-09-28</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-09-28</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->background</keyword> -<keyword ->wallpaper</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>background</keyword> +<keyword>wallpaper</keyword> </keywordset> </articleinfo> <sect1 id="background"> -<title ->Background</title> +<title>Background</title> -<para ->The Background module allows you to configure colours or wallpapers for your desktop background.</para> +<para>The Background module allows you to configure colours or wallpapers for your desktop background.</para> -<para ->It is comprised of four areas:</para> +<para>It is comprised of four areas:</para> <orderedlist> <listitem> -<para ->Desktop selection area</para> +<para>Desktop selection area</para> </listitem> <listitem> -<para ->The background Preview Monitor</para> +<para>The background Preview Monitor</para> </listitem> <listitem> -<para ->An area for determining the background colour</para> +<para>An area for determining the background colour</para> </listitem> <listitem> -<para ->An area for selecting background images</para> +<para>An area for selecting background images</para> </listitem> </orderedlist> <variablelist> <varlistentry> -<term ->Selecting the desktop</term> +<term>Selecting the desktop</term> <listitem> -<para ->The drop down box labelled <guilabel ->Setting for desktop:</guilabel -> is used to select the desktop you want to configure. You can select any of the desktops individually, or you can select <guilabel ->All Desktops</guilabel -> and the changes you make will be applied to all desktops.</para> +<para>The drop down box labelled <guilabel>Setting for desktop:</guilabel> is used to select the desktop you want to configure. You can select any of the desktops individually, or you can select <guilabel>All Desktops</guilabel> and the changes you make will be applied to all desktops.</para> </listitem> </varlistentry> <varlistentry> -<term ->Preview Monitor</term> +<term>Preview Monitor</term> <listitem> -<para ->This is a preview window. It will give you a sense of what to expect with each change.</para> +<para>This is a preview window. It will give you a sense of what to expect with each change.</para> </listitem> -</varlistentry -> +</varlistentry> <varlistentry> -<term -><guilabel ->Background</guilabel -></term> +<term><guilabel>Background</guilabel></term> <listitem> -<para ->This section allows you to load a wallpaper on top of the colour gradient chosen in the section below.</para> +<para>This section allows you to load a wallpaper on top of the colour gradient chosen in the section below.</para> -<para ->There are three choices available here:</para> +<para>There are three choices available here:</para> <variablelist> <varlistentry> -<term -><guilabel ->No Picture</guilabel -></term> +<term><guilabel>No Picture</guilabel></term> <listitem> -<para ->No picture background will be shown. The colour and pattern choices below will still take effect.</para> +<para>No picture background will be shown. The colour and pattern choices below will still take effect.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Picture</guilabel -></term> +<term><guilabel>Picture</guilabel></term> <listitem> -<para ->A single picture will be used as the background for the selected desktops.</para> -<para ->How this picture is positioned and scaled can be fine tuned below.</para> +<para>A single picture will be used as the background for the selected desktops.</para> +<para>How this picture is positioned and scaled can be fine tuned below.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Slide show</guilabel -></term> +<term><guilabel>Slide show</guilabel></term> <listitem> -<para ->&kde; allows you to have an automatic slide show of wallpaper images. To enable this option, press the <guibutton ->Setup...</guibutton -> button. In the resulting dialogue you may choose any image or folder of images available on your computer, using the <guibutton ->Add...</guibutton -> button to navigate your file system. <guibutton ->Remove</guibutton -> will remove the currently selected entry from the list.</para -> - -<para ->You may choose the length of time any image is displayed in the <guilabel ->Change picture after:</guilabel -> box, and you may choose <guibutton ->Show pictures in random order</guibutton -> if you don't want them displayed in the order they are listed.</para> - -<tip -><para ->Displaying wallpaper requires that the image be kept in memory. If you are low on memory, using a small, tiled image or none at all is recommended.</para> - -<para ->Scaling or centreing a small image still requires an image the size of your display to be maintained in memory.</para -></tip> +<para>&kde; allows you to have an automatic slide show of wallpaper images. To enable this option, press the <guibutton>Setup...</guibutton> button. In the resulting dialogue you may choose any image or folder of images available on your computer, using the <guibutton>Add...</guibutton> button to navigate your file system. <guibutton>Remove</guibutton> will remove the currently selected entry from the list.</para> + +<para>You may choose the length of time any image is displayed in the <guilabel>Change picture after:</guilabel> box, and you may choose <guibutton>Show pictures in random order</guibutton> if you don't want them displayed in the order they are listed.</para> + +<tip><para>Displaying wallpaper requires that the image be kept in memory. If you are low on memory, using a small, tiled image or none at all is recommended.</para> + +<para>Scaling or centreing a small image still requires an image the size of your display to be maintained in memory.</para></tip> </listitem> </varlistentry> </variablelist> @@ -182,192 +106,85 @@ </varlistentry> <varlistentry> -<term -><guilabel ->Options</guilabel -></term> +<term><guilabel>Options</guilabel></term> <listitem> -<variablelist -><!-- Positioning --> +<variablelist><!-- Positioning --> <varlistentry> -<term ->Centred</term> -<listitem -><para ->The image will be centred on the screen without changing the size of the image. The background colours will be present anywhere the image does not cover.</para -> </listitem> +<term>Centred</term> +<listitem><para>The image will be centred on the screen without changing the size of the image. The background colours will be present anywhere the image does not cover.</para> </listitem> </varlistentry> <varlistentry> -<term ->Tiled</term> -<listitem -><para ->The image will be duplicated until it fills the entire desktop. The first image will be placed in the upper left corner of the screen, and duplicated downward and to the right.</para -></listitem> +<term>Tiled</term> +<listitem><para>The image will be duplicated until it fills the entire desktop. The first image will be placed in the upper left corner of the screen, and duplicated downward and to the right.</para></listitem> </varlistentry> <varlistentry> -<term ->Centre Tiled</term> -<listitem -><para ->The image will be duplicated until it fills the entire desktop. The first image will be placed in the centre of the screen, and duplicated upward, downward to the right, and to the left.</para> -</listitem -></varlistentry> +<term>Centre Tiled</term> +<listitem><para>The image will be duplicated until it fills the entire desktop. The first image will be placed in the centre of the screen, and duplicated upward, downward to the right, and to the left.</para> +</listitem></varlistentry> <varlistentry> -<term ->Centred Maxpect</term> -<listitem -><para ->The image will be placed in the centre of the screen. It will be scaled to fit the desktop, but it will not change the aspect ratio of the original image. This will provide you with an image that is not distorted. </para -></listitem> +<term>Centred Maxpect</term> +<listitem><para>The image will be placed in the centre of the screen. It will be scaled to fit the desktop, but it will not change the aspect ratio of the original image. This will provide you with an image that is not distorted. </para></listitem> </varlistentry> <varlistentry> -<term ->Tiled Maxpect</term> +<term>Tiled Maxpect</term> <listitem> -<para ->The image will be placed in the corner of the screen. It will be scaled to fit the desktop, but it will not change the aspect ratio of the original image. This will provide you with an image that is not distorted. If there is any space over, the image will be duplicated to fill it. </para> +<para>The image will be placed in the corner of the screen. It will be scaled to fit the desktop, but it will not change the aspect ratio of the original image. This will provide you with an image that is not distorted. If there is any space over, the image will be duplicated to fill it. </para> </listitem> </varlistentry> <varlistentry> -<term ->Scaled</term> -<listitem -><para ->The image will be scaled to fit the desktop. It will be stretched to fit to all four corners. This may distort the image.</para -></listitem> +<term>Scaled</term> +<listitem><para>The image will be scaled to fit the desktop. It will be stretched to fit to all four corners. This may distort the image.</para></listitem> </varlistentry> <varlistentry> -<term ->Centred Auto fit</term> +<term>Centred Auto fit</term> <listitem> -<para ->If the picture fits the desktop size, this mode works like the centred option. If the picture is larger than the desktop then it is scaled down to fit while keeping the aspect ratio. </para> +<para>If the picture fits the desktop size, this mode works like the centred option. If the picture is larger than the desktop then it is scaled down to fit while keeping the aspect ratio. </para> </listitem> </varlistentry> </variablelist> -<variablelist -><!-- Colors --> +<variablelist><!-- Colors --> <varlistentry> -<term -><guilabel ->Colours:</guilabel -></term> +<term><guilabel>Colours:</guilabel></term> <listitem> -<para ->The first drop down box allows you to choose the type of colour, gradient, or pattern to display under (or in place of) wallpaper.</para> -<tip -><para ->If you are going to be using a picture as a wallpaper, you can skip this section of the dialogue box.</para -> -<para ->However, if your chosen wallpaper does not cover the entire desktop, the chosen colours will still show in the remaining space.</para -></tip> +<para>The first drop down box allows you to choose the type of colour, gradient, or pattern to display under (or in place of) wallpaper.</para> +<tip><para>If you are going to be using a picture as a wallpaper, you can skip this section of the dialogue box.</para> +<para>However, if your chosen wallpaper does not cover the entire desktop, the chosen colours will still show in the remaining space.</para></tip> <variablelist> <varlistentry> -<term -><guilabel ->Single Colour</guilabel -></term> -<listitem -><para ->By choosing this mode, you select one colour using the first colour bar, and the entire background is covered with this one colour.</para -></listitem -> +<term><guilabel>Single Colour</guilabel></term> +<listitem><para>By choosing this mode, you select one colour using the first colour bar, and the entire background is covered with this one colour.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Horizontal Gradient</guilabel -></term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel ->Primary Colour</guilabel -> on the left edge of the screen, and slowly transform into the colour selected by <guilabel ->Blend Colour</guilabel -> by the time it gets to the right edge of the screen.</para -></listitem> +<term><guilabel>Horizontal Gradient</guilabel></term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel>Primary Colour</guilabel> on the left edge of the screen, and slowly transform into the colour selected by <guilabel>Blend Colour</guilabel> by the time it gets to the right edge of the screen.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Vertical Gradient</guilabel -></term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel ->Primary Colour</guilabel -> on the top edge of the screen, and slowly transform into the colour selected by <guilabel ->Blend Colour</guilabel -> as it moves to the bottom of the screen.</para -></listitem -> +<term><guilabel>Vertical Gradient</guilabel></term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel>Primary Colour</guilabel> on the top edge of the screen, and slowly transform into the colour selected by <guilabel>Blend Colour</guilabel> as it moves to the bottom of the screen.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Pyramid Gradient</guilabel -></term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel ->Primary Colour</guilabel -> in each corner of the screen, and slowly transform into the colour selected by <guilabel ->Blend Colour</guilabel -> as it moves to the centre of the screen.</para -></listitem> +<term><guilabel>Pyramid Gradient</guilabel></term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel>Primary Colour</guilabel> in each corner of the screen, and slowly transform into the colour selected by <guilabel>Blend Colour</guilabel> as it moves to the centre of the screen.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Pipecross Gradient</guilabel -></term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel ->Primary Colour</guilabel -> in each corner of the screen, and slowly transform into the colour selected by <guilabel ->Blend Colour</guilabel -> as it moves to the centre of the screen. The shape of this gradient is different than the pyramid gradient.</para -></listitem> +<term><guilabel>Pipecross Gradient</guilabel></term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel>Primary Colour</guilabel> in each corner of the screen, and slowly transform into the colour selected by <guilabel>Blend Colour</guilabel> as it moves to the centre of the screen. The shape of this gradient is different than the pyramid gradient.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Elliptic Gradient</guilabel -></term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel ->Blend Colour</guilabel -> in the centre of the screen, and slowly transform into the colour selected by <guilabel ->Primary Colour</guilabel -> as it moves to the edges, in an elliptical pattern.</para -></listitem> +<term><guilabel>Elliptic Gradient</guilabel></term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel>Blend Colour</guilabel> in the centre of the screen, and slowly transform into the colour selected by <guilabel>Primary Colour</guilabel> as it moves to the edges, in an elliptical pattern.</para></listitem> </varlistentry> <varlistentry> -<term -><replaceable ->Pattern</replaceable -></term> +<term><replaceable>Pattern</replaceable></term> <listitem> -<para ->The rest of the list are the names of various patterns or textures you can choose.</para -> -<para ->Click on <guibutton ->OK</guibutton ->, and &kde; will render the pattern you selected using the two colours you selected. For more on patterns, see the section <link linkend="bkgnd-patterns" ->Adding, Removing and Modifying Patterns</link ->.</para> - -<para ->Select the primary colour with the first colour bar. If you have chosen a pattern that requires two colours to be set the secondary colour can be set by pressing the appropriate button.</para> +<para>The rest of the list are the names of various patterns or textures you can choose.</para> +<para>Click on <guibutton>OK</guibutton>, and &kde; will render the pattern you selected using the two colours you selected. For more on patterns, see the section <link linkend="bkgnd-patterns">Adding, Removing and Modifying Patterns</link>.</para> + +<para>Select the primary colour with the first colour bar. If you have chosen a pattern that requires two colours to be set the secondary colour can be set by pressing the appropriate button.</para> </listitem> </varlistentry> </variablelist> @@ -378,33 +195,14 @@ <variablelist> <varlistentry> -<term -><guilabel ->Blending:</guilabel -></term> +<term><guilabel>Blending:</guilabel></term> <listitem> -<para ->The drop down box labelled <guilabel ->Blending:</guilabel -> contains the options to make a smooth transition (blend) from the wallpaper as it changes to the background.</para> +<para>The drop down box labelled <guilabel>Blending:</guilabel> contains the options to make a smooth transition (blend) from the wallpaper as it changes to the background.</para> <orderedlist> -<listitem -><para ->A drop down box allows you to select the blending mode. Many of the modes are similar to blending modes for background colours. Select your mode from the list, and the preview window shows you what it will look like.</para -></listitem -> -<listitem -><para ->The <guilabel ->Balance</guilabel -> slider adjusts the blending. The results can be seen in the preview window.</para -></listitem> -<listitem -><para ->The <guilabel ->Reverse roles</guilabel -> can reverse the role of the picture and the background for some types of blending.</para> +<listitem><para>A drop down box allows you to select the blending mode. Many of the modes are similar to blending modes for background colours. Select your mode from the list, and the preview window shows you what it will look like.</para></listitem> +<listitem><para>The <guilabel>Balance</guilabel> slider adjusts the blending. The results can be seen in the preview window.</para></listitem> +<listitem><para>The <guilabel>Reverse roles</guilabel> can reverse the role of the picture and the background for some types of blending.</para> </listitem> </orderedlist> </listitem> @@ -415,70 +213,33 @@ </variablelist> <sect2 id="bkgnd-advanced"> -<title ->Advanced options</title> -<para ->Located below the preview monitor is a button labeled <guibutton ->Advanced Options...</guibutton ->.</para> - -<para ->To use an external program to determine and change the background of &kde;, simply select <guilabel ->Use the following program for drawing the background</guilabel ->. Available &kde; programs are listed, select one to enable it. To modify your choice, for example to change the refresh times, you may press the <guibutton ->Modify...</guibutton -> button.</para> - -<para ->To add a third party application (⪚ <application ->XEarth</application -> you may use the <guibutton ->Add...</guibutton -> button. A dialogue will open allowing you to choose your application, and fill in other data about it. You may remove any entries from this list by selecting it and pressing the <guibutton ->Remove</guibutton -> button.</para> - -<para ->Using third party external programs to modify or change the background is beyond the scope of this document, see their respective documentation for the format of command-line switches and other configuration information.</para> - -<para ->Also in this section you may choose to set the colour of text that is used for icons on the desktop. If you find icon text difficult to read against a wallpaper or pattern, you can choose a solid colour to show beneath text, or enable a shadow under the text to enhance its appearance.</para> - -<para ->Finally you can set the <guilabel ->Size of the background cache:</guilabel ->. The default (2048 KB) is usually a safe choice.</para> +<title>Advanced options</title> +<para>Located below the preview monitor is a button labeled <guibutton>Advanced Options...</guibutton>.</para> + +<para>To use an external program to determine and change the background of &kde;, simply select <guilabel>Use the following program for drawing the background</guilabel>. Available &kde; programs are listed, select one to enable it. To modify your choice, for example to change the refresh times, you may press the <guibutton>Modify...</guibutton> button.</para> + +<para>To add a third party application (⪚ <application>XEarth</application> you may use the <guibutton>Add...</guibutton> button. A dialogue will open allowing you to choose your application, and fill in other data about it. You may remove any entries from this list by selecting it and pressing the <guibutton>Remove</guibutton> button.</para> + +<para>Using third party external programs to modify or change the background is beyond the scope of this document, see their respective documentation for the format of command-line switches and other configuration information.</para> + +<para>Also in this section you may choose to set the colour of text that is used for icons on the desktop. If you find icon text difficult to read against a wallpaper or pattern, you can choose a solid colour to show beneath text, or enable a shadow under the text to enhance its appearance.</para> + +<para>Finally you can set the <guilabel>Size of the background cache:</guilabel>. The default (2048 KB) is usually a safe choice.</para> </sect2> <sect2 id="bkgnd-patterns"> -<title ->Adding, Removing and Modifying Patterns</title> - -<para ->A pattern is a picture file which &kde; uses as a template to draw your background. The picture file provides the shapes, but &kde; provides the colours. &kde; is packaged with several patterns, and you also can add new patterns.</para> - -<para ->To add a new pattern that is available to every user on your computer, simply place the file in <filename class="directory" ->$<envar ->TDEDIR</envar ->/share/apps/kdesktop/patterns/</filename -></para> - -<para ->Copy a <literal role="extension" ->.desktop</literal -> file from this folder, and name it the same as your new pattern image file. Modify the contents to suit your new pattern.</para> - -<para ->To add a new pattern for a single user, add the files to <filename class="directory" ->$<envar ->TDEHOME</envar ->/share/apps/kdesktop/patterns/</filename -></para> - -<para ->For best results, the pattern should be a grayscale PNG file.</para> +<title>Adding, Removing and Modifying Patterns</title> + +<para>A pattern is a picture file which &kde; uses as a template to draw your background. The picture file provides the shapes, but &kde; provides the colours. &kde; is packaged with several patterns, and you also can add new patterns.</para> + +<para>To add a new pattern that is available to every user on your computer, simply place the file in <filename class="directory">$<envar>TDEDIR</envar>/share/apps/kdesktop/patterns/</filename></para> + +<para>Copy a <literal role="extension">.desktop</literal> file from this folder, and name it the same as your new pattern image file. Modify the contents to suit your new pattern.</para> + +<para>To add a new pattern for a single user, add the files to <filename class="directory">$<envar>TDEHOME</envar>/share/apps/kdesktop/patterns/</filename></para> + +<para>For best results, the pattern should be a grayscale PNG file.</para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/bell/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/bell/index.docbook index c2af7f9e516..e37c3ba5575 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/bell/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/bell/index.docbook @@ -1,124 +1,53 @@ <?xml version="1.0"?> <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author -><firstname ->Pat</firstname -> <surname ->Dowler</surname -> </author> +<author><firstname>Pat</firstname> <surname>Dowler</surname> </author> -<author -><firstname ->Matthias</firstname -> <surname ->Hoelzer</surname -> </author> +<author><firstname>Matthias</firstname> <surname>Hoelzer</surname> </author> -<author -><firstname ->Mike</firstname -> <surname ->McBride</surname -> </author> +<author><firstname>Mike</firstname> <surname>McBride</surname> </author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-16</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-16</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->Bell</keyword> -<keyword ->Settings</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>Bell</keyword> +<keyword>Settings</keyword> </keywordset> </articleinfo> <sect1 id="bell"> -<title ->System bell</title> +<title>System bell</title> -<para ->The system bell or beep is a feature of the X server, which attempts to make good use of the available hardware. </para> +<para>The system bell or beep is a feature of the X server, which attempts to make good use of the available hardware. </para> -<para ->&kde; normally doesn't use the system bell; instead using its own system notifications, which could include log entries, message popups, or its own beep. You can configure these in the <guilabel ->System Notifications</guilabel -> &kcontrol; module.</para> +<para>&kde; normally doesn't use the system bell; instead using its own system notifications, which could include log entries, message popups, or its own beep. You can configure these in the <guilabel>System Notifications</guilabel> &kcontrol; module.</para> -<note -><para ->It isn't always possible for the X server to actually make a beep sound with exactly the parameters selected due to hardware limitations. For example, on most PCs, volume control is not very good so the X server seems to fake low volume with a reduced duration of the sound. Thus, if the settings don't seem to do anything, this is because the X server and/or the hardware don't support anything better.</para -></note> +<note><para>It isn't always possible for the X server to actually make a beep sound with exactly the parameters selected due to hardware limitations. For example, on most PCs, volume control is not very good so the X server seems to fake low volume with a reduced duration of the sound. Thus, if the settings don't seem to do anything, this is because the X server and/or the hardware don't support anything better.</para></note> -<para ->Users are able to set the following parameters for the bell:</para> +<para>Users are able to set the following parameters for the bell:</para> <itemizedlist> -<listitem -> <para ->volume (percentage of <quote ->maximum</quote -> volume)</para -> </listitem> -<listitem -> <para ->pitch (in Hz)</para -> </listitem> -<listitem -> <para ->duration (in milliseconds)</para -> </listitem> +<listitem> <para>volume (percentage of <quote>maximum</quote> volume)</para> </listitem> +<listitem> <para>pitch (in Hz)</para> </listitem> +<listitem> <para>duration (in milliseconds)</para> </listitem> </itemizedlist> -<para ->You can use the <guibutton ->test</guibutton -> button to hear how the current settings will sound.</para> +<para>You can use the <guibutton>test</guibutton> button to hear how the current settings will sound.</para> -<sect2 id="bell-author" -><title ->Section Authors</title> -<para ->Pat Dowler, Matthias Hoelzer <email ->mhk@kde.org</email -></para> -<para ->Converted to KDE 2.0 by Mike McBride <email ->mpmcbride7@yahoo.com</email -></para> -<para ->Conversion to British English: Malcolm Hunter <email ->malcolm.hunter@gmx.co.uk</email -></para -> +<sect2 id="bell-author"><title>Section Authors</title> +<para>Pat Dowler, Matthias Hoelzer <email>mhk@kde.org</email></para> +<para>Converted to KDE 2.0 by Mike McBride <email>mpmcbride7@yahoo.com</email></para> +<para>Conversion to British English: Malcolm Hunter <email>malcolm.hunter@gmx.co.uk</email></para> </sect2> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/cache/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/cache/index.docbook index f0ec76562e9..6de5f958ac5 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/cache/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/cache/index.docbook @@ -2,91 +2,45 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author -><firstname -></firstname -><surname -></surname -></author> +<author><firstname></firstname><surname></surname></author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-12</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-12</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->Konqueror</keyword> -<keyword ->Cache</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>Konqueror</keyword> +<keyword>Cache</keyword> </keywordset> </articleinfo> <sect1 id="cache"> -<title ->Cache</title> +<title>Cache</title> -<para ->This module allows you to control the size of the local cache folder used by &konqueror;. Note that each user account on your computer has a separate cache folder, and this folder is not shared with other web browsers such as &Netscape;.</para> +<para>This module allows you to control the size of the local cache folder used by &konqueror;. Note that each user account on your computer has a separate cache folder, and this folder is not shared with other web browsers such as &Netscape;.</para> -<para ->Storing local copies of web pages that you have visited allows &konqueror; to quickly load their contents on subsequent visits. It will only be necessary to reload the contents from the original site if they have changed since your last visit, or if you click the reload button in &konqueror;.</para> +<para>Storing local copies of web pages that you have visited allows &konqueror; to quickly load their contents on subsequent visits. It will only be necessary to reload the contents from the original site if they have changed since your last visit, or if you click the reload button in &konqueror;.</para> -<para ->If you really don't want any of the web pages you visit to be stored on your computer, you can disable &konqueror;'s disk cache by clearing the checkbox labelled <guilabel ->Use cache</guilabel ->.</para> +<para>If you really don't want any of the web pages you visit to be stored on your computer, you can disable &konqueror;'s disk cache by clearing the checkbox labelled <guilabel>Use cache</guilabel>.</para> -<para ->You can set here how aggressively &konqueror; keeps the cache up to date. <guilabel ->Keep cache in sync</guilabel -> means that &konqueror; will hit the cache for all objects, downloading them if they are not there, and then display the item from the cache. <guilabel ->Use cache whenever possible</guilabel -> means that &konqueror; will try the cache, and if an object is not there, it will directly download it for display. <guilabel ->Offline browsing mode</guilabel -> means that &konqueror; will try the cache, and if an object is not there, it will not attempt to download it from the Internet.</para> +<para>You can set here how aggressively &konqueror; keeps the cache up to date. <guilabel>Keep cache in sync</guilabel> means that &konqueror; will hit the cache for all objects, downloading them if they are not there, and then display the item from the cache. <guilabel>Use cache whenever possible</guilabel> means that &konqueror; will try the cache, and if an object is not there, it will directly download it for display. <guilabel>Offline browsing mode</guilabel> means that &konqueror; will try the cache, and if an object is not there, it will not attempt to download it from the Internet.</para> -<para ->You can control the size of the cache by typing a number into the text box labelled <guilabel ->Disk cache size</guilabel ->. This is the average amount of space in kilobytes that the cache folder is allowed to use. When the cache grows too large, &konqueror; will delete older files to reduce the size of the cache folder.</para> +<para>You can control the size of the cache by typing a number into the text box labelled <guilabel>Disk cache size</guilabel>. This is the average amount of space in kilobytes that the cache folder is allowed to use. When the cache grows too large, &konqueror; will delete older files to reduce the size of the cache folder.</para> -<para ->This is however, only an average, and during a browsing session the cache could become substantially larger.</para> +<para>This is however, only an average, and during a browsing session the cache could become substantially larger.</para> -<para ->You can use the <guibutton ->Clear Cache</guibutton -> button to empty the cache at any time.</para> +<para>You can use the <guibutton>Clear Cache</guibutton> button to empty the cache at any time.</para> </sect1> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/clock/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/clock/index.docbook index 9945e689c16..ba049c4068e 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/clock/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/clock/index.docbook @@ -2,104 +2,53 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-19</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-19</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->clock</keyword> -<keyword ->date</keyword> -<keyword ->time</keyword> -<keyword ->set</keyword> -<keyword ->configure</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>clock</keyword> +<keyword>date</keyword> +<keyword>time</keyword> +<keyword>set</keyword> +<keyword>configure</keyword> </keywordset> </articleinfo> <sect1 id="datetime"> -<title ->Date & Time</title> +<title>Date & Time</title> -<para ->You can use this module to alter the system date and time, using a convenient graphical interface.</para> +<para>You can use this module to alter the system date and time, using a convenient graphical interface.</para> -<note -><para ->You must have system administrator (<systemitem class="username" ->root</systemitem ->) access to change the system date and time. If you do not have this access level, this module will only show you the current settings.</para -></note> +<note><para>You must have system administrator (<systemitem class="username">root</systemitem>) access to change the system date and time. If you do not have this access level, this module will only show you the current settings.</para></note> -<para ->When you first start, you are in display mode only. To modify your settings, click on <guibutton ->Administrator Mode</guibutton ->. If you are logged in as <systemitem class="username" ->root</systemitem ->, you will go straight to the change dialogue. If not, &kde; will ask for a superuser password.</para> +<para>When you first start, you are in display mode only. To modify your settings, click on <guibutton>Administrator Mode</guibutton>. If you are logged in as <systemitem class="username">root</systemitem>, you will go straight to the change dialogue. If not, &kde; will ask for a superuser password.</para> <sect2 id="date-change"> -<title ->Modifying your settings</title> - -<para ->You set the date using the left half of the module. Simply choose your month (the drop down box at the top), year (the spin box at the top), and the day of the month (simply click on the day in the calendar).</para> - -<para ->You set the time using the spin boxes at the bottom of the clock. You can also directly enter your value.</para> - -<note -><para ->The time is represented in 24 hour format. If you want the system time to be set to 8:00 PM, you need to set the hour spinbox to <guilabel ->20</guilabel -> (8 + 12). If you want the system time set to 8:00 AM, you should set the hour spinbox to <guilabel ->8</guilabel ->.</para -></note> - -<para ->To set a new time zone, simply select one from the drop down box at the bottom.</para> - -<para ->When you have set the correct date and time, simply click <guibutton ->Apply</guibutton -> to make the changes permanent.</para> +<title>Modifying your settings</title> + +<para>You set the date using the left half of the module. Simply choose your month (the drop down box at the top), year (the spin box at the top), and the day of the month (simply click on the day in the calendar).</para> + +<para>You set the time using the spin boxes at the bottom of the clock. You can also directly enter your value.</para> + +<note><para>The time is represented in 24 hour format. If you want the system time to be set to 8:00 PM, you need to set the hour spinbox to <guilabel>20</guilabel> (8 + 12). If you want the system time set to 8:00 AM, you should set the hour spinbox to <guilabel>8</guilabel>.</para></note> + +<para>To set a new time zone, simply select one from the drop down box at the bottom.</para> + +<para>When you have set the correct date and time, simply click <guibutton>Apply</guibutton> to make the changes permanent.</para> </sect2> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/colors/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/colors/index.docbook index 9309da02b22..a4af7121ec2 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/colors/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/colors/index.docbook @@ -2,187 +2,92 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<author ->&Mark.Donohoe; &Mark.Donohoe.mail;</author> -<author ->&Martin.R.Jones; &Martin.R.Jones.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<author>&Mark.Donohoe; &Mark.Donohoe.mail;</author> +<author>&Martin.R.Jones; &Martin.R.Jones.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-09-22</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-09-22</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->colour</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>colour</keyword> </keywordset> </articleinfo> <sect1 id="color"> -<title ->Colours</title> +<title>Colours</title> <sect2 id="color-intro"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->The Colour Selection module is comprised of 4 sections:</para> +<para>The Colour Selection module is comprised of 4 sections:</para> <orderedlist> -<listitem -><para -><link linkend="kcmdisplay-preview" ->The colour scheme preview</link ->.</para -></listitem> -<listitem -><para -><link linkend="kcmdisplay-widget-color" ->The current <guilabel ->Widget Colour</guilabel -></link ->.</para> +<listitem><para><link linkend="kcmdisplay-preview">The colour scheme preview</link>.</para></listitem> +<listitem><para><link linkend="kcmdisplay-widget-color">The current <guilabel>Widget Colour</guilabel></link>.</para> </listitem> -<listitem -><para -><link linkend="kcmdisplay-color-schemes" ->The available Colour Schemes</link ->.</para -></listitem> -<listitem -><para -><link linkend="kcmdisplay-contrast" ->The contrast slider</link ->.</para -></listitem> +<listitem><para><link linkend="kcmdisplay-color-schemes">The available Colour Schemes</link>.</para></listitem> +<listitem><para><link linkend="kcmdisplay-contrast">The contrast slider</link>.</para></listitem> </orderedlist> -<note -><para ->A <emphasis ->Widget</emphasis -> is a commonly-used programmer's term for referring to User Interface elements such as buttons, menus, and scroll bars. You can think of them as the fundamental pieces that are assembled to make your application.</para -></note> +<note><para>A <emphasis>Widget</emphasis> is a commonly-used programmer's term for referring to User Interface elements such as buttons, menus, and scroll bars. You can think of them as the fundamental pieces that are assembled to make your application.</para></note> <sect3 id="kcmdisplay-preview"> -<title ->Preview</title> +<title>Preview</title> -<para ->This section of the dialogue demonstrates how a colour scheme applies to a sample selection of widgets. It provides you with a <guilabel ->preview</guilabel -> of your current colour choices.</para> +<para>This section of the dialogue demonstrates how a colour scheme applies to a sample selection of widgets. It provides you with a <guilabel>preview</guilabel> of your current colour choices.</para> -<para ->A colour scheme consists of a set of 18 colours. </para> +<para>A colour scheme consists of a set of 18 colours. </para> -<para ->Each of the widgets is labelled to help you identify how your changes will impact the colour scheme.</para> +<para>Each of the widgets is labelled to help you identify how your changes will impact the colour scheme.</para> </sect3> <sect3 id="kcmdisplay-widget-color"> -<title -><guilabel ->Widget Colour</guilabel -></title> +<title><guilabel>Widget Colour</guilabel></title> -<para ->The currently selected member of the colour scheme is shown in the combo box. This widget colour can be changed by clicking on the coloured box below the combo box. A colour selection dialogue will then appear, from which you may select a new colour. When you are happy with your colour selection, press <guibutton ->OK</guibutton -> in the colour selection dialogue. The colour will be updated in the Preview Area.</para> +<para>The currently selected member of the colour scheme is shown in the combo box. This widget colour can be changed by clicking on the coloured box below the combo box. A colour selection dialogue will then appear, from which you may select a new colour. When you are happy with your colour selection, press <guibutton>OK</guibutton> in the colour selection dialogue. The colour will be updated in the Preview Area.</para> -<para ->You may select any member of the colour scheme from the colour combination box.</para> +<para>You may select any member of the colour scheme from the colour combination box.</para> </sect3> <sect3 id="kcmdisplay-contrast"> -<title -><guilabel ->Contrast</guilabel -> Slider</title> +<title><guilabel>Contrast</guilabel> Slider</title> -<para ->The <guilabel ->Contrast</guilabel -> slider allows you to change the contrast between different shadings of the selected colours.</para> +<para>The <guilabel>Contrast</guilabel> slider allows you to change the contrast between different shadings of the selected colours.</para> -<para ->The preview area instantly updates to show the effect of your change.</para> +<para>The preview area instantly updates to show the effect of your change.</para> </sect3> <sect3 id="kcmdisplay-color-schemes"> -<title -><guilabel ->Colour Scheme</guilabel -></title> - -<para ->Various colour schemes are supplied with &kde;, and you are free to define your own.</para -> - -<para ->The three major colour components of each scheme are shown beside the name in the list. To preview a scheme in the larger preview area, click on its name in the list box. </para> - -<para ->You can use the &kde;-supplied Colour Schemes as a starting point to devise your own Scheme. Click on the <guibutton ->Save Scheme...</guibutton -> button to store the colour scheme under a new name, then modify it. </para> - -<para ->When such a user-created Colour Scheme is selected, changes to it (as shown in the Preview) can be saved with the <guibutton ->Save Scheme...</guibutton -> button; it can also be deleted with the <guibutton ->Remove Scheme</guibutton -> button.</para> - -<note -><para ->The &kde;-supplied Schemes themselves cannot be changed or deleted.</para -></note> - -<para ->You can use the <guibutton ->Import Scheme...</guibutton -> button to add new entries to the list. This might be colour schemes that you have created on another computer and saved, or colour schemes you have downloaded from a website.</para> - -<para ->You can choose if you want &kde; to apply the colour scheme even to non-&kde; applications by enabling the <guilabel ->Apply colours to non-TDE applications</guilabel ->. Not all applications will allow this, but most do.</para> +<title><guilabel>Colour Scheme</guilabel></title> + +<para>Various colour schemes are supplied with &kde;, and you are free to define your own.</para> + +<para>The three major colour components of each scheme are shown beside the name in the list. To preview a scheme in the larger preview area, click on its name in the list box. </para> + +<para>You can use the &kde;-supplied Colour Schemes as a starting point to devise your own Scheme. Click on the <guibutton>Save Scheme...</guibutton> button to store the colour scheme under a new name, then modify it. </para> + +<para>When such a user-created Colour Scheme is selected, changes to it (as shown in the Preview) can be saved with the <guibutton>Save Scheme...</guibutton> button; it can also be deleted with the <guibutton>Remove Scheme</guibutton> button.</para> + +<note><para>The &kde;-supplied Schemes themselves cannot be changed or deleted.</para></note> + +<para>You can use the <guibutton>Import Scheme...</guibutton> button to add new entries to the list. This might be colour schemes that you have created on another computer and saved, or colour schemes you have downloaded from a website.</para> + +<para>You can choose if you want &kde; to apply the colour scheme even to non-&kde; applications by enabling the <guilabel>Apply colours to non-TDE applications</guilabel>. Not all applications will allow this, but most do.</para> </sect3> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/cookies/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/cookies/index.docbook index c08cc498bcb..5d6bf669449 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/cookies/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/cookies/index.docbook @@ -2,237 +2,128 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> -<author ->&Jost.Schenck; &Jost.Schenck.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> +<author>&Jost.Schenck; &Jost.Schenck.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-12</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-12</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->cookie</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>cookie</keyword> </keywordset> </articleinfo> <sect1 id="cookie"> -<title ->Cookies</title> +<title>Cookies</title> -<para ->Cookies are a mechanism used by web sites to store and retrieve information using your browser. For example, a web site may allow you to customise the content and layout of the pages you see, so that your choices are persistent across different visits to that web site.</para> +<para>Cookies are a mechanism used by web sites to store and retrieve information using your browser. For example, a web site may allow you to customise the content and layout of the pages you see, so that your choices are persistent across different visits to that web site.</para> -<para ->The web site is able to remember your preferences by storing a cookie on your computer. Then, on future visits, the web site retrieves the information stored in the cookie to format the content of the site according to your previously specified preferences.</para> +<para>The web site is able to remember your preferences by storing a cookie on your computer. Then, on future visits, the web site retrieves the information stored in the cookie to format the content of the site according to your previously specified preferences.</para> -<para ->Thus, cookies play a very useful role in web browsing. Unfortunately, web sites often store and retrieve information in cookies without your explicit knowledge or consent. Some of this information may be quite useful to the web site owners, for example, by allowing them to collect summary statistics on the number of visits different areas of the web sites get, or to customise banner advertising.</para> +<para>Thus, cookies play a very useful role in web browsing. Unfortunately, web sites often store and retrieve information in cookies without your explicit knowledge or consent. Some of this information may be quite useful to the web site owners, for example, by allowing them to collect summary statistics on the number of visits different areas of the web sites get, or to customise banner advertising.</para> -<para ->The cookies module of the &kcontrol; allows you to set policies for the use of cookies when you are browsing the web with the &konqueror; web browser. </para> +<para>The cookies module of the &kcontrol; allows you to set policies for the use of cookies when you are browsing the web with the &konqueror; web browser. </para> -<warning -><para ->Note that the policies that you set using this control module will <emphasis ->not</emphasis -> apply to other web browsers such as &Netscape;.</para -></warning> +<warning><para>Note that the policies that you set using this control module will <emphasis>not</emphasis> apply to other web browsers such as &Netscape;.</para></warning> <sect2 id="cookie-policy"> -<title ->Policy</title> +<title>Policy</title> -<para ->Using the <guilabel ->Policy</guilabel -> tab, you can configure the &kde; applications that will handle cookies. You can do this by specifying a general cookie policy as well as special cookie policies for certain domains or hosts.</para> +<para>Using the <guilabel>Policy</guilabel> tab, you can configure the &kde; applications that will handle cookies. You can do this by specifying a general cookie policy as well as special cookie policies for certain domains or hosts.</para> -<para ->The top of the policy tab has a checkbox labeled <guilabel ->Enable cookies</guilabel ->. If you leave this unchecked cookies will be completely disabled. However, this may make browsing rather inconvenient especially as some web sites require the use of browsers with cookies enabled.</para> +<para>The top of the policy tab has a checkbox labeled <guilabel>Enable cookies</guilabel>. If you leave this unchecked cookies will be completely disabled. However, this may make browsing rather inconvenient especially as some web sites require the use of browsers with cookies enabled.</para> -<para ->You will probably want to enable cookies and then set specific policies on how you want them to be handled.</para> +<para>You will probably want to enable cookies and then set specific policies on how you want them to be handled.</para> -<para ->The first group of options create settings that apply to all cookies.</para> +<para>The first group of options create settings that apply to all cookies.</para> <variablelist> <varlistentry> -<term -><guilabel ->Only accept cookies from originating server</guilabel -></term> +<term><guilabel>Only accept cookies from originating server</guilabel></term> <listitem> -<para ->Some pages try to set cookies from servers other than the one you are seeing the <acronym ->HTML</acronym -> page from. For example, they show you advertisements, and the advertisements are from another computer, often one that belongs to a large advertising group. These advertisements may try to set a cookie which would allow them to track the pages you view across multiple web sites.</para> -<para ->Disabling this option will mean only cookies that come from the same web server as you are explicitly connecting to will be accepted.</para> +<para>Some pages try to set cookies from servers other than the one you are seeing the <acronym>HTML</acronym> page from. For example, they show you advertisements, and the advertisements are from another computer, often one that belongs to a large advertising group. These advertisements may try to set a cookie which would allow them to track the pages you view across multiple web sites.</para> +<para>Disabling this option will mean only cookies that come from the same web server as you are explicitly connecting to will be accepted.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Automatically accept session cookies</guilabel -></term> +<term><guilabel>Automatically accept session cookies</guilabel></term> <listitem> -<para ->An increasingly common use for cookies is not to track your movements across many visits to a web site but to just follow what you do during one single visit. Session cookies are saved as long as you are looking at the site and deleted when you leave it.</para> +<para>An increasingly common use for cookies is not to track your movements across many visits to a web site but to just follow what you do during one single visit. Session cookies are saved as long as you are looking at the site and deleted when you leave it.</para> -<para ->Web sites can use this information for various things, most commonly it is a convenience so that you do not have to keep logging in to view pages. For example, on a webmail site, without some kind of session <acronym ->ID</acronym ->, you would have to give your password again for each email you want to read. There are other ways to achieve this, but cookies are simple and very common.</para> +<para>Web sites can use this information for various things, most commonly it is a convenience so that you do not have to keep logging in to view pages. For example, on a webmail site, without some kind of session <acronym>ID</acronym>, you would have to give your password again for each email you want to read. There are other ways to achieve this, but cookies are simple and very common.</para> -<para ->Enabling this option means that session cookies are always accepted, even if you don't accept any other kind, and even if you choose to reject cookies from a particular site, session cookies from that site will be accepted.</para> +<para>Enabling this option means that session cookies are always accepted, even if you don't accept any other kind, and even if you choose to reject cookies from a particular site, session cookies from that site will be accepted.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Treat all cookies as session cookies</guilabel -></term> +<term><guilabel>Treat all cookies as session cookies</guilabel></term> <listitem> -<para ->If this option is enabled, all cookies are treated as session cookies. That is, they are not kept when you leave the web site.</para> +<para>If this option is enabled, all cookies are treated as session cookies. That is, they are not kept when you leave the web site.</para> <note> -<para ->The definition of <quote ->leave the web site</quote -> is vague. Some cookies may hang around for a little while after you are no longer viewing any pages on a particular web site. This is normal.</para> +<para>The definition of <quote>leave the web site</quote> is vague. Some cookies may hang around for a little while after you are no longer viewing any pages on a particular web site. This is normal.</para> </note> </listitem> </varlistentry> </variablelist> -<para ->The section for <guilabel ->Default Policy</guilabel -> sets some further options that are mutually exclusive — you can choose only one of these options as the default, but you are free to set a different option for any specific web server.</para> +<para>The section for <guilabel>Default Policy</guilabel> sets some further options that are mutually exclusive — you can choose only one of these options as the default, but you are free to set a different option for any specific web server.</para> <variablelist> <varlistentry> -<term -><guilabel ->Ask for confirmation</guilabel -></term> +<term><guilabel>Ask for confirmation</guilabel></term> <listitem> -<para ->If this option is selected, you will be asked for confirmation every time a cookie is stored or retrieved. You can selectively accept or reject each cookie. The confirmation dialogue will also allow you to set a domain specific policy, if you do not want to confirm each cookie for that domain.</para> +<para>If this option is selected, you will be asked for confirmation every time a cookie is stored or retrieved. You can selectively accept or reject each cookie. The confirmation dialogue will also allow you to set a domain specific policy, if you do not want to confirm each cookie for that domain.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Accept all cookies</guilabel -></term> +<term><guilabel>Accept all cookies</guilabel></term> <listitem> -<para ->If this option is selected, all cookies will be accepted without asking for confirmation.</para> +<para>If this option is selected, all cookies will be accepted without asking for confirmation.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Reject all cookies</guilabel -></term> +<term><guilabel>Reject all cookies</guilabel></term> <listitem> -<para ->If this option is selected, all cookies will be rejected without asking for confirmation.</para> +<para>If this option is selected, all cookies will be rejected without asking for confirmation.</para> </listitem> </varlistentry> </variablelist> -<para ->In addition to the default policy for handling of cookies, which you can set by selecting one of the three options described above, you can also set policies for specific host domains using the controls in the <guilabel ->Domain Specific</guilabel -> group.</para> +<para>In addition to the default policy for handling of cookies, which you can set by selecting one of the three options described above, you can also set policies for specific host domains using the controls in the <guilabel>Domain Specific</guilabel> group.</para> -<para ->The Ask, Accept, or Reject policy can be applied to a specific domain by clicking on the <guibutton ->New...</guibutton -> button, which brings up a dialogue. In this dialogue, you can type the name of the domain (with a leading dot), then select the policy you want to apply to this domain. Note that entries may also get added while you are browsing, if the default policy is to ask for confirmation, and you choose a general policy for a specific host (for example, by selecting <guilabel ->Reject all cookies from this domain</guilabel -> when asked to confirm a cookie).</para> +<para>The Ask, Accept, or Reject policy can be applied to a specific domain by clicking on the <guibutton>New...</guibutton> button, which brings up a dialogue. In this dialogue, you can type the name of the domain (with a leading dot), then select the policy you want to apply to this domain. Note that entries may also get added while you are browsing, if the default policy is to ask for confirmation, and you choose a general policy for a specific host (for example, by selecting <guilabel>Reject all cookies from this domain</guilabel> when asked to confirm a cookie).</para> -<para ->You can also select a specific host domain from the list and click the <guibutton ->Change</guibutton -> button to choose a different policy for that domain than the one shown in the list.</para> +<para>You can also select a specific host domain from the list and click the <guibutton>Change</guibutton> button to choose a different policy for that domain than the one shown in the list.</para> -<para ->To delete a domain specific policy, choose a domain from the list, and then click the <guibutton ->Delete</guibutton -> button. The default policy will apply to domains which have been deleted from the list.</para> +<para>To delete a domain specific policy, choose a domain from the list, and then click the <guibutton>Delete</guibutton> button. The default policy will apply to domains which have been deleted from the list.</para> </sect2> <sect2 id="cookie-management"> -<title ->Management</title> - -<para ->In the <guilabel ->Management</guilabel -> tab you can browse and selectively delete cookies that have been set in the past.</para> - -<para ->In the upper part of this dialogue, you can see a list of domains displayed as a tree. Click on the little <guiicon ->+</guiicon -> next to a domain to see all cookies that have been set for this particular target domain. If you select one of these cookies, you will notice that its contents will show up in the frame <guilabel ->Cookie Details</guilabel -> below.</para> - -<para ->By clicking the <guibutton ->Delete</guibutton -> button you can now delete the selected cookie. Click <guibutton ->Delete All</guibutton -> to delete all cookies stored.</para> - -<para ->Choose <guibutton ->Reload List</guibutton -> to reload the list from your hard disk. You might want to do this if you have had the module open and are testing web sites or have made many changes in the module itself.</para> +<title>Management</title> + +<para>In the <guilabel>Management</guilabel> tab you can browse and selectively delete cookies that have been set in the past.</para> + +<para>In the upper part of this dialogue, you can see a list of domains displayed as a tree. Click on the little <guiicon>+</guiicon> next to a domain to see all cookies that have been set for this particular target domain. If you select one of these cookies, you will notice that its contents will show up in the frame <guilabel>Cookie Details</guilabel> below.</para> + +<para>By clicking the <guibutton>Delete</guibutton> button you can now delete the selected cookie. Click <guibutton>Delete All</guibutton> to delete all cookies stored.</para> + +<para>Choose <guibutton>Reload List</guibutton> to reload the list from your hard disk. You might want to do this if you have had the module open and are testing web sites or have made many changes in the module itself.</para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/crypto/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/crypto/index.docbook index 0c4d8e716c4..65ec3b1d583 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/crypto/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/crypto/index.docbook @@ -2,311 +2,159 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-10-17</date> -<releaseinfo ->3.1</releaseinfo> +<date>2002-10-17</date> +<releaseinfo>3.1</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->crypto</keyword> -<keyword ->SSL</keyword> -<keyword ->encryption</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>crypto</keyword> +<keyword>SSL</keyword> +<keyword>encryption</keyword> </keywordset> </articleinfo> <sect1 id="crypto"> -<title ->Encryption Configuration</title> +<title>Encryption Configuration</title> <sect2 id="crypto-intro"> -<title ->Introduction</title> -<para ->Many applications within &kde; are capable of exchanging information using encrypted files and/or network transmissions.</para> +<title>Introduction</title> +<para>Many applications within &kde; are capable of exchanging information using encrypted files and/or network transmissions.</para> </sect2> <sect2 id="crypto-use"> -<title ->Use</title> - -<warning -><para ->All encryption schemes are only as strong as their weakest link. In general, unless you have some previous training/knowledge, it is better to leave this module unchanged.</para -></warning> - -<para ->The options within this module can be divided into two groups:</para> - -<para ->Two options along the bottom of the module, <guilabel ->Warn on entering SSL Mode</guilabel -> and <guilabel ->Warn on leaving SSL mode</guilabel ->, allow you to determine if &kde; should inform you when you enter or leave SSL encryption.</para -> - -<para ->The remainder of the options are about determining which encryption methods to use, and which should not be used. Once you have selected the appropriate encryption protocols, simply click <guibutton ->Apply</guibutton -> to commit your changes.</para> - -<tip -><para ->Only make changes to this module if specific information about the strength or weakness of a particular encryption method is given to you from <emphasis ->a reliable source</emphasis ->.</para -></tip> +<title>Use</title> + +<warning><para>All encryption schemes are only as strong as their weakest link. In general, unless you have some previous training/knowledge, it is better to leave this module unchanged.</para></warning> + +<para>The options within this module can be divided into two groups:</para> + +<para>Two options along the bottom of the module, <guilabel>Warn on entering SSL Mode</guilabel> and <guilabel>Warn on leaving SSL mode</guilabel>, allow you to determine if &kde; should inform you when you enter or leave SSL encryption.</para> + +<para>The remainder of the options are about determining which encryption methods to use, and which should not be used. Once you have selected the appropriate encryption protocols, simply click <guibutton>Apply</guibutton> to commit your changes.</para> + +<tip><para>Only make changes to this module if specific information about the strength or weakness of a particular encryption method is given to you from <emphasis>a reliable source</emphasis>.</para></tip> </sect2> <!-- Ugh.. write a bunch of stuff about the rest of it --> <sect2 id="ssl_tab"> -<title ->The <guilabel ->SSL</guilabel -> Tab</title> - -<para ->The first option is <guilabel ->Enable TLS support if supported by the server</guilabel ->. <acronym ->TLS</acronym -> is Transport Layer Security, and is the newest version of <acronym ->SSL</acronym ->. It integrates better than <acronym ->SSL</acronym -> with other protocols, and it has replaced <acronym ->SSL</acronym -> in protocols such as POP3 and <acronym ->SMTP</acronym ->.</para> - -<para ->Then next options are <guilabel ->Enable SSL v2</guilabel -> and <guilabel ->Enable SSL v3</guilabel ->. These are the second and third revision of the <acronym ->SSL</acronym -> protocol, and it is normal to enable both.</para> - -<para ->There are several different <firstterm ->Ciphers</firstterm -> available, and you can enable these separately in the lists labelled <guilabel ->SSL v2 Ciphers to Use</guilabel -> and <guilabel ->SSL v3 Ciphers to Use</guilabel ->. The actual protocol to use is negotiated by the application and the server when the connection is created.</para> - -<para ->There are several <guilabel ->Cipher Wizards</guilabel -> to help you choose a set that is suitable for your use.</para> +<title>The <guilabel>SSL</guilabel> Tab</title> + +<para>The first option is <guilabel>Enable TLS support if supported by the server</guilabel>. <acronym>TLS</acronym> is Transport Layer Security, and is the newest version of <acronym>SSL</acronym>. It integrates better than <acronym>SSL</acronym> with other protocols, and it has replaced <acronym>SSL</acronym> in protocols such as POP3 and <acronym>SMTP</acronym>.</para> + +<para>Then next options are <guilabel>Enable SSL v2</guilabel> and <guilabel>Enable SSL v3</guilabel>. These are the second and third revision of the <acronym>SSL</acronym> protocol, and it is normal to enable both.</para> + +<para>There are several different <firstterm>Ciphers</firstterm> available, and you can enable these separately in the lists labelled <guilabel>SSL v2 Ciphers to Use</guilabel> and <guilabel>SSL v3 Ciphers to Use</guilabel>. The actual protocol to use is negotiated by the application and the server when the connection is created.</para> + +<para>There are several <guilabel>Cipher Wizards</guilabel> to help you choose a set that is suitable for your use.</para> <variablelist> <varlistentry> -<term -><guibutton ->Most Compatible</guibutton -></term> +<term><guibutton>Most Compatible</guibutton></term> <listitem> -<para ->Select the settings found to be most compatible with the most servers.</para> +<para>Select the settings found to be most compatible with the most servers.</para> </listitem> </varlistentry> <varlistentry> -<term -><guibutton ->US Ciphers Only</guibutton -></term> +<term><guibutton>US Ciphers Only</guibutton></term> <listitem> -<para ->Select only the US <quote ->strong</quote -> (128 bit or greater) ciphers.</para> +<para>Select only the US <quote>strong</quote> (128 bit or greater) ciphers.</para> </listitem> </varlistentry> <varlistentry> -<term -><guibutton ->Export Ciphers Only</guibutton -></term> +<term><guibutton>Export Ciphers Only</guibutton></term> <listitem> -<para ->Select only the weak (56 bit or less) ciphers.</para> +<para>Select only the weak (56 bit or less) ciphers.</para> </listitem> </varlistentry> <varlistentry> -<term -><guibutton ->Enable All</guibutton -></term> +<term><guibutton>Enable All</guibutton></term> <listitem> -<para ->Select all ciphers and methods.</para> +<para>Select all ciphers and methods.</para> </listitem> </varlistentry> </variablelist> -<para ->Finally, there are some general <acronym ->SSL</acronym -> settings.</para> +<para>Finally, there are some general <acronym>SSL</acronym> settings.</para> <variablelist> <varlistentry> -<term -><guilabel ->Use EGD</guilabel -></term> +<term><guilabel>Use EGD</guilabel></term> <listitem> -<para ->If selected, <application ->OpenSSL</application -> will be asked to use the entropy gathering daemon (<acronym ->EGD</acronym ->) for initialising the pseudo-random number generator.</para> +<para>If selected, <application>OpenSSL</application> will be asked to use the entropy gathering daemon (<acronym>EGD</acronym>) for initialising the pseudo-random number generator.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Use entropy file</guilabel -></term> +<term><guilabel>Use entropy file</guilabel></term> <listitem> -<para ->If selected, <application ->OpenSSL</application -> will be asked to use the given file as entropy for initialising the pseudo-random number generator.</para> +<para>If selected, <application>OpenSSL</application> will be asked to use the given file as entropy for initialising the pseudo-random number generator.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Warn on entering SSL mode</guilabel -></term> +<term><guilabel>Warn on entering SSL mode</guilabel></term> <listitem> -<para ->If selected, you will be notified when entering an <acronym ->SSL</acronym -> enabled site.</para> +<para>If selected, you will be notified when entering an <acronym>SSL</acronym> enabled site.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Warn on leaving SSL mode</guilabel -></term> +<term><guilabel>Warn on leaving SSL mode</guilabel></term> <listitem> -<para ->If selected, you will be notified when leaving an <acronym ->SSL</acronym -> based site.</para> +<para>If selected, you will be notified when leaving an <acronym>SSL</acronym> based site.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Warn on sending unencrypted data</guilabel -></term> +<term><guilabel>Warn on sending unencrypted data</guilabel></term> <listitem> -<para ->If selected, you will be notified before sending unencrypted data via a web browser.</para> +<para>If selected, you will be notified before sending unencrypted data via a web browser.</para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="openssl"> -<title ->The <guilabel ->OpenSSL</guilabel -> Tab</title> - -<para ->Here you can test if your <application ->OpenSSL</application -> libraries have been detected correctly by &kde;, with the <guibutton ->Test</guibutton -> button.</para> - -<para ->If the test is unsuccessful, you can specify a path to the libraries in the field labelled <guilabel ->Path to OpenSSL Shared Libraries</guilabel ->.</para> +<title>The <guilabel>OpenSSL</guilabel> Tab</title> + +<para>Here you can test if your <application>OpenSSL</application> libraries have been detected correctly by &kde;, with the <guibutton>Test</guibutton> button.</para> + +<para>If the test is unsuccessful, you can specify a path to the libraries in the field labelled <guilabel>Path to OpenSSL Shared Libraries</guilabel>.</para> </sect2> <sect2 id="your-certificates"> -<title ->The <guilabel ->Your Certificates</guilabel -> Tab</title> +<title>The <guilabel>Your Certificates</guilabel> Tab</title> -<para ->The list shows which certificates of yours &kde; knows about. You can easily manage them from here.</para> +<para>The list shows which certificates of yours &kde; knows about. You can easily manage them from here.</para> </sect2> <sect2 id="authentication"> -<title ->The <guilabel ->Authentication</guilabel -> Tab</title> +<title>The <guilabel>Authentication</guilabel> Tab</title> -<para ->Not yet documented </para> +<para>Not yet documented </para> </sect2> <sect2 id="peer-ssl-certificates"> -<title ->The <guilabel ->Peer SSL Certificates</guilabel -> Tab</title> +<title>The <guilabel>Peer SSL Certificates</guilabel> Tab</title> -<para ->The list box shows which site and personal certificates &kde; knows about. You can easily manage them from here.</para> +<para>The list box shows which site and personal certificates &kde; knows about. You can easily manage them from here.</para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/desktop/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/desktop/index.docbook index 43b1ffca305..e529e365342 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/desktop/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/desktop/index.docbook @@ -2,153 +2,77 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<author ->&Jost.Schenck; &Jost.Schenck.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<author>&Jost.Schenck; &Jost.Schenck.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-08</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-08</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->desktop</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>desktop</keyword> </keywordset> </articleinfo> <sect1 id="desktop"> -<title ->Desktop</title> +<title>Desktop</title> <sect2 id="desktop-appearance"> -<title -><guilabel ->Appearance Tab</guilabel -></title> +<title><guilabel>Appearance Tab</guilabel></title> -<para ->Here you can configure how icons on your desktop appear.</para> +<para>Here you can configure how icons on your desktop appear.</para> <variablelist> <varlistentry> -<term -><guilabel ->Standard font:</guilabel -></term> -<listitem -><para ->This option can be used to change the typeface used on the desktop. Simply select your typeface from the dropdown box.</para -></listitem> +<term><guilabel>Standard font:</guilabel></term> +<listitem><para>This option can be used to change the typeface used on the desktop. Simply select your typeface from the dropdown box.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Font size:</guilabel -></term> -<listitem -><para ->You can change the relative size of the text on the Desktop. </para -></listitem> +<term><guilabel>Font size:</guilabel></term> +<listitem><para>You can change the relative size of the text on the Desktop. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Normal text colour:</guilabel -></term> -<listitem -><para ->This option lets you select the colour of normal (or unhighlighted) text.</para -></listitem> +<term><guilabel>Normal text colour:</guilabel></term> +<listitem><para>This option lets you select the colour of normal (or unhighlighted) text.</para></listitem> </varlistentry> -<varlistentry -><term -><guilabel ->Text background colour:</guilabel -></term> -<listitem -><para ->This option lets you select the background colour of normal text. If left unchecked, the text has a transparent background. If selected, you can choose the colour by pressing the button. </para -></listitem> +<varlistentry><term><guilabel>Text background colour:</guilabel></term> +<listitem><para>This option lets you select the background colour of normal text. If left unchecked, the text has a transparent background. If selected, you can choose the colour by pressing the button. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Underline filenames:</guilabel -></term> -<listitem -><para ->Determines if file names are underlined on the Desktop.</para -></listitem> +<term><guilabel>Underline filenames:</guilabel></term> +<listitem><para>Determines if file names are underlined on the Desktop.</para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="desktop-number"> -<title -><guilabel ->Multiple Desktops</guilabel -></title> +<title><guilabel>Multiple Desktops</guilabel></title> -<para ->&kde; offers you the possibility to have several virtual desktops. In this tab you can configure the number of desktops as well as their names. Just use the slider to adjust the number of desktops. You can assign names to the desktops by entering text into the text fields below.</para -> +<para>&kde; offers you the possibility to have several virtual desktops. In this tab you can configure the number of desktops as well as their names. Just use the slider to adjust the number of desktops. You can assign names to the desktops by entering text into the text fields below.</para> -<para ->If enable <guilabel ->Mouse wheel over desktop switches desktop</guilabel -> then scrolling the wheel over an empty space on the desktop will change the the next virtual desktop numerically, in the direction you scrolled (either up or down).</para> +<para>If enable <guilabel>Mouse wheel over desktop switches desktop</guilabel> then scrolling the wheel over an empty space on the desktop will change the the next virtual desktop numerically, in the direction you scrolled (either up or down).</para> </sect2> <sect2 id="desktop-desktop-path"> -<title -><guilabel ->Paths</guilabel -></title> - -<para ->You can use this section to configure where Desktop files, Wastebin files, and Autostart files are stored on your computer as well as the standard path for documents. </para> - -<warning -><para ->By changing the values in the first three of these paths, you will automatically move the files from their previous to their new location. </para -></warning> - -<note -><para ->Do not just delete the icons from the desktop. If you dislike them move them somewhere else in this module or hide them (with a dot in the front of the filename). If the paths in this dialogue do not exist when &kde; is started, they will be recreated.</para -></note> +<title><guilabel>Paths</guilabel></title> + +<para>You can use this section to configure where Desktop files, Wastebin files, and Autostart files are stored on your computer as well as the standard path for documents. </para> + +<warning><para>By changing the values in the first three of these paths, you will automatically move the files from their previous to their new location. </para></warning> + +<note><para>Do not just delete the icons from the desktop. If you dislike them move them somewhere else in this module or hide them (with a dot in the front of the filename). If the paths in this dialogue do not exist when &kde; is started, they will be recreated.</para></note> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/desktopbehavior/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/desktopbehavior/index.docbook index 80ad24d9b3c..53aa4e1ffad 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/desktopbehavior/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/desktopbehavior/index.docbook @@ -2,218 +2,113 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<author ->&Jost.Schenck; &Jost.Schenck.mail;</author> -<othercredit role="translator" -><firstname ->Jonathan</firstname -><surname ->Riddell</surname -><affiliation -><address -><email ->kde-en-gb@jriddell.org</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<author>&Jost.Schenck; &Jost.Schenck.mail;</author> +<othercredit role="translator"><firstname>Jonathan</firstname><surname>Riddell</surname><affiliation><address><email>kde-en-gb@jriddell.org</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->desktop</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>desktop</keyword> </keywordset> </articleinfo> <sect1 id="desktop"> -<title ->Desktop Behaviour</title> +<title>Desktop Behaviour</title> <sect2 id="desktop-desktop"> -<title -><guilabel ->Desktop</guilabel -> Tab</title> +<title><guilabel>Desktop</guilabel> Tab</title> <variablelist> <varlistentry> -<term -><guilabel ->Show icons on desktop</guilabel -></term> +<term><guilabel>Show icons on desktop</guilabel></term> <listitem> -<para ->Uncheck this option if you do not want to have icons on the desktop. Without icons the desktop may be somewhat faster, but you will no longer be able to drag files to the desktop.</para> -<para ->This will not remove any files already stored on the desktop, they will instead be hidden.</para> +<para>Uncheck this option if you do not want to have icons on the desktop. Without icons the desktop may be somewhat faster, but you will no longer be able to drag files to the desktop.</para> +<para>This will not remove any files already stored on the desktop, they will instead be hidden.</para> -<para ->If this is enabled, several further options become available:</para> +<para>If this is enabled, several further options become available:</para> <variablelist> <varlistentry> -<term -><guilabel ->Automatically line up icons</guilabel -></term> -<listitem -><para ->If this option is enabled, &kde; will align icons on a grid on the desktop. If it is not enabled, you may drop icons anywhere, and they will not be aligned for you.</para -></listitem> +<term><guilabel>Automatically line up icons</guilabel></term> +<listitem><para>If this option is enabled, &kde; will align icons on a grid on the desktop. If it is not enabled, you may drop icons anywhere, and they will not be aligned for you.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Show hidden files</guilabel -></term> -<listitem -><para ->If this option is enabled, then all hidden files will appear on the desktop. Generally this only clutters your desktop area, but if you are often working with hidden files or folders, this can be useful.</para> -<warning -><para ->Be very careful when deleting or modifying hidden files. Many of these files are configuration files and are essential for the correct operation of your computer.</para -></warning> +<term><guilabel>Show hidden files</guilabel></term> +<listitem><para>If this option is enabled, then all hidden files will appear on the desktop. Generally this only clutters your desktop area, but if you are often working with hidden files or folders, this can be useful.</para> +<warning><para>Be very careful when deleting or modifying hidden files. Many of these files are configuration files and are essential for the correct operation of your computer.</para></warning> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Allow programs in desktop window</guilabel -></term> +<term><guilabel>Allow programs in desktop window</guilabel></term> <listitem> -<para ->Enabling this option allows you to set a program as your desktop background, for example <command ->xearth</command ->, or &kworldclock;</para> +<para>Enabling this option allows you to set a program as your desktop background, for example <command>xearth</command>, or &kworldclock;</para> </listitem> </varlistentry> </variablelist> -<para ->Below these options you can see a list titled <guilabel ->Show Icon Previews For</guilabel ->. The &kde; desktop has a preview feature for many file types, including <acronym ->HTML</acronym -> files, images, &PostScript; and <acronym ->PDF</acronym ->, sound, web archives (if you have the appropriate &konqueror; plugin installed) and text files.</para> - -<para ->if you enable previews for one of these, files of that particular file type will not be represented by standard icons on the desktop, but will instead be shown as miniature previews. On slow computers, the previews can take some time to show up, so you might not want to enable this feature.</para> - -<para ->Finally there is <guilabel ->Display device icons:</guilabel ->.</para> - -<para ->On some operating systems (&Linux; and FreeBSD, so far) &kde; can dynamically display icons for each <firstterm ->mountable</firstterm -> device you have available. This could be &CD-ROM; drives, floppy disk drives, or network shares.</para> - -<para ->If you enable this, you can choose what kind, if any, of these devices you would like quick access icons to be displayed for.</para> +<para>Below these options you can see a list titled <guilabel>Show Icon Previews For</guilabel>. The &kde; desktop has a preview feature for many file types, including <acronym>HTML</acronym> files, images, &PostScript; and <acronym>PDF</acronym>, sound, web archives (if you have the appropriate &konqueror; plugin installed) and text files.</para> + +<para>if you enable previews for one of these, files of that particular file type will not be represented by standard icons on the desktop, but will instead be shown as miniature previews. On slow computers, the previews can take some time to show up, so you might not want to enable this feature.</para> + +<para>Finally there is <guilabel>Display device icons:</guilabel>.</para> + +<para>On some operating systems (&Linux; and FreeBSD, so far) &kde; can dynamically display icons for each <firstterm>mountable</firstterm> device you have available. This could be &CD-ROM; drives, floppy disk drives, or network shares.</para> + +<para>If you enable this, you can choose what kind, if any, of these devices you would like quick access icons to be displayed for.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Show tooltips</guilabel -></term> +<term><guilabel>Show tooltips</guilabel></term> <listitem> -<para ->Check this option if you would like to see tooltips for icons on the desktop as you hover the mouse over them. These tooltips display information about the file represented by the icon. Depending on the type of file, the information can range from simple file size and creation dates for unfamiliar file types, to complete meta information such as the content of tags for music files.</para> +<para>Check this option if you would like to see tooltips for icons on the desktop as you hover the mouse over them. These tooltips display information about the file represented by the icon. Depending on the type of file, the information can range from simple file size and creation dates for unfamiliar file types, to complete meta information such as the content of tags for music files.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Mouse button actions:</guilabel -></term> +<term><guilabel>Mouse button actions:</guilabel></term> <listitem> -<para ->The mouse button section allows you to determine what happens when you click one of the three mouse buttons on the Desktop (where there is no window).</para> +<para>The mouse button section allows you to determine what happens when you click one of the three mouse buttons on the Desktop (where there is no window).</para> -<note -><para ->Not all mice have three buttons. Two button mice can usually activate the <mousebutton ->Middle</mousebutton -> button by pressing both the <mousebutton ->Left</mousebutton -> and <mousebutton ->Right</mousebutton -> mouse buttons at the same time.</para -></note> +<note><para>Not all mice have three buttons. Two button mice can usually activate the <mousebutton>Middle</mousebutton> button by pressing both the <mousebutton>Left</mousebutton> and <mousebutton>Right</mousebutton> mouse buttons at the same time.</para></note> -<para ->For each of the three mouse buttons, you can select:</para> +<para>For each of the three mouse buttons, you can select:</para> <variablelist> <varlistentry> -<term ->No Action</term> -<listitem -><para ->When you use this mouse button, nothing happens.</para -></listitem> +<term>No Action</term> +<listitem><para>When you use this mouse button, nothing happens.</para></listitem> </varlistentry> <varlistentry> -<term ->Window list menu</term> -<listitem -><para ->This brings up a submenu with all the virtual desktops. Under each virtual desktop, you can select any window currently located on that desktop. Once selected, &kde; will switch to that desktop, and place the focus on that window.</para -></listitem> +<term>Window list menu</term> +<listitem><para>This brings up a submenu with all the virtual desktops. Under each virtual desktop, you can select any window currently located on that desktop. Once selected, &kde; will switch to that desktop, and place the focus on that window.</para></listitem> </varlistentry> <varlistentry> -<term ->Desktop Menu.</term> -<listitem -><para ->This brings up a submenu with commands specific to &kde;. You can create icons, edit bookmarks, cut and paste, run commands, configure &kde;, arrange icons, lock the session and log out of &kde;. The exact content of the menu varies depending on the current status of &kde;. </para -></listitem> +<term>Desktop Menu.</term> +<listitem><para>This brings up a submenu with commands specific to &kde;. You can create icons, edit bookmarks, cut and paste, run commands, configure &kde;, arrange icons, lock the session and log out of &kde;. The exact content of the menu varies depending on the current status of &kde;. </para></listitem> </varlistentry> <varlistentry> -<term ->Application Menu</term> -<listitem -><para ->This brings up the <guimenu ->Application</guimenu -> Menus (also know as the <guimenu ->K</guimenu -> Menus), so you can start a new application.</para -></listitem> +<term>Application Menu</term> +<listitem><para>This brings up the <guimenu>Application</guimenu> Menus (also know as the <guimenu>K</guimenu> Menus), so you can start a new application.</para></listitem> </varlistentry> </variablelist> <!-- FIXME: someone needs to write something about these custom menus --> @@ -222,22 +117,11 @@ </varlistentry> <varlistentry> -<term -><guilabel ->Show menu bar at the top of the screeen:</guilabel -></term> +<term><guilabel>Show menu bar at the top of the screeen:</guilabel></term> <listitem> -<para ->This option determines whether there is a menu across the top of the &kde; Desktop similar to the style of &MacOS;.</para> - -<para ->The default is <guilabel ->None</guilabel ->. If you select <guilabel ->Desktop menu bar</guilabel -> one static menu is shown at the top of the screen, displaying the desktop menu. Finally there is <guilabel ->Current application's menu bar (Mac OS-style)</guilabel ->. If this option is selected, applications won't have their menu bar attached to their own window anymore. Instead, there is one menu bar at the top of the screen which shows the menus of the currently active application. You might recognise this behaviour from &MacOS;. </para> +<para>This option determines whether there is a menu across the top of the &kde; Desktop similar to the style of &MacOS;.</para> + +<para>The default is <guilabel>None</guilabel>. If you select <guilabel>Desktop menu bar</guilabel> one static menu is shown at the top of the screen, displaying the desktop menu. Finally there is <guilabel>Current application's menu bar (Mac OS-style)</guilabel>. If this option is selected, applications won't have their menu bar attached to their own window anymore. Instead, there is one menu bar at the top of the screen which shows the menus of the currently active application. You might recognise this behaviour from &MacOS;. </para> </listitem> </varlistentry> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/ebrowsing/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/ebrowsing/index.docbook index 2753da77908..cc60b7c1206 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/ebrowsing/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/ebrowsing/index.docbook @@ -2,225 +2,75 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> -<author ->&Yves.Arrouye; &Yves.Arrouye.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> +<author>&Yves.Arrouye; &Yves.Arrouye.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-10-16</date> -<releaseinfo ->3.1</releaseinfo> +<date>2002-10-16</date> +<releaseinfo>3.1</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->enhanced browsing</keyword> -<keyword ->web shortcuts</keyword> -<keyword ->browsing</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>enhanced browsing</keyword> +<keyword>web shortcuts</keyword> +<keyword>browsing</keyword> </keywordset> </articleinfo> <sect1 id="ebrowse"> -<title ->Web Shortcuts</title> +<title>Web Shortcuts</title> <sect2 id="ebrowse-intro"> -<title ->Introduction</title> - -<para ->&konqueror; offers some features to enhance your browsing experience. One such feature is <emphasis ->Web Shortcuts</emphasis ->.</para> - -<para ->You may already have noticed that &kde; is very Internet friendly. For example, you can click on the <guimenuitem ->Run</guimenuitem -> menu item or type the keyboard shortcut assigned to that command (<keycombo action="simul" -><keycap ->Alt</keycap -><keycap ->F2</keycap -></keycombo ->, unless you have changed it) and type in a <acronym ->URI</acronym ->. <footnote -><para ->Uniform Resource Identifier. A standard way of referring to a resource such as a file on your computer, a World Wide Web address, an email address, <abbrev ->etc...</abbrev ->.</para -></footnote -></para> - -<para ->Web shortcuts, on the other hand, let you come up with new pseudo <acronym ->URL</acronym -> schemes, or shortcuts, that basically let you <emphasis ->parameterise</emphasis -> commonly used <acronym ->URI</acronym ->s. For example, if you like the Google search engine, you can configure KDE so that a pseudo <acronym ->URL</acronym -> scheme like <emphasis ->gg</emphasis -> will trigger a search on Google. This way, typing <userinput ->gg:<replaceable ->my query</replaceable -></userinput -> will search for <replaceable ->my query</replaceable -> on Google.</para> - -<note -><para ->One can see why we call these pseudo <acronym ->URL</acronym -> schemes. They are used like a <acronym ->URL</acronym -> scheme, but the input is not properly <acronym ->URL</acronym -> encoded, so one will type <userinput ->google:kde apps</userinput -> and not <userinput ->google:kde+apps</userinput ->.</para -></note> - -<para ->You can use web shortcuts wherever you would normally use <acronym ->URI</acronym ->s. Shortcuts for several search engines should already be configured on your system, but you can add new keywords and change or delete existing ones in the enhanced browsing control module. </para> +<title>Introduction</title> + +<para>&konqueror; offers some features to enhance your browsing experience. One such feature is <emphasis>Web Shortcuts</emphasis>.</para> + +<para>You may already have noticed that &kde; is very Internet friendly. For example, you can click on the <guimenuitem>Run</guimenuitem> menu item or type the keyboard shortcut assigned to that command (<keycombo action="simul"><keycap>Alt</keycap><keycap>F2</keycap></keycombo>, unless you have changed it) and type in a <acronym>URI</acronym>. <footnote><para>Uniform Resource Identifier. A standard way of referring to a resource such as a file on your computer, a World Wide Web address, an email address, <abbrev>etc...</abbrev>.</para></footnote></para> + +<para>Web shortcuts, on the other hand, let you come up with new pseudo <acronym>URL</acronym> schemes, or shortcuts, that basically let you <emphasis>parameterise</emphasis> commonly used <acronym>URI</acronym>s. For example, if you like the Google search engine, you can configure KDE so that a pseudo <acronym>URL</acronym> scheme like <emphasis>gg</emphasis> will trigger a search on Google. This way, typing <userinput>gg:<replaceable>my query</replaceable></userinput> will search for <replaceable>my query</replaceable> on Google.</para> + +<note><para>One can see why we call these pseudo <acronym>URL</acronym> schemes. They are used like a <acronym>URL</acronym> scheme, but the input is not properly <acronym>URL</acronym> encoded, so one will type <userinput>google:kde apps</userinput> and not <userinput>google:kde+apps</userinput>.</para></note> + +<para>You can use web shortcuts wherever you would normally use <acronym>URI</acronym>s. Shortcuts for several search engines should already be configured on your system, but you can add new keywords and change or delete existing ones in the enhanced browsing control module. </para> </sect2> <sect2 id="ebrowse-use"> -<title ->Use</title> +<title>Use</title> -<para ->There is a single tab in this control module. The title of the tab is <guilabel ->Keywords</guilabel ->. This tab features two main boxes, one for Internet Keywords and one for web shortcuts.</para> +<para>There is a single tab in this control module. The title of the tab is <guilabel>Keywords</guilabel>. This tab features two main boxes, one for Internet Keywords and one for web shortcuts.</para> <sect3 id="ebrowse-srch-use"> -<title ->Web Shortcuts</title> - -<para ->The descriptive names of defined web shortcuts are shown in a listbox. As with other lists in &kde;, you can click on a column heading to toggle the sort order between ascending and descending, and you can resize the columns.</para> - -<para ->If you double-click on a specific entry in the list of defined search providers, the details for that entry are shown in a popup dialogue. In addition to the descriptive name for the item, you can also see the <acronym ->URI</acronym -> which is used, as well as the associated shortcuts which you can type anywhere in &kde; where <acronym ->URI</acronym ->s are expected. A given search provider can have multiple shortcuts, each separated by a comma.</para> - -<para ->The text boxes are used not only for displaying information about an item in the list of web shortcuts, but also for modifying or adding new items.</para> - -<para ->You can change the contents of either the <guilabel ->Search URI</guilabel -> or the <guilabel ->URI Shortcuts</guilabel -> text box. Click <guibutton ->OK</guibutton -> to save your changes or <guibutton ->Cancel</guibutton -> to exit the dialogue with no changes.</para> - -<para ->If you examine the contents of the <guilabel ->Search URI</guilabel -> text box, you will find that most, if not all of the entries have a <option ->\{@}</option -> in them. This sequence of two characters acts as a parameter, which is to say that they are replaced by whatever you happen to type after the colon character that is between a shortcut and its parameter. Let's consider some examples to clarify this idea.</para> - -<para ->Suppose that the <acronym ->URI</acronym -> is <userinput ->http://www.google.com/search?q=\{@}</userinput ->, and <userinput ->gg</userinput -> is a shortcut to this <acronym ->URI</acronym ->. Then, typing <userinput ->gg:<replaceable ->alpha</replaceable -></userinput -> is equivalent to <userinput ->http://www.google.com/search?q=<replaceable ->alpha</replaceable -></userinput ->. You could type anything after the <userinput ->:</userinput -> character; whatever you have typed simply replaces the <option ->\{@}</option -> characters, after being converted to the appropriate character set for the search provider and then properly <acronym ->URL</acronym ->-encoded. Only the <option ->\{@}</option -> part of the search <acronym ->URI</acronym -> is touched, the rest of it is supposed to be properly <acronym ->URL</acronym ->-encoded already and is left as is.</para> - -<para ->You can also have shortcuts without parameters. Suppose the <acronym ->URI</acronym -> was <emphasis ->file:/home/me/mydocs/kofficefiles/kword</emphasis -> and the shortcut was <emphasis ->mykword</emphasis ->. Then, typing <userinput ->mykword:</userinput -> is the same as typing the complete <acronym ->URI</acronym ->. Note that there is nothing after the colon when typing the shortcut, but the colon is still required in order for the shortcut to be recognised as such.</para> - -<para ->By now, you will have understood that even though these shortcuts are called web shortcuts, they really are shortcuts to parameterised <acronym ->URI</acronym ->s, which can point not only to web sites like search engines but also to anything else that can be pointed to by a <acronym ->URI</acronym ->. Web shortcuts are a very powerful feature of navigation in &kde;.</para> +<title>Web Shortcuts</title> + +<para>The descriptive names of defined web shortcuts are shown in a listbox. As with other lists in &kde;, you can click on a column heading to toggle the sort order between ascending and descending, and you can resize the columns.</para> + +<para>If you double-click on a specific entry in the list of defined search providers, the details for that entry are shown in a popup dialogue. In addition to the descriptive name for the item, you can also see the <acronym>URI</acronym> which is used, as well as the associated shortcuts which you can type anywhere in &kde; where <acronym>URI</acronym>s are expected. A given search provider can have multiple shortcuts, each separated by a comma.</para> + +<para>The text boxes are used not only for displaying information about an item in the list of web shortcuts, but also for modifying or adding new items.</para> + +<para>You can change the contents of either the <guilabel>Search URI</guilabel> or the <guilabel>URI Shortcuts</guilabel> text box. Click <guibutton>OK</guibutton> to save your changes or <guibutton>Cancel</guibutton> to exit the dialogue with no changes.</para> + +<para>If you examine the contents of the <guilabel>Search URI</guilabel> text box, you will find that most, if not all of the entries have a <option>\{@}</option> in them. This sequence of two characters acts as a parameter, which is to say that they are replaced by whatever you happen to type after the colon character that is between a shortcut and its parameter. Let's consider some examples to clarify this idea.</para> + +<para>Suppose that the <acronym>URI</acronym> is <userinput>http://www.google.com/search?q=\{@}</userinput>, and <userinput>gg</userinput> is a shortcut to this <acronym>URI</acronym>. Then, typing <userinput>gg:<replaceable>alpha</replaceable></userinput> is equivalent to <userinput>http://www.google.com/search?q=<replaceable>alpha</replaceable></userinput>. You could type anything after the <userinput>:</userinput> character; whatever you have typed simply replaces the <option>\{@}</option> characters, after being converted to the appropriate character set for the search provider and then properly <acronym>URL</acronym>-encoded. Only the <option>\{@}</option> part of the search <acronym>URI</acronym> is touched, the rest of it is supposed to be properly <acronym>URL</acronym>-encoded already and is left as is.</para> + +<para>You can also have shortcuts without parameters. Suppose the <acronym>URI</acronym> was <emphasis>file:/home/me/mydocs/kofficefiles/kword</emphasis> and the shortcut was <emphasis>mykword</emphasis>. Then, typing <userinput>mykword:</userinput> is the same as typing the complete <acronym>URI</acronym>. Note that there is nothing after the colon when typing the shortcut, but the colon is still required in order for the shortcut to be recognised as such.</para> + +<para>By now, you will have understood that even though these shortcuts are called web shortcuts, they really are shortcuts to parameterised <acronym>URI</acronym>s, which can point not only to web sites like search engines but also to anything else that can be pointed to by a <acronym>URI</acronym>. Web shortcuts are a very powerful feature of navigation in &kde;.</para> </sect3> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/email/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/email/index.docbook index f4571453809..2497c28be53 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/email/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/email/index.docbook @@ -2,128 +2,70 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> -<author ->&Jost.Schenck; &Jost.Schenck.mail;</author> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> +<author>&Jost.Schenck; &Jost.Schenck.mail;</author> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-09-01</date> -<releaseinfo ->3.1.00</releaseinfo> +<date>2002-09-01</date> +<releaseinfo>3.1.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->email</keyword> -<keyword ->e-mail</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>email</keyword> +<keyword>e-mail</keyword> </keywordset> </articleinfo> <sect1 id="e-mail"> -<title ->Email</title> +<title>Email</title> <sect2 id="email-intro"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->The email module of the &kcontrol; allows you to enter and save some basic email information. This information is used when performing functions related to email within &kde;, for example, when sending bug reports from the &kde; crash handler application.</para> +<para>The email module of the &kcontrol; allows you to enter and save some basic email information. This information is used when performing functions related to email within &kde;, for example, when sending bug reports from the &kde; crash handler application.</para> -<para ->Programs such as &kmail;, which are used for reading and sending email, may offer many more options for customising the way in which email is handled. These options depend upon the specific program being used. &kmail;, for instance, offers its own configuration facilities.</para> +<para>Programs such as &kmail;, which are used for reading and sending email, may offer many more options for customising the way in which email is handled. These options depend upon the specific program being used. &kmail;, for instance, offers its own configuration facilities.</para> -<para ->Some of the information needed for configuring email should have been provided by your internet service provider (<acronym ->ISP</acronym ->). If you are connected to a local network, then the system administrator of your network should be able to help you.</para> +<para>Some of the information needed for configuring email should have been provided by your internet service provider (<acronym>ISP</acronym>). If you are connected to a local network, then the system administrator of your network should be able to help you.</para> </sect2> <sect2 id="email-use"> -<title ->Use</title> +<title>Use</title> -<para ->&kde; automatically establishes some of the information for this control module using the login information on the system. You will need to enter the remaining information.</para> -<para ->Looking at the page from top to bottom, the options are:</para> +<para>&kde; automatically establishes some of the information for this control module using the login information on the system. You will need to enter the remaining information.</para> +<para>Looking at the page from top to bottom, the options are:</para> <variablelist> <varlistentry> -<term -><guilabel ->Full name</guilabel -></term> -<listitem -><para ->Type your full name as you would like it to appear in the email messages that you send. </para -></listitem> +<term><guilabel>Full name</guilabel></term> +<listitem><para>Type your full name as you would like it to appear in the email messages that you send. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Organisation</guilabel -></term> -<listitem -><para ->If you work for a company or organisation, you can enter its name in this text box.</para -></listitem> +<term><guilabel>Organisation</guilabel></term> +<listitem><para>If you work for a company or organisation, you can enter its name in this text box.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Email address</guilabel -></term> -<listitem -><para ->To be able to use email, you must enter your email address here.</para -></listitem> +<term><guilabel>Email address</guilabel></term> +<listitem><para>To be able to use email, you must enter your email address here.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Reply-to address</guilabel -></term> -<listitem -><para ->If replies to your email messages should be sent to a different address, you can enter that address in this text box.</para -></listitem> +<term><guilabel>Reply-to address</guilabel></term> +<listitem><para>If replies to your email messages should be sent to a different address, you can enter that address in this text box.</para></listitem> </varlistentry> </variablelist> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/energy/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/energy/index.docbook index 4814541ce14..c2bdd26c078 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/energy/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/energy/index.docbook @@ -2,134 +2,68 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->energy</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>energy</keyword> </keywordset> </articleinfo> <sect1 id="energy"> -<title ->Energy</title> +<title>Energy</title> <sect2 id="energy-intro"> -<title ->Introduction</title> - -<para ->This module is useful for any computer having a monitor labelled Energy Star Compliant. (Energy Star Compliant equipment is equipment that can be configured to automatically enter a power saving mode when appropriate, without human intervention.)</para> - -<tip -><para ->Energy Star Compliance can be applied to nearly any electrical device. This module, however, does not spin down hard drives, does not shutdown printers, &etc; These settings only affect the behaviour of your monitor.</para> - -<para ->For information on shutting down components on a laptop, do not use this module. Instead, install tdeutils, and refer to the module entitled <ulink url="help://kcontrol/powerctrl/index.html" ->Laptop Power Control Centre</ulink ->, for details.</para -></tip> - -<para ->In the case of computer monitors, the computer can control the monitor, switching it between four states: On, Standby, Suspend, and Off.</para> - -<note -><para ->The following list of states is a generalisation, and you may find that your monitor will differ from the descriptions below.</para -></note> - -<para -><quote ->ON</quote -> is the normal operation of your monitor while you are using it.</para> - -<para -><quote ->STANDBY</quote -> is usually a minor power saving level. This setting usually involves blanking the screen, and not firing the electron gun, but keeping the electron gun <quote ->energised</quote -> and ready to go. When you need to use the monitor again, the monitor will come back on very quickly.</para> - -<para -><quote ->SUSPEND</quote -> is a very low power mode alternative. With most monitors the screen is blanked, the electron gun is shut down and the magnets that control the electron gun are powered down. While the power saving is substantial, to reactivate the monitor may take up to 10-15 seconds. The computer should always be able to return the monitor to On or Standby while in suspend mode.</para> - -<para -><quote ->OFF</quote ->, usually means just that. The computer monitor is turned off. This usually means that the computer will not be able to turn the monitor back on by itself. Obviously, this keeps power consumption to a bare minimum (zero).</para> +<title>Introduction</title> + +<para>This module is useful for any computer having a monitor labelled Energy Star Compliant. (Energy Star Compliant equipment is equipment that can be configured to automatically enter a power saving mode when appropriate, without human intervention.)</para> + +<tip><para>Energy Star Compliance can be applied to nearly any electrical device. This module, however, does not spin down hard drives, does not shutdown printers, &etc; These settings only affect the behaviour of your monitor.</para> + +<para>For information on shutting down components on a laptop, do not use this module. Instead, install tdeutils, and refer to the module entitled <ulink url="help://kcontrol/powerctrl/index.html">Laptop Power Control Centre</ulink>, for details.</para></tip> + +<para>In the case of computer monitors, the computer can control the monitor, switching it between four states: On, Standby, Suspend, and Off.</para> + +<note><para>The following list of states is a generalisation, and you may find that your monitor will differ from the descriptions below.</para></note> + +<para><quote>ON</quote> is the normal operation of your monitor while you are using it.</para> + +<para><quote>STANDBY</quote> is usually a minor power saving level. This setting usually involves blanking the screen, and not firing the electron gun, but keeping the electron gun <quote>energised</quote> and ready to go. When you need to use the monitor again, the monitor will come back on very quickly.</para> + +<para><quote>SUSPEND</quote> is a very low power mode alternative. With most monitors the screen is blanked, the electron gun is shut down and the magnets that control the electron gun are powered down. While the power saving is substantial, to reactivate the monitor may take up to 10-15 seconds. The computer should always be able to return the monitor to On or Standby while in suspend mode.</para> + +<para><quote>OFF</quote>, usually means just that. The computer monitor is turned off. This usually means that the computer will not be able to turn the monitor back on by itself. Obviously, this keeps power consumption to a bare minimum (zero).</para> </sect2> <sect2 id="energy-use"> -<title ->Use</title> - -<para ->Using this module is very simple:</para> - -<para ->If your monitor is Energy Star Compliant, then you should put a mark in the check box labeled <guilabel ->Enable Display Energy Saving</guilabel ->. This will activate the energy saving commands. </para> - -<para ->The next three slider bars, tell the computer how many minutes of inactivity before automatically switching to a new state. These numbers can be adjusted with either the sliders, or the spin boxes.</para> - -<note -><para ->These times are not additive, but all start counting at zero.</para -> - -<para ->As an example:</para -> - -<para ->If you set the Standby Mode to 10 minutes, the Suspend mode to 20 minutes, and the Power off at 30 minutes, and you stop using your computer at 9:00, then the monitor will:</para -> <para ->Enter Standby mode at 9:10, enter Suspend mode at 9:20, and shut the power off at 9:30.</para -></note> - -<para ->When you are happy with the settings, click <guibutton ->OK</guibutton ->.</para> +<title>Use</title> + +<para>Using this module is very simple:</para> + +<para>If your monitor is Energy Star Compliant, then you should put a mark in the check box labeled <guilabel>Enable Display Energy Saving</guilabel>. This will activate the energy saving commands. </para> + +<para>The next three slider bars, tell the computer how many minutes of inactivity before automatically switching to a new state. These numbers can be adjusted with either the sliders, or the spin boxes.</para> + +<note><para>These times are not additive, but all start counting at zero.</para> + +<para>As an example:</para> + +<para>If you set the Standby Mode to 10 minutes, the Suspend mode to 20 minutes, and the Power off at 30 minutes, and you stop using your computer at 9:00, then the monitor will:</para> <para>Enter Standby mode at 9:10, enter Suspend mode at 9:20, and shut the power off at 9:30.</para></note> + +<para>When you are happy with the settings, click <guibutton>OK</guibutton>.</para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/filemanager/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/filemanager/index.docbook index 91d669d56e7..75f7680ea13 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/filemanager/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/filemanager/index.docbook @@ -2,374 +2,201 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-10-16</date> -<releaseinfo ->3.1</releaseinfo> +<date>2002-10-16</date> +<releaseinfo>3.1</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->file manager</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>file manager</keyword> </keywordset> </articleinfo> <sect1 id="file-manager"> -<title ->File Manager</title> +<title>File Manager</title> -<para ->In this module, you can configure various aspects of &konqueror;'s file manager functionality. </para> +<para>In this module, you can configure various aspects of &konqueror;'s file manager functionality. </para> -<note -><para ->&konqueror;'s web browser functionality has its <ulink url="help:/kcontrol/tdehtml/index.html" ->own configuration modules</ulink ->.</para -></note> +<note><para>&konqueror;'s web browser functionality has its <ulink url="help:/kcontrol/tdehtml/index.html">own configuration modules</ulink>.</para></note> <sect2 id="fileman-use"> -<title ->Use</title> +<title>Use</title> -<para ->The configuration options for the file manager are organised under tabs as follows:</para> +<para>The configuration options for the file manager are organised under tabs as follows:</para> <variablelist> <varlistentry> -<term -><guilabel ->Appearance</guilabel -></term> -<listitem -><para ->This tab contains options for customising the appearance of &konqueror; windows, such as the default font text colour.</para -></listitem> +<term><guilabel>Appearance</guilabel></term> +<listitem><para>This tab contains options for customising the appearance of &konqueror; windows, such as the default font text colour.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Behaviour</guilabel -></term> -<listitem -><para ->This tab contains a couple of &konqueror; global options.</para -></listitem> +<term><guilabel>Behaviour</guilabel></term> +<listitem><para>This tab contains a couple of &konqueror; global options.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Previews</guilabel -></term> +<term><guilabel>Previews</guilabel></term> <listitem> -<para ->On this tab, you can customise when &konqueror; should show previews.</para> +<para>On this tab, you can customise when &konqueror; should show previews.</para> </listitem> </varlistentry> </variablelist> <sect3 id="fileman-appearance"> -<title ->Appearance</title> +<title>Appearance</title> -<para ->The following settings determine how text and colours are displayed in &konqueror; File Manager mode windows.</para> +<para>The following settings determine how text and colours are displayed in &konqueror; File Manager mode windows.</para> <variablelist> <varlistentry> -<term -><guilabel ->Standard font:</guilabel -></term> +<term><guilabel>Standard font:</guilabel></term> <listitem> -<para ->This is the font used to display text such as file names in &konqueror; windows.</para> +<para>This is the font used to display text such as file names in &konqueror; windows.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Font size:</guilabel -></term> +<term><guilabel>Font size:</guilabel></term> <listitem> -<para ->Lets you control the size of text, while the <guilabel ->Standard Font</guilabel -> setting determines the font face used.</para> +<para>Lets you control the size of text, while the <guilabel>Standard Font</guilabel> setting determines the font face used.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Normal text colour:</guilabel -></term> +<term><guilabel>Normal text colour:</guilabel></term> <listitem> -<para ->Determines the standard text colour.</para> +<para>Determines the standard text colour.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Word-wrap icon text:</guilabel -></term> +<term><guilabel>Word-wrap icon text:</guilabel></term> <listitem> -<para ->When checked, long filenames will be wrapped onto multiple lines, rather than showing only the part of the filename that fits on a single line.</para> +<para>When checked, long filenames will be wrapped onto multiple lines, rather than showing only the part of the filename that fits on a single line.</para> -<tip -> <para ->If you uncheck this option, you can still see word-wrapped filenames by pausing the mouse pointer over the icon.</para -></tip> +<tip> <para>If you uncheck this option, you can still see word-wrapped filenames by pausing the mouse pointer over the icon.</para></tip> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Underline filenames:</guilabel -></term> +<term><guilabel>Underline filenames:</guilabel></term> <listitem> -<para ->When <guilabel ->Underline filenames</guilabel -> is checked, filenames will be underlined so that they look like links on a web page.</para> +<para>When <guilabel>Underline filenames</guilabel> is checked, filenames will be underlined so that they look like links on a web page.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Display file sizes in bytes:</guilabel -></term> +<term><guilabel>Display file sizes in bytes:</guilabel></term> <listitem> -<para ->The final check box on this page determines how &konqueror; displays file sizes, when you are in one of the file manager modes that normally shows this information. If you check the <guilabel ->Display file sizes in bytes</guilabel -> box then file sizes are always shown in bytes. If you leave it unchecked then file sizes are shown in bytes, kilobytes or megabytes, depending on their size.</para> +<para>The final check box on this page determines how &konqueror; displays file sizes, when you are in one of the file manager modes that normally shows this information. If you check the <guilabel>Display file sizes in bytes</guilabel> box then file sizes are always shown in bytes. If you leave it unchecked then file sizes are shown in bytes, kilobytes or megabytes, depending on their size.</para> </listitem> </varlistentry> </variablelist> </sect3> <sect3 id="fileman-behav"> -<title ->Behaviour</title> +<title>Behaviour</title> <variablelist> -<title -><guilabel ->Misc Options</guilabel -></title> +<title><guilabel>Misc Options</guilabel></title> <varlistentry> -<term ->Open folders in separate windows</term> -<listitem -> <para ->If this option is checked, a new &konqueror; window will be created when you open a folder, rather than simply showing that folder's contents in the current window.</para -></listitem> +<term>Open folders in separate windows</term> +<listitem> <para>If this option is checked, a new &konqueror; window will be created when you open a folder, rather than simply showing that folder's contents in the current window.</para></listitem> </varlistentry> <varlistentry> -<term ->Show network operations in a single window</term> +<term>Show network operations in a single window</term> <listitem> -<para ->If unchecked, and you download a file, a dialogue box will appear that shows the status of the download.</para> +<para>If unchecked, and you download a file, a dialogue box will appear that shows the status of the download.</para> <screenshot> - <screeninfo ->Download Dialogue Box</screeninfo> + <screeninfo>Download Dialogue Box</screeninfo> <mediaobject> - <imageobject -><imagedata fileref="tdefileman2.png" + <imageobject><imagedata fileref="tdefileman2.png" format="PNG"/></imageobject> - <textobject -> <phrase ->Download Dialogue Box</phrase -> </textobject> + <textobject> <phrase>Download Dialogue Box</phrase> </textobject> <caption> - <para ->Individual Download Dialogue Box</para> + <para>Individual Download Dialogue Box</para> </caption> </mediaobject> </screenshot> -<para ->If you start a new transfer, another dialogue box will appear. (&Netscape; users will be familiar with this behaviour) </para> +<para>If you start a new transfer, another dialogue box will appear. (&Netscape; users will be familiar with this behaviour) </para> -<para ->If checked, all transfer status windows will be grouped together under a single dialogue box.</para> +<para>If checked, all transfer status windows will be grouped together under a single dialogue box.</para> <screenshot> - <screeninfo ->Download Dialogue Box</screeninfo> + <screeninfo>Download Dialogue Box</screeninfo> <mediaobject> - <imageobject -><imagedata fileref="tdefileman1.png" + <imageobject><imagedata fileref="tdefileman1.png" format="PNG"/></imageobject> - <textobject -><phrase ->Download Dialogue Box</phrase -></textobject> + <textobject><phrase>Download Dialogue Box</phrase></textobject> <caption> - <para ->Collected Download Dialogue Box</para> + <para>Collected Download Dialogue Box</para> </caption> </mediaobject> </screenshot> -<para ->If you choose to use the Collected download dialogue box, you can delete transfers by clicking once on the transfer you want to cancel, then clicking the <guibutton ->Delete</guibutton -> Button on the left.</para> +<para>If you choose to use the Collected download dialogue box, you can delete transfers by clicking once on the transfer you want to cancel, then clicking the <guibutton>Delete</guibutton> Button on the left.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Show file tips</guilabel -></term> +<term><guilabel>Show file tips</guilabel></term> <listitem> -<para ->Here you can control if, when moving the mouse over a file, you want to see a small popup window with additional information about that file.</para> +<para>Here you can control if, when moving the mouse over a file, you want to see a small popup window with additional information about that file.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Show previews in file tips</guilabel -></term> +<term><guilabel>Show previews in file tips</guilabel></term> <listitem> -<para ->Here you can control if the file tip should show a thumbnail preview of the file. </para> +<para>Here you can control if the file tip should show a thumbnail preview of the file. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Home URL</guilabel -></term> -<listitem -><para ->This is the &URL; (⪚ a folder or a web page) where &konqueror; will jump to when the <guibutton ->Home</guibutton -> button is pressed.</para -><para ->The default is the users home folder, indicated with a <literal ->~</literal ->.</para -></listitem> +<term><guilabel>Home URL</guilabel></term> +<listitem><para>This is the &URL; (⪚ a folder or a web page) where &konqueror; will jump to when the <guibutton>Home</guibutton> button is pressed.</para><para>The default is the users home folder, indicated with a <literal>~</literal>.</para></listitem> </varlistentry> </variablelist> -<para ->You can set a path that is your <guilabel ->Home URL</guilabel -> by typing into the text field, or using the <guiicon ->browse</guiicon -> icon. The default is <literal ->~</literal -> which is a standard shortcut for your $<envar ->HOME</envar -> folder. When you choose the <guiicon ->home</guiicon -> icon on your panel, in a file open or save dialogue, or from within &konqueror; in file manager mode, this is the folder you will be shown.</para> - -<para ->The <guilabel ->Ask confirmation for</guilabel -> setting tells &konqueror; what to do when you choose to <quote ->Delete</quote ->, <quote ->Trash</quote ->, or <quote ->Shred</quote -> a file in a &konqueror; window. If any box is checked, &konqueror; asks for confirmation before performing the corresponding action.</para> +<para>You can set a path that is your <guilabel>Home URL</guilabel> by typing into the text field, or using the <guiicon>browse</guiicon> icon. The default is <literal>~</literal> which is a standard shortcut for your $<envar>HOME</envar> folder. When you choose the <guiicon>home</guiicon> icon on your panel, in a file open or save dialogue, or from within &konqueror; in file manager mode, this is the folder you will be shown.</para> + +<para>The <guilabel>Ask confirmation for</guilabel> setting tells &konqueror; what to do when you choose to <quote>Delete</quote>, <quote>Trash</quote>, or <quote>Shred</quote> a file in a &konqueror; window. If any box is checked, &konqueror; asks for confirmation before performing the corresponding action.</para> </sect3> <sect3> -<title ->Previews</title> - -<para ->&konqueror; has a preview feature for many file types, including <acronym ->HTML</acronym -> files, images, &PostScript; and <acronym ->PDF</acronym ->, sound, web archives (if you have the appropriate &konqueror; plugin installed) and text files.</para> - -<para ->If you enable previews for one of these, files of that particular file type will not be represented by standard icons in the filemanager, but will instead be shown as miniature previews. On slow computers, the previews can take some time to show up, so you might not want to enable this feature.</para> - -<para ->In this module you can specify which <quote ->protocols</quote -> you wish the previews to be available for. Creating the previews requires that &konqueror; download at least part of the file, in order to create the preview. &konqueror;, like the rest of &kde; is entirely network transparent, and will treat a remote &FTP; folder just as if it was on your local hard drive. This can result in a delay, especially if you are viewing, for example, a folder full of images over a slow network connection.</para> - -<para ->For each protocol, you can independently enable or disable previews. For example, you might enable previews for <acronym ->NFS</acronym -> mounted drives if you have a fast network, but disable them for &FTP; because your Internet connection is via a modem.</para> - -<para ->You can further refine the maximum size file that &konqueror; will attempt to show a preview for. The default is 1 MB. In other words, by default, if a file is 900 kb in size, and the protocol you are viewing the folder with is enabled, then &konqueror; will create a preview icon for it. If the file is 1.1 MB in size, &konqueror; will not make a preview, even if the protocol is enabled.</para> - -<para ->You can turn on and off previews <quote ->on the fly</quote -> from within &konqueror;, using the <guimenu ->View</guimenu -> menu. For example, if you normally want to see image previews on every protocol but find a particular server is very slow to send you the data, you might turn it off for the present, and turn it on again later.</para> - -<para ->You may also like to enable the checkbox <guilabel ->Increase size of previews relative to icons</guilabel ->, in order to see more information in the thumbnails.</para> - -<para ->Many image files already contain a thumbnail. You can enable the <guilabel ->Use thumbnails embedded in files</guilabel -> to make use of these. This will save time waiting for thumbnails to be created when viewing a folder full of images you have not previously seen in &konqueror;.</para> +<title>Previews</title> + +<para>&konqueror; has a preview feature for many file types, including <acronym>HTML</acronym> files, images, &PostScript; and <acronym>PDF</acronym>, sound, web archives (if you have the appropriate &konqueror; plugin installed) and text files.</para> + +<para>If you enable previews for one of these, files of that particular file type will not be represented by standard icons in the filemanager, but will instead be shown as miniature previews. On slow computers, the previews can take some time to show up, so you might not want to enable this feature.</para> + +<para>In this module you can specify which <quote>protocols</quote> you wish the previews to be available for. Creating the previews requires that &konqueror; download at least part of the file, in order to create the preview. &konqueror;, like the rest of &kde; is entirely network transparent, and will treat a remote &FTP; folder just as if it was on your local hard drive. This can result in a delay, especially if you are viewing, for example, a folder full of images over a slow network connection.</para> + +<para>For each protocol, you can independently enable or disable previews. For example, you might enable previews for <acronym>NFS</acronym> mounted drives if you have a fast network, but disable them for &FTP; because your Internet connection is via a modem.</para> + +<para>You can further refine the maximum size file that &konqueror; will attempt to show a preview for. The default is 1 MB. In other words, by default, if a file is 900 kb in size, and the protocol you are viewing the folder with is enabled, then &konqueror; will create a preview icon for it. If the file is 1.1 MB in size, &konqueror; will not make a preview, even if the protocol is enabled.</para> + +<para>You can turn on and off previews <quote>on the fly</quote> from within &konqueror;, using the <guimenu>View</guimenu> menu. For example, if you normally want to see image previews on every protocol but find a particular server is very slow to send you the data, you might turn it off for the present, and turn it on again later.</para> + +<para>You may also like to enable the checkbox <guilabel>Increase size of previews relative to icons</guilabel>, in order to see more information in the thumbnails.</para> + +<para>Many image files already contain a thumbnail. You can enable the <guilabel>Use thumbnails embedded in files</guilabel> to make use of these. This will save time waiting for thumbnails to be created when viewing a folder full of images you have not previously seen in &konqueror;.</para> </sect3> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/filetypes/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/filetypes/index.docbook index 700fdf00682..39a0fa18995 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/filetypes/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/filetypes/index.docbook @@ -2,270 +2,129 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> -<title ->File Associations</title> +<title>File Associations</title> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-13</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-13</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->files association</keyword> -<keyword ->association</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>files association</keyword> +<keyword>association</keyword> </keywordset> </articleinfo> <sect1 id="file-assoc"> -<title ->File Associations</title> +<title>File Associations</title> <sect2 id="file-assoc-intro"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->One of the most convenient aspects of &kde;, is its ability to automatically match a data file, with its application. As an example, when you click on your favourite &kword; document in &konqueror;, &kde; automatically starts &kword;, and automatically loads that file into &kword; so you can begin working on it.</para> +<para>One of the most convenient aspects of &kde;, is its ability to automatically match a data file, with its application. As an example, when you click on your favourite &kword; document in &konqueror;, &kde; automatically starts &kword;, and automatically loads that file into &kword; so you can begin working on it.</para> -<para ->In the example above, the &kword; Data file is <emphasis ->associated</emphasis -> with &kword; (the application). These file associations are crucial to the functioning of &kde;.</para> +<para>In the example above, the &kword; Data file is <emphasis>associated</emphasis> with &kword; (the application). These file associations are crucial to the functioning of &kde;.</para> -<para ->When &kde; is installed, it automatically creates hundreds of file associations to many of the most common data types. These initial associations are based on the most commonly included software, and the most common user preferences.</para> +<para>When &kde; is installed, it automatically creates hundreds of file associations to many of the most common data types. These initial associations are based on the most commonly included software, and the most common user preferences.</para> -<para ->Unfortunately, &kde; can not:</para> +<para>Unfortunately, &kde; can not:</para> <itemizedlist> -<listitem -><para ->predict every possible combination of software and data files</para -></listitem> -<listitem -><para ->prepare for file formats not yet invented</para -></listitem> -<listitem -><para ->or predict everyone's favourite application for certain file formats</para -></listitem> +<listitem><para>predict every possible combination of software and data files</para></listitem> +<listitem><para>prepare for file formats not yet invented</para></listitem> +<listitem><para>or predict everyone's favourite application for certain file formats</para></listitem> </itemizedlist> -<para ->You can change your current file associations or add new file associations using this module.</para> +<para>You can change your current file associations or add new file associations using this module.</para> -<para ->Each file association is recorded as a mime type. &MIME; stands for <quote ->Multipurpose Internet Mail Extensions</quote ->. It allows a computer to determine the type of file, without opening and analysing the format of each and every file.</para> +<para>Each file association is recorded as a mime type. &MIME; stands for <quote>Multipurpose Internet Mail Extensions</quote>. It allows a computer to determine the type of file, without opening and analysing the format of each and every file.</para> </sect2> <sect2 id="file-assoc-use"> -<title ->How to use this module</title> +<title>How to use this module</title> -<para ->The file associations are organised into several categories, and at a minimum you will have:</para> +<para>The file associations are organised into several categories, and at a minimum you will have:</para> <orderedlist> -<listitem -><para ->Application</para -></listitem> -<listitem -><para ->Audio</para -></listitem> -<listitem -><para ->Image</para -></listitem> -<listitem -><para ->Inode</para -></listitem> -<listitem -><para ->Message</para -></listitem> -<listitem -><para ->Multipart</para -></listitem> -<listitem -><para ->Print</para -></listitem> -<listitem -><para ->Text</para -></listitem> -<listitem -><para ->Video</para -></listitem> +<listitem><para>Application</para></listitem> +<listitem><para>Audio</para></listitem> +<listitem><para>Image</para></listitem> +<listitem><para>Inode</para></listitem> +<listitem><para>Message</para></listitem> +<listitem><para>Multipart</para></listitem> +<listitem><para>Print</para></listitem> +<listitem><para>Text</para></listitem> +<listitem><para>Video</para></listitem> </orderedlist> -<para ->All of the file associations are sorted into one of these categories.</para> +<para>All of the file associations are sorted into one of these categories.</para> -<para ->There is also an overview category <quote ->All</quote ->, which displays all the file types in one list, without categorising them.</para> +<para>There is also an overview category <quote>All</quote>, which displays all the file types in one list, without categorising them.</para> -<note -><para ->There is no functional difference between any of the categories. These categories are designed to help organise your file associations, but they do not alter the associations in any way. </para -></note> +<note><para>There is no functional difference between any of the categories. These categories are designed to help organise your file associations, but they do not alter the associations in any way. </para></note> -<para ->The categories are listed in the box labelled <guilabel ->Known Types</guilabel ->.</para> +<para>The categories are listed in the box labelled <guilabel>Known Types</guilabel>.</para> -<para ->You can explore each of these categories, and see the file associations contained within each one, by simply double-clicking on the category name. You will be presented with a list of the associated mime-types under that category.</para> +<para>You can explore each of these categories, and see the file associations contained within each one, by simply double-clicking on the category name. You will be presented with a list of the associated mime-types under that category.</para> -<tip -><para ->You can also search for a particular &MIME; type by using the search box. The search box is labelled <guilabel ->Find filename pattern</guilabel -> and is located above the category list.</para> +<tip><para>You can also search for a particular &MIME; type by using the search box. The search box is labelled <guilabel>Find filename pattern</guilabel> and is located above the category list.</para> -<para ->Simply type the first letter of the &MIME; type you are interested in. The categories are automatically expanded, and only the mime-types that include that letter are displayed.</para> +<para>Simply type the first letter of the &MIME; type you are interested in. The categories are automatically expanded, and only the mime-types that include that letter are displayed.</para> -<para ->You can then enter a second character and the mime-types will be further limited to mime types containing those two characters.</para -></tip> +<para>You can then enter a second character and the mime-types will be further limited to mime types containing those two characters.</para></tip> <sect3 id="file-assoc-use-add"> -<title ->Adding a new mime type</title> - -<para ->If you want to add a new &MIME; type to your file associations, you can click on the <guibutton ->Add...</guibutton -> button. A small dialogue box will appear. You select the category from the drop down box, and type the &MIME; name in the blank labelled <guilabel ->Type name</guilabel ->. Click <guibutton ->OK</guibutton -> to add the new mime type, or click <guibutton ->Cancel</guibutton -> to not add any new mime-types.</para> +<title>Adding a new mime type</title> + +<para>If you want to add a new &MIME; type to your file associations, you can click on the <guibutton>Add...</guibutton> button. A small dialogue box will appear. You select the category from the drop down box, and type the &MIME; name in the blank labelled <guilabel>Type name</guilabel>. Click <guibutton>OK</guibutton> to add the new mime type, or click <guibutton>Cancel</guibutton> to not add any new mime-types.</para> </sect3> <sect3 id="file-assoc-use-del"> -<title ->Removing a mime type</title> +<title>Removing a mime type</title> -<para ->If you want to remove a &MIME; type, simply select the &MIME; type you want to delete by clicking once with the mouse on the &MIME; type name. Then click the button labelled <guibutton ->Remove</guibutton ->. The &MIME; type will be deleted immediately.</para> +<para>If you want to remove a &MIME; type, simply select the &MIME; type you want to delete by clicking once with the mouse on the &MIME; type name. Then click the button labelled <guibutton>Remove</guibutton>. The &MIME; type will be deleted immediately.</para> </sect3> <sect3 id="file-assoc-use-edit"> -<title ->Editing a mime types properties</title> +<title>Editing a mime types properties</title> -<para ->Before you can edit a &MIME; types property, you must first specify which &MIME; type. Simply browse through the categories until you find the &MIME; type you want to edit, then click once on it with the mouse.</para> +<para>Before you can edit a &MIME; types property, you must first specify which &MIME; type. Simply browse through the categories until you find the &MIME; type you want to edit, then click once on it with the mouse.</para> -<para ->As soon as you have selected the &MIME; type, the current values of the &MIME; type will appear in the module window.</para> +<para>As soon as you have selected the &MIME; type, the current values of the &MIME; type will appear in the module window.</para> -<para ->You will notice the current values are split into two tabs: <guilabel ->General</guilabel -> and <guilabel ->Embedding</guilabel -></para> +<para>You will notice the current values are split into two tabs: <guilabel>General</guilabel> and <guilabel>Embedding</guilabel></para> <variablelist> <varlistentry> -<term -><guilabel ->General</guilabel -></term> +<term><guilabel>General</guilabel></term> <listitem> -<para ->There are 4 properties for each &MIME; type in this tab:</para> +<para>There are 4 properties for each &MIME; type in this tab:</para> <orderedlist> -<listitem -><para -><guilabel ->Mime Type Icon</guilabel -> is the icon that will be visible when using &konqueror; as a file manager.</para -></listitem> -<listitem -><para -><guilabel ->Filename Patterns</guilabel -> is a search pattern which &kde; will use to determine the &MIME; type.</para -></listitem> -<listitem -><para -><guilabel ->Description</guilabel -> is a short description of the file type. This is for your benefit only.</para -></listitem> -<listitem -><para -><guilabel ->Application Preference Order</guilabel -> determines which applications will be associated with the specified &MIME; type.</para -></listitem> +<listitem><para><guilabel>Mime Type Icon</guilabel> is the icon that will be visible when using &konqueror; as a file manager.</para></listitem> +<listitem><para><guilabel>Filename Patterns</guilabel> is a search pattern which &kde; will use to determine the &MIME; type.</para></listitem> +<listitem><para><guilabel>Description</guilabel> is a short description of the file type. This is for your benefit only.</para></listitem> +<listitem><para><guilabel>Application Preference Order</guilabel> determines which applications will be associated with the specified &MIME; type.</para></listitem> </orderedlist> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Embedding Tab</guilabel -></term> +<term><guilabel>Embedding Tab</guilabel></term> <listitem> -<para ->The Embedding tab allows you to determine if an file will be viewed within a &konqueror; window, or by starting the application.</para> +<para>The Embedding tab allows you to determine if an file will be viewed within a &konqueror; window, or by starting the application.</para> </listitem> </varlistentry> </variablelist> @@ -273,211 +132,83 @@ </sect3> <sect3 id="file-assoc-use-icon"> -<title ->Changing the Icon</title> +<title>Changing the Icon</title> -<para ->To change the icon, simply click on the Icon button. A dialogue box will appear, which will show you all available icons. Simply click once with the mouse on the icon of your choice, and click <guibutton ->OK</guibutton ->.</para> +<para>To change the icon, simply click on the Icon button. A dialogue box will appear, which will show you all available icons. Simply click once with the mouse on the icon of your choice, and click <guibutton>OK</guibutton>.</para> </sect3> <sect3 id="file-assoc-use-pattern"> -<title ->Editing the mime-type patterns</title> - -<para ->The box labelled <guilabel ->Filename Patterns</guilabel ->, determines what files will be included within this mime-type.</para> - -<para ->Usually, files are selected based on their suffix. (Examples: Files that end with <literal role="extension" ->.wav</literal -> are sound files, using the WAV format and files that end in <literal role="extension" ->.c</literal -> are program files written in C).</para> - -<para ->You should enter your filename mask in this combo box.</para> - -<para ->The asterisk (<literal ->*</literal ->) is a wildcard character that will be used with nearly every mime type mask. A complete discussion of wildcards is beyond the scope of this manual, but it is important to understand that the asterisk (in this context), <quote ->matches</quote -> any number of characters. As an example: <userinput ->*.pdf</userinput -> will match <filename ->Datafile.pdf</filename ->, <filename ->Graphics.pdf</filename -> and <filename ->User.pdf</filename ->, but not <filename ->PDF</filename ->, <filename ->Datafile.PDF</filename ->, or <filename ->.pdf</filename ->.</para> - -<tip -><para ->It is very beneficial to have multiple masks. One for lower case, one for upper case, &etc; This will help ensure that &kde; can determine the file type more accurately.</para -></tip> +<title>Editing the mime-type patterns</title> + +<para>The box labelled <guilabel>Filename Patterns</guilabel>, determines what files will be included within this mime-type.</para> + +<para>Usually, files are selected based on their suffix. (Examples: Files that end with <literal role="extension">.wav</literal> are sound files, using the WAV format and files that end in <literal role="extension">.c</literal> are program files written in C).</para> + +<para>You should enter your filename mask in this combo box.</para> + +<para>The asterisk (<literal>*</literal>) is a wildcard character that will be used with nearly every mime type mask. A complete discussion of wildcards is beyond the scope of this manual, but it is important to understand that the asterisk (in this context), <quote>matches</quote> any number of characters. As an example: <userinput>*.pdf</userinput> will match <filename>Datafile.pdf</filename>, <filename>Graphics.pdf</filename> and <filename>User.pdf</filename>, but not <filename>PDF</filename>, <filename>Datafile.PDF</filename>, or <filename>.pdf</filename>.</para> + +<tip><para>It is very beneficial to have multiple masks. One for lower case, one for upper case, &etc; This will help ensure that &kde; can determine the file type more accurately.</para></tip> </sect3> <sect3 id="file-assoc-use-desc"> -<title ->Editing a mime types description.</title> +<title>Editing a mime types description.</title> -<para ->You can type a short description of the &MIME; type in the text box labelled <guilabel ->Description</guilabel ->. This label is to help you, it does not affect the function of the &MIME; type.</para> +<para>You can type a short description of the &MIME; type in the text box labelled <guilabel>Description</guilabel>. This label is to help you, it does not affect the function of the &MIME; type.</para> </sect3> <sect3 id="file-assoc-use-app"> -<title ->Editing the application associations</title> - -<para ->There are four buttons (<guibutton ->Move Up</guibutton ->, <guibutton ->Move Down</guibutton ->, <guibutton ->Add</guibutton -> and <guibutton ->Remove</guibutton ->) and a combo box (which lists the applications) which are used to configure the applications.</para> - -<para ->The combo box lists all of the applications associated with a specific &MIME; type. The list is in a specific order. The top application is the first application tried. The next application down the list is the second, etc.</para> - -<note -><para ->What do you mean there is more than one application per &MIME; type? Why is this necessary?</para> - -<para ->We started out by saying that &kde; comes preconfigured with hundreds of file associations. The reality is, each system that &kde; is installed on has a different selection of applications. By allowing multiple associations per &MIME; type, &kde; can continue to operate when a certain application is not installed on the system.</para> - -<para ->As an example:</para> -<para ->For the &MIME; type <literal ->pdf</literal ->, there are two applications associated with this file type. The first program is called <application ->PS Viewer</application ->. If your system does not have <application ->PS Viewer</application -> installed, then &kde; automatically starts the second application <application ->Adobe Acrobat Reader</application ->. As you can see, this will help keep &kde; running strong as you add and subtract applications.</para -></note> - -<para ->We have established that the order is important. You can change the order of the applications by clicking once with the mouse on the application you want to move, and then clicking either <guibutton ->Move Up</guibutton -> or <guibutton ->Move Down</guibutton ->. This will shift the currently selected application up or down the list of applications. </para> - -<para ->You can add new applications to the list by clicking the button labelled <guibutton ->Add</guibutton ->. A dialogue box will appear. Using the dialogue box, you can select the application you want to use for this mime type. Click <guibutton ->OK</guibutton -> when you are done, and the application will be added to the current list.</para> - -<para ->You can remove an application (thereby ensuring that the application will never run with this &MIME; type by clicking once on the name of the application, and clicking the <guibutton ->Remove</guibutton -> button.</para> - -<tip -><para ->It is a good idea to use the <guibutton ->Move Up</guibutton -> and <guibutton ->Move Down</guibutton -> buttons to adjust the unwanted application to a lower position in the list, rather than deleting the application from the list entirely. Once you have deleted an application, if your preferred application should become compromised, there will not be an application to view the data document.</para -></tip> +<title>Editing the application associations</title> + +<para>There are four buttons (<guibutton>Move Up</guibutton>, <guibutton>Move Down</guibutton>, <guibutton>Add</guibutton> and <guibutton>Remove</guibutton>) and a combo box (which lists the applications) which are used to configure the applications.</para> + +<para>The combo box lists all of the applications associated with a specific &MIME; type. The list is in a specific order. The top application is the first application tried. The next application down the list is the second, etc.</para> + +<note><para>What do you mean there is more than one application per &MIME; type? Why is this necessary?</para> + +<para>We started out by saying that &kde; comes preconfigured with hundreds of file associations. The reality is, each system that &kde; is installed on has a different selection of applications. By allowing multiple associations per &MIME; type, &kde; can continue to operate when a certain application is not installed on the system.</para> + +<para>As an example:</para> +<para>For the &MIME; type <literal>pdf</literal>, there are two applications associated with this file type. The first program is called <application>PS Viewer</application>. If your system does not have <application>PS Viewer</application> installed, then &kde; automatically starts the second application <application>Adobe Acrobat Reader</application>. As you can see, this will help keep &kde; running strong as you add and subtract applications.</para></note> + +<para>We have established that the order is important. You can change the order of the applications by clicking once with the mouse on the application you want to move, and then clicking either <guibutton>Move Up</guibutton> or <guibutton>Move Down</guibutton>. This will shift the currently selected application up or down the list of applications. </para> + +<para>You can add new applications to the list by clicking the button labelled <guibutton>Add</guibutton>. A dialogue box will appear. Using the dialogue box, you can select the application you want to use for this mime type. Click <guibutton>OK</guibutton> when you are done, and the application will be added to the current list.</para> + +<para>You can remove an application (thereby ensuring that the application will never run with this &MIME; type by clicking once on the name of the application, and clicking the <guibutton>Remove</guibutton> button.</para> + +<tip><para>It is a good idea to use the <guibutton>Move Up</guibutton> and <guibutton>Move Down</guibutton> buttons to adjust the unwanted application to a lower position in the list, rather than deleting the application from the list entirely. Once you have deleted an application, if your preferred application should become compromised, there will not be an application to view the data document.</para></tip> </sect3> <sect3 id="file-assoc-embedding"> -<title ->Embedding</title> -<para ->By clicking on the <guilabel ->Embedding</guilabel -> tab, you are presented with three radio buttons in the <guilabel ->Left click action</guilabel -> group. These determine how &konqueror; views the selected &MIME; type:</para> +<title>Embedding</title> +<para>By clicking on the <guilabel>Embedding</guilabel> tab, you are presented with three radio buttons in the <guilabel>Left click action</guilabel> group. These determine how &konqueror; views the selected &MIME; type:</para> <variablelist> -<varlistentry -><term ->Show file in embedded viewer</term> -<listitem -><para ->If this is selected, the file will be shown <emphasis ->within</emphasis -> the &konqueror; window.</para -></listitem -></varlistentry> -<varlistentry -><term ->Show file in separate viewer</term> -<listitem -><para ->This will cause a separate window to be created when showing this mime-type.</para -></listitem -></varlistentry> -<varlistentry -><term ->Use group settings.</term> -<listitem -><para ->This will cause the mime-type to use the settings for the mime-type group. (if you are editing an audio mime type, then the settings for the audio group are used).</para -></listitem -></varlistentry> +<varlistentry><term>Show file in embedded viewer</term> +<listitem><para>If this is selected, the file will be shown <emphasis>within</emphasis> the &konqueror; window.</para></listitem></varlistentry> +<varlistentry><term>Show file in separate viewer</term> +<listitem><para>This will cause a separate window to be created when showing this mime-type.</para></listitem></varlistentry> +<varlistentry><term>Use group settings.</term> +<listitem><para>This will cause the mime-type to use the settings for the mime-type group. (if you are editing an audio mime type, then the settings for the audio group are used).</para></listitem></varlistentry> </variablelist> -<para ->Below this is a listbox labelled <guilabel ->Services Preference Order</guilabel ->.</para> - -<para ->When you are in &konqueror;, you can <mousebutton ->right</mousebutton -> mouse click, and a menu will with an entry labelled <guimenu ->Preview with...</guimenu -> will appear. This box lists the applications that will appear, in the order they will appear, under this menu.</para> - -<para ->You can use the <guibutton ->Move Up</guibutton -> and <guibutton ->Move Down</guibutton -> buttons to change the order.</para> +<para>Below this is a listbox labelled <guilabel>Services Preference Order</guilabel>.</para> + +<para>When you are in &konqueror;, you can <mousebutton>right</mousebutton> mouse click, and a menu will with an entry labelled <guimenu>Preview with...</guimenu> will appear. This box lists the applications that will appear, in the order they will appear, under this menu.</para> + +<para>You can use the <guibutton>Move Up</guibutton> and <guibutton>Move Down</guibutton> buttons to change the order.</para> </sect3> <sect3 id="file-assoc-use-done"> -<title ->Making changes permanent</title> +<title>Making changes permanent</title> -<para ->When you are done making any changes to mime types, you can click <guibutton ->Apply</guibutton -> to make your changes permanent, but keep you in this module.</para> +<para>When you are done making any changes to mime types, you can click <guibutton>Apply</guibutton> to make your changes permanent, but keep you in this module.</para> </sect3> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/fonts/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/fonts/index.docbook index a379b8d94a2..ac3b120830d 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/fonts/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/fonts/index.docbook @@ -2,171 +2,74 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-09-22</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-09-22</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->fonts</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>fonts</keyword> </keywordset> </articleinfo> <sect1 id="fonts"> -<title ->Fonts</title> +<title>Fonts</title> -<para ->This module is designed to allow you to easily select different fonts for different parts of the &kde; Desktop.</para> +<para>This module is designed to allow you to easily select different fonts for different parts of the &kde; Desktop.</para> -<para ->The panel consists of different font groups to give you a lot of flexibility in configuring your fonts: </para> +<para>The panel consists of different font groups to give you a lot of flexibility in configuring your fonts: </para> <itemizedlist> -<listitem -><para -><guilabel ->General:</guilabel -> Used everywhere the other font groups do not apply</para -></listitem> - -<listitem -><para -><guilabel ->Fixed width:</guilabel -> Anywhere a non-proportional font is specified</para -></listitem> - -<!-- <listitem -><para -><guilabel ->File Manager</guilabel -> (Font to use in the -&kde; file manager)</para -></listitem -> --> - -<listitem -><para -><guilabel ->Toolbar:</guilabel -> Font used in &kde; application toolbars</para -></listitem> - -<listitem -><para -><guilabel ->Menu:</guilabel -> Font used in &kde; application menus</para -></listitem> - -<listitem -><para -><guilabel ->Window title:</guilabel -> Font used in the window title</para -></listitem> - -<listitem -><para -><guilabel ->Taskbar:</guilabel -> Font used in the taskbar panel applet</para -></listitem> - -<listitem -><para -><guilabel ->Desktop:</guilabel -> Font used on the desktop to label icons</para -></listitem> +<listitem><para><guilabel>General:</guilabel> Used everywhere the other font groups do not apply</para></listitem> + +<listitem><para><guilabel>Fixed width:</guilabel> Anywhere a non-proportional font is specified</para></listitem> + +<!-- <listitem><para><guilabel>File Manager</guilabel> (Font to use in the +&kde; file manager)</para></listitem> --> + +<listitem><para><guilabel>Toolbar:</guilabel> Font used in &kde; application toolbars</para></listitem> + +<listitem><para><guilabel>Menu:</guilabel> Font used in &kde; application menus</para></listitem> + +<listitem><para><guilabel>Window title:</guilabel> Font used in the window title</para></listitem> + +<listitem><para><guilabel>Taskbar:</guilabel> Font used in the taskbar panel applet</para></listitem> + +<listitem><para><guilabel>Desktop:</guilabel> Font used on the desktop to label icons</para></listitem> </itemizedlist> -<para ->Each font has a corresponding <guibutton ->Choose...</guibutton -> button. By clicking on this button, a dialogue box appears. You can use this dialogue box to choose a new font, font style, size and character set. Then press <guibutton ->OK</guibutton ->.</para> - -<para ->An example of the font you have chosen will be displayed in the space between the font group name and the choose button.</para> - -<para ->When you are done, simply click <guibutton ->OK</guibutton ->, and all necessary components of &kde; will be restarted so your changes can take affect immediately.</para> - -<para ->The <guibutton ->Adjust All Fonts...</guibutton -> button allows you to quickly set properties for all the fonts selected above. A font selection dialogue similar to the standard one will appear, but you will notice checkboxes that allow you to change the <guilabel ->Font</guilabel ->, <guilabel ->Font style</guilabel -> or <guilabel ->Size</guilabel -> independently of each other. You can choose any one, two, or three of these options, and they will be applied to all the font groups.</para> - -<para ->For example, if you have selected several different font faces above, and realise they are all a size too big (this often happens when you change screen resolution, for instance), you can apply a new font size to all the fonts, without affecting your customised font faces and styles.</para> +<para>Each font has a corresponding <guibutton>Choose...</guibutton> button. By clicking on this button, a dialogue box appears. You can use this dialogue box to choose a new font, font style, size and character set. Then press <guibutton>OK</guibutton>.</para> + +<para>An example of the font you have chosen will be displayed in the space between the font group name and the choose button.</para> + +<para>When you are done, simply click <guibutton>OK</guibutton>, and all necessary components of &kde; will be restarted so your changes can take affect immediately.</para> + +<para>The <guibutton>Adjust All Fonts...</guibutton> button allows you to quickly set properties for all the fonts selected above. A font selection dialogue similar to the standard one will appear, but you will notice checkboxes that allow you to change the <guilabel>Font</guilabel>, <guilabel>Font style</guilabel> or <guilabel>Size</guilabel> independently of each other. You can choose any one, two, or three of these options, and they will be applied to all the font groups.</para> + +<para>For example, if you have selected several different font faces above, and realise they are all a size too big (this often happens when you change screen resolution, for instance), you can apply a new font size to all the fonts, without affecting your customised font faces and styles.</para> <sect2 id="fonts-aa"> -<title ->Anti-alias text</title> - -<para ->To use anti-aliasing, simply place a mark in the checkbox labelled <guilabel ->Use anti-aliasing for fonts</guilabel ->. This enables two more options.</para> -<para ->Placing a mark in the checkbox will allow you to specify which range of fonts will <emphasis ->not</emphasis -> be anti-aliased. This range is specified with the two combo boxes on the same line.</para> - -<para ->You can also choose the method that &kde; uses to create an anti-alias look to your fonts. If you are not familiar with the individual methods, you should leave this option alone.</para> - -<note -><para ->The ability to use anti-aliased fonts and icons requires that you have support in both X and the &Qt; toolkit, that you have suitable fonts installed, and that you are using the built-in font serving capabilities of the X server. If you still are having problems, please contact the appropriate &kde; mailing list, or check the <acronym ->FAQ</acronym ->.</para -></note> +<title>Anti-alias text</title> + +<para>To use anti-aliasing, simply place a mark in the checkbox labelled <guilabel>Use anti-aliasing for fonts</guilabel>. This enables two more options.</para> +<para>Placing a mark in the checkbox will allow you to specify which range of fonts will <emphasis>not</emphasis> be anti-aliased. This range is specified with the two combo boxes on the same line.</para> + +<para>You can also choose the method that &kde; uses to create an anti-alias look to your fonts. If you are not familiar with the individual methods, you should leave this option alone.</para> + +<note><para>The ability to use anti-aliased fonts and icons requires that you have support in both X and the &Qt; toolkit, that you have suitable fonts installed, and that you are using the built-in font serving capabilities of the X server. If you still are having problems, please contact the appropriate &kde; mailing list, or check the <acronym>FAQ</acronym>.</para></note> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/helpindex/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/helpindex/index.docbook index d9a4ee29875..62a141f1118 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/helpindex/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/helpindex/index.docbook @@ -2,214 +2,83 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<author ->&Jost.Schenck; &Jost.Schenck.mail;</author> - -<othercredit role="translator" -><firstname ->Jonathan</firstname -><surname ->Riddell</surname -><affiliation -><address -><email ->kde-en-gb@jriddell.org</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<author>&Jost.Schenck; &Jost.Schenck.mail;</author> + +<othercredit role="translator"><firstname>Jonathan</firstname><surname>Riddell</surname><affiliation><address><email>kde-en-gb@jriddell.org</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-10-17</date> -<releaseinfo ->3.1</releaseinfo> +<date>2002-10-17</date> +<releaseinfo>3.1</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->Help Index</keyword> -<keyword ->Index</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>Help Index</keyword> +<keyword>Index</keyword> </keywordset> </articleinfo> <sect1 id="help-index"> -<title ->Help Index</title> - -<note -><para ->At the time of writing, for most installations of &kde; the entire search engine function in &khelpcenter; is disabled, and settings made in this &kcontrol; module will have no effect. We hope to have it back in a future release.</para -></note> - -<para ->&kde; comes with a lot of documentation for applications and components. While it is possible to just browse the manuals until you find that piece of information you're looking for, this may be a very time-consuming task. To make this easier for you, &kde; offers fulltext search using a program called <application ->ht://dig</application ->. It works quite similar to search engines on the web, in fact some search engines you now might even use it. Just click on the <guilabel ->Search</guilabel -> tab in the &khelpcenter;, enter the word you are looking for, click <guibutton ->Search</guibutton -> and enjoy!</para> - -<para ->However, to make use of this feature, <application ->ht://dig</application -> has to be installed on your system and &kde; has to be configured to make us of it. This control module tries to help you doing the latter. If you haven't installed <application ->ht://dig</application -> and it wasn't shipped with your operating system you have to get ht://dig yourself. Have a look at <ulink url="http://www.htdig.org" ->the ht://dig homepage</ulink -> on how to download and install it.</para> - -<para ->When you first start, you are in display mode only. To modify your settings, click on <guibutton ->Administrator Mode</guibutton ->. If you are logged in as <systemitem class="username" ->root</systemitem ->, you will go straight to the change dialogue. If not, &kde; will ask for a superuser password.</para> -<sect2 id="help-index-use" -> - -<title ->Use</title -> - -<para ->There are two important things to tell &kde; so it can make use of the fulltext search engine:</para> +<title>Help Index</title> + +<note><para>At the time of writing, for most installations of &kde; the entire search engine function in &khelpcenter; is disabled, and settings made in this &kcontrol; module will have no effect. We hope to have it back in a future release.</para></note> + +<para>&kde; comes with a lot of documentation for applications and components. While it is possible to just browse the manuals until you find that piece of information you're looking for, this may be a very time-consuming task. To make this easier for you, &kde; offers fulltext search using a program called <application>ht://dig</application>. It works quite similar to search engines on the web, in fact some search engines you now might even use it. Just click on the <guilabel>Search</guilabel> tab in the &khelpcenter;, enter the word you are looking for, click <guibutton>Search</guibutton> and enjoy!</para> + +<para>However, to make use of this feature, <application>ht://dig</application> has to be installed on your system and &kde; has to be configured to make us of it. This control module tries to help you doing the latter. If you haven't installed <application>ht://dig</application> and it wasn't shipped with your operating system you have to get ht://dig yourself. Have a look at <ulink url="http://www.htdig.org">the ht://dig homepage</ulink> on how to download and install it.</para> + +<para>When you first start, you are in display mode only. To modify your settings, click on <guibutton>Administrator Mode</guibutton>. If you are logged in as <systemitem class="username">root</systemitem>, you will go straight to the change dialogue. If not, &kde; will ask for a superuser password.</para> +<sect2 id="help-index-use"> + +<title>Use</title> + +<para>There are two important things to tell &kde; so it can make use of the fulltext search engine:</para> <itemizedlist> -<listitem -><para ->where to find the <application ->ht://dig</application -> programs KDE uses for fulltext search</para -></listitem> -<listitem -><para ->where to search</para -></listitem> +<listitem><para>where to find the <application>ht://dig</application> programs KDE uses for fulltext search</para></listitem> +<listitem><para>where to search</para></listitem> </itemizedlist> <sect3 id="help-index-use-progs"> -<title ->The <application ->ht://dig</application -> Programs</title> - -<para ->There are three programs &kde; needs that come with <application ->ht://dig</application ->: <command ->htdig</command ->, <command ->htsearch</command -> and <command ->htmerge</command ->. For each program you have to provide the full path including the program name, for example: <filename class="directory" ->/usr/bin/htdig</filename ->.</para -> - -<para ->Where exactly these programs are installed depends on your operating system or your distribution. However, there are some good guesses you might want to try:</para> +<title>The <application>ht://dig</application> Programs</title> + +<para>There are three programs &kde; needs that come with <application>ht://dig</application>: <command>htdig</command>, <command>htsearch</command> and <command>htmerge</command>. For each program you have to provide the full path including the program name, for example: <filename class="directory">/usr/bin/htdig</filename>.</para> + +<para>Where exactly these programs are installed depends on your operating system or your distribution. However, there are some good guesses you might want to try:</para> <itemizedlist> -<listitem -><para -><command ->htdig</command -> and <command ->htmerge</command -> are often found in <filename class="directory" ->/usr/bin/</filename -> or in something like <filename class="directory" ->/usr/local/www/htdig/bin/</filename ->.</para -></listitem> - -<listitem -><para ->the <command ->htsearch</command -> command is often found in a sub folder called <filename class="directory" ->cgi-bin</filename ->, for example <filename class="directory" ->/usr/local/httpd/cgi-bin/</filename ->.</para> +<listitem><para><command>htdig</command> and <command>htmerge</command> are often found in <filename class="directory">/usr/bin/</filename> or in something like <filename class="directory">/usr/local/www/htdig/bin/</filename>.</para></listitem> + +<listitem><para>the <command>htsearch</command> command is often found in a sub folder called <filename class="directory">cgi-bin</filename>, for example <filename class="directory">/usr/local/httpd/cgi-bin/</filename>.</para> </listitem> </itemizedlist> -<tip -><para ->To find out where for example <command ->htdig</command -> is installed you can always type <command ->whereis htdig</command -> on the console. <command ->whereis</command -> will look for the specified command in the standard execution path folders. However, folders like <filename class="directory" ->cgi-bin</filename -> are often not in the standard execution path.</para -></tip> +<tip><para>To find out where for example <command>htdig</command> is installed you can always type <command>whereis htdig</command> on the console. <command>whereis</command> will look for the specified command in the standard execution path folders. However, folders like <filename class="directory">cgi-bin</filename> are often not in the standard execution path.</para></tip> </sect3> <sect3 id="help-index-use-scope"> -<title ->Scope and Search Paths</title> - -<para ->In this section you can choose which help resources should be indexed, &ie; made available to the search engine.</para> - -<para ->In the <guilabel ->Scope</guilabel -> frame you can select some typical resources you want to be indexed, &ie; the &kde; help files, and the information offered by the <command ->man</command -> and <command ->info</command -> commands. Note that some of those may still be disabled, which means that support for them has not been added yet.</para> - -<para ->Maybe you have additional files you want to access using the &khelpcenter; fulltext search feature. For example, you might have an <acronym ->HTML</acronym -> reference installed in <filename ->/home/jdoe/docs/selfhtml</filename ->. By adding this path to the list of additional search paths you make this documentation available to &khelpcenter;'s fulltext search, too. Just click on the <guibutton ->Add</guibutton -> button and a file dialogue will ask you for an additional search folder. Select <filename class="directory" ->/home/jdoe/docs/selfhtml</filename -> and click <guibutton ->OK</guibutton ->. To remove an additional search path, just select it and click <guibutton ->Delete</guibutton ->.</para> - -<important -><para ->Your changes to the scope and additional search paths will not take effect if you don't click on the <guibutton ->Build index</guibutton -> button.</para -></important> +<title>Scope and Search Paths</title> + +<para>In this section you can choose which help resources should be indexed, &ie; made available to the search engine.</para> + +<para>In the <guilabel>Scope</guilabel> frame you can select some typical resources you want to be indexed, &ie; the &kde; help files, and the information offered by the <command>man</command> and <command>info</command> commands. Note that some of those may still be disabled, which means that support for them has not been added yet.</para> + +<para>Maybe you have additional files you want to access using the &khelpcenter; fulltext search feature. For example, you might have an <acronym>HTML</acronym> reference installed in <filename>/home/jdoe/docs/selfhtml</filename>. By adding this path to the list of additional search paths you make this documentation available to &khelpcenter;'s fulltext search, too. Just click on the <guibutton>Add</guibutton> button and a file dialogue will ask you for an additional search folder. Select <filename class="directory">/home/jdoe/docs/selfhtml</filename> and click <guibutton>OK</guibutton>. To remove an additional search path, just select it and click <guibutton>Delete</guibutton>.</para> + +<important><para>Your changes to the scope and additional search paths will not take effect if you don't click on the <guibutton>Build index</guibutton> button.</para></important> </sect3> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/icons/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/icons/index.docbook index eb875630a9e..058866d77f6 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/icons/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/icons/index.docbook @@ -2,305 +2,137 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<author ->&Jost.Schenck; &Jost.Schenck.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<author>&Jost.Schenck; &Jost.Schenck.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-09-22</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-09-22</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->icon</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>icon</keyword> </keywordset> </articleinfo> <sect1 id="icons"> -<title ->Icons</title> +<title>Icons</title> <sect2 id="icons-intro"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->&kde; comes with a full set of icons in several sizes. These icons are being used all over &kde;: the desktop, the panel, the &konqueror; file manager, in every toolbar of every &kde; application, etc. The icons control module offers you very flexible ways of customising the way &kde; handles icons. You can:</para> +<para>&kde; comes with a full set of icons in several sizes. These icons are being used all over &kde;: the desktop, the panel, the &konqueror; file manager, in every toolbar of every &kde; application, etc. The icons control module offers you very flexible ways of customising the way &kde; handles icons. You can:</para> <itemizedlist> -<listitem -><para ->install and choose icon themes</para -></listitem> -<listitem -><para ->choose different icon sizes</para -></listitem> -<listitem -><para ->assign effects to icons (for example make them semi-transparent or colourise them) </para -></listitem> -<listitem -><para ->configure these settings for each of the different places icons will be used in: for example the desktop, toolbars &etc; </para -></listitem> +<listitem><para>install and choose icon themes</para></listitem> +<listitem><para>choose different icon sizes</para></listitem> +<listitem><para>assign effects to icons (for example make them semi-transparent or colourise them) </para></listitem> +<listitem><para>configure these settings for each of the different places icons will be used in: for example the desktop, toolbars &etc; </para></listitem> </itemizedlist> -<important -><para ->Please note that some of these settings may depend on your selected icon theme. &kde; comes with two icon themes by default, &kde;-Classic (HiColour) and Crystal SVG. There is also a low colour theme in the tdeartwork package, along with others.</para -></important> +<important><para>Please note that some of these settings may depend on your selected icon theme. &kde; comes with two icon themes by default, &kde;-Classic (HiColour) and Crystal SVG. There is also a low colour theme in the tdeartwork package, along with others.</para></important> </sect2> <sect2 id="icon-theme"> -<title -><guilabel ->Theme</guilabel -></title> +<title><guilabel>Theme</guilabel></title> -<para ->Starting at the top, you can see some example icons. These change in appearance depending on the icon theme you select. Most default installations will have only one icon theme available, the &kde; default Crystal SVG theme. There are others contained separately in the tdeartwork package, and you can download more from the Internet.</para> +<para>Starting at the top, you can see some example icons. These change in appearance depending on the icon theme you select. Most default installations will have only one icon theme available, the &kde; default Crystal SVG theme. There are others contained separately in the tdeartwork package, and you can download more from the Internet.</para> -<para ->Use the <guibutton ->Install New Theme...</guibutton -> to browse to the location of newly downloaded themes, and they will then become available to select from above.</para> +<para>Use the <guibutton>Install New Theme...</guibutton> to browse to the location of newly downloaded themes, and they will then become available to select from above.</para> </sect2> <sect2 id="icons-use"> -<title ->Advanced</title> - -<para ->Looking at this second page of the icons control module, you will see two areas:</para> - -<itemizedlist -> -<listitem -> -<para ->An area labelled <guilabel ->Use of Icon</guilabel ->. Here you can choose which particular usage of icons you want to configure, for example <guilabel ->Toolbar</guilabel -> or <guilabel ->Panel</guilabel ->.</para -> -</listitem -> - -<listitem -> <para ->A preview area where you can see how icons of the selected kind will look using the current settings. Note that the state of this preview also depends on the icon state selected in the effects below (do not worry about that now, we will explain that below). </para -> </listitem> +<title>Advanced</title> + +<para>Looking at this second page of the icons control module, you will see two areas:</para> + +<itemizedlist> +<listitem> +<para>An area labelled <guilabel>Use of Icon</guilabel>. Here you can choose which particular usage of icons you want to configure, for example <guilabel>Toolbar</guilabel> or <guilabel>Panel</guilabel>.</para> +</listitem> + +<listitem> <para>A preview area where you can see how icons of the selected kind will look using the current settings. Note that the state of this preview also depends on the icon state selected in the effects below (do not worry about that now, we will explain that below). </para> </listitem> </itemizedlist> -<para ->When you want to configure icons, first select the usage of icons you want to configure. Change the settings until you like the preview. You can then choose a different icon usage and configure that. At the end, if you are satisfied with your settings, click <guibutton ->OK</guibutton -> or <guibutton ->Apply</guibutton -> to take the changes in effect.</para> +<para>When you want to configure icons, first select the usage of icons you want to configure. Change the settings until you like the preview. You can then choose a different icon usage and configure that. At the end, if you are satisfied with your settings, click <guibutton>OK</guibutton> or <guibutton>Apply</guibutton> to take the changes in effect.</para> -<para ->There are two further options to consider, <guilabel ->Size</guilabel -> and <guilabel ->Effects</guilabel ->. </para> +<para>There are two further options to consider, <guilabel>Size</guilabel> and <guilabel>Effects</guilabel>. </para> <sect3 id="icons-use-size"> -<title ->Icon Size</title> - -<para ->You have two options relating to icon sizes. First, you can choose from a list of icon sizes. Second, you can tell &kde; to draw all pixels using double sized pixels. The largest icon sizes are especially useful for visually impaired people.</para> - -<para ->Which sizes will be offered by the icon size listbox depends on the icon theme you have selected in the icon themes control module. For example, the low colour icon theme only offers the sizes 16 and 32 for desktop icons and 16, 22 and 32 for toolbar icons. The HiColour theme offers icon sizes 16, 32 and 48 as well as sizes from 64 to 128. However, as &kde; can not have all these icon sizes in store, icons using size 64 to 128 will be automatically generated which may result in a loss of quality.</para> - -<para ->If the icon sizes offered by your chosen icon theme are not enough for you, there is still the option <guilabel ->Double-sized pixels</guilabel ->. If this option is selected, all icons will have double sized pixels, &ie; a 2x2 block instead of normal pixels. While this makes it possible to achieve very large icon sizes, the quality is poor: icons will look <quote ->blocky</quote ->, an effect you may remember if you've grown up using a Sinclair ZX Spectrum or similar. If this is an option for you, using the large sizes offered by &kde;'s HiColour icon theme will always result in a much better quality than using the low colour icon theme with double sized pixels.</para -> +<title>Icon Size</title> + +<para>You have two options relating to icon sizes. First, you can choose from a list of icon sizes. Second, you can tell &kde; to draw all pixels using double sized pixels. The largest icon sizes are especially useful for visually impaired people.</para> + +<para>Which sizes will be offered by the icon size listbox depends on the icon theme you have selected in the icon themes control module. For example, the low colour icon theme only offers the sizes 16 and 32 for desktop icons and 16, 22 and 32 for toolbar icons. The HiColour theme offers icon sizes 16, 32 and 48 as well as sizes from 64 to 128. However, as &kde; can not have all these icon sizes in store, icons using size 64 to 128 will be automatically generated which may result in a loss of quality.</para> + +<para>If the icon sizes offered by your chosen icon theme are not enough for you, there is still the option <guilabel>Double-sized pixels</guilabel>. If this option is selected, all icons will have double sized pixels, &ie; a 2x2 block instead of normal pixels. While this makes it possible to achieve very large icon sizes, the quality is poor: icons will look <quote>blocky</quote>, an effect you may remember if you've grown up using a Sinclair ZX Spectrum or similar. If this is an option for you, using the large sizes offered by &kde;'s HiColour icon theme will always result in a much better quality than using the low colour icon theme with double sized pixels.</para> <!-- -<para ->You can also choose to have smoothed icons, an effect similar to -anti-aliasing of fonts. Enable the checkbox <guilabel ->Blend alpha -channel</guilabel -> to see this in action, but note that it will slow +<para>You can also choose to have smoothed icons, an effect similar to +anti-aliasing of fonts. Enable the checkbox <guilabel>Blend alpha +channel</guilabel> to see this in action, but note that it will slow down graphics on a slower computer.</para> --> -<para ->You can also choose animated icons. Many of the icons have animations associated with them. Enable the checkbox labelled <guilabel ->Animate Icons</guilabel ->, to enable this effect, but note that it may appear slow or jerky if your graphics card is old or you are low on memory.</para> +<para>You can also choose animated icons. Many of the icons have animations associated with them. Enable the checkbox labelled <guilabel>Animate Icons</guilabel>, to enable this effect, but note that it may appear slow or jerky if your graphics card is old or you are low on memory.</para> </sect3> <sect3 id="icons-use-effects"> -<title ->Effects</title> +<title>Effects</title> -<para ->Finally you can configure certain <quote ->filters</quote -> to be applied on icons which are in one of three states:</para> +<para>Finally you can configure certain <quote>filters</quote> to be applied on icons which are in one of three states:</para> <variablelist> <varlistentry> -<term -><guilabel ->Default</guilabel -></term> -<listitem -><para ->This is how the icon will look normally.</para -></listitem> +<term><guilabel>Default</guilabel></term> +<listitem><para>This is how the icon will look normally.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Active</guilabel ->:</term> -<listitem -><para ->This is how the icon will look when the mouse cursor is over the icon.</para -></listitem> +<term><guilabel>Active</guilabel>:</term> +<listitem><para>This is how the icon will look when the mouse cursor is over the icon.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Disabled</guilabel ->:</term> -<listitem -><para ->This is how the icon will look if its corresponding action is disabled, &ie; clicking on it will not lead to any result.</para -></listitem> +<term><guilabel>Disabled</guilabel>:</term> +<listitem><para>This is how the icon will look if its corresponding action is disabled, &ie; clicking on it will not lead to any result.</para></listitem> </varlistentry> </variablelist> -<para ->Select one of these states, and press the <guibutton ->Set Effect...</guibutton -> button to configure a corresponding icon effect. Please note that this configuration will only affect icons of the currently selected <guilabel ->Use of Icon</guilabel -> category (see above): configuring an effect for active icons, while <guilabel ->Toolbar</guilabel -> icon usage is selected, will <emphasis ->not</emphasis -> affect active icons used in other places.</para> - -<para ->Below the list of icon states there are two options: you can configure an effect and you can select the <guilabel ->Semi-transparent</guilabel -> option, which will make the background <quote ->shine through</quote -> the icon. To the right of the effects list box there's a setup button to pass additional parameters to a filter.</para> - -<para ->The following effects can be applied to icons:</para> +<para>Select one of these states, and press the <guibutton>Set Effect...</guibutton> button to configure a corresponding icon effect. Please note that this configuration will only affect icons of the currently selected <guilabel>Use of Icon</guilabel> category (see above): configuring an effect for active icons, while <guilabel>Toolbar</guilabel> icon usage is selected, will <emphasis>not</emphasis> affect active icons used in other places.</para> + +<para>Below the list of icon states there are two options: you can configure an effect and you can select the <guilabel>Semi-transparent</guilabel> option, which will make the background <quote>shine through</quote> the icon. To the right of the effects list box there's a setup button to pass additional parameters to a filter.</para> + +<para>The following effects can be applied to icons:</para> <variablelist> <varlistentry> -<term -><guilabel ->No Effect</guilabel ->:</term> -<listitem -><para ->Icons will be used without applying any effect.</para -></listitem -> +<term><guilabel>No Effect</guilabel>:</term> +<listitem><para>Icons will be used without applying any effect.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->To Grey</guilabel ->:</term> -<listitem -><para ->This filter will apply a greyish look to the icon. Click <guibutton ->Setup...</guibutton -> to configure the intensity of this filter. Note that it is customary for most user interfaces to use this effect for disabled icons only.</para -></listitem> +<term><guilabel>To Grey</guilabel>:</term> +<listitem><para>This filter will apply a greyish look to the icon. Click <guibutton>Setup...</guibutton> to configure the intensity of this filter. Note that it is customary for most user interfaces to use this effect for disabled icons only.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Colourise</guilabel ->:</term> -<listitem -><para ->Icons will be coloured using a custom colour. For example, you may configure active icons (&ie; the icon the mouse cursor is over) to shine golden. Click <guibutton ->Setup...</guibutton -> to configure the used colour and the intensity of the colouring.</para -></listitem -> +<term><guilabel>Colourise</guilabel>:</term> +<listitem><para>Icons will be coloured using a custom colour. For example, you may configure active icons (&ie; the icon the mouse cursor is over) to shine golden. Click <guibutton>Setup...</guibutton> to configure the used colour and the intensity of the colouring.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Gamma</guilabel ->:</term> -<listitem -><para ->A different gamma value will be applied to all icons. If you're no photographer and don't know what Gamma is: it's quite similar to what people call contrast. Just play around with the gamma settings by clicking on <guibutton ->Setup...</guibutton -> to get a feeling for this effect.</para -></listitem> +<term><guilabel>Gamma</guilabel>:</term> +<listitem><para>A different gamma value will be applied to all icons. If you're no photographer and don't know what Gamma is: it's quite similar to what people call contrast. Just play around with the gamma settings by clicking on <guibutton>Setup...</guibutton> to get a feeling for this effect.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Desaturate</guilabel ->:</term> -<listitem -><para ->Icons will be drawn desaturated. This is quite similar to the <quote ->Colour</quote -> setting on your television. Click <guibutton ->Setup...</guibutton -> to configure the amount of desaturation. </para -></listitem -> +<term><guilabel>Desaturate</guilabel>:</term> +<listitem><para>Icons will be drawn desaturated. This is quite similar to the <quote>Colour</quote> setting on your television. Click <guibutton>Setup...</guibutton> to configure the amount of desaturation. </para></listitem> </varlistentry> </variablelist> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/index.docbook index b599c16d500..9e4982aac59 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/index.docbook @@ -2,233 +2,126 @@ <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <book lang="&language;"> <bookinfo> -<title ->The &kcontrolcenter;</title> +<title>The &kcontrolcenter;</title> <authorgroup> -<author -><firstname ->Michael</firstname -> <surname ->McBride</surname -> <affiliation -><address -><email ->mpmcbride7@yahoo.com</email -></address -></affiliation> +<author><firstname>Michael</firstname> <surname>McBride</surname> <affiliation><address><email>mpmcbride7@yahoo.com</email></address></affiliation> </author> </authorgroup> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2002-02-02</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-02</date> +<releaseinfo>3.00.00</releaseinfo> <abstract> -<para ->This documentation describes &kde;'s control centre.</para> +<para>This documentation describes &kde;'s control centre.</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->kcontrol</keyword> -<keyword ->configuration</keyword> -<keyword ->settings</keyword> -<keyword ->module</keyword> +<keyword>KDE</keyword> +<keyword>kcontrol</keyword> +<keyword>configuration</keyword> +<keyword>settings</keyword> +<keyword>module</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->The &kcontrolcenter;</title> +<title>The &kcontrolcenter;</title> -<para ->The &kcontrolcenter; (from now on referred to simply as <quote ->the control centre</quote ->) provides you with a centralised and convenient way to configure all of your &kde; settings. </para> +<para>The &kcontrolcenter; (from now on referred to simply as <quote>the control centre</quote>) provides you with a centralised and convenient way to configure all of your &kde; settings. </para> -<para ->The control centre is made up of multiple modules. Each module is a separate application, but the control centre organises all of these programs into a convenient location. </para> +<para>The control centre is made up of multiple modules. Each module is a separate application, but the control centre organises all of these programs into a convenient location. </para> <tip> -<para ->Each control centre module can be executed individually </para> +<para>Each control centre module can be executed individually </para> -<para ->See section entitled <link linkend="control-center-run-indiv" ->Running individual control centre modules</link -> for more information. </para> +<para>See section entitled <link linkend="control-center-run-indiv">Running individual control centre modules</link> for more information. </para> </tip> -<para ->The control centre groups the configuration modules into categories, so they are easy to locate. Within each category, the control centre shows all the modules in a list, so it is easier to find the right configuration module. </para> +<para>The control centre groups the configuration modules into categories, so they are easy to locate. Within each category, the control centre shows all the modules in a list, so it is easier to find the right configuration module. </para> </chapter> <chapter id="control-center"> -<title ->Using The &kcontrolcenter;</title> +<title>Using The &kcontrolcenter;</title> -<para ->This next section details the use of the control centre itself. For information on individual modules, please see <link linkend="module" ->Control Centre Modules</link -> </para> +<para>This next section details the use of the control centre itself. For information on individual modules, please see <link linkend="module">Control Centre Modules</link> </para> <sect1 id="control-center-starting"> -<title ->Starting the &kcontrol;</title> +<title>Starting the &kcontrol;</title> -<para ->The &kcontrolcenter; can be started 3 ways: </para> +<para>The &kcontrolcenter; can be started 3 ways: </para> -<orderedlist -> +<orderedlist> <listitem> -<para ->By selecting <menuchoice -><guimenu ->K Button</guimenu -><guimenuitem ->Control Centre</guimenuitem -></menuchoice -> from the &kde; Panel. </para> +<para>By selecting <menuchoice><guimenu>K Button</guimenu><guimenuitem>Control Centre</guimenuitem></menuchoice> from the &kde; Panel. </para> </listitem> <listitem> -<para ->By pressing <keycombo action="simul" ->&Alt;<keycap ->F2</keycap -></keycombo ->. </para> - -<para ->This will bring up a dialogue box. Type <userinput -><command ->kcontrol</command -></userinput ->, and click <guibutton ->Run</guibutton ->. </para> +<para>By pressing <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>. </para> + +<para>This will bring up a dialogue box. Type <userinput><command>kcontrol</command></userinput>, and click <guibutton>Run</guibutton>. </para> </listitem> <listitem> -<para ->You can type <command ->kcontrol &</command -> at any command prompt. </para> -</listitem -> -</orderedlist -> - -<para ->All three of these methods are equivalent, and produce the same result. </para> +<para>You can type <command>kcontrol &</command> at any command prompt. </para> +</listitem> +</orderedlist> + +<para>All three of these methods are equivalent, and produce the same result. </para> </sect1> -<sect1 id="control-center-screen" -> -<title ->The &kcontrolcenter; Screen</title> +<sect1 id="control-center-screen"> +<title>The &kcontrolcenter; Screen</title> -<para ->When you start the control centre, you are presented with a window, which can be divided into 3 functional parts. </para> +<para>When you start the control centre, you are presented with a window, which can be divided into 3 functional parts. </para> <screenshot> -<screeninfo ->Screenshot</screeninfo> +<screeninfo>Screenshot</screeninfo> <mediaobject> -<imageobject -> <imagedata fileref="screenshot.png" format="PNG"/> +<imageobject> <imagedata fileref="screenshot.png" format="PNG"/> </imageobject> -<textobject -> <phrase ->Screenshot</phrase -> </textobject> +<textobject> <phrase>Screenshot</phrase> </textobject> <caption> -<para ->The &kde; Control Centre Screen</para> +<para>The &kde; Control Centre Screen</para> </caption> </mediaobject> -</screenshot -> +</screenshot> -<para ->Across the top is a menubar. The menubar will provide you with quick access to most of &kcontrolcenter;'s features. The menus are detailed in <link linkend="control-center-menus" ->The &kde; Control Centre Menus</link ->. </para> +<para>Across the top is a menubar. The menubar will provide you with quick access to most of &kcontrolcenter;'s features. The menus are detailed in <link linkend="control-center-menus">The &kde; Control Centre Menus</link>. </para> -<para ->Along the left hand side, is a column. This is a where you choose which module to configure. You can learn how to navigate through the modules in the section called <link linkend="module-intro" ->Navigating Modules</link ->. </para> +<para>Along the left hand side, is a column. This is a where you choose which module to configure. You can learn how to navigate through the modules in the section called <link linkend="module-intro">Navigating Modules</link>. </para> -<para ->The main panel shows you some system information. </para> +<para>The main panel shows you some system information. </para> -<para ->In this example, we are running &kde; 2.99, we started &kcontrolcenter; as user <systemitem class="username" ->adridg</systemitem ->, the computer is named <systemitem class="systemname" ->aramis</systemitem ->, it is a FreeBSD system, Version 4.4-RELEASE, on a Pentium. </para> +<para>In this example, we are running &kde; 2.99, we started &kcontrolcenter; as user <systemitem class="username">adridg</systemitem>, the computer is named <systemitem class="systemname">aramis</systemitem>, it is a FreeBSD system, Version 4.4-RELEASE, on a Pentium. </para> </sect1> <sect1 id="control-center-menus"> -<title ->The &kcontrol; Menus</title> +<title>The &kcontrol; Menus</title> -<para ->This next section gives you a brief description of what each menu item does. </para> +<para>This next section gives you a brief description of what each menu item does. </para> <sect2 id="control-center-menu-file"> -<title -><guimenu ->File</guimenu -> Menu</title> +<title><guimenu>File</guimenu> Menu</title> -<para ->The <guimenu ->File</guimenu -> menu has a single entry. </para> +<para>The <guimenu>File</guimenu> menu has a single entry. </para> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->Q</keycap -></keycombo -> </shortcut -> <guimenu ->File</guimenu -> <guimenuitem ->Quit</guimenuitem -> </menuchoice -></term> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem> </menuchoice></term> <listitem> <para> -<action ->Closes the control centre.</action> +<action>Closes the control centre.</action> </para> </listitem> </varlistentry> @@ -237,161 +130,75 @@ </sect2> <sect2 id="control-center-menu-view"> -<title -><guimenu ->View</guimenu -> Menu</title> - -<para ->These options determine how the module selection looks and behaves. </para> - -<variablelist -> -<varlistentry -> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Mode</guimenuitem -> </menuchoice -></term> +<title><guimenu>View</guimenu> Menu</title> + +<para>These options determine how the module selection looks and behaves. </para> + +<variablelist> +<varlistentry> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>Mode</guimenuitem> </menuchoice></term> <listitem> -<para ->Determines whether to use <guimenuitem ->Tree</guimenuitem -> view, or <guimenuitem ->Icon</guimenuitem -> view for your modules. </para> - -<para ->With <guimenuitem ->Tree</guimenuitem -> view, each submenu appears as an indented list. </para> - -<para ->With <guimenuitem ->Icon</guimenuitem -> view, when you click on a category, the categories disappear and are replaced with the module list. You then use the <guiicon ->up</guiicon -> button to return to the categories. </para> +<para>Determines whether to use <guimenuitem>Tree</guimenuitem> view, or <guimenuitem>Icon</guimenuitem> view for your modules. </para> + +<para>With <guimenuitem>Tree</guimenuitem> view, each submenu appears as an indented list. </para> + +<para>With <guimenuitem>Icon</guimenuitem> view, when you click on a category, the categories disappear and are replaced with the module list. You then use the <guiicon>up</guiicon> button to return to the categories. </para> </listitem> </varlistentry> -<varlistentry -> -<term -><menuchoice -><guimenu ->View</guimenu -><guisubmenu ->Icon size</guisubmenu -> </menuchoice -></term -> +<varlistentry> +<term><menuchoice><guimenu>View</guimenu><guisubmenu>Icon size</guisubmenu> </menuchoice></term> <listitem> -<para ->Using this option, you can choose <guimenuitem ->Small</guimenuitem ->, <guimenuitem ->Medium</guimenuitem ->, or <guimenuitem ->Large</guimenuitem -> icons to select your modules. </para> - -<note -><para ->This menu item only controls the icon size if you are in <guimenuitem ->Icon View</guimenuitem ->. If you choose <guimenuitem ->Tree View</guimenuitem ->, the <guimenuitem ->Small</guimenuitem -> icon size will be used, no matter what size was previously selected in <guimenuitem ->Icon View</guimenuitem ->. </para> +<para>Using this option, you can choose <guimenuitem>Small</guimenuitem>, <guimenuitem>Medium</guimenuitem>, or <guimenuitem>Large</guimenuitem> icons to select your modules. </para> + +<note><para>This menu item only controls the icon size if you are in <guimenuitem>Icon View</guimenuitem>. If you choose <guimenuitem>Tree View</guimenuitem>, the <guimenuitem>Small</guimenuitem> icon size will be used, no matter what size was previously selected in <guimenuitem>Icon View</guimenuitem>. </para> </note> </listitem> -</varlistentry -> -</variablelist -> +</varlistentry> +</variablelist> </sect2> <sect2 id="control-center-menu-mod"> -<title -><guimenu ->Modules</guimenu -> Menu</title> +<title><guimenu>Modules</guimenu> Menu</title> -<para ->The modules menu is a shortcut to take you directly to any module in the control centre. </para> +<para>The modules menu is a shortcut to take you directly to any module in the control centre. </para> </sect2> <sect2 id="control-center-menu-help"> -<title -><guimenu ->Help</guimenu -> Menu</title> +<title><guimenu>Help</guimenu> Menu</title> &help.menu.documentation; </sect2> </sect1> <sect1 id="control-center-exiting"> -<title ->Exiting The &kde; Control Centre</title> +<title>Exiting The &kde; Control Centre</title> -<para ->You can exit the control centre one of three ways: </para> +<para>You can exit the control centre one of three ways: </para> <itemizedlist> <listitem> -<para ->Select <menuchoice -><guimenu ->File</guimenu -> <guimenuitem ->Quit</guimenuitem -></menuchoice -> from the menu bar. </para> +<para>Select <menuchoice><guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem></menuchoice> from the menu bar. </para> </listitem> <listitem> -<para ->Type <keycombo action="simul" ->&Ctrl;<keycap ->Q</keycap -></keycombo -> on the keyboard. </para> +<para>Type <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> on the keyboard. </para> </listitem> <listitem> -<para ->Click on the <guiicon ->Close</guiicon -> button on the frame surrounding the control centre. </para> +<para>Click on the <guiicon>Close</guiicon> button on the frame surrounding the control centre. </para> </listitem> </itemizedlist> </sect1> <sect1 id="control-center-run-indiv"> -<title ->Running Individual Modules</title> - -<para ->You can run individual modules without running kcontrol by selecting <menuchoice -><guimenu ->K Button</guimenu -> <guisubmenu ->Preferences</guisubmenu -> </menuchoice -> from the &kde; panel. You can then select the module you want to run in the submenus. </para> +<title>Running Individual Modules</title> + +<para>You can run individual modules without running kcontrol by selecting <menuchoice><guimenu>K Button</guimenu> <guisubmenu>Preferences</guisubmenu> </menuchoice> from the &kde; panel. You can then select the module you want to run in the submenus. </para> </sect1> @@ -400,335 +207,186 @@ <!--*****************************************************************--> <chapter id="module"> -<title ->The &kcontrol; Modules</title> +<title>The &kcontrol; Modules</title> -<para ->In order to make it as easy as possible, the &kcontrol; has organised similar options into groups. Each group is called a module. When you click on the name of a module in the left window, you will be presented with the options of the module on the right. </para> +<para>In order to make it as easy as possible, the &kcontrol; has organised similar options into groups. Each group is called a module. When you click on the name of a module in the left window, you will be presented with the options of the module on the right. </para> -<para ->Each module will have some or all of the following buttons: </para> +<para>Each module will have some or all of the following buttons: </para> <variablelist> <varlistentry> -<term ->Help</term> +<term>Help</term> <listitem> -<para ->This button will give you help specific to the current module. The button will show you a short summary help page in the left window. At the bottom of that window, you can click on a link to get more detailed help. </para> +<para>This button will give you help specific to the current module. The button will show you a short summary help page in the left window. At the bottom of that window, you can click on a link to get more detailed help. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Use Defaults</guilabel -></term -> +<term><guilabel>Use Defaults</guilabel></term> <listitem> -<para ->This button will restore this module to its default values. You must click <guibutton ->OK</guibutton -> to save the options. </para> +<para>This button will restore this module to its default values. You must click <guibutton>OK</guibutton> to save the options. </para> </listitem> </varlistentry> <varlistentry> -<term -><guibutton ->Apply</guibutton -></term> +<term><guibutton>Apply</guibutton></term> <listitem> -<para ->Clicking this button will save all changes to &kde;. If you have changed anything, clicking <guibutton ->Apply</guibutton -> will cause the changes to take effect. </para> +<para>Clicking this button will save all changes to &kde;. If you have changed anything, clicking <guibutton>Apply</guibutton> will cause the changes to take effect. </para> </listitem> </varlistentry> <varlistentry> -<term -><guibutton ->Reset</guibutton -></term> +<term><guibutton>Reset</guibutton></term> <listitem> -<para ->This button will <quote ->Reset</quote -> the module. The exact effect will depend on the module. </para> +<para>This button will <quote>Reset</quote> the module. The exact effect will depend on the module. </para> </listitem> -</varlistentry -> +</varlistentry> </variablelist> <note> -<para ->You must save the options of one module using <guibutton ->Apply</guibutton -> before you can change to a different module. </para> -<para ->If you try to change without saving your options, you will be asked if you want to save your changes, or discard them. </para> +<para>You must save the options of one module using <guibutton>Apply</guibutton> before you can change to a different module. </para> +<para>If you try to change without saving your options, you will be asked if you want to save your changes, or discard them. </para> </note> <sect1 id="module-intro"> -<title ->Navigating Modules</title> +<title>Navigating Modules</title> -<para ->This is a list of the <emphasis ->standard</emphasis -> configuration modules (sorted by category) provided by the <application role="package" ->KDE base</application -> package. Please note that there may be many more modules on your system if you have installed additional software. </para> +<para>This is a list of the <emphasis>standard</emphasis> configuration modules (sorted by category) provided by the <application role="package">KDE base</application> package. Please note that there may be many more modules on your system if you have installed additional software. </para> <!-- Commented until fixed arrangement is made --> <!-- <variablelist> <varlistentry> -<term ->File Browsing</term> +<term>File Browsing</term> <listitem> <para> -<link linkend="file-assoc" ->File Associations</link ->, -<link linkend="file-manager" ->File Manager</link ->, +<link linkend="file-assoc">File Associations</link>, +<link linkend="file-manager">File Manager</link>, </para> </listitem> </varlistentry> <varlistentry> -<term ->Look and Feel</term> +<term>Look and Feel</term> <listitem> <para> -<link linkend="background" ->Background</link ->, -<!- - <link linkend="borders" ->Borders</link ->,- -> -<link linkend="color" ->Colors</link ->, -<link linkend="desktop" ->Desktop</link ->, -<link linkend="fonts" ->Fonts</link ->, -<link linkend="icons" ->Icons</link ->, -<!- - <link linkend="iconstyle" ->Icon Style</link ->, - -> -<link linkend="key-bindings" ->Key Bindings</link ->, -<link linkend="launch-feedback" ->Launch feedback</link ->, -<link linkend="panel" ->Panel</link ->, -<link linkend="screensaver" ->Screensaver</link ->, -<link linkend="style" ->Style</link ->, -<link linkend="sys-notify" ->System Notifications</link ->, -<link linkend="taskbar" ->Taskbar</link ->, -<link linkend="theme-manager" ->Theme Manager</link ->, -<!- - <link linkend="numbername" ->Virtual Desktops</link ->,- -> -<link linkend="window-behavior" ->Window Behavior</link ->, -<link linkend="window-deco" ->Window Decoration</link ->. +<link linkend="background">Background</link>, +<!- - <link linkend="borders">Borders</link>,- -> +<link linkend="color">Colors</link>, +<link linkend="desktop">Desktop</link>, +<link linkend="fonts">Fonts</link>, +<link linkend="icons">Icons</link>, +<!- - <link linkend="iconstyle">Icon Style</link>, - -> +<link linkend="key-bindings">Key Bindings</link>, +<link linkend="launch-feedback">Launch feedback</link>, +<link linkend="panel">Panel</link>, +<link linkend="screensaver">Screensaver</link>, +<link linkend="style">Style</link>, +<link linkend="sys-notify">System Notifications</link>, +<link linkend="taskbar">Taskbar</link>, +<link linkend="theme-manager">Theme Manager</link>, +<!- - <link linkend="numbername">Virtual Desktops</link>,- -> +<link linkend="window-behavior">Window Behavior</link>, +<link linkend="window-deco">Window Decoration</link>. </para> </listitem> </varlistentry> <varlistentry> -<term ->Network</term> +<term>Network</term> <listitem> <para> -<link linkend="e-mail" ->E-Mail</link ->, -<link linkend="lan-browsing" ->LAN Browsing</link ->, -<link linkend="timeouts" ->Preferences</link ->, <!- - FIXME - -> -<link linkend="socks" ->SOCKS</link ->, -<link linkend="talk" ->Talk Configuration</link> -<link linkend="windows-shares" ->Windows Shares</link> +<link linkend="e-mail">E-Mail</link>, +<link linkend="lan-browsing">LAN Browsing</link>, +<link linkend="timeouts">Preferences</link>, <!- - FIXME - -> +<link linkend="socks">SOCKS</link>, +<link linkend="talk">Talk Configuration</link> +<link linkend="windows-shares">Windows Shares</link> </para> </listitem> </varlistentry> <varlistentry> -<term ->Peripherals</term> +<term>Peripherals</term> <listitem> <para> -<link linkend="kbd" ->Keyboard</link ->, -<link linkend="mouse" ->Mouse</link> +<link linkend="kbd">Keyboard</link>, +<link linkend="mouse">Mouse</link> </para> </listitem> </varlistentry> <varlistentry> -<term ->Personalization</term> +<term>Personalization</term> <listitem> <para> -<link linkend="accessibility" ->Accessibility</link ->, -<link linkend="locale" ->Country & Language</link ->, -<link linkend="crypto" ->Crypto</link ->, -<!- - <link linkend="kblayout" ->Keyboard Layout</link ->, - -> -<link linkend="passwords" ->Passwords</link> -<link linkend="spell-checking" ->Spell Checking</link ->. +<link linkend="accessibility">Accessibility</link>, +<link linkend="locale">Country & Language</link>, +<link linkend="crypto">Crypto</link>, +<!- - <link linkend="kblayout">Keyboard Layout</link>, - -> +<link linkend="passwords">Passwords</link> +<link linkend="spell-checking">Spell Checking</link>. </para> </listitem> </varlistentry> <varlistentry> -<term ->Power Control</term> +<term>Power Control</term> <listitem> <para> -<link linkend="battery-monitor" ->Battery Monitor</link ->, -<link linkend="energy" ->Energy</link ->, -<link linkend="powerctrl" ->Laptop Power Control</link ->, -<link linkend="lowbatcrit" ->Low Battery Critical</link ->, -<link linkend="lowbatwarn" ->Low Battery Warning</link> +<link linkend="battery-monitor">Battery Monitor</link>, +<link linkend="energy">Energy</link>, +<link linkend="powerctrl">Laptop Power Control</link>, +<link linkend="lowbatcrit">Low Battery Critical</link>, +<link linkend="lowbatwarn">Low Battery Warning</link> </para> </listitem> </varlistentry> <varlistentry> -<term ->Sound</term> +<term>Sound</term> <listitem> <para> -<link linkend="midi" ->Midi</link ->, -<link linkend="mixer" ->Mixer</link ->, -<link linkend="sndserver" ->Sound Server</link ->, -<link linkend="bell" ->System Bell</link> +<link linkend="midi">Midi</link>, +<link linkend="mixer">Mixer</link>, +<link linkend="sndserver">Sound Server</link>, +<link linkend="bell">System Bell</link> </para> </listitem> </varlistentry> <varlistentry> -<term ->System</term> +<term>System</term> <listitem> <para> -<link linkend="datetime" ->Date and Time</link ->, -<link linkend="konsole" ->&konsole;</link ->, -<link linkend="login-manager" ->Login Manager</link ->, -<link linkend="print-manager" ->Printing Manager</link ->, -<link linkend="sessions" ->Session Manager</link ->, +<link linkend="datetime">Date and Time</link>, +<link linkend="konsole">&konsole;</link>, +<link linkend="login-manager">Login Manager</link>, +<link linkend="print-manager">Printing Manager</link>, +<link linkend="sessions">Session Manager</link>, </para> </listitem> </varlistentry> <varlistentry> -<term ->Web Browsing</term> +<term>Web Browsing</term> <listitem> <para> -<link linkend="cookie" ->Cookies</link ->, -<link linkend="ebrowse" ->Enhanced Browsing</link ->, -<link linkend="konq-browsing" ->Konqueror Browser</link ->, -<link linkend="nsplugins" ->Netscape Plugins</link ->, -<link linkend="proxies" ->Proxies & Cache</link ->, -<link linkend="stylesheets" ->Stylesheets</link ->, -<link linkend="user-agent" ->User Agent</link ->, +<link linkend="cookie">Cookies</link>, +<link linkend="ebrowse">Enhanced Browsing</link>, +<link linkend="konq-browsing">Konqueror Browser</link>, +<link linkend="nsplugins">Netscape Plugins</link>, +<link linkend="proxies">Proxies & Cache</link>, +<link linkend="stylesheets">Stylesheets</link>, +<link linkend="user-agent">User Agent</link>, </para> </listitem> </varlistentry> -</variablelist ->--> +</variablelist>--> </sect1> @@ -738,189 +396,60 @@ </chapter> <chapter id="laptop"> -<title ->Laptop Modules Notes</title> - -<para ->In order to use the laptop modules, you must have the kernel <acronym ->APM</acronym -> package installed in your kernel. Useful information on how to do this can be found at <ulink url="http://www.cs.utexas.edu/users/kharker/linux-laptop/apm.html" -> http://www.cs.utexas.edu/users/kharker/linux-laptop/apm.html</ulink -> and in the Battery Powered Linux mini-HOWTO at <ulink url="http://metalab.unc.edu/LDP/HOWTO/mini/Battery-Powered.html" -> http://metalab.unc.edu/LDP/HOWTO/mini/Battery-Powered.html</ulink ->. </para> - -<para ->If you want the <guimenuitem ->suspend</guimenuitem -> and <guimenuitem ->standby</guimenuitem -> menu commands to work then you should install the &Linux; <application ->apmd</application -> package (version 2.4 or later). If you want to use them from non-root accounts you must mark the <application ->apm</application -> command <quote ->set uid root</quote ->. </para> - -<para ->To do this, log on as <systemitem class="username" ->root</systemitem -> and enter: </para> - -<screen -><prompt ->%</prompt -><userinput -><command ->chown</command -> <option ->root -/usr/bin/apm</option ->;<command ->chmod</command -> <option ->+s -/usr/bin/apm</option -></userinput -> +<title>Laptop Modules Notes</title> + +<para>In order to use the laptop modules, you must have the kernel <acronym>APM</acronym> package installed in your kernel. Useful information on how to do this can be found at <ulink url="http://www.cs.utexas.edu/users/kharker/linux-laptop/apm.html"> http://www.cs.utexas.edu/users/kharker/linux-laptop/apm.html</ulink> and in the Battery Powered Linux mini-HOWTO at <ulink url="http://metalab.unc.edu/LDP/HOWTO/mini/Battery-Powered.html"> http://metalab.unc.edu/LDP/HOWTO/mini/Battery-Powered.html</ulink>. </para> + +<para>If you want the <guimenuitem>suspend</guimenuitem> and <guimenuitem>standby</guimenuitem> menu commands to work then you should install the &Linux; <application>apmd</application> package (version 2.4 or later). If you want to use them from non-root accounts you must mark the <application>apm</application> command <quote>set uid root</quote>. </para> + +<para>To do this, log on as <systemitem class="username">root</systemitem> and enter: </para> + +<screen><prompt>%</prompt><userinput><command>chown</command> <option>root +/usr/bin/apm</option>;<command>chmod</command> <option>+s +/usr/bin/apm</option></userinput> </screen> <warning> -<para ->By doing this you will allow any user of your system to put it into suspend or standby states - if you are the only user, this should not be a problem. </para> - -<para ->Also note that any program which has <systemitem class="username" ->root</systemitem -> access, can be a potential security problem. You should carefully determine if there are any security concerns <emphasis ->before</emphasis -> giving any program <systemitem class="username" ->root</systemitem -> permissions. </para> +<para>By doing this you will allow any user of your system to put it into suspend or standby states - if you are the only user, this should not be a problem. </para> + +<para>Also note that any program which has <systemitem class="username">root</systemitem> access, can be a potential security problem. You should carefully determine if there are any security concerns <emphasis>before</emphasis> giving any program <systemitem class="username">root</systemitem> permissions. </para> </warning> </chapter> <chapter id="credits"> -<title ->Credits and Licence</title> +<title>Credits and Licence</title> -<para ->&kcontrol;</para> -<para ->Program copyright 1997-2001 The &kcontrolcenter; Developers</para> -<para ->Contributors:</para> +<para>&kcontrol;</para> +<para>Program copyright 1997-2001 The &kcontrolcenter; Developers</para> +<para>Contributors:</para> <itemizedlist> -<listitem -><para ->Matthias Hoelzer-Kluepfel <email ->hoelzer@kde.org</email -></para -></listitem> -<listitem -><para ->Matthias Elter <email ->elter@kde.org</email -></para -></listitem> +<listitem><para>Matthias Hoelzer-Kluepfel <email>hoelzer@kde.org</email></para></listitem> +<listitem><para>Matthias Elter <email>elter@kde.org</email></para></listitem> </itemizedlist> -<para ->Documentation <trademark class="copyright" ->copyright 2000 Michael McBride</trademark -> <email ->mpmcbride7@yahoo.com</email -></para> +<para>Documentation <trademark class="copyright">copyright 2000 Michael McBride</trademark> <email>mpmcbride7@yahoo.com</email></para> -<para ->Contributors:</para> +<para>Contributors:</para> <itemizedlist> -<listitem -><para ->Paul Campbell <email ->paul@taniwha.com</email -></para -></listitem> -<listitem -><para ->Helge Deller <email ->deller@kde.org</email -></para -></listitem> -<listitem -><para ->Mark Donohoe </para -></listitem> -<listitem -><para ->Pat Dowler </para -></listitem> -<listitem -><para ->Duncan Haldane <email ->duncan@kde.org</email -></para -></listitem> -<listitem -><para ->Steffen Hansen <email ->stefh@mip.ou.dk</email ->.</para -></listitem> -<listitem -><para ->Matthias Hoelzer-Kluepfel <email ->hoelzer@kde.org</email -></para -></listitem> -<listitem -><para ->Martin Jones <email ->mjones@kde.org</email -></para -></listitem> -<listitem -><para ->Jost Schenck <email ->jost@schenck.de</email -></para -></listitem> -<listitem -><para ->Jonathan Singer <email ->jsinger@leeta.net</email -></para -></listitem> -<listitem -><para ->Thomas Tanghus <email ->tanghus@earthling.net</email -></para -></listitem> -<listitem -><para ->Krishna Tateneni <email ->tateneni@pluto.njcc.com -></email -></para -></listitem> -<listitem -><para ->Ellis Whitehead <email ->ewhitehe@uni-freiburg.de</email -></para -></listitem> +<listitem><para>Paul Campbell <email>paul@taniwha.com</email></para></listitem> +<listitem><para>Helge Deller <email>deller@kde.org</email></para></listitem> +<listitem><para>Mark Donohoe </para></listitem> +<listitem><para>Pat Dowler </para></listitem> +<listitem><para>Duncan Haldane <email>duncan@kde.org</email></para></listitem> +<listitem><para>Steffen Hansen <email>stefh@mip.ou.dk</email>.</para></listitem> +<listitem><para>Matthias Hoelzer-Kluepfel <email>hoelzer@kde.org</email></para></listitem> +<listitem><para>Martin Jones <email>mjones@kde.org</email></para></listitem> +<listitem><para>Jost Schenck <email>jost@schenck.de</email></para></listitem> +<listitem><para>Jonathan Singer <email>jsinger@leeta.net</email></para></listitem> +<listitem><para>Thomas Tanghus <email>tanghus@earthling.net</email></para></listitem> +<listitem><para>Krishna Tateneni <email>tateneni@pluto.njcc.com></email></para></listitem> +<listitem><para>Ellis Whitehead <email>ewhitehe@uni-freiburg.de</email></para></listitem> </itemizedlist> -<para ->Conversion to British English: Malcolm Hunter <email ->malcolm.hunter@gmx.co.uk</email -></para -> +<para>Conversion to British English: Malcolm Hunter <email>malcolm.hunter@gmx.co.uk</email></para> &underFDL; &underGPL; </chapter> </book> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmaccess/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmaccess/index.docbook index 0de44832cbb..d95215e5e29 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmaccess/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmaccess/index.docbook @@ -2,202 +2,82 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article> <articleinfo> -<authorgroup -> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<authorgroup> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-09-01</date> -<releaseinfo ->3.01.00</releaseinfo> +<date>2002-09-01</date> +<releaseinfo>3.01.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->accessibility</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>accessibility</keyword> </keywordset> </articleinfo> <sect1 id="accessibility"> -<title ->Accessibility</title> +<title>Accessibility</title> <sect2 id="accessibility-intro"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->This module is designed to help users who have difficulty hearing audible cues, or who have difficulty using a keyboard. </para> +<para>This module is designed to help users who have difficulty hearing audible cues, or who have difficulty using a keyboard. </para> -<para ->The module is divided into two tabs: <link linkend="access-bell" -><guilabel ->Bell</guilabel -></link -> and <link linkend="access-kb" -><guilabel ->Keyboard</guilabel -></link ->. </para> +<para>The module is divided into two tabs: <link linkend="access-bell"><guilabel>Bell</guilabel></link> and <link linkend="access-kb"><guilabel>Keyboard</guilabel></link>. </para> <sect3 id="access-bell"> -<title -><guilabel ->Bell</guilabel -></title> - -<para ->This panel is divided into an <guilabel ->Audible Bell</guilabel -> section and a <guilabel ->Visible Bell</guilabel -> section. </para> - -<para ->The top check box labelled <guilabel ->Use System Bell</guilabel ->, determines whether the normal System bell rings. If this option is disabled, the System bell will be silenced. </para> - -<para ->The next check box down can be used to play a different sound whenever the system bell is triggered. To activate, place a mark in the check box labelled <guilabel ->Use customised bell</guilabel ->, and enter the complete pathname to the sound file in the text box labelled <guilabel ->Sound to Play</guilabel ->. If you want, you can select the <guibutton ->Browse</guibutton -> button to navigate through your filesystem to find the exact file. </para> - -<para ->For those users who have difficulty hearing the System bell, or those users who have a silent computer, &kde; offers the <emphasis ->visible bell</emphasis ->. This provides a visual signal (inverting the screen or flashing a colour across it) when the system bell would normally sound. </para> - -<para ->To use the visible bell, first place a mark in the check box labelled <guilabel ->Use visible bell</guilabel ->. </para> - -<para ->You can then select between <guilabel ->Invert screen</guilabel ->, or <guilabel ->Flash screen</guilabel ->. If you select <guilabel ->Invert screen</guilabel ->, all colours on the screen will be reversed. If you choose <guilabel ->Flash screen</guilabel ->, you can choose the colour by clicking the button to the right of the <guilabel ->Flash screen</guilabel -> selection. </para> - -<para ->The slider bar can be used to adjust the duration of the visible bell. The default value is 500ms, or half a second. </para> +<title><guilabel>Bell</guilabel></title> + +<para>This panel is divided into an <guilabel>Audible Bell</guilabel> section and a <guilabel>Visible Bell</guilabel> section. </para> + +<para>The top check box labelled <guilabel>Use System Bell</guilabel>, determines whether the normal System bell rings. If this option is disabled, the System bell will be silenced. </para> + +<para>The next check box down can be used to play a different sound whenever the system bell is triggered. To activate, place a mark in the check box labelled <guilabel>Use customised bell</guilabel>, and enter the complete pathname to the sound file in the text box labelled <guilabel>Sound to Play</guilabel>. If you want, you can select the <guibutton>Browse</guibutton> button to navigate through your filesystem to find the exact file. </para> + +<para>For those users who have difficulty hearing the System bell, or those users who have a silent computer, &kde; offers the <emphasis>visible bell</emphasis>. This provides a visual signal (inverting the screen or flashing a colour across it) when the system bell would normally sound. </para> + +<para>To use the visible bell, first place a mark in the check box labelled <guilabel>Use visible bell</guilabel>. </para> + +<para>You can then select between <guilabel>Invert screen</guilabel>, or <guilabel>Flash screen</guilabel>. If you select <guilabel>Invert screen</guilabel>, all colours on the screen will be reversed. If you choose <guilabel>Flash screen</guilabel>, you can choose the colour by clicking the button to the right of the <guilabel>Flash screen</guilabel> selection. </para> + +<para>The slider bar can be used to adjust the duration of the visible bell. The default value is 500ms, or half a second. </para> </sect3> <sect3 id="access-kb"> -<title -><guilabel ->Keyboard</guilabel -></title> +<title><guilabel>Keyboard</guilabel></title> -<para ->There are three sections to this panel.</para> +<para>There are three sections to this panel.</para> <variablelist> <varlistentry> -<term -><guilabel ->Use Sticky Keys</guilabel -></term> +<term><guilabel>Use Sticky Keys</guilabel></term> <listitem> -<para ->If this option is enabled, the user can press and release the &Shift;, &Alt; or &Ctrl; keys, and then press another key to get a key combo (example: <keycombo action="simul" ->&Ctrl; &Alt; <keycap ->Del</keycap -></keycombo -> could be done with &Ctrl; then &Alt; then <keycap ->Del</keycap ->). </para> - -<para ->Also in this section is a check box labelled <guilabel ->Lock Sticky Keys</guilabel ->. If this check box is enabled, the &Alt;, &Ctrl; and &Shift; keys stay <quote ->selected</quote -> until they are <quote ->de-selected</quote -> by the user. </para> - -<para ->As an example: </para> +<para>If this option is enabled, the user can press and release the &Shift;, &Alt; or &Ctrl; keys, and then press another key to get a key combo (example: <keycombo action="simul">&Ctrl; &Alt; <keycap>Del</keycap></keycombo> could be done with &Ctrl; then &Alt; then <keycap>Del</keycap>). </para> + +<para>Also in this section is a check box labelled <guilabel>Lock Sticky Keys</guilabel>. If this check box is enabled, the &Alt;, &Ctrl; and &Shift; keys stay <quote>selected</quote> until they are <quote>de-selected</quote> by the user. </para> + +<para>As an example: </para> <variablelist> <varlistentry> -<term ->With <guilabel ->Lock Sticky Keys</guilabel -> disabled:</term> +<term>With <guilabel>Lock Sticky Keys</guilabel> disabled:</term> <listitem> -<para ->The user presses the &Shift; key, then presses the <keycap ->F</keycap -> key. The computer translates this into <keycombo action="simul" ->&Shift;<keycap ->F</keycap -></keycombo ->. Now if the user types a <keycap ->p</keycap ->, the computer interprets this as the letter p (no shift). </para> +<para>The user presses the &Shift; key, then presses the <keycap>F</keycap> key. The computer translates this into <keycombo action="simul">&Shift;<keycap>F</keycap></keycombo>. Now if the user types a <keycap>p</keycap>, the computer interprets this as the letter p (no shift). </para> </listitem> </varlistentry> <varlistentry> -<term ->With <guilabel ->Lock Sticky Keys</guilabel -> enabled:</term> +<term>With <guilabel>Lock Sticky Keys</guilabel> enabled:</term> <listitem> -<para ->The user presses the &Shift; key, then presses the <keycap ->F</keycap -> key. The computer translates this into <keycombo action="simul" ->&Shift;<keycap ->F</keycap -></keycombo ->. Now if the user types a <keycap ->p</keycap ->, the computer interprets this as the letter P (<keycombo action="simul" ->&Shift;<keycap ->P</keycap -></keycombo ->). </para> +<para>The user presses the &Shift; key, then presses the <keycap>F</keycap> key. The computer translates this into <keycombo action="simul">&Shift;<keycap>F</keycap></keycombo>. Now if the user types a <keycap>p</keycap>, the computer interprets this as the letter P (<keycombo action="simul">&Shift;<keycap>P</keycap></keycombo>). </para> </listitem> </varlistentry> </variablelist> @@ -205,24 +85,16 @@ </varlistentry> <varlistentry> -<term -><guilabel ->Slow keys</guilabel -></term> +<term><guilabel>Slow keys</guilabel></term> <listitem> -<para ->If this option is enabled, the user must hold the key down for a specified period of time (adjustable with the slider) before the keystroke will be accepted. This helps prevent accidental key strokes. </para> +<para>If this option is enabled, the user must hold the key down for a specified period of time (adjustable with the slider) before the keystroke will be accepted. This helps prevent accidental key strokes. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Bounce keys</guilabel -></term> +<term><guilabel>Bounce keys</guilabel></term> <listitem> -<para ->If this option is enabled, the user must wait a specified delay (configurable with the slider) before the next key press can be accepted. This prevents accidental multiple key strokes. </para> +<para>If this option is enabled, the user must wait a specified delay (configurable with the slider) before the next key press can be accepted. This prevents accidental multiple key strokes. </para> </listitem> </varlistentry> </variablelist> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmcss/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmcss/index.docbook index 34b33d4c1d7..48968426957 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmcss/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmcss/index.docbook @@ -2,134 +2,70 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-12</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-12</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->CSS</keyword> -<keyword ->Stylesheets</keyword> -<keyword ->Accessibility</keyword> +<keyword>KDE</keyword> +<keyword>CSS</keyword> +<keyword>Stylesheets</keyword> +<keyword>Accessibility</keyword> </keywordset> </articleinfo> <sect1 id="stylesheets"> -<title ->Stylesheets</title> +<title>Stylesheets</title> <sect2> -<title ->Introduction</title> - -<para -><acronym ->CSS</acronym -> style sheets affect the way web pages appear. <acronym ->CSS</acronym -> stands for <emphasis ->C</emphasis ->ascading <emphasis ->S</emphasis ->tyle <emphasis ->S</emphasis ->heets.</para> - -<para ->&kde; can use its own stylesheet, based on simple defaults and the colour scheme you are using for your desktop. &kde; can also use a stylesheet that you have written yourself. Finally, you can specify a stylesheet in this module. The options presented in this module are tuned for accessibility purposes, especially for people with reduced vision.</para> - -<para ->Your choices here affect every &kde; application that renders HTML with &kde;'s own renderer, which is called tdehtml. These include &kmail;, &khelpcenter; and of course &konqueror;. Choices here do not affect other browsers such as &Netscape;.</para> - -<para ->The module has two pages, <guilabel ->General</guilabel ->, where you can choose which stylesheet to use, and <guilabel ->Customise</guilabel -> where you can design an accessibility stylesheet.</para> +<title>Introduction</title> + +<para><acronym>CSS</acronym> style sheets affect the way web pages appear. <acronym>CSS</acronym> stands for <emphasis>C</emphasis>ascading <emphasis>S</emphasis>tyle <emphasis>S</emphasis>heets.</para> + +<para>&kde; can use its own stylesheet, based on simple defaults and the colour scheme you are using for your desktop. &kde; can also use a stylesheet that you have written yourself. Finally, you can specify a stylesheet in this module. The options presented in this module are tuned for accessibility purposes, especially for people with reduced vision.</para> + +<para>Your choices here affect every &kde; application that renders HTML with &kde;'s own renderer, which is called tdehtml. These include &kmail;, &khelpcenter; and of course &konqueror;. Choices here do not affect other browsers such as &Netscape;.</para> + +<para>The module has two pages, <guilabel>General</guilabel>, where you can choose which stylesheet to use, and <guilabel>Customise</guilabel> where you can design an accessibility stylesheet.</para> </sect2> <sect2 id="css-general"> -<title ->General</title> +<title>General</title> -<para ->This page contains the following options:</para> +<para>This page contains the following options:</para> <variablelist> <varlistentry> -<term -><guilabel ->Use default stylesheet</guilabel -></term> +<term><guilabel>Use default stylesheet</guilabel></term> <listitem> -<para ->&kde; will use the default stylesheet. Some of the colours will default to those defined in your chosen colour scheme. Most settings are easily overridden by the page you are viewing.</para> +<para>&kde; will use the default stylesheet. Some of the colours will default to those defined in your chosen colour scheme. Most settings are easily overridden by the page you are viewing.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Use user-defined stylesheet</guilabel -></term> +<term><guilabel>Use user-defined stylesheet</guilabel></term> <listitem> -<para ->&kde; will use a stylesheet that you have written yourself. You can use the browse button to locate the stylesheet on your system. <acronym ->CSS</acronym -> files traditionally have a <literal role="extension" ->.css</literal -> extension, but this is not required.</para> +<para>&kde; will use a stylesheet that you have written yourself. You can use the browse button to locate the stylesheet on your system. <acronym>CSS</acronym> files traditionally have a <literal role="extension">.css</literal> extension, but this is not required.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Use accessibility stylesheet defined in "Customise"-tab</guilabel -></term> +<term><guilabel>Use accessibility stylesheet defined in "Customise"-tab</guilabel></term> <listitem> -<para ->Use the settings defined in the <guilabel ->Customise</guilabel -> tab. Enabling this option will enable the options on the <guilabel ->Customise</guilabel -> page.</para> +<para>Use the settings defined in the <guilabel>Customise</guilabel> tab. Enabling this option will enable the options on the <guilabel>Customise</guilabel> page.</para> </listitem> </varlistentry> </variablelist> @@ -137,143 +73,84 @@ </sect2> <sect2 id="css-customize"> -<title ->Customise</title> +<title>Customise</title> -<para ->Here you can set up a user stylesheet. The options available are only a subset of the instructions you can add in a stylesheet, and they are geared towards people with reduced vision, to allow users to create a stylesheet that makes web pages and the &kde; help files more readable.</para> +<para>Here you can set up a user stylesheet. The options available are only a subset of the instructions you can add in a stylesheet, and they are geared towards people with reduced vision, to allow users to create a stylesheet that makes web pages and the &kde; help files more readable.</para> -<para ->The options on this page are disabled unless you chose <guilabel ->Use accessibility stylesheet defined in "Customise"-tab</guilabel -> on the previous page.</para> +<para>The options on this page are disabled unless you chose <guilabel>Use accessibility stylesheet defined in "Customise"-tab</guilabel> on the previous page.</para> <sect3> -<title -><guilabel ->Font Family</guilabel -></title> +<title><guilabel>Font Family</guilabel></title> <variablelist> <varlistentry> -<term -><guilabel ->Base family</guilabel -></term> +<term><guilabel>Base family</guilabel></term> <listitem> -<para ->Choose a font family to use for body text.</para> +<para>Choose a font family to use for body text.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Use same family for all text</guilabel -></term> +<term><guilabel>Use same family for all text</guilabel></term> <listitem> -<para ->If you enable this, then the same font family will be used for all text, regardless of the settings on the page you are viewing. This is useful for pages which have used a decorative or hard to read font for headlines.</para> +<para>If you enable this, then the same font family will be used for all text, regardless of the settings on the page you are viewing. This is useful for pages which have used a decorative or hard to read font for headlines.</para> </listitem> </varlistentry> </variablelist> </sect3> <sect3> -<title ->Font Size</title> +<title>Font Size</title> <variablelist> <varlistentry> -<term -><guilabel ->Base Font Size</guilabel -></term> +<term><guilabel>Base Font Size</guilabel></term> <listitem> -<para ->This is the default size for text on the page. Many web sites set their font sizes relative to this default, using <quote ->larger</quote -> or <quote ->+1</quote -> to make the text bigger, and <quote ->smaller</quote -> or <quote ->-1</quote -> to make the text smaller.</para> -<para ->Many people design their web pages on platforms where the ordinary default text size is too large for the average user to read, so it is very common to come across web pages that have forced the font smaller in this way.</para> -<para ->This setting will allow you to set the default font to a comfortable size, so that the relative sizes are also enlarged enough to be comfortable.</para> -<para ->Do not forget you can also have &konqueror; enforce a minimum size, so that text is <emphasis ->never</emphasis -> too small to read. Set that under Behaviour, in the Web Browser section in &kcontrol;.</para> +<para>This is the default size for text on the page. Many web sites set their font sizes relative to this default, using <quote>larger</quote> or <quote>+1</quote> to make the text bigger, and <quote>smaller</quote> or <quote>-1</quote> to make the text smaller.</para> +<para>Many people design their web pages on platforms where the ordinary default text size is too large for the average user to read, so it is very common to come across web pages that have forced the font smaller in this way.</para> +<para>This setting will allow you to set the default font to a comfortable size, so that the relative sizes are also enlarged enough to be comfortable.</para> +<para>Do not forget you can also have &konqueror; enforce a minimum size, so that text is <emphasis>never</emphasis> too small to read. Set that under Behaviour, in the Web Browser section in &kcontrol;.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Use same size for all elements</guilabel -></term> +<term><guilabel>Use same size for all elements</guilabel></term> <listitem> -<para ->If you enable this option, then all text will be rendered at your specified font size, regardless of the instructions the page contains. Relative font sizes as discussed earlier, and even specific instructions that text should be rendered at a certain size will be overridden here.</para> +<para>If you enable this option, then all text will be rendered at your specified font size, regardless of the instructions the page contains. Relative font sizes as discussed earlier, and even specific instructions that text should be rendered at a certain size will be overridden here.</para> </listitem> </varlistentry> </variablelist> </sect3> <sect3> -<title ->Colours</title> +<title>Colours</title> <variablelist> <varlistentry> -<term -><guilabel ->Black on White</guilabel -></term> +<term><guilabel>Black on White</guilabel></term> <listitem> -<para ->Many people with reduced vision find black text on a white screen gives the most contrast, and is easiest to read. If this applies to you, you can set this here.</para> +<para>Many people with reduced vision find black text on a white screen gives the most contrast, and is easiest to read. If this applies to you, you can set this here.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->White on Black</guilabel -></term> +<term><guilabel>White on Black</guilabel></term> <listitem> -<para ->Many other people with reduced vision find the opposite to be true, that white text on a black screen is easier to read.</para> +<para>Many other people with reduced vision find the opposite to be true, that white text on a black screen is easier to read.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Custom</guilabel -></term> +<term><guilabel>Custom</guilabel></term> <listitem> -<para ->Still other people find that pure black and white, in either order, is difficult to read. You can set custom colours here for both the <guilabel ->Background</guilabel -> and the <guilabel ->Foreground</guilabel ->.</para> +<para>Still other people find that pure black and white, in either order, is difficult to read. You can set custom colours here for both the <guilabel>Background</guilabel> and the <guilabel>Foreground</guilabel>.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Use same colour for all text</guilabel -></term> +<term><guilabel>Use same colour for all text</guilabel></term> <listitem> -<para ->Many web sites use a different, often contrasting colour for headings or other flourishes. If this interferes with your ability to read the content, you can enable this checkbox to have &kde; use the colours you have set above for all text.</para> +<para>Many web sites use a different, often contrasting colour for headings or other flourishes. If this interferes with your ability to read the content, you can enable this checkbox to have &kde; use the colours you have set above for all text.</para> </listitem> </varlistentry> </variablelist> @@ -281,29 +158,19 @@ </sect3> <sect3> -<title ->Images</title> +<title>Images</title> <variablelist> <varlistentry> -<term -><guilabel ->Suppress images</guilabel -></term> +<term><guilabel>Suppress images</guilabel></term> <listitem> -<para ->If you do not want to view images, you can turn this off here.</para -></listitem> +<para>If you do not want to view images, you can turn this off here.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Suppress background images</guilabel -></term> +<term><guilabel>Suppress background images</guilabel></term> <listitem> -<para ->One major problem for reduced vision users is that background images do not give sufficient contrast to allow them to read the text. You can disable background images here, independently of your choice above to view all images.</para> +<para>One major problem for reduced vision users is that background images do not give sufficient contrast to allow them to read the text. You can disable background images here, independently of your choice above to view all images.</para> </listitem> </varlistentry> </variablelist> @@ -311,19 +178,13 @@ </sect3> <sect3> -<title ->Preview</title> +<title>Preview</title> -<para ->The <guibutton ->Preview</guibutton -> allows you to see the effect of your changes. A window will pop up, showing how several types of headings will appear with your stylesheet, and a sentence in the default body text.</para> +<para>The <guibutton>Preview</guibutton> allows you to see the effect of your changes. A window will pop up, showing how several types of headings will appear with your stylesheet, and a sentence in the default body text.</para> -<para ->This should allow you to fine tune your stylesheet until you have something that you can comfortably read.</para> +<para>This should allow you to fine tune your stylesheet until you have something that you can comfortably read.</para> -<para ->Happy surfing!</para> +<para>Happy surfing!</para> </sect3> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmfontinst/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmfontinst/index.docbook index 882d3a14a6e..f5211c2a084 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmfontinst/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmfontinst/index.docbook @@ -2,113 +2,49 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Craig.Drummond; &Craig.Drummond.Mail;</author> +<author>&Craig.Drummond; &Craig.Drummond.Mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-22</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-22</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->fonts</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>fonts</keyword> </keywordset> </articleinfo> <sect1 id="fontinst"> -<title ->Font Installer</title> +<title>Font Installer</title> -<para ->This module is responsible for installing (and uninstalling) fonts. The installer will configure X (XFree86), XRender, (anti-aliasing), and <application ->Ghostscript</application -> (printing), for any TrueType (<literal role="extension" ->.ttf</literal ->) and Type1 (<literal role="extension" ->.pfa</literal ->, <literal role="extension" ->.pfb</literal ->) fonts that you care to install - bitmap (<literal role="extension" ->.bdf</literal ->, <literal role="extension" ->.pcf</literal ->, <literal role="extension" ->.snf</literal ->), and Speedo (<literal role="extension" ->.spd</literal ->), fonts will also be installed, but these can only used by X.</para> +<para>This module is responsible for installing (and uninstalling) fonts. The installer will configure X (XFree86), XRender, (anti-aliasing), and <application>Ghostscript</application> (printing), for any TrueType (<literal role="extension">.ttf</literal>) and Type1 (<literal role="extension">.pfa</literal>, <literal role="extension">.pfb</literal>) fonts that you care to install - bitmap (<literal role="extension">.bdf</literal>, <literal role="extension">.pcf</literal>, <literal role="extension">.snf</literal>), and Speedo (<literal role="extension">.spd</literal>), fonts will also be installed, but these can only used by X.</para> -<para ->When the module is started by a normal (non-root) user, then the settings will refer to their personal configuration, and installed fonts will be available to them only. For <systemitem class="username" ->root</systemitem ->, the settings will usually refer to the system-wide configuration, and as such any installed fonts should be available to all users.</para> -<para ->If you install fonts as a normal user and notice the fonts used for display (and for print preview) do not match those of the printed output - then you should re-install the fonts system-wide (i.e. as <systemitem class="username" ->root</systemitem ->). This can occur because when printing the output is sent to a printer queue - and when the system comes to actually send the information to the printer, it is running as a different user (usually <systemitem class="username" ->lp</systemitem ->), and cannot find the font files.</para> -<para ->To install fonts, simply select the "Add Fonts" button - this will produce a file dialogue, then just locate the fonts to install. Likewise, to remove a font, simply highlight a font and press the "Delete" button.</para> -<para ->Fonts may also be "disabled" - this basically just "hides" the font file, so that the font system cannot "see" it. To enable/disable fonts, just highlight the required fonts, and select the "Enable" or "Disable" button. </para> +<para>When the module is started by a normal (non-root) user, then the settings will refer to their personal configuration, and installed fonts will be available to them only. For <systemitem class="username">root</systemitem>, the settings will usually refer to the system-wide configuration, and as such any installed fonts should be available to all users.</para> +<para>If you install fonts as a normal user and notice the fonts used for display (and for print preview) do not match those of the printed output - then you should re-install the fonts system-wide (i.e. as <systemitem class="username">root</systemitem>). This can occur because when printing the output is sent to a printer queue - and when the system comes to actually send the information to the printer, it is running as a different user (usually <systemitem class="username">lp</systemitem>), and cannot find the font files.</para> +<para>To install fonts, simply select the "Add Fonts" button - this will produce a file dialogue, then just locate the fonts to install. Likewise, to remove a font, simply highlight a font and press the "Delete" button.</para> +<para>Fonts may also be "disabled" - this basically just "hides" the font file, so that the font system cannot "see" it. To enable/disable fonts, just highlight the required fonts, and select the "Enable" or "Disable" button. </para> <sect2 id="using-konqueror"> -<title ->Using Konqueror</title> -<para ->You can also use Konqueror to install fonts via drag-and-drop. To do this just type <ulink url="fonts:/" ->fonts:/</ulink -> into Konqueror's Location bar.</para> -<para ->As a normal (non-root) user, this will produce 2 top-level folders:</para> +<title>Using Konqueror</title> +<para>You can also use Konqueror to install fonts via drag-and-drop. To do this just type <ulink url="fonts:/">fonts:/</ulink> into Konqueror's Location bar.</para> +<para>As a normal (non-root) user, this will produce 2 top-level folders:</para> <orderedlist> <listitem> -<para -><ulink url="fonts:/Personal" ->Personal</ulink -> - this will display your personal fonts.</para> +<para><ulink url="fonts:/Personal">Personal</ulink> - this will display your personal fonts.</para> </listitem> <listitem> -<para -><ulink url="fonts:/System" ->System</ulink -> - this will display the system wide fonts. If you drag-n-drop a font on to the folders here, you will be asked for the root password in order to install the font.</para> +<para><ulink url="fonts:/System">System</ulink> - this will display the system wide fonts. If you drag-n-drop a font on to the folders here, you will be asked for the root password in order to install the font.</para> </listitem> </orderedlist> -<para ->If you drop a font over <ulink url="fonts:/" ->fonts:/</ulink ->, then you will be asked whether this should go into "Personal", or "System".</para> -<para ->As root, just the contents of the system font folder will be displayed - as root does not have any "personal" fonts.</para> +<para>If you drop a font over <ulink url="fonts:/">fonts:/</ulink>, then you will be asked whether this should go into "Personal", or "System".</para> +<para>As root, just the contents of the system font folder will be displayed - as root does not have any "personal" fonts.</para> </sect2> </sect1> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmkonsole/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmkonsole/index.docbook index 0626c66b40d..a1dcd8fe5f1 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmkonsole/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmkonsole/index.docbook @@ -2,8 +2,7 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> @@ -11,257 +10,139 @@ <authorgroup> -<author ->&Jonathan.Singer; &Jonathan.Singer.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Jonathan.Singer; &Jonathan.Singer.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->konsole</keyword> -<keyword ->terminal</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>konsole</keyword> +<keyword>terminal</keyword> </keywordset> </articleinfo> <sect1 id="konsole"> -<title ->&konsole;</title> +<title>&konsole;</title> -<para ->In this module, you can configure basic settings for &konsole;, the &kde; terminal. You can also easily create new schemata (appearance files) for &konsole;.</para> +<para>In this module, you can configure basic settings for &konsole;, the &kde; terminal. You can also easily create new schemata (appearance files) for &konsole;.</para> -<para ->This module contains several tab pages: <guilabel ->General</guilabel ->, <guilabel ->Schema</guilabel ->, <guilabel ->Session</guilabel -> and <guilabel ->Write Daemon</guilabel ->.</para> +<para>This module contains several tab pages: <guilabel>General</guilabel>, <guilabel>Schema</guilabel>, <guilabel>Session</guilabel> and <guilabel>Write Daemon</guilabel>.</para> <sect2> -<title -><guilabel ->General</guilabel -></title> +<title><guilabel>General</guilabel></title> -<para ->This tab page allows you to configure aspects of &konsole;'s functions. It contains the following options:</para> +<para>This tab page allows you to configure aspects of &konsole;'s functions. It contains the following options:</para> <variablelist> <varlistentry> -<term -><guilabel ->Use Konsole as default terminal application</guilabel -></term> +<term><guilabel>Use Konsole as default terminal application</guilabel></term> <listitem> -<para ->If you wish to have &kde; use another terminal application by default, uncheck this box and enter the preferred application (<application ->wterm</application ->, <application ->rxvt</application ->, &etc;) in the text field below.</para> +<para>If you wish to have &kde; use another terminal application by default, uncheck this box and enter the preferred application (<application>wterm</application>, <application>rxvt</application>, &etc;) in the text field below.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Show Terminal Size when Resizing</guilabel -></term> +<term><guilabel>Show Terminal Size when Resizing</guilabel></term> <listitem> -<para ->By default, &konsole; will show the size (in characters) of the window when you are resizing, allowing you to make the window a specific size. Uncheck this box to turn off this behaviour.</para -></listitem> +<para>By default, &konsole; will show the size (in characters) of the window when you are resizing, allowing you to make the window a specific size. Uncheck this box to turn off this behaviour.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Show Frame</guilabel -></term> +<term><guilabel>Show Frame</guilabel></term> <listitem> -<para ->Draw an inner frame around the inside of the &konsole; window.</para> +<para>Draw an inner frame around the inside of the &konsole; window.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Confirm quit with open sessions</guilabel -></term> +<term><guilabel>Confirm quit with open sessions</guilabel></term> <listitem> -<para ->When set, a warning appears when you try to close a &konsole; window with multiple sessions.</para> +<para>When set, a warning appears when you try to close a &konsole; window with multiple sessions.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Blinking Cursor</guilabel -></term> -<listitem -><para ->If you have trouble spotting the cursor in the &konsole; window, you can have it blink to draw your attention.</para -></listitem> +<term><guilabel>Blinking Cursor</guilabel></term> +<listitem><para>If you have trouble spotting the cursor in the &konsole; window, you can have it blink to draw your attention.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Line Spacing</guilabel -></term> -<listitem -><para ->Change the space between lines of text.</para> +<term><guilabel>Line Spacing</guilabel></term> +<listitem><para>Change the space between lines of text.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Consider the following characters part of a word when double clicking</guilabel -></term> -<listitem -><para ->It is a common &UNIX; behaviour to select a whole word when you double click on it, however, the computer's idea of a word may differ from yours. Add characters here that you would like to be considered always to be <quote ->part of a word</quote ->. For example, adding the <literal ->@</literal -> character will allow you to double click to select an entire email address.</para -></listitem> +<term><guilabel>Consider the following characters part of a word when double clicking</guilabel></term> +<listitem><para>It is a common &UNIX; behaviour to select a whole word when you double click on it, however, the computer's idea of a word may differ from yours. Add characters here that you would like to be considered always to be <quote>part of a word</quote>. For example, adding the <literal>@</literal> character will allow you to double click to select an entire email address.</para></listitem> </varlistentry> </variablelist> </sect2> <sect2> -<title ->Schema</title> +<title>Schema</title> -<para ->The <guilabel ->Schema</guilabel -> page will allow you to easily create, edit and save schemata, with text and background colouring, transparency and background images.</para> +<para>The <guilabel>Schema</guilabel> page will allow you to easily create, edit and save schemata, with text and background colouring, transparency and background images.</para> <!-- <variablelist> <varlistentry> -<term -><guilabel ->Font</guilabel -></term> +<term><guilabel>Font</guilabel></term> <listitem> -<para ->Use the drop-down box to select the default font size. Use the -<guibutton ->Custom...</guibutton -> button to select your own combination +<para>Use the drop-down box to select the default font size. Use the +<guibutton>Custom...</guibutton> button to select your own combination of font, size, and style.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Full Screen</guilabel -></term> +<term><guilabel>Full Screen</guilabel></term> <listitem> -<para ->Check the box to make &konsole; windows full-screen by +<para>Check the box to make &konsole; windows full-screen by default.</para> </listitem> </varlistentry> </variablelist> -</listitem -> +</listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Bars</guilabel -></term> +<term><guilabel>Bars</guilabel></term> <listitem> <variablelist> <varlistentry> -<term -><guilabel ->Show menubar</guilabel -></term> +<term><guilabel>Show menubar</guilabel></term> <listitem> -<para ->Check to show the menubar by default.</para> +<para>Check to show the menubar by default.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Show toolbar</guilabel -></term> +<term><guilabel>Show toolbar</guilabel></term> <listitem> -<para ->Check to show the toolbar by default.</para> +<para>Check to show the toolbar by default.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Show frame</guilabel -></term> +<term><guilabel>Show frame</guilabel></term> <listitem> -<para ->Check to show the frame by default.</para> +<para>Check to show the frame by default.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Scrollbar position</guilabel -></term> +<term><guilabel>Scrollbar position</guilabel></term> <listitem> -<para ->Select the default position of the scrollbar: -<guilabel ->Hide</guilabel -> (no scrollbar), <guilabel ->Left</guilabel ->, or -<guilabel ->Right</guilabel ->.</para> +<para>Select the default position of the scrollbar: +<guilabel>Hide</guilabel> (no scrollbar), <guilabel>Left</guilabel>, or +<guilabel>Right</guilabel>.</para> </listitem> </varlistentry> </variablelist> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmlaunch/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmlaunch/index.docbook index b9173626e56..f0a19134cb6 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmlaunch/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmlaunch/index.docbook @@ -2,86 +2,44 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-09-22</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-09-22</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->launch feedback</keyword> -<keyword ->cursor</keyword> -<keyword ->busy</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>launch feedback</keyword> +<keyword>cursor</keyword> +<keyword>busy</keyword> </keywordset> </articleinfo> <sect1 id="launch-feedback"> -<title ->Launch Feedback</title> +<title>Launch Feedback</title> -<para ->Sometimes it is reassuring to know that your computer didn't just ignore your command, and something is happening behind the scenes. In this module you can configure visible feedback to help you know if you really hit that icon or not.</para> +<para>Sometimes it is reassuring to know that your computer didn't just ignore your command, and something is happening behind the scenes. In this module you can configure visible feedback to help you know if you really hit that icon or not.</para> -<para ->The traditional way to indicate that your computer is busy is to modify the cursor, and you can turn this on by choosing a <guilabel ->Busy Cursor</guilabel -> checkbox.</para> +<para>The traditional way to indicate that your computer is busy is to modify the cursor, and you can turn this on by choosing a <guilabel>Busy Cursor</guilabel> checkbox.</para> -<para ->With this option enabled, your cursor will have an icon attached to it for a short time, when a new application is being launched. You can configure how long this icon is displayed beside your cursor with the <guilabel ->Startup indication timeout (seconds):</guilabel -> spinbox. The default is 30 seconds.</para> +<para>With this option enabled, your cursor will have an icon attached to it for a short time, when a new application is being launched. You can configure how long this icon is displayed beside your cursor with the <guilabel>Startup indication timeout (seconds):</guilabel> spinbox. The default is 30 seconds.</para> -<para ->There are several variations of busy cursor available, including a blinking cursor, a bouncing cursor or a passive icon with no animation.</para> +<para>There are several variations of busy cursor available, including a blinking cursor, a bouncing cursor or a passive icon with no animation.</para> -<para ->Traditional &kde; launch notification has taken another form, which you can also enable and disable here. Normally when you start an application, it gets an immediate entry in the taskbar, with the icon replaced by a spinning hourglass to let you know something is happening. You can toggle this behaviour on and off with the <guilabel ->Enable Taskbar Notification</guilabel -> checkbox, and when it's enabled, you can set a time in the <guilabel ->Startup indication timeout (seconds):</guilabel -> spinbox.</para> +<para>Traditional &kde; launch notification has taken another form, which you can also enable and disable here. Normally when you start an application, it gets an immediate entry in the taskbar, with the icon replaced by a spinning hourglass to let you know something is happening. You can toggle this behaviour on and off with the <guilabel>Enable Taskbar Notification</guilabel> checkbox, and when it's enabled, you can set a time in the <guilabel>Startup indication timeout (seconds):</guilabel> spinbox.</para> -<para ->Not all applications that you start will eventually show a window, or an entry in the taskbar. Some of them, for example, are docked into the &kde; system tray. Alternatively, it might be that you sent it off to a different virtual desktop, and <quote ->Show all windows</quote -> is unchecked in the &kcontrolcenter; module <guimenuitem ->Taskbar</guimenuitem ->. Setting a timeout ensures that, even in these cases, you can still get launch feedback, but also that it will go away when the job is done.</para> +<para>Not all applications that you start will eventually show a window, or an entry in the taskbar. Some of them, for example, are docked into the &kde; system tray. Alternatively, it might be that you sent it off to a different virtual desktop, and <quote>Show all windows</quote> is unchecked in the &kcontrolcenter; module <guimenuitem>Taskbar</guimenuitem>. Setting a timeout ensures that, even in these cases, you can still get launch feedback, but also that it will go away when the job is done.</para> </sect1> </article>
\ No newline at end of file diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmnotify/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmnotify/index.docbook index 7ebe5b1ce1f..3e94eba9142 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmnotify/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmnotify/index.docbook @@ -2,143 +2,69 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->system notification</keyword> -<keyword ->notification</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>system notification</keyword> +<keyword>notification</keyword> </keywordset> </articleinfo> <sect1 id="sys-notify"> -<title ->System Notification Settings</title> +<title>System Notification Settings</title> -<para ->&kde;, like all applications, needs to inform the user when a problem occurs, a task is completed, or something has happened. &kde; uses a set of <quote ->System Notifications</quote -> to keep the user informed on what is happening.</para> +<para>&kde;, like all applications, needs to inform the user when a problem occurs, a task is completed, or something has happened. &kde; uses a set of <quote>System Notifications</quote> to keep the user informed on what is happening.</para> -<para ->Using this module, you can determine what &kde; does to communicate each event.</para> +<para>Using this module, you can determine what &kde; does to communicate each event.</para> -<para ->The panel consists of a large list of specific events which need to be communicated to the user. This list is organised into a tree, so that you can rapidly find the notification you are looking for.</para> +<para>The panel consists of a large list of specific events which need to be communicated to the user. This list is organised into a tree, so that you can rapidly find the notification you are looking for.</para> -<para ->To configure a notification, simply click on a group, which will open up a subgroup. You can click on subgroups, which may lead to more subgroups, or it may lead to a list of notifications.</para> +<para>To configure a notification, simply click on a group, which will open up a subgroup. You can click on subgroups, which may lead to more subgroups, or it may lead to a list of notifications.</para> -<para ->Once you have found the notification you are looking for, double-click on the notification.</para> +<para>Once you have found the notification you are looking for, double-click on the notification.</para> -<para ->You will be presented with 4 options:</para> +<para>You will be presented with 4 options:</para> <variablelist> <varlistentry> -<term -><guilabel ->Log to file</guilabel -></term> -<listitem -><para ->This will tell &kde; to add the notification to the end of a file. Once you place a mark in front of this option, you can enter a filename at the bottom of the module. If you click on the <guiicon ->folder</guiicon -> to the right of the blank, you can browse through your filesystem and select the file you want.</para -></listitem> +<term><guilabel>Log to file</guilabel></term> +<listitem><para>This will tell &kde; to add the notification to the end of a file. Once you place a mark in front of this option, you can enter a filename at the bottom of the module. If you click on the <guiicon>folder</guiicon> to the right of the blank, you can browse through your filesystem and select the file you want.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Play sound</guilabel -></term> -<listitem -><para ->When this notification is activated, &kde; will play a sound. Once you place a mark in front of this option, you can enter a filename at the bottom of the module. </para> -<para ->If you click on the <guiicon ->folder</guiicon -> to the right of the blank, you can browse through your filesystem and select the file you want.</para> -<para ->By clicking the arrow button to the right of the <guiicon ->folder</guiicon -> button, you can hear the sound.</para> - -<para ->Maybe you want to use a special media player to play sound files, ⪚ because you use sound files in a special format or you don't use the &arts; sound daemon. In that case, check the <guilabel ->Use external player</guilabel -> option and enter the full path and name of the program you want to use into the text field.</para -></listitem> +<term><guilabel>Play sound</guilabel></term> +<listitem><para>When this notification is activated, &kde; will play a sound. Once you place a mark in front of this option, you can enter a filename at the bottom of the module. </para> +<para>If you click on the <guiicon>folder</guiicon> to the right of the blank, you can browse through your filesystem and select the file you want.</para> +<para>By clicking the arrow button to the right of the <guiicon>folder</guiicon> button, you can hear the sound.</para> + +<para>Maybe you want to use a special media player to play sound files, ⪚ because you use sound files in a special format or you don't use the &arts; sound daemon. In that case, check the <guilabel>Use external player</guilabel> option and enter the full path and name of the program you want to use into the text field.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Show messagebox</guilabel -></term> -<listitem -><para ->When this notification is activated, a message box appears in the middle of the screen to inform the user of the message.</para -></listitem> +<term><guilabel>Show messagebox</guilabel></term> +<listitem><para>When this notification is activated, a message box appears in the middle of the screen to inform the user of the message.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Standard error output</guilabel -></term> -<listitem -><para ->When this notification is activated, the message is sent to the standard output.</para -></listitem> +<term><guilabel>Standard error output</guilabel></term> +<listitem><para>When this notification is activated, the message is sent to the standard output.</para></listitem> </varlistentry> </variablelist> -<tip -><para ->You are not limited to choosing one option, you can use any combination of these four options for each notification.</para -></tip> - -<para ->You can turn off (or on) all sounds at once, for all installed applications, with the <guibutton ->Enable All Sounds</guibutton -> or <guibutton ->Disable All Sounds</guibutton -> Button. Which of these you see depends on the current status.</para> +<tip><para>You are not limited to choosing one option, you can use any combination of these four options for each notification.</para></tip> + +<para>You can turn off (or on) all sounds at once, for all installed applications, with the <guibutton>Enable All Sounds</guibutton> or <guibutton>Disable All Sounds</guibutton> Button. Which of these you see depends on the current status.</para> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmsmserver/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmsmserver/index.docbook index 7bac2d4cff6..78f911433ae 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmsmserver/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmsmserver/index.docbook @@ -2,149 +2,79 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Jost.Schenck; &Jost.Schenck.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Jost.Schenck; &Jost.Schenck.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-13</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-13</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->session</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>session</keyword> </keywordset> </articleinfo> <sect1 id="sessions"> -<title ->Session Manager</title> +<title>Session Manager</title> <sect2 id="sessions-use"> -<title ->Use</title> +<title>Use</title> -<para ->In this control module you can configure &kde;'s session manager.</para> +<para>In this control module you can configure &kde;'s session manager.</para> -<para ->Session management refers to &kde;'s ability to save the state of applications and windows when you log out of &kde; and restore them when you log back in.</para> +<para>Session management refers to &kde;'s ability to save the state of applications and windows when you log out of &kde; and restore them when you log back in.</para> -<para ->The <guilabel ->General</guilabel -> section contains one setting:</para> +<para>The <guilabel>General</guilabel> section contains one setting:</para> <variablelist> <varlistentry> -<term -><guilabel ->Confirm logout</guilabel -></term> +<term><guilabel>Confirm logout</guilabel></term> <listitem> -<para ->If this option is checked, when logging out, &kde; will display a dialogue asking for confirmation. In this dialogue you can also choose whether you want to restore your current session when you login the next time.</para> +<para>If this option is checked, when logging out, &kde; will display a dialogue asking for confirmation. In this dialogue you can also choose whether you want to restore your current session when you login the next time.</para> </listitem> </varlistentry> </variablelist> -<para ->You may choose one of three options on what should happen when you log into &kde;:</para> +<para>You may choose one of three options on what should happen when you log into &kde;:</para> <variablelist> <varlistentry> -<term -><guilabel ->Restore previous session</guilabel -></term> -<listitem -><para ->If this option is checked, &kde; will save your current session's state when you logout. &kde; will restore your session on the next login, so you can continue to work with a desktop just like you left it.</para> +<term><guilabel>Restore previous session</guilabel></term> +<listitem><para>If this option is checked, &kde; will save your current session's state when you logout. &kde; will restore your session on the next login, so you can continue to work with a desktop just like you left it.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Restore manually saved session</guilabel -></term> -<listitem -><para ->Instead of restoring &kde; to the state it was when you logged out last, it will be restored to a specific state that you have saved manually. </para -></listitem> +<term><guilabel>Restore manually saved session</guilabel></term> +<listitem><para>Instead of restoring &kde; to the state it was when you logged out last, it will be restored to a specific state that you have saved manually. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Start with an empty session</guilabel -></term> +<term><guilabel>Start with an empty session</guilabel></term> <listitem> -<para ->If you choose this option, &kde; will never restore sessions that it has saved.</para> +<para>If you choose this option, &kde; will never restore sessions that it has saved.</para> </listitem> </varlistentry> </variablelist> -<para ->You can configure what should happen by default when you log out of &kde;. These options are not possible on all operating systems, and they require the use of &tdm; as your login manager. </para> +<para>You can configure what should happen by default when you log out of &kde;. These options are not possible on all operating systems, and they require the use of &tdm; as your login manager. </para> -<para ->The options available are self explanatory, if you are in doubt, leave the default settings. They are:</para> +<para>The options available are self explanatory, if you are in doubt, leave the default settings. They are:</para> <itemizedlist> -<listitem -><para -><guilabel ->Login as different user</guilabel -> (this is the default)</para -></listitem> -<listitem -><para -><guilabel ->Turn off computer</guilabel -></para -></listitem> -<listitem -><para -><guilabel ->Restart computer</guilabel -></para -></listitem> +<listitem><para><guilabel>Login as different user</guilabel> (this is the default)</para></listitem> +<listitem><para><guilabel>Turn off computer</guilabel></para></listitem> +<listitem><para><guilabel>Restart computer</guilabel></para></listitem> </itemizedlist> -<para ->Finally, you can enter a colon (<literal ->:</literal ->) separated list of applications that should not be saved in sessions, and therefore will not be started when restoring a session. For example <userinput ->xterm:konsole</userinput ->.</para> +<para>Finally, you can enter a colon (<literal>:</literal>) separated list of applications that should not be saved in sessions, and therefore will not be started when restoring a session. For example <userinput>xterm:konsole</userinput>.</para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmstyle/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmstyle/index.docbook index 5d05a331969..a1961c33027 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmstyle/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmstyle/index.docbook @@ -2,321 +2,137 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-09-22</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-09-22</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->style</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>style</keyword> </keywordset> </articleinfo> <sect1 id="style"> -<title ->Style</title> +<title>Style</title> <sect2 id="style-intro"> -<title ->Introduction</title> - -<para ->This module is used to configure how the individual widgets are drawn by &kde;.</para> - -<note -><para ->A <emphasis ->Widget</emphasis -> is a commonly-used programmer's term for referring to User Interface elements such as buttons, menus, and scroll bars. You can think of them as the fundamental pieces that are assembled to make your application.</para -></note> - -<para ->You can configure how the widgets are drawn with this module, but to change the colour of the widgets, you should refer to the section entitled <ulink url="help:/kcontrol/color/index.html" ->Colours</ulink ->.</para> - -<para ->This panel is divided into three tabs: <guilabel ->Style</guilabel ->, <guilabel ->Effects</guilabel ->, <guilabel ->Miscellaneous</guilabel ->.</para> +<title>Introduction</title> + +<para>This module is used to configure how the individual widgets are drawn by &kde;.</para> + +<note><para>A <emphasis>Widget</emphasis> is a commonly-used programmer's term for referring to User Interface elements such as buttons, menus, and scroll bars. You can think of them as the fundamental pieces that are assembled to make your application.</para></note> + +<para>You can configure how the widgets are drawn with this module, but to change the colour of the widgets, you should refer to the section entitled <ulink url="help:/kcontrol/color/index.html">Colours</ulink>.</para> + +<para>This panel is divided into three tabs: <guilabel>Style</guilabel>, <guilabel>Effects</guilabel>, <guilabel>Miscellaneous</guilabel>.</para> <sect3 id="style-style"> -<title -><guilabel ->Style</guilabel -> tab</title> +<title><guilabel>Style</guilabel> tab</title> -<para ->The top list box, labelled <guilabel ->Widget Style</guilabel -> contains a list of the pre-defined styles. Each style has a name, and a brief description.</para> +<para>The top list box, labelled <guilabel>Widget Style</guilabel> contains a list of the pre-defined styles. Each style has a name, and a brief description.</para> -<para ->To change styles, simply click on the style name, and a preview of the style will be displayed in the preview box below the style list.</para> +<para>To change styles, simply click on the style name, and a preview of the style will be displayed in the preview box below the style list.</para> -<para ->The other options available here are:</para> +<para>The other options available here are:</para> <variablelist> -<varlistentry -> -<term -><guilabel ->Show icons on buttons</guilabel -></term> +<varlistentry> +<term><guilabel>Show icons on buttons</guilabel></term> <listitem> -<para ->If this option is selected, action buttons (like <guibutton ->OK</guibutton -> and <guibutton ->Apply</guibutton -> will have a small icon located within them to act as a visual reference. If this option is not selected, then only the text of the button will appear in the button.</para> -</listitem -> -</varlistentry -> - -<varlistentry -> -<term -><guilabel ->Enable tooltips</guilabel -></term> +<para>If this option is selected, action buttons (like <guibutton>OK</guibutton> and <guibutton>Apply</guibutton> will have a small icon located within them to act as a visual reference. If this option is not selected, then only the text of the button will appear in the button.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Enable tooltips</guilabel></term> <listitem> -<para ->This will toggle tooltips off and on.</para> -</listitem -> -</varlistentry -> - -<varlistentry -> -<term -><guilabel ->Menubar on the top of the screen in the style of MacOS</guilabel -></term> +<para>This will toggle tooltips off and on.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Menubar on the top of the screen in the style of MacOS</guilabel></term> <listitem> -<para ->This will turn on a menubar at the top of the screen. This menubar will reflect the menu options of the active application.</para> -</listitem -> -</varlistentry -> +<para>This will turn on a menubar at the top of the screen. This menubar will reflect the menu options of the active application.</para> +</listitem> +</varlistentry> </variablelist> </sect3> <sect3 id="style-effects"> -<title -><guilabel ->Effects</guilabel -> tab</title> -<para ->If you click on the <guilabel ->Effects</guilabel -> tab, you will see the panel is divided into two sections.</para> -<para ->At the top of the first section, is a checkbox labelled <guilabel ->Enable GUI effects</guilabel ->. If there is no mark in front of this checkbox, then all visual effects of this panel are disabled. To edit any of these effects, simply place a mark in this checkbox.</para> - -<para ->Below that checkbox, are 4 combo boxes: </para> +<title><guilabel>Effects</guilabel> tab</title> +<para>If you click on the <guilabel>Effects</guilabel> tab, you will see the panel is divided into two sections.</para> +<para>At the top of the first section, is a checkbox labelled <guilabel>Enable GUI effects</guilabel>. If there is no mark in front of this checkbox, then all visual effects of this panel are disabled. To edit any of these effects, simply place a mark in this checkbox.</para> + +<para>Below that checkbox, are 4 combo boxes: </para> <variablelist> <varlistentry> -<term -><guilabel ->Combobox effects</guilabel -></term> -<listitem -><para ->This combobox has two options. If this option is set to <guilabel ->Animate</guilabel -> then when a combo box is selected, it will appear to scroll down. If <guilabel ->Disable</guilabel -> is selected, then the combobox list appears instantly.</para -></listitem> +<term><guilabel>Combobox effects</guilabel></term> +<listitem><para>This combobox has two options. If this option is set to <guilabel>Animate</guilabel> then when a combo box is selected, it will appear to scroll down. If <guilabel>Disable</guilabel> is selected, then the combobox list appears instantly.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Tool Tip Effect</guilabel -></term> -<listitem -><para ->This combobox has three options. If this option is set to <guilabel ->Animate</guilabel -> then when a tool tip appears, it will have a short animation. If <guilabel ->Fade</guilabel -> is selected, the tool tip appears to fade from the background. If <guilabel ->Disable</guilabel -> is selected, then the tool tip appears instantly.</para -></listitem> +<term><guilabel>Tool Tip Effect</guilabel></term> +<listitem><para>This combobox has three options. If this option is set to <guilabel>Animate</guilabel> then when a tool tip appears, it will have a short animation. If <guilabel>Fade</guilabel> is selected, the tool tip appears to fade from the background. If <guilabel>Disable</guilabel> is selected, then the tool tip appears instantly.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Menu Effect</guilabel -></term> -<listitem -><para ->This combobox has four options. If this option is set to <guilabel ->Animate</guilabel -> then when a menu list appears, it will appear to scroll downward. If <guilabel ->Fade</guilabel -> is selected, the menu list appears to fade from the background. If <guilabel ->Make Transparent</guilabel -> is selected, the menu list will have a transparent look to it. The details of that transparency is configured in the next part of the dialogue. If <guilabel ->Disable</guilabel -> is selected, then the menu list appears instantly.</para -></listitem> +<term><guilabel>Menu Effect</guilabel></term> +<listitem><para>This combobox has four options. If this option is set to <guilabel>Animate</guilabel> then when a menu list appears, it will appear to scroll downward. If <guilabel>Fade</guilabel> is selected, the menu list appears to fade from the background. If <guilabel>Make Transparent</guilabel> is selected, the menu list will have a transparent look to it. The details of that transparency is configured in the next part of the dialogue. If <guilabel>Disable</guilabel> is selected, then the menu list appears instantly.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Menu tear-off handles</guilabel -></term> -<listitem -><para ->If this option is set to <guilabel ->Disable</guilabel ->, then no menus can be separated from the application. If <guilabel ->Application Level</guilabel -> is selected, then it is left up to each individual application to determine which menus can be torn separated from the application.</para> -<note -><para ->Many applications do not have tear off menus. You cannot tell &kde; to force an application to allow tear off menus. This is determined by the authors of the application.</para -></note -></listitem> +<term><guilabel>Menu tear-off handles</guilabel></term> +<listitem><para>If this option is set to <guilabel>Disable</guilabel>, then no menus can be separated from the application. If <guilabel>Application Level</guilabel> is selected, then it is left up to each individual application to determine which menus can be torn separated from the application.</para> +<note><para>Many applications do not have tear off menus. You cannot tell &kde; to force an application to allow tear off menus. This is determined by the authors of the application.</para></note></listitem> </varlistentry> </variablelist> -<para ->The next checkbox, labelled <guilabel ->Menu drop shadow</guilabel -> is used to toggle the drop shadow behind all &kde; menus. A drop shadow is a dark, soft line on the bottom and right sides of the menu, which give the menus the appearance that the menu is lifted off the application, and the menu is creating a shadow on the application.</para> +<para>The next checkbox, labelled <guilabel>Menu drop shadow</guilabel> is used to toggle the drop shadow behind all &kde; menus. A drop shadow is a dark, soft line on the bottom and right sides of the menu, which give the menus the appearance that the menu is lifted off the application, and the menu is creating a shadow on the application.</para> -<para ->The next section only applies if the combobox labelled <guilabel ->Menu Effect</guilabel -> is set to <guilabel ->Make Transparent</guilabel ->. You can use the combo box labelled <guilabel ->Menu transparency type</guilabel -> to select the method &kde; uses to generate the transparency. You can use the slider to determine the level of transparency in menus. A preview is visible on the right side of this section.</para> +<para>The next section only applies if the combobox labelled <guilabel>Menu Effect</guilabel> is set to <guilabel>Make Transparent</guilabel>. You can use the combo box labelled <guilabel>Menu transparency type</guilabel> to select the method &kde; uses to generate the transparency. You can use the slider to determine the level of transparency in menus. A preview is visible on the right side of this section.</para> </sect3> <sect3 id="style-misc"> -<title -><guilabel ->Miscellaneous</guilabel -> tab</title> - -<para ->This small section has six options.</para> - -<variablelist -> - -<varlistentry -> -<term -><guilabel ->Highlight buttons under mouse.</guilabel -></term> +<title><guilabel>Miscellaneous</guilabel> tab</title> + +<para>This small section has six options.</para> + +<variablelist> + +<varlistentry> +<term><guilabel>Highlight buttons under mouse.</guilabel></term> <listitem> -<para ->If there is a mark in this checkbox, when the mouse pointer is above a toolbar button, that button will be highlighted with a square around the button. This is a good visual indicator of which button will be selected with a mouse click.</para> -</listitem -> -</varlistentry -> - -<varlistentry -> -<term -><guilabel ->Transparent toolbars when moving</guilabel -></term> +<para>If there is a mark in this checkbox, when the mouse pointer is above a toolbar button, that button will be highlighted with a square around the button. This is a good visual indicator of which button will be selected with a mouse click.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Transparent toolbars when moving</guilabel></term> <listitem> -<para ->As the title suggests, if this option is selected, the toolbars will be transparent when you are moving them around on the screen.</para> -</listitem -> -</varlistentry -> - -<varlistentry -> -<term -><guilabel ->Text position</guilabel -></term> +<para>As the title suggests, if this option is selected, the toolbars will be transparent when you are moving them around on the screen.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Text position</guilabel></term> <listitem> -<para ->This combo box lets you determine where on the button the text name of the button will appear as the default. If <guilabel ->Icon Only</guilabel -> is selected, then there is no text on the tool bar buttons. If <guilabel ->Text Only</guilabel -> is selected, then the buttons icon is replaced with a text name of the button. If <guilabel ->Text Alongside Icons</guilabel -> is selected, then the name of the button will be placed to the <emphasis ->right</emphasis -> of the icon. If <guilabel ->Text Under Icons</guilabel -> is selected, the default will be to have the text of the button <emphasis ->below</emphasis -> the icon.</para> -<tip -><para ->This option only specifies the <emphasis ->default</emphasis -> location. Each application can override the setting used in this panel.</para -></tip> -</listitem -> -</varlistentry -> +<para>This combo box lets you determine where on the button the text name of the button will appear as the default. If <guilabel>Icon Only</guilabel> is selected, then there is no text on the tool bar buttons. If <guilabel>Text Only</guilabel> is selected, then the buttons icon is replaced with a text name of the button. If <guilabel>Text Alongside Icons</guilabel> is selected, then the name of the button will be placed to the <emphasis>right</emphasis> of the icon. If <guilabel>Text Under Icons</guilabel> is selected, the default will be to have the text of the button <emphasis>below</emphasis> the icon.</para> +<tip><para>This option only specifies the <emphasis>default</emphasis> location. Each application can override the setting used in this panel.</para></tip> +</listitem> +</varlistentry> </variablelist> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmtaskbar/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmtaskbar/index.docbook index 326f9102474..3858ec96524 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmtaskbar/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmtaskbar/index.docbook @@ -2,174 +2,92 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-10-08</date> -<releaseinfo ->3.2</releaseinfo> +<date>2002-10-08</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->taskbar</keyword> -<keyword ->configure</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>taskbar</keyword> +<keyword>configure</keyword> </keywordset> </articleinfo> <sect1 id="taskbar"> -<title ->Taskbar</title> +<title>Taskbar</title> <sect2> -<title -><guilabel ->Taskbar</guilabel -></title> - -<para ->The taskbar is a quick way to switch between applications. The taskbar can be located in the panel (default), or outside the panel on the desktop.</para> - -<para ->This module has options to control how the taskbar operates:</para> - -<para -><guilabel ->Show windows from all desktops</guilabel ->, determines if all open windows are included in the taskbar or not. By default, the taskbar only shows the open windows <emphasis ->on the current desktop</emphasis ->. If this option is enabled, the taskbar will show all open windows <emphasis ->on all desktops</emphasis ->.</para> - -<para ->Using the <guilabel ->Show window list button</guilabel -> option, you can enable a little button to be shown in the taskbar: this button will open a popup menu offering access to applications on other desktops as well as some useful actions, like <guilabel ->Unclutter Windows</guilabel ->.</para> - -<para -><guilabel ->Sort tasks by virtual desktop</guilabel -> changes the sort order of the icons on the taskbar, so that windows on virtual desktop 1 are shown first (to the left, or at the top of the taskbar), followed by windows on virtual desktop 2, and so on.</para> - -<para ->You can disable the application icons, and show just the text. You might want to do this to save space on your taskbar, for example.</para> - -<para ->You can have the taskbar <guilabel ->Show only minimised windows</guilabel ->. In this case, when you minimise a window, it will show up on the taskbar, and when you open it again, its taskbar entry will disappear.</para> - -<para -><guilabel ->Group similar tasks</guilabel -> allows you to save some space on your taskbar, by only showing one icon for each running application, no matter how many windows are shown. You can click on the icon to display a menu of all the windows that are available. This is most useful when you have enabled <guilabel ->Show all windows</guilabel ->.</para> +<title><guilabel>Taskbar</guilabel></title> + +<para>The taskbar is a quick way to switch between applications. The taskbar can be located in the panel (default), or outside the panel on the desktop.</para> + +<para>This module has options to control how the taskbar operates:</para> + +<para><guilabel>Show windows from all desktops</guilabel>, determines if all open windows are included in the taskbar or not. By default, the taskbar only shows the open windows <emphasis>on the current desktop</emphasis>. If this option is enabled, the taskbar will show all open windows <emphasis>on all desktops</emphasis>.</para> + +<para>Using the <guilabel>Show window list button</guilabel> option, you can enable a little button to be shown in the taskbar: this button will open a popup menu offering access to applications on other desktops as well as some useful actions, like <guilabel>Unclutter Windows</guilabel>.</para> + +<para><guilabel>Sort tasks by virtual desktop</guilabel> changes the sort order of the icons on the taskbar, so that windows on virtual desktop 1 are shown first (to the left, or at the top of the taskbar), followed by windows on virtual desktop 2, and so on.</para> + +<para>You can disable the application icons, and show just the text. You might want to do this to save space on your taskbar, for example.</para> + +<para>You can have the taskbar <guilabel>Show only minimised windows</guilabel>. In this case, when you minimise a window, it will show up on the taskbar, and when you open it again, its taskbar entry will disappear.</para> + +<para><guilabel>Group similar tasks</guilabel> allows you to save some space on your taskbar, by only showing one icon for each running application, no matter how many windows are shown. You can click on the icon to display a menu of all the windows that are available. This is most useful when you have enabled <guilabel>Show all windows</guilabel>.</para> </sect2> <sect2> -<title -><guilabel ->Actions</guilabel -></title> +<title><guilabel>Actions</guilabel></title> -<para ->The next set of options allow you to customise the actions performed with different mouse clicks on taskbar icons.</para> +<para>The next set of options allow you to customise the actions performed with different mouse clicks on taskbar icons.</para> -<para ->You can select any action from the list for the &LMB;, the &MMB; and the &RMB;.</para> +<para>You can select any action from the list for the &LMB;, the &MMB; and the &RMB;.</para> -<para ->The options available are:</para> +<para>The options available are:</para> <variablelist> <varlistentry> -<term -><guilabel ->Show Task List</guilabel -></term> +<term><guilabel>Show Task List</guilabel></term> <listitem> -<para ->Show the list of tasks grouped under the icon you have clicked on. If there is only one task or window for that icon, it will become the active window.</para> -<para ->This is the default action for the &LMB;.</para> +<para>Show the list of tasks grouped under the icon you have clicked on. If there is only one task or window for that icon, it will become the active window.</para> +<para>This is the default action for the &LMB;.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Cycle Through Windows</guilabel -></term> +<term><guilabel>Cycle Through Windows</guilabel></term> <listitem> -<para ->If there is more than one task grouped under the icon, switch from one to the next, until you release the button (&ie; when you have reached the window you are looking for). If there is only one task or window for that icon, it will become the active window.</para -> +<para>If there is more than one task grouped under the icon, switch from one to the next, until you release the button (&ie; when you have reached the window you are looking for). If there is only one task or window for that icon, it will become the active window.</para> -<para ->This is the default action for the &MMB; if window grouping is enabled.</para> +<para>This is the default action for the &MMB; if window grouping is enabled.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Show Operations Menu</guilabel -></term> +<term><guilabel>Show Operations Menu</guilabel></term> <listitem> -<para ->Show the operations menu for the application. This allows you to minimise, maximize, &etc;, move windows between desktops, and close windows. You can perform these actions on all windows grouped under that icon, or on any single window, by choosing it from the submenu.</para> -<para ->This is the default action for the &RMB;.</para> +<para>Show the operations menu for the application. This allows you to minimise, maximize, &etc;, move windows between desktops, and close windows. You can perform these actions on all windows grouped under that icon, or on any single window, by choosing it from the submenu.</para> +<para>This is the default action for the &RMB;.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Raise Task</guilabel ->, <guilabel ->Lower Task</guilabel ->, <guilabel ->Minimise Task</guilabel -></term> +<term><guilabel>Raise Task</guilabel>, <guilabel>Lower Task</guilabel>, <guilabel>Minimise Task</guilabel></term> <listitem> -<para ->These three options make sense only if window grouping is disabled. They are fairly self-explanatory. Raise means to make active, bring to the front, and give focus. Lower means, send to the back, and give focus to whichever window is now on top.</para> +<para>These three options make sense only if window grouping is disabled. They are fairly self-explanatory. Raise means to make active, bring to the front, and give focus. Lower means, send to the back, and give focus to whichever window is now on top.</para> </listitem> </varlistentry> </variablelist> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/keyboard/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/keyboard/index.docbook index 320d43bcdaf..5da87605348 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/keyboard/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/keyboard/index.docbook @@ -2,108 +2,59 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->keyboard</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>keyboard</keyword> </keywordset> </articleinfo> <sect1 id="kbd"> -<title ->Keyboard</title> +<title>Keyboard</title> -<para ->This module allows you to choose how your keyboard works.</para> +<para>This module allows you to choose how your keyboard works.</para> -<para ->The actual effect of setting these options depends upon the features provided by your keyboard hardware and the X server on which &kde; is running. As an example, you may find that changing the key click volume has no effect because that feature is not available on your system. </para> +<para>The actual effect of setting these options depends upon the features provided by your keyboard hardware and the X server on which &kde; is running. As an example, you may find that changing the key click volume has no effect because that feature is not available on your system. </para> <sect2 id="kbd-use"> -<title ->Advanced</title> +<title>Advanced</title> <variablelist> <varlistentry> -<term -><guilabel ->Enable keyboard repeat</guilabel -></term> +<term><guilabel>Enable keyboard repeat</guilabel></term> <listitem> -<para ->When this option is selected, pressing and holding down a key emits the same character repeatedly until the key is released. Pressing and holding the key will have the same effect as pressing it multiple times in succession. </para> -<tip -><para ->Almost all users will want to have this option enabled, because it makes navigating through documents with the arrow keys significantly easier. </para -></tip> +<para>When this option is selected, pressing and holding down a key emits the same character repeatedly until the key is released. Pressing and holding the key will have the same effect as pressing it multiple times in succession. </para> +<tip><para>Almost all users will want to have this option enabled, because it makes navigating through documents with the arrow keys significantly easier. </para></tip> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->NumLock on KDE Startup</guilabel -></term> +<term><guilabel>NumLock on KDE Startup</guilabel></term> <listitem> -<para ->You can choose to either always <guilabel ->Turn on</guilabel -> or <guilabel ->Turn off</guilabel -> the NumLock when &kde; starts, or you can choose to have &kde; leave NumLock at whatever it was set to before KDE started up.</para> +<para>You can choose to either always <guilabel>Turn on</guilabel> or <guilabel>Turn off</guilabel> the NumLock when &kde; starts, or you can choose to have &kde; leave NumLock at whatever it was set to before KDE started up.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Key click volume:</guilabel -></term> +<term><guilabel>Key click volume:</guilabel></term> <listitem> -<para ->If supported, this option allows you to hear audible clicks from your computer's speakers when you press the keys on your keyboard. In essence, this simulates the <quote ->click</quote -> of a mechanical type-writer. You can change the loudness of the key click feedback by dragging the slider button or by clicking the up/down arrows on the spin-button. Setting the volume to 0% turns off the key click.</para> -<para ->Many computers won't support this function.</para> -<tip -><para ->Very few people would choose to enable this option, since it generally annoys everyone else in the room. However, if your heart yearns for the pre-soft-key era, this may help you to re-experience the warm sentimentality of days-gone-by.</para> +<para>If supported, this option allows you to hear audible clicks from your computer's speakers when you press the keys on your keyboard. In essence, this simulates the <quote>click</quote> of a mechanical type-writer. You can change the loudness of the key click feedback by dragging the slider button or by clicking the up/down arrows on the spin-button. Setting the volume to 0% turns off the key click.</para> +<para>Many computers won't support this function.</para> +<tip><para>Very few people would choose to enable this option, since it generally annoys everyone else in the room. However, if your heart yearns for the pre-soft-key era, this may help you to re-experience the warm sentimentality of days-gone-by.</para> </tip> </listitem> </varlistentry> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/keys/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/keys/index.docbook index ea1405b79b7..46a0ce85692 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/keys/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/keys/index.docbook @@ -2,244 +2,104 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<author ->&Jost.Schenck; &Jost.Schenck.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<author>&Jost.Schenck; &Jost.Schenck.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-13</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-13</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->key bindings</keyword> -<keyword ->bindings</keyword> -<keyword ->shortcuts</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>key bindings</keyword> +<keyword>bindings</keyword> +<keyword>shortcuts</keyword> </keywordset> </articleinfo> <sect1 id="key-bindings"> -<title ->Shortcuts</title> - -<sect2 id="key-bindings-intro" -> -<title ->Introduction</title -> - -<para ->While most of the functionality offered by &kde; can be accessed using a simple <quote ->point and click</quote -> interface, many people prefer using the keyboard for some tasks. Pressing something like <keycombo action="simul" -> &Ctrl;<keycap ->F</keycap -></keycombo -> is often just faster than moving your hands off the keyboard to the mouse, opening the <guimenu ->Edit</guimenu -> menu and selecting <guimenuitem ->Find</guimenuitem ->.</para> - -<para ->As different people have different preferences about keyboard shortcuts, &kde; offers full customisation of <quote ->key bindings.</quote -> A key binding or shortcut is a combination of an action with a key or a combination of keys.</para> +<title>Shortcuts</title> + +<sect2 id="key-bindings-intro"> +<title>Introduction</title> + +<para>While most of the functionality offered by &kde; can be accessed using a simple <quote>point and click</quote> interface, many people prefer using the keyboard for some tasks. Pressing something like <keycombo action="simul"> &Ctrl;<keycap>F</keycap></keycombo> is often just faster than moving your hands off the keyboard to the mouse, opening the <guimenu>Edit</guimenu> menu and selecting <guimenuitem>Find</guimenuitem>.</para> + +<para>As different people have different preferences about keyboard shortcuts, &kde; offers full customisation of <quote>key bindings.</quote> A key binding or shortcut is a combination of an action with a key or a combination of keys.</para> </sect2> <sect2 id="key-bindings-use"> -<title ->Use</title> - -<para ->In the Shortcuts control module you will see a list of <quote ->key schemes,</quote -> a list of key bindings in the currently selected scheme and a frame where you can customise the currently selected key binding. Also, you will see a tab for <guilabel ->Global shortcuts</guilabel -> and one for <guilabel ->Application shortcuts</guilabel ->.</para> +<title>Use</title> + +<para>In the Shortcuts control module you will see a list of <quote>key schemes,</quote> a list of key bindings in the currently selected scheme and a frame where you can customise the currently selected key binding. Also, you will see a tab for <guilabel>Global shortcuts</guilabel> and one for <guilabel>Application shortcuts</guilabel>.</para> <sect3 id="key-bindings-use-globapp"> -<title ->Global Shortcuts and Application Shortcuts</title> - -<para -><guilabel ->Global shortcuts</guilabel -> and <guilabel ->application shortcuts</guilabel -> work just the same. Actually, in a certain way application shortcuts are <quote ->global</quote -> as well. The only difference is:</para> +<title>Global Shortcuts and Application Shortcuts</title> + +<para><guilabel>Global shortcuts</guilabel> and <guilabel>application shortcuts</guilabel> work just the same. Actually, in a certain way application shortcuts are <quote>global</quote> as well. The only difference is:</para> <itemizedlist> -<listitem -><para -><quote ->Global shortcuts</quote -> are shortcuts for actions that make sense even when no application is opened. These shortcuts usually refer to actions like switching desktops, manipulating windows etc. </para -></listitem -> -<listitem -><para -><quote ->Application shortcuts</quote -> refer to actions that are often available in applications, such as Save, Print, Copy etc.</para -></listitem -> +<listitem><para><quote>Global shortcuts</quote> are shortcuts for actions that make sense even when no application is opened. These shortcuts usually refer to actions like switching desktops, manipulating windows etc. </para></listitem> +<listitem><para><quote>Application shortcuts</quote> refer to actions that are often available in applications, such as Save, Print, Copy etc.</para></listitem> </itemizedlist> -<para ->Please note, that the application shortcuts configured here are <emphasis ->only</emphasis -> the standard actions often found in applications. Most applications will define their own actions as well, for which you have to customise key bindings using the application's key bindings dialogue.</para> +<para>Please note, that the application shortcuts configured here are <emphasis>only</emphasis> the standard actions often found in applications. Most applications will define their own actions as well, for which you have to customise key bindings using the application's key bindings dialogue.</para> </sect3> <sect3 id="key-bindings-use-confkeys"> -<title ->Configuring Key Bindings</title> +<title>Configuring Key Bindings</title> -<para ->Configuring key bindings is pretty easy. In the middle of the key bindings control module you'll find a list of available actions. If there's a key binding configured for that action you'll find it right next to it. Just select the action you want to configure.</para> +<para>Configuring key bindings is pretty easy. In the middle of the key bindings control module you'll find a list of available actions. If there's a key binding configured for that action you'll find it right next to it. Just select the action you want to configure.</para> -<para ->After you've selected an action you'll notice that most of the controls below the action list are enabled. There you can configure a combination of keys or maybe no key binding at all for the selected action. </para> +<para>After you've selected an action you'll notice that most of the controls below the action list are enabled. There you can configure a combination of keys or maybe no key binding at all for the selected action. </para> <itemizedlist> -<listitem -><para -><guilabel ->No key</guilabel ->: the selected action will not be associated with any key.</para -></listitem> - -<listitem -><para -><guilabel ->Default key</guilabel ->: the selected action will be associated with &kde;'s default value. This is a good choice for most actions, as &kde; comes with reasonable key bindings we have thought about. </para -></listitem> - -<listitem -><para -><guilabel ->Custom key</guilabel ->: if this option is enabled, you can create a key combination for the selected action. Just select any modifiers (&ie; &Shift;, &Ctrl;, or &Alt;) and then select a key: just click on the key symbol and after that press the key you want to assign to this key combination.</para -></listitem> +<listitem><para><guilabel>No key</guilabel>: the selected action will not be associated with any key.</para></listitem> + +<listitem><para><guilabel>Default key</guilabel>: the selected action will be associated with &kde;'s default value. This is a good choice for most actions, as &kde; comes with reasonable key bindings we have thought about. </para></listitem> + +<listitem><para><guilabel>Custom key</guilabel>: if this option is enabled, you can create a key combination for the selected action. Just select any modifiers (&ie; &Shift;, &Ctrl;, or &Alt;) and then select a key: just click on the key symbol and after that press the key you want to assign to this key combination.</para></listitem> </itemizedlist> -<para ->As with all control modules, your changes won't take in effect until you click <guibutton ->OK</guibutton -> or <guibutton ->Apply</guibutton ->. Click <guibutton ->Cancel</guibutton -> to discard all changes.</para> +<para>As with all control modules, your changes won't take in effect until you click <guibutton>OK</guibutton> or <guibutton>Apply</guibutton>. Click <guibutton>Cancel</guibutton> to discard all changes.</para> </sect3> <sect3 id="key-bindings-use-confschemes"> -<title ->Configuring Schemes</title> - -<para ->A key binding scheme is a set of key bindings that you can access using its name. &kde; comes with one pre-defined key binding scheme called <guilabel ->KDE default for 3 modifiers</guilabel ->. In addition to that scheme, you'll always see a scheme named <guilabel ->Current scheme</guilabel -> that stands for the set of key bindings you are using right now (&ie; not the current settings you are playing with, but what you've been using up to now). </para> - -<para ->When you are playing with the key bindings for the first time you don't have to be afraid of changing the default bindings: &kde; won't let you overwrite the defaults, so you can always switch back to the factory presets. By choosing <guilabel ->Current scheme</guilabel -> you can return to the set of key bindings you've been using up to now. However, be careful not to select a scheme when you've made changes to the key bindings you don't want to lose.</para> - -<para ->When you are satisfied with a set of key bindings you've created, you may want to save them to a scheme of your own, so that you can still experiment with the bindings and always return to a certain scheme. You can always do this by clicking on the <guibutton ->Add</guibutton -> button. You will be prompted for a name and then the new scheme will appear in the key schemes listbox. You can remove your own schemes again by selecting a scheme and clicking the <guibutton ->Remove</guibutton -> button. Click the <guibutton ->Save changes</guibutton -> button to save any changes you have made to the currently selected scheme. Note that you can not remove or save changes to <guilabel ->KDE default</guilabel -> or to <guilabel ->Current scheme</guilabel ->.</para> - -<important -><para ->If you want to save your changes while a read-only scheme is selected, you always have to add a new scheme first! If you select one of your own schemes because you want to save the changes to that one, the control module will switch to the key bindings of that scheme, discarding your changes.</para -></important -> </sect3> +<title>Configuring Schemes</title> + +<para>A key binding scheme is a set of key bindings that you can access using its name. &kde; comes with one pre-defined key binding scheme called <guilabel>KDE default for 3 modifiers</guilabel>. In addition to that scheme, you'll always see a scheme named <guilabel>Current scheme</guilabel> that stands for the set of key bindings you are using right now (&ie; not the current settings you are playing with, but what you've been using up to now). </para> + +<para>When you are playing with the key bindings for the first time you don't have to be afraid of changing the default bindings: &kde; won't let you overwrite the defaults, so you can always switch back to the factory presets. By choosing <guilabel>Current scheme</guilabel> you can return to the set of key bindings you've been using up to now. However, be careful not to select a scheme when you've made changes to the key bindings you don't want to lose.</para> + +<para>When you are satisfied with a set of key bindings you've created, you may want to save them to a scheme of your own, so that you can still experiment with the bindings and always return to a certain scheme. You can always do this by clicking on the <guibutton>Add</guibutton> button. You will be prompted for a name and then the new scheme will appear in the key schemes listbox. You can remove your own schemes again by selecting a scheme and clicking the <guibutton>Remove</guibutton> button. Click the <guibutton>Save changes</guibutton> button to save any changes you have made to the currently selected scheme. Note that you can not remove or save changes to <guilabel>KDE default</guilabel> or to <guilabel>Current scheme</guilabel>.</para> + +<important><para>If you want to save your changes while a read-only scheme is selected, you always have to add a new scheme first! If you select one of your own schemes because you want to save the changes to that one, the control module will switch to the key bindings of that scheme, discarding your changes.</para></important> </sect3> </sect2> <sect2> -<title ->Modifier Keys</title> - -<para ->Different keyboards offer different sets of modifier keys. A &Mac; keyboard, for example, does not have a &Ctrl; key, and instead has an <keycap ->Option</keycap -> key. Here you can see what the available modifier keys for the current keyboard are.</para> - -<para ->If you enable <guilabel ->Macintosh keyboard</guilabel -> the list of modifiers will change.</para> - -<para ->If you have enabled the &Mac; keyboard, you can further enable <guilabel ->MacOS-style modifier usage</guilabel ->, to make &kde; behave more like &MacOS;.</para -><!-- FIXME: well, that's rather non-explanatory, more here would be good --> - -<para ->Finally, you can change what a keypress sends to the &X-Server; in the <guilabel ->X Modifier Mapping</guilabel -> section. A common example is to reconfigure the <keycap ->Caps Lock</keycap -> key, which is rarely used, to be another &Ctrl; key. This is especially nice if you are a touch typist, as <keycap ->Caps Lock</keycap -> is much easier to reach than either of the &Ctrl; keys on a standard keyboard.</para> +<title>Modifier Keys</title> + +<para>Different keyboards offer different sets of modifier keys. A &Mac; keyboard, for example, does not have a &Ctrl; key, and instead has an <keycap>Option</keycap> key. Here you can see what the available modifier keys for the current keyboard are.</para> + +<para>If you enable <guilabel>Macintosh keyboard</guilabel> the list of modifiers will change.</para> + +<para>If you have enabled the &Mac; keyboard, you can further enable <guilabel>MacOS-style modifier usage</guilabel>, to make &kde; behave more like &MacOS;.</para><!-- FIXME: well, that's rather non-explanatory, more here would be good --> + +<para>Finally, you can change what a keypress sends to the &X-Server; in the <guilabel>X Modifier Mapping</guilabel> section. A common example is to reconfigure the <keycap>Caps Lock</keycap> key, which is rarely used, to be another &Ctrl; key. This is especially nice if you are a touch typist, as <keycap>Caps Lock</keycap> is much easier to reach than either of the &Ctrl; keys on a standard keyboard.</para> <!-- FIXME: what exactly is going on here... --> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/kthememgr/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/kthememgr/index.docbook index 8e3bfc2a446..b5f4c1a673d 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/kthememgr/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/kthememgr/index.docbook @@ -2,8 +2,7 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE" > <!-- change language only here --> ]> <article lang="&language;"> @@ -11,170 +10,76 @@ <authorgroup> -<author -> <firstname ->Lauri</firstname -> <surname ->Watts</surname -> </author> - -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->KDE British Conversion</contrib -></othercredit -> +<author> <firstname>Lauri</firstname> <surname>Watts</surname> </author> + +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>KDE British Conversion</contrib></othercredit> </authorgroup> -<date ->2002-02-16</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-16</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->kcontrol</keyword> -<keyword ->Themes</keyword> +<keyword>KDE</keyword> +<keyword>kcontrol</keyword> +<keyword>Themes</keyword> </keywordset> </articleinfo> <sect1 id="theme-manager"> -<title ->Theme Manager</title> +<title>Theme Manager</title> -<para ->With this module you can install, view, and even create, &kde; themes.</para> +<para>With this module you can install, view, and even create, &kde; themes.</para> -<para ->This page is divided into two tabs: <guilabel ->Installer</guilabel ->, <guilabel ->Contents</guilabel ->.</para> +<para>This page is divided into two tabs: <guilabel>Installer</guilabel>, <guilabel>Contents</guilabel>.</para> <sect2 id="theme-installer"> -<title ->Installer</title> +<title>Installer</title> -<para ->Here you can install, preview and create &kde; themes. Themes created this way may not cover all the configurable options that &kde; has to offer. However, they do cover most options and are a great way to get started.</para> +<para>Here you can install, preview and create &kde; themes. Themes created this way may not cover all the configurable options that &kde; has to offer. However, they do cover most options and are a great way to get started.</para> -<para ->On the left, you can see a list of themes that &kde; is aware of. Selecting one of the names will change the preview image in the middle of the pane, to give you a small taste of what the theme looks like. Any information the author has provided about the theme, for example, a longer or more descriptive name, is displayed in the bottom of the pane.</para> +<para>On the left, you can see a list of themes that &kde; is aware of. Selecting one of the names will change the preview image in the middle of the pane, to give you a small taste of what the theme looks like. Any information the author has provided about the theme, for example, a longer or more descriptive name, is displayed in the bottom of the pane.</para> -<para ->Along with the normal &kcontrol; buttons at the bottom, you have four new ones to the right of the module. <guibutton ->Add...</guibutton -> allows you to add a new theme to the list on the left. Pressing it will open a normal &kde; file dialogue, where you can browse to the location of themes you have downloaded or created.</para> +<para>Along with the normal &kcontrol; buttons at the bottom, you have four new ones to the right of the module. <guibutton>Add...</guibutton> allows you to add a new theme to the list on the left. Pressing it will open a normal &kde; file dialogue, where you can browse to the location of themes you have downloaded or created.</para> -<para ->The <guibutton ->Save As...</guibutton -> button allows you to save an existing theme with a new name, for example to allow you to easily modify it without damaging the original. It is strongly recommended that you use this if you intend creating themes by hand, you can get very unexpected results if there are errors in a theme file.</para> +<para>The <guibutton>Save As...</guibutton> button allows you to save an existing theme with a new name, for example to allow you to easily modify it without damaging the original. It is strongly recommended that you use this if you intend creating themes by hand, you can get very unexpected results if there are errors in a theme file.</para> -<para -><guibutton ->Create</guibutton -> will create a theme that contains your current desktop settings. Themes created this way are fairly unsophisticated, but they are a very good start to learning to make your own.</para> +<para><guibutton>Create</guibutton> will create a theme that contains your current desktop settings. Themes created this way are fairly unsophisticated, but they are a very good start to learning to make your own.</para> -<para ->Finally, it's very easy to collect alot of themes that look rather nice on a website, but aren't to your taste once you've tried them. The <guibutton ->Remove...</guibutton -> will remedy this situation, removing the theme from the list on the left.</para> +<para>Finally, it's very easy to collect alot of themes that look rather nice on a website, but aren't to your taste once you've tried them. The <guibutton>Remove...</guibutton> will remedy this situation, removing the theme from the list on the left.</para> </sect2> <sect2> -<title ->Contents</title> - -<para ->This page works together with the previous one, allowing you to custom fit a theme to your own needs.</para> - -<para ->Not all themes contain instructions (or images) for all the configurable parts of &kde;. For example, some contain a colour scheme, a desktop wallpaper, and a style for the panel, but they don't have any icons or Window Decoration instructions.</para> - -<para ->Another common situation is to find you have finally got your own icon theme, colour scheme or window decoration arrangement <quote ->just so</quote ->, and although you'd like to try out a theme, you don't want to mess up your current installation.</para> - -<para ->Using this page, you can see immediately what categories of changes the theme will make, and you can enable or disable its effects on those categories.</para> - -<para ->The list under the heading <guilabel ->Work on the following parts</guilabel -> will show you a checkbox to the left if the theme is going to affect that item, and to the right if the theme actually contains any contents for that category.</para> - -<para ->You can use the <guibutton ->Clear</guibutton -> button to clear all the checkboxes, and the <guibutton ->Invert</guibutton -> button to check all the checkboxes that are currently empty, and clear those that were checked.</para> - -<para ->For example, the <quote ->Eclipse</quote -> theme that comes with a base &kde; installation contains contents for all the configurable items, and is by default set up to change them all to its own settings. The <quote ->MGBreizh</quote -> theme contains contents for everything except the icons. The <quote ->Technical</quote -> theme, which you can find in the tdeartwork package, contains <emphasis ->only</emphasis -> the icons, so if you were to install <quote ->MGBreizh</quote ->, and then <quote ->Technical</quote ->, you would find you still had mostly the <quote ->MGBreizh</quote -> theme in place, but with new icons.</para> - -<para ->Taking this same scenario, what if you really didn't want the <quote ->MGBreizh</quote -> theme anymore, and wanted to remove it, and just use the <quote ->Technical</quote -> icon theme with a plain desktop?</para> - -<para ->You have two choices here. You can check the <guilabel ->Uninstall parts of previous theme</guilabel -> box, and then any installed theme will be entirely removed before the new one is installed. Or you could just install the <quote ->Default</quote -> theme, which really isn't a theme, it's more of a theme cleaner - it removes all other themes, and resets all your desktop theme settings to the &kde; default appearance.</para> +<title>Contents</title> + +<para>This page works together with the previous one, allowing you to custom fit a theme to your own needs.</para> + +<para>Not all themes contain instructions (or images) for all the configurable parts of &kde;. For example, some contain a colour scheme, a desktop wallpaper, and a style for the panel, but they don't have any icons or Window Decoration instructions.</para> + +<para>Another common situation is to find you have finally got your own icon theme, colour scheme or window decoration arrangement <quote>just so</quote>, and although you'd like to try out a theme, you don't want to mess up your current installation.</para> + +<para>Using this page, you can see immediately what categories of changes the theme will make, and you can enable or disable its effects on those categories.</para> + +<para>The list under the heading <guilabel>Work on the following parts</guilabel> will show you a checkbox to the left if the theme is going to affect that item, and to the right if the theme actually contains any contents for that category.</para> + +<para>You can use the <guibutton>Clear</guibutton> button to clear all the checkboxes, and the <guibutton>Invert</guibutton> button to check all the checkboxes that are currently empty, and clear those that were checked.</para> + +<para>For example, the <quote>Eclipse</quote> theme that comes with a base &kde; installation contains contents for all the configurable items, and is by default set up to change them all to its own settings. The <quote>MGBreizh</quote> theme contains contents for everything except the icons. The <quote>Technical</quote> theme, which you can find in the tdeartwork package, contains <emphasis>only</emphasis> the icons, so if you were to install <quote>MGBreizh</quote>, and then <quote>Technical</quote>, you would find you still had mostly the <quote>MGBreizh</quote> theme in place, but with new icons.</para> + +<para>Taking this same scenario, what if you really didn't want the <quote>MGBreizh</quote> theme anymore, and wanted to remove it, and just use the <quote>Technical</quote> icon theme with a plain desktop?</para> + +<para>You have two choices here. You can check the <guilabel>Uninstall parts of previous theme</guilabel> box, and then any installed theme will be entirely removed before the new one is installed. Or you could just install the <quote>Default</quote> theme, which really isn't a theme, it's more of a theme cleaner - it removes all other themes, and resets all your desktop theme settings to the &kde; default appearance.</para> </sect2> <sect2 id="theme-author"> -<title ->Section Author</title> - -<para ->This section was written by Lauri Watts <email ->lauri@kde.org</email ->.</para> - -<para ->KDE British Conversion Malcolm Hunter <email ->malcolm.hunter@gmx.co.uk</email -></para -> +<title>Section Author</title> + +<para>This section was written by Lauri Watts <email>lauri@kde.org</email>.</para> + +<para>KDE British Conversion Malcolm Hunter <email>malcolm.hunter@gmx.co.uk</email></para> </sect2> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/language/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/language/index.docbook index 258f0edda9d..a5cf378baee 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/language/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/language/index.docbook @@ -2,8 +2,7 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> @@ -11,323 +10,123 @@ <sect1info> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<author ->&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-14</date -> <releaseinfo ->3.2</releaseinfo -> <keywordset> - <keyword ->KDE</keyword> - <keyword ->KControl</keyword> - <keyword ->locale</keyword> - <keyword ->country</keyword> - <keyword ->language</keyword> +<date>2003-10-14</date> <releaseinfo>3.2</releaseinfo> <keywordset> + <keyword>KDE</keyword> + <keyword>KControl</keyword> + <keyword>locale</keyword> + <keyword>country</keyword> + <keyword>language</keyword> </keywordset> </sect1info> -<title ->Country and Language</title> +<title>Country and Language</title> -<para ->This module of the &kde; control centre allows you select customisation options that depend on the region of the world that you happen to live in. There are five different pages in this module, each of which is described in detail in the following sections.</para> +<para>This module of the &kde; control centre allows you select customisation options that depend on the region of the world that you happen to live in. There are five different pages in this module, each of which is described in detail in the following sections.</para> -<para ->In most cases, you can simply select the country you live in, and the other options will be set in an appropriate manner.</para> +<para>In most cases, you can simply select the country you live in, and the other options will be set in an appropriate manner.</para> -<para ->Below the pages of this module, you can see a preview of what the settings look like. In addition to positive and negative numbers, you can see how positive and negative currency values, long and short dates, and times are displayed. When you change any of the settings, the preview shows the effects of the changes before you apply them.</para> +<para>Below the pages of this module, you can see a preview of what the settings look like. In addition to positive and negative numbers, you can see how positive and negative currency values, long and short dates, and times are displayed. When you change any of the settings, the preview shows the effects of the changes before you apply them.</para> <sect2 id="locale-locale"> -<title ->Locale</title> +<title>Locale</title> -<para ->On this page, there are two lists, from which you can select the country and languages that you want to use.</para> +<para>On this page, there are two lists, from which you can select the country and languages that you want to use.</para> -<para ->When you click on the <guilabel ->Country</guilabel -> list, a menu pops up showing major groups of countries. You can select one of these regions and see a list of the countries that are available for that region.</para> +<para>When you click on the <guilabel>Country</guilabel> list, a menu pops up showing major groups of countries. You can select one of these regions and see a list of the countries that are available for that region.</para> -<para ->If the language for the country you have selected is available on your system, it will be selected automatically. For instance, choosing <guilabel ->Germany</guilabel -> as the country will select <guilabel ->German</guilabel -> as the language, if it is available.</para> +<para>If the language for the country you have selected is available on your system, it will be selected automatically. For instance, choosing <guilabel>Germany</guilabel> as the country will select <guilabel>German</guilabel> as the language, if it is available.</para> </sect2> <sect2 id="locale-numbers"> -<title ->Numbers</title> +<title>Numbers</title> -<para ->On this page, you can select options for how numbers are displayed. The defaults are selected automatically based on the country which is currently selected.</para> +<para>On this page, you can select options for how numbers are displayed. The defaults are selected automatically based on the country which is currently selected.</para> -<para ->In the text box labelled <guilabel ->Decimal symbol</guilabel ->, you can type the character that you want to use to separate the decimal portion of numbers. You could put anything here you wanted to, but really, <userinput ->.</userinput -> and <userinput ->,</userinput -> are the two characters that make the most sense.</para> +<para>In the text box labelled <guilabel>Decimal symbol</guilabel>, you can type the character that you want to use to separate the decimal portion of numbers. You could put anything here you wanted to, but really, <userinput>.</userinput> and <userinput>,</userinput> are the two characters that make the most sense.</para> -<para ->Similarly, you can choose the character which is used to group units of thousands in numbers. If no character, not even a space, is present, then there will be no separator for thousands.</para> +<para>Similarly, you can choose the character which is used to group units of thousands in numbers. If no character, not even a space, is present, then there will be no separator for thousands.</para> -<para ->Finally, you can choose what character should be prefixed to positive and negative numbers respectively. For example, the default for English is not to have any prefix for positive numbers, and a <userinput ->-</userinput -> for negative numbers.</para> +<para>Finally, you can choose what character should be prefixed to positive and negative numbers respectively. For example, the default for English is not to have any prefix for positive numbers, and a <userinput>-</userinput> for negative numbers.</para> </sect2> <sect2 id="locale-money"> -<title ->Money</title> +<title>Money</title> -<para ->Unlike the display of ordinary numbers, conventions for currency values do vary from region to region. However, you will find that the defaults are probably fine.</para> +<para>Unlike the display of ordinary numbers, conventions for currency values do vary from region to region. However, you will find that the defaults are probably fine.</para> -<para ->The character or characters representing the currency symbol are based on the country that is currently selected. The decimal symbol and thousands separator work as they do for numbers. The text box labelled <guilabel ->Fract digits</guilabel -> allows you to specify the number of fractional digits used in displaying currency values.</para> +<para>The character or characters representing the currency symbol are based on the country that is currently selected. The decimal symbol and thousands separator work as they do for numbers. The text box labelled <guilabel>Fract digits</guilabel> allows you to specify the number of fractional digits used in displaying currency values.</para> -<para ->For both positive and negative currency values, you can control whether the currency symbol appears before or after the numeric value, and how the sign of the value is distinguished in the display. Note that the symbols used for the sign of currency values are the same as those used for other numeric values.</para> +<para>For both positive and negative currency values, you can control whether the currency symbol appears before or after the numeric value, and how the sign of the value is distinguished in the display. Note that the symbols used for the sign of currency values are the same as those used for other numeric values.</para> -<para ->If the checkbox labelled <guilabel ->Prefix currency symbol</guilabel -> is selected, the currency symbol appears before the numeric value. If this checkbox is cleared, then the currency symbol appears after the numeric value.</para> +<para>If the checkbox labelled <guilabel>Prefix currency symbol</guilabel> is selected, the currency symbol appears before the numeric value. If this checkbox is cleared, then the currency symbol appears after the numeric value.</para> -<para ->There are five choices for the way in which the sign of the currency value is handled:</para> +<para>There are five choices for the way in which the sign of the currency value is handled:</para> <itemizedlist> -<listitem -><para ->The <guilabel ->Parens around</guilabel -> option displays the numeric value within a pair of parentheses.</para -></listitem> -<listitem -><para ->The <guilabel ->Before quantity money</guilabel -> option displays the sign before the numeric value, but after any currency symbol that may be present.</para -></listitem> -<listitem -><para ->The <guilabel ->After quantity money</guilabel -> option displays the sign after the numeric value, but before any currency symbol that may be present.</para -></listitem> -<listitem -><para ->The <guilabel ->Before money</guilabel -> option displays the sign before the numeric value as well as any currency symbol that may be present.</para -></listitem> -<listitem -><para ->The <guilabel ->After money</guilabel -> option displays the sign after the numeric value as well as any currency symbol that may be present.</para -></listitem> +<listitem><para>The <guilabel>Parens around</guilabel> option displays the numeric value within a pair of parentheses.</para></listitem> +<listitem><para>The <guilabel>Before quantity money</guilabel> option displays the sign before the numeric value, but after any currency symbol that may be present.</para></listitem> +<listitem><para>The <guilabel>After quantity money</guilabel> option displays the sign after the numeric value, but before any currency symbol that may be present.</para></listitem> +<listitem><para>The <guilabel>Before money</guilabel> option displays the sign before the numeric value as well as any currency symbol that may be present.</para></listitem> +<listitem><para>The <guilabel>After money</guilabel> option displays the sign after the numeric value as well as any currency symbol that may be present.</para></listitem> </itemizedlist> </sect2> <sect2 id="locale-datetime"> -<title ->Time and Dates</title> +<title>Time and Dates</title> -<para ->If you use a different calendar system than Gregorian, you can choose this from the first dropdown box.</para> +<para>If you use a different calendar system than Gregorian, you can choose this from the first dropdown box.</para> -<para ->On the rest of this page, there are text boxes for the time, long date, and short date, in which you can type format strings to control the way in which times and dates are displayed.</para> +<para>On the rest of this page, there are text boxes for the time, long date, and short date, in which you can type format strings to control the way in which times and dates are displayed.</para> -<para ->Except for the special codes described below, any other characters in the format strings are displayed literally. The special codes consist of a <parameter ->%</parameter -> sign followed by a character, as shown in the list of codes below:</para> +<para>Except for the special codes described below, any other characters in the format strings are displayed literally. The special codes consist of a <parameter>%</parameter> sign followed by a character, as shown in the list of codes below:</para> <itemizedlist> -<listitem -><para ->Time format codes:</para> +<listitem><para>Time format codes:</para> <itemizedlist> - <listitem -><para -><parameter ->HH</parameter -> - The hour according to a 24-hour clock, using two digits (00 to 23).</para -></listitem> - <listitem -><para -><parameter ->hH</parameter -> - The hour according to a 24-hour clock, using one or two digits (0 to 23).</para -></listitem> - <listitem -><para -><parameter ->PH</parameter -> (uppercase eye) - The hour according to a 12-hour clock, using two digits (01 to 12).</para -></listitem> - <listitem -><para -><parameter ->pH</parameter -> (lowercase ell) - The hour according to a 12-hour clock, using one or two digits (1 to 12).</para -></listitem> - <listitem -><para -><parameter ->MM</parameter -> - The current minute using two digits (00 to 59).</para -></listitem> - <listitem -><para -><parameter ->SS</parameter -> - The current second using two digits (00 to 59).</para -></listitem> - <listitem -><para -><parameter ->AMPM</parameter -> - Either <quote ->am</quote -> or <quote ->pm</quote -> depending on the hour. Useful with <parameter ->PH</parameter -> or <parameter ->pH</parameter ->.</para -></listitem> + <listitem><para><parameter>HH</parameter> - The hour according to a 24-hour clock, using two digits (00 to 23).</para></listitem> + <listitem><para><parameter>hH</parameter> - The hour according to a 24-hour clock, using one or two digits (0 to 23).</para></listitem> + <listitem><para><parameter>PH</parameter> (uppercase eye) - The hour according to a 12-hour clock, using two digits (01 to 12).</para></listitem> + <listitem><para><parameter>pH</parameter> (lowercase ell) - The hour according to a 12-hour clock, using one or two digits (1 to 12).</para></listitem> + <listitem><para><parameter>MM</parameter> - The current minute using two digits (00 to 59).</para></listitem> + <listitem><para><parameter>SS</parameter> - The current second using two digits (00 to 59).</para></listitem> + <listitem><para><parameter>AMPM</parameter> - Either <quote>am</quote> or <quote>pm</quote> depending on the hour. Useful with <parameter>PH</parameter> or <parameter>pH</parameter>.</para></listitem> </itemizedlist> </listitem> -<listitem -><para ->Date format codes:</para> +<listitem><para>Date format codes:</para> <itemizedlist> - <listitem -><para -><parameter ->YYYY</parameter -> - The year, using 4 digits.</para -></listitem> - <listitem -><para -><parameter ->YY</parameter -> - The year, using 2 digits.</para -></listitem> - <listitem -><para -><parameter ->MM</parameter -> - The month, using 2 digits (01 to 12).</para -></listitem> - <listitem -><para -><parameter ->mM</parameter -> - The month, using 1 or 2 digits (1 to 12).</para -></listitem> - <listitem -><para -><parameter ->MONTH</parameter -> - The name of the month.</para -></listitem> - <listitem -><para -><parameter ->SHORTMONTH</parameter -> - The abbreviated name of the month.</para -></listitem> - <listitem -><para -><parameter ->DD</parameter -> - The day, using 2 digits (01 to 31).</para -></listitem> - <listitem -><para -><parameter ->dD</parameter -> - The day, using 1 or 2 digits (1 to 31).</para -></listitem> - <listitem -><para -><parameter ->WEEKDAY</parameter -> - The name of the weekday.</para -></listitem> - <listitem -><para -><parameter ->SHORTWEEKDAY</parameter -> - The abbreviated name of the weekday.</para -></listitem> + <listitem><para><parameter>YYYY</parameter> - The year, using 4 digits.</para></listitem> + <listitem><para><parameter>YY</parameter> - The year, using 2 digits.</para></listitem> + <listitem><para><parameter>MM</parameter> - The month, using 2 digits (01 to 12).</para></listitem> + <listitem><para><parameter>mM</parameter> - The month, using 1 or 2 digits (1 to 12).</para></listitem> + <listitem><para><parameter>MONTH</parameter> - The name of the month.</para></listitem> + <listitem><para><parameter>SHORTMONTH</parameter> - The abbreviated name of the month.</para></listitem> + <listitem><para><parameter>DD</parameter> - The day, using 2 digits (01 to 31).</para></listitem> + <listitem><para><parameter>dD</parameter> - The day, using 1 or 2 digits (1 to 31).</para></listitem> + <listitem><para><parameter>WEEKDAY</parameter> - The name of the weekday.</para></listitem> + <listitem><para><parameter>SHORTWEEKDAY</parameter> - The abbreviated name of the weekday.</para></listitem> </itemizedlist> </listitem> </itemizedlist> -<para ->Finally, there's a combobox labelled <guilabel ->First day of the week</guilabel -> which lets you select which day is the first one of the week in your country.</para> +<para>Finally, there's a combobox labelled <guilabel>First day of the week</guilabel> which lets you select which day is the first one of the week in your country.</para> </sect2> <sect2 id="locale-other"> -<title ->Other</title> -<para ->You can select the default paper format with the combo box labelled <guilabel ->Paper Format</guilabel ->.</para> - -<para ->Use the drop down box labelled <guilabel ->Measure system</guilabel -> to select Imperial or Metric systems of measurement.</para> +<title>Other</title> +<para>You can select the default paper format with the combo box labelled <guilabel>Paper Format</guilabel>.</para> + +<para>Use the drop down box labelled <guilabel>Measure system</guilabel> to select Imperial or Metric systems of measurement.</para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/mouse/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/mouse/index.docbook index f8a56db1571..92117c513ec 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/mouse/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/mouse/index.docbook @@ -2,330 +2,154 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<author ->&Brad.Hards; &Brad.Hards.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<author>&Brad.Hards; &Brad.Hards.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2004-10-09</date> -<releaseinfo ->3.03.00</releaseinfo> +<date>2004-10-09</date> +<releaseinfo>3.03.00</releaseinfo> <abstract> -<para ->This is the documentation for the &kde; &kcontrol; module that configures mice and other pointing devices. </para> +<para>This is the documentation for the &kde; &kcontrol; module that configures mice and other pointing devices. </para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->mouse</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>mouse</keyword> </keywordset> </articleinfo> <sect1 id="mouse"> -<title ->Mouse</title> - -<para ->This module allows you to configure your pointing device. Your pointing device may be a mouse, a track ball, a touch-pad, or another piece of hardware that performs a similar function.</para> - -<para ->This module is divided into several tabs: <link linkend="mouse-general" ->General</link ->, <link linkend="cursor-theme" ->Cursor Theme</link ->, <link linkend="mouse-advanced" ->Advanced</link -> and <link linkend="mouse-navigation" ->Mouse Navigation</link ->. </para> +<title>Mouse</title> + +<para>This module allows you to configure your pointing device. Your pointing device may be a mouse, a track ball, a touch-pad, or another piece of hardware that performs a similar function.</para> + +<para>This module is divided into several tabs: <link linkend="mouse-general">General</link>, <link linkend="cursor-theme">Cursor Theme</link>, <link linkend="mouse-advanced">Advanced</link> and <link linkend="mouse-navigation">Mouse Navigation</link>. </para> <sect2 id="mouse-general"> -<title -><guilabel ->General</guilabel -></title> +<title><guilabel>General</guilabel></title> <variablelist> <varlistentry> -<term -><guilabel ->Button Order</guilabel -></term> -<listitem -><para ->If you are left-handed, you may prefer to swap the functions of the <mousebutton ->left</mousebutton -> and <mousebutton ->right</mousebutton -> buttons on your pointing device by choosing the <quote ->Left handed</quote -> option. If your pointing device has more than two buttons, only those that function as the <mousebutton ->left</mousebutton -> and <mousebutton ->right</mousebutton -> buttons are affected. For example, if you have a three-button mouse, the <mousebutton ->middle</mousebutton -> button is unaffected.</para> +<term><guilabel>Button Order</guilabel></term> +<listitem><para>If you are left-handed, you may prefer to swap the functions of the <mousebutton>left</mousebutton> and <mousebutton>right</mousebutton> buttons on your pointing device by choosing the <quote>Left handed</quote> option. If your pointing device has more than two buttons, only those that function as the <mousebutton>left</mousebutton> and <mousebutton>right</mousebutton> buttons are affected. For example, if you have a three-button mouse, the <mousebutton>middle</mousebutton> button is unaffected.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Reverse scroll direction</guilabel -></term> -<listitem -><para ->With this checkbox selected, the scroll wheel (if any) will work in the opposite direction (so that if rolling the top of the scroll wheel towards you previously causes a scroll down, then it will now cause a scroll up). This may be useful to handle a unusual setup of the X server. </para> +<term><guilabel>Reverse scroll direction</guilabel></term> +<listitem><para>With this checkbox selected, the scroll wheel (if any) will work in the opposite direction (so that if rolling the top of the scroll wheel towards you previously causes a scroll down, then it will now cause a scroll up). This may be useful to handle a unusual setup of the X server. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Double-click to open files and folders (select icons on first click)</guilabel -></term> +<term><guilabel>Double-click to open files and folders (select icons on first click)</guilabel></term> <listitem> -<para ->If this option is not checked, icons/files will be opened with a single click of the <mousebutton ->left</mousebutton -> mouse-button. This default behaviour is consistent with what you would expect when you click links in most web browsers. If checked however, icons/files will be opened with a double click, while a single click will only select the icon or file. This is the behaviour you may know from other desktops or operating systems.</para> +<para>If this option is not checked, icons/files will be opened with a single click of the <mousebutton>left</mousebutton> mouse-button. This default behaviour is consistent with what you would expect when you click links in most web browsers. If checked however, icons/files will be opened with a double click, while a single click will only select the icon or file. This is the behaviour you may know from other desktops or operating systems.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Single-click to open files and folders</guilabel -></term> +<term><guilabel>Single-click to open files and folders</guilabel></term> <listitem> -<para ->This is the default setting for &kde;. Clicking once on an icon will open it. To select you can drag around the icon(s) or <keycombo action="simul" ->&Ctrl;<mousebutton ->Right</mousebutton -></keycombo -> click, or simply click and hold to drag it. You can also enable automatic selection of icons using the <guilabel ->Automatically select icons</guilabel -> checkbox, discussed below.</para> +<para>This is the default setting for &kde;. Clicking once on an icon will open it. To select you can drag around the icon(s) or <keycombo action="simul">&Ctrl;<mousebutton>Right</mousebutton></keycombo> click, or simply click and hold to drag it. You can also enable automatic selection of icons using the <guilabel>Automatically select icons</guilabel> checkbox, discussed below.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Change pointer shape over icons</guilabel -></term> +<term><guilabel>Change pointer shape over icons</guilabel></term> <listitem> -<para ->When this option is checked, the shape of the mouse pointer changes whenever it is over an icon.</para> +<para>When this option is checked, the shape of the mouse pointer changes whenever it is over an icon.</para> -<tip -><para ->This option should be checked in most situations. It gives more visual feedback and says, in essence, if you click here, something will happen.</para -></tip> +<tip><para>This option should be checked in most situations. It gives more visual feedback and says, in essence, if you click here, something will happen.</para></tip> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Automatically select icons</guilabel -></term> +<term><guilabel>Automatically select icons</guilabel></term> <listitem> -<para ->As noted above, if you have <guilabel ->Single-click to open files and folders</guilabel -> selected, you can select icons by dragging around them, or by using <keycombo action="simul" ->&Ctrl;<mousebutton ->Right</mousebutton -></keycombo -> click. If you routinely need to select icons, you may want to enable this checkbox, which will allow icons to be selected automatically by pausing over the icon. The <guilabel ->Delay:</guilabel -> slider determines how long is required before the automatic selection takes effect. </para> +<para>As noted above, if you have <guilabel>Single-click to open files and folders</guilabel> selected, you can select icons by dragging around them, or by using <keycombo action="simul">&Ctrl;<mousebutton>Right</mousebutton></keycombo> click. If you routinely need to select icons, you may want to enable this checkbox, which will allow icons to be selected automatically by pausing over the icon. The <guilabel>Delay:</guilabel> slider determines how long is required before the automatic selection takes effect. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Visual feedback on activation</guilabel -></term> +<term><guilabel>Visual feedback on activation</guilabel></term> <listitem> -<para ->When this option is checked, &kde; gives you visual feedback whenever you click on something and activate it.</para -></listitem> +<para>When this option is checked, &kde; gives you visual feedback whenever you click on something and activate it.</para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="cursor-theme"> -<title -><guilabel ->Cursor Theme</guilabel -></title> +<title><guilabel>Cursor Theme</guilabel></title> -<para ->This tab allows you to select from a number of cursor themes. A preview of the cursor display is shown above the listbox. </para> +<para>This tab allows you to select from a number of cursor themes. A preview of the cursor display is shown above the listbox. </para> -<note -><para ->The features provided by this tab may not be available on some systems. Your system may need to be updated to support cursor themes. </para -></note> +<note><para>The features provided by this tab may not be available on some systems. Your system may need to be updated to support cursor themes. </para></note> -<para ->If you have additional cursor themes available to you, you can install and remove them using the buttons below the listbox. Note that you cannot remove the default themes. </para> +<para>If you have additional cursor themes available to you, you can install and remove them using the buttons below the listbox. Note that you cannot remove the default themes. </para> </sect2> <sect2 id="mouse-advanced"> -<title ->Advanced</title> +<title>Advanced</title> <variablelist> <varlistentry> <term id="peripherals-mouse-acceleration"> -<guilabel ->Pointer acceleration</guilabel -></term> +<guilabel>Pointer acceleration</guilabel></term> <listitem> -<para ->This option allows you to change the relationship between the distance that the mouse pointer moves on the screen and the relative movement of the physical device itself (which may be a mouse, track-ball, or some other pointing device.)</para> - -<para ->A high value for the acceleration multiplier will lead to large movements of the mouse pointer on the screen, even when you only make a small movement with the physical device.</para> - -<tip -><para ->A multiplier between <guilabel ->1x</guilabel -> and <guilabel ->3x</guilabel -> will works well for many systems. With a multiplier over <guilabel ->3x</guilabel -> the mouse pointer may become difficult to control.</para -></tip> +<para>This option allows you to change the relationship between the distance that the mouse pointer moves on the screen and the relative movement of the physical device itself (which may be a mouse, track-ball, or some other pointing device.)</para> + +<para>A high value for the acceleration multiplier will lead to large movements of the mouse pointer on the screen, even when you only make a small movement with the physical device.</para> + +<tip><para>A multiplier between <guilabel>1x</guilabel> and <guilabel>3x</guilabel> will works well for many systems. With a multiplier over <guilabel>3x</guilabel> the mouse pointer may become difficult to control.</para></tip> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Pointer threshold</guilabel -></term> +<term><guilabel>Pointer threshold</guilabel></term> <listitem> -<para ->The threshold is the smallest distance that the mouse pointer must move on the screen before acceleration has any effect. If the movement is within the threshold, the mouse pointer moves as if the acceleration were set to <guilabel ->1x</guilabel ->.</para> - -<para ->Thus, when you make small movements with the physical device (⪚ mouse), you still have fine control of the mouse pointer on the screen, whereas larger movements of the physical device will move the mouse pointer rapidly to different areas on the screen.</para> - -<para ->You can set the threshold value by dragging the slider button or by clicking the up/down arrows on the spin-button to the left of the slider.</para> - -<tip -><para ->In general, the higher you set the <guilabel ->Pointer acceleration</guilabel -> value, the higher you'll want to set the <guilabel ->Pointer threshold</guilabel -> value. For example, A <guilabel ->Pointer threshold</guilabel -> of 4 pixels may be appropriate for a <guilabel ->Pointer Acceleration</guilabel -> of 2x, but 10 pixels might be better for 3x.</para -></tip> +<para>The threshold is the smallest distance that the mouse pointer must move on the screen before acceleration has any effect. If the movement is within the threshold, the mouse pointer moves as if the acceleration were set to <guilabel>1x</guilabel>.</para> + +<para>Thus, when you make small movements with the physical device (⪚ mouse), you still have fine control of the mouse pointer on the screen, whereas larger movements of the physical device will move the mouse pointer rapidly to different areas on the screen.</para> + +<para>You can set the threshold value by dragging the slider button or by clicking the up/down arrows on the spin-button to the left of the slider.</para> + +<tip><para>In general, the higher you set the <guilabel>Pointer acceleration</guilabel> value, the higher you'll want to set the <guilabel>Pointer threshold</guilabel> value. For example, A <guilabel>Pointer threshold</guilabel> of 4 pixels may be appropriate for a <guilabel>Pointer Acceleration</guilabel> of 2x, but 10 pixels might be better for 3x.</para></tip> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Double click interval</guilabel -></term> +<term><guilabel>Double click interval</guilabel></term> <listitem> -<para ->This is the maximum amount of time between clicks for &kde; to register a double click. If you click twice, and the time between those two clicks is less than this number, &kde; recognises that as a double click. If the time between these two clicks is greater than this number, &kde; recognises those as two <emphasis ->separate</emphasis -> single clicks.</para> +<para>This is the maximum amount of time between clicks for &kde; to register a double click. If you click twice, and the time between those two clicks is less than this number, &kde; recognises that as a double click. If the time between these two clicks is greater than this number, &kde; recognises those as two <emphasis>separate</emphasis> single clicks.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Drag start time</guilabel -> and <guilabel ->Drag start distance</guilabel -></term> +<term><guilabel>Drag start time</guilabel> and <guilabel>Drag start distance</guilabel></term> <listitem> -<para ->If you <itemizedlist -> <listitem -><para ->click with the mouse</para -></listitem -> <listitem -><para ->drag within the time specified in <guilabel ->Drag start time</guilabel ->, and </para -></listitem -> <listitem -><para ->move a distance equal to or greater than the number (of pixels) specified in <guilabel ->Drag start distance</guilabel -></para -> </listitem -> </itemizedlist -> &kde; will drag the selected item.</para> +<para>If you <itemizedlist> <listitem><para>click with the mouse</para></listitem> <listitem><para>drag within the time specified in <guilabel>Drag start time</guilabel>, and </para></listitem> <listitem><para>move a distance equal to or greater than the number (of pixels) specified in <guilabel>Drag start distance</guilabel></para> </listitem> </itemizedlist> &kde; will drag the selected item.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Mouse wheel scrolls by</guilabel -></term> +<term><guilabel>Mouse wheel scrolls by</guilabel></term> <listitem> -<para ->If you have a wheel mouse, use the slider to determine how many lines of text one <quote ->step</quote -> of the mouse wheel will scroll.</para> +<para>If you have a wheel mouse, use the slider to determine how many lines of text one <quote>step</quote> of the mouse wheel will scroll.</para> </listitem> </varlistentry> @@ -334,97 +158,52 @@ </sect2> <sect2 id="mouse-navigation"> -<title -><guilabel ->Mouse Navigation</guilabel -></title> +<title><guilabel>Mouse Navigation</guilabel></title> -<para ->This tab allows you to configure the keyboard number pad keys as a mouse-type device. This may be useful when you are working on a device without another pointing device, or where you have no other use for the number pad. </para> +<para>This tab allows you to configure the keyboard number pad keys as a mouse-type device. This may be useful when you are working on a device without another pointing device, or where you have no other use for the number pad. </para> <variablelist> <varlistentry> -<term -><guilabel ->Move pointer with keyboard (using the num pad)</guilabel -></term> +<term><guilabel>Move pointer with keyboard (using the num pad)</guilabel></term> <listitem> -<para ->To enable keyboard mouse mode, you need to select the checkbox labelled <guilabel ->Move pointer with keyboard (using the num pad)</guilabel ->. When you do this, the other settings will become enabled, and you can customise the keyboard pointer behaviour further, if required. </para> -<para ->The various keys on the number pad move in the direction you would expect. Note that you can move diagonally as well as up, down, left and right. The <keycap ->5</keycap -> key emulates a click to a pointer button, typically &LMB;. You change which button is emulated by using the <keycap ->/</keycap -> key (which makes it &LMB;), <keycap ->*</keycap -> key (which makes it &MMB;) and <keycap ->-</keycap -> (which makes it &RMB;). Using the <keycap ->+</keycap -> emulates a doubleclick to the selected pointer button. You can use the <keycap ->0</keycap -> key to emulate holding down the selected pointer button (for easy dragging), and then use the <keycap ->.</keycap -> to emulate releasing the selected pointer button. </para> +<para>To enable keyboard mouse mode, you need to select the checkbox labelled <guilabel>Move pointer with keyboard (using the num pad)</guilabel>. When you do this, the other settings will become enabled, and you can customise the keyboard pointer behaviour further, if required. </para> +<para>The various keys on the number pad move in the direction you would expect. Note that you can move diagonally as well as up, down, left and right. The <keycap>5</keycap> key emulates a click to a pointer button, typically &LMB;. You change which button is emulated by using the <keycap>/</keycap> key (which makes it &LMB;), <keycap>*</keycap> key (which makes it &MMB;) and <keycap>-</keycap> (which makes it &RMB;). Using the <keycap>+</keycap> emulates a doubleclick to the selected pointer button. You can use the <keycap>0</keycap> key to emulate holding down the selected pointer button (for easy dragging), and then use the <keycap>.</keycap> to emulate releasing the selected pointer button. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Acceleration delay</guilabel -></term> +<term><guilabel>Acceleration delay</guilabel></term> <listitem> -<para ->This is the time (in milliseconds) between the initial key press and the first repeated motion event for mouse key acceleration. </para> +<para>This is the time (in milliseconds) between the initial key press and the first repeated motion event for mouse key acceleration. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Repeat interval</guilabel -></term> +<term><guilabel>Repeat interval</guilabel></term> <listitem> -<para ->This is the time in milliseconds between repeated motion events for mouse key acceleration. </para> +<para>This is the time in milliseconds between repeated motion events for mouse key acceleration. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Acceleration time</guilabel -></term> +<term><guilabel>Acceleration time</guilabel></term> <listitem> -<para ->This is the number of key events before the pointer reaches a maximum speed for mouse key acceleration. </para> +<para>This is the number of key events before the pointer reaches a maximum speed for mouse key acceleration. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Maximum speed</guilabel -></term> +<term><guilabel>Maximum speed</guilabel></term> <listitem> -<para ->This is the maximum speed in pixels per key event the pointer can reach for mouse key acceleration. </para> +<para>This is the maximum speed in pixels per key event the pointer can reach for mouse key acceleration. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Acceleration profile</guilabel -></term> +<term><guilabel>Acceleration profile</guilabel></term> <listitem> -<para ->This is the slope of the acceleration curve for mouse key acceleration. </para> +<para>This is the slope of the acceleration curve for mouse key acceleration. </para> </listitem> </varlistentry> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/netpref/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/netpref/index.docbook index bb7c2e8fc55..c9517512ca5 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/netpref/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/netpref/index.docbook @@ -2,132 +2,76 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> - -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> + +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-10-16</date> -<releaseinfo ->3.1</releaseinfo> +<date>2002-10-16</date> +<releaseinfo>3.1</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->tdebase</keyword> -<keyword ->kcontrol</keyword> -<keyword ->network</keyword> -<keyword ->timeouts</keyword> +<keyword>KDE</keyword> +<keyword>tdebase</keyword> +<keyword>kcontrol</keyword> +<keyword>network</keyword> +<keyword>timeouts</keyword> </keywordset> </articleinfo> <sect1 id="timeouts"> -<title ->Preferences</title> +<title>Preferences</title> -<para ->Here you can set timeout values. You might want to tweak them if your connection is very slow, but the default settings are appropriate for most users.</para> +<para>Here you can set timeout values. You might want to tweak them if your connection is very slow, but the default settings are appropriate for most users.</para> -<para ->Here <guilabel ->Timeout Values</guilabel -> are the length of time an application should wait for an answer from a network operation.</para> +<para>Here <guilabel>Timeout Values</guilabel> are the length of time an application should wait for an answer from a network operation.</para> -<para ->You can configure the following timeouts:</para> +<para>You can configure the following timeouts:</para> <variablelist> <varlistentry> -<term -><guilabel ->Socket Read</guilabel -></term> +<term><guilabel>Socket Read</guilabel></term> <listitem> -<para ->Some applications use <firstterm ->sockets</firstterm -> to communicate. You can think of a socket as a water tap; while it is open, water (or in our case, data) comes out, without any interaction. If something stops this flow of data, the application will wait for more to come. This could be a very long time, but you can configure a maximum time for an application to wait with this option.</para> -<para ->This setting will only apply to &kde; applications, of course.</para> +<para>Some applications use <firstterm>sockets</firstterm> to communicate. You can think of a socket as a water tap; while it is open, water (or in our case, data) comes out, without any interaction. If something stops this flow of data, the application will wait for more to come. This could be a very long time, but you can configure a maximum time for an application to wait with this option.</para> +<para>This setting will only apply to &kde; applications, of course.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Proxy Connect</guilabel -></term> +<term><guilabel>Proxy Connect</guilabel></term> <listitem> -<para ->Sets how long to wait for a connection to a proxy server, if one is configured. </para> +<para>Sets how long to wait for a connection to a proxy server, if one is configured. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Server Connect</guilabel -></term> +<term><guilabel>Server Connect</guilabel></term> <listitem> -<para ->Sets how long to wait for a connection to a remote server. </para> +<para>Sets how long to wait for a connection to a remote server. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Server Response</guilabel -></term> +<term><guilabel>Server Response</guilabel></term> <listitem> -<para ->Sets how long to wait for a reply from a remote server. </para> +<para>Sets how long to wait for a reply from a remote server. </para> </listitem> </varlistentry> </variablelist> -<para ->You can configure <guilabel ->FTP Options</guilabel -> here. At present there is just one option, <guilabel ->Enable Passive Mode (PASV)</guilabel ->.</para> - -<para ->Passive &FTP; is often required when you are behind a firewall. Many firewalls only permit connections that were initiated from <quote ->the inside</quote ->. Passive &FTP; is controlled by the client, which makes it usable through firewalls.</para> +<para>You can configure <guilabel>FTP Options</guilabel> here. At present there is just one option, <guilabel>Enable Passive Mode (PASV)</guilabel>.</para> + +<para>Passive &FTP; is often required when you are behind a firewall. Many firewalls only permit connections that were initiated from <quote>the inside</quote>. Passive &FTP; is controlled by the client, which makes it usable through firewalls.</para> </sect1> </article>
\ No newline at end of file diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/panel/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/panel/index.docbook index 9b28919dd8a..193d74f4465 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/panel/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/panel/index.docbook @@ -2,316 +2,132 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-08</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-08</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->panel</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>panel</keyword> </keywordset> </articleinfo> <sect1 id="panel"> -<title ->Panel</title> +<title>Panel</title> -<para ->The &kde; panel (often referred to as &kicker;) is the bar that you'll usually find at the bottom of the screen when you start up &kde; for the first time. The panel gives you quick access to applications and makes it easier for you to organise your desktop. Using the &kde; panel you can: </para> +<para>The &kde; panel (often referred to as &kicker;) is the bar that you'll usually find at the bottom of the screen when you start up &kde; for the first time. The panel gives you quick access to applications and makes it easier for you to organise your desktop. Using the &kde; panel you can: </para> <itemizedlist> -<listitem -><para ->launch applications using the <guimenu ->K</guimenu -> menu or the application buttons</para -></listitem> -<listitem -><para ->switch desktops using the panel's pager applet</para> +<listitem><para>launch applications using the <guimenu>K</guimenu> menu or the application buttons</para></listitem> +<listitem><para>switch desktops using the panel's pager applet</para> </listitem> -<listitem -><para ->switch active windows, and minimise or maximise them</para> +<listitem><para>switch active windows, and minimise or maximise them</para> </listitem> -<listitem -><para ->browse folder using the browser menu functionality </para -></listitem> -<listitem -><para ->access panel applets that extend the panel's functionality, offering for example mixers, clocks or a system monitor</para -> </listitem> +<listitem><para>browse folder using the browser menu functionality </para></listitem> +<listitem><para>access panel applets that extend the panel's functionality, offering for example mixers, clocks or a system monitor</para> </listitem> </itemizedlist> <sect2 id="panel-position"> -<title ->Arrangement</title> - -<para ->In the <guilabel ->Arrangement</guilabel -> tab you can configure the size and position of the panel.</para> - -<para ->In the section labelled <guilabel ->Position</guilabel -> is a set of 12 small buttons arranged in a square. Each button corresponds to a location for the panel. Click on a button and notice where the panel is located on the preview monitor to the right.</para> - -<tip -><para ->Generally, the available space in kicker is used more efficiently if the panel is aligned horizontally, &ie; attached to the top or bottom screen border.</para -></tip> - -<para ->In the section labelled <guilabel ->Length</guilabel ->, you can use the combo box and slider to adjust the <emphasis ->minimum</emphasis -> length of the panel. If you place a mark in the checkbox labeled <guilabel ->Expand as required to fit contents</guilabel ->, the panel will become longer if more space is needed. When less space is required on the panel, the panel will shrink down to the minimum size. If there is no mark in the checkbox, then the panel is fixed to the length specified in this section.</para> - -<para ->The final section of this table is labeled <guilabel ->Size</guilabel ->, and refers to the <emphasis ->height</emphasis -> of the panel. The panel's size can be <guilabel ->Tiny</guilabel ->, <guilabel ->Small</guilabel ->, <guilabel ->Medium</guilabel ->, <guilabel ->Large</guilabel -> or <guilabel ->Custom</guilabel ->. If you choose <guilabel ->Custom</guilabel -> mode, you can resize &kicker; by specifying a height in the combobox.</para> - -<para ->If you have multiple monitors, you can configure the panel for each screen entirely independently. If you are not sure which screen is which, Press the <guibutton ->Identify</guibutton -> and a number will appear centred on each screen.</para> - -<para ->Then simply choose the screen you wish to configure from the drop down box labelled <guilabel ->Xinerama screen</guilabel ->, or choose <guilabel ->All Screens</guilabel -> to have identical configurations on each.</para> +<title>Arrangement</title> + +<para>In the <guilabel>Arrangement</guilabel> tab you can configure the size and position of the panel.</para> + +<para>In the section labelled <guilabel>Position</guilabel> is a set of 12 small buttons arranged in a square. Each button corresponds to a location for the panel. Click on a button and notice where the panel is located on the preview monitor to the right.</para> + +<tip><para>Generally, the available space in kicker is used more efficiently if the panel is aligned horizontally, &ie; attached to the top or bottom screen border.</para></tip> + +<para>In the section labelled <guilabel>Length</guilabel>, you can use the combo box and slider to adjust the <emphasis>minimum</emphasis> length of the panel. If you place a mark in the checkbox labeled <guilabel>Expand as required to fit contents</guilabel>, the panel will become longer if more space is needed. When less space is required on the panel, the panel will shrink down to the minimum size. If there is no mark in the checkbox, then the panel is fixed to the length specified in this section.</para> + +<para>The final section of this table is labeled <guilabel>Size</guilabel>, and refers to the <emphasis>height</emphasis> of the panel. The panel's size can be <guilabel>Tiny</guilabel>, <guilabel>Small</guilabel>, <guilabel>Medium</guilabel>, <guilabel>Large</guilabel> or <guilabel>Custom</guilabel>. If you choose <guilabel>Custom</guilabel> mode, you can resize &kicker; by specifying a height in the combobox.</para> + +<para>If you have multiple monitors, you can configure the panel for each screen entirely independently. If you are not sure which screen is which, Press the <guibutton>Identify</guibutton> and a number will appear centred on each screen.</para> + +<para>Then simply choose the screen you wish to configure from the drop down box labelled <guilabel>Xinerama screen</guilabel>, or choose <guilabel>All Screens</guilabel> to have identical configurations on each.</para> </sect2> <sect2 id="panel-hiding"> -<title ->Hiding</title> - -<para ->Depending on your screen resolution you may find that the panel takes away too much of your precious screen real estate. To save screen space, the panel offers manual hiding of the panel, an auto hide feature, and the ability to allow other windows to lay on top of the panel. These features are selected in the section entitled <guilabel ->Hide Mode</guilabel ->.</para> - -<para ->The <guilabel ->Hide Mode</guilabel -> section has three options:</para> +<title>Hiding</title> + +<para>Depending on your screen resolution you may find that the panel takes away too much of your precious screen real estate. To save screen space, the panel offers manual hiding of the panel, an auto hide feature, and the ability to allow other windows to lay on top of the panel. These features are selected in the section entitled <guilabel>Hide Mode</guilabel>.</para> + +<para>The <guilabel>Hide Mode</guilabel> section has three options:</para> <variablelist> <varlistentry> -<term -><guilabel ->Only hide when panel-hiding button is clicked</guilabel -></term> -<listitem -><para ->When this option is selected, the panel will remain visible at the location you defined unless you click on the button at the far right (for horizontally oriented) or bottom (for vertically oriented) button. This button has an arrow on it pointed to the edge of the screen.</para> - -<para ->Once clicked, the panel will disappear. If the button is clicked again, the panel will re-appear at the same location.</para> +<term><guilabel>Only hide when panel-hiding button is clicked</guilabel></term> +<listitem><para>When this option is selected, the panel will remain visible at the location you defined unless you click on the button at the far right (for horizontally oriented) or bottom (for vertically oriented) button. This button has an arrow on it pointed to the edge of the screen.</para> + +<para>Once clicked, the panel will disappear. If the button is clicked again, the panel will re-appear at the same location.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Hide automatically</guilabel -></term> -<listitem -><para ->If this option is selected, then the panel will automatically disappear after the number of seconds specified in the combo box below the option. To make the panel reappear, simply move the mouse pointer to the edge of the screen where the panel is located, and the panel will reappear immediately.</para> - -<para ->If you place a mark in the checkbox labelled <guilabel ->Show panel when switching desktops</guilabel ->, the panel will automatically reappear when you switch desktops. (The panel will disappear again after the specified number of seconds.)</para> +<term><guilabel>Hide automatically</guilabel></term> +<listitem><para>If this option is selected, then the panel will automatically disappear after the number of seconds specified in the combo box below the option. To make the panel reappear, simply move the mouse pointer to the edge of the screen where the panel is located, and the panel will reappear immediately.</para> + +<para>If you place a mark in the checkbox labelled <guilabel>Show panel when switching desktops</guilabel>, the panel will automatically reappear when you switch desktops. (The panel will disappear again after the specified number of seconds.)</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Allow other windows to cover the panel</guilabel -></term> -<listitem -><para ->As this option's label implies, the panel is always on the desktop when this option is selected. It is now possible, however, for application windows to lay on top of the panel.</para -> - -<para ->To restore the panel, simply move the mouse cursor to the screen location specified in the drop box labeled <guilabel ->Raise when the pointer touches the screen's:</guilabel ->. You can change this value by selecting one of the choices provided in the drop down box.</para> - -<para ->Once the panel has moved back on top of the application window, it will stay there until the application window becomes active again.</para> +<term><guilabel>Allow other windows to cover the panel</guilabel></term> +<listitem><para>As this option's label implies, the panel is always on the desktop when this option is selected. It is now possible, however, for application windows to lay on top of the panel.</para> + +<para>To restore the panel, simply move the mouse cursor to the screen location specified in the drop box labeled <guilabel>Raise when the pointer touches the screen's:</guilabel>. You can change this value by selecting one of the choices provided in the drop down box.</para> + +<para>Once the panel has moved back on top of the application window, it will stay there until the application window becomes active again.</para> </listitem> </varlistentry> </variablelist> -<para ->The next section down is labelled <guilabel ->Panel-Hiding Buttons</guilabel ->. It consists of two check boxes: <guilabel ->Show left panel-hiding button</guilabel -> and <guilabel ->Show left panel-hiding button</guilabel ->. Use these checkboxes to show and hide the left and right manual panel hiding buttons.</para> - -<para ->If there is no mark in the checkbox labeled <guilabel ->Animate panel hiding</guilabel ->, then whenever the toolbar is hidden, is simply disappears. If there is a mark in the check box, then the panel appears to slide off the edge of the screen.</para> - -<para ->You can determine how quickly the panel appears to move by adjusting the slider from <guilabel ->Fast</guilabel -> to <guilabel ->Slow</guilabel ->.</para> +<para>The next section down is labelled <guilabel>Panel-Hiding Buttons</guilabel>. It consists of two check boxes: <guilabel>Show left panel-hiding button</guilabel> and <guilabel>Show left panel-hiding button</guilabel>. Use these checkboxes to show and hide the left and right manual panel hiding buttons.</para> + +<para>If there is no mark in the checkbox labeled <guilabel>Animate panel hiding</guilabel>, then whenever the toolbar is hidden, is simply disappears. If there is a mark in the check box, then the panel appears to slide off the edge of the screen.</para> + +<para>You can determine how quickly the panel appears to move by adjusting the slider from <guilabel>Fast</guilabel> to <guilabel>Slow</guilabel>.</para> </sect2> <sect2 id="panel-menus"> -<title ->Menus</title> +<title>Menus</title> -<para ->In the <guilabel ->Menus</guilabel -> tab you can configure the panel menu's behaviour. This affects the TDE menu you will often use to launch applications, the browser menus you can use to access folders and other menus like the recent documents menu.</para> +<para>In the <guilabel>Menus</guilabel> tab you can configure the panel menu's behaviour. This affects the TDE menu you will often use to launch applications, the browser menus you can use to access folders and other menus like the recent documents menu.</para> -<para ->The <guilabel ->TDE Menu</guilabel -> frame offers you some options to configure the <guimenu ->K</guimenu -> menu's functionality. This frame consists of 4 items:</para> +<para>The <guilabel>TDE Menu</guilabel> frame offers you some options to configure the <guimenu>K</guimenu> menu's functionality. This frame consists of 4 items:</para> <itemizedlist> -<listitem -><para ->The <guilabel ->Menu item format:</guilabel -> radio buttons have three options. This determines how the application name (&ie; &konqueror;, &kword;, &etc;) and the description (&ie; Web Browser, Word Processor, &etc;) are displayed on the TDE menu. </para -></listitem> - -<listitem -><para ->The <guilabel ->Optional Sub Menus</guilabel -> checkboxes allow you to determine which special menu items appear in the TDE Menu.</para> -<para ->The <guilabel ->Bookmarks</guilabel -> menu allows you to quickly select from the same bookmarks that are available in &konqueror;. </para> -<para ->The <guilabel ->Find</guilabel -> menu offers access to the &kfind; application to search for local files, and a quick link to a search engine to search for things on the Internet.</para> - -<para ->The <guilabel ->Preferences</guilabel -> menu allows you to launch each &kcontrol; module directly from the TDE menu.</para> -<para ->The <guilabel ->Print System</guilabel -> menu provides several menu entries to help manage the printer(s) attached to your system.</para> -<para ->The <guilabel ->Quick Browser</guilabel -> menu gives you quick links to locations on your hard drive.</para> -<para ->The <guilabel ->Recent Documents</guilabel -> menu lists the most recently edited documents and will automatically launch the application to edit or view this document. </para> -<para ->The <guilabel ->Terminal Sessions</guilabel -> menu provides menu items to launch several different types of terminal programs (command line interfaces).</para> +<listitem><para>The <guilabel>Menu item format:</guilabel> radio buttons have three options. This determines how the application name (&ie; &konqueror;, &kword;, &etc;) and the description (&ie; Web Browser, Word Processor, &etc;) are displayed on the TDE menu. </para></listitem> + +<listitem><para>The <guilabel>Optional Sub Menus</guilabel> checkboxes allow you to determine which special menu items appear in the TDE Menu.</para> +<para>The <guilabel>Bookmarks</guilabel> menu allows you to quickly select from the same bookmarks that are available in &konqueror;. </para> +<para>The <guilabel>Find</guilabel> menu offers access to the &kfind; application to search for local files, and a quick link to a search engine to search for things on the Internet.</para> + +<para>The <guilabel>Preferences</guilabel> menu allows you to launch each &kcontrol; module directly from the TDE menu.</para> +<para>The <guilabel>Print System</guilabel> menu provides several menu entries to help manage the printer(s) attached to your system.</para> +<para>The <guilabel>Quick Browser</guilabel> menu gives you quick links to locations on your hard drive.</para> +<para>The <guilabel>Recent Documents</guilabel> menu lists the most recently edited documents and will automatically launch the application to edit or view this document. </para> +<para>The <guilabel>Terminal Sessions</guilabel> menu provides menu items to launch several different types of terminal programs (command line interfaces).</para> </listitem> -<listitem -><para -><guilabel ->Show side image</guilabel -> will add a small image to the side of the menu. This is purely decorative.</para -></listitem> - -<listitem -><para ->The <guibutton ->Edit TDE Menu</guibutton -> button launches the &kde; menu editor.</para -></listitem> +<listitem><para><guilabel>Show side image</guilabel> will add a small image to the side of the menu. This is purely decorative.</para></listitem> + +<listitem><para>The <guibutton>Edit TDE Menu</guibutton> button launches the &kde; menu editor.</para></listitem> </itemizedlist> -<para ->In the <guilabel ->QuickBrowser Menus</guilabel -> area you can configure whether the panel's browser menus will show hidden files or not (hidden files on unix systems are those whose filenames begin with a dot) as well as how many files at most will be shown in a browser menu. The latter option may be especially useful if you have a rather small screen resolution, as then the browser menus will quickly fill up your screen when you browse folders containing many files.</para> - -<para ->The quick start section in the TDE menu offers quick access to programs you have used often or recently. In the <guilabel ->Quick Start Menu Items</guilabel -> frame you can choose whether this section will show the most recently or the most frequently used programs. Using the option <guilabel ->Maximum number of entries</guilabel -> combo box, you can configure how many programs the quick start section will remember.</para> +<para>In the <guilabel>QuickBrowser Menus</guilabel> area you can configure whether the panel's browser menus will show hidden files or not (hidden files on unix systems are those whose filenames begin with a dot) as well as how many files at most will be shown in a browser menu. The latter option may be especially useful if you have a rather small screen resolution, as then the browser menus will quickly fill up your screen when you browse folders containing many files.</para> + +<para>The quick start section in the TDE menu offers quick access to programs you have used often or recently. In the <guilabel>Quick Start Menu Items</guilabel> frame you can choose whether this section will show the most recently or the most frequently used programs. Using the option <guilabel>Maximum number of entries</guilabel> combo box, you can configure how many programs the quick start section will remember.</para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/panelappearance/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/panelappearance/index.docbook index 562d2f264a9..4efbd76d42f 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/panelappearance/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/panelappearance/index.docbook @@ -2,170 +2,75 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author -><firstname ->Mike</firstname -> <surname ->McBride</surname -> </author> -<author -><firstname ->Jost</firstname -> <surname ->Schenck</surname -> </author> -<othercredit role="translator" -><firstname ->Jonathan</firstname -><surname ->Riddell</surname -><affiliation -><address -><email ->kde-en-gb@jriddell.org</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author><firstname>Mike</firstname> <surname>McBride</surname> </author> +<author><firstname>Jost</firstname> <surname>Schenck</surname> </author> +<othercredit role="translator"><firstname>Jonathan</firstname><surname>Riddell</surname><affiliation><address><email>kde-en-gb@jriddell.org</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-06</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-06</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->panel</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>panel</keyword> </keywordset> </articleinfo> <sect1 id="panel"> -<title ->Panel</title> +<title>Panel</title> -<para ->Here you can configure the panel's overall appearance.</para> +<para>Here you can configure the panel's overall appearance.</para> -<para ->You can also have the icons themselves zoom out when the mouse is over them, with the <guilabel ->Enable icon zooming</guilabel -> option. You can choose to have tooltips appear when your mouse button is over an icon, by enabling the <guilabel ->Show tooltips</guilabel -> option.</para> +<para>You can also have the icons themselves zoom out when the mouse is over them, with the <guilabel>Enable icon zooming</guilabel> option. You can choose to have tooltips appear when your mouse button is over an icon, by enabling the <guilabel>Show tooltips</guilabel> option.</para> <sect2 id="button-backgrounds"> -<title ->Button Backgrounds</title> - -<para ->The &kde; panel supports so-called <guilabel ->Button Backgrounds</guilabel ->. This means that the buttons shown on the panel will be drawn using configurable images. To enable button backgrounds, simply choose the button type from the list, and change the drop down box to the colour image you would like to use. Choose <guilabel ->Default</guilabel -> to return to an unstyled button. If you choose <guilabel ->Custom colour</guilabel ->, the colour button next to the drop down list will be enabled. Click on it to select a custom colour to use.</para> +<title>Button Backgrounds</title> + +<para>The &kde; panel supports so-called <guilabel>Button Backgrounds</guilabel>. This means that the buttons shown on the panel will be drawn using configurable images. To enable button backgrounds, simply choose the button type from the list, and change the drop down box to the colour image you would like to use. Choose <guilabel>Default</guilabel> to return to an unstyled button. If you choose <guilabel>Custom colour</guilabel>, the colour button next to the drop down list will be enabled. Click on it to select a custom colour to use.</para> </sect2> <sect2 id="panel-background"> -<title -><guilabel ->Panel Background</guilabel -></title> - -<para -><guilabel ->Enable transparency</guilabel -> to turn the entire panel transparent. The desktop background will show through instead of a solid colour panel.</para> - -<para ->There will still be small handles beside each applet, to allow you to locate, move, and configure them. These can be turned off in the <guilabel ->Advanced Options...</guilabel -></para> - -<para ->If you check <guilabel ->Enable background image</guilabel -> a picture that will be used to draw the panel's background, just as you can use a picture for the desktop background. You can specify an image file in the line edit box below or choose one by clicking on the <guibutton ->Browse</guibutton -> button. You'll see a preview of the selected picture on the right.</para> - -<para ->The image can be tinted on-the-fly by enabling the option <guilabel ->Colour to match the desktop colour scheme</guilabel ->. You might use a greyscale texture that is tinted in this manner, to create a particular effect.</para> +<title><guilabel>Panel Background</guilabel></title> + +<para><guilabel>Enable transparency</guilabel> to turn the entire panel transparent. The desktop background will show through instead of a solid colour panel.</para> + +<para>There will still be small handles beside each applet, to allow you to locate, move, and configure them. These can be turned off in the <guilabel>Advanced Options...</guilabel></para> + +<para>If you check <guilabel>Enable background image</guilabel> a picture that will be used to draw the panel's background, just as you can use a picture for the desktop background. You can specify an image file in the line edit box below or choose one by clicking on the <guibutton>Browse</guibutton> button. You'll see a preview of the selected picture on the right.</para> + +<para>The image can be tinted on-the-fly by enabling the option <guilabel>Colour to match the desktop colour scheme</guilabel>. You might use a greyscale texture that is tinted in this manner, to create a particular effect.</para> </sect2> <sect2 id="advanced-options"> -<title -><guilabel ->Advanced Options...</guilabel -></title> - -<para ->The <guilabel ->Hide button size:</guilabel -> option allows you to choose a width in pixels for the hide buttons, if they are visible.</para> - -<para ->The panel itself has several default sizes set, which you can switch between by simply dragging the edge of it, or by &RMB; clicking on an empty space in the panel, choosing <guisubmenu ->Size</guisubmenu -> and selecting the desired size from the submenu. If you enable <guilabel ->Allow Drag and Drop resizing of panels</guilabel -> then by choosing <guimenuitem ->Custom</guimenuitem -> in the panel menu, you can drag the panel edge to any size you like.</para> - -<para ->Applet handles are normally visible beside each applet on the panel, so that it is clear where to click to configure them, or to get to the panel menu. You can instead have them <guilabel ->Fade out</guilabel ->, or hide unless you hover the mouse over them, or you can choose to <guilabel ->Hide</guilabel -> them completely.</para> - -<para ->Finally, if the panel is transparent, you can tint it with a colour of your choice. The slider allows you to choose how opaque the tint is. At the lowest end, there is no tint visible, while at the highest, the panel is not transparent at all.</para> +<title><guilabel>Advanced Options...</guilabel></title> + +<para>The <guilabel>Hide button size:</guilabel> option allows you to choose a width in pixels for the hide buttons, if they are visible.</para> + +<para>The panel itself has several default sizes set, which you can switch between by simply dragging the edge of it, or by &RMB; clicking on an empty space in the panel, choosing <guisubmenu>Size</guisubmenu> and selecting the desired size from the submenu. If you enable <guilabel>Allow Drag and Drop resizing of panels</guilabel> then by choosing <guimenuitem>Custom</guimenuitem> in the panel menu, you can drag the panel edge to any size you like.</para> + +<para>Applet handles are normally visible beside each applet on the panel, so that it is clear where to click to configure them, or to get to the panel menu. You can instead have them <guilabel>Fade out</guilabel>, or hide unless you hover the mouse over them, or you can choose to <guilabel>Hide</guilabel> them completely.</para> + +<para>Finally, if the panel is transparent, you can tint it with a colour of your choice. The slider allows you to choose how opaque the tint is. At the lowest end, there is no tint visible, while at the highest, the panel is not transparent at all.</para> </sect2> <sect2 id="panel-author"> -<title ->Section Author</title> -<para ->This section written by: Jost Schenck <email ->jost@schenck.de</email -></para> -<para ->Minor update by Mike McBride <email ->mpmcbride7@yahoo.com</email -></para> - -<para ->Some new options added by Lauri Watts <email ->lauri@kde.org</email -></para> - -<para ->Jonathan Riddell<email ->kde-en-gb@jriddell.org</email -></para -> +<title>Section Author</title> +<para>This section written by: Jost Schenck <email>jost@schenck.de</email></para> +<para>Minor update by Mike McBride <email>mpmcbride7@yahoo.com</email></para> + +<para>Some new options added by Lauri Watts <email>lauri@kde.org</email></para> + +<para>Jonathan Riddell<email>kde-en-gb@jriddell.org</email></para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/passwords/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/passwords/index.docbook index 486f35b7c11..d433efdc682 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/passwords/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/passwords/index.docbook @@ -2,101 +2,53 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-16</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-16</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->password</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>password</keyword> </keywordset> </articleinfo> <sect1 id="passwords"> -<title ->Passwords</title> +<title>Passwords</title> <sect2 id="passwords-intro"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->This module of the &kcontrol; gives you options for configuring the way in which the &tdesu; program treats passwords. &tdesu; will ask you for a password when you try to carry out some privileged actions, such as changing the date/time stored in your system clock, or adding new users on your computer.</para> +<para>This module of the &kcontrol; gives you options for configuring the way in which the &tdesu; program treats passwords. &tdesu; will ask you for a password when you try to carry out some privileged actions, such as changing the date/time stored in your system clock, or adding new users on your computer.</para> -<para ->Privileged actions such as those described above can only be carried out by <systemitem class="username" ->root</systemitem -> or a user with administrator permissions on your system. You will need to enter the password for the root account when you want to carry out such actions.</para> +<para>Privileged actions such as those described above can only be carried out by <systemitem class="username">root</systemitem> or a user with administrator permissions on your system. You will need to enter the password for the root account when you want to carry out such actions.</para> -<important -><para ->The options in this module do not affect the behaviour of passwords in other programs such as &kmail;.</para> +<important><para>The options in this module do not affect the behaviour of passwords in other programs such as &kmail;.</para> </important> </sect2> <sect2 id="passwords-use"> -<title ->Use</title> - -<para ->There are two configuration options for passwords. The first is to control the visual feedback that you receive when you type a password. The actual characters in the password are never shown on the screen. You can choose to have each character represented by a <token ->*</token -> character. If you want to make it harder for someone who might be watching your screen to figure out how many characters there are in the password, you can choose to have each character in the password be represented by three asterisks rather than just one. Still another option is not to have any visual feedback at all, so nothing appears on the screen when you type a password.</para> - -<para ->If you work in a reasonably secure environment, you can check the option labelled <guilabel ->Remember Passwords</guilabel ->, and then choose a time period in minutes using the spinner labelled <guilabel ->Timeout</guilabel ->. (You can either type a number between 5 and 1200 minutes, or use the arrows on the spinner.)</para> - -<para ->If the <guilabel ->Remember passwords</guilabel -> option has been selected, <application ->tdesu</application -> will not ask you for a password for the length of time specified, after you have given the password once. Keep in mind, however, that this makes your workstation less secure.</para> - -<important -><para ->You should avoid selecting the <guilabel ->Remember passwords</guilabel -> option if you are working in an insecure area, such as a publicly accessible workstation. Also, note that choosing a shorter timeout may be better if you are in a less secure environment.</para -></important> +<title>Use</title> + +<para>There are two configuration options for passwords. The first is to control the visual feedback that you receive when you type a password. The actual characters in the password are never shown on the screen. You can choose to have each character represented by a <token>*</token> character. If you want to make it harder for someone who might be watching your screen to figure out how many characters there are in the password, you can choose to have each character in the password be represented by three asterisks rather than just one. Still another option is not to have any visual feedback at all, so nothing appears on the screen when you type a password.</para> + +<para>If you work in a reasonably secure environment, you can check the option labelled <guilabel>Remember Passwords</guilabel>, and then choose a time period in minutes using the spinner labelled <guilabel>Timeout</guilabel>. (You can either type a number between 5 and 1200 minutes, or use the arrows on the spinner.)</para> + +<para>If the <guilabel>Remember passwords</guilabel> option has been selected, <application>tdesu</application> will not ask you for a password for the length of time specified, after you have given the password once. Keep in mind, however, that this makes your workstation less secure.</para> + +<important><para>You should avoid selecting the <guilabel>Remember passwords</guilabel> option if you are working in an insecure area, such as a publicly accessible workstation. Also, note that choosing a shorter timeout may be better if you are in a less secure environment.</para></important> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/proxy/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/proxy/index.docbook index ac3eb8e7490..89100936044 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/proxy/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/proxy/index.docbook @@ -3,8 +3,7 @@ "dtd/kdex.dtd" [ <!ENTITY socks-kcontrol SYSTEM "socks.docbook"> <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> @@ -12,186 +11,93 @@ <authorgroup> -<author ->&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> -<othercredit role="translator" -><firstname ->Jonathan</firstname -><surname ->Riddell</surname -><affiliation -><address -><email ->kde-en-gb@jriddell.org</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> +<othercredit role="translator"><firstname>Jonathan</firstname><surname>Riddell</surname><affiliation><address><email>kde-en-gb@jriddell.org</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-11</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-11</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->proxy</keyword> -<keyword ->proxies</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>proxy</keyword> +<keyword>proxies</keyword> </keywordset> </articleinfo> <sect1 id="proxies"> -<title ->Proxies</title> +<title>Proxies</title> <sect2 id="proxies-intro"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->Proxies are programs running on a computer that acts a server on the network you are connected to (whether by modem or other means). These programs receive &HTTP; and &FTP; requests, retrieve the relevant files from the internet, and pass them on to the client computer that made the requests.</para> +<para>Proxies are programs running on a computer that acts a server on the network you are connected to (whether by modem or other means). These programs receive &HTTP; and &FTP; requests, retrieve the relevant files from the internet, and pass them on to the client computer that made the requests.</para> -<para ->When you have configured a proxy, &HTTP; and/or &FTP; requests are re-routed through the computer that is acting as a proxy server. However, you can also select specific hosts which should be contacted directly, rather than through the proxy server. If you are on a local network, for example, access to local hosts probably doesn't need to go through a proxy server.</para> +<para>When you have configured a proxy, &HTTP; and/or &FTP; requests are re-routed through the computer that is acting as a proxy server. However, you can also select specific hosts which should be contacted directly, rather than through the proxy server. If you are on a local network, for example, access to local hosts probably doesn't need to go through a proxy server.</para> -<para ->You should only need to configure a proxy server if your network administrator requires it (if you are a dial-up user, that would be your internet service provider or <acronym ->ISP</acronym ->). Otherwise, especially if you are feeling a bit confused about this proxy business, but everything seems to be fine with your internet connection, you don't need to change anything.</para> +<para>You should only need to configure a proxy server if your network administrator requires it (if you are a dial-up user, that would be your internet service provider or <acronym>ISP</acronym>). Otherwise, especially if you are feeling a bit confused about this proxy business, but everything seems to be fine with your internet connection, you don't need to change anything.</para> </sect2> <sect2 id="proxies-use"> -<title ->Use</title> +<title>Use</title> -<para ->The first option on the page is a checkbox labelled <guilabel ->Use proxy</guilabel ->.</para> +<para>The first option on the page is a checkbox labelled <guilabel>Use proxy</guilabel>.</para> -<para ->Check this box to enable the use of proxy servers for your internet connection.</para> +<para>Check this box to enable the use of proxy servers for your internet connection.</para> -<para ->Please note that using proxy servers is optional, but has the benefit or advantage of giving you faster access to data on the internet.</para> +<para>Please note that using proxy servers is optional, but has the benefit or advantage of giving you faster access to data on the internet.</para> -<para ->If you are uncertain whether or not you need to use a proxy server to connect to the internet, please consult with your internet service provider's setup guide or your system administrator.</para> +<para>If you are uncertain whether or not you need to use a proxy server to connect to the internet, please consult with your internet service provider's setup guide or your system administrator.</para> -<para ->If you have selected to use a proxy, you have several methods to configure the settings for it.</para> +<para>If you have selected to use a proxy, you have several methods to configure the settings for it.</para> <variablelist> <varlistentry> -<term -><guilabel ->Automatically detected script file</guilabel -></term> +<term><guilabel>Automatically detected script file</guilabel></term> <listitem> -<para ->Select this option if you want the proxy setup configuration script file to be automatically detected and downloaded.</para> -<para ->This option only differs from the next choice in that it <emphasis ->does not</emphasis -> require you to supply the location of the configuration script file. Instead, it will be automatically downloaded using <quote ->Web Access Protocol Discovery</quote -> (<acronym ->WAPD</acronym ->).</para> - -<note -><para ->If you have a problem using this setup, please consult the <acronym ->FAQ</acronym -> section at <ulink url="http://www.konqueror.org" ->http://www.konqueror.org</ulink -> for more information.</para -></note> +<para>Select this option if you want the proxy setup configuration script file to be automatically detected and downloaded.</para> +<para>This option only differs from the next choice in that it <emphasis>does not</emphasis> require you to supply the location of the configuration script file. Instead, it will be automatically downloaded using <quote>Web Access Protocol Discovery</quote> (<acronym>WAPD</acronym>).</para> + +<note><para>If you have a problem using this setup, please consult the <acronym>FAQ</acronym> section at <ulink url="http://www.konqueror.org">http://www.konqueror.org</ulink> for more information.</para></note> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Specified script file</guilabel -></term> +<term><guilabel>Specified script file</guilabel></term> <listitem> -<para ->Select this option if your proxy support is provided through a script file located at a specific address. You can then enter the address in the location text box, or use the <guiicon ->folder</guiicon -> icon to browse to it.</para> +<para>Select this option if your proxy support is provided through a script file located at a specific address. You can then enter the address in the location text box, or use the <guiicon>folder</guiicon> icon to browse to it.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Preset environment variables</guilabel -></term> +<term><guilabel>Preset environment variables</guilabel></term> <listitem> -<para ->Some systems are setup with $<envar ->HTTP_PROXY</envar -> to allow graphical as well as non-graphical applications to share the same proxy configuration information.</para> -<para ->If you know this applies to you, select this option and click on the <guibutton ->Setup...</guibutton -> button to provide the environment variable names used to set the address of the proxy server(s).</para> +<para>Some systems are setup with $<envar>HTTP_PROXY</envar> to allow graphical as well as non-graphical applications to share the same proxy configuration information.</para> +<para>If you know this applies to you, select this option and click on the <guibutton>Setup...</guibutton> button to provide the environment variable names used to set the address of the proxy server(s).</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Manually specified settings</guilabel -></term> +<term><guilabel>Manually specified settings</guilabel></term> <listitem> -<para ->Select this option, and click on the <guibutton ->Setup...</guibutton -> to manually setup the location of the proxy servers to be used.</para> - -<para ->If you choose this option, another dialogue will pop up.</para> - -<para ->The complete addressing information for the proxy includes both the internet address and a port number. You should enter these into the relevant text boxes. The <guiicon ->arrow</guiicon -> button copies the information from the <guilabel ->HTTP</guilabel -> line to the <guilabel ->FTP</guilabel -> line, in order to help save some typing.</para> - -<para ->If there are hosts which you can connect to without going through the proxy server, you can press <guibutton ->Add</guibutton -> to add the names of these hosts, separated by in the text box labelled <guilabel ->No Proxy For:</guilabel ->. For example, hosts that are on your local network can probably be contacted directly.</para> - -<para ->You can also choose <guilabel ->Only use proxy for entries in this list</guilabel ->.</para> - -<para ->Check this box to reverse the use of the exception list, &ie; the proxy servers will only be used when the requested &URL; matches one of the addresses listed here.</para> - -<para ->This features is useful if all you need is a proxy to access a few specific sites, for example, an internal intranet. If you have more complex requirements you might want to use a configuration script.</para> +<para>Select this option, and click on the <guibutton>Setup...</guibutton> to manually setup the location of the proxy servers to be used.</para> + +<para>If you choose this option, another dialogue will pop up.</para> + +<para>The complete addressing information for the proxy includes both the internet address and a port number. You should enter these into the relevant text boxes. The <guiicon>arrow</guiicon> button copies the information from the <guilabel>HTTP</guilabel> line to the <guilabel>FTP</guilabel> line, in order to help save some typing.</para> + +<para>If there are hosts which you can connect to without going through the proxy server, you can press <guibutton>Add</guibutton> to add the names of these hosts, separated by in the text box labelled <guilabel>No Proxy For:</guilabel>. For example, hosts that are on your local network can probably be contacted directly.</para> + +<para>You can also choose <guilabel>Only use proxy for entries in this list</guilabel>.</para> + +<para>Check this box to reverse the use of the exception list, &ie; the proxy servers will only be used when the requested &URL; matches one of the addresses listed here.</para> + +<para>This features is useful if all you need is a proxy to access a few specific sites, for example, an internal intranet. If you have more complex requirements you might want to use a configuration script.</para> </listitem> </varlistentry> </variablelist> @@ -199,24 +105,11 @@ </sect2> <sect2 id="authorization"> -<title -><guilabel ->Authorisation</guilabel -></title> - -<para ->Here you can choose between two types of authentication, if your proxy requires it. You can have <guilabel ->Prompt as needed</guilabel ->, the default, in which case &konqueror; will only ask for a username or password if it needs to.</para> - -<para ->The other option is <guilabel ->Use automatic login</guilabel ->. Select this option if you have already set up a login entry for your proxy server in the <filename ->$<envar ->TDEDIR</envar ->/share/config/kionetrc</filename -> file.</para> +<title><guilabel>Authorisation</guilabel></title> + +<para>Here you can choose between two types of authentication, if your proxy requires it. You can have <guilabel>Prompt as needed</guilabel>, the default, in which case &konqueror; will only ask for a username or password if it needs to.</para> + +<para>The other option is <guilabel>Use automatic login</guilabel>. Select this option if you have already set up a login entry for your proxy server in the <filename>$<envar>TDEDIR</envar>/share/config/kionetrc</filename> file.</para> </sect2> &socks-kcontrol; </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/proxy/socks.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/proxy/socks.docbook index 6463d9b0c07..c8ee36dd9ae 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/proxy/socks.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/proxy/socks.docbook @@ -1,81 +1,29 @@ <sect2 id="socks"> <sect2info> <authorgroup> -<author ->&Lauri.Watts;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </sect2info> -<title ->SOCKS</title> +<title>SOCKS</title> -<para ->SOCKS is a protocol to execute proxy requests for a client. SOCKS is capable of authentication and encryption of traffic, and is often found in corporate settings, as opposed to home users. For more information about SOCKS, see the <ulink url="http://www.socks.nec.com" ->NEC</ulink -> website</para> +<para>SOCKS is a protocol to execute proxy requests for a client. SOCKS is capable of authentication and encryption of traffic, and is often found in corporate settings, as opposed to home users. For more information about SOCKS, see the <ulink url="http://www.socks.nec.com">NEC</ulink> website</para> -<para ->With this module you can enable most of the network aware &kde; applications to transparently use SOCKS.</para> +<para>With this module you can enable most of the network aware &kde; applications to transparently use SOCKS.</para> -<para ->Setting up of a SOCKS client is outside the scope of this document, and the differences between the commonly used ones are very large. If you already have a working SOCKS implementation, allowing you to use commandline clients (for example, if <command ->lynx</command -> or <command ->ftp</command -> are already working) then you can simply check the <guilabel ->Enable SOCKS support</guilabel -> checkbox.</para> +<para>Setting up of a SOCKS client is outside the scope of this document, and the differences between the commonly used ones are very large. If you already have a working SOCKS implementation, allowing you to use commandline clients (for example, if <command>lynx</command> or <command>ftp</command> are already working) then you can simply check the <guilabel>Enable SOCKS support</guilabel> checkbox.</para> -<para ->When this box is checked, several further options become available to you.</para> +<para>When this box is checked, several further options become available to you.</para> -<para ->First, you should select which of the various SOCKS clients you have installed on your computer. &kde; will attempt to find this out by itself, if you choose <guilabel ->Auto detect</guilabel ->. If you know the client you have, you could choose either <guilabel ->NEC Socks</guilabel -> or <guilabel ->Dante</guilabel ->. If you have a custom built SOCKS library to use, you can select <guilabel ->Use custom library</guilabel -> and then enter the path to it in the <guilabel ->Path</guilabel -> field.</para> +<para>First, you should select which of the various SOCKS clients you have installed on your computer. &kde; will attempt to find this out by itself, if you choose <guilabel>Auto detect</guilabel>. If you know the client you have, you could choose either <guilabel>NEC Socks</guilabel> or <guilabel>Dante</guilabel>. If you have a custom built SOCKS library to use, you can select <guilabel>Use custom library</guilabel> and then enter the path to it in the <guilabel>Path</guilabel> field.</para> -<para ->If you want &kde; to auto detect the SOCKS library in use, but you suspect it isn't looking in the right places or you have installed it in a non-standard location, then you can add further paths to be searched in the bottom of this panel. Use the <guibutton ->Add</guibutton -> and <guibutton ->Remove</guibutton -> to add or remove paths.</para> +<para>If you want &kde; to auto detect the SOCKS library in use, but you suspect it isn't looking in the right places or you have installed it in a non-standard location, then you can add further paths to be searched in the bottom of this panel. Use the <guibutton>Add</guibutton> and <guibutton>Remove</guibutton> to add or remove paths.</para> -<para ->At any time while filling in this module, you can press the <guibutton ->Test</guibutton -> button, and &kde; will report immediately with a message box to tell you if it could find and initialise SOCKS or not.</para> +<para>At any time while filling in this module, you can press the <guibutton>Test</guibutton> button, and &kde; will report immediately with a message box to tell you if it could find and initialise SOCKS or not.</para> -<para ->Changes made here will not affect any applications that are already open. You will need to close and restart them before they are able to connect via SOCKS.</para> +<para>Changes made here will not affect any applications that are already open. You will need to close and restart them before they are able to connect via SOCKS.</para> -<para ->Conversion to British English: Malcolm Hunter <email ->malcolm.hunter@gmx.co.uk</email -></para -> +<para>Conversion to British English: Malcolm Hunter <email>malcolm.hunter@gmx.co.uk</email></para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/screensaver/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/screensaver/index.docbook index 1705b5249c0..e841382b86b 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/screensaver/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/screensaver/index.docbook @@ -2,284 +2,129 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-09-19</date> -<releaseinfo ->3.01.00</releaseinfo> +<date>2002-09-19</date> +<releaseinfo>3.01.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->screensaver</keyword> -<keyword ->screen saver</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>screensaver</keyword> +<keyword>screen saver</keyword> </keywordset> </articleinfo> <sect1 id="screensaver"> -<title ->Screen Saver</title> +<title>Screen Saver</title> -<para ->Using this module, you can choose your screen saver, determine how much time must pass before the screen saver is activated, and add or remove password protection to your screen saver.</para> +<para>Using this module, you can choose your screen saver, determine how much time must pass before the screen saver is activated, and add or remove password protection to your screen saver.</para> <sect2 id="ss-choose"> -<title ->Choosing the screen saver, and configuring its options</title> - -<para ->In the <guilabel ->Settings</guilabel -> box is a check box labeled <guilabel ->Start screen saver automatically</guilabel ->. This box must have a mark in it, or &kde; will not launch any screen saver and it will not allow you to adjust the settings of your screen saver.</para> - -<para ->Along the left side is a list of all available screen savers. You can select a screen saver by simply clicking on its name. Once you have selected a screen saver, you will see a small preview on the monitor on the right.</para> - -<note -><para ->The preview monitor will often show the screen saver larger than it is when the screen saver is activated. This is done on purpose, since many of the details of the screen savers would be unintelligible if actually scaled down to such a small size.</para -></note> - -<para ->Each screen saver has a different set of setup options. By clicking on <guilabel ->Setup...</guilabel ->, a dialogue box will appear with all available options. As you adjust the options, the preview box in the dialog box will show you what effect you will achieve with the current settings.</para> - -<para ->When you are done setting up your screen saver, click <guibutton ->OK</guibutton ->.</para -> <para ->Clicking <guibutton ->Cancel</guibutton -> will erase any changes you made in this dialogue box, and return you to the screen saver module.</para> - -<para ->Clicking the <guibutton ->About</guibutton -> button will give you the Copyright and Author information if you are interested.</para> - -<para ->When you think you have all the options set the way you want, simply click on <guibutton ->Test</guibutton -> to immediately start the screen saver <emphasis ->exactly</emphasis -> as it will appear.</para> +<title>Choosing the screen saver, and configuring its options</title> + +<para>In the <guilabel>Settings</guilabel> box is a check box labeled <guilabel>Start screen saver automatically</guilabel>. This box must have a mark in it, or &kde; will not launch any screen saver and it will not allow you to adjust the settings of your screen saver.</para> + +<para>Along the left side is a list of all available screen savers. You can select a screen saver by simply clicking on its name. Once you have selected a screen saver, you will see a small preview on the monitor on the right.</para> + +<note><para>The preview monitor will often show the screen saver larger than it is when the screen saver is activated. This is done on purpose, since many of the details of the screen savers would be unintelligible if actually scaled down to such a small size.</para></note> + +<para>Each screen saver has a different set of setup options. By clicking on <guilabel>Setup...</guilabel>, a dialogue box will appear with all available options. As you adjust the options, the preview box in the dialog box will show you what effect you will achieve with the current settings.</para> + +<para>When you are done setting up your screen saver, click <guibutton>OK</guibutton>.</para> <para>Clicking <guibutton>Cancel</guibutton> will erase any changes you made in this dialogue box, and return you to the screen saver module.</para> + +<para>Clicking the <guibutton>About</guibutton> button will give you the Copyright and Author information if you are interested.</para> + +<para>When you think you have all the options set the way you want, simply click on <guibutton>Test</guibutton> to immediately start the screen saver <emphasis>exactly</emphasis> as it will appear.</para> </sect2> <sect2 id="ss-options"> -<title ->Setting the time, priority and passwords for screen savers.</title> - -<para ->Below the Preview Monitor, is the <guilabel ->Start screen saver automatically</guilabel -> check box, and a spin box which determines the period of inactivity before the screen saver should be started. You can enter any number from 1-120 minutes in this box.</para> - -<para ->Enable the check box <guilabel ->Make the screen saver aware of power management</guilabel -> if you do not want the screensaver to start while you watch TV or movies on your monitor.</para> - -<para ->Below that is a check box labelled <guilabel ->Require password to stop screen saver</guilabel ->. If it is checked, when you click a key or click a mouse button to end the screen saver and return to your work, you must enter a password. The password used is the same password you used to login to your machine. If there is no mark in the check box, no password is required to return to your desktop.</para> - -<para ->Finally, there is a slider labelled <guilabel ->Priority</guilabel ->. If your screen saver appears jumpy, you should increase the priority closer to the <guilabel ->High</guilabel -> end. This will tell your computer to devote more time to the screen saver, and less time to other tasks. </para> +<title>Setting the time, priority and passwords for screen savers.</title> + +<para>Below the Preview Monitor, is the <guilabel>Start screen saver automatically</guilabel> check box, and a spin box which determines the period of inactivity before the screen saver should be started. You can enter any number from 1-120 minutes in this box.</para> + +<para>Enable the check box <guilabel>Make the screen saver aware of power management</guilabel> if you do not want the screensaver to start while you watch TV or movies on your monitor.</para> + +<para>Below that is a check box labelled <guilabel>Require password to stop screen saver</guilabel>. If it is checked, when you click a key or click a mouse button to end the screen saver and return to your work, you must enter a password. The password used is the same password you used to login to your machine. If there is no mark in the check box, no password is required to return to your desktop.</para> + +<para>Finally, there is a slider labelled <guilabel>Priority</guilabel>. If your screen saver appears jumpy, you should increase the priority closer to the <guilabel>High</guilabel> end. This will tell your computer to devote more time to the screen saver, and less time to other tasks. </para> </sect2> -<sect2 id="ss-other" -><title ->Using a non-&kde; screen saver</title -> +<sect2 id="ss-other"><title>Using a non-&kde; screen saver</title> -<para ->&kde; does not prevent another screen saver from working. To use a different screen saver, such as <application ->xscreensaver</application ->, simply disable the &kde; Screen Saver, and set up your other screen saver program normally. </para> +<para>&kde; does not prevent another screen saver from working. To use a different screen saver, such as <application>xscreensaver</application>, simply disable the &kde; Screen Saver, and set up your other screen saver program normally. </para> </sect2> <sect2 id="screensaver-remove"> -<title ->Removing and restoring a screen saver from your system</title> - -<para ->If you want to remove a screen saver from the list in this Control Centre Module, you will need to rename a file on your system.</para> - -<caution -><para ->Working as a <systemitem class="username" ->root</systemitem -> user is a potentially dangerous situation. While unlikely, it is entirely possible to do permanent damage to your system while working as <emphasis ->root</emphasis ->.</para> - -<para ->Be very careful following the next set of directions</para -></caution> - -<para ->To delete a screen saver, type the following commands:</para> - -<screen -><prompt ->bash$</prompt -> <command ->cd +<title>Removing and restoring a screen saver from your system</title> + +<para>If you want to remove a screen saver from the list in this Control Centre Module, you will need to rename a file on your system.</para> + +<caution><para>Working as a <systemitem class="username">root</systemitem> user is a potentially dangerous situation. While unlikely, it is entirely possible to do permanent damage to your system while working as <emphasis>root</emphasis>.</para> + +<para>Be very careful following the next set of directions</para></caution> + +<para>To delete a screen saver, type the following commands:</para> + +<screen><prompt>bash$</prompt> <command>cd $TDEDIR/share/applnk/System/ScreenSavers</command> -<prompt ->bash$</prompt -> <command ->ls</command -> -</screen -> - -<para ->This will give you a list of files. You will notice similarities between some of the file names and that of the screen saver you want to remove. Simply rename the file of similarly named desktop file to a name which does not end in <emphasis ->desktop</emphasis ->.</para> - -<para ->Example:</para> -<screen -><prompt ->bash$</prompt -> <command ->cd +<prompt>bash$</prompt> <command>ls</command> +</screen> + +<para>This will give you a list of files. You will notice similarities between some of the file names and that of the screen saver you want to remove. Simply rename the file of similarly named desktop file to a name which does not end in <emphasis>desktop</emphasis>.</para> + +<para>Example:</para> +<screen><prompt>bash$</prompt> <command>cd $TDEDIR/share/applnk/System/ScreenSavers</command> -<prompt ->bash$</prompt -> <command ->mv KSpace.desktop KSpace.backup</command -> -</screen -> - -<para ->Will remove Space (GL) from the list</para> - -<note -><para ->You must close the &kcontrolcenter; entirely and restart it before the changes will be seen.</para -></note> - -<para ->To restore the disabled screen saver, simply rename the file back to its original name:</para> - -<screen -><prompt ->bash$</prompt -> <command ->cd +<prompt>bash$</prompt> <command>mv KSpace.desktop KSpace.backup</command> +</screen> + +<para>Will remove Space (GL) from the list</para> + +<note><para>You must close the &kcontrolcenter; entirely and restart it before the changes will be seen.</para></note> + +<para>To restore the disabled screen saver, simply rename the file back to its original name:</para> + +<screen><prompt>bash$</prompt> <command>cd $TDEDIR/share/applnk/System/ScreenSavers</command> -<prompt ->bash$</prompt -> <command ->mv KSpace.backup KSpace.desktop</command -> -</screen -> +<prompt>bash$</prompt> <command>mv KSpace.backup KSpace.desktop</command> +</screen> -<para ->Restart the &kcontrolcenter;, and the screen saver is back in the list.</para> +<para>Restart the &kcontrolcenter;, and the screen saver is back in the list.</para> </sect2> <sect2 id="grace"> -<title ->Advanced Settings: Grace period</title> - -<para ->There is a five second grace period after the screen saver begins before a password is required even if <guilabel ->Require password</guilabel -> is checked.</para> -<para ->Locking the desktop manually, by clicking the lock icon in the &kde; panel, causes the password protection to engage immediately with no grace period.</para> -<para ->To alter the grace period setting, you need to manually edit the configuration file. To do so:</para> -<para -><prompt ->$</prompt -> <command ->cd <filename ->~/.trinity/share/config</filename -> </command -> </para> -<para ->Now, using a text editor (the example uses &kate;, the &kde; text editor), load the <filename ->kdesktoprc</filename ->.</para> -<para -><prompt ->$</prompt -> <command ->kate <filename ->kdesktoprc</filename -> </command -> </para> -<para ->Search through the file for the section labelled <emphasis ->[Screensaver]</emphasis ->.</para> -<para ->Look through all lines in the section for an entry entitled <emphasis ->LockGrace</emphasis ->.</para> -<para ->If the entry exists, you can edit the value of the entry. </para> -<screen ->[Screensaver] +<title>Advanced Settings: Grace period</title> + +<para>There is a five second grace period after the screen saver begins before a password is required even if <guilabel>Require password</guilabel> is checked.</para> +<para>Locking the desktop manually, by clicking the lock icon in the &kde; panel, causes the password protection to engage immediately with no grace period.</para> +<para>To alter the grace period setting, you need to manually edit the configuration file. To do so:</para> +<para><prompt>$</prompt> <command>cd <filename>~/.trinity/share/config</filename> </command> </para> +<para>Now, using a text editor (the example uses &kate;, the &kde; text editor), load the <filename>kdesktoprc</filename>.</para> +<para><prompt>$</prompt> <command>kate <filename>kdesktoprc</filename> </command> </para> +<para>Search through the file for the section labelled <emphasis>[Screensaver]</emphasis>.</para> +<para>Look through all lines in the section for an entry entitled <emphasis>LockGrace</emphasis>.</para> +<para>If the entry exists, you can edit the value of the entry. </para> +<screen>[Screensaver] LockGrace=3000</screen> -<para ->The value of the entity represents the duration of the grace period in milliseconds. An entry of 3000, would change the grace period to 3 seconds. You can set the value of the entry to any number between zero (no grace period) and 300000 (5 minutes). </para> -<para ->If the entry does not exist, simply add the entry to the end of the section.</para> +<para>The value of the entity represents the duration of the grace period in milliseconds. An entry of 3000, would change the grace period to 3 seconds. You can set the value of the entry to any number between zero (no grace period) and 300000 (5 minutes). </para> +<para>If the entry does not exist, simply add the entry to the end of the section.</para> -<para ->Any changes to the configuration entry take effect immediately.</para> +<para>Any changes to the configuration entry take effect immediately.</para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/smb/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/smb/index.docbook index 0c6c183792a..7b2f23b2f22 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/smb/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/smb/index.docbook @@ -2,80 +2,36 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<author ->&Jost.Schenck; &Jost.Schenck.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<author>&Jost.Schenck; &Jost.Schenck.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->Windows shares</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>Windows shares</keyword> </keywordset> </articleinfo> <sect1 id="windows-shares"> -<title ->Windows Shares</title> +<title>Windows Shares</title> <sect2 id="windows-shares-intro"> -<title ->Introduction</title> - -<para ->In many small local area networks, the <acronym ->SMB</acronym -> protocol is used to offer network services. Names like <quote ->&Windows; Network</quote -> or <quote ->&Windows; for Workgroups Network</quote -> or <quote ->LanManager</quote -> are often used as well. Using <acronym ->SMB</acronym -> you can access so-called <quote ->shares</quote -> (&ie; folders made available by the server) as well as printers. </para> - -<para ->&kde; comes with built-in support for the <acronym ->SMB</acronym -> protocol. As &kde; is network-transparent that means you can access <acronym ->SMB</acronym -> shares from everywhere you can access your local files, for example in the &konqueror; file manager and in the file dialogue. To make use of this you should provide &kde; with some information on your <acronym ->SMB</acronym -> network. But do not worry, this is normally pretty simple as, for example, all the Windows clients in your network need and have the same information.</para> +<title>Introduction</title> + +<para>In many small local area networks, the <acronym>SMB</acronym> protocol is used to offer network services. Names like <quote>&Windows; Network</quote> or <quote>&Windows; for Workgroups Network</quote> or <quote>LanManager</quote> are often used as well. Using <acronym>SMB</acronym> you can access so-called <quote>shares</quote> (&ie; folders made available by the server) as well as printers. </para> + +<para>&kde; comes with built-in support for the <acronym>SMB</acronym> protocol. As &kde; is network-transparent that means you can access <acronym>SMB</acronym> shares from everywhere you can access your local files, for example in the &konqueror; file manager and in the file dialogue. To make use of this you should provide &kde; with some information on your <acronym>SMB</acronym> network. But do not worry, this is normally pretty simple as, for example, all the Windows clients in your network need and have the same information.</para> <!-- Don't know if the following info should go in the base documentation --> @@ -86,18 +42,7 @@ very cool thing (TM) btw. If you want to write some documentation for this one too, have a look at tdenetwork/lanbrowsing/lisa/README and contact me if you have questions. --> -<note -><para ->For the <acronym ->SMB</acronym -> protocol to work, it is required to have <application ->Samba</application -> correctly installed. If you have an NT domain controller, you will need at least <application ->Samba</application -> version 2.0 or higher. If you want to access &Windows; 2000 shares, you will need <application ->Samba</application -> version 2.0.7 or higher. Older versions may work too, but have not been tested.</para -></note> +<note><para>For the <acronym>SMB</acronym> protocol to work, it is required to have <application>Samba</application> correctly installed. If you have an NT domain controller, you will need at least <application>Samba</application> version 2.0 or higher. If you want to access &Windows; 2000 shares, you will need <application>Samba</application> version 2.0.7 or higher. Older versions may work too, but have not been tested.</para></note> <!-- TODO: link to some place which explains USING SMB, i.e. konqueror or file dialog manual --> @@ -105,48 +50,15 @@ or file dialog manual --> </sect2> <sect2 id="windows-shares-use"> -<title ->Use</title> - -<para ->Although there are a lot of insecure <acronym ->SMB</acronym -> networks out there which allow access to anyone, in principle you have to authenticate yourself to access the services of an <acronym ->SMB</acronym -> server. By default, &kde; will use the data entered in the <guilabel ->Default user name</guilabel -> and <guilabel ->Default password</guilabel -> fields to authenticate itself on <acronym ->SMB</acronym -> hosts. If you leave the field <guilabel ->Default user name</guilabel -> empty, &kde; will try to access <acronym ->SMB</acronym -> hosts without a username. If you leave the default password empty, it will try without a password. If &kde; is unsuccessful accessing the host using these settings, you will be asked for a username and a password.</para> - -<important -><para ->While it makes things more comfortable if &kde; stores your <acronym ->SMB</acronym -> password, this may be a security problem. If you are using <acronym ->SMB</acronym -> in a security conscious environment, you should not store your password here but rather enter it anew every time you need to access an <acronym ->SMB</acronym -> host.</para -></important> - -<para ->In the <guilabel ->Workgroup</guilabel -> field, you can enter your workgroup name. If you don't know it, ask your system administrator or have a look at other already configured machines in your network. However, in most cases providing the workgroup name is not required, so you probably can also leave this empty.</para> - -<para ->If the option <guilabel ->Show hidden shares</guilabel -> is checked, shares ending with a <quote ->$</quote -> will be shown.</para> +<title>Use</title> + +<para>Although there are a lot of insecure <acronym>SMB</acronym> networks out there which allow access to anyone, in principle you have to authenticate yourself to access the services of an <acronym>SMB</acronym> server. By default, &kde; will use the data entered in the <guilabel>Default user name</guilabel> and <guilabel>Default password</guilabel> fields to authenticate itself on <acronym>SMB</acronym> hosts. If you leave the field <guilabel>Default user name</guilabel> empty, &kde; will try to access <acronym>SMB</acronym> hosts without a username. If you leave the default password empty, it will try without a password. If &kde; is unsuccessful accessing the host using these settings, you will be asked for a username and a password.</para> + +<important><para>While it makes things more comfortable if &kde; stores your <acronym>SMB</acronym> password, this may be a security problem. If you are using <acronym>SMB</acronym> in a security conscious environment, you should not store your password here but rather enter it anew every time you need to access an <acronym>SMB</acronym> host.</para></important> + +<para>In the <guilabel>Workgroup</guilabel> field, you can enter your workgroup name. If you don't know it, ask your system administrator or have a look at other already configured machines in your network. However, in most cases providing the workgroup name is not required, so you probably can also leave this empty.</para> + +<para>If the option <guilabel>Show hidden shares</guilabel> is checked, shares ending with a <quote>$</quote> will be shown.</para> </sect2> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/spellchecking/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/spellchecking/index.docbook index 4578d3b55c8..67ff42190f2 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/spellchecking/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/spellchecking/index.docbook @@ -2,133 +2,66 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-13</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-13</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->Spelling</keyword> -<keyword ->dictionary</keyword> +<keyword>KDE</keyword> +<keyword>Spelling</keyword> +<keyword>dictionary</keyword> </keywordset> </articleinfo> <sect1 id="spell-checking"> -<title ->Spell Checker</title> +<title>Spell Checker</title> -<para ->The configuration options available here are used by all &kde; applications that use &tdespell;, which is a front end to <command ->ispell</command -> or <command ->aspell</command ->.</para> +<para>The configuration options available here are used by all &kde; applications that use &tdespell;, which is a front end to <command>ispell</command> or <command>aspell</command>.</para> <variablelist> <varlistentry> -<term -><guilabel ->Create root/affix combinations not in dictionary</guilabel -></term> +<term><guilabel>Create root/affix combinations not in dictionary</guilabel></term> <listitem> -<para ->Selecting this option allows the spell checker to register as <quote ->correct</quote -> combinations of root words with suffixes or prefixes even if the particular combination is not listed in its dictionary database of words.</para> +<para>Selecting this option allows the spell checker to register as <quote>correct</quote> combinations of root words with suffixes or prefixes even if the particular combination is not listed in its dictionary database of words.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Consider run-together words as spelling errors</guilabel -></term> -<listitem -><para ->If this is selected, then words that appear in the dictionary separately, but have been run together, are considered to be spelling errors. For example, even though <quote ->alarm</quote -> and <quote ->clock</quote -> might be in your dictionary, if <quote ->alarmclock</quote -> is not, it will be flagged as a spelling error.</para -></listitem> +<term><guilabel>Consider run-together words as spelling errors</guilabel></term> +<listitem><para>If this is selected, then words that appear in the dictionary separately, but have been run together, are considered to be spelling errors. For example, even though <quote>alarm</quote> and <quote>clock</quote> might be in your dictionary, if <quote>alarmclock</quote> is not, it will be flagged as a spelling error.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Dictionary:</guilabel -></term> +<term><guilabel>Dictionary:</guilabel></term> <listitem> -<para ->Choose from the available dictionaries, which one to use for &tdespell;.</para> +<para>Choose from the available dictionaries, which one to use for &tdespell;.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Encoding:</guilabel -></term> +<term><guilabel>Encoding:</guilabel></term> <listitem> -<para ->You should select the one that matches the character set you are using. In some cases, dictionaries will support more than one encoding. A dictionary might, for example, accept accented characters when <emphasis ->Latin1</emphasis -> is selected, but accept email-style character combinations (like <userinput ->'a</userinput -> for an accented <emphasis ->a</emphasis ->) when <emphasis ->7-Bit-ASCII</emphasis -> is selected. Please see your dictionary's distribution for more information.</para> +<para>You should select the one that matches the character set you are using. In some cases, dictionaries will support more than one encoding. A dictionary might, for example, accept accented characters when <emphasis>Latin1</emphasis> is selected, but accept email-style character combinations (like <userinput>'a</userinput> for an accented <emphasis>a</emphasis>) when <emphasis>7-Bit-ASCII</emphasis> is selected. Please see your dictionary's distribution for more information.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Client:</guilabel -></term> +<term><guilabel>Client:</guilabel></term> <listitem> -<para ->You can choose which of the installed client applications on your system to use. For example, you can choose <command ->ispell</command ->.</para> +<para>You can choose which of the installed client applications on your system to use. For example, you can choose <command>ispell</command>.</para> </listitem> </varlistentry> </variablelist> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/tdehtml/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/tdehtml/index.docbook index 4c7deb25248..62b7ea24e4c 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/tdehtml/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/tdehtml/index.docbook @@ -3,339 +3,146 @@ "dtd/kdex.dtd" [ <!ENTITY nsplugins-kcontrol SYSTEM "nsplugin.docbook"> <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-12</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-12</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->konqueror</keyword> -<keyword ->browsing</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>konqueror</keyword> +<keyword>browsing</keyword> </keywordset> </articleinfo> <sect1 id="konq-browsing"> -<title ->Browsing With &konqueror;</title> +<title>Browsing With &konqueror;</title> -<para ->The &konqueror; Browser module of &kcontrol; allows you to select various options for the appearance and behaviour of &konqueror;, the integrated web browser of &kde;.</para> +<para>The &konqueror; Browser module of &kcontrol; allows you to select various options for the appearance and behaviour of &konqueror;, the integrated web browser of &kde;.</para> <sect2 id="kbrowse-html"> -<title ->Behaviour</title> - -<para ->The first option you can enable on this page is <guilabel ->Enable completion of forms</guilabel ->. If you check this box, &konqueror; will try to remember what you answer to form questions, and will try to fill in forms for you with the answers you previously used.</para> - -<para ->You can configure the number of form items &konqueror; remembers with the slider below labelled <guilabel ->Maximum completions</guilabel -></para> - -<note -><para ->Of course, anything &konqueror; fills in a form with, you can still edit before submitting the form!</para -></note> - -<para ->The next option is <guilabel ->Change cursor over links</guilabel ->. If this option is selected, the shape of the cursor will change (usually to a hand) whenever it moves over a hyperlink. This makes it easy to identify links, especially when they are in the form of images.</para> - -<para ->&konqueror; defaults to a single window per page, but has the capability to open multiple <firstterm ->tabs</firstterm -> inside a single window. &konqueror; also, by default, has a &MMB; shortcut to open any link in a new window. If you enable <guilabel ->Open links in new tab instead of in new window</guilabel -> you can &MMB; click on a link to have it open in a new tab.</para> - -<para ->If you are using tabbed browsing, you can choose if a newly opened tab becomes the active (<quote ->front</quote ->) tab, or goes to the back. On a slow internet connection, or while browsing a page that has a list of headlines or other links in a list, you may like to have the new tabs load in the background while you continue reading. In this case, leave this setting disabled. If you prefer to go straight to the new page, leaving the old one in the background to return to later, enable it.</para> - -<para ->If you close a window in &konqueror; that has multiple tabs open, &konqueror; will ask you if you're sure that you meant to close it. You can toggle on and off this behaviour with the <guilabel ->Confirm when closing windows with multiple tabs</guilabel -> checkbox.</para> - -<para ->As a convenience feature, if you enable <guilabel ->Right click goes back in history</guilabel ->, then clicking an empty area (&ie; not a link) in the &konqueror; window will act as if you pressed the <guiicon ->Back</guiicon -> button on the toolbar.</para> - -<para ->The checkbox labelled <guilabel ->Automatically load images</guilabel ->, allows you to control whether images on web pages are loaded by default. Unless you have a very slow connection, you will probably want to leave this option selected, as there are many web pages that are difficult to use without images. If you don't select the option to automatically load images, you can still view the text on the page, and then load the images if you need them.</para> - -<para ->Enabling <guilabel ->Allow automatic delayed reloading/redirecting</guilabel -> allows websites to send you to another page without your interaction. In many cases, this is a convenience. For example, the website has moved to a new <acronym ->URL</acronym ->. Many webmasters in this situation will put up a page on the old site, telling you that it has moved and you may like to change your bookmark, and then automatically move you along to the new website. However, such features can be confusing, or annoying, when misused, and so you may wish to disable it.</para> - -<para ->The next setting is <guilabel ->Underline links:</guilabel ->. You can choose to underline links <guilabel ->Always</guilabel ->. If this option is selected, any text on web pages that acts as a link will be shown in an underlined font. While many web pages do use colour to distinguish text that acts as a link, underlining makes it very easy to spot links.</para> - -<para ->If you don't like underlined links, you can choose <guilabel ->Never</guilabel ->, so that no links are underlined. Or you can choose a middle ground, <guilabel ->Hover</guilabel ->, so that links are underlined when the mouse cursor is resting over them, and not underlined the rest of the time.</para> - -<para ->Many web pages use animated gif images, and these can be very annoying, and in some cases, quite a drain on your system resources. The <guilabel ->Animations</guilabel -> option lets you choose when animations are enabled. The default is enabled, but you can set this to disabled, or to run the animation only once, even if the file itself contains instructions that the animation should run more times, or continuously.</para> +<title>Behaviour</title> + +<para>The first option you can enable on this page is <guilabel>Enable completion of forms</guilabel>. If you check this box, &konqueror; will try to remember what you answer to form questions, and will try to fill in forms for you with the answers you previously used.</para> + +<para>You can configure the number of form items &konqueror; remembers with the slider below labelled <guilabel>Maximum completions</guilabel></para> + +<note><para>Of course, anything &konqueror; fills in a form with, you can still edit before submitting the form!</para></note> + +<para>The next option is <guilabel>Change cursor over links</guilabel>. If this option is selected, the shape of the cursor will change (usually to a hand) whenever it moves over a hyperlink. This makes it easy to identify links, especially when they are in the form of images.</para> + +<para>&konqueror; defaults to a single window per page, but has the capability to open multiple <firstterm>tabs</firstterm> inside a single window. &konqueror; also, by default, has a &MMB; shortcut to open any link in a new window. If you enable <guilabel>Open links in new tab instead of in new window</guilabel> you can &MMB; click on a link to have it open in a new tab.</para> + +<para>If you are using tabbed browsing, you can choose if a newly opened tab becomes the active (<quote>front</quote>) tab, or goes to the back. On a slow internet connection, or while browsing a page that has a list of headlines or other links in a list, you may like to have the new tabs load in the background while you continue reading. In this case, leave this setting disabled. If you prefer to go straight to the new page, leaving the old one in the background to return to later, enable it.</para> + +<para>If you close a window in &konqueror; that has multiple tabs open, &konqueror; will ask you if you're sure that you meant to close it. You can toggle on and off this behaviour with the <guilabel>Confirm when closing windows with multiple tabs</guilabel> checkbox.</para> + +<para>As a convenience feature, if you enable <guilabel>Right click goes back in history</guilabel>, then clicking an empty area (&ie; not a link) in the &konqueror; window will act as if you pressed the <guiicon>Back</guiicon> button on the toolbar.</para> + +<para>The checkbox labelled <guilabel>Automatically load images</guilabel>, allows you to control whether images on web pages are loaded by default. Unless you have a very slow connection, you will probably want to leave this option selected, as there are many web pages that are difficult to use without images. If you don't select the option to automatically load images, you can still view the text on the page, and then load the images if you need them.</para> + +<para>Enabling <guilabel>Allow automatic delayed reloading/redirecting</guilabel> allows websites to send you to another page without your interaction. In many cases, this is a convenience. For example, the website has moved to a new <acronym>URL</acronym>. Many webmasters in this situation will put up a page on the old site, telling you that it has moved and you may like to change your bookmark, and then automatically move you along to the new website. However, such features can be confusing, or annoying, when misused, and so you may wish to disable it.</para> + +<para>The next setting is <guilabel>Underline links:</guilabel>. You can choose to underline links <guilabel>Always</guilabel>. If this option is selected, any text on web pages that acts as a link will be shown in an underlined font. While many web pages do use colour to distinguish text that acts as a link, underlining makes it very easy to spot links.</para> + +<para>If you don't like underlined links, you can choose <guilabel>Never</guilabel>, so that no links are underlined. Or you can choose a middle ground, <guilabel>Hover</guilabel>, so that links are underlined when the mouse cursor is resting over them, and not underlined the rest of the time.</para> + +<para>Many web pages use animated gif images, and these can be very annoying, and in some cases, quite a drain on your system resources. The <guilabel>Animations</guilabel> option lets you choose when animations are enabled. The default is enabled, but you can set this to disabled, or to run the animation only once, even if the file itself contains instructions that the animation should run more times, or continuously.</para> </sect2> <sect2 id="kbrowse-appearance"> -<title ->Fonts</title> - -<para ->Under this tab, you can select various options related to the use of fonts. Although the shapes and sizes of fonts are often part of the design of a web page, you can select some default settings for &konqueror; to use.</para> - -<para ->The first thing you can set here is the font size. There are two settings which work together to allow you a comfortable browsing experience.</para> - -<para ->Firstly, you can set a <guilabel ->Minimum Font Size</guilabel ->. This means, even if the font size is set specifically in the page you are viewing, &konqueror; will ignore that instruction and never show smaller fonts than you set here.</para> - -<para ->Next you can set a <guilabel ->Medium Font Size</guilabel ->. This is not only the default size of text, used when the page doesn't specify sizes, but it is also used as the base size that relative font sizes are calculated against. That is, the <acronym ->HTML</acronym -> instruction <quote ->smaller</quote ->, it means smaller than the size you set for this option.</para> - -<para ->For either option, you can select the exact font size in points by using the up/down spin control (or just typing) next to the option label.</para> - -<para ->These options are independent of each other. Pages that do not set a font size, or ask for the default, will display with the size you set from <guilabel ->Medium Font Size</guilabel ->, while any pages that ask for a size smaller than your <guilabel ->Minimum Font Size</guilabel -> setting will instead show that size. The one does not affect the other.</para> - -<para ->The remaining options are for the fonts to be associated with different types of markup used in <acronym ->HTML</acronym -> pages. Note that many web pages may override these settings. If you click anywhere on a control which shows a font name, a list of font names appears, and you can select a different font if you like. (If there are a lot of fonts, a vertical scrollbar appears in the list to allow you to scroll through all of the fonts.)</para> +<title>Fonts</title> + +<para>Under this tab, you can select various options related to the use of fonts. Although the shapes and sizes of fonts are often part of the design of a web page, you can select some default settings for &konqueror; to use.</para> + +<para>The first thing you can set here is the font size. There are two settings which work together to allow you a comfortable browsing experience.</para> + +<para>Firstly, you can set a <guilabel>Minimum Font Size</guilabel>. This means, even if the font size is set specifically in the page you are viewing, &konqueror; will ignore that instruction and never show smaller fonts than you set here.</para> + +<para>Next you can set a <guilabel>Medium Font Size</guilabel>. This is not only the default size of text, used when the page doesn't specify sizes, but it is also used as the base size that relative font sizes are calculated against. That is, the <acronym>HTML</acronym> instruction <quote>smaller</quote>, it means smaller than the size you set for this option.</para> + +<para>For either option, you can select the exact font size in points by using the up/down spin control (or just typing) next to the option label.</para> + +<para>These options are independent of each other. Pages that do not set a font size, or ask for the default, will display with the size you set from <guilabel>Medium Font Size</guilabel>, while any pages that ask for a size smaller than your <guilabel>Minimum Font Size</guilabel> setting will instead show that size. The one does not affect the other.</para> + +<para>The remaining options are for the fonts to be associated with different types of markup used in <acronym>HTML</acronym> pages. Note that many web pages may override these settings. If you click anywhere on a control which shows a font name, a list of font names appears, and you can select a different font if you like. (If there are a lot of fonts, a vertical scrollbar appears in the list to allow you to scroll through all of the fonts.)</para> <!-- -<para ->You can set a font for each <quote ->type</quote -> of markup, for -each <guilabel ->Charset</guilabel ->, by changing the character set in the +<para>You can set a font for each <quote>type</quote> of markup, for +each <guilabel>Charset</guilabel>, by changing the character set in the first drop down box, and then selecting a font for each category below. This would take quite some time, so you may just want to set up the fonts for your default character set. Most English speaking users will use iso8859-1</para> --> -<para ->Below this, you can set a <guilabel ->Font size adjustment for this encoding</guilabel ->. Sometimes the fonts you want to use for a particular encoding or language are much larger or smaller than average, so you can use this setting to bring them into line.</para> +<para>Below this, you can set a <guilabel>Font size adjustment for this encoding</guilabel>. Sometimes the fonts you want to use for a particular encoding or language are much larger or smaller than average, so you can use this setting to bring them into line.</para> -<para ->You can set a default encoding that &konqueror; should assume pages are when rendering them. The default setting is <guilabel ->Use language encoding</guilabel ->, but you can change it to any encoding available in the list.</para> +<para>You can set a default encoding that &konqueror; should assume pages are when rendering them. The default setting is <guilabel>Use language encoding</guilabel>, but you can change it to any encoding available in the list.</para> </sect2> <sect2 id="kbrowse-java"> -<title ->&Java; and JavaScript</title> - -<para ->&Java; allows applications to be downloaded and run by a web browser, provided you have the necessary software installed on your machine. Many web sites make use of &Java; (for example, online banking services or interactive gaming sites). You should be aware that running programs from unknown sources could pose a threat to the security of your computer, even if the potential extent of the damage is not great.</para> - -<para ->The checkboxes under <guilabel ->Global Settings</guilabel -> allows you to turn &Java; support on for all web sites by default. You can also select to turn &Java; on or off for specific hosts. To add a policy for a specific host, click the <guilabel ->Add...</guilabel -> button to bring up a dialogue in which you can type the host name and then choose to accept or reject &Java; code from that particular host, which will add the domain to the list on the left of the page.</para> - -<para ->You can select a host in the list, and click the <guilabel ->Change...</guilabel -> button to choose a different policy for that host. Clicking the <guilabel ->Delete</guilabel -> button removes the policy for the selected host; after deletion, the global settings will then apply to that host. You can import policies from a file by clicking the <guilabel ->Import...</guilabel -> button. To save the current list to a compressed archive file, click the <guilabel ->Export...</guilabel -> button.</para> - -<para ->Finally, the group of controls labelled <guilabel ->Java Runtime Settings</guilabel -> allows you to set some options for the way in which &Java; should run. These options are useful for diagnosing problems, or if you are a &Java; developer, and should not normally need adjusting.</para> - -<para ->If you select the <guilabel ->Show Java Console</guilabel -> option, &konqueror; will open a console window from which &Java; applications can read and write text. While most &Java; applications will not require such a console, it could be helpful in diagnosing problems with &Java; applications.</para> - -<para -><guilabel ->Use TDEIO</guilabel -> will cause the <acronym ->JVM</acronym ->to use &kde;'s own <acronym ->TDEIO</acronym -> transports for network connections.</para> - -<para -><guilabel ->Use security manager</guilabel -> is normally enabled by default. This setting will cause the <acronym ->JVM</acronym -> to run with a Security Manager in place. This will keep applets from being able to read and write to your file system, creating arbitrary sockets, and other actions which could be used to compromise your system. Disable this option at your own risk. You can modify your <filename ->$<envar ->HOME</envar ->/.java.policy</filename -> file with the &Java; policytool utility to give code downloaded from certain sites more permissions.</para> - -<para ->The <guilabel ->Shutdown Applet Server when inactive</guilabel -> checkbox allows you to save resources by closing the &Java; Applet Server when it is not in use, rather than leaving it running in the background. Leaving this disabled may make &Java; applets start up faster, but it will use system resources when you are not using a &Java; applet. If you enable this, you can set a timeout.</para> - -<para ->You can either opt to have &konqueror; automatically detect the &Java; installation on your system, or specify the path to the installation yourself by selecting <guilabel ->Use user-specified Java</guilabel ->. You may want to choose the latter method, for instance, if you have multiple &Java; installations on your system, and want to specify which one to use. If the &Java; Virtual Machine you are using requires any special startup options, you can type them in the text box labelled <guilabel ->Additional Java Arguments</guilabel ->.</para> +<title>&Java; and JavaScript</title> + +<para>&Java; allows applications to be downloaded and run by a web browser, provided you have the necessary software installed on your machine. Many web sites make use of &Java; (for example, online banking services or interactive gaming sites). You should be aware that running programs from unknown sources could pose a threat to the security of your computer, even if the potential extent of the damage is not great.</para> + +<para>The checkboxes under <guilabel>Global Settings</guilabel> allows you to turn &Java; support on for all web sites by default. You can also select to turn &Java; on or off for specific hosts. To add a policy for a specific host, click the <guilabel>Add...</guilabel> button to bring up a dialogue in which you can type the host name and then choose to accept or reject &Java; code from that particular host, which will add the domain to the list on the left of the page.</para> + +<para>You can select a host in the list, and click the <guilabel>Change...</guilabel> button to choose a different policy for that host. Clicking the <guilabel>Delete</guilabel> button removes the policy for the selected host; after deletion, the global settings will then apply to that host. You can import policies from a file by clicking the <guilabel>Import...</guilabel> button. To save the current list to a compressed archive file, click the <guilabel>Export...</guilabel> button.</para> + +<para>Finally, the group of controls labelled <guilabel>Java Runtime Settings</guilabel> allows you to set some options for the way in which &Java; should run. These options are useful for diagnosing problems, or if you are a &Java; developer, and should not normally need adjusting.</para> + +<para>If you select the <guilabel>Show Java Console</guilabel> option, &konqueror; will open a console window from which &Java; applications can read and write text. While most &Java; applications will not require such a console, it could be helpful in diagnosing problems with &Java; applications.</para> + +<para><guilabel>Use TDEIO</guilabel> will cause the <acronym>JVM</acronym>to use &kde;'s own <acronym>TDEIO</acronym> transports for network connections.</para> + +<para><guilabel>Use security manager</guilabel> is normally enabled by default. This setting will cause the <acronym>JVM</acronym> to run with a Security Manager in place. This will keep applets from being able to read and write to your file system, creating arbitrary sockets, and other actions which could be used to compromise your system. Disable this option at your own risk. You can modify your <filename>$<envar>HOME</envar>/.java.policy</filename> file with the &Java; policytool utility to give code downloaded from certain sites more permissions.</para> + +<para>The <guilabel>Shutdown Applet Server when inactive</guilabel> checkbox allows you to save resources by closing the &Java; Applet Server when it is not in use, rather than leaving it running in the background. Leaving this disabled may make &Java; applets start up faster, but it will use system resources when you are not using a &Java; applet. If you enable this, you can set a timeout.</para> + +<para>You can either opt to have &konqueror; automatically detect the &Java; installation on your system, or specify the path to the installation yourself by selecting <guilabel>Use user-specified Java</guilabel>. You may want to choose the latter method, for instance, if you have multiple &Java; installations on your system, and want to specify which one to use. If the &Java; Virtual Machine you are using requires any special startup options, you can type them in the text box labelled <guilabel>Additional Java Arguments</guilabel>.</para> </sect2> <sect2 id="kbrowse-javascript"> -<title ->JavaScript</title> - -<para ->Despite the name, JavaScript is not related at all to &Java;.</para> - -<para ->The first part of this page works the same as the &Java; page settings.</para> - -<para ->The checkboxes under <guilabel ->Global Settings</guilabel -> allow you to turn JavaScript support on for all web sites by default. You can also select to turn JavaScript on or off for specific hosts. To add a policy for a specific host, click the <guilabel ->Add...</guilabel -> button to bring up a dialogue in which you can type the host name and then choose to accept or reject JavaScript code from that particular host, which will add the domain to the list on the left of the page.</para> - -<para ->You can select a host in the list, and click the <guilabel ->Change...</guilabel -> button to choose a different policy for that host. Clicking the <guilabel ->Delete</guilabel -> button removes the policy for the selected host; after deletion, the global settings will then apply to that host. You can import policies from a file by clicking the <guilabel ->Import...</guilabel -> button. To save the current list to a compressed archive file, click the <guilabel ->Export...</guilabel -> button.</para> - -<para ->The final set of options on this page determine what happens when a page uses JavaScript for specific actions.</para> - -<para ->You can individually enable or disable the ability of JavaScript to manipulate your windows by moving, resizing or changing focus. You can also disable JavaScript from changing the status bar text, so that for instance, you can always see where links will take you when clicked.The choices for these options are <guilabel ->Allow</guilabel -> and <guilabel ->Ignore</guilabel ->.</para> - -<para ->For opening a new window, there is even more control. You can set &konqueror; to <guilabel ->Allow</guilabel -> all such requests, <guilabel ->Ask</guilabel -> each time a request is made, or <guilabel ->Deny</guilabel -> all popup requests.</para> - -<para ->The <guilabel ->Smart</guilabel -> setting will only allow JavaScript popup windows when you have explicitly chosen a link that creates one.</para> +<title>JavaScript</title> + +<para>Despite the name, JavaScript is not related at all to &Java;.</para> + +<para>The first part of this page works the same as the &Java; page settings.</para> + +<para>The checkboxes under <guilabel>Global Settings</guilabel> allow you to turn JavaScript support on for all web sites by default. You can also select to turn JavaScript on or off for specific hosts. To add a policy for a specific host, click the <guilabel>Add...</guilabel> button to bring up a dialogue in which you can type the host name and then choose to accept or reject JavaScript code from that particular host, which will add the domain to the list on the left of the page.</para> + +<para>You can select a host in the list, and click the <guilabel>Change...</guilabel> button to choose a different policy for that host. Clicking the <guilabel>Delete</guilabel> button removes the policy for the selected host; after deletion, the global settings will then apply to that host. You can import policies from a file by clicking the <guilabel>Import...</guilabel> button. To save the current list to a compressed archive file, click the <guilabel>Export...</guilabel> button.</para> + +<para>The final set of options on this page determine what happens when a page uses JavaScript for specific actions.</para> + +<para>You can individually enable or disable the ability of JavaScript to manipulate your windows by moving, resizing or changing focus. You can also disable JavaScript from changing the status bar text, so that for instance, you can always see where links will take you when clicked.The choices for these options are <guilabel>Allow</guilabel> and <guilabel>Ignore</guilabel>.</para> + +<para>For opening a new window, there is even more control. You can set &konqueror; to <guilabel>Allow</guilabel> all such requests, <guilabel>Ask</guilabel> each time a request is made, or <guilabel>Deny</guilabel> all popup requests.</para> + +<para>The <guilabel>Smart</guilabel> setting will only allow JavaScript popup windows when you have explicitly chosen a link that creates one.</para> </sect2> <sect2 id="kbrowse-plugins"> -<title ->Plugins</title> - -<para ->The first setting here is <guilabel ->Enable Plugins globally</guilabel ->. If you disable this checkbox, then &konqueror; will not use any plugins. If you enable it, then any installed and configured plugins that it can find will be used by &konqueror;</para> - -<para ->You can also restrict &konqueror; to <guilabel ->Only allow HTTP and HTTPS URLs for plugins</guilabel -> by checking the box.</para> +<title>Plugins</title> + +<para>The first setting here is <guilabel>Enable Plugins globally</guilabel>. If you disable this checkbox, then &konqueror; will not use any plugins. If you enable it, then any installed and configured plugins that it can find will be used by &konqueror;</para> + +<para>You can also restrict &konqueror; to <guilabel>Only allow HTTP and HTTPS URLs for plugins</guilabel> by checking the box.</para> </sect2> &nsplugins-kcontrol; </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/tdehtml/nsplugin.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/tdehtml/nsplugin.docbook index 1e6ada4226a..84d50b0c398 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/tdehtml/nsplugin.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/tdehtml/nsplugin.docbook @@ -1,99 +1,43 @@ <sect2 id="nsplugins"> -<title ->&Netscape; Plugins</title> +<title>&Netscape; Plugins</title> <sect3 id="nsplugins-intro"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->As &Netscape;'s <application ->Navigator</application -> has been a web browsing standard for many years, so-called &Netscape; plugins have appeared that allow rich web content. Using those plugins, web sites can contain <acronym ->PDF</acronym -> files, flash animations, video, &etc; With &konqueror;, you can still use these plugins to take advantage of rich web content.</para> +<para>As &Netscape;'s <application>Navigator</application> has been a web browsing standard for many years, so-called &Netscape; plugins have appeared that allow rich web content. Using those plugins, web sites can contain <acronym>PDF</acronym> files, flash animations, video, &etc; With &konqueror;, you can still use these plugins to take advantage of rich web content.</para> -<note -><para ->&Netscape; plugins should not be confused with &konqueror; plugins. The latter ones specifically extend &konqueror;'s functionality; they are normally not used to display rich web content.</para -></note> +<note><para>&Netscape; plugins should not be confused with &konqueror; plugins. The latter ones specifically extend &konqueror;'s functionality; they are normally not used to display rich web content.</para></note> </sect3> <sect3 id="nsplugins-scan"> -<title ->Scan</title> - -<para ->&konqueror; has to know where your &Netscape; plugins are installed. This can be in several places, &ie; you might have system-wide plugins in <filename class="directory" ->/opt/netscape/plugins</filename -> and your personal plugins in <filename class="directory" ->$<envar ->HOME</envar ->/.netscape/plugins</filename ->. However, &konqueror; will not automatically use the installed plugins: it first has to scan a list of folders. You can initiate the scan by clicking <guibutton ->Scan for new plugins</guibutton ->. Alternatively, you can enable <guilabel ->Scan for new plugins at &kde; startup</guilabel -> so &konqueror; will scan the appropriate folders every time &kde; starts up, to see whether new plugins have been installed.</para> - -<note -><para ->Enabling <guilabel ->Scan for new plugins at &kde; startup</guilabel -> can considerably slow down the startup procedure, and is known to give difficulty on certain installations. Turn this option off if you experience problems.</para -></note> - -<para ->To find plugins, &konqueror; will look in the folders specified in the <guilabel ->Scan Folders</guilabel -> frame. When you use this control module for the first time, this list will already be filled with reasonable paths that should work on most operating systems. If you need to provide a new path, click the <guibutton ->New</guibutton -> button; then you can either enter the new path in the text edit box to the left, or choose a folder using the file dialogue by clicking the <guibutton ->New...</guibutton -> button. As scanning the folders can take a little time, you might want to remove folders from the list where you know that no plugins are installed: do this by selecting a folder and clicking <guibutton ->Remove</guibutton ->. Using the <guibutton ->Up</guibutton -> and <guibutton ->Down</guibutton -> buttons you can change the order in which folders will be scanned by moving the selected folder up or down.</para> - -<para ->As usual, click <guibutton ->Apply</guibutton -> to save your changes permanently.</para> +<title>Scan</title> + +<para>&konqueror; has to know where your &Netscape; plugins are installed. This can be in several places, &ie; you might have system-wide plugins in <filename class="directory">/opt/netscape/plugins</filename> and your personal plugins in <filename class="directory">$<envar>HOME</envar>/.netscape/plugins</filename>. However, &konqueror; will not automatically use the installed plugins: it first has to scan a list of folders. You can initiate the scan by clicking <guibutton>Scan for new plugins</guibutton>. Alternatively, you can enable <guilabel>Scan for new plugins at &kde; startup</guilabel> so &konqueror; will scan the appropriate folders every time &kde; starts up, to see whether new plugins have been installed.</para> + +<note><para>Enabling <guilabel>Scan for new plugins at &kde; startup</guilabel> can considerably slow down the startup procedure, and is known to give difficulty on certain installations. Turn this option off if you experience problems.</para></note> + +<para>To find plugins, &konqueror; will look in the folders specified in the <guilabel>Scan Folders</guilabel> frame. When you use this control module for the first time, this list will already be filled with reasonable paths that should work on most operating systems. If you need to provide a new path, click the <guibutton>New</guibutton> button; then you can either enter the new path in the text edit box to the left, or choose a folder using the file dialogue by clicking the <guibutton>New...</guibutton> button. As scanning the folders can take a little time, you might want to remove folders from the list where you know that no plugins are installed: do this by selecting a folder and clicking <guibutton>Remove</guibutton>. Using the <guibutton>Up</guibutton> and <guibutton>Down</guibutton> buttons you can change the order in which folders will be scanned by moving the selected folder up or down.</para> + +<para>As usual, click <guibutton>Apply</guibutton> to save your changes permanently.</para> </sect3> <sect3 id="nsplugins-plugins"> -<title ->Plugins</title> +<title>Plugins</title> -<para ->In this tab, you can see a list of the &Netscape; plugins found by &konqueror;, displayed as a tree. Double click on a plugin to fold it out and you'll see that the different mime types this plugin can handle will be displayed as branches. Fold out a mime type to see its info.</para> +<para>In this tab, you can see a list of the &Netscape; plugins found by &konqueror;, displayed as a tree. Double click on a plugin to fold it out and you'll see that the different mime types this plugin can handle will be displayed as branches. Fold out a mime type to see its info.</para> -<para ->This tab is mostly for informational purposes. The only configurable option is <guilabel ->Use artsdsp to pipe plugin sound through aRts</guilabel ->, which is enabled by default. Disable this if you wish plugins to use their own method for sounds, and you have configured &arts; in such a way that third-party applications can do so (for example, by having it exit when idle, or by having it use a custom sound device on modern soundcards which allow this.)</para> +<para>This tab is mostly for informational purposes. The only configurable option is <guilabel>Use artsdsp to pipe plugin sound through aRts</guilabel>, which is enabled by default. Disable this if you wish plugins to use their own method for sounds, and you have configured &arts; in such a way that third-party applications can do so (for example, by having it exit when idle, or by having it use a custom sound device on modern soundcards which allow this.)</para> </sect3> <sect3 id="nsplugins-author"> -<title ->Section Author</title> - -<para ->This section written by: Jost Schenck <email ->jost@schenck.de</email -></para> - -<para ->Conversion to British English: Malcolm Hunter <email ->malcolm.hunter@gmx.co.uk</email -></para -> +<title>Section Author</title> + +<para>This section written by: Jost Schenck <email>jost@schenck.de</email></para> + +<para>Conversion to British English: Malcolm Hunter <email>malcolm.hunter@gmx.co.uk</email></para> </sect3> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/tdm/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/tdm/index.docbook index a54991df318..8c5f5ea55f6 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/tdm/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/tdm/index.docbook @@ -2,504 +2,216 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Thomas.Tanghus; &Thomas.Tanghus.mail;</author> -<author ->&Steffen.Hansen; &Steffen.Hansen.mail;</author> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Thomas.Tanghus; &Thomas.Tanghus.mail;</author> +<author>&Steffen.Hansen; &Steffen.Hansen.mail;</author> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-13</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-13</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->TDM configuration</keyword> -<keyword ->login manager</keyword> -<keyword ->login</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>TDM configuration</keyword> +<keyword>login manager</keyword> +<keyword>login</keyword> </keywordset> </articleinfo> <sect1 id="login-manager"> -<title ->Login Manager</title> - -<para ->Using this module, you can configure the &kde; graphical login manager, &tdm;. You can change how the login screen looks, who has access using the login manager and who can shutdown the computer.</para> - -<para ->In order to organise all of these options, this module is divided into five sections: <link linkend="tdmconfig-appearance" -><guilabel ->Appearance</guilabel -></link ->, <link linkend="tdmconfig-font" -><guilabel ->Font</guilabel -></link ->, <link linkend="tdmconfig-background" -><guilabel ->Background</guilabel -></link ->, <link linkend="tdmconfig-sessions" -><guilabel ->Sessions</guilabel -></link ->, <link linkend="tdmconfig-users" -><guilabel ->Users</guilabel -></link -> and <link linkend="tdmconfig-convenience" -><guilabel ->Convenience</guilabel -></link ->.</para> - -<para ->You can switch between the sections using the tabs at the top of the window.</para> - -<note -><para ->If you are not currently logged in as a superuser, you will need to click the <guibutton ->Administrator Mode</guibutton -> Button. You will then be asked for a superuser password. Entering a correct password will allow you to modify the settings of this module.</para -></note> +<title>Login Manager</title> + +<para>Using this module, you can configure the &kde; graphical login manager, &tdm;. You can change how the login screen looks, who has access using the login manager and who can shutdown the computer.</para> + +<para>In order to organise all of these options, this module is divided into five sections: <link linkend="tdmconfig-appearance"><guilabel>Appearance</guilabel></link>, <link linkend="tdmconfig-font"><guilabel>Font</guilabel></link>, <link linkend="tdmconfig-background"><guilabel>Background</guilabel></link>, <link linkend="tdmconfig-sessions"><guilabel>Sessions</guilabel></link>, <link linkend="tdmconfig-users"><guilabel>Users</guilabel></link> and <link linkend="tdmconfig-convenience"><guilabel>Convenience</guilabel></link>.</para> + +<para>You can switch between the sections using the tabs at the top of the window.</para> + +<note><para>If you are not currently logged in as a superuser, you will need to click the <guibutton>Administrator Mode</guibutton> Button. You will then be asked for a superuser password. Entering a correct password will allow you to modify the settings of this module.</para></note> <sect2 id="tdmconfig-appearance"> -<title ->Appearance</title> +<title>Appearance</title> -<para ->From this page you can change the visual appearance of &tdm;, &kde;'s graphical login manager.</para> +<para>From this page you can change the visual appearance of &tdm;, &kde;'s graphical login manager.</para> -<para ->The greeting string is the title of the login screen. If the string contains the word <computeroutput ->HOSTNAME</computeroutput -> it will be translated to the domainless name of the machine &tdm; is installed on.</para> +<para>The greeting string is the title of the login screen. If the string contains the word <computeroutput>HOSTNAME</computeroutput> it will be translated to the domainless name of the machine &tdm; is installed on.</para> -<para ->You can then choose to show either the current system time, a logo or nothing special in the login box. Make your choice in the radio buttons labelled <guilabel ->Logo area</guilabel ->. Using the <guilabel ->Positions</guilabel -> setting, you can choose to either centre the content of the logo area or to position it using fixed coordinates.</para> +<para>You can then choose to show either the current system time, a logo or nothing special in the login box. Make your choice in the radio buttons labelled <guilabel>Logo area</guilabel>. Using the <guilabel>Positions</guilabel> setting, you can choose to either centre the content of the logo area or to position it using fixed coordinates.</para> -<para ->If you chose <guilabel ->Show logo</guilabel -> you can now choose a logo:</para> +<para>If you chose <guilabel>Show logo</guilabel> you can now choose a logo:</para> <itemizedlist> <listitem> -<para ->Drop an image file on the image button.</para> +<para>Drop an image file on the image button.</para> </listitem> <listitem> -<para ->Click on the image button and select a new image from the image chooser dialogue.</para> +<para>Click on the image button and select a new image from the image chooser dialogue.</para> </listitem> </itemizedlist> -<para ->If you do not specify a logo the default <filename ->$<envar ->TDEDIR</envar ->/share/apps/tdm/pics/kdelogo.png</filename -> will be displayed.</para> +<para>If you do not specify a logo the default <filename>$<envar>TDEDIR</envar>/share/apps/tdm/pics/kdelogo.png</filename> will be displayed.</para> -<para ->While &kde;'s style depends on the settings of the user logged in, the style used by &tdm; can be configured using the <guilabel ->GUI Style</guilabel -> option.</para> +<para>While &kde;'s style depends on the settings of the user logged in, the style used by &tdm; can be configured using the <guilabel>GUI Style</guilabel> option.</para> -<para ->Below that, you have two dropdown boxes to choose the language and the country for your login box.</para> +<para>Below that, you have two dropdown boxes to choose the language and the country for your login box.</para> </sect2> <sect2 id="tdmconfig-font"> -<title ->Font</title> - -<para ->From this section of the module you can change the fonts used in the login window.</para> - -<para ->You can select three different font styles from the drop down box (<guilabel ->Greeting</guilabel ->, <guilabel ->Fail</guilabel ->, <guilabel ->Standard</guilabel ->). When you click on the <guibutton ->Change font</guibutton -> button a dialogue appears from which you can select the new characteristics for the font style.</para> +<title>Font</title> + +<para>From this section of the module you can change the fonts used in the login window.</para> + +<para>You can select three different font styles from the drop down box (<guilabel>Greeting</guilabel>, <guilabel>Fail</guilabel>, <guilabel>Standard</guilabel>). When you click on the <guibutton>Change font</guibutton> button a dialogue appears from which you can select the new characteristics for the font style.</para> <itemizedlist> <listitem> -<para ->The <guilabel ->Greeting</guilabel -> font is the font used for the title (Greeting String).</para> +<para>The <guilabel>Greeting</guilabel> font is the font used for the title (Greeting String).</para> </listitem> <listitem> -<para ->The <guilabel ->Fail</guilabel -> font is used when a login fails.</para> +<para>The <guilabel>Fail</guilabel> font is used when a login fails.</para> </listitem> <listitem> -<para ->The <guilabel ->Standard</guilabel -> font is used in all other places in the login window.</para> +<para>The <guilabel>Standard</guilabel> font is used in all other places in the login window.</para> </listitem> </itemizedlist> -<para ->An example of each font can be seen in the <guilabel ->Example</guilabel -> Box.</para> +<para>An example of each font can be seen in the <guilabel>Example</guilabel> Box.</para> </sect2> <sect2 id="tdmconfig-background"> -<title ->Background</title> +<title>Background</title> -<para ->Here you can change the desktop background which will be displayed when a user logs in. You can have a single colour or an image as a background. If you have an image as the background and select centre, the selected background colour will be used around the image if it isn't large enough to cover the entire desktop.</para> +<para>Here you can change the desktop background which will be displayed when a user logs in. You can have a single colour or an image as a background. If you have an image as the background and select centre, the selected background colour will be used around the image if it isn't large enough to cover the entire desktop.</para> -<para ->The background colours and effects are controlled by the options on the tab labelled <guilabel ->Background</guilabel -> and you select a background image and its placement from the options on the tab labelled <guilabel ->Wallpaper</guilabel ->.</para> +<para>The background colours and effects are controlled by the options on the tab labelled <guilabel>Background</guilabel> and you select a background image and its placement from the options on the tab labelled <guilabel>Wallpaper</guilabel>.</para> -<para ->To change the default background colour(s) simply click either of the colour buttons and select a new colour.</para> +<para>To change the default background colour(s) simply click either of the colour buttons and select a new colour.</para> -<para ->The dropdown box above the colour buttons provides you with several different blend effects. Choose one from the list, and it will be previewed on the small monitor at the top of the window. Your choices are:</para> +<para>The dropdown box above the colour buttons provides you with several different blend effects. Choose one from the list, and it will be previewed on the small monitor at the top of the window. Your choices are:</para> <variablelist> <varlistentry> -<term ->Flat</term> -<listitem -><para ->By choosing this mode, you select one colour (using the colour button labelled <guibutton ->Colour 1</guibutton ->), and the entire background is covered with this one colour.</para -></listitem> +<term>Flat</term> +<listitem><para>By choosing this mode, you select one colour (using the colour button labelled <guibutton>Colour 1</guibutton>), and the entire background is covered with this one colour.</para></listitem> </varlistentry> <varlistentry> -<term ->Pattern</term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). </para -> <para ->You then select a pattern by clicking <guilabel ->Setup</guilabel ->. This opens a new dialogue window, which gives you the opportunity to select a pattern. Simply click once on the pattern of your choice, then click on <guilabel ->OK</guilabel ->, and &kde; will render the pattern you selected using the two colours you selected. For more on patterns, see the section <ulink url="help:/kcontrol/background/index.html#bkgnd-patterns" ->Background: Adding, Removing and Modifying Patterns</ulink ->.</para -></listitem> +<term>Pattern</term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). </para> <para>You then select a pattern by clicking <guilabel>Setup</guilabel>. This opens a new dialogue window, which gives you the opportunity to select a pattern. Simply click once on the pattern of your choice, then click on <guilabel>OK</guilabel>, and &kde; will render the pattern you selected using the two colours you selected. For more on patterns, see the section <ulink url="help:/kcontrol/background/index.html#bkgnd-patterns">Background: Adding, Removing and Modifying Patterns</ulink>.</para></listitem> </varlistentry> <varlistentry> -<term ->Background Program</term> -<listitem -><para ->By selecting this option, you can have &kde; use an external program to determine the background. This can be any program of your choosing. For more information on this option, see the section entitled <ulink url="help:/kcontrol/background/index.html#bkgnd-programs" ->Background: Using an external program</ulink ->.</para -></listitem> +<term>Background Program</term> +<listitem><para>By selecting this option, you can have &kde; use an external program to determine the background. This can be any program of your choosing. For more information on this option, see the section entitled <ulink url="help:/kcontrol/background/index.html#bkgnd-programs">Background: Using an external program</ulink>.</para></listitem> </varlistentry> <varlistentry> -<term ->Horizontal Gradient</term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel ->Colour 1</guilabel -> on the left edge of the screen, and slowly transform into the colour selected by <guilabel ->Colour 2</guilabel -> by the time it gets to the right edge of the screen.</para -></listitem> +<term>Horizontal Gradient</term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel>Colour 1</guilabel> on the left edge of the screen, and slowly transform into the colour selected by <guilabel>Colour 2</guilabel> by the time it gets to the right edge of the screen.</para></listitem> </varlistentry> <varlistentry> -<term ->Vertical Gradient</term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel ->Colour 1</guilabel -> on the top edge of the screen, and slowly transform into the colour selected by <guilabel ->Colour 2</guilabel -> as it moves to the bottom of the screen.</para -></listitem> +<term>Vertical Gradient</term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel>Colour 1</guilabel> on the top edge of the screen, and slowly transform into the colour selected by <guilabel>Colour 2</guilabel> as it moves to the bottom of the screen.</para></listitem> </varlistentry> <varlistentry> -<term ->Pyramid Gradient</term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel ->Colour 1</guilabel -> in each corner of the screen, and slowly transform into the colour selected by <guilabel ->Colour 2</guilabel -> as it moves to the centre of the screen.</para -></listitem -> +<term>Pyramid Gradient</term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel>Colour 1</guilabel> in each corner of the screen, and slowly transform into the colour selected by <guilabel>Colour 2</guilabel> as it moves to the centre of the screen.</para></listitem> </varlistentry> <varlistentry> -<term ->Pipecross Gradient</term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel ->Colour 1</guilabel -> in each corner of the screen, and slowly transform into the colour selected by <guilabel ->Colour 2</guilabel -> as it moves to the centre of the screen. The <quote ->shape</quote -> of this gradient is different then the pyramid gradient.</para -></listitem> +<term>Pipecross Gradient</term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel>Colour 1</guilabel> in each corner of the screen, and slowly transform into the colour selected by <guilabel>Colour 2</guilabel> as it moves to the centre of the screen. The <quote>shape</quote> of this gradient is different then the pyramid gradient.</para></listitem> </varlistentry> <varlistentry> -<term ->Elliptic Gradient</term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel ->Colour 2</guilabel -> in the centre of the screen, and slowly transform into the colour selected by <guilabel ->Colour 1</guilabel -> as it moves to the edges, in an elliptical pattern.</para -></listitem -> +<term>Elliptic Gradient</term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel>Colour 2</guilabel> in the centre of the screen, and slowly transform into the colour selected by <guilabel>Colour 1</guilabel> as it moves to the edges, in an elliptical pattern.</para></listitem> </varlistentry> </variablelist> -<para ->The setup button is only needed for if you select <guilabel ->Background program</guilabel -> or <guilabel ->Patterns</guilabel ->. In these instances, another window will appear to configure the specifics.</para> -<para -><emphasis ->Wallpaper</emphasis -></para> -<para ->To select a new background image first, click on the <guilabel ->Wallpapers</guilabel -> tab, then you can either select an image from the drop-down list labelled <guilabel ->Wallpaper</guilabel -> or select <guibutton ->Browse...</guibutton -> and select an image file from a file selector.</para> - -<para ->The image can be displayed in six different ways:</para> +<para>The setup button is only needed for if you select <guilabel>Background program</guilabel> or <guilabel>Patterns</guilabel>. In these instances, another window will appear to configure the specifics.</para> +<para><emphasis>Wallpaper</emphasis></para> +<para>To select a new background image first, click on the <guilabel>Wallpapers</guilabel> tab, then you can either select an image from the drop-down list labelled <guilabel>Wallpaper</guilabel> or select <guibutton>Browse...</guibutton> and select an image file from a file selector.</para> + +<para>The image can be displayed in six different ways:</para> <variablelist> <varlistentry> -<term ->No wallpaper</term -> -<listitem -><para ->No image is displayed. Just the background colours.</para> -</listitem -></varlistentry> +<term>No wallpaper</term> +<listitem><para>No image is displayed. Just the background colours.</para> +</listitem></varlistentry> <varlistentry> -<term ->Centred</term -> -<listitem -><para ->The image will be centred on the screen. The background colours will be present anywhere the image does not cover.</para -> </listitem> +<term>Centred</term> +<listitem><para>The image will be centred on the screen. The background colours will be present anywhere the image does not cover.</para> </listitem> </varlistentry> <varlistentry> -<term ->Tiled</term> -<listitem -><para ->The image will be duplicated until it fills the entire desktop. The first image will be placed in the upper left corner of the screen, and duplicated downward and to the right.</para -> </listitem> +<term>Tiled</term> +<listitem><para>The image will be duplicated until it fills the entire desktop. The first image will be placed in the upper left corner of the screen, and duplicated downward and to the right.</para> </listitem> </varlistentry> <varlistentry> -<term ->Centre Tiled</term> -<listitem -><para ->The image will be duplicated until it fills the entire desktop. The first image will be placed in the centre of the screen, and duplicated upward, downward to the right, and to the left.</para -> </listitem> +<term>Centre Tiled</term> +<listitem><para>The image will be duplicated until it fills the entire desktop. The first image will be placed in the centre of the screen, and duplicated upward, downward to the right, and to the left.</para> </listitem> </varlistentry> <varlistentry> -<term ->Centred Maxpect</term> -<listitem -><para ->The image will be placed in the centre of the screen. It will be scaled to fit the desktop, but it will not change the aspect ratio of the original image. This will provide you with an image that is not distorted. </para -> </listitem> +<term>Centred Maxpect</term> +<listitem><para>The image will be placed in the centre of the screen. It will be scaled to fit the desktop, but it will not change the aspect ratio of the original image. This will provide you with an image that is not distorted. </para> </listitem> </varlistentry> <varlistentry> -<term ->Scaled</term> -<listitem -><para ->The image will be scaled to fit the desktop. It will be stretched to fit all four corners.</para -> </listitem> +<term>Scaled</term> +<listitem><para>The image will be scaled to fit the desktop. It will be stretched to fit all four corners.</para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="tdmconfig-sessions"> -<title ->Sessions</title> - -<para -><guilabel ->Allow to shutdown</guilabel -></para> -<para ->Use this dropdown box to choose who is allowed to shut down:</para> +<title>Sessions</title> + +<para><guilabel>Allow to shutdown</guilabel></para> +<para>Use this dropdown box to choose who is allowed to shut down:</para> <itemizedlist> <listitem> -<para -><guilabel ->None</guilabel ->: No one can shutdown the computer using &tdm;. You must be logged in, and execute a command.</para> +<para><guilabel>None</guilabel>: No one can shutdown the computer using &tdm;. You must be logged in, and execute a command.</para> </listitem> <listitem> -<para -><guilabel ->All</guilabel ->: Everyone can shutdown the computer using &tdm;.</para> +<para><guilabel>All</guilabel>: Everyone can shutdown the computer using &tdm;.</para> </listitem> -<listitem -><para -><guilabel ->Root only</guilabel ->: &tdm; requires that the <systemitem ->root</systemitem -> password be entered before shutting down the computer.</para -></listitem -> -<listitem -><para -><guilabel ->Console only</guilabel ->: The user must be at this console, to shut down the computer.</para -></listitem> +<listitem><para><guilabel>Root only</guilabel>: &tdm; requires that the <systemitem>root</systemitem> password be entered before shutting down the computer.</para></listitem> +<listitem><para><guilabel>Console only</guilabel>: The user must be at this console, to shut down the computer.</para></listitem> </itemizedlist> -<para -><emphasis ->Commands</emphasis -></para> -<para ->Use these 3 blanks to define the exact shutdown command.</para> -<para ->The shutdown command defaults to:</para> - -<para -><command ->/sbin/shutdown</command -></para> - -<para ->The restart command defaults to:</para> - -<para -><command ->/sbin/reboot</command -></para> - -<para ->The Console mode (which restarts the computer as a console only terminal) defaults to:</para> - -<para -><command ->/sbin/init <option ->3</option -></command -></para> - -<para ->When <guilabel ->Show boot options</guilabel -> is enabled, &tdm; will on reboot offer you options for the lilo boot manager. For this feature to work, you will need to supply the correct paths to your <command ->lilo</command -> command and to lilo's map file.</para> +<para><emphasis>Commands</emphasis></para> +<para>Use these 3 blanks to define the exact shutdown command.</para> +<para>The shutdown command defaults to:</para> + +<para><command>/sbin/shutdown</command></para> + +<para>The restart command defaults to:</para> + +<para><command>/sbin/reboot</command></para> + +<para>The Console mode (which restarts the computer as a console only terminal) defaults to:</para> + +<para><command>/sbin/init <option>3</option></command></para> + +<para>When <guilabel>Show boot options</guilabel> is enabled, &tdm; will on reboot offer you options for the lilo boot manager. For this feature to work, you will need to supply the correct paths to your <command>lilo</command> command and to lilo's map file.</para> <sect3 id="tdmconfig-sess"> -<title ->Session types</title> - -<para ->Define which session types should be accessible from the login window.</para> - -<para ->For more information on this subject, look at <filename class="directory" ->/etc/X11/xdm/Xsession</filename -> to find your <application ->xdm</application -> setup files. Also review the <ulink url="man:xdm" ->xdm man pages</ulink ->, especially under the SESSION PROGRAM section.</para> - -<para ->To add a session, type its name in the blank entitled <guilabel ->New types</guilabel ->, and click <guibutton ->Add new</guibutton ->. </para> - -<para ->To remove a session, select the session from the list and click <guibutton ->Remove</guibutton ->.</para> +<title>Session types</title> + +<para>Define which session types should be accessible from the login window.</para> + +<para>For more information on this subject, look at <filename class="directory">/etc/X11/xdm/Xsession</filename> to find your <application>xdm</application> setup files. Also review the <ulink url="man:xdm">xdm man pages</ulink>, especially under the SESSION PROGRAM section.</para> + +<para>To add a session, type its name in the blank entitled <guilabel>New types</guilabel>, and click <guibutton>Add new</guibutton>. </para> + +<para>To remove a session, select the session from the list and click <guibutton>Remove</guibutton>.</para> </sect3> @@ -507,210 +219,98 @@ <sect2 id="tdmconfig-users"> -<title ->Users</title> +<title>Users</title> -<para ->From here you can change the way users are represented in the login window.</para> +<para>From here you can change the way users are represented in the login window.</para> -<para ->As you look on this window, you will see three lists (All users, selected users, and no-show users). You also see an image box, and a set of options along the right side of the window.</para> +<para>As you look on this window, you will see three lists (All users, selected users, and no-show users). You also see an image box, and a set of options along the right side of the window.</para> -<para ->The first thing you must decide, is if you are going to show users or not.</para> +<para>The first thing you must decide, is if you are going to show users or not.</para> -<para ->If you choose to show users, then the login window will show images (which you select), of a list of users. When someone is ready to login, they select their user name/image, enter their password, and they are granted access. </para> +<para>If you choose to show users, then the login window will show images (which you select), of a list of users. When someone is ready to login, they select their user name/image, enter their password, and they are granted access. </para> -<para ->If you choose not to show users, then the login window will be more traditional. Users will need to type their username, and password to gain entrance. This is the preferred way if you have many users on this terminal.</para> +<para>If you choose not to show users, then the login window will be more traditional. Users will need to type their username, and password to gain entrance. This is the preferred way if you have many users on this terminal.</para> <sect3 id="tdmconfig-showusers"> -<title ->To show (and sort) or not to show users</title> +<title>To show (and sort) or not to show users</title> -<para ->Along the right edge of the window are two check boxes:</para> +<para>Along the right edge of the window are two check boxes:</para> -<para ->If <guilabel ->Show users</guilabel -> is selected, you have chosen to show images of users, instead of making them type their login name.</para> +<para>If <guilabel>Show users</guilabel> is selected, you have chosen to show images of users, instead of making them type their login name.</para> -<para ->If <guilabel ->Sort users</guilabel -> is selected, then the list of users will be sorted alphabetically in the login window. If unchecked, users will be listed in the same order as they are on this page. If <guilabel ->Show users</guilabel -> is not checked, this has no effect.</para> +<para>If <guilabel>Sort users</guilabel> is selected, then the list of users will be sorted alphabetically in the login window. If unchecked, users will be listed in the same order as they are on this page. If <guilabel>Show users</guilabel> is not checked, this has no effect.</para> </sect3> <sect3 id="tdmconfig-whichusers"> -<title ->How to determine which users to show and which users to hide</title> +<title>How to determine which users to show and which users to hide</title> -<para ->Below the user image box, and above the <guilabel ->Show users</guilabel -> check box, is a set of two radio buttions:</para> +<para>Below the user image box, and above the <guilabel>Show users</guilabel> check box, is a set of two radio buttions:</para> <itemizedlist> -<listitem -><para ->Show only selected users: If this option is selected, only the users contained in the list labelled <guilabel ->Selected Users</guilabel ->, will be displayed in the login window. If <guilabel ->Show users</guilabel -> is not checked, this has no effect.</para -></listitem> -<listitem -><para ->Show all users but no-show users: If this option is selected, all users will be listed, <emphasis ->except</emphasis -> those users contained in the list entitled <guilabel ->No show users</guilabel ->. If <guilabel ->Show users</guilabel -> is not checked, this has no effect. </para -></listitem> +<listitem><para>Show only selected users: If this option is selected, only the users contained in the list labelled <guilabel>Selected Users</guilabel>, will be displayed in the login window. If <guilabel>Show users</guilabel> is not checked, this has no effect.</para></listitem> +<listitem><para>Show all users but no-show users: If this option is selected, all users will be listed, <emphasis>except</emphasis> those users contained in the list entitled <guilabel>No show users</guilabel>. If <guilabel>Show users</guilabel> is not checked, this has no effect. </para></listitem> </itemizedlist> </sect3> <sect3 id="tdmconfig-select"> -<title ->Select users</title> +<title>Select users</title> -<para ->This page contains three listboxes. The large listbox on the left shows all the users on the system which might be a genuine user.</para> +<para>This page contains three listboxes. The large listbox on the left shows all the users on the system which might be a genuine user.</para> -<para ->The top rightmost listbox shows the selected users and the bottom rightmost listbox shows the users we don't want displayed in the login window.</para> +<para>The top rightmost listbox shows the selected users and the bottom rightmost listbox shows the users we don't want displayed in the login window.</para> -<para ->To move a user from one listbox to another you click on the username in the listbox and click <guibutton ->>></guibutton -> to move the user from the leftmost box the the rightmost box or <guibutton -><<</guibutton -> to move the user from the rightmost box to the leftmost box.</para> +<para>To move a user from one listbox to another you click on the username in the listbox and click <guibutton>>></guibutton> to move the user from the leftmost box the the rightmost box or <guibutton><<</guibutton> to move the user from the rightmost box to the leftmost box.</para> </sect3> <sect3 id="tdmconfig-image"> -<title ->Images</title> - -<note -><para ->This section of the manual only applies if <guilabel ->Show users</guilabel -> is selected. If it is not, this image box has no effect.</para -></note> - -<para ->Every user on the system can be represented by a image. The image for the user is kept in a file called <filename ->$<envar ->TDEDIR</envar ->/share/apps/tdm/pics/users/$<envar ->USER</envar ->.xpm.</filename -> If the user doesn't have such a file the file <filename ->$<envar ->TDEDIR</envar ->/share/apps/tdm/pics/users/default.xpm</filename -> will be used instead.</para> - -<para ->To assign a new image to a user just select the user in one of the listboxes and either drop an imagefile on the image button to the right or click on the image button and select a new image from the image selector.</para> - -<para ->If no user is currently selected you will be asked if you want to change the default image.</para> - -<para ->The replacement is performed by a &konqueror; process so if the image file already exists you will be prompted by &konqueror; if you want to replace it. If you confirm the image will be replaced - you will <emphasis ->not</emphasis -> have to press the <guibutton ->Apply</guibutton -> button.</para> +<title>Images</title> + +<note><para>This section of the manual only applies if <guilabel>Show users</guilabel> is selected. If it is not, this image box has no effect.</para></note> + +<para>Every user on the system can be represented by a image. The image for the user is kept in a file called <filename>$<envar>TDEDIR</envar>/share/apps/tdm/pics/users/$<envar>USER</envar>.xpm.</filename> If the user doesn't have such a file the file <filename>$<envar>TDEDIR</envar>/share/apps/tdm/pics/users/default.xpm</filename> will be used instead.</para> + +<para>To assign a new image to a user just select the user in one of the listboxes and either drop an imagefile on the image button to the right or click on the image button and select a new image from the image selector.</para> + +<para>If no user is currently selected you will be asked if you want to change the default image.</para> + +<para>The replacement is performed by a &konqueror; process so if the image file already exists you will be prompted by &konqueror; if you want to replace it. If you confirm the image will be replaced - you will <emphasis>not</emphasis> have to press the <guibutton>Apply</guibutton> button.</para> </sect3> </sect2> <sect2 id="tdmconfig-convenience"> -<title ->Convenience</title> +<title>Convenience</title> -<para ->In the <guilabel ->convenience</guilabel -> tab you can configure some options that make life easier for lazy people, like auto login or disabling passwords.</para> +<para>In the <guilabel>convenience</guilabel> tab you can configure some options that make life easier for lazy people, like auto login or disabling passwords.</para> -<important -><para ->Please think more than twice before using these options. Every option in the <guilabel ->convenience</guilabel -> tab is well-suited to seriously compromise your system security. Practically, these options are only to be used in a completely non-critical environment, ⪚ a private computer at home. </para -></important> +<important><para>Please think more than twice before using these options. Every option in the <guilabel>convenience</guilabel> tab is well-suited to seriously compromise your system security. Practically, these options are only to be used in a completely non-critical environment, ⪚ a private computer at home. </para></important> <sect3 id="loginmanager-convenience-autologin"> -<title ->Automatic Login</title> - -<para ->Automatic login will give anyone access to a certain account on your system without doing any authentication. You can enable it using the option <guilabel ->Enable auto-login</guilabel ->.</para> - -<para ->Automatic login comes in two flavours: <guilabel ->truly automatic login</guilabel -> acts like you would expect automatic login to, &ie; &tdm; will automatically login without expecting any input from the user. Enable this using the <guilabel ->Truly automatic login</guilabel -> option. If this option is not enabled, &tdm; will start normally, enabling you to login as any user, and will only perform automatic login if you kill the X server, ⪚ by pressing <keycombo action="simul" ->&Ctrl;&Alt;<keycap ->Backspace</keycap -></keycombo ->.</para> - -<para ->You can choose the account to be used for automatic login in the list below.</para> +<title>Automatic Login</title> + +<para>Automatic login will give anyone access to a certain account on your system without doing any authentication. You can enable it using the option <guilabel>Enable auto-login</guilabel>.</para> + +<para>Automatic login comes in two flavours: <guilabel>truly automatic login</guilabel> acts like you would expect automatic login to, &ie; &tdm; will automatically login without expecting any input from the user. Enable this using the <guilabel>Truly automatic login</guilabel> option. If this option is not enabled, &tdm; will start normally, enabling you to login as any user, and will only perform automatic login if you kill the X server, ⪚ by pressing <keycombo action="simul">&Ctrl;&Alt;<keycap>Backspace</keycap></keycombo>.</para> + +<para>You can choose the account to be used for automatic login in the list below.</para> </sect3> <sect3 id="loginmanager-convenience-nopasswd"> -<title ->Password-less Login</title> - -<para ->Using this feature, you can allow certain users to login without having to provide their password. Enable this feature using the <guilabel ->Enable password-less logins</guilabel -> option.</para> - -<para ->Below this option you will see a list of users for which a password is required, as well as a (by default, empty) list of users that do not need to provide a password. When <guilabel ->Enable password-less logins</guilabel -> is enabled, you can move users from one list into the other, by selecting them and then clicking the <guibutton ->>></guibutton -> and <guibutton -><<</guibutton -> buttons.</para> - -<important -><para ->Again, this option should only be used in a safe environment. If you enable it on a rather public system you should take care that only users with heavy access restrictions are granted password-less login, ⪚ <systemitem ->guest</systemitem ->.</para -></important> - -<para ->The <guilabel ->Automatically login after X server crash</guilabel -> option allows you to skip the authentication procedure when your X server accidentally crashed. <guilabel ->Show previous user</guilabel -> will show the name of the last login already entered into the login field in &tdm;. Some site administrators would consider even this a possible security weakness, because potential attackers then know at least one valid login.</para> +<title>Password-less Login</title> + +<para>Using this feature, you can allow certain users to login without having to provide their password. Enable this feature using the <guilabel>Enable password-less logins</guilabel> option.</para> + +<para>Below this option you will see a list of users for which a password is required, as well as a (by default, empty) list of users that do not need to provide a password. When <guilabel>Enable password-less logins</guilabel> is enabled, you can move users from one list into the other, by selecting them and then clicking the <guibutton>>></guibutton> and <guibutton><<</guibutton> buttons.</para> + +<important><para>Again, this option should only be used in a safe environment. If you enable it on a rather public system you should take care that only users with heavy access restrictions are granted password-less login, ⪚ <systemitem>guest</systemitem>.</para></important> + +<para>The <guilabel>Automatically login after X server crash</guilabel> option allows you to skip the authentication procedure when your X server accidentally crashed. <guilabel>Show previous user</guilabel> will show the name of the last login already entered into the login field in &tdm;. Some site administrators would consider even this a possible security weakness, because potential attackers then know at least one valid login.</para> </sect3> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/twindecoration/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/twindecoration/index.docbook index b4194089571..a7731676695 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/twindecoration/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/twindecoration/index.docbook @@ -2,87 +2,48 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Rik.Hemsley; &Rik.Hemsley.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Rik.Hemsley; &Rik.Hemsley.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-09-28</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-09-28</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->twin</keyword> -<keyword ->window</keyword> -<keyword ->border</keyword> -<keyword ->theme</keyword> -<keyword ->style</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>twin</keyword> +<keyword>window</keyword> +<keyword>border</keyword> +<keyword>theme</keyword> +<keyword>style</keyword> </keywordset> </articleinfo> <sect1 id="window-deco"> -<title ->Window Decoration</title> +<title>Window Decoration</title> <sect2> -<title ->General</title> +<title>General</title> -<para ->This module allows you to select a style for the borders around windows.</para> +<para>This module allows you to select a style for the borders around windows.</para> -<para ->Each style has a different look, but also a different <quote ->feel</quote ->. Some have (sometimes invisible) <quote ->resize</quote -> borders all around the edge, which make resizing easier but moving more difficult. Some have no borders on certain edges. One (<quote ->BII</quote ->) even has a dynamically sized and positioned title element.</para> +<para>Each style has a different look, but also a different <quote>feel</quote>. Some have (sometimes invisible) <quote>resize</quote> borders all around the edge, which make resizing easier but moving more difficult. Some have no borders on certain edges. One (<quote>BII</quote>) even has a dynamically sized and positioned title element.</para> -<para ->You are encouraged to experiment with the different styles until you find one which best suits your pattern of work.</para> +<para>You are encouraged to experiment with the different styles until you find one which best suits your pattern of work.</para> -<para ->Choose a window decoration style from the drop down box at the top of the screen to see a preview of it in the lower pane.</para> +<para>Choose a window decoration style from the drop down box at the top of the screen to see a preview of it in the lower pane.</para> -<para ->If there are any configurable options for the theme you chose on the first page, they will become available below the preview...</para> +<para>If there are any configurable options for the theme you chose on the first page, they will become available below the preview...</para> <!-- -<para ->In particular, if you chose to use the IceWM theme, you can choose +<para>In particular, if you chose to use the IceWM theme, you can choose here which of the many IceWM themes to use. The IceWM theme has instructions on the page as to where you should copy the theme files, and once this is done, you can simply select the theme you want to @@ -92,28 +53,22 @@ use.</para> </sect2> <sect2> -<title ->Buttons</title> +<title>Buttons</title> -<para ->This page has instructions directly on it - just drag around the buttons until you have the order that makes you comfortable.</para> +<para>This page has instructions directly on it - just drag around the buttons until you have the order that makes you comfortable.</para> <note> -<para ->Not all the window decorations are able to comply with your custom set button order. The ones that cannot are being converted, but at the time of this release they have not been all been changed.</para> +<para>Not all the window decorations are able to comply with your custom set button order. The ones that cannot are being converted, but at the time of this release they have not been all been changed.</para> </note> -<para ->Apart from choosing the window decoration itself, you can choose here two further options: If there should be a tooltip while you hover your mouse over a window decoration button, and if the window decoration should attempt to use a custom set button order.</para> +<para>Apart from choosing the window decoration itself, you can choose here two further options: If there should be a tooltip while you hover your mouse over a window decoration button, and if the window decoration should attempt to use a custom set button order.</para> <tip> -<para ->The tooltips can be quite useful if you have set a custom button order, and then changed to an unfamiliar window decoration.</para> +<para>The tooltips can be quite useful if you have set a custom button order, and then changed to an unfamiliar window decoration.</para> </tip> <tip> -<para ->For accessibility purposes, some window decorations support extra wide borders. If this is available, you can also choose a border size here. These large borders are easier to see for low vision users, and easier to grab for people with limited mobility or difficulty using a mouse.</para> +<para>For accessibility purposes, some window decorations support extra wide borders. If this is available, you can also choose a border size here. These large borders are easier to see for low vision users, and easier to grab for people with limited mobility or difficulty using a mouse.</para> </tip> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/useragent/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/useragent/index.docbook index 09f16321c6c..df515db9587 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/useragent/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/useragent/index.docbook @@ -2,149 +2,67 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title ->Browser Identification</title> +<title>Browser Identification</title> <articleinfo> <authorgroup> -<author ->&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-12</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-12</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->user agent</keyword> -<keyword ->browser</keyword> -<keyword ->identification</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>user agent</keyword> +<keyword>browser</keyword> +<keyword>identification</keyword> </keywordset> </articleinfo> <sect1 id="user-agent"> -<title ->Browser Identification</title> +<title>Browser Identification</title> <sect2 id="user-agent-intro"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->When &konqueror; connects to a web site to retrieve information, some basic identifying information is sent to the web site in the form of a <quote ->User Agent</quote -> header.</para> +<para>When &konqueror; connects to a web site to retrieve information, some basic identifying information is sent to the web site in the form of a <quote>User Agent</quote> header.</para> -<para ->Because of minor differences in the way that different web browsers function, web sites that rely too much on a single browser may sometimes not display as intended when viewed using another browser. Some web sites are smart enough to examine the contents of the user agent header and incorporate this information in the <acronym ->HTML</acronym -> code so that the content is displayed correctly regardless of the browser used.</para> +<para>Because of minor differences in the way that different web browsers function, web sites that rely too much on a single browser may sometimes not display as intended when viewed using another browser. Some web sites are smart enough to examine the contents of the user agent header and incorporate this information in the <acronym>HTML</acronym> code so that the content is displayed correctly regardless of the browser used.</para> -<para ->However, you may find that some web sites refuse to function correctly unless you are using a browser recognised as <quote ->proper</quote -> by that site. In these cases, you may find it necessary to fool the web site by having &konqueror; report itself to be another browser by means of the user agent header.</para> +<para>However, you may find that some web sites refuse to function correctly unless you are using a browser recognised as <quote>proper</quote> by that site. In these cases, you may find it necessary to fool the web site by having &konqueror; report itself to be another browser by means of the user agent header.</para> </sect2> <sect2 id="user-agent-use"> -<title ->Use</title> - -<para ->In this module you can configure the type of browser that &konqueror; will report itself to be. You can control this information by web site. Usually, the list box that is labeled <guilabel ->Site/Domain Specific Identification</guilabel -> will be empty, so that &konqueror; will always use its default useragent string.</para> - -<para ->You can disable the sending of a user agent entirely, by unchecking the <guilabel ->Send identification</guilabel -> checkbox. This may cause strange behaviour on some sites, and may even deny you access to some websites, so disable this with caution.</para> - -<para ->To configure a new agent binding, press the <guibutton ->New...</guibutton -> button. Type the name of the server or a domain in the text box at the top of the dialogue that pops up, which is labelled <guilabel ->When browsing the following site</guilabel ->.</para> - -<para ->Note that you can <emphasis ->not</emphasis -> use the wildcard character <token ->*</token -> in this text box. However, the string <userinput ->kde.org</userinput -> will match all hosts in the domain <systemitem ->kde.org</systemitem -></para> - -<para ->After typing the name of the server, type in the identifying string in the next combo box, which is labeled <guilabel ->Use the following identity:</guilabel ->, or choose a string from the list. If you don't choose a string from the list, you will need to know what a valid string from the browser looks like. For example, you could type <userinput ->Mozilla/4.0 (compatible; MSIE 4.0)</userinput ->. </para> - -<para ->In the field labelled <guilabel ->Alias (description)</guilabel -> you can enter a descriptive name for the configured binding, ⪚ <userinput ->Netscape Navigator 4.75 on Linux</userinput -> for the useragent string <userinput ->Mozilla/4.75 (X11; U; Linux 2.2.14 i686)</userinput ->.</para> - -<para ->You can click on an existing entry in the <guilabel ->Configured agent bindings</guilabel -> list, and then modify the contents of the text boxes, followed by clicking <guibutton ->Change...</guibutton ->.</para> - -<para ->The <guibutton ->Delete</guibutton -> button can be used to delete the selected entry in the list of configured agent bindings. The <guibutton ->Delete All</guibutton -> will remove all the configured user agent strings. Click the <guibutton ->Apply</guibutton -> to take your changes in effect.</para> - -<para ->You can use the checkboxes at the top of the screen to build a user agent that is uniquely yours, by choosing your own combination of operating system name and version, platform, processor type, and language.</para> - -<para ->In all cases, the user agent that is being sent by default is displayed in bold text at the top of the page.</para> +<title>Use</title> + +<para>In this module you can configure the type of browser that &konqueror; will report itself to be. You can control this information by web site. Usually, the list box that is labeled <guilabel>Site/Domain Specific Identification</guilabel> will be empty, so that &konqueror; will always use its default useragent string.</para> + +<para>You can disable the sending of a user agent entirely, by unchecking the <guilabel>Send identification</guilabel> checkbox. This may cause strange behaviour on some sites, and may even deny you access to some websites, so disable this with caution.</para> + +<para>To configure a new agent binding, press the <guibutton>New...</guibutton> button. Type the name of the server or a domain in the text box at the top of the dialogue that pops up, which is labelled <guilabel>When browsing the following site</guilabel>.</para> + +<para>Note that you can <emphasis>not</emphasis> use the wildcard character <token>*</token> in this text box. However, the string <userinput>kde.org</userinput> will match all hosts in the domain <systemitem>kde.org</systemitem></para> + +<para>After typing the name of the server, type in the identifying string in the next combo box, which is labeled <guilabel>Use the following identity:</guilabel>, or choose a string from the list. If you don't choose a string from the list, you will need to know what a valid string from the browser looks like. For example, you could type <userinput>Mozilla/4.0 (compatible; MSIE 4.0)</userinput>. </para> + +<para>In the field labelled <guilabel>Alias (description)</guilabel> you can enter a descriptive name for the configured binding, ⪚ <userinput>Netscape Navigator 4.75 on Linux</userinput> for the useragent string <userinput>Mozilla/4.75 (X11; U; Linux 2.2.14 i686)</userinput>.</para> + +<para>You can click on an existing entry in the <guilabel>Configured agent bindings</guilabel> list, and then modify the contents of the text boxes, followed by clicking <guibutton>Change...</guibutton>.</para> + +<para>The <guibutton>Delete</guibutton> button can be used to delete the selected entry in the list of configured agent bindings. The <guibutton>Delete All</guibutton> will remove all the configured user agent strings. Click the <guibutton>Apply</guibutton> to take your changes in effect.</para> + +<para>You can use the checkboxes at the top of the screen to build a user agent that is uniquely yours, by choosing your own combination of operating system name and version, platform, processor type, and language.</para> + +<para>In all cases, the user agent that is being sent by default is displayed in bold text at the top of the page.</para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kcontrol/windowmanagement/index.docbook b/tde-i18n-en_GB/docs/tdebase/kcontrol/windowmanagement/index.docbook index 6812a8d7013..8e49122c52d 100644 --- a/tde-i18n-en_GB/docs/tdebase/kcontrol/windowmanagement/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kcontrol/windowmanagement/index.docbook @@ -2,457 +2,221 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<author ->&Jost.Schenck; &Jost.Schenck.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<author>&Jost.Schenck; &Jost.Schenck.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2004-05-04</date> -<releaseinfo ->3.2</releaseinfo> +<date>2004-05-04</date> +<releaseinfo>3.2</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->actions</keyword> -<keyword ->window placement</keyword> -<keyword ->window size</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>actions</keyword> +<keyword>window placement</keyword> +<keyword>window size</keyword> </keywordset> </articleinfo> <sect1 id="window-behavior"> -<title ->Window Behaviour</title> - -<para ->In the upper part of this control module you can see several tabs: <guilabel ->Focus</guilabel ->, <guilabel ->Actions</guilabel ->, <guilabel ->Moving</guilabel -> and <guilabel ->Advanced</guilabel ->. In the <guilabel ->Focus</guilabel -> panel you can configure how windows gain or lose focus, &ie; become active or inactive. Using <guilabel ->Actions</guilabel -> you can configure how windows react to mouse clicks. <guilabel ->Moving</guilabel -> allows you to configure how windows move and place themselves when started. The <guilabel ->Advanced</guilabel -> options cover some specialized options involving moving windows between desktops and <quote ->window shading</quote ->. </para> +<title>Window Behaviour</title> + +<para>In the upper part of this control module you can see several tabs: <guilabel>Focus</guilabel>, <guilabel>Actions</guilabel>, <guilabel>Moving</guilabel> and <guilabel>Advanced</guilabel>. In the <guilabel>Focus</guilabel> panel you can configure how windows gain or lose focus, &ie; become active or inactive. Using <guilabel>Actions</guilabel> you can configure how windows react to mouse clicks. <guilabel>Moving</guilabel> allows you to configure how windows move and place themselves when started. The <guilabel>Advanced</guilabel> options cover some specialized options involving moving windows between desktops and <quote>window shading</quote>. </para> <note> -<para ->Please note that the configuration in this module will not take effect if you don't use &kde;'s native window manager, &twin;. If you do use a different window manager, please refer to its documentation for how to customise window behaviour. </para> +<para>Please note that the configuration in this module will not take effect if you don't use &kde;'s native window manager, &twin;. If you do use a different window manager, please refer to its documentation for how to customise window behaviour. </para> </note> <sect2 id="action-focus"> -<title ->Focus</title> +<title>Focus</title> -<para ->The <quote ->focus</quote -> of the desktop refers to the window which the user is currently working on. The window with focus is often referred to as the <quote ->active window</quote ->. </para> +<para>The <quote>focus</quote> of the desktop refers to the window which the user is currently working on. The window with focus is often referred to as the <quote>active window</quote>. </para> -<para ->Focus does not necessarily mean the window is the one at the front — this is referred to as <quote ->raised</quote ->, and although this is configured here as well, focus and raising of windows are configured independently.</para> +<para>Focus does not necessarily mean the window is the one at the front — this is referred to as <quote>raised</quote>, and although this is configured here as well, focus and raising of windows are configured independently.</para> <sect3 id="action-focus-focuspolicy"> -<title ->Focus Policy</title> +<title>Focus Policy</title> -<para ->There are four methods &kde; can use to determine the current focus: </para> +<para>There are four methods &kde; can use to determine the current focus: </para> <variablelist> <varlistentry> -<term -><guilabel ->Click to Focus</guilabel -></term> +<term><guilabel>Click to Focus</guilabel></term> <listitem> -<para ->A window becomes active when you click into it. </para> +<para>A window becomes active when you click into it. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Focus follows mouse</guilabel -></term> +<term><guilabel>Focus follows mouse</guilabel></term> <listitem> -<para ->Moving the mouse pointer actively over a normal window activates it. New windows such as the mini command line invoked with <keycombo action="simul" ->&Alt;<keycap ->F2</keycap -></keycombo -> will receive the focus, without you having to point the mouse at them explicitly. </para> - -<para ->In other window managers, this is sometimes known as <quote ->Sloppy focus follows mouse</quote ->. </para> +<para>Moving the mouse pointer actively over a normal window activates it. New windows such as the mini command line invoked with <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> will receive the focus, without you having to point the mouse at them explicitly. </para> + +<para>In other window managers, this is sometimes known as <quote>Sloppy focus follows mouse</quote>. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Focus under mouse</guilabel -></term> +<term><guilabel>Focus under mouse</guilabel></term> <listitem> -<para ->The window that happens to be under the mouse pointer becomes active. If the mouse is not over a window (for instance, it's on the desktop) the last window that was under the mouse has focus. New windows such as the mini command line invoked with <keycombo action="simul" ->&Alt;<keycap ->F2</keycap -></keycombo -> will not receive the focus, you must move the mouse over them to type. </para> +<para>The window that happens to be under the mouse pointer becomes active. If the mouse is not over a window (for instance, it's on the desktop) the last window that was under the mouse has focus. New windows such as the mini command line invoked with <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> will not receive the focus, you must move the mouse over them to type. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Focus strictly under mouse</guilabel -></term> +<term><guilabel>Focus strictly under mouse</guilabel></term> <listitem> -<para ->Similar to <guilabel ->Focus under mouse</guilabel ->, but even more strict with its interpretation. Only the window under the mouse pointer is active. If the mouse pointer is not over a window, no window has focus. New windows such as the mini command line invoked with <keycombo action="simul" ->&Alt;<keycap ->F2</keycap -></keycombo -> will not receive the focus, you must move the mouse over them to type. </para> - -<note -><para ->Note that <guilabel ->Focus under mouse</guilabel -> and <guilabel ->Focus strictly under mouse</guilabel -> prevent certain features, such as the <keycombo action="simul" ->&Alt;	</keycombo -> walk-through-windows dialogue, from working properly.</para> +<para>Similar to <guilabel>Focus under mouse</guilabel>, but even more strict with its interpretation. Only the window under the mouse pointer is active. If the mouse pointer is not over a window, no window has focus. New windows such as the mini command line invoked with <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> will not receive the focus, you must move the mouse over them to type. </para> + +<note><para>Note that <guilabel>Focus under mouse</guilabel> and <guilabel>Focus strictly under mouse</guilabel> prevent certain features, such as the <keycombo action="simul">&Alt;	</keycombo> walk-through-windows dialogue, from working properly.</para> </note> </listitem> </varlistentry> </variablelist> -<para ->Once you have determined the focus policy, there are the window raising options. </para> +<para>Once you have determined the focus policy, there are the window raising options. </para> -<para ->By placing a mark in front of <guilabel ->Auto Raise</guilabel ->, &kde; can bring a window to the front if the mouse is over that window for a specified period of time. This is very useful with the <guilabel ->Focus follows Mouse</guilabel -> option. You can determine the delay by using the slider bar/spin box combination. </para> +<para>By placing a mark in front of <guilabel>Auto Raise</guilabel>, &kde; can bring a window to the front if the mouse is over that window for a specified period of time. This is very useful with the <guilabel>Focus follows Mouse</guilabel> option. You can determine the delay by using the slider bar/spin box combination. </para> <tip> -<para ->Setting the delay too short will cause a rapid fire changing of windows, which can be quite distracting. Most people will like a delay of 100-300 ms. This is responsive, but it will let you slide over the corners of a window on your way to your destination without bringing that window to the front. </para> +<para>Setting the delay too short will cause a rapid fire changing of windows, which can be quite distracting. Most people will like a delay of 100-300 ms. This is responsive, but it will let you slide over the corners of a window on your way to your destination without bringing that window to the front. </para> </tip> -<para ->If you do not use <guilabel ->Auto Raise</guilabel ->, make sure the <guilabel ->Click Raise</guilabel -> option has a mark in front of it. You will not be happy with both <guilabel ->Auto Raise</guilabel -> and <guilabel ->Click Raise</guilabel -> disabled, the net effect is that windows are not raised at all. </para> +<para>If you do not use <guilabel>Auto Raise</guilabel>, make sure the <guilabel>Click Raise</guilabel> option has a mark in front of it. You will not be happy with both <guilabel>Auto Raise</guilabel> and <guilabel>Click Raise</guilabel> disabled, the net effect is that windows are not raised at all. </para> </sect3> <sect3 id="action-focus-keyboard"> -<title -><guilabel ->Navigation</guilabel -></title> - -<para ->In the <guilabel ->Navigation</guilabel -> frame you can configure the way switching between applications or desktops using <keycombo action="simul" -> &Alt;<keycap ->Tab</keycap -></keycombo -> or <keycombo action="simul" -> &Ctrl;<keycap ->Tab</keycap -></keycombo ->. </para> - -<para ->Switching applications using <keycombo action="simul" ->&Alt; <keycap ->Tab</keycap -></keycombo ->, &ie; holding down &Alt; while repeatedly pressing the <keycap ->Tab</keycap -> key, can take place in &kde; mode or in <acronym ->CDE</acronym -> mode: in &kde; mode you will see a box in the middle of the screen showing you the currently selected application while you are still holding down the &Alt; key. In <acronym ->CDE</acronym -> mode focus goes to each new window as it's selected. </para> - -<para ->Next there is an option where you can choose to <guilabel ->Traverse windows on all desktops</guilabel -> or not. With this enabled, switching windows with <keycombo action="simul" -> &Alt;<keycap ->Tab</keycap -></keycombo -> will show all windows, on all desktops, and take you to the appropriate desktop for the window you select. With it disabled, only windows on your current desktop are selectable with <keycombo action="simul" -> &Alt;<keycap ->Tab</keycap -></keycombo ->, and you must use <keycombo action="simul" ->&Ctrl;<keycap ->Tab</keycap -></keycombo -> to switch to other desktops yourself. </para> - -<para ->If you check the <guilabel ->Desktop navigation wraps around</guilabel -> checkbox, then after you reach the <quote ->last</quote -> desktop, pressing <keycap ->Tab</keycap -> again will select the first desktop again.</para> - -<para ->Many people name their virtual desktops according to their purpose or some other naming scheme. You may find it convenient to select the <guilabel ->Popup desktop name on desktop switch</guilabel ->, so you can quickly tell that you've switched to the right one.</para> +<title><guilabel>Navigation</guilabel></title> + +<para>In the <guilabel>Navigation</guilabel> frame you can configure the way switching between applications or desktops using <keycombo action="simul"> &Alt;<keycap>Tab</keycap></keycombo> or <keycombo action="simul"> &Ctrl;<keycap>Tab</keycap></keycombo>. </para> + +<para>Switching applications using <keycombo action="simul">&Alt; <keycap>Tab</keycap></keycombo>, &ie; holding down &Alt; while repeatedly pressing the <keycap>Tab</keycap> key, can take place in &kde; mode or in <acronym>CDE</acronym> mode: in &kde; mode you will see a box in the middle of the screen showing you the currently selected application while you are still holding down the &Alt; key. In <acronym>CDE</acronym> mode focus goes to each new window as it's selected. </para> + +<para>Next there is an option where you can choose to <guilabel>Traverse windows on all desktops</guilabel> or not. With this enabled, switching windows with <keycombo action="simul"> &Alt;<keycap>Tab</keycap></keycombo> will show all windows, on all desktops, and take you to the appropriate desktop for the window you select. With it disabled, only windows on your current desktop are selectable with <keycombo action="simul"> &Alt;<keycap>Tab</keycap></keycombo>, and you must use <keycombo action="simul">&Ctrl;<keycap>Tab</keycap></keycombo> to switch to other desktops yourself. </para> + +<para>If you check the <guilabel>Desktop navigation wraps around</guilabel> checkbox, then after you reach the <quote>last</quote> desktop, pressing <keycap>Tab</keycap> again will select the first desktop again.</para> + +<para>Many people name their virtual desktops according to their purpose or some other naming scheme. You may find it convenient to select the <guilabel>Popup desktop name on desktop switch</guilabel>, so you can quickly tell that you've switched to the right one.</para> </sect3> </sect2> <sect2 id="action-actions"> -<title ->Actions</title> +<title>Actions</title> -<para ->In this panel you can configure what happens to windows when a mouse is clicked on them. This panel is divided into four sections. </para> +<para>In this panel you can configure what happens to windows when a mouse is clicked on them. This panel is divided into four sections. </para> <sect3 id="action-actions-sec1"> -<title -><guilabel ->Titlebar double-click</guilabel -></title> - -<para ->This section provides a single dropdown box. You can select either <guilabel ->Shade</guilabel ->, several variations of <guilabel ->Maximise</guilabel -> or <guilabel ->Lower</guilabel ->. </para> - -<para ->Selecting <guilabel ->Maximise</guilabel -> causes &kde; to maximise the window whenever you doubleclick on the titlebar. You can further choose to maximise windows only horizontally or only vertically.</para> - -<para -><guilabel ->Shade</guilabel ->, on the other hand, causes the window to be reduced to simply the titlebar. Double clicking on the titlebar again, restores the window to its normal size. </para> +<title><guilabel>Titlebar double-click</guilabel></title> + +<para>This section provides a single dropdown box. You can select either <guilabel>Shade</guilabel>, several variations of <guilabel>Maximise</guilabel> or <guilabel>Lower</guilabel>. </para> + +<para>Selecting <guilabel>Maximise</guilabel> causes &kde; to maximise the window whenever you doubleclick on the titlebar. You can further choose to maximise windows only horizontally or only vertically.</para> + +<para><guilabel>Shade</guilabel>, on the other hand, causes the window to be reduced to simply the titlebar. Double clicking on the titlebar again, restores the window to its normal size. </para> <tip> -<para ->You can have windows automatically unshade when you simply place the mouse over their shaded titlebar. Just check the <guilabel ->Enable Hover</guilabel -> check box in the <guilabel ->Advanced</guilabel -> tab of this module. This is a great way to reclaim desktop space when you're cutting and pasting between a lot of windows, for example. </para> +<para>You can have windows automatically unshade when you simply place the mouse over their shaded titlebar. Just check the <guilabel>Enable Hover</guilabel> check box in the <guilabel>Advanced</guilabel> tab of this module. This is a great way to reclaim desktop space when you're cutting and pasting between a lot of windows, for example. </para> </tip> </sect3> <sect3 id="action-actions-sec2"> -<title -><guilabel ->Titlebar & Frame</guilabel -></title> +<title><guilabel>Titlebar & Frame</guilabel></title> -<para ->This section allows you to determine what happens when you single click on the titlebar or frame of a window. Notice that you can have different actions associated with the same click depending on whether the window is active or not. </para> +<para>This section allows you to determine what happens when you single click on the titlebar or frame of a window. Notice that you can have different actions associated with the same click depending on whether the window is active or not. </para> -<para ->For each combination of mousebuttons, modifiers, Active and Inactive, you can select the most appropriate choice. The actions are as follows: </para> +<para>For each combination of mousebuttons, modifiers, Active and Inactive, you can select the most appropriate choice. The actions are as follows: </para> <variablelist> <varlistentry> -<term -><guilabel ->Activate</guilabel -></term> +<term><guilabel>Activate</guilabel></term> <listitem> -<para ->Make this window active. </para> +<para>Make this window active. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Lower</guilabel -></term> +<term><guilabel>Lower</guilabel></term> <listitem> -<para ->Will move this window to the bottom of the display. This will get the window out of the way. </para> +<para>Will move this window to the bottom of the display. This will get the window out of the way. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Nothing</guilabel -></term> +<term><guilabel>Nothing</guilabel></term> <listitem> -<para ->Just like it says. Nothing happens. </para> +<para>Just like it says. Nothing happens. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Operations Menu</guilabel -></term> +<term><guilabel>Operations Menu</guilabel></term> <listitem> -<para ->Will bring up a small submenu, where you can choose window related commands (&ie; Maximise, Minimise, Close, &etc;). </para> +<para>Will bring up a small submenu, where you can choose window related commands (&ie; Maximise, Minimise, Close, &etc;). </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Raise</guilabel -></term> +<term><guilabel>Raise</guilabel></term> <listitem> -<para ->Will bring the window to the top of the display. All other windows which overlap with this one, will be hidden <quote ->below</quote -> it. </para> +<para>Will bring the window to the top of the display. All other windows which overlap with this one, will be hidden <quote>below</quote> it. </para> </listitem> </varlistentry> <varlistentry> -<term ->Toggle Raise and Lower</term> +<term>Toggle Raise and Lower</term> <listitem> -<para ->This will raise windows which are not on top, and lower windows which are already on top. </para> +<para>This will raise windows which are not on top, and lower windows which are already on top. </para> </listitem> </varlistentry> </variablelist> </sect3> <sect3 id="action-actions-sec3"> -<title -><guilabel ->Inactive Inner Window</guilabel -></title> +<title><guilabel>Inactive Inner Window</guilabel></title> -<para ->This part of the module, allows you to configure what happens when you click on an inactive window, with any of the three mouse buttons. </para> +<para>This part of the module, allows you to configure what happens when you click on an inactive window, with any of the three mouse buttons. </para> -<para ->Your choices are as follows: </para> +<para>Your choices are as follows: </para> <variablelist> <varlistentry> -<term -><guilabel ->Activate, Raise and pass click</guilabel -></term> +<term><guilabel>Activate, Raise and pass click</guilabel></term> <listitem> -<para ->This makes the clicked window active, raises it to the top of the display, and passes a mouse click to the application within the window. </para> +<para>This makes the clicked window active, raises it to the top of the display, and passes a mouse click to the application within the window. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Activate and pass click</guilabel -></term> +<term><guilabel>Activate and pass click</guilabel></term> <listitem> -<para ->This makes the clicked window active and passes a mouse click to the application within the window. </para> +<para>This makes the clicked window active and passes a mouse click to the application within the window. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Activate</guilabel -></term> +<term><guilabel>Activate</guilabel></term> <listitem> -<para ->This simply makes the clicked window active. The mouse click is not passed on to the application within the window. </para> +<para>This simply makes the clicked window active. The mouse click is not passed on to the application within the window. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Activate and Raise</guilabel -></term> +<term><guilabel>Activate and Raise</guilabel></term> <listitem> -<para ->This makes the clicked window active and raises the window to the top of the display. The mouse click is not passed on to the application within the window. </para> +<para>This makes the clicked window active and raises the window to the top of the display. The mouse click is not passed on to the application within the window. </para> </listitem> </varlistentry> </variablelist> @@ -460,92 +224,54 @@ </sect3> <sect3 id="action-actions-sec4"> -<title -><guilabel ->Inner Window, titlebar and frame</guilabel -></title> - -<para ->This bottom section, allows you to configure additional actions, when a modifier key (by default &Alt;) is pressed, and a mouse click is made on a window.</para> - -<para ->Once again, you can select different actions for <mousebutton ->Left</mousebutton ->, <mousebutton ->Middle</mousebutton -> and <mousebutton ->Right</mousebutton -> button clicks. </para> - -<para ->Your choices are:</para> +<title><guilabel>Inner Window, titlebar and frame</guilabel></title> + +<para>This bottom section, allows you to configure additional actions, when a modifier key (by default &Alt;) is pressed, and a mouse click is made on a window.</para> + +<para>Once again, you can select different actions for <mousebutton>Left</mousebutton>, <mousebutton>Middle</mousebutton> and <mousebutton>Right</mousebutton> button clicks. </para> + +<para>Your choices are:</para> <variablelist> <varlistentry> -<term -><guilabel ->Lower</guilabel -></term> +<term><guilabel>Lower</guilabel></term> <listitem> -<para ->Will move this window to the bottom of the display. This will get the window out of the way. </para> +<para>Will move this window to the bottom of the display. This will get the window out of the way. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Move</guilabel -></term> +<term><guilabel>Move</guilabel></term> <listitem> -<para ->Allows you to drag the selected window around the desktop. </para> +<para>Allows you to drag the selected window around the desktop. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Nothing</guilabel -></term> +<term><guilabel>Nothing</guilabel></term> <listitem> -<para ->Just like it says. Nothing happens. </para> +<para>Just like it says. Nothing happens. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Raise</guilabel -></term> +<term><guilabel>Raise</guilabel></term> <listitem> -<para ->Will bring the window to the top of the display. All other windows which overlap with this one, will be hidden <quote ->below</quote -> it. </para> +<para>Will bring the window to the top of the display. All other windows which overlap with this one, will be hidden <quote>below</quote> it. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Resize</guilabel -></term> +<term><guilabel>Resize</guilabel></term> <listitem> -<para ->Allows you to change the size of the selected window. </para> +<para>Allows you to change the size of the selected window. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Toggle Raise and Lower</guilabel -></term> +<term><guilabel>Toggle Raise and Lower</guilabel></term> <listitem> -<para ->This will raise windows which are not on top, and lower windows which are already on top. </para> +<para>This will raise windows which are not on top, and lower windows which are already on top. </para> </listitem> </varlistentry> </variablelist> @@ -555,102 +281,55 @@ </sect2> <sect2 id="action-moving"> -<title -><guilabel ->Moving</guilabel -></title> +<title><guilabel>Moving</guilabel></title> <sect3> -<title -><guilabel ->Windows</guilabel -></title> +<title><guilabel>Windows</guilabel></title> -<para ->The options here determine how windows appear on screen when you are moving them. Most of these options exact a price in performance, so if you want to streamline your desktop, you should turn them off. However, if you have a fast computer, they may make your day a little more pleasant, so leave them on.</para> +<para>The options here determine how windows appear on screen when you are moving them. Most of these options exact a price in performance, so if you want to streamline your desktop, you should turn them off. However, if you have a fast computer, they may make your day a little more pleasant, so leave them on.</para> <variablelist> <varlistentry> -<term -><guilabel ->Display content in moving windows</guilabel -></term> +<term><guilabel>Display content in moving windows</guilabel></term> <listitem> -<para ->Enable this option if you want a window's content to be fully shown while moving it, instead of just showing a window <quote ->skeleton</quote ->. The result may not be satisfying on slow computers without graphic acceleration.</para> +<para>Enable this option if you want a window's content to be fully shown while moving it, instead of just showing a window <quote>skeleton</quote>. The result may not be satisfying on slow computers without graphic acceleration.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Display content in resizing windows</guilabel -></term> +<term><guilabel>Display content in resizing windows</guilabel></term> <listitem> -<para ->Enable this option if you want a window's content to be shown while resizing it, instead of just showing a window <quote ->skeleton</quote ->. The result, again, may not be satisfying on slower computers.</para> +<para>Enable this option if you want a window's content to be shown while resizing it, instead of just showing a window <quote>skeleton</quote>. The result, again, may not be satisfying on slower computers.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Display window geometry when moving or resizing</guilabel -></term> +<term><guilabel>Display window geometry when moving or resizing</guilabel></term> <listitem> -<para ->Enable this option if you want a popup tooltip to tell you the size in pixels of a window as you resize it.</para -></listitem> +<para>Enable this option if you want a popup tooltip to tell you the size in pixels of a window as you resize it.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Animate minimise and restore</guilabel -></term> +<term><guilabel>Animate minimise and restore</guilabel></term> <listitem> -<para ->Enable this option if you want an animation shown when windows are minimised or restored.</para> -<para ->With the slider, you can set the speed of the animation.</para> +<para>Enable this option if you want an animation shown when windows are minimised or restored.</para> +<para>With the slider, you can set the speed of the animation.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Allow moving and resizing of maximised windows</guilabel -></term> +<term><guilabel>Allow moving and resizing of maximised windows</guilabel></term> <listitem> -<para ->When enabled, this feature activates the border of maximised windows, and allows you to move or resize them just as you can normal windows.</para> +<para>When enabled, this feature activates the border of maximised windows, and allows you to move or resize them just as you can normal windows.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Placement:</guilabel -></term> +<term><guilabel>Placement:</guilabel></term> <listitem> -<para ->The placement policy determines where a new window will appear on the desktop. <guilabel ->Smart</guilabel -> will try to achieve a minimum overlap of windows, <guilabel ->Cascade</guilabel -> will cascade the windows, and <guilabel ->Random</guilabel -> will use a random position. <guilabel ->Centred</guilabel -> will open all new windows in the centre of the screen, and <guilabel ->Zero-Cornered</guilabel -> will open all windows with their top left corner in the top left corner of the screen.</para> +<para>The placement policy determines where a new window will appear on the desktop. <guilabel>Smart</guilabel> will try to achieve a minimum overlap of windows, <guilabel>Cascade</guilabel> will cascade the windows, and <guilabel>Random</guilabel> will use a random position. <guilabel>Centred</guilabel> will open all new windows in the centre of the screen, and <guilabel>Zero-Cornered</guilabel> will open all windows with their top left corner in the top left corner of the screen.</para> </listitem> </varlistentry> @@ -660,50 +339,32 @@ </sect3> <sect3> -<title -><guilabel ->Snap Zones</guilabel -></title> +<title><guilabel>Snap Zones</guilabel></title> -<para ->The rest of this page allows you to configure the <guilabel ->Snap Zones</guilabel ->. These are like a magnetic field along the side of the desktop and each window, which will make windows snap alongside when moved near.</para> +<para>The rest of this page allows you to configure the <guilabel>Snap Zones</guilabel>. These are like a magnetic field along the side of the desktop and each window, which will make windows snap alongside when moved near.</para> <variablelist> <varlistentry> -<term -><guilabel ->Border snap zone:</guilabel -></term> +<term><guilabel>Border snap zone:</guilabel></term> <listitem> -<para ->Here you can set the snap zone for screen borders. Moving a window within the configured distance will make it snap to the edge of the desktop.</para> +<para>Here you can set the snap zone for screen borders. Moving a window within the configured distance will make it snap to the edge of the desktop.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Window snap zone:</guilabel -></term> +<term><guilabel>Window snap zone:</guilabel></term> <listitem> -<para ->Here you can set the snap zone for windows. As with screen borders, moving a window near to another will make it snap to the edge as if the windows were magnetised.</para> +<para>Here you can set the snap zone for windows. As with screen borders, moving a window near to another will make it snap to the edge as if the windows were magnetised.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Snap windows only when overlapping</guilabel -></term> +<term><guilabel>Snap windows only when overlapping</guilabel></term> <listitem> -<para ->If checked, windows will not snap together if they are only near each other, they must be overlapping, by the configured amount or less.</para> +<para>If checked, windows will not snap together if they are only near each other, they must be overlapping, by the configured amount or less.</para> </listitem> </varlistentry> </variablelist> @@ -712,54 +373,31 @@ </sect2> <sect2 id="action-advanced"> -<title ->Advanced</title> +<title>Advanced</title> -<para ->In the <guilabel ->Advanced</guilabel -> panel you can do more advanced fine tuning to the window behaviour. </para> +<para>In the <guilabel>Advanced</guilabel> panel you can do more advanced fine tuning to the window behaviour. </para> <variablelist> -<title ->Shading</title> +<title>Shading</title> <varlistentry> -<term -><guilabel ->Animate</guilabel -></term> +<term><guilabel>Animate</guilabel></term> <listitem> -<para ->If this option is enabled, shading, or rolling up a window until just the title bar is shown, will be animated.</para> +<para>If this option is enabled, shading, or rolling up a window until just the title bar is shown, will be animated.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Enable hover</guilabel -></term> +<term><guilabel>Enable hover</guilabel></term> <listitem> -<para ->If this option is enabled, a shaded window will un-shade automatically when the mouse pointer has been over the title bar for some time. Use the slider to configure the delay un-shading. </para> +<para>If this option is enabled, a shaded window will un-shade automatically when the mouse pointer has been over the title bar for some time. Use the slider to configure the delay un-shading. </para> </listitem> </varlistentry> </variablelist> -<para ->Finally, you can configure <guilabel ->Active Desktop Borders</guilabel ->. If this is enabled, moving the mouse to a screen border will change your desktop. This is useful if you want to drag windows from one desktop to another.</para> - -<para ->You can set this option to <guilabel ->Disabled</guilabel ->, which is the default, to <guilabel ->Only when moving windows</guilabel ->, or to <guilabel ->Always enabled</guilabel -> in which case just pushing your mouse against the side of the screen will switch you to a new desktop.</para> +<para>Finally, you can configure <guilabel>Active Desktop Borders</guilabel>. If this is enabled, moving the mouse to a screen border will change your desktop. This is useful if you want to drag windows from one desktop to another.</para> + +<para>You can set this option to <guilabel>Disabled</guilabel>, which is the default, to <guilabel>Only when moving windows</guilabel>, or to <guilabel>Always enabled</guilabel> in which case just pushing your mouse against the side of the screen will switch you to a new desktop.</para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kfind/index.docbook b/tde-i18n-en_GB/docs/tdebase/kfind/index.docbook index 85fe5d4a78c..91682d60755 100644 --- a/tde-i18n-en_GB/docs/tdebase/kfind/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kfind/index.docbook @@ -4,241 +4,113 @@ <!ENTITY kappname "&kfind;"> <!ENTITY package "tdebase"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -> + <!ENTITY % British-English "INCLUDE"> ]> <book lang="&language;"> <bookinfo> -<title ->The &kfind; Handbook</title> +<title>The &kfind; Handbook</title> <authorgroup> -<author ->&Dirk.Doerflinger; &Dirk.Doerflinger.mail;</author> - -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Dirk.Doerflinger; &Dirk.Doerflinger.mail;</author> + +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->2001</year> -<holder ->&Dirk.Doerflinger;</holder> +<year>2001</year> +<holder>&Dirk.Doerflinger;</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2004-04-11</date> -<releaseinfo ->1.20.01</releaseinfo> +<date>2004-04-11</date> +<releaseinfo>1.20.01</releaseinfo> <abstract> -<para ->&kfind; is &kde;'s file find utility. </para> +<para>&kfind; is &kde;'s file find utility. </para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->tdeutils</keyword> -<keyword ->kfind</keyword> -<keyword ->find</keyword> -<keyword ->search</keyword> +<keyword>KDE</keyword> +<keyword>tdeutils</keyword> +<keyword>kfind</keyword> +<keyword>find</keyword> +<keyword>search</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->&kfind; is the &kde; file find utility. </para> +<para>&kfind; is the &kde; file find utility. </para> <sect1 id="starting"> -<title ->Launching &kfind;</title> +<title>Launching &kfind;</title> -<para ->The Find Files tool is a useful method of searching for specific files on your computer, or for searching for files that match a pattern. An example of this could include searching for files of a particular type or with certain letters in the filename. You can load this utility by clicking on <guimenuitem ->Find Files</guimenuitem ->. This will launch &kfind;. </para> +<para>The Find Files tool is a useful method of searching for specific files on your computer, or for searching for files that match a pattern. An example of this could include searching for files of a particular type or with certain letters in the filename. You can load this utility by clicking on <guimenuitem>Find Files</guimenuitem>. This will launch &kfind;. </para> </sect1> </chapter> <chapter id="kfind"> -<title ->Finding Files</title> +<title>Finding Files</title> <sect1 id="name-tab"> -<title ->The Name/Location Tab</title> - -<para ->When starting &kfind;, you will see a quite simple window. Type in the name of the file you are searching in the textbox labelled <guilabel ->Named:</guilabel ->. Choose a folder where you want to search by typing it in the field <guilabel ->Look in:</guilabel -> or by clicking <guibutton ->Browse...</guibutton -> and press <keycap ->Enter</keycap -> or click <guibutton ->Find</guibutton ->. If <guilabel ->Include subfolders</guilabel -> is checked all subfolders starting from your chosen folder will be searched too. The results will be displayed in the box below. </para> - -<para ->You can use the following wildcards: </para> +<title>The Name/Location Tab</title> + +<para>When starting &kfind;, you will see a quite simple window. Type in the name of the file you are searching in the textbox labelled <guilabel>Named:</guilabel>. Choose a folder where you want to search by typing it in the field <guilabel>Look in:</guilabel> or by clicking <guibutton>Browse...</guibutton> and press <keycap>Enter</keycap> or click <guibutton>Find</guibutton>. If <guilabel>Include subfolders</guilabel> is checked all subfolders starting from your chosen folder will be searched too. The results will be displayed in the box below. </para> + +<para>You can use the following wildcards: </para> <variablelist> <varlistentry> -<term ->The Asterisk <quote -><keycap ->*</keycap -></quote -></term> +<term>The Asterisk <quote><keycap>*</keycap></quote></term> <listitem> -<para ->The asterisk stands for any number of missing characters (even zero), that means ⪚ searching for <userinput ->marc*</userinput -> may find the files <filename ->marc</filename ->, <filename ->marc.png</filename -> and <filename -> marc_must_not_read_this.kwd</filename ->. <userinput ->mar*.kwd</userinput -> may find <filename ->marketplace.kwd</filename -> and <filename ->marc_must_not_read_this.kwd</filename ->. </para> +<para>The asterisk stands for any number of missing characters (even zero), that means ⪚ searching for <userinput>marc*</userinput> may find the files <filename>marc</filename>, <filename>marc.png</filename> and <filename> marc_must_not_read_this.kwd</filename>. <userinput>mar*.kwd</userinput> may find <filename>marketplace.kwd</filename> and <filename>marc_must_not_read_this.kwd</filename>. </para> </listitem> </varlistentry> <varlistentry> -<term ->The Question Mark <quote -><keycap ->?</keycap -></quote -></term> +<term>The Question Mark <quote><keycap>?</keycap></quote></term> <listitem> -<para ->In contrast to the asterisk, the question mark stands for exactly one character, so <userinput ->mar?</userinput -> will find <filename ->marc</filename ->, but <userinput ->marc?</userinput -> will not find anything, as our files are called <filename ->marc</filename -> and <filename ->marc.png</filename ->. You can put as many question marks in the term as you want, it will find exactly that number of characters. </para> +<para>In contrast to the asterisk, the question mark stands for exactly one character, so <userinput>mar?</userinput> will find <filename>marc</filename>, but <userinput>marc?</userinput> will not find anything, as our files are called <filename>marc</filename> and <filename>marc.png</filename>. You can put as many question marks in the term as you want, it will find exactly that number of characters. </para> </listitem> </varlistentry> </variablelist> -<para ->Of course you can combine those two wildcard symbols in a search term. </para> +<para>Of course you can combine those two wildcard symbols in a search term. </para> </sect1> <sect1 id="kfind-date-range"> -<title ->The Contents Tab</title> +<title>The Contents Tab</title> <variablelist> <varlistentry> -<term -><guilabel ->File type</guilabel -></term> +<term><guilabel>File type</guilabel></term> <listitem> -<para ->Here you can specify the type of file you are searching for. </para> +<para>Here you can specify the type of file you are searching for. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Containing text</guilabel -></term> +<term><guilabel>Containing text</guilabel></term> <listitem> -<para ->Type in the word or phrase the files you are searching for must contain. Note: If you do this in a large folder or checked <guilabel ->Include subfolders</guilabel -> in the <guilabel ->Name/Location</guilabel -> tab, this may take a long time. </para> +<para>Type in the word or phrase the files you are searching for must contain. Note: If you do this in a large folder or checked <guilabel>Include subfolders</guilabel> in the <guilabel>Name/Location</guilabel> tab, this may take a long time. </para> <note> -<para ->This option will <emphasis ->not</emphasis -> work for all files listed under <guilabel ->File type</guilabel ->. Only the following file types are supported: <itemizedlist> -<listitem -><para ->Text files, ⪚ source code and <filename ->README</filename -> files</para -></listitem> -<listitem -><para ->KWord >= 1.2</para -></listitem> -<listitem -><para ->KPresenter >= 1.2</para -></listitem> -<listitem -><para ->KSpread >= 1.2</para -></listitem> -<listitem -><para ->OpenOffice.org Writer</para -></listitem> -<listitem -><para ->OpenOffice.org Impress</para -></listitem> -<listitem -><para ->OpenOffice.org Calc</para -></listitem> +<para>This option will <emphasis>not</emphasis> work for all files listed under <guilabel>File type</guilabel>. Only the following file types are supported: <itemizedlist> +<listitem><para>Text files, ⪚ source code and <filename>README</filename> files</para></listitem> +<listitem><para>KWord >= 1.2</para></listitem> +<listitem><para>KPresenter >= 1.2</para></listitem> +<listitem><para>KSpread >= 1.2</para></listitem> +<listitem><para>OpenOffice.org Writer</para></listitem> +<listitem><para>OpenOffice.org Impress</para></listitem> +<listitem><para>OpenOffice.org Calc</para></listitem> </itemizedlist> </para> @@ -248,37 +120,17 @@ </varlistentry> <varlistentry> -<term -><guilabel ->Case sensitive</guilabel -></term> +<term><guilabel>Case sensitive</guilabel></term> <listitem> -<para ->If you enable this option, &kfind; will only find files with the exact case matching, ⪚ <userinput ->MARC</userinput -> will only match <quote ->MARC</quote ->, not <quote ->Marc</quote ->. </para> +<para>If you enable this option, &kfind; will only find files with the exact case matching, ⪚ <userinput>MARC</userinput> will only match <quote>MARC</quote>, not <quote>Marc</quote>. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Regular expression</guilabel -></term> -<listitem -><para ->If you have installed the &kregexpeditor; tool from the tdeutils package, you will have this additional option. Enabling it will allow you to search for a <firstterm ->regexp</firstterm -> or regular expression. A regexp is a way to specify conditions for your search, and they can be very complex, and equally they can be very powerful. If you are unfamiliar with regular expressions, you can choose <guilabel ->Edit Regular Expression</guilabel -> to open &kregexpeditor;. This tool allows you to construct your set of conditions graphically, and then generates the expression for you.</para> - -<para ->&kregexpeditor; is a very useful tool, and can be used from within many &kde; applications other than &kfind;. You can find more information from within its own help file.</para> +<term><guilabel>Regular expression</guilabel></term> +<listitem><para>If you have installed the &kregexpeditor; tool from the tdeutils package, you will have this additional option. Enabling it will allow you to search for a <firstterm>regexp</firstterm> or regular expression. A regexp is a way to specify conditions for your search, and they can be very complex, and equally they can be very powerful. If you are unfamiliar with regular expressions, you can choose <guilabel>Edit Regular Expression</guilabel> to open &kregexpeditor;. This tool allows you to construct your set of conditions graphically, and then generates the expression for you.</para> + +<para>&kregexpeditor; is a very useful tool, and can be used from within many &kde; applications other than &kfind;. You can find more information from within its own help file.</para> </listitem> </varlistentry> @@ -289,44 +141,30 @@ </sect1> <sect1 id="kfind-advanced"> -<title ->The Properties Tab</title> +<title>The Properties Tab</title> -<para ->Here you can refine your search. These are the special refinements you can choose: </para> +<para>Here you can refine your search. These are the special refinements you can choose: </para> <variablelist> <varlistentry> -<term -><guilabel ->Find all files created or modified</guilabel -></term> +<term><guilabel>Find all files created or modified</guilabel></term> <listitem> -<para ->Here you can either enter two dates, between which the files were created or modified, or specify a time period. </para> +<para>Here you can either enter two dates, between which the files were created or modified, or specify a time period. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->File size is</guilabel -></term> +<term><guilabel>File size is</guilabel></term> <listitem> -<para ->Here you can specify if the file has to be at least or as most as big as the size you entered in the following box. </para> +<para>Here you can specify if the file has to be at least or as most as big as the size you entered in the following box. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Files owned by user, Files owned by group</guilabel -></term> +<term><guilabel>Files owned by user, Files owned by group</guilabel></term> <listitem> -<para ->Here you can specify user and group names. </para> +<para>Here you can specify user and group names. </para> </listitem> </varlistentry> @@ -338,120 +176,77 @@ <chapter id="credits"> -<title ->Credits and Licence</title> +<title>Credits and Licence</title> -<para ->&kfind; </para> +<para>&kfind; </para> -<para ->Program copyright: </para> +<para>Program copyright: </para> <itemizedlist> -<title ->Developers</title> +<title>Developers</title> <listitem> -<para ->Martin Hartig</para> +<para>Martin Hartig</para> </listitem> <listitem> -<para ->Stephan Kulow <email ->coolo@kde.org</email -></para> +<para>Stephan Kulow <email>coolo@kde.org</email></para> </listitem> <listitem> -<para ->Mario Weilguni <email ->mweilguni@sime.com</email -></para> +<para>Mario Weilguni <email>mweilguni@sime.com</email></para> </listitem> <listitem> -<para ->Alex Zepeda <email ->jazepeda@pacbell.net</email -></para> +<para>Alex Zepeda <email>jazepeda@pacbell.net</email></para> </listitem> <listitem> -<para ->Miroslav FlÃdr <email ->flidr@kky.zcu.cz</email -></para> +<para>Miroslav FlÃdr <email>flidr@kky.zcu.cz</email></para> </listitem> <listitem> -<para ->Harri Porten <email ->porten@kde.org</email -></para> +<para>Harri Porten <email>porten@kde.org</email></para> </listitem> <listitem> -<para ->Dima Rogozin <email ->dima@mercury.co.il</email -></para> +<para>Dima Rogozin <email>dima@mercury.co.il</email></para> </listitem> <listitem> -<para ->Carsten Pfeiffer <email ->pfeiffer@kde.org</email -></para> +<para>Carsten Pfeiffer <email>pfeiffer@kde.org</email></para> </listitem> <listitem> -<para ->Hans Petter Bieker <email ->bieker@kde.org</email -></para> +<para>Hans Petter Bieker <email>bieker@kde.org</email></para> </listitem> <listitem> -<para ->Waldo Bastian <email ->bastian@kde.org</email -></para> +<para>Waldo Bastian <email>bastian@kde.org</email></para> </listitem> </itemizedlist> -<para ->Documentation copyright 2001 &Dirk.Doerflinger; &Dirk.Doerflinger.mail;</para -> +<para>Documentation copyright 2001 &Dirk.Doerflinger; &Dirk.Doerflinger.mail;</para> -<para ->Conversion to British English: John Knight <email ->anarchist_tomato@herzeleid.net</email -></para -> +<para>Conversion to British English: John Knight <email>anarchist_tomato@herzeleid.net</email></para> &underFDL; &underBSDLicense; </chapter> <appendix id="installation"> -<title ->Installation</title> +<title>Installation</title> <sect1 id="getting-kfind"> -<title ->How to obtain &kfind;</title> +<title>How to obtain &kfind;</title> &install.intro.documentation; </sect1> <sect1 id="requirements"> -<title ->Requirements</title> +<title>Requirements</title> -<para ->In order to successfully use &kfind;, you need &kde; 3.x. </para> +<para>In order to successfully use &kfind;, you need &kde; 3.x. </para> </sect1> <sect1 id="compilation"> -<title ->Compilation and Installation</title> +<title>Compilation and Installation</title> &install.compile.documentation; </sect1> </appendix> diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/contact.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/contact.docbook index c164370fb32..c4cdd5b35b1 100644 --- a/tde-i18n-en_GB/docs/tdebase/khelpcenter/contact.docbook +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/contact.docbook @@ -1,100 +1,48 @@ <chapter id="contact-the-kde-team"> -<chapterinfo -><date ->2002-01-18</date -> <releaseinfo ->3.00.00</releaseinfo -> </chapterinfo> -<title ->Contact the &kde; team</title> +<chapterinfo><date>2002-01-18</date> <releaseinfo>3.00.00</releaseinfo> </chapterinfo> +<title>Contact the &kde; team</title> <anchor id="contact"/> <sect1 id="contact-mailinglists"> -<title ->Mailing lists</title> +<title>Mailing lists</title> -<para ->&kde; has several mailing lists up. See below for some of the most useful. Older articles can be found in the <ulink url="http://lists.kde.org" ->mailing list archive</ulink ->.</para> +<para>&kde; has several mailing lists up. See below for some of the most useful. Older articles can be found in the <ulink url="http://lists.kde.org">mailing list archive</ulink>.</para> <variablelist> <varlistentry> -<term -><ulink url="http://mail.kde.org/mailman/listinfo/kde" ->kde</ulink -></term> -<listitem -><para ->For general discussion, users helping each other.</para -></listitem> +<term><ulink url="http://mail.kde.org/mailman/listinfo/kde">kde</ulink></term> +<listitem><para>For general discussion, users helping each other.</para></listitem> </varlistentry> <varlistentry> -<term -><ulink url="http://mail.kde.org/mailman/listinfo/kde-announce" ->kde-announce</ulink -></term> -<listitem -><para ->Announcements of new &kde; applications</para -></listitem> +<term><ulink url="http://mail.kde.org/mailman/listinfo/kde-announce">kde-announce</ulink></term> +<listitem><para>Announcements of new &kde; applications</para></listitem> </varlistentry> <varlistentry> -<term -><ulink url="http://mail.kde.org/mailman/listinfo/kde-devel" ->kde-devel</ulink -></term> -<listitem -><para ->For developers.</para -></listitem> +<term><ulink url="http://mail.kde.org/mailman/listinfo/kde-devel">kde-devel</ulink></term> +<listitem><para>For developers.</para></listitem> </varlistentry> <varlistentry> -<term -><ulink url="http://mail.kde.org/mailman/listinfo/kde-artists" ->kde-artists</ulink -></term> -<listitem -><para ->Creating icons and other artwork</para -></listitem> +<term><ulink url="http://mail.kde.org/mailman/listinfo/kde-artists">kde-artists</ulink></term> +<listitem><para>Creating icons and other artwork</para></listitem> </varlistentry> <varlistentry> -<term -><ulink url="http://mail.kde.org/mailman/listinfo/kde-doc-english" ->kde-doc-english</ulink -></term> -<listitem -><para ->For people interested in writing documentation for &kde;.</para -></listitem> +<term><ulink url="http://mail.kde.org/mailman/listinfo/kde-doc-english">kde-doc-english</ulink></term> +<listitem><para>For people interested in writing documentation for &kde;.</para></listitem> </varlistentry> <varlistentry> -<term -><ulink url="http://mail.kde.org/mailman/listinfo/tde-i18n-doc" ->tde-i18n-doc</ulink -></term> -<listitem -><para ->Internationalisation and documentation issues</para -></listitem> +<term><ulink url="http://mail.kde.org/mailman/listinfo/tde-i18n-doc">tde-i18n-doc</ulink></term> +<listitem><para>Internationalisation and documentation issues</para></listitem> </varlistentry> <varlistentry> -<term -><ulink url="http://i18n.kde.org/teams/" ->http://i18n.kde.org/teams/</ulink -></term> -<listitem -><para ->For localised information, which may include user email lists and websites, check the translation teams page at the above &URL;.</para -></listitem> +<term><ulink url="http://i18n.kde.org/teams/">http://i18n.kde.org/teams/</ulink></term> +<listitem><para>For localised information, which may include user email lists and websites, check the translation teams page at the above &URL;.</para></listitem> </varlistentry> </variablelist> @@ -102,117 +50,58 @@ </sect1> <sect1 id="contact-developers"> -<title ->Contacting the &kde; developers</title> +<title>Contacting the &kde; developers</title> -<para ->On this page, you can find links to &kde; related web sites.</para> +<para>On this page, you can find links to &kde; related web sites.</para> -<para ->The K Desktop Environment is developed by a large group of people around the world. Our main communication channel is the Internet. For general questions, you will be best served by asking on the mailing lists mentioned in the <link linkend="contact-mailinglists" ->previous section</link ->, and contact addresses for individual developers can be found in the documentation of their individual application.</para> +<para>The K Desktop Environment is developed by a large group of people around the world. Our main communication channel is the Internet. For general questions, you will be best served by asking on the mailing lists mentioned in the <link linkend="contact-mailinglists">previous section</link>, and contact addresses for individual developers can be found in the documentation of their individual application.</para> -<para ->Please visit our <ulink url="http://www.kde.org/contact/representatives.php" ->Official Representatives</ulink -> page for official enquiries regarding &kde; (⪚ interviews).</para> +<para>Please visit our <ulink url="http://www.kde.org/contact/representatives.php">Official Representatives</ulink> page for official enquiries regarding &kde; (⪚ interviews).</para> -<para ->More information about &kde; is available at &kde-http;.</para> +<para>More information about &kde; is available at &kde-http;.</para> -<para -><anchor id="links"/>Other &kde; websites include:</para> +<para><anchor id="links"/>Other &kde; websites include:</para> <variablelist> <varlistentry> -<term -><ulink url="http://www.kde.org" ->www.kde.org</ulink -></term> -<listitem -><para ->&kde;'s official website</para -></listitem> +<term><ulink url="http://www.kde.org">www.kde.org</ulink></term> +<listitem><para>&kde;'s official website</para></listitem> </varlistentry> <varlistentry> -<term -><ulink url="http://developer.kde.org" ->developer.kde.org</ulink -></term> -<listitem -><para ->The &kde; developers centre</para -></listitem> +<term><ulink url="http://developer.kde.org">developer.kde.org</ulink></term> +<listitem><para>The &kde; developers centre</para></listitem> </varlistentry> <varlistentry> -<term -><ulink url="http://webcvs.kde.org" ->webcvs.kde.org</ulink -></term> -<listitem -><para ->A web interface to the &kde; CVS repository</para -></listitem> +<term><ulink url="http://webcvs.kde.org">webcvs.kde.org</ulink></term> +<listitem><para>A web interface to the &kde; CVS repository</para></listitem> </varlistentry> <varlistentry> -<term -><ulink url="http://i18n.kde.org" ->i18n.kde.org</ulink -></term> -<listitem -><para ->&kde;'s internationalisation and documentation server</para -></listitem> +<term><ulink url="http://i18n.kde.org">i18n.kde.org</ulink></term> +<listitem><para>&kde;'s internationalisation and documentation server</para></listitem> </varlistentry> <varlistentry> -<term -><ulink url="ftp://ftp.kde.org" ->ftp.kde.org</ulink -></term> -<listitem -><para ->The main &kde; &FTP; server. Please have a look at the link below to find a mirror site in your geographic region.</para -></listitem> +<term><ulink url="ftp://ftp.kde.org">ftp.kde.org</ulink></term> +<listitem><para>The main &kde; &FTP; server. Please have a look at the link below to find a mirror site in your geographic region.</para></listitem> </varlistentry> <varlistentry> -<term -><ulink -url="http://www.kde.org/mirrors" ->www.kde.org/mirrors</ulink -></term -> -<listitem -><para ->&kde; web and &FTP; mirror sites</para -></listitem> +<term><ulink +url="http://www.kde.org/mirrors">www.kde.org/mirrors</ulink></term> +<listitem><para>&kde; web and &FTP; mirror sites</para></listitem> </varlistentry> <varlistentry> -<term -><ulink url="http://www.kde-apps.org" ->www.kde-apps.org</ulink -></term> -<listitem -><para ->A directory of &kde; applications.</para -></listitem> +<term><ulink url="http://www.kde-apps.org">www.kde-apps.org</ulink></term> +<listitem><para>A directory of &kde; applications.</para></listitem> </varlistentry> <varlistentry> -<term -><ulink url="http://www.kde-look.org" ->www.kde-look.org</ulink -></term> -<listitem -><para ->&kde; themes, icons, and other items to change the look of your desktop.</para -></listitem> +<term><ulink url="http://www.kde-look.org">www.kde-look.org</ulink></term> +<listitem><para>&kde; themes, icons, and other items to change the look of your desktop.</para></listitem> </varlistentry> </variablelist> diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/help.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/help.docbook index 372573d1e1b..88ff0f7c915 100644 --- a/tde-i18n-en_GB/docs/tdebase/khelpcenter/help.docbook +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/help.docbook @@ -1,183 +1,88 @@ <chapter id="help-system-user-manual"> -<chapterinfo -><date ->2002-02-03</date -> <releaseinfo ->0.08.00</releaseinfo -> </chapterinfo> -<title ->&kde; Help System User Manual</title> +<chapterinfo><date>2002-02-03</date> <releaseinfo>0.08.00</releaseinfo> </chapterinfo> +<title>&kde; Help System User Manual</title> <anchor id="help"/> <sect1 id="help-introduction"> -<title ->&kde; Help System</title> +<title>&kde; Help System</title> -<para ->The &kde; help system is designed to make accessing the common &UNIX; help systems (<application ->man</application -> and <application ->info</application ->) simple, as well as the native &kde; documentation (&XML;). </para> +<para>The &kde; help system is designed to make accessing the common &UNIX; help systems (<application>man</application> and <application>info</application>) simple, as well as the native &kde; documentation (&XML;). </para> -<para ->All base &kde; applications come fully documented, thanks to the efforts of the Documentation team. If you would like to help, please write to the Documentation coordinator, Lauri Watts, at <email ->lauri@kde.org</email -> for information. No experience is required, just enthusiasm and patience. </para> - -<para ->If you would like to help translating &kde; documentation to your native language, the Translation coordinator is Thomas Diehl, <email ->thd@kde.org</email ->, and he would also welcome the help. More information, including the coordinators for each language team, can be found on the <ulink url="http://i18n.kde.org" ->Internationalisation web site</ulink ->, and in the <link linkend="contact" ->Contact</link -> section of this document. </para> +<para>All base &kde; applications come fully documented, thanks to the efforts of the Documentation team. If you would like to help, please write to the Documentation coordinator, Lauri Watts, at <email>lauri@kde.org</email> for information. No experience is required, just enthusiasm and patience. </para> + +<para>If you would like to help translating &kde; documentation to your native language, the Translation coordinator is Thomas Diehl, <email>thd@kde.org</email>, and he would also welcome the help. More information, including the coordinators for each language team, can be found on the <ulink url="http://i18n.kde.org">Internationalisation web site</ulink>, and in the <link linkend="contact">Contact</link> section of this document. </para> <sect2 id="installation"> -<title ->Installation</title> +<title>Installation</title> -<para ->&khelpcenter; is an integral part of the &kde; Base installation, and is installed with every copy of &kde;. It can be found in the tdebase package, and is available from the &kde-ftp;, or will be found in your operating system tdebase package. </para> +<para>&khelpcenter; is an integral part of the &kde; Base installation, and is installed with every copy of &kde;. It can be found in the tdebase package, and is available from the &kde-ftp;, or will be found in your operating system tdebase package. </para> </sect2> </sect1> <sect1 id="invoking-help"> -<title ->Invoking Help</title> - -<para ->&khelpcenter; can be called in several ways: </para> - -<variablelist -> -<varlistentry -> -<term ->From the <guimenu ->Help</guimenu -> menu</term -> -<listitem> -<para ->The most common will probably be from within an application. Choose <menuchoice -><guimenu ->Help</guimenu -> <guimenuitem ->Contents</guimenuitem -></menuchoice -> to open that application's help file, at the contents page. </para> +<title>Invoking Help</title> + +<para>&khelpcenter; can be called in several ways: </para> + +<variablelist> +<varlistentry> +<term>From the <guimenu>Help</guimenu> menu</term> +<listitem> +<para>The most common will probably be from within an application. Choose <menuchoice><guimenu>Help</guimenu> <guimenuitem>Contents</guimenuitem></menuchoice> to open that application's help file, at the contents page. </para> </listitem> </varlistentry> <varlistentry> -<term ->From the <guimenu ->K</guimenu -> menu</term> +<term>From the <guimenu>K</guimenu> menu</term> <listitem> -<para ->Choose the big <guiicon ->K</guiicon -> in your panel, and select <guimenuitem ->Help</guimenuitem -> to open &khelpcenter;, starting at the default welcome page. </para> -</listitem -> +<para>Choose the big <guiicon>K</guiicon> in your panel, and select <guimenuitem>Help</guimenuitem> to open &khelpcenter;, starting at the default welcome page. </para> +</listitem> </varlistentry> <varlistentry> -<term ->From the panel</term> +<term>From the panel</term> <listitem> -<para ->By default, the &kicker; panel contains an icon to call &khelpcenter;. Again, the default welcome page is displayed. </para> -</listitem -> +<para>By default, the &kicker; panel contains an icon to call &khelpcenter;. Again, the default welcome page is displayed. </para> +</listitem> </varlistentry> <varlistentry> -<term ->From the command line</term> +<term>From the command line</term> <listitem> -<para ->&khelpcenter; may be started using a &URL; to display a file. &URL;s have been added for <command ->info</command -> and <command ->man</command -> pages also. You can use them as follows: </para -> +<para>&khelpcenter; may be started using a &URL; to display a file. &URL;s have been added for <command>info</command> and <command>man</command> pages also. You can use them as follows: </para> <variablelist> <varlistentry> -<term ->An application help file</term> -<listitem> -<para -><command ->khelpcenter</command -> <option ->help:/<replaceable ->kedit</replaceable -></option -> </para> -<para ->Opens the &kedit; help file, at the contents page. </para> +<term>An application help file</term> +<listitem> +<para><command>khelpcenter</command> <option>help:/<replaceable>kedit</replaceable></option> </para> +<para>Opens the &kedit; help file, at the contents page. </para> </listitem> </varlistentry> <varlistentry> -<term ->A local &URL;</term> -<listitem -><para -><command ->khelpcenter</command -> <option ->file:/ <replaceable ->usr/local/src/qt/html/index.html</replaceable -></option -> </para> +<term>A local &URL;</term> +<listitem><para><command>khelpcenter</command> <option>file:/ <replaceable>usr/local/src/qt/html/index.html</replaceable></option> </para> </listitem> </varlistentry> <varlistentry> -<term ->A Man page</term> +<term>A Man page</term> <listitem> -<para -><command ->khelpcenter</command -> <option ->man:/<replaceable ->strcpy</replaceable -></option -> </para> +<para><command>khelpcenter</command> <option>man:/<replaceable>strcpy</replaceable></option> </para> </listitem> </varlistentry> <varlistentry> -<term ->An Info page</term> +<term>An Info page</term> <listitem> -<para -><command ->khelpcenter</command -> <option ->info:/<replaceable ->gcc</replaceable -></option -> </para> +<para><command>khelpcenter</command> <option>info:/<replaceable>gcc</replaceable></option> </para> </listitem> </varlistentry> </variablelist> -<para ->Invoking <command ->khelpcenter</command -> with no parameters opens the default welcome page. </para> +<para>Invoking <command>khelpcenter</command> with no parameters opens the default welcome page. </para> </listitem> </varlistentry> @@ -185,200 +90,104 @@ </sect1> <sect1 id="interface-basics"> -<title ->The &khelpcenter; interface</title> - -<para ->The &khelpcenter; interface consists of two panes of information. </para> - -<para ->The toolbar and menus are explained further in <xref linkend="menu-and-toolbar-ref"/>. </para> - -<para ->Documents contain their own navigation tools, enabling you to move either sequentially through a document, using <guilabel ->Next</guilabel ->, <guilabel ->Previous</guilabel ->, and <guilabel ->Home</guilabel -> links, or to move around in a less structured manner, using hyperlinks. </para> - -<para ->Links can take you to other parts of the same document, or to a different document, and you can use the <guiicon ->Back</guiicon -> (Left pointing arrow) or <guiicon ->Forward</guiicon -> (Right pointing arrow) icons on the toolbar to move through the documents you have viewed in this session. </para -> - -<para ->The two panes display the contents of the help system, and the help files themselves, on the left and right respectively. </para> +<title>The &khelpcenter; interface</title> + +<para>The &khelpcenter; interface consists of two panes of information. </para> + +<para>The toolbar and menus are explained further in <xref linkend="menu-and-toolbar-ref"/>. </para> + +<para>Documents contain their own navigation tools, enabling you to move either sequentially through a document, using <guilabel>Next</guilabel>, <guilabel>Previous</guilabel>, and <guilabel>Home</guilabel> links, or to move around in a less structured manner, using hyperlinks. </para> + +<para>Links can take you to other parts of the same document, or to a different document, and you can use the <guiicon>Back</guiicon> (Left pointing arrow) or <guiicon>Forward</guiicon> (Right pointing arrow) icons on the toolbar to move through the documents you have viewed in this session. </para> + +<para>The two panes display the contents of the help system, and the help files themselves, on the left and right respectively. </para> <sect2 id="contents-pane"> -<title ->The <guilabel ->Contents</guilabel -> pane</title> - -<para ->The <guilabel ->Contents</guilabel -> pane in &khelpcenter; is displayed on the left hand side of the window. As you might expect, you can move the splitter bar, to make sure you can comfortably read the contents of either pane. </para -> - -<para ->The <guilabel ->Contents</guilabel -> pane is further divided into two tabs, one containing a <link linkend="contents-menu" ->menu</link -> showing all the help information &khelpcenter; is aware of, and the other contains the &kde; <link linkend="kde-glossary" ->glossary</link -> of terms. </para> +<title>The <guilabel>Contents</guilabel> pane</title> + +<para>The <guilabel>Contents</guilabel> pane in &khelpcenter; is displayed on the left hand side of the window. As you might expect, you can move the splitter bar, to make sure you can comfortably read the contents of either pane. </para> + +<para>The <guilabel>Contents</guilabel> pane is further divided into two tabs, one containing a <link linkend="contents-menu">menu</link> showing all the help information &khelpcenter; is aware of, and the other contains the &kde; <link linkend="kde-glossary">glossary</link> of terms. </para> <sect3 id="contents-menu"> -<title ->The <guilabel ->Contents</guilabel -> Menu</title> +<title>The <guilabel>Contents</guilabel> Menu</title> -<para ->The <guilabel ->Contents</guilabel -> contains the following default entries: </para -> +<para>The <guilabel>Contents</guilabel> contains the following default entries: </para> <variablelist> <varlistentry> -<term -><guilabel ->Introduction</guilabel -></term> -<listitem -><para ->Welcome to &kde; - an introduction to the K Desktop Environment.</para -></listitem> +<term><guilabel>Introduction</guilabel></term> +<listitem><para>Welcome to &kde; - an introduction to the K Desktop Environment.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Introduction to &kde;</guilabel -></term> +<term><guilabel>Introduction to &kde;</guilabel></term> <listitem> -<para ->The &kde; Quickstart guide. Contains a tour of the &kde; Interface and specific help and tips on how to work smarter with &kde;. </para> +<para>The &kde; Quickstart guide. Contains a tour of the &kde; Interface and specific help and tips on how to work smarter with &kde;. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->&kde; User's manual</guilabel -></term> +<term><guilabel>&kde; User's manual</guilabel></term> <listitem> -<para ->The &kde; User's manual is an in-depth exploration of &kde;, including installation, configuration and customisation, and use. </para> -</listitem -> +<para>The &kde; User's manual is an in-depth exploration of &kde;, including installation, configuration and customisation, and use. </para> +</listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Application manuals</guilabel -></term> +<term><guilabel>Application manuals</guilabel></term> <listitem> -<para ->Native &kde; application documentation. All &kde; applications have documentation in &XML; format, which are converted to <acronym ->HTML</acronym -> when you view them. This section lists all the &kde; applications with a brief description and a link to the full application documentation. </para> -<para ->The applications are displayed in a tree structure that echoes the default structure of the <guimenu ->K</guimenu -> menu, making it easy to find the application you are looking for. </para> -</listitem -> +<para>Native &kde; application documentation. All &kde; applications have documentation in &XML; format, which are converted to <acronym>HTML</acronym> when you view them. This section lists all the &kde; applications with a brief description and a link to the full application documentation. </para> +<para>The applications are displayed in a tree structure that echoes the default structure of the <guimenu>K</guimenu> menu, making it easy to find the application you are looking for. </para> +</listitem> </varlistentry> <varlistentry> -<term -><guilabel ->&UNIX; manual pages</guilabel -></term> +<term><guilabel>&UNIX; manual pages</guilabel></term> <listitem> -<para ->&UNIX; man pages are the traditional on-line documentation format for &UNIX; systems. Most programs on your system will have a man page. In addition, man pages exist for programming functions and file formats. </para> -</listitem -> +<para>&UNIX; man pages are the traditional on-line documentation format for &UNIX; systems. Most programs on your system will have a man page. In addition, man pages exist for programming functions and file formats. </para> +</listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Browse info pages</guilabel -></term> +<term><guilabel>Browse info pages</guilabel></term> <listitem> -<para ->TeXinfo documentation is used by many &GNU; applications, including <command ->gcc</command -> (the C/C++ compiler), <command ->emacs</command ->, and many others. </para> +<para>TeXinfo documentation is used by many &GNU; applications, including <command>gcc</command> (the C/C++ compiler), <command>emacs</command>, and many others. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Tutorials</guilabel -></term> +<term><guilabel>Tutorials</guilabel></term> <listitem> -<para ->Short, task based or informational tutorials. </para> +<para>Short, task based or informational tutorials. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->The &kde; FAQ</guilabel -></term> +<term><guilabel>The &kde; FAQ</guilabel></term> <listitem> -<para ->Frequently asked questions about &kde;, and their answers. </para> +<para>Frequently asked questions about &kde;, and their answers. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->&kde; on the web</guilabel -></term> +<term><guilabel>&kde; on the web</guilabel></term> <listitem> -<para ->Links to &kde; on the web, both the official &kde; website, and other useful sites. </para> +<para>Links to &kde; on the web, both the official &kde; website, and other useful sites. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Contact Information</guilabel -></term> +<term><guilabel>Contact Information</guilabel></term> <listitem> -<para ->Information on how to contact &kde; developers, and how to join the &kde; mailing lists. </para> +<para>Information on how to contact &kde; developers, and how to join the &kde; mailing lists. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Supporting &kde;</guilabel -></term> +<term><guilabel>Supporting &kde;</guilabel></term> <listitem> -<para ->How to help, and how to get involved. </para> +<para>How to help, and how to get involved. </para> </listitem> </varlistentry> </variablelist> @@ -386,24 +195,14 @@ </sect3> <!-- <sect3 id="search"> -<title ->The <guilabel ->Search</guilabel -> tab</title> +<title>The <guilabel>Search</guilabel> tab</title> <para> -Searching requires you have the <application ->ht://Dig</application> +Searching requires you have the <application>ht://Dig</application> application installed. Information on installing and configuring the search index is available in the document. Configuration of the search index is performed in the &kcontrol;, by choosing -<menuchoice -><guisubmenu ->Help</guisubmenu -><guimenuitem ->Index</guimenuitem -></menuchoice ->, +<menuchoice><guisubmenu>Help</guisubmenu><guimenuitem>Index</guimenuitem></menuchoice>, and detailed help is available from this module. </para> @@ -415,172 +214,77 @@ up and configured. <para> Searching the help files is fairly intuitive, enter the word(s) you wish to search for in the text box, choose your options (if any), and press -<guibutton ->Search</guibutton ->. The results display in the viewer pane +<guibutton>Search</guibutton>. The results display in the viewer pane to the right. </para> -<para ->The options available are:</para> +<para>The options available are:</para> <variablelist> <varlistentry> -<term -><guilabel ->Method</guilabel -></term> +<term><guilabel>Method</guilabel></term> <listitem> <para> Choose how to search for multiple words. If you choose -<guilabel ->and</guilabel ->, results are returned only if all your search -terms are included in the page. <guilabel ->or</guilabel -> returns results -if <emphasis ->any</emphasis -> of the search terms are found, and -<guilabel ->boolean</guilabel -> lets you search using a combination. -</para -> +<guilabel>and</guilabel>, results are returned only if all your search +terms are included in the page. <guilabel>or</guilabel> returns results +if <emphasis>any</emphasis> of the search terms are found, and +<guilabel>boolean</guilabel> lets you search using a combination. +</para> <para> -Boolean syntax lets you use the operators <literal ->AND</literal ->, -<literal ->OR</literal -> and <literal ->NOT</literal -> to create complex +Boolean syntax lets you use the operators <literal>AND</literal>, +<literal>OR</literal> and <literal>NOT</literal> to create complex searches. Some examples:</para> <variablelist> <varlistentry> -<term -><userinput ->cat and dog</userinput -></term> -<listitem -><para ->Searches for pages which have both the words -<userinput ->cat</userinput -> and <userinput ->dog</userinput -> in them. Pages with -only one or the other will not be returned.</para -></listitem> -</varlistentry> -<varlistentry> -<term -><userinput ->cat not dog</userinput -></term> -<listitem -><para ->Searches for pages with <userinput ->cat</userinput -> in them, but -only returns the ones that don't have the word <userinput ->dog</userinput -> in -them.</para -></listitem> -</varlistentry> -<varlistentry> -<term -><userinput ->cat or (dog not nose)</userinput -></term> -<listitem -><para ->Searches for pages which contain <userinput ->cat</userinput ->, and -for pages which contain <userinput ->dog</userinput -> but don't contain -<userinput ->nose</userinput ->. Pages which contain both -<userinput ->cat</userinput -> and <userinput ->nose</userinput -> would be returned, -pages containing all three words would not.</para -></listitem -> +<term><userinput>cat and dog</userinput></term> +<listitem><para>Searches for pages which have both the words +<userinput>cat</userinput> and <userinput>dog</userinput> in them. Pages with +only one or the other will not be returned.</para></listitem> +</varlistentry> +<varlistentry> +<term><userinput>cat not dog</userinput></term> +<listitem><para>Searches for pages with <userinput>cat</userinput> in them, but +only returns the ones that don't have the word <userinput>dog</userinput> in +them.</para></listitem> +</varlistentry> +<varlistentry> +<term><userinput>cat or (dog not nose)</userinput></term> +<listitem><para>Searches for pages which contain <userinput>cat</userinput>, and +for pages which contain <userinput>dog</userinput> but don't contain +<userinput>nose</userinput>. Pages which contain both +<userinput>cat</userinput> and <userinput>nose</userinput> would be returned, +pages containing all three words would not.</para></listitem> </varlistentry> </variablelist> -<para ->If your searches are not returning the results you expect, check +<para>If your searches are not returning the results you expect, check carefully you haven't excluded the wrong search term with an errand -<literal ->NOT</literal -> or a stray brace.</para -></listitem> -</varlistentry> -<varlistentry> -<term -><guilabel ->Max. results</guilabel -></term> -<listitem -><para ->Determines the maximum number of results returned from your -search.</para -></listitem> -</varlistentry> -<varlistentry> -<term -><guilabel ->Format</guilabel -></term> -<listitem -><para ->Decide if you want just a short link to the page +<literal>NOT</literal> or a stray brace.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Max. results</guilabel></term> +<listitem><para>Determines the maximum number of results returned from your +search.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Format</guilabel></term> +<listitem><para>Decide if you want just a short link to the page containing your search terms, or do you want a longer -summary.</para -></listitem -> -</varlistentry> -<varlistentry> -<term -><guilabel ->Sort</guilabel -></term> -<listitem -><para ->Sort the results in order of <guilabel ->Score</guilabel -> (how +summary.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Sort</guilabel></term> +<listitem><para>Sort the results in order of <guilabel>Score</guilabel> (how closely your search terms were matched,) alphabetically by -<guilabel ->Title</guilabel -> or by <guilabel ->Date</guilabel ->. Selecting the -<guilabel ->Reverse order</guilabel -> check box, naturally enough, reverses the -sort order of the results.</para -></listitem> -</varlistentry> -<varlistentry> -<term -><guilabel ->Update index</guilabel -></term> -<listitem -><para ->Update the search index, to incorporate new documents, +<guilabel>Title</guilabel> or by <guilabel>Date</guilabel>. Selecting the +<guilabel>Reverse order</guilabel> check box, naturally enough, reverses the +sort order of the results.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Update index</guilabel></term> +<listitem><para>Update the search index, to incorporate new documents, or if you think your database is incomplete or damaged. This may take -some time.</para -></listitem> +some time.</para></listitem> </varlistentry> </variablelist> </sect3> @@ -589,209 +293,118 @@ some time.</para </sect2> <sect2 id="man-and-info"> -<title ->The <application ->Man</application -> and <application ->Info</application -> sections</title> +<title>The <application>Man</application> and <application>Info</application> sections</title> -<para ->Man pages are the standard &UNIX; manual pages, and have been in use for many years on many operating systems. They are extremely thorough, and are the very best place to get information about most &UNIX; commands and applications. When people say <quote ->RTFM</quote ->, the Manual they are referring to is very often the man page.</para> +<para>Man pages are the standard &UNIX; manual pages, and have been in use for many years on many operating systems. They are extremely thorough, and are the very best place to get information about most &UNIX; commands and applications. When people say <quote>RTFM</quote>, the Manual they are referring to is very often the man page.</para> -<para ->The man pages are not perfect. They tend to be in depth, but also extremely technical, often written by developers, and for developers. In some cases this makes them somewhat unfriendly, if not downright impossible for many users to understand. They are, however, the best source of solid information on most command line applications, and very often the only source.</para> +<para>The man pages are not perfect. They tend to be in depth, but also extremely technical, often written by developers, and for developers. In some cases this makes them somewhat unfriendly, if not downright impossible for many users to understand. They are, however, the best source of solid information on most command line applications, and very often the only source.</para> -<para ->If you've ever wondered what the number is when people write things like man(1) it means which section of the manual the item is in. You will see &khelpcenter; uses the numbers to divide the very many man pages into their own sections, making it easier for you to find the information you're looking for, if you're just browsing.</para> +<para>If you've ever wondered what the number is when people write things like man(1) it means which section of the manual the item is in. You will see &khelpcenter; uses the numbers to divide the very many man pages into their own sections, making it easier for you to find the information you're looking for, if you're just browsing.</para> -<para ->Also available are the Info pages, intended to be a replacement for the man pages. The maintainer of some applications no longer update the man pages, so if there is both a man page and an info page available, the info page is probably the most recent. Most applications have one or the other though. If the application you are looking for help on is a &GNU; utility, you will most likely find it has an info page, not a man page.</para> +<para>Also available are the Info pages, intended to be a replacement for the man pages. The maintainer of some applications no longer update the man pages, so if there is both a man page and an info page available, the info page is probably the most recent. Most applications have one or the other though. If the application you are looking for help on is a &GNU; utility, you will most likely find it has an info page, not a man page.</para> <sect3 id="navigation"> -<title ->Navigating inside the <application ->Info</application -> pages</title> - -<para ->Info documents are arranged hierarchically with each page called a node. All info documents have a <guilabel ->Top</guilabel -> node, &ie; the opening page. You can return to the <guilabel ->Top</guilabel -> of an info document by pressing <guilabel ->Top</guilabel ->.</para> - -<para -><guibutton ->Prev</guibutton -> & <guibutton ->Next</guibutton -> are used to move to the previous/next page at the current level of the hierarchy.</para> - -<para ->Clicking on a menu item within a document moves you to a lower level in the hierarchy. You may move up the hierarchy by pressing <guibutton ->Up</guibutton ->.</para> - -<para ->Man is treated similarly to info, with the section index being the Top node and each man page on the level below. Man entries are one page long.</para> +<title>Navigating inside the <application>Info</application> pages</title> + +<para>Info documents are arranged hierarchically with each page called a node. All info documents have a <guilabel>Top</guilabel> node, &ie; the opening page. You can return to the <guilabel>Top</guilabel> of an info document by pressing <guilabel>Top</guilabel>.</para> + +<para><guibutton>Prev</guibutton> & <guibutton>Next</guibutton> are used to move to the previous/next page at the current level of the hierarchy.</para> + +<para>Clicking on a menu item within a document moves you to a lower level in the hierarchy. You may move up the hierarchy by pressing <guibutton>Up</guibutton>.</para> + +<para>Man is treated similarly to info, with the section index being the Top node and each man page on the level below. Man entries are one page long.</para> </sect3> </sect2> <sect2 id="kde-glossary"> -<title ->The &kde; glossary</title> +<title>The &kde; glossary</title> -<para ->The glossary provides a quick reference point, where you can look up the definitions of words that may be unfamiliar to you. These range from &kde; specific applications and technologies, through to general &UNIX; computing terms. </para> +<para>The glossary provides a quick reference point, where you can look up the definitions of words that may be unfamiliar to you. These range from &kde; specific applications and technologies, through to general &UNIX; computing terms. </para> -<para ->In the left hand pane you will see a tree view, with two choices: <guilabel ->Alphabetically</guilabel -> or <guilabel ->By topic</guilabel ->. Both contain the same entries, sorted differently, to allow you to quickly find the item of interest. </para> +<para>In the left hand pane you will see a tree view, with two choices: <guilabel>Alphabetically</guilabel> or <guilabel>By topic</guilabel>. Both contain the same entries, sorted differently, to allow you to quickly find the item of interest. </para> -<para ->Navigate down the tree views to the left, and items you select will be displayed on the right. </para> +<para>Navigate down the tree views to the left, and items you select will be displayed on the right. </para> </sect2> <sect2 id="menu-and-toolbar-ref"> -<title ->The menus and toolbar</title> +<title>The menus and toolbar</title> -<para ->&khelpcenter; has a very minimal interface, allowing you to concentrate on getting help rather than learning how to use the help browser. </para> +<para>&khelpcenter; has a very minimal interface, allowing you to concentrate on getting help rather than learning how to use the help browser. </para> -<para ->The icons available to you in the toolbar are as follows: </para> +<para>The icons available to you in the toolbar are as follows: </para> <variablelist> -<title ->Toolbar Icons</title> +<title>Toolbar Icons</title> <varlistentry> -<term -><guiicon ->Back</guiicon -></term> +<term><guiicon>Back</guiicon></term> <listitem> -<para ->Go to the previous page you viewed.</para> +<para>Go to the previous page you viewed.</para> </listitem> </varlistentry> <varlistentry> -<term -><guiicon ->Forward</guiicon -></term> +<term><guiicon>Forward</guiicon></term> <listitem> -<para ->Go forward one page. This icon is only active if you have already used the <guiicon ->Back</guiicon -> icon.</para -></listitem> +<para>Go forward one page. This icon is only active if you have already used the <guiicon>Back</guiicon> icon.</para></listitem> </varlistentry> <varlistentry> -<term -><guiicon ->Print</guiicon -></term> +<term><guiicon>Print</guiicon></term> <listitem> -<para ->Print the contents of the currently visible page. </para> +<para>Print the contents of the currently visible page. </para> </listitem> </varlistentry> <varlistentry> -<term -><guiicon ->Find</guiicon -></term> +<term><guiicon>Find</guiicon></term> <listitem> -<para ->Find a word or words within the currently visible page. </para> +<para>Find a word or words within the currently visible page. </para> </listitem> </varlistentry> <varlistentry> -<term -><guiicon ->Increase Font</guiicon -></term> +<term><guiicon>Increase Font</guiicon></term> <listitem> -<para ->Increase the size of the text in the viewer pane. </para> +<para>Increase the size of the text in the viewer pane. </para> </listitem> </varlistentry> <varlistentry> -<term -><guiicon ->Decrease Font</guiicon -></term> +<term><guiicon>Decrease Font</guiicon></term> <listitem> -<para ->Decrease the size of the text in the viewer pane. This icon is only enabled if you have previously enlarged the text. </para> +<para>Decrease the size of the text in the viewer pane. This icon is only enabled if you have previously enlarged the text. </para> </listitem> </varlistentry> </variablelist> -<para ->The menus contain the following entries: </para> +<para>The menus contain the following entries: </para> <variablelist> <varlistentry> -<term -><guimenu ->File</guimenu -></term> +<term><guimenu>File</guimenu></term> <listitem> <variablelist> <varlistentry> <term> -<menuchoice -><guimenu ->File</guimenu -> <guimenuitem ->Print...</guimenuitem -> </menuchoice> +<menuchoice><guimenu>File</guimenu> <guimenuitem>Print...</guimenuitem> </menuchoice> </term> <listitem> -<para ->Print the contents of the currently visible page. </para> +<para>Print the contents of the currently visible page. </para> </listitem> </varlistentry> <varlistentry> <term> -<menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->Q</keycap -></keycombo -> </shortcut -> <guimenu ->File</guimenu -> <guimenuitem ->Quit</guimenuitem -> </menuchoice> +<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem> </menuchoice> </term> <listitem> -<para ->Close and exit &khelpcenter; </para> +<para>Close and exit &khelpcenter; </para> </listitem> </varlistentry> </variablelist> @@ -799,52 +412,23 @@ some time.</para </varlistentry> <varlistentry> -<term -><guimenu ->Edit</guimenu -></term> +<term><guimenu>Edit</guimenu></term> <listitem> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->A</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Select All</guimenuitem -> </menuchoice> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Select All</guimenuitem> </menuchoice> </term> <listitem> -<para ->Select all the text in the current page. </para> +<para>Select all the text in the current page. </para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->F</keycap -></keycombo -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Find...</guimenuitem -> </menuchoice> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Find...</guimenuitem> </menuchoice> </term> <listitem> -<para ->Find a word or words in the currently visible page. </para> +<para>Find a word or words in the currently visible page. </para> </listitem> </varlistentry> </variablelist> @@ -852,43 +436,22 @@ some time.</para </varlistentry> <varlistentry> -<term -><guimenu ->View</guimenu -></term> +<term><guimenu>View</guimenu></term> <listitem> <variablelist> <varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->View Document Source</guimenuitem -> </menuchoice> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>View Document Source</guimenuitem> </menuchoice> </term> <listitem> -<para ->View the <acronym ->HTML</acronym -> source of the page you are currently viewing. </para> +<para>View the <acronym>HTML</acronym> source of the page you are currently viewing. </para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guisubmenu ->Set Encoding</guisubmenu -> </menuchoice> +<term><menuchoice><guimenu>View</guimenu> <guisubmenu>Set Encoding</guisubmenu> </menuchoice> </term> <listitem> -<para ->Change the encoding of the current page. Normally, the default setting of <guimenuitem ->Auto</guimenuitem -> should be sufficient, but if you are having problems viewing pages written in languages other than English, you may need to choose a specific encoding in this menu. </para> +<para>Change the encoding of the current page. Normally, the default setting of <guimenuitem>Auto</guimenuitem> should be sufficient, but if you are having problems viewing pages written in languages other than English, you may need to choose a specific encoding in this menu. </para> </listitem> </varlistentry> </variablelist> @@ -896,68 +459,36 @@ some time.</para </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Go</guimenu -> <guimenuitem ->Back</guimenuitem -></menuchoice -></term> +<term><menuchoice><guimenu>Go</guimenu> <guimenuitem>Back</guimenuitem></menuchoice></term> <listitem> -<para ->Go back to the previous page you were viewing.</para> +<para>Go back to the previous page you were viewing.</para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Go</guimenu -> <guimenuitem ->Forward</guimenuitem -> </menuchoice -></term> +<term><menuchoice><guimenu>Go</guimenu> <guimenuitem>Forward</guimenuitem> </menuchoice></term> <listitem> -<para ->If you have previously moved back with the back icon or menu entry, you can work your way forward again with this menu entry.</para> +<para>If you have previously moved back with the back icon or menu entry, you can work your way forward again with this menu entry.</para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Go</guimenu -> <guimenuitem ->...</guimenuitem -> </menuchoice -></term> +<term><menuchoice><guimenu>Go</guimenu> <guimenuitem>...</guimenuitem> </menuchoice></term> <listitem> -<para ->At the bottom of the <guimenu ->Go</guimenu -> menu, you will find a history list, of the last few pages you have looked at. Selecting one will take you directly back to that page.</para> -</listitem -></varlistentry -></variablelist> +<para>At the bottom of the <guimenu>Go</guimenu> menu, you will find a history list, of the last few pages you have looked at. Selecting one will take you directly back to that page.</para> +</listitem></varlistentry></variablelist> </sect2> </sect1> <sect1 id="credits"> -<title ->Credits and Licences</title> +<title>Credits and Licences</title> -<para ->&khelpcenter;</para> +<para>&khelpcenter;</para> -<para ->Originally developed by &Matthias.Elter; &Matthias.Elter.mail;</para> -<para ->The current maintainer is &Cornelius.Schumacher; &Cornelius.Schumacher.mail;</para> +<para>Originally developed by &Matthias.Elter; &Matthias.Elter.mail;</para> +<para>The current maintainer is &Cornelius.Schumacher; &Cornelius.Schumacher.mail;</para> &underFDL; &underGPL; </sect1> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/index.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/index.docbook index 06bfe61fb87..948f43a5795 100644 --- a/tde-i18n-en_GB/docs/tdebase/khelpcenter/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/index.docbook @@ -24,65 +24,37 @@ available, unless only references to the top page are needed, which is doubtful. <!ENTITY kde-kcontrol-doc SYSTEM "../kcontrol/index.html" NDATA SGML> <!ENTITY kde-kfm-doc SYSTEM "../konqueror/index.html" NDATA SGML> <!ENTITY kde-kwm-doc SYSTEM "../kwm/index.html" NDATA SGML> - <!-- ENTITY man SYSTEM "." NDATA LINESPECIFIC -> - to be changed ; should be + <!-- ENTITY man SYSTEM "." NDATA LINESPECIFIC> - to be changed ; should be the reference to the apropos file in this case, but I cannot really imagine putting all manual pages into FPIs or system identifiers, so we'll have to find a way round it. (FF) --> <!ENTITY kappname "&khelpcenter;"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> <!ENTITY % addindex "IGNORE"> ]> <book lang="&language;"> <bookinfo> -<title ->The &khelpcenter;</title> +<title>The &khelpcenter;</title> <authorgroup> -<corpauthor ->The &kde; Team</corpauthor> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<corpauthor>The &kde; Team</corpauthor> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-01-18</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-01-18</date> +<releaseinfo>3.00.00</releaseinfo> <abstract> -<para ->&kde; is a powerful graphical desktop environment for &UNIX; workstations. A &kde; desktop combines ease of use, contemporary functionality and outstanding graphical design with the technological superiority of the &UNIX; operating system.</para> +<para>&kde; is a powerful graphical desktop environment for &UNIX; workstations. A &kde; desktop combines ease of use, contemporary functionality and outstanding graphical design with the technological superiority of the &UNIX; operating system.</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->tdebase</keyword> -<keyword ->khelpcenter</keyword> -<keyword ->kdehelp</keyword> -<keyword ->help</keyword> -<keyword ->help centre</keyword> -<keyword ->KDE help centre</keyword> +<keyword>KDE</keyword> +<keyword>tdebase</keyword> +<keyword>khelpcenter</keyword> +<keyword>kdehelp</keyword> +<keyword>help</keyword> +<keyword>help centre</keyword> +<keyword>KDE help centre</keyword> </keywordset> </bookinfo> diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/links.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/links.docbook index 51e671a605c..644f2322d50 100644 --- a/tde-i18n-en_GB/docs/tdebase/khelpcenter/links.docbook +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/links.docbook @@ -1,90 +1,15 @@ <chapter id="web"> <chapterinfo> -<date ->2000-10-02</date> -<releaseinfo ->1.94.00</releaseinfo> +<date>2000-10-02</date> +<releaseinfo>1.94.00</releaseinfo> </chapterinfo> -<title ->&kde; on the web</title> +<title>&kde; on the web</title> <anchor id="links"/> -<para ->The K Desktop Environment is developed by a large group of developers around the world. Our main communication channel is the Internet. Please find links to &kde; related web sites on this page.</para> +<para>The K Desktop Environment is developed by a large group of developers around the world. Our main communication channel is the Internet. Please find links to &kde; related web sites on this page.</para> -<variablelist -> <varlistentry -> <term -><ulink url="http://www.kde.org" ->www.kde.org</ulink -></term -> <listitem -><para ->&kde;'s official website</para -></listitem -> </varlistentry -> <varlistentry -> <term -><ulink url="http://kde.themes.org" ->kde.themes.org</ulink -></term -> <listitem -><para ->&kde; themes</para -></listitem -> </varlistentry -> <varlistentry -> <term -><ulink url="http://developer.kde.org" ->developer.kde.org</ulink -></term -> <listitem -><para ->The &kde; developers centre</para -></listitem -> </varlistentry -> <varlistentry -> <term -><ulink url="http://webcvs.kde.org" ->webcvs.kde.org</ulink -></term -> <listitem -><para ->A web interface to the &kde; CVS repository</para -></listitem -> </varlistentry -> <varlistentry -> <term -><ulink url="http://i18n.kde.org" ->i18n.kde.org</ulink -></term -> <listitem -><para ->&kde;'s internationalisation and documentation server</para -></listitem -> </varlistentry -> <varlistentry -> <term -><ulink url="ftp://ftp.kde.org" ->ftp.kde.org</ulink -></term -> <listitem -><para ->The main &kde; &FTP; server. Please have a look at the link below to find a mirror site in your geographic region.</para -></listitem -> </varlistentry -> <varlistentry -> <term -><ulink url="http://www.kde.org/mirrors.html" ->www.kde.org/mirrors.html</ulink -></term -> <listitem -><para ->&kde; &FTP; mirror sites</para -></listitem -> </varlistentry -> </variablelist> +<variablelist> <varlistentry> <term><ulink url="http://www.kde.org">www.kde.org</ulink></term> <listitem><para>&kde;'s official website</para></listitem> </varlistentry> <varlistentry> <term><ulink url="http://kde.themes.org">kde.themes.org</ulink></term> <listitem><para>&kde; themes</para></listitem> </varlistentry> <varlistentry> <term><ulink url="http://developer.kde.org">developer.kde.org</ulink></term> <listitem><para>The &kde; developers centre</para></listitem> </varlistentry> <varlistentry> <term><ulink url="http://webcvs.kde.org">webcvs.kde.org</ulink></term> <listitem><para>A web interface to the &kde; CVS repository</para></listitem> </varlistentry> <varlistentry> <term><ulink url="http://i18n.kde.org">i18n.kde.org</ulink></term> <listitem><para>&kde;'s internationalisation and documentation server</para></listitem> </varlistentry> <varlistentry> <term><ulink url="ftp://ftp.kde.org">ftp.kde.org</ulink></term> <listitem><para>The main &kde; &FTP; server. Please have a look at the link below to find a mirror site in your geographic region.</para></listitem> </varlistentry> <varlistentry> <term><ulink url="http://www.kde.org/mirrors.html">www.kde.org/mirrors.html</ulink></term> <listitem><para>&kde; &FTP; mirror sites</para></listitem> </varlistentry> </variablelist> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/support.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/support.docbook index c15b43176d2..432d41b1eb8 100644 --- a/tde-i18n-en_GB/docs/tdebase/khelpcenter/support.docbook +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/support.docbook @@ -1,101 +1,63 @@ <chapter id="supporting-kde"> -<chapterinfo -><date ->2002-03-04</date -> <releaseinfo ->2.02.00</releaseinfo -> </chapterinfo> -<title ->Supporting &kde;</title> +<chapterinfo><date>2002-03-04</date> <releaseinfo>2.02.00</releaseinfo> </chapterinfo> +<title>Supporting &kde;</title> <anchor id="support"/> <sect1 id="supporting-kde-introduction"> -<title ->Supporting &kde;</title> +<title>Supporting &kde;</title> -<para ->If you are new to &kde;, the &kde; project might look like big machinery to you. Undoubtedly, &kde; is no longer a small project, nevertheless it is very important to realise that it is easy to <quote ->make a difference</quote -> in the &kde; world. </para> +<para>If you are new to &kde;, the &kde; project might look like big machinery to you. Undoubtedly, &kde; is no longer a small project, nevertheless it is very important to realise that it is easy to <quote>make a difference</quote> in the &kde; world. </para> -<para ->There is always a need for dedicated developers, graphic artists, sound engineers, translators and documentation writers. Consider jumping aboard this exciting international project and make yourself a name in the software world.</para> +<para>There is always a need for dedicated developers, graphic artists, sound engineers, translators and documentation writers. Consider jumping aboard this exciting international project and make yourself a name in the software world.</para> -<para ->Along the way you will make countless friends and acquaintances all over the world. Also, the satisfaction that stems from doing actual hands-on work, that will benefit an uncountable number of users world-wide, and from seeing an unparalleled project grow, is hard to beat. Please consider joining and supporting &kde; and hop aboard this exciting journey towards a free and open alternative computing platform. </para> +<para>Along the way you will make countless friends and acquaintances all over the world. Also, the satisfaction that stems from doing actual hands-on work, that will benefit an uncountable number of users world-wide, and from seeing an unparalleled project grow, is hard to beat. Please consider joining and supporting &kde; and hop aboard this exciting journey towards a free and open alternative computing platform. </para> </sect1> <sect1 id="supporting-kde-get-started"> -<title ->How to get started</title> +<title>How to get started</title> <itemizedlist> -<listitem -><para ->Subscribe to the <link linkend="contact" ->&kde; mailing lists</link -> that interest you. </para -></listitem> - -<listitem -><para ->Read the <ulink url="http://lists.kde.org" ->mailing list</ulink -> archives in order to get a feel for &kde; development. </para -></listitem> - -<listitem -><para ->Learn how to program using the &kde; application framework and join the friendly &kde; developers' community. </para -></listitem> +<listitem><para>Subscribe to the <link linkend="contact">&kde; mailing lists</link> that interest you. </para></listitem> + +<listitem><para>Read the <ulink url="http://lists.kde.org">mailing list</ulink> archives in order to get a feel for &kde; development. </para></listitem> + +<listitem><para>Learn how to program using the &kde; application framework and join the friendly &kde; developers' community. </para></listitem> </itemizedlist> </sect1> <sect1 id="supporting-kde-financial-support"> -<title ->Supporting financially</title> +<title>Supporting financially</title> -<para ->The &kde; team is working very hard on providing you with the best desktop available for the &UNIX; operating system. &kde; is available for free and will always be available for free, including each and every line of its source code, for everyone to modify and distribute. If you enjoy and use &kde; please consider supporting the &kde; Project financially. &kde; is in constant need of funds in order to finance its operations. </para> +<para>The &kde; team is working very hard on providing you with the best desktop available for the &UNIX; operating system. &kde; is available for free and will always be available for free, including each and every line of its source code, for everyone to modify and distribute. If you enjoy and use &kde; please consider supporting the &kde; Project financially. &kde; is in constant need of funds in order to finance its operations. </para> -<para ->If your busy schedule or skills do not permit you to be actively involved in &kde; development, please consider supporting &kde; financially by sending a donation to: </para> +<para>If your busy schedule or skills do not permit you to be actively involved in &kde; development, please consider supporting &kde; financially by sending a donation to: </para> -<para ->You can send standard US cheques to the following address: </para> +<para>You can send standard US cheques to the following address: </para> -<literallayout ->K Desktop Environment e.V. +<literallayout>K Desktop Environment e.V. Mirko Boehm 2029 Chadds Ford Drive Reston, VA 20191 USA </literallayout> -<para ->Use "KDE e.V. - Mirko Boehm" in the "Pay to the order of..." line. </para> +<para>Use "KDE e.V. - Mirko Boehm" in the "Pay to the order of..." line. </para> -<para ->From Europe, you may remit your donation to (be aware of a fee if wiring from outside of Germany): </para> +<para>From Europe, you may remit your donation to (be aware of a fee if wiring from outside of Germany): </para> -<literallayout ->K Desktop Environment e.V. +<literallayout>K Desktop Environment e.V. Account-Nr. 0 66 64 46 BLZ 200 700 24 Deutsche Bank 24 </literallayout> -<para ->Please contact Mirko Boehm <email ->kde-ev-treasurer@kde.org</email -> if you have any questions. </para> +<para>Please contact Mirko Boehm <email>kde-ev-treasurer@kde.org</email> if you have any questions. </para> -<para ->Your contribution is very much appreciated. Thank you! </para> +<para>Your contribution is very much appreciated. Thank you! </para> </sect1> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/welcome.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/welcome.docbook index 59a12630834..2f5a467b997 100644 --- a/tde-i18n-en_GB/docs/tdebase/khelpcenter/welcome.docbook +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/welcome.docbook @@ -1,95 +1,50 @@ <chapter id="welcome-to-kde"> -<chapterinfo -><date ->2002-01-18</date -> <releaseinfo ->3.00.00</releaseinfo -> </chapterinfo> -<title ->Welcome to &kde;</title> +<chapterinfo><date>2002-01-18</date> <releaseinfo>3.00.00</releaseinfo> </chapterinfo> +<title>Welcome to &kde;</title> <anchor id="welcome"/> -<para -> <emphasis ->The &kde; team welcomes you to user-friendly &UNIX; computing.</emphasis -> </para> +<para> <emphasis>The &kde; team welcomes you to user-friendly &UNIX; computing.</emphasis> </para> <sect1 id="welcome-page"> -<title ->Welcome to the K Desktop Environment</title> +<title>Welcome to the K Desktop Environment</title> <sect2 id="welcome-information-about-kde"> -<title ->Information about &kde;</title> +<title>Information about &kde;</title> -<para ->&kde; is a powerful graphical desktop environment for &UNIX; workstations. A &kde; desktop combines ease of use, contemporary functionality and outstanding graphical design with the technological superiority of the &UNIX; operating system. </para> +<para>&kde; is a powerful graphical desktop environment for &UNIX; workstations. A &kde; desktop combines ease of use, contemporary functionality and outstanding graphical design with the technological superiority of the &UNIX; operating system. </para> -<para -><link linkend="what-is-tde" ->What is the K Desktop Environment?</link -></para> +<para><link linkend="what-is-tde">What is the K Desktop Environment?</link></para> -<para -><link linkend="contact" ->Contacting the &kde; Project</link -></para> +<para><link linkend="contact">Contacting the &kde; Project</link></para> -<para -><link linkend="support" ->Supporting the &kde; Project</link -></para> +<para><link linkend="support">Supporting the &kde; Project</link></para> -<para -><link linkend="links" ->Useful links</link -></para> +<para><link linkend="links">Useful links</link></para> </sect2> <sect2 id="welcome-getting-the-most-out-of-kde"> -<title ->Getting the most out of &kde;</title> +<title>Getting the most out of &kde;</title> <sect3 id="welcome-general-documentation"> -<title ->General documentation</title> +<title>General documentation</title> -<para -><ulink url="help:/khelpcenter/quickstart" ->A Quick Start Guide to the Desktop</ulink -></para> +<para><ulink url="help:/khelpcenter/quickstart">A Quick Start Guide to the Desktop</ulink></para> -<para -><ulink url="help:/khelpcenter/userguide" ->&kde; User's guide</ulink -></para> +<para><ulink url="help:/khelpcenter/userguide">&kde; User's guide</ulink></para> -<para -><ulink url="help:/khelpcenter/faq" ->Frequently asked questions</ulink -></para> +<para><ulink url="help:/khelpcenter/faq">Frequently asked questions</ulink></para> </sect3> <sect3 id="welcome-basic-applications"> -<title ->Basic applications</title> - -<para -><ulink url="help:/kicker" ->Desktop Panel</ulink -></para> - -<para -><ulink url="help:/kcontrol" ->Control Centre</ulink -></para> - -<para -><ulink url="help:/konqueror" ->File Manager</ulink -></para> +<title>Basic applications</title> + +<para><ulink url="help:/kicker">Desktop Panel</ulink></para> + +<para><ulink url="help:/kcontrol">Control Centre</ulink></para> + +<para><ulink url="help:/konqueror">File Manager</ulink></para> </sect3> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/whatistde.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/whatistde.docbook index 8ab7799675b..8439e58bc71 100644 --- a/tde-i18n-en_GB/docs/tdebase/khelpcenter/whatistde.docbook +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/whatistde.docbook @@ -1,100 +1,55 @@ <chapter id="what-is-tde"> -<chapterinfo -><date ->2002-01-18</date -> <releaseinfo ->3.00.00</releaseinfo -> </chapterinfo> -<title ->What is &tde;?</title> +<chapterinfo><date>2002-01-18</date> <releaseinfo>3.00.00</releaseinfo> </chapterinfo> +<title>What is &tde;?</title> <anchor id="whatistde"/> <sect1 id="what-is-tde-introduction"> -<title ->What is &tde;?</title> +<title>What is &tde;?</title> -<para ->&tde; is a desktop environment. In other words, &tde; is a collection of programs, technologies and documentation that attempt to make life easier for computer users. &tde; is targeted at &UNIX; workstations. It features network transparency and a contemporary work philosophy. </para> +<para>&tde; is a desktop environment. In other words, &tde; is a collection of programs, technologies and documentation that attempt to make life easier for computer users. &tde; is targeted at &UNIX; workstations. It features network transparency and a contemporary work philosophy. </para> -<para ->The creators of the K Desktop Environment are a world-wide group of software engineers. This group's major goal in free software development is to provide high quality software that empowers the user with easy control of his computer's resources.</para> +<para>The creators of the K Desktop Environment are a world-wide group of software engineers. This group's major goal in free software development is to provide high quality software that empowers the user with easy control of his computer's resources.</para> -<para ->&tde; seeks to fill the need for an easy to use desktop for &UNIX; workstations, similar to the desktop environments found under &MacOS; or &Windows; 95/NT. &tde; meets the requirement of users for an easy to use work environment. Tools used to reach this end are: enhanced inter-application communication, component reuse, global drag and drop, uniform look and feel and many more. Thus, &tde; offers much more than the traditional &UNIX; window managers.</para> +<para>&tde; seeks to fill the need for an easy to use desktop for &UNIX; workstations, similar to the desktop environments found under &MacOS; or &Windows; 95/NT. &tde; meets the requirement of users for an easy to use work environment. Tools used to reach this end are: enhanced inter-application communication, component reuse, global drag and drop, uniform look and feel and many more. Thus, &tde; offers much more than the traditional &UNIX; window managers.</para> -<para ->Stability, scaleability and openness are qualities which have made &UNIX; the undisputed choice for the information technology professional for many years. &tde; builds on top of this excellent base framework and brings new, much needed qualities: usability, user friendliness and beauty! &tde; was the first, and stays the forefront player in bringing these qualities to &UNIX;, which constituted for years, the premier platform for server computers and scientific institutions, but wasn't very attractive for desktop users.</para> +<para>Stability, scaleability and openness are qualities which have made &UNIX; the undisputed choice for the information technology professional for many years. &tde; builds on top of this excellent base framework and brings new, much needed qualities: usability, user friendliness and beauty! &tde; was the first, and stays the forefront player in bringing these qualities to &UNIX;, which constituted for years, the premier platform for server computers and scientific institutions, but wasn't very attractive for desktop users.</para> -<para ->Without &UNIX; the Internet would not exist, or at least would have a vastly different form. &UNIX; has not, until now, addressed the needs of the average computer user. This fact is particularly unfortunate, since a number of implementations of &UNIX; (<ulink url="http://www.linux.org" ->&Linux;</ulink ->, <ulink url="http://www.freebsd.org" ->FreeBSD</ulink ->, <ulink url="http://www.netbsd.org" ->NetBSD</ulink ->, &etc;) are freely available on the Internet, all of which are of exceptional quality and stability. </para> +<para>Without &UNIX; the Internet would not exist, or at least would have a vastly different form. &UNIX; has not, until now, addressed the needs of the average computer user. This fact is particularly unfortunate, since a number of implementations of &UNIX; (<ulink url="http://www.linux.org">&Linux;</ulink>, <ulink url="http://www.freebsd.org">FreeBSD</ulink>, <ulink url="http://www.netbsd.org">NetBSD</ulink>, &etc;) are freely available on the Internet, all of which are of exceptional quality and stability. </para> </sect1> <sect1 id="what-is-tde-the-desktop"> -<title ->&tde; The Desktop Environment</title> +<title>&tde; The Desktop Environment</title> -<para ->In combination with a free implementation of &UNIX;, &tde; provides to the world an open and completely free desktop computing platform either at home or at work.</para> +<para>In combination with a free implementation of &UNIX;, &tde; provides to the world an open and completely free desktop computing platform either at home or at work.</para> -<para ->This platform is available to anyone free of charge including its source code for anyone to modify.</para> +<para>This platform is available to anyone free of charge including its source code for anyone to modify.</para> -<para ->While there will always be room for improvement we believe we have now delivered a viable alternative to some of the more commonly found and commercial operating systems/desktops combinations available today. It is our hope that the combination of &UNIX; and &tde; will finally bring the same open, reliable, stable, and monopoly free computing to the average computer user that scientists and computing professionals world-wide have enjoyed for years. </para> +<para>While there will always be room for improvement we believe we have now delivered a viable alternative to some of the more commonly found and commercial operating systems/desktops combinations available today. It is our hope that the combination of &UNIX; and &tde; will finally bring the same open, reliable, stable, and monopoly free computing to the average computer user that scientists and computing professionals world-wide have enjoyed for years. </para> </sect1> <sect1 id="what-is-tde-the-development-framework"> -<title ->&tde; The Application Development Framework</title> +<title>&tde; The Application Development Framework</title> -<para ->&tde; focuses on the user's needs, but it's obvious that this focus is more easily achieved by also giving developers the best tools. &tde; code contains, and comes with, some of the best development technologies of the modern computing age.</para> +<para>&tde; focuses on the user's needs, but it's obvious that this focus is more easily achieved by also giving developers the best tools. &tde; code contains, and comes with, some of the best development technologies of the modern computing age.</para> -<para ->Authoring applications under &UNIX;/X11 used to be an extremely tedious and labour intensive process. &tde; recognises the fact that a computing platform is only as good as the number of first class applications available to the users of that particular platform.</para> +<para>Authoring applications under &UNIX;/X11 used to be an extremely tedious and labour intensive process. &tde; recognises the fact that a computing platform is only as good as the number of first class applications available to the users of that particular platform.</para> -<para ->&tde; defines new technologies in &DCOP; and KParts, created to offer a component document model and technology. Together with the complete &tde; libraries programming interface, &DCOP;/KParts are set in direct competition with other similar technologies like &Microsoft; <abbrev ->MFC</abbrev ->/<abbrev ->COM</abbrev ->/ActiveX technologies. The excellent quality and the high level of refinement of &tde;'s application programming interface (<acronym ->API</acronym ->) enables developers to focus on original and interesting issues and avoid reinventing the wheel.</para> +<para>&tde; defines new technologies in &DCOP; and KParts, created to offer a component document model and technology. Together with the complete &tde; libraries programming interface, &DCOP;/KParts are set in direct competition with other similar technologies like &Microsoft; <abbrev>MFC</abbrev>/<abbrev>COM</abbrev>/ActiveX technologies. The excellent quality and the high level of refinement of &tde;'s application programming interface (<acronym>API</acronym>) enables developers to focus on original and interesting issues and avoid reinventing the wheel.</para> </sect1> <sect1 id="what-is-tde-the-office-suite"> -<title ->&tde; The Office Application Suite</title> - -<para ->In its current form, &tde; provides, apart from the essential desktop component applications, a suite of powerful office programs known to the world by the name &koffice;.</para> - -<para ->&koffice; is based on the &tde; &DCOP;/KParts technologies. It currently contains: a word processor with desktop publishing capabilities (&kword;), a spreadsheet application (&kspread;) and accompanying charting program (&kchart;), a presentation program (&kpresenter;) and a vector drawing program (&kontour;). Tying things together is the <application ->KOffice Workspace</application ->, an integrated shell to ease the use of the &koffice; components in conjunction with each other. Additional components include an email client, a news reader, and a powerful <abbrev ->PIM</abbrev -> (Personal Information Manager - an organiser).</para> - -<para ->While some of those components are still in alpha development, others are already extremely powerful. For example, &kpresenter;, &tde;'s presentation application, was successfully used at the 5th International &Linux; Congress in Cologne, Germany to deliver a &tde; presentation. </para> - -<para ->We would like to invite you to <ulink url="http://www.kde.org" ->learn more about &tde;</ulink -> and <ulink url="http://koffice.kde.org" ->&koffice;</ulink ->.</para> +<title>&tde; The Office Application Suite</title> + +<para>In its current form, &tde; provides, apart from the essential desktop component applications, a suite of powerful office programs known to the world by the name &koffice;.</para> + +<para>&koffice; is based on the &tde; &DCOP;/KParts technologies. It currently contains: a word processor with desktop publishing capabilities (&kword;), a spreadsheet application (&kspread;) and accompanying charting program (&kchart;), a presentation program (&kpresenter;) and a vector drawing program (&kontour;). Tying things together is the <application>KOffice Workspace</application>, an integrated shell to ease the use of the &koffice; components in conjunction with each other. Additional components include an email client, a news reader, and a powerful <abbrev>PIM</abbrev> (Personal Information Manager - an organiser).</para> + +<para>While some of those components are still in alpha development, others are already extremely powerful. For example, &kpresenter;, &tde;'s presentation application, was successfully used at the 5th International &Linux; Congress in Cologne, Germany to deliver a &tde; presentation. </para> + +<para>We would like to invite you to <ulink url="http://www.kde.org">learn more about &tde;</ulink> and <ulink url="http://koffice.kde.org">&koffice;</ulink>.</para> </sect1> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/kicker/index.docbook b/tde-i18n-en_GB/docs/tdebase/kicker/index.docbook index 7f9cb31571d..fd8340cdbed 100644 --- a/tde-i18n-en_GB/docs/tdebase/kicker/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kicker/index.docbook @@ -11,253 +11,152 @@ <book lang="&language;"> <bookinfo> -<title ->The &kicker; Handbook</title> +<title>The &kicker; Handbook</title> <authorgroup> -<author ->&Dirk.Doerflinger; &Dirk.Doerflinger.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Dirk.Doerflinger; &Dirk.Doerflinger.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->2001</year -><year ->2002</year> -<holder ->&Dirk.Doerflinger;</holder> +<year>2001</year><year>2002</year> +<holder>&Dirk.Doerflinger;</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2002-03-01</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-03-01</date> +<releaseinfo>3.00.00</releaseinfo> <abstract> -<para ->&kicker; is the &kde; application starter panel and is also capable of some useful applets and extensions. It usually resides on the bottom of the desktop. </para> +<para>&kicker; is the &kde; application starter panel and is also capable of some useful applets and extensions. It usually resides on the bottom of the desktop. </para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->Kicker</keyword> -<keyword ->tdebase</keyword> -<keyword ->panel</keyword> -<keyword ->application</keyword> -<keyword ->starter</keyword> +<keyword>KDE</keyword> +<keyword>Kicker</keyword> +<keyword>tdebase</keyword> +<keyword>panel</keyword> +<keyword>application</keyword> +<keyword>starter</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->&kicker; is the application launcher panel of the K Desktop Environment. Besides the <guimenu ->K</guimenu -> Menu, where you can start applications, &kicker; is also capable of running docked applets like the pager, the taskbar or the clock, and extensions, such as child panels. </para> +<para>&kicker; is the application launcher panel of the K Desktop Environment. Besides the <guimenu>K</guimenu> Menu, where you can start applications, &kicker; is also capable of running docked applets like the pager, the taskbar or the clock, and extensions, such as child panels. </para> -<para ->&kicker; usually resides on the bottom of the desktop, but it can also be moved to any other border. Please report any problems or feature requests to the &kde; mailing lists. </para> +<para>&kicker; usually resides on the bottom of the desktop, but it can also be moved to any other border. Please report any problems or feature requests to the &kde; mailing lists. </para> </chapter> <chapter id="using-kicker"> -<title ->Using &kicker;</title> +<title>Using &kicker;</title> -<para ->This is what you see on a freshly installed &kde;, assuming that you skipped <application ->KPersonaliser</application ->. If you are using lower resolution, some of the icons may not appear immediately. To cater for those smaller resolutions, the screenshot below is divided in two parts. </para> +<para>This is what you see on a freshly installed &kde;, assuming that you skipped <application>KPersonaliser</application>. If you are using lower resolution, some of the icons may not appear immediately. To cater for those smaller resolutions, the screenshot below is divided in two parts. </para> <screenshot> -<screeninfo ->Here's a screenshot of the left side of &kicker;</screeninfo> +<screeninfo>Here's a screenshot of the left side of &kicker;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="screenshot_left.png" format="PNG"/></imageobject> <textobject> -<phrase ->Screenshot Left</phrase> +<phrase>Screenshot Left</phrase> </textobject> <caption> -<para ->Here's a screenshot of the left side of &kicker; </para> +<para>Here's a screenshot of the left side of &kicker; </para> </caption> </mediaobject> </screenshot> <screenshot> -<screeninfo ->And here's the right side</screeninfo> +<screeninfo>And here's the right side</screeninfo> <mediaobject> <imageobject> <imagedata fileref="screenshot_right.png" format="PNG"/></imageobject> <textobject> -<phrase ->Screenshot Right</phrase> +<phrase>Screenshot Right</phrase> </textobject> <caption> -<para ->And here's the right side </para> +<para>And here's the right side </para> </caption> </mediaobject> </screenshot> -<para ->Of course, this is only one way &kicker; might appear on the screen. There are many more configurations available. </para> +<para>Of course, this is only one way &kicker; might appear on the screen. There are many more configurations available. </para> <sect1 id="newbie"> -<title ->A quick tour for new &kde; users</title> +<title>A quick tour for new &kde; users</title> -<para ->If you are experienced with this kind of application launcher, you can ignore this chapter and move on to <link linkend="basics" ->&kicker; basics</link ->. </para> +<para>If you are experienced with this kind of application launcher, you can ignore this chapter and move on to <link linkend="basics">&kicker; basics</link>. </para> -<para ->The main use of &kicker; is starting applications. This is done by clicking icons, either from the panel or from the <guimenu ->K</guimenu -> Menu. &kicker; shows some more things too, so let's see. </para> +<para>The main use of &kicker; is starting applications. This is done by clicking icons, either from the panel or from the <guimenu>K</guimenu> Menu. &kicker; shows some more things too, so let's see. </para> -<para ->Having a look at the screenshots above, there are from left to right: </para> +<para>Having a look at the screenshots above, there are from left to right: </para> <variablelist> <varlistentry> -<term ->The <guimenu ->K</guimenu -> Menu</term> +<term>The <guimenu>K</guimenu> Menu</term> <listitem> -<para ->It is used for launching applications and some other useful things. Refer to <link linkend="k-menu" ->The <guimenu ->K</guimenu -> Menu </link ->for more information. </para> +<para>It is used for launching applications and some other useful things. Refer to <link linkend="k-menu">The <guimenu>K</guimenu> Menu </link>for more information. </para> </listitem> </varlistentry> <varlistentry> -<term ->Application start icons</term> +<term>Application start icons</term> <listitem> -<para ->Here are some icons of commonly used applications. They can be moved and removed and others can be added. Some of them have a special meaning, which you can read more about in <link linkend="basics" ->&kicker; basics</link ->. Resting the mouse over an icon without clicking shows the name and a short description of that application, if you have set that in the <link linkend="configuring" ->Settings Dialogue</link ->. </para> +<para>Here are some icons of commonly used applications. They can be moved and removed and others can be added. Some of them have a special meaning, which you can read more about in <link linkend="basics">&kicker; basics</link>. Resting the mouse over an icon without clicking shows the name and a short description of that application, if you have set that in the <link linkend="configuring">Settings Dialogue</link>. </para> </listitem> </varlistentry> <varlistentry> -<term ->The Pager applet</term> +<term>The Pager applet</term> <listitem> -<para ->This displays a small view of the virtual desktops. Clicking one section of it will activate that desktop. Please refer to <link linkend="applets" ->Applets</link ->. </para> +<para>This displays a small view of the virtual desktops. Clicking one section of it will activate that desktop. Please refer to <link linkend="applets">Applets</link>. </para> </listitem> </varlistentry> <varlistentry> -<term ->The Taskbar</term> +<term>The Taskbar</term> <listitem> -<para ->All running applications are displayed as buttons in the taskbar. Clicking an application's button will bring this application on top. If it was on top before, it will be iconified. As always, more information in <link linkend="applets" ->Applets</link ->. </para> +<para>All running applications are displayed as buttons in the taskbar. Clicking an application's button will bring this application on top. If it was on top before, it will be iconified. As always, more information in <link linkend="applets">Applets</link>. </para> </listitem> </varlistentry> <varlistentry> -<term ->Lock/Logout</term> +<term>Lock/Logout</term> <listitem> -<para ->This applet contains two small buttons. The one with the luggage lock on it locks your session if you ever leave your &kde; unattended and don't want anybody else to have access to it; the other one shuts down &kde; and the X-Server. </para> +<para>This applet contains two small buttons. The one with the luggage lock on it locks your session if you ever leave your &kde; unattended and don't want anybody else to have access to it; the other one shuts down &kde; and the X-Server. </para> </listitem> </varlistentry> <varlistentry> -<term ->System Tray</term> +<term>System Tray</term> <listitem> -<para ->The system tray is able to swallow some kind of applications like - in this case - &klipper;. There are also more useful apps for the system tray. You can click the applications either with the <mousebutton ->left</mousebutton -> or the <mousebutton ->right</mousebutton -> mousebutton and see what's happening. </para> +<para>The system tray is able to swallow some kind of applications like - in this case - &klipper;. There are also more useful apps for the system tray. You can click the applications either with the <mousebutton>left</mousebutton> or the <mousebutton>right</mousebutton> mousebutton and see what's happening. </para> </listitem> </varlistentry> <varlistentry> -<term ->Clock</term> +<term>Clock</term> <listitem> -<para ->The Clock applet is - of course - a small, useful clock. It can have various styles, have a look at the <link linkend="applets" ->applets</link -> section for more information. </para> +<para>The Clock applet is - of course - a small, useful clock. It can have various styles, have a look at the <link linkend="applets">applets</link> section for more information. </para> </listitem> </varlistentry> <varlistentry> -<term ->The <guibutton ->hide</guibutton -> button</term> +<term>The <guibutton>hide</guibutton> button</term> <listitem> -<para ->This button lets you fade out &kicker; for having more space on the screen. When &kicker; is faded out, only the <guibutton ->hide</guibutton -> button will remain in order to fade in &kicker; again. </para> +<para>This button lets you fade out &kicker; for having more space on the screen. When &kicker; is faded out, only the <guibutton>hide</guibutton> button will remain in order to fade in &kicker; again. </para> </listitem> </varlistentry> </variablelist> -<para ->This was only the description of &kicker; on its initial launch. It can be configured in many ways and styles and more applets can be added. There are even some extensions like the external taskbar you can add. See <link linkend="basics" ->&kicker; basics</link ->, <link linkend="applets" ->Applets </link -> and <link linkend="extensions" ->Extensions </link ->for more information. </para> +<para>This was only the description of &kicker; on its initial launch. It can be configured in many ways and styles and more applets can be added. There are even some extensions like the external taskbar you can add. See <link linkend="basics">&kicker; basics</link>, <link linkend="applets">Applets </link> and <link linkend="extensions">Extensions </link>for more information. </para> </sect1> @@ -265,103 +164,44 @@ <chapter id="basics"> -<title ->&kicker; basics</title> +<title>&kicker; basics</title> <sect1 id="general-usage"> -<title ->General usage</title> - -<para ->As mentioned before, there are a lot of things that can be added to &kicker;. This section will tell you everything about application starting, folder browsing and adding some kinds of applets and extensions. Lots of things can be done from the <guimenu ->context menu</guimenu -> or from <guisubmenu ->Configure Panel</guisubmenu -> in the <guimenu ->K</guimenu -> Menu. </para> +<title>General usage</title> + +<para>As mentioned before, there are a lot of things that can be added to &kicker;. This section will tell you everything about application starting, folder browsing and adding some kinds of applets and extensions. Lots of things can be done from the <guimenu>context menu</guimenu> or from <guisubmenu>Configure Panel</guisubmenu> in the <guimenu>K</guimenu> Menu. </para> <sect2 id="adding-apps"> -<title ->Adding applications</title> +<title>Adding applications</title> -<para ->There are three different ways to add an application to &kicker;: </para> +<para>There are three different ways to add an application to &kicker;: </para> <variablelist> <varlistentry> -<term ->Drag and Drop</term> +<term>Drag and Drop</term> <listitem> -<para ->Simply drag any file from &konqueror; into &kicker; and it's there. This works also from the <guimenu ->K</guimenu -> Menu with any entry. You can change the attributes like optional command line parameters or the icon by clicking it with the <mousebutton ->right</mousebutton -> mouse button and choosing <guimenuitem ->Preferences</guimenuitem -> from the <guimenu ->context menu</guimenu ->. </para> +<para>Simply drag any file from &konqueror; into &kicker; and it's there. This works also from the <guimenu>K</guimenu> Menu with any entry. You can change the attributes like optional command line parameters or the icon by clicking it with the <mousebutton>right</mousebutton> mouse button and choosing <guimenuitem>Preferences</guimenuitem> from the <guimenu>context menu</guimenu>. </para> </listitem> </varlistentry> <varlistentry> -<term ->Using the context menu to add a &kde; application</term> +<term>Using the context menu to add a &kde; application</term> <listitem> -<para ->Click the <mousebutton ->right</mousebutton -> mousebutton on any free space in &kicker; and choose <guisubmenu ->Add</guisubmenu -> and then <guisubmenu ->Button </guisubmenu ->. There you can choose an application which will be added in the place you clicked. </para> +<para>Click the <mousebutton>right</mousebutton> mousebutton on any free space in &kicker; and choose <guisubmenu>Add</guisubmenu> and then <guisubmenu>Button </guisubmenu>. There you can choose an application which will be added in the place you clicked. </para> </listitem> </varlistentry> <varlistentry> -<term ->Using the <guimenu ->context menu</guimenu -> to add a non-&kde;-application</term> +<term>Using the <guimenu>context menu</guimenu> to add a non-&kde;-application</term> <listitem> -<para ->Non-&kde;-applications ⪚ <application ->xosview</application -> or <application ->xemacs</application ->. </para> +<para>Non-&kde;-applications ⪚ <application>xosview</application> or <application>xemacs</application>. </para> -<para ->Click the <mousebutton ->right</mousebutton -> mousebutton on any free space in &kicker; and choose <guisubmenu ->Add</guisubmenu ->, <guisubmenu ->Special Button</guisubmenu -> and then <guimenuitem ->Non-KDE Application </guimenuitem ->. Choose the application you want to add. In the newly appearing window, you can append an <guilabel ->optional command line</guilabel ->, have the application start from a terminal, and choose the icon which will appear in &kicker; by clicking the <guiicon ->gear </guiicon ->. If you don't choose an icon, the application will use the gear as a default. </para> +<para>Click the <mousebutton>right</mousebutton> mousebutton on any free space in &kicker; and choose <guisubmenu>Add</guisubmenu>, <guisubmenu>Special Button</guisubmenu> and then <guimenuitem>Non-KDE Application </guimenuitem>. Choose the application you want to add. In the newly appearing window, you can append an <guilabel>optional command line</guilabel>, have the application start from a terminal, and choose the icon which will appear in &kicker; by clicking the <guiicon>gear </guiicon>. If you don't choose an icon, the application will use the gear as a default. </para> </listitem> </varlistentry> </variablelist> -<para ->Applications can be moved or removed by &RMB; click and choosing <guimenuitem ->Move</guimenuitem -> or <guimenuitem ->Remove</guimenuitem ->. You can also move an icon by clicking &MMB; if you have one. Another way to remove an application is by clicking the &RMB; on any free space and then choosing <guisubmenu ->Remove</guisubmenu ->, <guisubmenu ->Button</guisubmenu -> and then the application you want to be removed. </para> +<para>Applications can be moved or removed by &RMB; click and choosing <guimenuitem>Move</guimenuitem> or <guimenuitem>Remove</guimenuitem>. You can also move an icon by clicking &MMB; if you have one. Another way to remove an application is by clicking the &RMB; on any free space and then choosing <guisubmenu>Remove</guisubmenu>, <guisubmenu>Button</guisubmenu> and then the application you want to be removed. </para> <!-- NOTE: Lauri: I'd say it would confuse users if I'd mention Non-KDE-Apps --> <!-- explicitly here. Please add them if you think there's a need. --> @@ -369,308 +209,123 @@ </sect2> <sect2 id="adding-folders"> -<title ->Adding Folders</title> +<title>Adding Folders</title> -<para ->Folders can be added by simply dragging a folder to any free space of &kicker;. Quick Browsers can also be added from the <guimenu ->context menu</guimenu -> or the <guimenu ->K</guimenu -> Menu. </para> +<para>Folders can be added by simply dragging a folder to any free space of &kicker;. Quick Browsers can also be added from the <guimenu>context menu</guimenu> or the <guimenu>K</guimenu> Menu. </para> -<para ->There are two different ways to have a folder in &kicker;, you can choose between them in the menu appearing after dropping. Omitting this menu, it will be added as a file manager <acronym ->URL</acronym ->. </para> +<para>There are two different ways to have a folder in &kicker;, you can choose between them in the menu appearing after dropping. Omitting this menu, it will be added as a file manager <acronym>URL</acronym>. </para> <variablelist> <varlistentry> -<term ->Add as file manager &URL;</term> +<term>Add as file manager &URL;</term> <listitem> -<para ->Choosing this will add a link to the selected folder. Clicking this <guiicon ->folder</guiicon -> icon will open &konqueror; displaying the contents of this folder. </para> +<para>Choosing this will add a link to the selected folder. Clicking this <guiicon>folder</guiicon> icon will open &konqueror; displaying the contents of this folder. </para> </listitem> </varlistentry> <varlistentry> -<term ->Add as Quick Browser</term> +<term>Add as Quick Browser</term> <listitem> -<para ->If you add a folder this way, it will be displayed as a submenu of &kicker;. This submenu contains <guimenuitem ->Open in File Manager</guimenuitem ->, which does the same as a file manager &URL;, and <guimenuitem ->Open in Terminal</guimenuitem ->, which opens a terminal with this folder as working path. Also, this submenu contains the contents of that folder. Sub-folders are displayed as new submenus like the Quick Browser itself. The maximum number of displayed elements can be set in the <link linkend="configuring" ->Settings Dialogue</link ->. Quick Browsers can also be added from the <guimenu ->context menu</guimenu -> of &kicker; and then choosing <guisubmenu ->Add</guisubmenu -> and <guisubmenu ->Special Button</guisubmenu ->. </para> +<para>If you add a folder this way, it will be displayed as a submenu of &kicker;. This submenu contains <guimenuitem>Open in File Manager</guimenuitem>, which does the same as a file manager &URL;, and <guimenuitem>Open in Terminal</guimenuitem>, which opens a terminal with this folder as working path. Also, this submenu contains the contents of that folder. Sub-folders are displayed as new submenus like the Quick Browser itself. The maximum number of displayed elements can be set in the <link linkend="configuring">Settings Dialogue</link>. Quick Browsers can also be added from the <guimenu>context menu</guimenu> of &kicker; and then choosing <guisubmenu>Add</guisubmenu> and <guisubmenu>Special Button</guisubmenu>. </para> </listitem> </varlistentry> </variablelist> -<para ->Both kinds of folders can be moved or removed by &RMB; click and choosing <guimenuitem ->Move</guimenuitem -> or <guimenuitem ->Remove</guimenuitem ->. You can also move an icon by clicking &MMB; if you have one. Another way to remove a folder is by clicking the &RMB; on any free space and then choosing <guisubmenu ->Remove</guisubmenu ->, <guisubmenu ->Button</guisubmenu -> and then the folder you want to be removed. </para> - -<para ->File manager &URL;s can also be configured from the <guimenu ->context-menu</guimenu ->, just like any other folder anywhere in &kde; </para> +<para>Both kinds of folders can be moved or removed by &RMB; click and choosing <guimenuitem>Move</guimenuitem> or <guimenuitem>Remove</guimenuitem>. You can also move an icon by clicking &MMB; if you have one. Another way to remove a folder is by clicking the &RMB; on any free space and then choosing <guisubmenu>Remove</guisubmenu>, <guisubmenu>Button</guisubmenu> and then the folder you want to be removed. </para> + +<para>File manager &URL;s can also be configured from the <guimenu>context-menu</guimenu>, just like any other folder anywhere in &kde; </para> </sect2> <sect2 id="adding-special-icons"> -<title ->Special Icons</title> - -<para ->Some icons in &kicker; have a special meaning. They are added by choosing <guisubmenu ->Add</guisubmenu -> and then <guisubmenu ->Special Button</guisubmenu -> of the <guimenu ->context-menu</guimenu ->. </para> +<title>Special Icons</title> + +<para>Some icons in &kicker; have a special meaning. They are added by choosing <guisubmenu>Add</guisubmenu> and then <guisubmenu>Special Button</guisubmenu> of the <guimenu>context-menu</guimenu>. </para> <variablelist> <varlistentry> -<term ->The <guimenu ->K</guimenu -> Menu Icon</term> -<listitem> -<para -><guiicon -><inlinemediaobject -><imageobject -><imagedata fileref="k_menu_icon.png" format="PNG"/></imageobject -></inlinemediaobject -></guiicon -> The <guiicon ->TDE Menu icon</guiicon -> is one of the most necessary icons in &kicker;. As you might guess, it opens the <guimenu ->K</guimenu -> Menu, which you can learn more about in <link linkend="k-menu" ->The TDE Menu</link ->. </para> +<term>The <guimenu>K</guimenu> Menu Icon</term> +<listitem> +<para><guiicon><inlinemediaobject><imageobject><imagedata fileref="k_menu_icon.png" format="PNG"/></imageobject></inlinemediaobject></guiicon> The <guiicon>TDE Menu icon</guiicon> is one of the most necessary icons in &kicker;. As you might guess, it opens the <guimenu>K</guimenu> Menu, which you can learn more about in <link linkend="k-menu">The TDE Menu</link>. </para> </listitem> </varlistentry> -<varlistentry> -<term ->The Window List</term> -<listitem> -<para -><guiicon -><inlinemediaobject -><imageobject -><imagedata fileref="windowlist_icon.png" format="PNG"/></imageobject -></inlinemediaobject -></guiicon -> Clicking this <guiicon ->icon</guiicon -> will show the <guimenu ->Window List</guimenu ->. Its first entry, <guimenuitem ->Unclutter Windows</guimenuitem ->, tries to move the windows on your active desktop in a way to see as many as possible. </para> - -<para -><guimenuitem ->Cascade Windows</guimenuitem -> puts all windows on the active desktop over each others, the most recently on top and the others sorted by the time they where last used.</para -> <para ->Below those entries is a list of all currently running applications, grouped by the desktops on which they are running. Clicking on the name of a desktop will switch to that one, clicking an application will also activate it. </para> +<varlistentry> +<term>The Window List</term> +<listitem> +<para><guiicon><inlinemediaobject><imageobject><imagedata fileref="windowlist_icon.png" format="PNG"/></imageobject></inlinemediaobject></guiicon> Clicking this <guiicon>icon</guiicon> will show the <guimenu>Window List</guimenu>. Its first entry, <guimenuitem>Unclutter Windows</guimenuitem>, tries to move the windows on your active desktop in a way to see as many as possible. </para> + +<para><guimenuitem>Cascade Windows</guimenuitem> puts all windows on the active desktop over each others, the most recently on top and the others sorted by the time they where last used.</para> <para>Below those entries is a list of all currently running applications, grouped by the desktops on which they are running. Clicking on the name of a desktop will switch to that one, clicking an application will also activate it. </para> </listitem> </varlistentry> <varlistentry> -<term ->The Bookmarks Icon</term> +<term>The Bookmarks Icon</term> <listitem> -<para -><guiicon -><inlinemediaobject -><imageobject -><imagedata fileref="bookmarks_icon.png" format="PNG"/></imageobject -></inlinemediaobject -></guiicon -> The <guiicon ->Bookmarks icon</guiicon -> provides fast access to your bookmarks. They appear in the same way as if you click the <guimenu ->Bookmarks menu</guimenu -> in &konqueror;. Clicking a bookmark in the menu will launch &konqueror; with the <acronym ->URL</acronym -> which is behind that bookmark. </para> +<para><guiicon><inlinemediaobject><imageobject><imagedata fileref="bookmarks_icon.png" format="PNG"/></imageobject></inlinemediaobject></guiicon> The <guiicon>Bookmarks icon</guiicon> provides fast access to your bookmarks. They appear in the same way as if you click the <guimenu>Bookmarks menu</guimenu> in &konqueror;. Clicking a bookmark in the menu will launch &konqueror; with the <acronym>URL</acronym> which is behind that bookmark. </para> </listitem> </varlistentry> <varlistentry> -<term ->The Recent Documents Icon</term> +<term>The Recent Documents Icon</term> <listitem> -<para -><guiicon -><inlinemediaobject -><imageobject -><imagedata fileref="recent_docs_icon.png" format="PNG"/></imageobject -></inlinemediaobject -></guiicon -> This menu shows the most recently used documents (works only with &kde; applications for the moment). Clicking the element <guimenuitem ->Clear History</guimenuitem -> will remove those entries, what may be useful for privacy reasons. </para> +<para><guiicon><inlinemediaobject><imageobject><imagedata fileref="recent_docs_icon.png" format="PNG"/></imageobject></inlinemediaobject></guiicon> This menu shows the most recently used documents (works only with &kde; applications for the moment). Clicking the element <guimenuitem>Clear History</guimenuitem> will remove those entries, what may be useful for privacy reasons. </para> </listitem> </varlistentry> <varlistentry> -<term ->The Desktop Access Icon</term> +<term>The Desktop Access Icon</term> <listitem> -<para -><guiicon -><inlinemediaobject -><imageobject -><imagedata fileref="desktop_icon.png" format="PNG"/></imageobject -></inlinemediaobject -></guiicon -> The <guiicon ->Desktop Access icon</guiicon -> lets you have quick access to all the things you have on your desktop by minimising all currently open applications. Clicking it once will toggle it to show the desktop. The <guiicon ->icon</guiicon -> will remain pressed until you either click it again, what will restore your minimised apps, or reactivate an application from the taskbar. </para> +<para><guiicon><inlinemediaobject><imageobject><imagedata fileref="desktop_icon.png" format="PNG"/></imageobject></inlinemediaobject></guiicon> The <guiicon>Desktop Access icon</guiicon> lets you have quick access to all the things you have on your desktop by minimising all currently open applications. Clicking it once will toggle it to show the desktop. The <guiicon>icon</guiicon> will remain pressed until you either click it again, what will restore your minimised apps, or reactivate an application from the taskbar. </para> </listitem> </varlistentry> <varlistentry> -<term ->The Quick Browser Item</term> +<term>The Quick Browser Item</term> <listitem> -<para -><guiicon -><inlinemediaobject -><imageobject -><imagedata fileref="quickbrowser_icon.png" format="PNG"/></imageobject -></inlinemediaobject -></guiicon ->Adding a <guiicon ->Quick Browser icon</guiicon -> will open a dialogue which will let you choose a path and an <guiicon ->icon</guiicon ->, which will appear as a <guimenu ->Quick Browser menu</guimenu ->. Refer to the <link linkend="adding-folders" ->Adding Folders</link -> section for more information about quick browsers. </para> +<para><guiicon><inlinemediaobject><imageobject><imagedata fileref="quickbrowser_icon.png" format="PNG"/></imageobject></inlinemediaobject></guiicon>Adding a <guiicon>Quick Browser icon</guiicon> will open a dialogue which will let you choose a path and an <guiicon>icon</guiicon>, which will appear as a <guimenu>Quick Browser menu</guimenu>. Refer to the <link linkend="adding-folders">Adding Folders</link> section for more information about quick browsers. </para> </listitem> </varlistentry> <varlistentry> -<term ->The Non-KDE Application Item</term> +<term>The Non-KDE Application Item</term> <listitem> -<para ->The <guimenuitem ->Add Non-KDE Application</guimenuitem -> lets you add an application which doesn't appear in the <guimenu ->K</guimenu -> menu to &kicker;. Refer to <link linkend="adding-apps" ->Adding Applications</link -> for more information about Non-&kde; Applications. </para> +<para>The <guimenuitem>Add Non-KDE Application</guimenuitem> lets you add an application which doesn't appear in the <guimenu>K</guimenu> menu to &kicker;. Refer to <link linkend="adding-apps">Adding Applications</link> for more information about Non-&kde; Applications. </para> </listitem> </varlistentry> <varlistentry> -<term ->The Terminal Sessions Icon</term> +<term>The Terminal Sessions Icon</term> <listitem> -<para -><guiicon -><inlinemediaobject -><imageobject -><imagedata fileref="terminals_icon.png" format="PNG"/></imageobject -></inlinemediaobject -></guiicon -> This icon provides a menu of the available Terminal sessions, just as &konsole; does when you click and hold its <guiicon ->New Session</guiicon -> button. </para> +<para><guiicon><inlinemediaobject><imageobject><imagedata fileref="terminals_icon.png" format="PNG"/></imageobject></inlinemediaobject></guiicon> This icon provides a menu of the available Terminal sessions, just as &konsole; does when you click and hold its <guiicon>New Session</guiicon> button. </para> </listitem> </varlistentry> <varlistentry> -<term ->The Printing System Icon</term> +<term>The Printing System Icon</term> <listitem> -<para -><guiicon -><inlinemediaobject -><imageobject -><imagedata fileref="printsys_icon.png" format="PNG"/></imageobject -></inlinemediaobject -></guiicon ->This icon gives you direct access to &kde;'s printing system. Clicking the &LMB; on the icon opens a menu which gives you the following options: <itemizedlist> -<listitem -><para -><guimenuitem ->Add Printer...</guimenuitem ->:This will start &kde;'s Add Printer Wizard which allows you to simply add a new printer to your system.</para> +<para><guiicon><inlinemediaobject><imageobject><imagedata fileref="printsys_icon.png" format="PNG"/></imageobject></inlinemediaobject></guiicon>This icon gives you direct access to &kde;'s printing system. Clicking the &LMB; on the icon opens a menu which gives you the following options: <itemizedlist> +<listitem><para><guimenuitem>Add Printer...</guimenuitem>:This will start &kde;'s Add Printer Wizard which allows you to simply add a new printer to your system.</para> </listitem> -<listitem -><para -><guimenuitem ->TDE Print Settings</guimenuitem -> This item will open the TDE Print Configuration dialogue.</para> +<listitem><para><guimenuitem>TDE Print Settings</guimenuitem> This item will open the TDE Print Configuration dialogue.</para> </listitem> <listitem> -<para -><guimenuitem ->Configure Server</guimenuitem -></para> +<para><guimenuitem>Configure Server</guimenuitem></para> </listitem> -<listitem -><para -><guimenuitem ->Print Manager</guimenuitem ->This item starts the Printing Manager, &kde;'s main printing control centre.</para> +<listitem><para><guimenuitem>Print Manager</guimenuitem>This item starts the Printing Manager, &kde;'s main printing control centre.</para> </listitem> -<listitem -><para -><guimenuitem ->Print Browser (&konqueror;)</guimenuitem ->This item will start &konqueror; with the <literal ->print:/</literal -> io-slave to browse all kinds of printers.</para> +<listitem><para><guimenuitem>Print Browser (&konqueror;)</guimenuitem>This item will start &konqueror; with the <literal>print:/</literal> io-slave to browse all kinds of printers.</para> </listitem> -<listitem -><para -><guimenuitem ->Print a file...</guimenuitem ->This item opens a dialogue which lets you easily print one or more files.</para> +<listitem><para><guimenuitem>Print a file...</guimenuitem>This item opens a dialogue which lets you easily print one or more files.</para> </listitem> </itemizedlist> @@ -684,226 +339,110 @@ </sect2> <sect2 id="removing-icons"> -<title ->Removing all kinds of icons</title> - -<para ->Clicking the &RMB; on any icon, no means if it's for an application, a folder or a special icon, or clicking the small arrow on the handle, and then choosing <guimenuitem ->Remove</guimenuitem -> from the appearing <guimenu ->context menu</guimenu -> will remove the icon from &kicker;. </para> -<para ->Another way of removing icons is clicking the &RMB; on any free space in &kicker; and choosing <guimenuitem ->Remove</guimenuitem -> and then <guimenuitem ->Button</guimenuitem -> or <guimenuitem ->Special Button</guimenuitem ->. You can then choose the button you want to remove in the submenu.</para> +<title>Removing all kinds of icons</title> + +<para>Clicking the &RMB; on any icon, no means if it's for an application, a folder or a special icon, or clicking the small arrow on the handle, and then choosing <guimenuitem>Remove</guimenuitem> from the appearing <guimenu>context menu</guimenu> will remove the icon from &kicker;. </para> +<para>Another way of removing icons is clicking the &RMB; on any free space in &kicker; and choosing <guimenuitem>Remove</guimenuitem> and then <guimenuitem>Button</guimenuitem> or <guimenuitem>Special Button</guimenuitem>. You can then choose the button you want to remove in the submenu.</para> <note> -<para ->Please note that removing an icon from &kicker; won't remove the application on the disk! </para> +<para>Please note that removing an icon from &kicker; won't remove the application on the disk! </para> </note> </sect2> <sect2 id="adding-applets"> -<title ->Adding Applets</title> - -<para ->&kicker; comes with a set of applets like the taskbar or the mini-pager. Those can be added either from the submenu <guisubmenu ->Configure Panel</guisubmenu -> of the <guimenu ->K</guimenu -> Menu or from the <guimenu ->context menu</guimenu -> by choosing <guisubmenu ->Add</guisubmenu -> and then <guisubmenu ->Applet</guisubmenu ->. </para> - -<para ->Applets can be moved by dragging them on their handle with holding the &LMB; mouse button, or the &MMB; mouse button, or by choosing <guimenuitem ->Move</guimenuitem -> from the <guimenu ->context menu</guimenu ->. </para> - -<para ->You can learn more about the applets in the section <link linkend="applets" ->Applets</link ->. </para> +<title>Adding Applets</title> + +<para>&kicker; comes with a set of applets like the taskbar or the mini-pager. Those can be added either from the submenu <guisubmenu>Configure Panel</guisubmenu> of the <guimenu>K</guimenu> Menu or from the <guimenu>context menu</guimenu> by choosing <guisubmenu>Add</guisubmenu> and then <guisubmenu>Applet</guisubmenu>. </para> + +<para>Applets can be moved by dragging them on their handle with holding the &LMB; mouse button, or the &MMB; mouse button, or by choosing <guimenuitem>Move</guimenuitem> from the <guimenu>context menu</guimenu>. </para> + +<para>You can learn more about the applets in the section <link linkend="applets">Applets</link>. </para> </sect2> <sect2 id="removing-applets"> -<title ->Removing Applets</title> -<para ->Applets can be removed by choosing <guimenuitem ->Remove</guimenuitem -> from the <guimenu ->context menu</guimenu ->, which appears when the &RMB; is clicked on the applet's handle (left or top side of the applet) or in some applets allover the applet. The same <guimenu ->menu</guimenu -> appears when clicking the small arrow on the applet's handle. </para> +<title>Removing Applets</title> +<para>Applets can be removed by choosing <guimenuitem>Remove</guimenuitem> from the <guimenu>context menu</guimenu>, which appears when the &RMB; is clicked on the applet's handle (left or top side of the applet) or in some applets allover the applet. The same <guimenu>menu</guimenu> appears when clicking the small arrow on the applet's handle. </para> </sect2> <sect2 id="adding-extensions"> -<title ->Adding Extensions</title> +<title>Adding Extensions</title> -<para ->There is also the possibility to add external extensions to &kicker;, like the external taskbar, the Dock Application Bar for WindowMaker dock-applications, <application ->Kasbar</application ->, an iconic kind of taskbar and even child panels which behave like new instances of &kicker;. </para> +<para>There is also the possibility to add external extensions to &kicker;, like the external taskbar, the Dock Application Bar for WindowMaker dock-applications, <application>Kasbar</application>, an iconic kind of taskbar and even child panels which behave like new instances of &kicker;. </para> -<para ->All extensions can be moved to any border of the screen by dragging them with the &LMB; on the small fade-out handles on the left or top side of the extensions. These fade-out handles can also be used for fading out the extension. The child panel can also be dragged by clicking with the &LMB; on any empty space on it. </para> +<para>All extensions can be moved to any border of the screen by dragging them with the &LMB; on the small fade-out handles on the left or top side of the extensions. These fade-out handles can also be used for fading out the extension. The child panel can also be dragged by clicking with the &LMB; on any empty space on it. </para> -<para ->More about extensions can be read in the <link linkend="extensions" ->extensions</link -> section. </para> +<para>More about extensions can be read in the <link linkend="extensions">extensions</link> section. </para> </sect2> <sect2 id="removing-extensions"> -<title ->Removing Extensions</title> - -<para ->You can remove extensions by clicking <guimenuitem ->Remove</guimenuitem -> in their <guimenu ->context menu</guimenu ->, usually located in the fade-out handles. </para> +<title>Removing Extensions</title> + +<para>You can remove extensions by clicking <guimenuitem>Remove</guimenuitem> in their <guimenu>context menu</guimenu>, usually located in the fade-out handles. </para> </sect2> </sect1> <sect1 id="configuring-apps"> -<title ->Configuring Application Buttons</title> - -<para ->Every <guiicon ->application starter</guiicon -> has some preferences you can set from their <guimenu ->context menu</guimenu ->. Usually applications and folders have the same preferences as in &konqueror;. Only the applications which are located in the <guimenu ->K</guimenu -> Menu (for experienced users: those which have a <literal role="extension" ->*.desktop</literal -> in the <filename class="directory" ->applnk</filename -> dir) have a special kind of config dialogue. </para> +<title>Configuring Application Buttons</title> + +<para>Every <guiicon>application starter</guiicon> has some preferences you can set from their <guimenu>context menu</guimenu>. Usually applications and folders have the same preferences as in &konqueror;. Only the applications which are located in the <guimenu>K</guimenu> Menu (for experienced users: those which have a <literal role="extension">*.desktop</literal> in the <filename class="directory">applnk</filename> dir) have a special kind of config dialogue. </para> <sect2 id="general-tab"> -<title ->The <guilabel ->General</guilabel -> Tab</title> - -<para ->Here you can see some stats about the application link. You can also choose an icon by clicking on the <guibutton ->icon button</guibutton -> and change the filename of the link file. This may be useful if you want the icon on the panel behave different to the analogue one in the <guimenu ->K</guimenu -> Menu. </para> +<title>The <guilabel>General</guilabel> Tab</title> + +<para>Here you can see some stats about the application link. You can also choose an icon by clicking on the <guibutton>icon button</guibutton> and change the filename of the link file. This may be useful if you want the icon on the panel behave different to the analogue one in the <guimenu>K</guimenu> Menu. </para> </sect2> <sect2 id="permissions-tab"> -<title ->The <guilabel ->Permissions</guilabel -> Tab</title> +<title>The <guilabel>Permissions</guilabel> Tab</title> -<para ->Here you can set the permissions of the link file. Please refer to the manuals or handbooks of your operating system for more about permissions. </para> +<para>Here you can set the permissions of the link file. Please refer to the manuals or handbooks of your operating system for more about permissions. </para> </sect2> <sect2 id="execute-tab"> -<title ->The <guilabel ->Execute</guilabel -> Tab</title> +<title>The <guilabel>Execute</guilabel> Tab</title> -<para ->You can set the behaviour of the application when it's executed on this page. </para> +<para>You can set the behaviour of the application when it's executed on this page. </para> <variablelist> <varlistentry> -<term -><guilabel ->Command</guilabel -></term> +<term><guilabel>Command</guilabel></term> <listitem> -<para ->Usually, there is only the name of the binary that has to be started when clicking on the icon. You can search for another application to be started by clicking the <guibutton ->Browse</guibutton -> button and/or add special command line parameters to the application. </para> +<para>Usually, there is only the name of the binary that has to be started when clicking on the icon. You can search for another application to be started by clicking the <guibutton>Browse</guibutton> button and/or add special command line parameters to the application. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Panel Embedding</guilabel -></term> +<term><guilabel>Panel Embedding</guilabel></term> <listitem> -<para ->This feature is not implemented yet. </para> +<para>This feature is not implemented yet. </para> </listitem> -<!--<listitem -><para ->&kicker; has the possibility to swallow some applications -like <abbrev ->e.g.</abbrev -> <application ->XOSView</application ->. This means that +<!--<listitem><para>&kicker; has the possibility to swallow some applications +like <abbrev>e.g.</abbrev> <application>XOSView</application>. This means that the application will show up directly in the panel. Therefore you have to -insert the exact title of the application window in the <guilabel ->Window -Title</guilabel -> Textfield. You can also specify an application that will be +insert the exact title of the application window in the <guilabel>Window +Title</guilabel> Textfield. You can also specify an application that will be executed when clicking on the swallowed application by typing it's name in the -<guilabel ->Execute on click</guilabel -> field.</para -></listitem ->--> +<guilabel>Execute on click</guilabel> field.</para></listitem>--> </varlistentry> <varlistentry> -<term -><guilabel ->Run in terminal</guilabel -></term> +<term><guilabel>Run in terminal</guilabel></term> <listitem> -<para ->If this box is checked, the application will be executed in a terminal window. You can also add special Terminal options. </para> +<para>If this box is checked, the application will be executed in a terminal window. You can also add special Terminal options. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Run as different user</guilabel -></term> +<term><guilabel>Run as different user</guilabel></term> <listitem> -<para ->Checking this option will let the application start with the permission of the user you typed in the field <guilabel ->Username</guilabel ->. You will be prompted for the user's password on application start. This option may be very useful if you want to start some applications as superuser. </para> +<para>Checking this option will let the application start with the permission of the user you typed in the field <guilabel>Username</guilabel>. You will be prompted for the user's password on application start. This option may be very useful if you want to start some applications as superuser. </para> </listitem> </varlistentry> </variablelist> @@ -911,20 +450,11 @@ executed when clicking on the swallowed application by typing it's name in the </sect2> <sect2 id="application-tab"> -<title ->The <guilabel ->Application</guilabel -> Tab</title> +<title>The <guilabel>Application</guilabel> Tab</title> -<para ->If you set a name and a comment, they will be shown as tooltips of the start icons in the style <quote ->Name - Comment</quote ->. </para> +<para>If you set a name and a comment, they will be shown as tooltips of the start icons in the style <quote>Name - Comment</quote>. </para> -<para ->In the <guilabel ->File Types</guilabel -> section you can choose what kinds of filetypes are handled by this application. Please refer to &konqueror; handbook for more about this. </para> +<para>In the <guilabel>File Types</guilabel> section you can choose what kinds of filetypes are handled by this application. Please refer to &konqueror; handbook for more about this. </para> </sect2> @@ -933,552 +463,259 @@ executed when clicking on the swallowed application by typing it's name in the </chapter> <chapter id="configuring"> -<title ->Configuring &kicker;</title> - -<para ->This section describes the ways &kicker; can be configured. It's only about the basic &kicker; settings, configuration of the applets are described in their <link linkend="applets" ->sections</link -> </para> - -<para ->You can change the settings by either clicking <guimenuitem ->Settings</guimenuitem -> in the <guimenu ->context menu</guimenu -> or the submenu <guisubmenu ->Configure Panel</guisubmenu -> of the <guimenu ->K</guimenu -> Menu or in the &kcontrol; in the module <guilabel ->Look & Feel</guilabel ->. </para> +<title>Configuring &kicker;</title> + +<para>This section describes the ways &kicker; can be configured. It's only about the basic &kicker; settings, configuration of the applets are described in their <link linkend="applets">sections</link> </para> + +<para>You can change the settings by either clicking <guimenuitem>Settings</guimenuitem> in the <guimenu>context menu</guimenu> or the submenu <guisubmenu>Configure Panel</guisubmenu> of the <guimenu>K</guimenu> Menu or in the &kcontrol; in the module <guilabel>Look & Feel</guilabel>. </para> <note> -<para ->Please note that the settings in the <guilabel ->General</guilabel -> and the <guilabel ->Look & Feel</guilabel -> tabs only affect to the main panel while the behaviour of extensions is set in the <guilabel ->Extensions</guilabel -> tab. </para> +<para>Please note that the settings in the <guilabel>General</guilabel> and the <guilabel>Look & Feel</guilabel> tabs only affect to the main panel while the behaviour of extensions is set in the <guilabel>Extensions</guilabel> tab. </para> </note> <sect1 id="panel"> -<title ->The Panel Section</title> +<title>The Panel Section</title> <sect2 id="panel-general"> -<title -><guilabel ->General</guilabel -></title> - -<para ->In the <guilabel ->General</guilabel -> tab you can configure some basic functionality of the &kde; panel (&ie; functionality you'd find in other panel applications as well; later we'll come to the more interesting features). </para> - -<para ->In the <guilabel ->Panel Location</guilabel -> frame you can choose which screen border the panel should be attached to. Please note that usually the available space is used more efficiently if the panel is aligned horizontally, &ie; attached to the top or bottom screen border. If you want to play around with different settings you can change the panel's position even easier by dragging the panel from one border to the other. </para> - -<para ->The <guilabel ->Alignment</guilabel -> group lets you define, where &kicker; is located when the size is set to less than 100%. This can also be done by dragging &kicker; with the &LMB; to the place you want to have it. </para> - -<para ->The panel's style can be tiny, small, medium or large. Depending on which applets you use you may find that some applets work better at different panel sizes. You can also change the size by moving the mousepointer over the upper border of &kicker; (assuming &kicker; is at the bottom of your screen) and dragging it while holding the &LMB;. When you do that, the style settings will switch to <guilabel ->Custom</guilabel -> </para> +<title><guilabel>General</guilabel></title> + +<para>In the <guilabel>General</guilabel> tab you can configure some basic functionality of the &kde; panel (&ie; functionality you'd find in other panel applications as well; later we'll come to the more interesting features). </para> + +<para>In the <guilabel>Panel Location</guilabel> frame you can choose which screen border the panel should be attached to. Please note that usually the available space is used more efficiently if the panel is aligned horizontally, &ie; attached to the top or bottom screen border. If you want to play around with different settings you can change the panel's position even easier by dragging the panel from one border to the other. </para> + +<para>The <guilabel>Alignment</guilabel> group lets you define, where &kicker; is located when the size is set to less than 100%. This can also be done by dragging &kicker; with the &LMB; to the place you want to have it. </para> + +<para>The panel's style can be tiny, small, medium or large. Depending on which applets you use you may find that some applets work better at different panel sizes. You can also change the size by moving the mousepointer over the upper border of &kicker; (assuming &kicker; is at the bottom of your screen) and dragging it while holding the &LMB;. When you do that, the style settings will switch to <guilabel>Custom</guilabel> </para> <note> -<para ->Please note, that switching manually to <guilabel ->Custom</guilabel -> doesn't have any effect and otherwise that you don't need to switch to custom to be able to resize &kicker; manually. </para> +<para>Please note, that switching manually to <guilabel>Custom</guilabel> doesn't have any effect and otherwise that you don't need to switch to custom to be able to resize &kicker; manually. </para> </note> -<para ->Some people may not want to have &kicker; take the whole width or height of their screen. The slider <guilabel ->Percentage of desktop width/height to be used</guilabel -> changes this behaviour. If you decrease the percentage, &kicker; will either appear aligned left or top of the screen, depending on its location. Checking the checkbox <guilabel ->Expand to fit required size</guilabel -> makes sure that &kicker; is at least as big as needed to show every icon and applet. </para> +<para>Some people may not want to have &kicker; take the whole width or height of their screen. The slider <guilabel>Percentage of desktop width/height to be used</guilabel> changes this behaviour. If you decrease the percentage, &kicker; will either appear aligned left or top of the screen, depending on its location. Checking the checkbox <guilabel>Expand to fit required size</guilabel> makes sure that &kicker; is at least as big as needed to show every icon and applet. </para> </sect2> <sect2 id="panel-hiding"> -<title -><guilabel ->Hiding</guilabel -></title> - -<para ->Depending on your screen resolution you may find that the panel takes away too much of your precious screen real estate. To save screen space, the panel offers an auto hide feature. When this feature is enabled, the panel will hide when the mouse cursor has not been moved over it for a configurable amount of time. If you move the mouse to the panel's screen border it will show up again. Check the <guilabel ->Enable automatic hide</guilabel -> option in the <guilabel ->Automatic Hide</guilabel -> frame to enable this feature. Using the <guilabel ->Delay in seconds</guilabel -> slider you can configure the amount of time the panel will wait before it hides. The checkbox <guilabel ->Show panel when switching desktop</guilabel -> makes sure that the panel will be shown on the new chosen desktop. Otherwise, if there are too many applets and icons on &kicker;, two small scroll buttons will be displayed to scroll the whole panel. </para> - -<para ->When the panel's hide buttons are enabled you'll see buttons on both sides of the panel, with arrows showing to the screen border. If you click on one of these buttons, the panel will slide away in that direction. After that, you'll see a remaining show button in that corner, which will make the panel show again. Check the appropriate checkbox if you want the hide buttons to show up on any side of &kicker;. Using the slider you can change the width of the buttons. </para> - -<para ->Using the <guilabel ->Manual Hide Animation</guilabel -> (for the hide buttons) and <guilabel ->Auto Hide Animation</guilabel -> (for the auto hide functionality) options you can configure whether the panel will softly slide away or just disappear. You can enable or disable both animations using the <guilabel ->Enable</guilabel -> options and you can change the speed of the animation using the sliders. </para> +<title><guilabel>Hiding</guilabel></title> + +<para>Depending on your screen resolution you may find that the panel takes away too much of your precious screen real estate. To save screen space, the panel offers an auto hide feature. When this feature is enabled, the panel will hide when the mouse cursor has not been moved over it for a configurable amount of time. If you move the mouse to the panel's screen border it will show up again. Check the <guilabel>Enable automatic hide</guilabel> option in the <guilabel>Automatic Hide</guilabel> frame to enable this feature. Using the <guilabel>Delay in seconds</guilabel> slider you can configure the amount of time the panel will wait before it hides. The checkbox <guilabel>Show panel when switching desktop</guilabel> makes sure that the panel will be shown on the new chosen desktop. Otherwise, if there are too many applets and icons on &kicker;, two small scroll buttons will be displayed to scroll the whole panel. </para> + +<para>When the panel's hide buttons are enabled you'll see buttons on both sides of the panel, with arrows showing to the screen border. If you click on one of these buttons, the panel will slide away in that direction. After that, you'll see a remaining show button in that corner, which will make the panel show again. Check the appropriate checkbox if you want the hide buttons to show up on any side of &kicker;. Using the slider you can change the width of the buttons. </para> + +<para>Using the <guilabel>Manual Hide Animation</guilabel> (for the hide buttons) and <guilabel>Auto Hide Animation</guilabel> (for the auto hide functionality) options you can configure whether the panel will softly slide away or just disappear. You can enable or disable both animations using the <guilabel>Enable</guilabel> options and you can change the speed of the animation using the sliders. </para> </sect2> <sect2 id="panel-looknfeel"> -<title -><guilabel ->Look & Feel</guilabel -></title> - -<para ->Using the <guilabel ->Look & Feel</guilabel -> tab you can configure the panel's overall appearance. </para> - -<para ->The &kde; panel supports so-called <quote ->tiled buttons</quote ->. This means that the buttons shown on the panel will be drawn using configurable images. To enable button tiling, check the <guilabel ->Enable background tiles</guilabel -> option in the <guilabel ->Look & Feel</guilabel -> tab. Then you can configure tiles for certain kinds of buttons. </para> - -<para ->For every kind of panel button there is a frame offering an <guilabel ->Enabled</guilabel -> option to enable or disable tiled images. If tiles are enabled for this kind of button, you can choose a tile in the combo box below and the box on the right will show a preview of this tile. </para> - -<para ->The different kinds of buttons are: </para> +<title><guilabel>Look & Feel</guilabel></title> + +<para>Using the <guilabel>Look & Feel</guilabel> tab you can configure the panel's overall appearance. </para> + +<para>The &kde; panel supports so-called <quote>tiled buttons</quote>. This means that the buttons shown on the panel will be drawn using configurable images. To enable button tiling, check the <guilabel>Enable background tiles</guilabel> option in the <guilabel>Look & Feel</guilabel> tab. Then you can configure tiles for certain kinds of buttons. </para> + +<para>For every kind of panel button there is a frame offering an <guilabel>Enabled</guilabel> option to enable or disable tiled images. If tiles are enabled for this kind of button, you can choose a tile in the combo box below and the box on the right will show a preview of this tile. </para> + +<para>The different kinds of buttons are: </para> <variablelist> <varlistentry> -<term -><guilabel ->TDE Menu Tiles</guilabel -></term> +<term><guilabel>TDE Menu Tiles</guilabel></term> <listitem> -<para ->The icon for the <guiicon ->TDE Menu</guiicon -> will be displayed as a tile </para> +<para>The icon for the <guiicon>TDE Menu</guiicon> will be displayed as a tile </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Quickbrowser Tiles</guilabel -></term> +<term><guilabel>Quickbrowser Tiles</guilabel></term> <listitem> -<para ->The icons for <guiicon ->Quickbrowsers</guiicon -> will be displayed as tiles </para> +<para>The icons for <guiicon>Quickbrowsers</guiicon> will be displayed as tiles </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Application Launcher Tiles</guilabel -></term> +<term><guilabel>Application Launcher Tiles</guilabel></term> <listitem> -<para ->The icons which start applications will be displayed as tiles </para> +<para>The icons which start applications will be displayed as tiles </para> </listitem> </varlistentry> <varlistentry> <term> -<guilabel ->Legacy Application Tiles</guilabel> +<guilabel>Legacy Application Tiles</guilabel> </term> <listitem> -<para ->The icons for legacy applications will be displayed as tiles </para> +<para>The icons for legacy applications will be displayed as tiles </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Window List Tiles</guilabel -></term> +<term><guilabel>Window List Tiles</guilabel></term> <listitem> -<para ->The <guiicon ->Window List</guiicon -> icon will be displayed as a tile </para> +<para>The <guiicon>Window List</guiicon> icon will be displayed as a tile </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Desktop Access Tiles</guilabel -></term> +<term><guilabel>Desktop Access Tiles</guilabel></term> <listitem> -<para ->The <guiicon ->Desktop Access</guiicon -> icon will be displayed as a tile </para> +<para>The <guiicon>Desktop Access</guiicon> icon will be displayed as a tile </para> </listitem> </varlistentry> </variablelist> -<para ->Enabling the switch <guilabel ->Enable icon zooming</guilabel -> will give you the effect that &kicker;'s icons will grow bigger when hovering with the mouse. This effect will not appear when the size of &kicker; is set bigger than <guilabel ->medium</guilabel ->. </para> +<para>Enabling the switch <guilabel>Enable icon zooming</guilabel> will give you the effect that &kicker;'s icons will grow bigger when hovering with the mouse. This effect will not appear when the size of &kicker; is set bigger than <guilabel>medium</guilabel>. </para> -<para ->If <guilabel ->Show tooltips</guilabel -> is checked, small descriptions of the icons or applets will be shown when the mousepointer rests over an icon for some seconds. </para> +<para>If <guilabel>Show tooltips</guilabel> is checked, small descriptions of the icons or applets will be shown when the mousepointer rests over an icon for some seconds. </para> -<para ->The <guilabel ->Background Image</guilabel -> is a picture that will be used to draw the panel's background, just like you can use a picture for the desktop background. Check the <guilabel ->Enable background image</guilabel -> option to enable this feature. You can specify an image file in the line edit box below or choose one by clicking on the <guibutton ->Browse</guibutton -> button. You'll see a preview of the selected picture on the right. </para> +<para>The <guilabel>Background Image</guilabel> is a picture that will be used to draw the panel's background, just like you can use a picture for the desktop background. Check the <guilabel>Enable background image</guilabel> option to enable this feature. You can specify an image file in the line edit box below or choose one by clicking on the <guibutton>Browse</guibutton> button. You'll see a preview of the selected picture on the right. </para> </sect2> <sect2 id="panel-menus"> -<title ->Menus</title> - -<para ->In the <guilabel ->Menus</guilabel -> tab you can configure the panel menu's behaviour. This affects the <guimenu ->K</guimenu -> menu you will often use to launch applications, the browser menus you can use to access folders and other menus like the recent documents menu. </para> - -<para ->The <guilabel ->TDE Menu Layout</guilabel -> frame offers you some options to configure the <guimenu ->K</guimenu -> menu's functionality. The <guilabel ->Show "Bookmarks" submenu</guilabel -> and <guilabel ->Show "Recent Documents" submenu</guilabel -> options will enable submenus showing your <application ->konqueror</application -> bookmarks and the last documents you've opened using &kde; applications respectively. The <guilabel ->Show "Quick Browser" submenu</guilabel -> option will enable a browser menu. Enabling the <guilabel ->Show side image</guilabel -> checkbox will display a neat image on the left side of the <guimenu ->K</guimenu -> menu. If the option <guilabel ->Detailed menu entries</guilabel -> is set, th <guimenu ->K</guimenu -> menu will show a small description besides the name of the application. </para> -<para ->Within the <guilabel ->TDE Menu Layout</guilabel -> you can also define which dynamic menus should be displayed in the <guimenu ->K</guimenu -> menu by moving them from <guilabel ->Available Menus</guilabel -> to <guilabel ->Selected Menus</guilabel -> using the <guibutton -><<</guibutton ->. They can be removed the same way by using the <guibutton ->>></guibutton ->. </para> - -<para ->In the <guilabel ->Browser Menus</guilabel -> frame you can configure whether the panel's browser menus will show hidden files or not (hidden files on UNIX systems are those whose filenames begin with a dot) as well as how many files at most will be shown in a browser menu; the latter option may be especially useful if you have a rather small screen resolution, as the browser menus would otherwise quickly fill up your screen when you browse folders containing many files. </para> - -<para ->The quick start section in the <guimenu ->K</guimenu -> menu offers quick access to programs you have used often or recently. In the <guilabel ->"Quick Start" section contains</guilabel -> frame you can choose whether this section will show the most recently or the most frequently used programs. Using the option <guilabel ->Max number of "Quick Start" entries</guilabel -> you can configure how many programs the quick start section will remember. </para> +<title>Menus</title> + +<para>In the <guilabel>Menus</guilabel> tab you can configure the panel menu's behaviour. This affects the <guimenu>K</guimenu> menu you will often use to launch applications, the browser menus you can use to access folders and other menus like the recent documents menu. </para> + +<para>The <guilabel>TDE Menu Layout</guilabel> frame offers you some options to configure the <guimenu>K</guimenu> menu's functionality. The <guilabel>Show "Bookmarks" submenu</guilabel> and <guilabel>Show "Recent Documents" submenu</guilabel> options will enable submenus showing your <application>konqueror</application> bookmarks and the last documents you've opened using &kde; applications respectively. The <guilabel>Show "Quick Browser" submenu</guilabel> option will enable a browser menu. Enabling the <guilabel>Show side image</guilabel> checkbox will display a neat image on the left side of the <guimenu>K</guimenu> menu. If the option <guilabel>Detailed menu entries</guilabel> is set, th <guimenu>K</guimenu> menu will show a small description besides the name of the application. </para> +<para>Within the <guilabel>TDE Menu Layout</guilabel> you can also define which dynamic menus should be displayed in the <guimenu>K</guimenu> menu by moving them from <guilabel>Available Menus</guilabel> to <guilabel>Selected Menus</guilabel> using the <guibutton><<</guibutton>. They can be removed the same way by using the <guibutton>>></guibutton>. </para> + +<para>In the <guilabel>Browser Menus</guilabel> frame you can configure whether the panel's browser menus will show hidden files or not (hidden files on UNIX systems are those whose filenames begin with a dot) as well as how many files at most will be shown in a browser menu; the latter option may be especially useful if you have a rather small screen resolution, as the browser menus would otherwise quickly fill up your screen when you browse folders containing many files. </para> + +<para>The quick start section in the <guimenu>K</guimenu> menu offers quick access to programs you have used often or recently. In the <guilabel>"Quick Start" section contains</guilabel> frame you can choose whether this section will show the most recently or the most frequently used programs. Using the option <guilabel>Max number of "Quick Start" entries</guilabel> you can configure how many programs the quick start section will remember. </para> </sect2> <sect2 id="panel-applets"> -<title ->Applets</title> +<title>Applets</title> -<para ->Applets are small plugins that extend the panel's functionality. &kde; comes with some applets but they may be provided by third parties as well.</para> +<para>Applets are small plugins that extend the panel's functionality. &kde; comes with some applets but they may be provided by third parties as well.</para> -<para ->Panel applets can be started using two different ways: internally or externally. While <quote ->internal</quote -> is the preferred way to load applets, this can raise stability or security problems when you are using poorly programmed third-party applets. To address these problems, applets can be marked <quote ->trusted</quote ->. You might want to configure the panel to treat trusted applets different from untrusted ones. Your options are: </para> +<para>Panel applets can be started using two different ways: internally or externally. While <quote>internal</quote> is the preferred way to load applets, this can raise stability or security problems when you are using poorly programmed third-party applets. To address these problems, applets can be marked <quote>trusted</quote>. You might want to configure the panel to treat trusted applets different from untrusted ones. Your options are: </para> <itemizedlist> <listitem> -<para -><guilabel ->Load only trusted applets internal</guilabel ->: All applets but the ones marked <quote ->trusted</quote -> will be loaded using an external wrapper application. </para> +<para><guilabel>Load only trusted applets internal</guilabel>: All applets but the ones marked <quote>trusted</quote> will be loaded using an external wrapper application. </para> </listitem> <listitem> -<para -><guilabel ->Load startup config applets internal</guilabel ->: The applets shown on &kde; startup will be loaded internally, others will be loaded using an external wrapper application.</para -></listitem> -<listitem -><para -><guilabel ->Load all applets internal</guilabel ->: will load all applets internally, regardless of whether they're trusted or not. </para> +<para><guilabel>Load startup config applets internal</guilabel>: The applets shown on &kde; startup will be loaded internally, others will be loaded using an external wrapper application.</para></listitem> +<listitem><para><guilabel>Load all applets internal</guilabel>: will load all applets internally, regardless of whether they're trusted or not. </para> </listitem> </itemizedlist> -<para ->For stability and security reasons, we recommend using one of the first two options and that you mark only those applets as 'trusted' that come with the &kde; base packages. </para> +<para>For stability and security reasons, we recommend using one of the first two options and that you mark only those applets as 'trusted' that come with the &kde; base packages. </para> -<para ->To mark applets <quote ->trusted</quote -> or <quote ->untrusted</quote -> you can move them from one of the shown listboxes to the other. Just try selecting an applet in the list of trusted applets and click the <guibutton ->>></guibutton -> button. This will move the selected applet to the other list, while clicking the <guibutton -><<</guibutton -> button will move the selected applet of the list of available applets to the list of trusted ones. </para> +<para>To mark applets <quote>trusted</quote> or <quote>untrusted</quote> you can move them from one of the shown listboxes to the other. Just try selecting an applet in the list of trusted applets and click the <guibutton>>></guibutton> button. This will move the selected applet to the other list, while clicking the <guibutton><<</guibutton> button will move the selected applet of the list of available applets to the list of trusted ones. </para> </sect2> <sect2 id="panel-extensions"> -<title ->Extensions</title> -<para ->In this section you can change the behaviour of the <xref linkend="extensions"/>. Simply choose one of your extensions (⪚ Child Panel) from the listbox on the left side and adjust its settings. Those are very similar to the settings on the <xref linkend="panel-general"/> and the <xref linkend="panel-looknfeel"/> tabs. </para> - -<para ->The <guilabel ->Panel Location</guilabel -> group sets the location of the chosen extension. If the option <guilabel ->Enable automatic hide</guilabel -> is checked, the extension will be faded out automatically after the time in seconds set with the slider <guilabel ->Delay in seconds</guilabel ->. Marking the checkbox <guilabel ->Show panel when switching desktop</guilabel -> lets the extension show up after a desktop change. </para> - -<para ->You can toggle which hide buttons the chosen extension should have with the checkboxes in the group <guilabel ->Hide Buttons</guilabel ->. The slider <guilabel -> Hide Button Size</guilabel -> sets the size of the appearing hide buttons. </para> +<title>Extensions</title> +<para>In this section you can change the behaviour of the <xref linkend="extensions"/>. Simply choose one of your extensions (⪚ Child Panel) from the listbox on the left side and adjust its settings. Those are very similar to the settings on the <xref linkend="panel-general"/> and the <xref linkend="panel-looknfeel"/> tabs. </para> + +<para>The <guilabel>Panel Location</guilabel> group sets the location of the chosen extension. If the option <guilabel>Enable automatic hide</guilabel> is checked, the extension will be faded out automatically after the time in seconds set with the slider <guilabel>Delay in seconds</guilabel>. Marking the checkbox <guilabel>Show panel when switching desktop</guilabel> lets the extension show up after a desktop change. </para> + +<para>You can toggle which hide buttons the chosen extension should have with the checkboxes in the group <guilabel>Hide Buttons</guilabel>. The slider <guilabel> Hide Button Size</guilabel> sets the size of the appearing hide buttons. </para> </sect2> </sect1> <sect1 id="taskbar-settings"> -<title ->The Taskbar Section</title> +<title>The Taskbar Section</title> -<para ->This section changes the settings of the taskbar. Changes affect the external taskbar and also taskbar applets on &kicker; or child-panels. </para> +<para>This section changes the settings of the taskbar. Changes affect the external taskbar and also taskbar applets on &kicker; or child-panels. </para> <variablelist> <varlistentry> -<term ->Show all windows</term> +<term>Show all windows</term> <listitem> -<para ->If this box is checked, the taskbar will show all running apps of every desktop. Otherwise, only the applications of the current desktop are shown. </para> +<para>If this box is checked, the taskbar will show all running apps of every desktop. Otherwise, only the applications of the current desktop are shown. </para> </listitem> </varlistentry> <varlistentry> -<term ->Show windows list button</term> +<term>Show windows list button</term> <listitem> -<para ->Checking this box will show the small <guibutton ->window list button</guibutton ->. </para> +<para>Checking this box will show the small <guibutton>window list button</guibutton>. </para> </listitem> </varlistentry> <varlistentry> -<term ->Group similar tasks</term> +<term>Group similar tasks</term> <listitem> <para> -<inlinemediaobject -><imageobject -><imagedata fileref="taskbar_group.png" -format="PNG"/></imageobject -></inlinemediaobject -> This is a feature introduced in &kde; version 2.2. If the option <guilabel ->Group similar tasks</guilabel -> is set, several instances of the same application are grouped together in one taskbar button. </para> - -<para ->You can define the mouse actions of the taskbar buttons with the settings in the <guilabel ->Actions</guilabel ->. Each action can be one of the following:</para> +<inlinemediaobject><imageobject><imagedata fileref="taskbar_group.png" +format="PNG"/></imageobject></inlinemediaobject> This is a feature introduced in &kde; version 2.2. If the option <guilabel>Group similar tasks</guilabel> is set, several instances of the same application are grouped together in one taskbar button. </para> + +<para>You can define the mouse actions of the taskbar buttons with the settings in the <guilabel>Actions</guilabel>. Each action can be one of the following:</para> <variablelist> <varlistentry> <term> -<guilabel ->Show Task List</guilabel> +<guilabel>Show Task List</guilabel> </term> -<listitem -><para ->Clicking with the mouse button will open a menu displaying all tasks in that group. If you click an entry of that menu with any mouse button, the corresponding application will become active.</para> +<listitem><para>Clicking with the mouse button will open a menu displaying all tasks in that group. If you click an entry of that menu with any mouse button, the corresponding application will become active.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Show Operations Menu</guilabel -></term> +<term><guilabel>Show Operations Menu</guilabel></term> <listitem> -<para ->Clicking with the mousebutton will open a menu with all applications of that group, where every application has its window menu as a submenu and there are some group specific entries like <guimenuitem ->Close All</guimenuitem -> which closes all applications of that group, <guisubmenu ->All to Desktop</guisubmenu -> which lets you define on which desktop the whole group appears and <guimenuitem ->Maximise All</guimenuitem ->, <guimenuitem ->Minimise All</guimenuitem -> and <guimenuitem ->Restore All</guimenuitem -> which appends those actions to all applications of that group. </para> +<para>Clicking with the mousebutton will open a menu with all applications of that group, where every application has its window menu as a submenu and there are some group specific entries like <guimenuitem>Close All</guimenuitem> which closes all applications of that group, <guisubmenu>All to Desktop</guisubmenu> which lets you define on which desktop the whole group appears and <guimenuitem>Maximise All</guimenuitem>, <guimenuitem>Minimise All</guimenuitem> and <guimenuitem>Restore All</guimenuitem> which appends those actions to all applications of that group. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Cycle Through Windows</guilabel -></term> -<listitem -><para ->If this action is chosen, each click with the mousebutton on the <guibutton ->taskbar button</guibutton -> will activate one of that group's applications, one after each others.</para> +<term><guilabel>Cycle Through Windows</guilabel></term> +<listitem><para>If this action is chosen, each click with the mousebutton on the <guibutton>taskbar button</guibutton> will activate one of that group's applications, one after each others.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Activate Task</guilabel -></term> +<term><guilabel>Activate Task</guilabel></term> <listitem> -<para -><guilabel ->Activate Task</guilabel ->: Clicking with the mousebutton will activate the first application in that group without opening the group menu. </para> +<para><guilabel>Activate Task</guilabel>: Clicking with the mousebutton will activate the first application in that group without opening the group menu. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Raise Task</guilabel -></term> +<term><guilabel>Raise Task</guilabel></term> <listitem> -<para ->The first application of that group will be put in the foreground without giving focus to it.</para> +<para>The first application of that group will be put in the foreground without giving focus to it.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Lower Task</guilabel -></term> +<term><guilabel>Lower Task</guilabel></term> <listitem> -<para ->The first application of that group will be put in the background. It won't lose the focus. </para> +<para>The first application of that group will be put in the background. It won't lose the focus. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Minimise Task</guilabel -></term> +<term><guilabel>Minimise Task</guilabel></term> <listitem> -<para ->The first application of that group will be minimised. If it is already minimised, it will be restored again.</para> +<para>The first application of that group will be minimised. If it is already minimised, it will be restored again.</para> </listitem> </varlistentry> </variablelist> -<para ->Please note that some of these settings only have effect if a taskbar button contains more than one application. </para> +<para>Please note that some of these settings only have effect if a taskbar button contains more than one application. </para> </listitem> </varlistentry> <varlistentry> -<term ->Sort tasks by virtual desktop</term> +<term>Sort tasks by virtual desktop</term> <listitem> -<para ->Checking this box will sort all <guibutton ->taskbar buttons</guibutton -> in a group for each desktop, otherwise they are sorted by the order they are started. This will not affect grouped tasks if they are spread over more than one desktop. </para> +<para>Checking this box will sort all <guibutton>taskbar buttons</guibutton> in a group for each desktop, otherwise they are sorted by the order they are started. This will not affect grouped tasks if they are spread over more than one desktop. </para> </listitem> </varlistentry> <varlistentry> -<term ->Show application icons</term> +<term>Show application icons</term> <listitem> -<para ->If this box is checked, every <guibutton ->taskbar button</guibutton -> will have the icon of the running application beside its title. </para> +<para>If this box is checked, every <guibutton>taskbar button</guibutton> will have the icon of the running application beside its title. </para> </listitem> </varlistentry> @@ -1489,71 +726,36 @@ format="PNG"/></imageobject </chapter> <chapter id="k-menu"> -<title ->The <guimenu ->K</guimenu -> Menu</title> +<title>The <guimenu>K</guimenu> Menu</title> -<para ->The <guimenu ->K</guimenu -> Menu is one of the central elements of &kicker;. </para> +<para>The <guimenu>K</guimenu> Menu is one of the central elements of &kicker;. </para> -<para ->There are five main groups in the <guimenu ->K</guimenu -> Menu which will be described now from bottom to top. </para> +<para>There are five main groups in the <guimenu>K</guimenu> Menu which will be described now from bottom to top. </para> <sect1 id="kde-group"> -<title ->The <acronym ->KDE</acronym -> Group</title> +<title>The <acronym>KDE</acronym> Group</title> -<para ->This group is for the common &kde; things in the <guimenu ->K</guimenu -> Menu. </para> +<para>This group is for the common &kde; things in the <guimenu>K</guimenu> Menu. </para> <variablelist> <varlistentry> -<term -><guimenuitem ->Logout</guimenuitem -></term> +<term><guimenuitem>Logout</guimenuitem></term> <listitem> -<para ->This entry is used to finish the &kde; session. It also shuts down the &X-Window; session. </para> +<para>This entry is used to finish the &kde; session. It also shuts down the &X-Window; session. </para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Lock Session</guimenuitem -></term> +<term><guimenuitem>Lock Session</guimenuitem></term> <listitem> -<para ->With this entry you can lock your session if you don't want anybody else to access your desktop. If you have set a screensaver, it will appear when locked, otherwise the screen will turn black. If you hit any key, you will be prompted for your user password. This is independent from the screensaver's password settings. </para> +<para>With this entry you can lock your session if you don't want anybody else to access your desktop. If you have set a screensaver, it will appear when locked, otherwise the screen will turn black. If you hit any key, you will be prompted for your user password. This is independent from the screensaver's password settings. </para> </listitem> </varlistentry> <varlistentry> -<term -><guisubmenu ->Configure Panel</guisubmenu -></term> +<term><guisubmenu>Configure Panel</guisubmenu></term> <listitem> -<para ->In this submenu you can change the settings of &kicker;, described in the <link linkend="configuring" ->Configuring &kicker;</link -> section, add things to &kicker; (see in <link linkend="basics" ->&kicker; Basics</link -> for more) and start the <application ->Menu Editor</application ->. You can also reach the <guisubmenu ->Help</guisubmenu -> Menu, but as you are reading this, you probably found it yourself. </para> +<para>In this submenu you can change the settings of &kicker;, described in the <link linkend="configuring">Configuring &kicker;</link> section, add things to &kicker; (see in <link linkend="basics">&kicker; Basics</link> for more) and start the <application>Menu Editor</application>. You can also reach the <guisubmenu>Help</guisubmenu> Menu, but as you are reading this, you probably found it yourself. </para> </listitem> </varlistentry> </variablelist> @@ -1561,73 +763,41 @@ format="PNG"/></imageobject </sect1> <sect1 id="run-command"> -<title ->Run Command</title> +<title>Run Command</title> -<para ->This will bring up a small but powerful application start dialogue. </para> +<para>This will bring up a small but powerful application start dialogue. </para> -<para ->In the standard case, you just type in a command and press <keycap ->Enter</keycap -> or click <guibutton ->Run</guibutton ->. But there is also an <guibutton ->Options</guibutton -> button which will bring up some starting options to the command window. </para> +<para>In the standard case, you just type in a command and press <keycap>Enter</keycap> or click <guibutton>Run</guibutton>. But there is also an <guibutton>Options</guibutton> button which will bring up some starting options to the command window. </para> <variablelist> <varlistentry> -<term -><guilabel ->Run in terminal</guilabel -></term> +<term><guilabel>Run in terminal</guilabel></term> <listitem> -<para ->Checking this box will let the application start in a terminal which means that you will be able to see any command-line messages the application may give. </para> +<para>Checking this box will let the application start in a terminal which means that you will be able to see any command-line messages the application may give. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Run as a different user</guilabel -></term> +<term><guilabel>Run as a different user</guilabel></term> <listitem> -<para ->If this box is checked, you can specify a user with whose permission the application should run in the <guilabel ->Username</guilabel -> textfield. If you specify another user, you will have to give a password at the box below. </para> +<para>If this box is checked, you can specify a user with whose permission the application should run in the <guilabel>Username</guilabel> textfield. If you specify another user, you will have to give a password at the box below. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Run with different priority</guilabel -></term> +<term><guilabel>Run with different priority</guilabel></term> <listitem> -<para ->Check this option to run with a different priority. A higher priority will tell the operating system to give more processing time to the applications. You can use the slider to change the priority. If you want to give your app a higher priority than the default one (middle position), you will need to enter the root password below. </para> +<para>Check this option to run with a different priority. A higher priority will tell the operating system to give more processing time to the applications. You can use the slider to change the priority. If you want to give your app a higher priority than the default one (middle position), you will need to enter the root password below. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Scheduler</guilabel -></term> +<term><guilabel>Scheduler</guilabel></term> <listitem> -<para ->The Scheduler is the part of the operating system which processes will run and which have to wait. Usually, an application will run with normal schedule, which means it can use the processing time it gets from the operating system, but you can also set it to <guilabel ->Realtime</guilabel ->. This means that the application has all the process time until it gives it away. You will need to enter the root password to use <guilabel ->Realtime</guilabel ->. </para> +<para>The Scheduler is the part of the operating system which processes will run and which have to wait. Usually, an application will run with normal schedule, which means it can use the processing time it gets from the operating system, but you can also set it to <guilabel>Realtime</guilabel>. This means that the application has all the process time until it gives it away. You will need to enter the root password to use <guilabel>Realtime</guilabel>. </para> <warning> -<para ->This can be dangerous. If the application hangs and can't give up the processor, the complete system might hang. </para> +<para>This can be dangerous. If the application hangs and can't give up the processor, the complete system might hang. </para> </warning> </listitem> @@ -1638,47 +808,29 @@ format="PNG"/></imageobject </sect1> <sect1 id="browsers"> -<title ->Browsers</title> +<title>Browsers</title> -<para ->This group contains some very useful browsers. It can also contain dynamic menus as described in the <link linkend="panel-menus" ->Menus</link -> section of &kicker;'s settings. </para> +<para>This group contains some very useful browsers. It can also contain dynamic menus as described in the <link linkend="panel-menus">Menus</link> section of &kicker;'s settings. </para> <variablelist> <varlistentry> -<term -><guisubmenu ->Quick Browser</guisubmenu -></term> +<term><guisubmenu>Quick Browser</guisubmenu></term> <listitem> -<para ->This submenu contains quick browsers for three very useful folders: home, root, and system configuration. </para> +<para>This submenu contains quick browsers for three very useful folders: home, root, and system configuration. </para> </listitem> </varlistentry> <varlistentry> -<term -><guisubmenu ->Recent Documents</guisubmenu -></term> +<term><guisubmenu>Recent Documents</guisubmenu></term> <listitem> -<para ->This menu shows the most recently used documents (works only with &kde; applications for the moment). Clicking the element <guimenuitem ->Clear History</guimenuitem -> will remove those entries, what may be useful for privacy reasons. </para> +<para>This menu shows the most recently used documents (works only with &kde; applications for the moment). Clicking the element <guimenuitem>Clear History</guimenuitem> will remove those entries, what may be useful for privacy reasons. </para> </listitem> </varlistentry> <varlistentry> -<term -><guisubmenu ->Bookmarks</guisubmenu -></term> +<term><guisubmenu>Bookmarks</guisubmenu></term> <listitem> -<para ->This submenu shows your personal bookmarks just like &konqueror; does. Refer to the &konqueror; Handbook for more help on this. </para> +<para>This submenu shows your personal bookmarks just like &konqueror; does. Refer to the &konqueror; Handbook for more help on this. </para> </listitem> </varlistentry> @@ -1687,156 +839,90 @@ format="PNG"/></imageobject </sect1> <sect1 id="application-group"> -<title ->The Application Group</title> +<title>The Application Group</title> -<para ->The submenus for application starting are located in this group. You can use &kmenuedit; to add, remove or move the entries. Applications will have a short description if the option <guilabel ->Detailed menu entries</guilabel -> is enabled in the settings. </para> +<para>The submenus for application starting are located in this group. You can use &kmenuedit; to add, remove or move the entries. Applications will have a short description if the option <guilabel>Detailed menu entries</guilabel> is enabled in the settings. </para> </sect1> <sect1 id="most-recently-group"> -<title ->The most recently used applications</title> +<title>The most recently used applications</title> -<para ->This group holds either the most recently or the most frequently used applications. See the <link linkend="panel-menus" ->Menus Configuration</link -> section for more about that. </para> +<para>This group holds either the most recently or the most frequently used applications. See the <link linkend="panel-menus">Menus Configuration</link> section for more about that. </para> </sect1> </chapter> <chapter id="applets"> -<title ->Applets</title> - -<para ->Applets are small applications running inside of &kicker;. Almost everything besides the <guiicon ->application starter buttons</guiicon -> are applets. They can be added from the <guimenu ->context menu</guimenu -> or from the submenu <guisubmenu ->Configure Panel</guisubmenu -> by choosing <guisubmenu ->Add</guisubmenu -> and the <guisubmenu ->Applet</guisubmenu ->. Every applet contains a small arrow in its handle. Clicking it will bring up a menu which lets you move or remove it, set the Preferences, if there are any and set the preferences of &kicker;. </para> +<title>Applets</title> + +<para>Applets are small applications running inside of &kicker;. Almost everything besides the <guiicon>application starter buttons</guiicon> are applets. They can be added from the <guimenu>context menu</guimenu> or from the submenu <guisubmenu>Configure Panel</guisubmenu> by choosing <guisubmenu>Add</guisubmenu> and the <guisubmenu>Applet</guisubmenu>. Every applet contains a small arrow in its handle. Clicking it will bring up a menu which lets you move or remove it, set the Preferences, if there are any and set the preferences of &kicker;. </para> <sect1 id="taskbar-applet"> -<title ->The Taskbar Applet</title> +<title>The Taskbar Applet</title> -<para ->The taskbar applet shows buttons for the running applications. The application, which has the focus, is shown as a pressed button. If an application is minimised, the title displayed in the taskbar will fade to grey. </para> +<para>The taskbar applet shows buttons for the running applications. The application, which has the focus, is shown as a pressed button. If an application is minimised, the title displayed in the taskbar will fade to grey. </para> <tip> -<para ->If you click on the button of the active application, it will be minimised. This means also that if you click twice on an inactive application, it will also be minimised. </para> +<para>If you click on the button of the active application, it will be minimised. This means also that if you click twice on an inactive application, it will also be minimised. </para> </tip> -<para ->A click with the &RMB; on a button will show the standard application menu. Only the entry <guimenuitem ->To current desktop</guimenuitem -> differs: if you have set the taskbar to show the applications of all desktops, you can move this app to the current desktop. </para> +<para>A click with the &RMB; on a button will show the standard application menu. Only the entry <guimenuitem>To current desktop</guimenuitem> differs: if you have set the taskbar to show the applications of all desktops, you can move this app to the current desktop. </para> -<para ->There is also a small icon on the left or top side of the taskbar, which opens a menu. This is called the <guibutton ->windows list icon</guibutton ->. The menu's first entry, <guimenuitem ->Unclutter Windows</guimenuitem ->, tries to move the windows on your active desktop in a way to see as many as possible. <guimenuitem ->Cascade Windows</guimenuitem -> puts all windows on the active desktop over each others, the most recently on top and the others sorted by the time they where last used. </para> +<para>There is also a small icon on the left or top side of the taskbar, which opens a menu. This is called the <guibutton>windows list icon</guibutton>. The menu's first entry, <guimenuitem>Unclutter Windows</guimenuitem>, tries to move the windows on your active desktop in a way to see as many as possible. <guimenuitem>Cascade Windows</guimenuitem> puts all windows on the active desktop over each others, the most recently on top and the others sorted by the time they where last used. </para> -<para ->Below those entries is a list of all currently running applications, grouped by the desktops on which they are running. Clicking on the name of a desktop will switch to that one, clicking an application will also activate it. You can specify the mouse behaviour. Please refer to <link linkend="taskbar-settings" ->Taskbar</link -> settings for more about that. </para> +<para>Below those entries is a list of all currently running applications, grouped by the desktops on which they are running. Clicking on the name of a desktop will switch to that one, clicking an application will also activate it. You can specify the mouse behaviour. Please refer to <link linkend="taskbar-settings">Taskbar</link> settings for more about that. </para> <sect2 id="configure-taskbar-applet"> -<title ->Configuring the Taskbar Applet</title> +<title>Configuring the Taskbar Applet</title> -<para ->You can configure the taskbar by clicking the &RMB; on the small move handle. </para> -<para ->Please refer to <xref linkend="taskbar-settings"/> for details about the preferences of the taskbar. </para> +<para>You can configure the taskbar by clicking the &RMB; on the small move handle. </para> +<para>Please refer to <xref linkend="taskbar-settings"/> for details about the preferences of the taskbar. </para> </sect2> </sect1> <sect1 id="pager-applet"> -<title ->The Mini-Pager Applet</title> +<title>The Mini-Pager Applet</title> -<para ->This little applet shows a preview of the desktops and lets you also choose by a click with the &LMB; which desktop you want to use. </para> +<para>This little applet shows a preview of the desktops and lets you also choose by a click with the &LMB; which desktop you want to use. </para> -<para ->There is also a very useful <guimenu ->context menu</guimenu ->: </para> +<para>There is also a very useful <guimenu>context menu</guimenu>: </para> <variablelist> <varlistentry> -<term -><guimenuitem ->Preview</guimenuitem -></term> +<term><guimenuitem>Preview</guimenuitem></term> <listitem> -<para ->This option lets the mini pager appear as a tiny preview of the desktops with symbolic rectangles for the running applications. </para> +<para>This option lets the mini pager appear as a tiny preview of the desktops with symbolic rectangles for the running applications. </para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Number</guimenuitem -></term> +<term><guimenuitem>Number</guimenuitem></term> <listitem> -<para ->If this option is chosen, the pager will show the numbers of the desktops </para> +<para>If this option is chosen, the pager will show the numbers of the desktops </para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Name</guimenuitem -></term> +<term><guimenuitem>Name</guimenuitem></term> <listitem> -<para ->This will let the pager show the names of the desktops, which can be set in the preferences or from <application ->Control Centre</application ->. </para> +<para>This will let the pager show the names of the desktops, which can be set in the preferences or from <application>Control Centre</application>. </para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Enable Desktop Preview</guimenuitem -></term> +<term><guimenuitem>Enable Desktop Preview</guimenuitem></term> <listitem> -<para ->If this option is checked, a small button will be shown which shows a bigger preview of the running desktops. If you click an application in that preview, it will be activated. </para> +<para>If this option is checked, a small button will be shown which shows a bigger preview of the running desktops. If you click an application in that preview, it will be activated. </para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Preferences</guimenuitem -></term> +<term><guimenuitem>Preferences</guimenuitem></term> <listitem> -<para ->Here you can set the number of desktops you want to have and the names of them. </para> +<para>Here you can set the number of desktops you want to have and the names of them. </para> </listitem> </varlistentry> @@ -1845,71 +931,48 @@ format="PNG"/></imageobject </sect1> <sect1 id="clock-applet"> -<title ->The Clock Applet</title> +<title>The Clock Applet</title> -<para ->As you might already guess, the clock applet is a small clock which resides in &kicker;. </para> +<para>As you might already guess, the clock applet is a small clock which resides in &kicker;. </para> -<para ->A click with the &LMB; on the clock will show a small calendar. You can use the <guibutton ->single arrows</guibutton -> to switch the months or the <guibutton ->double arrows</guibutton -> for switching years. This won't have any effect of your date settings, it's just for your information. </para> +<para>A click with the &LMB; on the clock will show a small calendar. You can use the <guibutton>single arrows</guibutton> to switch the months or the <guibutton>double arrows</guibutton> for switching years. This won't have any effect of your date settings, it's just for your information. </para> -<para ->There are some things you can do with the clock applet. This can be done from the <guimenu ->context menu</guimenu ->. </para> +<para>There are some things you can do with the clock applet. This can be done from the <guimenu>context menu</guimenu>. </para> <sect2 id="clock-type"> -<title -><guisubmenu ->Type</guisubmenu -></title> +<title><guisubmenu>Type</guisubmenu></title> -<para ->There are four ways the clock can appear: </para> +<para>There are four ways the clock can appear: </para> <variablelist> <varlistentry> -<term ->Plain</term> +<term>Plain</term> <listitem> -<para ->This lets the clock appear as a simple text that shows the time in plain text. </para> +<para>This lets the clock appear as a simple text that shows the time in plain text. </para> </listitem> </varlistentry> <varlistentry> -<term ->Digital</term> +<term>Digital</term> <listitem> -<para ->This lets the clock appear as a digital clock showing the time in the well known seven segment style. </para> +<para>This lets the clock appear as a digital clock showing the time in the well known seven segment style. </para> </listitem> </varlistentry> <varlistentry> -<term ->Analogue</term> +<term>Analogue</term> <listitem> -<para ->If this is set, the clock will be displayed as an old styled analogue clock. </para> +<para>If this is set, the clock will be displayed as an old styled analogue clock. </para> <note> -<para ->This may only be useful if you set &kicker; to normal or large size. </para> +<para>This may only be useful if you set &kicker; to normal or large size. </para> </note> </listitem> </varlistentry> <varlistentry> -<term ->Fuzzy</term> +<term>Fuzzy</term> <listitem> -<para ->This is a very unorthodox style of time display. Try it out, it is really funny! </para> +<para>This is a very unorthodox style of time display. Try it out, it is really funny! </para> </listitem> </varlistentry> </variablelist> @@ -1917,100 +980,45 @@ format="PNG"/></imageobject </sect2> <sect2 id="clock-preferences"> -<title -><guimenuitem ->Preferences</guimenuitem -></title> +<title><guimenuitem>Preferences</guimenuitem></title> -<para ->Here you can set some general preferences of the clock applet. </para> +<para>Here you can set some general preferences of the clock applet. </para> <variablelist> <varlistentry> -<term -><guilabel ->General</guilabel -></term> +<term><guilabel>General</guilabel></term> <listitem> -<para ->In the <guilabel ->Clock Type</guilabel -> settings you can choose between the clock styles like in the <guimenu ->context menu</guimenu ->. </para> +<para>In the <guilabel>Clock Type</guilabel> settings you can choose between the clock styles like in the <guimenu>context menu</guimenu>. </para> -<para ->The <guilabel ->Date</guilabel -> group lets you pick font and colour of the date, which is shown when activated for the specific clock type. </para> +<para>The <guilabel>Date</guilabel> group lets you pick font and colour of the date, which is shown when activated for the specific clock type. </para> </listitem> </varlistentry> <varlistentry> -<term ->The <guilabel ->Plain Clock</guilabel -> Tab</term> +<term>The <guilabel>Plain Clock</guilabel> Tab</term> <listitem> -<para ->In the <guilabel ->Options</guilabel -> section you can check if you want to have the date and/or the seconds shown. In <guilabel ->Colours</guilabel -> you can choose if you want the common &kde; look or your own custom colours and font. </para> +<para>In the <guilabel>Options</guilabel> section you can check if you want to have the date and/or the seconds shown. In <guilabel>Colours</guilabel> you can choose if you want the common &kde; look or your own custom colours and font. </para> </listitem> </varlistentry> <varlistentry> -<term ->The <guilabel ->Digital Clock</guilabel -> Tab</term> +<term>The <guilabel>Digital Clock</guilabel> Tab</term> <listitem> -<para ->In the <guilabel ->Options</guilabel -> section you can check if you want to have the date, the seconds and/or blinking dots shown. In <guilabel ->Colours</guilabel -> you can choose if you want the common <acronym ->LCD</acronym ->-Look or your own custom colours. </para> +<para>In the <guilabel>Options</guilabel> section you can check if you want to have the date, the seconds and/or blinking dots shown. In <guilabel>Colours</guilabel> you can choose if you want the common <acronym>LCD</acronym>-Look or your own custom colours. </para> </listitem> </varlistentry> <varlistentry> -<term ->The <guilabel ->Analogue Clock</guilabel -> Tab</term> +<term>The <guilabel>Analogue Clock</guilabel> Tab</term> <listitem> -<para ->In the <guilabel ->Options</guilabel -> section you can check if you want to have the date and/or seconds shown. In <guilabel ->Colours</guilabel -> you can choose if you want the common <acronym ->LCD</acronym ->-Look or your own custom colours. You can also set the level of antialiasing, which means that lines will get blurred a little bit to prevent steps in the drawing. High quality antialiasing may catch some system load on low-end systems. <guilabel ->Draw Frame</guilabel -> will display the clock a little bit sunken in the panel. </para> +<para>In the <guilabel>Options</guilabel> section you can check if you want to have the date and/or seconds shown. In <guilabel>Colours</guilabel> you can choose if you want the common <acronym>LCD</acronym>-Look or your own custom colours. You can also set the level of antialiasing, which means that lines will get blurred a little bit to prevent steps in the drawing. High quality antialiasing may catch some system load on low-end systems. <guilabel>Draw Frame</guilabel> will display the clock a little bit sunken in the panel. </para> </listitem> </varlistentry> <varlistentry> -<term ->The <guilabel ->Fuzzy Clock</guilabel -> Tab</term> +<term>The <guilabel>Fuzzy Clock</guilabel> Tab</term> <listitem> -<para ->In the <guilabel ->Options</guilabel -> section you can check if you want to have the date shown. There is also a slider to set the <guilabel ->Fuzziness</guilabel ->. This cannot be described in the documents, just do your own experiments. In <guilabel ->Colours</guilabel -> you can choose the colours and the font of the fuzzy clock. </para> +<para>In the <guilabel>Options</guilabel> section you can check if you want to have the date shown. There is also a slider to set the <guilabel>Fuzziness</guilabel>. This cannot be described in the documents, just do your own experiments. In <guilabel>Colours</guilabel> you can choose the colours and the font of the fuzzy clock. </para> </listitem> </varlistentry> @@ -2019,208 +1027,122 @@ format="PNG"/></imageobject </sect2> <sect2 id="adjust-time"> -<title -><guimenuitem ->Adjust Date and Time</guimenuitem -></title> +<title><guimenuitem>Adjust Date and Time</guimenuitem></title> -<para ->This option starts the <guilabel ->Country & Language</guilabel -> configuration module of the &kcontrol;.</para> +<para>This option starts the <guilabel>Country & Language</guilabel> configuration module of the &kcontrol;.</para> <note> -<para ->You will need the super user password for adjusting date and time. </para> +<para>You will need the super user password for adjusting date and time. </para> </note> </sect2> <sect2 id="date-format"> -<title -><guimenuitem ->Date and Time Format</guimenuitem -></title> +<title><guimenuitem>Date and Time Format</guimenuitem></title> -<para ->This will open the Date and Time module of &kcontrol; where you can set your formats. There aren't any special permissions needed for that. </para> +<para>This will open the Date and Time module of &kcontrol; where you can set your formats. There aren't any special permissions needed for that. </para> </sect2> <sect2 id="copy-date"> -<title -><guisubmenu ->Copy</guisubmenu -></title> +<title><guisubmenu>Copy</guisubmenu></title> -<para ->If you need to paste the actual date and/or time in another application (⪚ in a text editor), you can copy it to the clipboard with this function. After selecting one of the available formats, the actual date and/or time is placed in the clipboard using the appropriate format. </para> +<para>If you need to paste the actual date and/or time in another application (⪚ in a text editor), you can copy it to the clipboard with this function. After selecting one of the available formats, the actual date and/or time is placed in the clipboard using the appropriate format. </para> </sect2> </sect1> <sect1 id="launcher-applet"> -<title ->The Quick Launcher Applet</title> - -<para ->This is a compressed application launcher. It is very useful especially if the panel is set to normal or large size. You can add applications by drag and drop or from the <guimenu ->context menu</guimenu ->. The <guimenu ->context menu</guimenu -> is also used to remove an application. </para> +<title>The Quick Launcher Applet</title> + +<para>This is a compressed application launcher. It is very useful especially if the panel is set to normal or large size. You can add applications by drag and drop or from the <guimenu>context menu</guimenu>. The <guimenu>context menu</guimenu> is also used to remove an application. </para> </sect1> <sect1 id="systemtray-applet"> -<title ->The System Tray Applet</title> +<title>The System Tray Applet</title> -<para ->The System Tray is used to dock some special applications like ⪚ &klipper; or &kteatime;. </para> +<para>The System Tray is used to dock some special applications like ⪚ &klipper; or &kteatime;. </para> </sect1> <sect1 id="lockout-applet"> -<title ->Lock/Logout Applet</title> -<para ->This little applet contains two buttons. The <guibutton ->luggage lock</guibutton -> is used to lock the session if you ever want to leave your &kde; unattended and don't want anybody to access it. The <guibutton ->off switch</guibutton -> is used to close your &kde; session. </para> +<title>Lock/Logout Applet</title> +<para>This little applet contains two buttons. The <guibutton>luggage lock</guibutton> is used to lock the session if you ever want to leave your &kde; unattended and don't want anybody to access it. The <guibutton>off switch</guibutton> is used to close your &kde; session. </para> </sect1> <sect1 id="run-applet"> -<title ->The Application Launcher Applet</title> +<title>The Application Launcher Applet</title> -<para ->This applet provides a simple command line embedded in &kicker;. Nothing more, nothing less. </para> +<para>This applet provides a simple command line embedded in &kicker;. Nothing more, nothing less. </para> </sect1> <sect1 id="naughty-applet"> -<title ->The Runaway Process Catcher Applet</title> +<title>The Runaway Process Catcher Applet</title> -<para ->This applet shows a smiley which will get angry when any process catches up too much system resources. If an application uses too much, a messagebox will appear and ask you how to handle that application. </para> +<para>This applet shows a smiley which will get angry when any process catches up too much system resources. If an application uses too much, a messagebox will appear and ask you how to handle that application. </para> -<para ->Clicking it with the &LMB; will show a configuration dialogue. Here you can set the <guilabel ->Update interval</guilabel ->, which is set in seconds, and the <guilabel ->CPU load threshold</guilabel ->. At the moment, there is no real advice for setting this up, you will have to do some experimenting. These settings will probably change in a future release. There is also a section <guilabel ->Programs to ignore</guilabel -> where you can add applications that use many resources naturally, ⪚ compilers or 3D renderers. </para> +<para>Clicking it with the &LMB; will show a configuration dialogue. Here you can set the <guilabel>Update interval</guilabel>, which is set in seconds, and the <guilabel>CPU load threshold</guilabel>. At the moment, there is no real advice for setting this up, you will have to do some experimenting. These settings will probably change in a future release. There is also a section <guilabel>Programs to ignore</guilabel> where you can add applications that use many resources naturally, ⪚ compilers or 3D renderers. </para> </sect1> <sect1 id="klipper-applet"> -<title ->&klipper; Applet</title> +<title>&klipper; Applet</title> -<para ->This applet does exactly the same like the &klipper; residing in the system tray. It has the advantage, that it consumes a little bit less system resources, which only matters on really slow systems, but has the disadvantage, that it uses more space than &klipper; in the system tray. You can read more about that in the manual for <ulink url="help:/klipper/index.html" ->&klipper;</ulink -> </para> +<para>This applet does exactly the same like the &klipper; residing in the system tray. It has the advantage, that it consumes a little bit less system resources, which only matters on really slow systems, but has the disadvantage, that it uses more space than &klipper; in the system tray. You can read more about that in the manual for <ulink url="help:/klipper/index.html">&klipper;</ulink> </para> </sect1> </chapter> <chapter id="extensions"> -<title ->Extensions</title> - -<para ->There are also some features that run outside of &kicker;, the extensions. They are added from the submenu <guisubmenu ->Configure Panel</guisubmenu -> of the <guimenu ->K</guimenu -> Menu or the <guimenu ->context menu</guimenu -> by choosing <guisubmenu ->Add</guisubmenu -> and then <guisubmenu ->Extensions</guisubmenu ->. You can move them to any screenborder by dragging them at the small <guibutton ->fadeout </guibutton -> on their side and remove it by right clicking on that button and choose <guimenuitem ->Remove</guimenuitem ->. Clicking these buttons with the &LMB; fades the extension out or in, just like the main &kicker;. </para> - -<para ->The style of the extensions can be configured in the <xref linkend="panel-extensions"/> section of &kicker;'s preferences. </para> +<title>Extensions</title> + +<para>There are also some features that run outside of &kicker;, the extensions. They are added from the submenu <guisubmenu>Configure Panel</guisubmenu> of the <guimenu>K</guimenu> Menu or the <guimenu>context menu</guimenu> by choosing <guisubmenu>Add</guisubmenu> and then <guisubmenu>Extensions</guisubmenu>. You can move them to any screenborder by dragging them at the small <guibutton>fadeout </guibutton> on their side and remove it by right clicking on that button and choose <guimenuitem>Remove</guimenuitem>. Clicking these buttons with the &LMB; fades the extension out or in, just like the main &kicker;. </para> + +<para>The style of the extensions can be configured in the <xref linkend="panel-extensions"/> section of &kicker;'s preferences. </para> <sect1 id="external-taskbar-extension"> -<title ->The External Taskbar Extension</title> +<title>The External Taskbar Extension</title> -<para ->The external taskbar is just the same as the taskbar applet with the only difference that it provides its own panel. Refer to the <link linkend="taskbar-applet" ->taskbar applet section</link -> for help about it. </para> +<para>The external taskbar is just the same as the taskbar applet with the only difference that it provides its own panel. Refer to the <link linkend="taskbar-applet">taskbar applet section</link> for help about it. </para> </sect1> <sect1 id="child-panel-extension"> -<title ->The Child Panel Extension</title> +<title>The Child Panel Extension</title> -<para ->This is just a panel like &kicker; itself, where you can add all the stuff &kicker; is also capable. So you can have as many &kicker;s as you want. Just add a child panel and add applications and applets to it. </para> +<para>This is just a panel like &kicker; itself, where you can add all the stuff &kicker; is also capable. So you can have as many &kicker;s as you want. Just add a child panel and add applications and applets to it. </para> </sect1> <sect1 id="kasbar-extension"> -<title ->The <application ->KasBar</application -> Extension</title> - -<para ->The <application ->KasBar</application -> is an iconic replacement of the taskbar. It always shows the icons of all currently running applications on any desktop, they can be chosen by clicking with the &LMB;. The active window is highlighted, minimised windows will show a little triangle pointing downwards instead of the square in the lower right of the icons. A triangle pointing to the right indicates that the application is shaded. </para> +<title>The <application>KasBar</application> Extension</title> + +<para>The <application>KasBar</application> is an iconic replacement of the taskbar. It always shows the icons of all currently running applications on any desktop, they can be chosen by clicking with the &LMB;. The active window is highlighted, minimised windows will show a little triangle pointing downwards instead of the square in the lower right of the icons. A triangle pointing to the right indicates that the application is shaded. </para> </sect1> <sect1 id="dock-application-bar-extension"> -<title ->The Dock Application Bar Extension</title> +<title>The Dock Application Bar Extension</title> -<para ->The Dock Application Bar is an external bar which lets WindowMaker applications be docked. Just run your dockable WindowMaker programs, if the Dock Application Bar is running, they will be automatically docked. </para> +<para>The Dock Application Bar is an external bar which lets WindowMaker applications be docked. Just run your dockable WindowMaker programs, if the Dock Application Bar is running, they will be automatically docked. </para> </sect1> </chapter> <chapter id="commands"> -<title ->Command Reference</title> +<title>Command Reference</title> <sect1 id="keybinding"> -<title ->The Panel</title> +<title>The Panel</title> -<para ->There is only one standard shortcut available in &kicker;: </para> +<para>There is only one standard shortcut available in &kicker;: </para> <variablelist> <varlistentry> -<term -><keycombo action="simul" ->&Alt;<keycap ->F1</keycap -></keycombo -></term> +<term><keycombo action="simul">&Alt;<keycap>F1</keycap></keycombo></term> <listitem> -<para ->Opens the <guimenu ->K</guimenu -> Menu </para> +<para>Opens the <guimenu>K</guimenu> Menu </para> </listitem> </varlistentry> </variablelist> @@ -2230,182 +1152,107 @@ format="PNG"/></imageobject </chapter> <chapter id="faq"> -<title ->Questions and Answers</title> +<title>Questions and Answers</title> <qandaset> <qandaentry> <question> -<para ->How can I add applications, applets or anything else to the panel? </para> +<para>How can I add applications, applets or anything else to the panel? </para> </question> <answer> -<para ->Click the &RMB; on any free space in &kicker; and choose <guisubmenu ->Add</guisubmenu ->. From appearing submenu you can choose, what you want to add. See in <link linkend="basics" ->Kicker Basics</link -> for more about that. </para> +<para>Click the &RMB; on any free space in &kicker; and choose <guisubmenu>Add</guisubmenu>. From appearing submenu you can choose, what you want to add. See in <link linkend="basics">Kicker Basics</link> for more about that. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->Can I have an external Taskbar just like in &kde; 1? </para> +<para>Can I have an external Taskbar just like in &kde; 1? </para> </question> <answer> -<para ->Yes, you can just click the &RMB; on any empty space in &kicker; and then choose <guisubmenu ->Add</guisubmenu ->, <guisubmenu ->Extension</guisubmenu -> and the <guimenuitem ->External Taskbar</guimenuitem ->. </para> +<para>Yes, you can just click the &RMB; on any empty space in &kicker; and then choose <guisubmenu>Add</guisubmenu>, <guisubmenu>Extension</guisubmenu> and the <guimenuitem>External Taskbar</guimenuitem>. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->How can I move &kicker; to another screen border? </para> +<para>How can I move &kicker; to another screen border? </para> </question> <answer> -<para ->Simply drag it by holding the &LMB; on any empty space in &kicker; to any screen border. </para> +<para>Simply drag it by holding the &LMB; on any empty space in &kicker; to any screen border. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->How can I move extensions to another screen border? </para> +<para>How can I move extensions to another screen border? </para> </question> <answer> -<para ->Just drag it by holding the &LMB; on the small <guibutton ->handles</guibutton -> on the left or the top of the extension. </para> +<para>Just drag it by holding the &LMB; on the small <guibutton>handles</guibutton> on the left or the top of the extension. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->I want the taskbar to show all applications I'm running, independent on which desktop it is. Is that possible? </para> +<para>I want the taskbar to show all applications I'm running, independent on which desktop it is. Is that possible? </para> </question> <answer> -<para ->Yes, click the &RMB; on the small <guibutton ->handle</guibutton -> of the taskbar, then choose <guimenuitem ->Preferences</guimenuitem -> and check <guilabel ->Show all windows</guilabel -> in the appearing dialogue. </para> +<para>Yes, click the &RMB; on the small <guibutton>handle</guibutton> of the taskbar, then choose <guimenuitem>Preferences</guimenuitem> and check <guilabel>Show all windows</guilabel> in the appearing dialogue. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->How can I access the <guimenu ->K</guimenu -> Menu without using the mouse? </para> +<para>How can I access the <guimenu>K</guimenu> Menu without using the mouse? </para> </question> <answer> -<para ->Simply press <keycombo action="simul" ->&Alt;<keycap ->F1</keycap -></keycombo -> and it will appear. </para> +<para>Simply press <keycombo action="simul">&Alt;<keycap>F1</keycap></keycombo> and it will appear. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->Is there a way to add a menu containing all desktop icons to &kicker;? </para> +<para>Is there a way to add a menu containing all desktop icons to &kicker;? </para> </question> <answer> -<para ->Just fire up &konqueror;, go to your home folder and drag the <guiicon ->KDesktop</guiicon -> icon to any free space of &kicker;, then choose <guimenuitem ->Add as Quick Browser</guimenuitem -> from the appearing menu. </para> +<para>Just fire up &konqueror;, go to your home folder and drag the <guiicon>KDesktop</guiicon> icon to any free space of &kicker;, then choose <guimenuitem>Add as Quick Browser</guimenuitem> from the appearing menu. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->How can I change the colour and style of &kicker;? </para> +<para>How can I change the colour and style of &kicker;? </para> </question> <answer> -<para ->You can change the colours of the panel with the global colour module of the <application ->Control Centre</application -> or you can style the panel itself, see in <xref linkend="panel-looknfeel"/> for more about that. </para> +<para>You can change the colours of the panel with the global colour module of the <application>Control Centre</application> or you can style the panel itself, see in <xref linkend="panel-looknfeel"/> for more about that. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->Why is the clock showing the wrong time? </para> +<para>Why is the clock showing the wrong time? </para> </question> <answer> -<para ->On some &RedHat;systems, the clock always shows the time in <acronym ->GMT</acronym ->. This is a bug in the system setup, and not directly related to &kicker;. However, to solve it, just create this symbolic link: <userinput -><command ->ln</command -> <option ->-s</option -> <filename ->/usr/share/zoneinfo</filename -> <filename ->/usr/lib/zoneinfo</filename -></userinput ->. </para> +<para>On some &RedHat;systems, the clock always shows the time in <acronym>GMT</acronym>. This is a bug in the system setup, and not directly related to &kicker;. However, to solve it, just create this symbolic link: <userinput><command>ln</command> <option>-s</option> <filename>/usr/share/zoneinfo</filename> <filename>/usr/lib/zoneinfo</filename></userinput>. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->Is it possible to change the <guiicon ->K</guiicon -> button of the panel to another picture? </para> +<para>Is it possible to change the <guiicon>K</guiicon> button of the panel to another picture? </para> </question> <answer> -<para ->Look for <filename ->$HOME/.trinity/share/apps/kicker/pics/go.png</filename -> and <filename ->$HOME/.trinity/share/apps/kicker/pics/mini/go.png</filename -> and replace them. Do not forget to flatten the replacements to one layer, or else you will not see anything. Create the folders if they do not already exist. Then restart &kicker;. </para> +<para>Look for <filename>$HOME/.trinity/share/apps/kicker/pics/go.png</filename> and <filename>$HOME/.trinity/share/apps/kicker/pics/mini/go.png</filename> and replace them. Do not forget to flatten the replacements to one layer, or else you will not see anything. Create the folders if they do not already exist. Then restart &kicker;. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->Why is my <guisubmenu ->Settings</guisubmenu -> menu not working? </para> +<para>Why is my <guisubmenu>Settings</guisubmenu> menu not working? </para> </question> <answer> -<para ->Your menu entries may be mixed up for some reason. Simply run <command ->tdebuildsycoca</command -> on a commandline. </para> +<para>Your menu entries may be mixed up for some reason. Simply run <command>tdebuildsycoca</command> on a commandline. </para> </answer> </qandaentry> </qandaset> @@ -2413,52 +1260,40 @@ format="PNG"/></imageobject <chapter id="credits"> -<title ->Credits and Licence</title> +<title>Credits and Licence</title> -<para ->&kicker; </para> +<para>&kicker; </para> -<para ->Program copyright 1999-2000 The KDE Team <ulink url="http://www.kde.org" -> (www.kde.org)</ulink ->. </para> +<para>Program copyright 1999-2000 The KDE Team <ulink url="http://www.kde.org"> (www.kde.org)</ulink>. </para> <itemizedlist> <listitem> -<para ->&Matthias.Elter; &Matthias.Elter.mail; </para> +<para>&Matthias.Elter; &Matthias.Elter.mail; </para> </listitem> <listitem> -<para ->&Matthias.Ettrich; &Matthias.Ettrich.mail; </para> +<para>&Matthias.Ettrich; &Matthias.Ettrich.mail; </para> </listitem> <listitem> -<para ->&Wilco.Greven; &Wilco.Greven.mail; </para> +<para>&Wilco.Greven; &Wilco.Greven.mail; </para> </listitem> <listitem> -<para ->&Rik.Hemsley; &Rik.Hemsley.mail; </para> +<para>&Rik.Hemsley; &Rik.Hemsley.mail; </para> </listitem> <listitem> -<para ->&Daniel.M.Duley; &Daniel.M.Duley.mail; </para> +<para>&Daniel.M.Duley; &Daniel.M.Duley.mail; </para> </listitem> <listitem> -<para ->&Preston.Brown; &Preston.Brown.mail; </para> +<para>&Preston.Brown; &Preston.Brown.mail; </para> </listitem> </itemizedlist> -<para ->Documentation copyright 2001, 2002 &Dirk.Doerflinger; &Dirk.Doerflinger.mail;</para> +<para>Documentation copyright 2001, 2002 &Dirk.Doerflinger; &Dirk.Doerflinger.mail;</para> &underFDL; &underBSDLicense; </chapter> &documentation.index; diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/devices/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/devices/index.docbook index af32239a9b1..f41d740c669 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/devices/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/devices/index.docbook @@ -2,81 +2,44 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title ->Device Information</title> +<title>Device Information</title> <articleinfo> <authorgroup> -<author ->&Matthias.Hoelzer-Kluepfel;</author> -<author ->&Helge.Deller;</author> -<author ->&Duncan.Haldane;</author> -<author ->&Mike.McBride;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Matthias.Hoelzer-Kluepfel;</author> +<author>&Helge.Deller;</author> +<author>&Duncan.Haldane;</author> +<author>&Mike.McBride;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->device</keyword> -<keyword ->system information</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>device</keyword> +<keyword>system information</keyword> </keywordset> </articleinfo> <sect1> -<title ->Device Information</title> +<title>Device Information</title> -<para ->This page displays information about the available devices, </para> +<para>This page displays information about the available devices, </para> <note> -<para ->The exact information displayed is system-dependent. On some systems, device information cannot be displayed yet. </para> +<para>The exact information displayed is system-dependent. On some systems, device information cannot be displayed yet. </para> </note> -<para ->On &Linux;, this information is read from <filename class="devicefile" ->/proc/devices</filename -> and <filename class="devicefile" ->/proc/misc</filename ->, which are only available if the <filename class="directory" ->/proc</filename -> pseudo-filesystem is compiled into the kernel. Devices are listed by group (Character, Block, or Miscellaneous). The device major number is listed, followed by an identifying label. </para> +<para>On &Linux;, this information is read from <filename class="devicefile">/proc/devices</filename> and <filename class="devicefile">/proc/misc</filename>, which are only available if the <filename class="directory">/proc</filename> pseudo-filesystem is compiled into the kernel. Devices are listed by group (Character, Block, or Miscellaneous). The device major number is listed, followed by an identifying label. </para> -<para ->The user cannot modify any settings on this page. </para> +<para>The user cannot modify any settings on this page. </para> </sect1> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/dma/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/dma/index.docbook index 50832841ba1..e5d6b30d0cc 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/dma/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/dma/index.docbook @@ -2,107 +2,46 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title -><acronym ->DMA</acronym -> Channel Information</title> +<title><acronym>DMA</acronym> Channel Information</title> <articleinfo> <authorgroup> -<author ->&Matthias.Hoelzer-Kluepfel;</author> -<author ->&Helge.Deller;</author> -<author ->&Duncan.Haldane;</author> -<author ->&Mike.McBride;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Matthias.Hoelzer-Kluepfel;</author> +<author>&Helge.Deller;</author> +<author>&Duncan.Haldane;</author> +<author>&Mike.McBride;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->DMA</keyword> -<keyword ->system information</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>DMA</keyword> +<keyword>system information</keyword> </keywordset> </articleinfo> <sect1> -<title -><acronym ->DMA</acronym -> Channel Information</title> +<title><acronym>DMA</acronym> Channel Information</title> -<para ->This page displays information about the <acronym ->DMA</acronym -> (Direct Memory Access) Channels. A <acronym ->DMA</acronym -> channel is a direct connection that allows devices to transfer data to and from memory without going through the processor. Typically, i386-architecture systems (<acronym ->PC</acronym ->'s) have eight <acronym ->DMA</acronym -> channels (0-7). </para> +<para>This page displays information about the <acronym>DMA</acronym> (Direct Memory Access) Channels. A <acronym>DMA</acronym> channel is a direct connection that allows devices to transfer data to and from memory without going through the processor. Typically, i386-architecture systems (<acronym>PC</acronym>'s) have eight <acronym>DMA</acronym> channels (0-7). </para> -<note -> <para ->The exact information displayed is system-dependent. On some systems, <acronym ->DMA</acronym -> Channel information cannot be displayed yet. </para -> </note> +<note> <para>The exact information displayed is system-dependent. On some systems, <acronym>DMA</acronym> Channel information cannot be displayed yet. </para> </note> -<para ->On &Linux;, this information is read from <filename class="devicefile" ->/proc/dma</filename ->, which is only available if the <filename class="directory" ->/proc</filename -> pseudo-filesystem is compiled into the kernel. </para> +<para>On &Linux;, this information is read from <filename class="devicefile">/proc/dma</filename>, which is only available if the <filename class="directory">/proc</filename> pseudo-filesystem is compiled into the kernel. </para> -<para ->A list of all currently-registered (<acronym ->ISA</acronym -> bus) <acronym ->DMA</acronym -> channels that are in use is shown. The first column shows the <acronym ->DMA</acronym -> channel, and the second column shows the device which uses that channel. </para> +<para>A list of all currently-registered (<acronym>ISA</acronym> bus) <acronym>DMA</acronym> channels that are in use is shown. The first column shows the <acronym>DMA</acronym> channel, and the second column shows the device which uses that channel. </para> -<para ->Unused <acronym ->DMA</acronym -> channels are not listed. </para> +<para>Unused <acronym>DMA</acronym> channels are not listed. </para> -<para ->The user cannot modify any settings on this page. </para> +<para>The user cannot modify any settings on this page. </para> </sect1> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/index.docbook index f3659e6b590..4a86a640893 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/index.docbook @@ -1,213 +1,113 @@ <?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ -<!ENTITY infocenter "<application ->KInfoCenter</application ->"> +<!ENTITY infocenter "<application>KInfoCenter</application>"> <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <book lang="&language;"> <bookinfo> -<title ->The &infocenter;</title> +<title>The &infocenter;</title> <authorgroup> -<author -><firstname ->Michael</firstname -> <surname ->McBride</surname -> <affiliation -><address -><email ->mpmcbride7@yahoo.com</email -></address -></affiliation> +<author><firstname>Michael</firstname> <surname>McBride</surname> <affiliation><address><email>mpmcbride7@yahoo.com</email></address></affiliation> </author> </authorgroup> -<date ->2002-07-03</date> -<releaseinfo ->3.10.00</releaseinfo> +<date>2002-07-03</date> +<releaseinfo>3.10.00</releaseinfo> <abstract> -<para ->This documentation describes &kde;'s information centre.</para> +<para>This documentation describes &kde;'s information centre.</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->kinfocenter</keyword> -<keyword ->system</keyword> -<keyword ->information</keyword> -<keyword ->module</keyword> +<keyword>KDE</keyword> +<keyword>kinfocenter</keyword> +<keyword>system</keyword> +<keyword>information</keyword> +<keyword>module</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->The &infocenter;</title> +<title>The &infocenter;</title> -<para ->The &infocenter; (from now on referred to simply as <quote ->the information centre</quote ->) provides you with a centralised and convenient overview of your &kde; and system settings. </para> +<para>The &infocenter; (from now on referred to simply as <quote>the information centre</quote>) provides you with a centralised and convenient overview of your &kde; and system settings. </para> -<para ->The information centre is made up of multiple modules. Each module is a separate application, but the information centre organises all of these programs into a convenient location. </para> +<para>The information centre is made up of multiple modules. Each module is a separate application, but the information centre organises all of these programs into a convenient location. </para> </chapter> <chapter id="info-center"> -<title ->Using The &infocenter;</title> +<title>Using The &infocenter;</title> -<para ->This next section details the use of the information centre itself. For information on individual modules, please see <link linkend="module" ->Info Centre Modules</link -> </para> +<para>This next section details the use of the information centre itself. For information on individual modules, please see <link linkend="module">Info Centre Modules</link> </para> <sect1 id="information-center-starting"> -<title ->Starting the &infocenter;</title> +<title>Starting the &infocenter;</title> -<para ->The &infocenter; can be started 3 ways: </para> +<para>The &infocenter; can be started 3 ways: </para> -<orderedlist -> +<orderedlist> <listitem> -<para ->By selecting <menuchoice -><guimenu ->K Button</guimenu -><guisubmenu ->System</guisubmenu -><guimenuitem ->Info Centre</guimenuitem -></menuchoice -> from the &kde; Panel. </para> +<para>By selecting <menuchoice><guimenu>K Button</guimenu><guisubmenu>System</guisubmenu><guimenuitem>Info Centre</guimenuitem></menuchoice> from the &kde; Panel. </para> </listitem> <listitem> -<para ->By pressing <keycombo action="simul" ->&Alt;<keycap ->F2</keycap -></keycombo ->. </para> - -<para ->This will bring up a dialogue box. Type <userinput -><command ->kinfocenter</command -></userinput ->, and click <guibutton ->Run</guibutton -> or press <keycap ->Enter</keycap ->. </para> +<para>By pressing <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>. </para> + +<para>This will bring up a dialogue box. Type <userinput><command>kinfocenter</command></userinput>, and click <guibutton>Run</guibutton> or press <keycap>Enter</keycap>. </para> </listitem> <listitem> -<para ->You can type <command ->kinfocenter &</command -> at any command prompt. </para> -</listitem -> -</orderedlist -> - -<para ->All three of these methods are equivalent, and produce the same result. </para> +<para>You can type <command>kinfocenter &</command> at any command prompt. </para> +</listitem> +</orderedlist> + +<para>All three of these methods are equivalent, and produce the same result. </para> </sect1> -<sect1 id="information-center-screen" -> -<title ->The &infocenter; Screen</title> +<sect1 id="information-center-screen"> +<title>The &infocenter; Screen</title> -<para ->When you start the information centre, you are presented with a window, which can be divided into 3 functional parts. </para> +<para>When you start the information centre, you are presented with a window, which can be divided into 3 functional parts. </para> -<para ->Across the top is a menubar. The menubar will provide you with quick access to most of &infocenter;'s features. The menus are detailed in <link linkend="info-center-menus" ->The &kde; Info Centre Menus</link ->. </para> +<para>Across the top is a menubar. The menubar will provide you with quick access to most of &infocenter;'s features. The menus are detailed in <link linkend="info-center-menus">The &kde; Info Centre Menus</link>. </para> -<para ->Along the left hand side, is a column. This is a where you choose which module to investigate. You can learn how to navigate through the modules in the section called <link linkend="module-intro" ->Navigating Modules</link ->. </para> +<para>Along the left hand side, is a column. This is a where you choose which module to investigate. You can learn how to navigate through the modules in the section called <link linkend="module-intro">Navigating Modules</link>. </para> -<para ->The main panel shows you some system information. </para> +<para>The main panel shows you some system information. </para> <!-- <para> In this example, we are running &kde; 2.99, we started &infocenter; -as user <systemitem class="username" ->adridg</systemitem ->, the computer is -named <systemitem class="systemname" ->aramis</systemitem ->, it is a +as user <systemitem class="username">adridg</systemitem>, the computer is +named <systemitem class="systemname">aramis</systemitem>, it is a FreeBSD system, Version 4.4-RELEASE, on a Pentium. -</para -> --> +</para> --> </sect1> <sect1 id="info-center-menus"> -<title ->The &infocenter; Menus</title> +<title>The &infocenter; Menus</title> -<para ->This next section gives you a brief description of what each menu item does. </para> +<para>This next section gives you a brief description of what each menu item does. </para> <sect2 id="info-center-menu-file"> -<title -><guimenu ->File</guimenu -> Menu</title> +<title><guimenu>File</guimenu> Menu</title> -<para ->The <guimenu ->File</guimenu -> menu has a single entry. </para> +<para>The <guimenu>File</guimenu> menu has a single entry. </para> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->Q</keycap -></keycombo -> </shortcut -> <guimenu ->File</guimenu -> <guimenuitem ->Quit</guimenuitem -> </menuchoice -></term> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem> </menuchoice></term> <listitem> <para> -<action ->Closes the info centre.</action> +<action>Closes the info centre.</action> </para> </listitem> </varlistentry> @@ -216,47 +116,27 @@ FreeBSD system, Version 4.4-RELEASE, on a Pentium. </sect2> <sect2 id="info-center-menu-help"> -<title -><guimenu ->Help</guimenu -> Menu</title> +<title><guimenu>Help</guimenu> Menu</title> &help.menu.documentation; </sect2> </sect1> <sect1 id="info-center-exiting"> -<title ->Exiting The &kde; Information Centre</title> +<title>Exiting The &kde; Information Centre</title> -<para ->You can exit the info centre one of three ways: </para> +<para>You can exit the info centre one of three ways: </para> <itemizedlist> <listitem> -<para ->Select <menuchoice -><guimenu ->File</guimenu -> <guimenuitem ->Quit</guimenuitem -></menuchoice -> from the menu bar. </para> +<para>Select <menuchoice><guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem></menuchoice> from the menu bar. </para> </listitem> <listitem> -<para ->Type <keycombo action="simul" ->&Ctrl;<keycap ->Q</keycap -></keycombo -> on the keyboard. </para> +<para>Type <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> on the keyboard. </para> </listitem> <listitem> -<para ->Click on the <guiicon ->Close</guiicon -> button on the frame surrounding the info centre. </para> +<para>Click on the <guiicon>Close</guiicon> button on the frame surrounding the info centre. </para> </listitem> </itemizedlist> @@ -267,116 +147,61 @@ FreeBSD system, Version 4.4-RELEASE, on a Pentium. <!--*****************************************************************--> <chapter id="module"> -<title ->The &infocenter; Modules</title> +<title>The &infocenter; Modules</title> <sect1 id="module-intro"> -<title ->Navigating Modules</title> +<title>Navigating Modules</title> -<para ->This is a list of the <emphasis ->standard</emphasis -> configuration modules (sorted by category) provided by the <application role="package" ->&kde; base</application -> package. Please note that there may be many more modules on your system if you have installed additional software. </para> +<para>This is a list of the <emphasis>standard</emphasis> configuration modules (sorted by category) provided by the <application role="package">&kde; base</application> package. Please note that there may be many more modules on your system if you have installed additional software. </para> <itemizedlist> <listitem> -<para -><ulink url="help:/kinfocenter/dma/index.html" ->DMA-Channels</ulink -></para> +<para><ulink url="help:/kinfocenter/dma/index.html">DMA-Channels</ulink></para> </listitem> <listitem> -<para -><ulink url="help:/kinfocenter/devices/index.html" ->Devices</ulink -></para> +<para><ulink url="help:/kinfocenter/devices/index.html">Devices</ulink></para> </listitem> <listitem> -<para -><ulink url="help:/kinfocenter/ioports/index.html" ->IO-Ports</ulink -></para> +<para><ulink url="help:/kinfocenter/ioports/index.html">IO-Ports</ulink></para> </listitem> <listitem> -<para -><ulink url="help:/kinfocenter/interrupts/index.html" ->Interrupts</ulink -></para> +<para><ulink url="help:/kinfocenter/interrupts/index.html">Interrupts</ulink></para> </listitem> <listitem> -<para -><ulink url="help:/kinfocenter/memory/index.html" ->Memory</ulink -></para> +<para><ulink url="help:/kinfocenter/memory/index.html">Memory</ulink></para> </listitem> <listitem> -<para -><ulink url="help:/kinfocenter/nics/index.html" ->Network Interfaces</ulink -></para> +<para><ulink url="help:/kinfocenter/nics/index.html">Network Interfaces</ulink></para> </listitem> <listitem> -<para -><ulink url="help:/kinfocenter/pci/index.html" ->PCI</ulink -></para> +<para><ulink url="help:/kinfocenter/pci/index.html">PCI</ulink></para> </listitem> <listitem> -<para -><ulink url="help:/kinfocenter/pcmcia/index.html" ->PCMCIA</ulink -></para> +<para><ulink url="help:/kinfocenter/pcmcia/index.html">PCMCIA</ulink></para> </listitem> <listitem> -<para -><ulink url="help:/kinfocenter/partitions/index.html" ->Partitions</ulink -></para> +<para><ulink url="help:/kinfocenter/partitions/index.html">Partitions</ulink></para> </listitem> <listitem> -<para -><ulink url="help:/kinfocenter/processor/index.html" ->Processor</ulink -></para> +<para><ulink url="help:/kinfocenter/processor/index.html">Processor</ulink></para> </listitem> <listitem> -<para -><ulink url="help:/kinfocenter/protocols/index.html" ->Protocols</ulink -></para> +<para><ulink url="help:/kinfocenter/protocols/index.html">Protocols</ulink></para> </listitem> <listitem> -<para -><ulink url="help:/kinfocenter/scsi/index.html" ->SCSI</ulink -></para> +<para><ulink url="help:/kinfocenter/scsi/index.html">SCSI</ulink></para> </listitem> <listitem> -<para -><ulink url="help:/kinfocenter/samba/index.html" ->Samba Status Information</ulink -></para> +<para><ulink url="help:/kinfocenter/samba/index.html">Samba Status Information</ulink></para> </listitem> <listitem> -<para -><ulink url="help:/kinfocenter/sound/index.html" ->Sound</ulink -></para> +<para><ulink url="help:/kinfocenter/sound/index.html">Sound</ulink></para> </listitem> <listitem> -<para -><ulink url="help:/kinfocenter/usb/index.html" ->USB Devices</ulink -></para> +<para><ulink url="help:/kinfocenter/usb/index.html">USB Devices</ulink></para> </listitem> <listitem> -<para -><ulink url="help:/kinfocenter/xserver/index.html" ->X-Server</ulink -></para> +<para><ulink url="help:/kinfocenter/xserver/index.html">X-Server</ulink></para> </listitem> </itemizedlist> @@ -387,125 +212,39 @@ FreeBSD system, Version 4.4-RELEASE, on a Pentium. </chapter> <chapter id="credits"> -<title ->Credits and Licence</title> +<title>Credits and Licence</title> -<para ->&infocenter;</para> -<para ->Program copyright 1997-2001 The &infocenter; Developers</para> -<para ->Contributors:</para> +<para>&infocenter;</para> +<para>Program copyright 1997-2001 The &infocenter; Developers</para> +<para>Contributors:</para> <itemizedlist> -<listitem -><para ->Matthias Hoelzer-Kluepfel <email ->hoelzer@kde.org</email -></para -></listitem> -<listitem -><para ->Matthias Elter <email ->elter@kde.org</email -></para -></listitem> +<listitem><para>Matthias Hoelzer-Kluepfel <email>hoelzer@kde.org</email></para></listitem> +<listitem><para>Matthias Elter <email>elter@kde.org</email></para></listitem> </itemizedlist> -<para ->Documentation <trademark class="copyright" ->copyright 2000 Michael McBride</trademark -> <email ->mpmcbride7@yahoo.com</email -></para> +<para>Documentation <trademark class="copyright">copyright 2000 Michael McBride</trademark> <email>mpmcbride7@yahoo.com</email></para> -<para ->Contributors:</para> +<para>Contributors:</para> <itemizedlist> -<listitem -><para ->Paul Campbell <email ->paul@taniwha.com</email -></para -></listitem> -<listitem -><para ->Helge Deller <email ->deller@kde.org</email -></para -></listitem> -<listitem -><para ->Mark Donohoe </para -></listitem> -<listitem -><para ->Pat Dowler</para -></listitem> -<listitem -><para ->Duncan Haldane <email ->duncan@kde.org</email -></para -></listitem> -<listitem -><para ->Steffen Hansen <email ->stefh@mip.ou.dk</email ->.</para -></listitem> -<listitem -><para ->Matthias Hoelzer-Kluepfel <email ->hoelzer@kde.org</email -></para -></listitem> -<listitem -><para ->Martin Jones <email ->mjones@kde.org</email -></para -></listitem> -<listitem -><para ->Jost Schenck <email ->jost@schenck.de</email -></para -></listitem> -<listitem -><para ->Jonathan Singer <email ->jsinger@leeta.net</email -></para -></listitem> -<listitem -><para ->Thomas Tanghus <email ->tanghus@earthling.net</email -></para -></listitem> -<listitem -><para ->Krishna Tateneni <email ->tateneni@pluto.njcc.com -></email -></para -></listitem> -<listitem -><para ->Ellis Whitehead <email ->ewhitehe@uni-freiburg.de</email -></para -></listitem> +<listitem><para>Paul Campbell <email>paul@taniwha.com</email></para></listitem> +<listitem><para>Helge Deller <email>deller@kde.org</email></para></listitem> +<listitem><para>Mark Donohoe </para></listitem> +<listitem><para>Pat Dowler</para></listitem> +<listitem><para>Duncan Haldane <email>duncan@kde.org</email></para></listitem> +<listitem><para>Steffen Hansen <email>stefh@mip.ou.dk</email>.</para></listitem> +<listitem><para>Matthias Hoelzer-Kluepfel <email>hoelzer@kde.org</email></para></listitem> +<listitem><para>Martin Jones <email>mjones@kde.org</email></para></listitem> +<listitem><para>Jost Schenck <email>jost@schenck.de</email></para></listitem> +<listitem><para>Jonathan Singer <email>jsinger@leeta.net</email></para></listitem> +<listitem><para>Thomas Tanghus <email>tanghus@earthling.net</email></para></listitem> +<listitem><para>Krishna Tateneni <email>tateneni@pluto.njcc.com></email></para></listitem> +<listitem><para>Ellis Whitehead <email>ewhitehe@uni-freiburg.de</email></para></listitem> </itemizedlist> -<para ->Conversion to British English: Malcolm Hunter <email ->malcolm.hunter@gmx.co.uk</email -></para -> +<para>Conversion to British English: Malcolm Hunter <email>malcolm.hunter@gmx.co.uk</email></para> &underFDL; &underGPL; </chapter> </book> diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/interrupts/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/interrupts/index.docbook index b9efbf5cffa..a13f30e4833 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/interrupts/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/interrupts/index.docbook @@ -2,116 +2,49 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title ->Interrupt Request (<abbrev ->IRQ</abbrev ->) Lines</title> +<title>Interrupt Request (<abbrev>IRQ</abbrev>) Lines</title> <articleinfo> <authorgroup> -<author ->&Matthias.Hoelzer-Kluepfel;</author> -<author ->&Helge.Deller;</author> -<author ->&Duncan.Haldane;</author> -<author ->&Mike.McBride;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Matthias.Hoelzer-Kluepfel;</author> +<author>&Helge.Deller;</author> +<author>&Duncan.Haldane;</author> +<author>&Mike.McBride;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->IRQ</keyword> -<keyword ->interrupts</keyword> -<keyword ->system information</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>IRQ</keyword> +<keyword>interrupts</keyword> +<keyword>system information</keyword> </keywordset> </articleinfo> <sect1> -<title ->Interrupt Request (<abbrev ->IRQ</abbrev ->) Lines in Use</title> +<title>Interrupt Request (<abbrev>IRQ</abbrev>) Lines in Use</title> -<para ->This page displays information about the Interrupt Request Lines in use, and the devices that use them.</para> +<para>This page displays information about the Interrupt Request Lines in use, and the devices that use them.</para> -<para ->An <acronym ->IRQ</acronym -> is a hardware line used in a <acronym ->PC</acronym -> by (<acronym ->ISA</acronym -> bus) devices like keyboards, modems, sound cards, &etc;, to send interrupt signals to the processor to tell it that the device is ready to send or accept data. Unfortunately, there are only sixteen <acronym ->IRQ</acronym ->'s (0-15) available in the i386 (<acronym ->PC</acronym ->) architecture for sharing among the various <acronym ->ISA</acronym -> devices.</para> +<para>An <acronym>IRQ</acronym> is a hardware line used in a <acronym>PC</acronym> by (<acronym>ISA</acronym> bus) devices like keyboards, modems, sound cards, &etc;, to send interrupt signals to the processor to tell it that the device is ready to send or accept data. Unfortunately, there are only sixteen <acronym>IRQ</acronym>'s (0-15) available in the i386 (<acronym>PC</acronym>) architecture for sharing among the various <acronym>ISA</acronym> devices.</para> -<para ->Many hardware problems are the result of <acronym ->IRQ</acronym -> conflicts, when two devices try to use the same <acronym ->IRQ</acronym ->, or software is misconfigured to use a different <acronym ->IRQ</acronym -> from the one a device is actually configured for.</para> +<para>Many hardware problems are the result of <acronym>IRQ</acronym> conflicts, when two devices try to use the same <acronym>IRQ</acronym>, or software is misconfigured to use a different <acronym>IRQ</acronym> from the one a device is actually configured for.</para> -<note -><para ->The exact information displayed is system-dependent. On some systems, <acronym ->IRQ</acronym -> information cannot be displayed yet.</para -></note> +<note><para>The exact information displayed is system-dependent. On some systems, <acronym>IRQ</acronym> information cannot be displayed yet.</para></note> -<para ->On &Linux;, this information is read from <filename class="directory" ->/proc/interrupts</filename ->, which is only available if the <filename class="directory" ->/proc</filename -> pseudo-filesystem is compiled into the kernel.</para> +<para>On &Linux;, this information is read from <filename class="directory">/proc/interrupts</filename>, which is only available if the <filename class="directory">/proc</filename> pseudo-filesystem is compiled into the kernel.</para> -<para ->The first column, is the <acronym ->IRQ</acronym -> number. The second column, is the number of interrupts that have been received since the last reboot. The third column shows the type of interrupt. The fourth, identifies the device assigned to that interrupt.</para> +<para>The first column, is the <acronym>IRQ</acronym> number. The second column, is the number of interrupts that have been received since the last reboot. The third column shows the type of interrupt. The fourth, identifies the device assigned to that interrupt.</para> -<para ->The user cannot modify any settings on this page.</para> +<para>The user cannot modify any settings on this page.</para> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/ioports/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/ioports/index.docbook index e26155a5c4b..1bc9f83fca4 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/ioports/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/ioports/index.docbook @@ -2,89 +2,49 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title ->I/O Port</title> +<title>I/O Port</title> <articleinfo> <authorgroup> -<author ->&Matthias.Hoelzer-Kluepfel;</author> -<author ->&Helge.Deller;</author> -<author ->&Duncan.Haldane;</author> -<author ->&Mike.McBride;</author> +<author>&Matthias.Hoelzer-Kluepfel;</author> +<author>&Helge.Deller;</author> +<author>&Duncan.Haldane;</author> +<author>&Mike.McBride;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->ioports</keyword> -<keyword ->system information</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>ioports</keyword> +<keyword>system information</keyword> </keywordset> </articleinfo> <sect1> -<title ->Input/Output Port Information</title> +<title>Input/Output Port Information</title> -<para ->This page displays information about the I/O ports.</para> +<para>This page displays information about the I/O ports.</para> -<para ->I/O Ports are memory addresses used by the processor for direct communication with a device that has sent an interrupt signal to the processor.</para> +<para>I/O Ports are memory addresses used by the processor for direct communication with a device that has sent an interrupt signal to the processor.</para> -<para ->The exchange of commands or data between the processor and the device takes place through the I/O port address of the device, which is a hexadecimal number. No two devices can share the same I/O port. Many devices use multiple I/O port addresses, which are expressed as a range of hexadecimal numbers. </para> +<para>The exchange of commands or data between the processor and the device takes place through the I/O port address of the device, which is a hexadecimal number. No two devices can share the same I/O port. Many devices use multiple I/O port addresses, which are expressed as a range of hexadecimal numbers. </para> -<note -><para ->The exact information displayed is system-dependent. On some systems, I/O port information can not yet be displayed.</para -></note> +<note><para>The exact information displayed is system-dependent. On some systems, I/O port information can not yet be displayed.</para></note> -<para ->On &Linux;, this information is read from <filename class="devicefile" ->/proc/ioports</filename -> which is only available if the <filename class="devicefile" ->/proc</filename -> pseudo-filesystem is compiled into the kernel. A list of all currently-registered I/O port regions that are in use is shown.</para> +<para>On &Linux;, this information is read from <filename class="devicefile">/proc/ioports</filename> which is only available if the <filename class="devicefile">/proc</filename> pseudo-filesystem is compiled into the kernel. A list of all currently-registered I/O port regions that are in use is shown.</para> -<para ->The first column is the I/O port (or the range of I/O ports), the second column identifies the device that uses these I/O ports.</para> +<para>The first column is the I/O port (or the range of I/O ports), the second column identifies the device that uses these I/O ports.</para> -<para ->The user cannot modify any settings on this page.</para> +<para>The user cannot modify any settings on this page.</para> </sect1> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/memory/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/memory/index.docbook index ad31d42788b..90ddf62057a 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/memory/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/memory/index.docbook @@ -2,139 +2,73 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title ->Memory Information</title> +<title>Memory Information</title> <articleinfo> <authorgroup> -<author ->&Mike.McBride;</author> - -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride;</author> + +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-13</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-13</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->memory</keyword> -<keyword ->system information</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>memory</keyword> +<keyword>system information</keyword> </keywordset> </articleinfo> <sect1> -<title ->Memory Information</title> +<title>Memory Information</title> -<para ->This module displays the current memory usage. It is updated constantly, and can be very useful for pinpointing bottlenecks when certain applications are executed.</para> +<para>This module displays the current memory usage. It is updated constantly, and can be very useful for pinpointing bottlenecks when certain applications are executed.</para> <sect2 id="memory-intro"> -<title ->Memory Types</title> - -<para ->The first thing you must understand, is there are two types of <quote ->memory</quote ->, available to the operating system and the programs that run within it.</para> - -<para ->The first type, is called physical memory. This is the memory located within the memory chips, within your computer. This is the <acronym ->RAM</acronym -> (for Random Access Memory) you bought when you purchased your computer.</para> - -<para ->The second type of memory, is called virtual or swap memory. This block of memory, is actually space on the hard drive. The operating system reserves a space on the hard drive for <quote ->swap space</quote ->. The operating system can use this virtual memory (or swap space), if it runs out of physical memory. The reason this is called <quote ->swap</quote -> memory, is the operating system takes some data that it doesn't think you will want for a while, and saves that to disk in this reserved space. The operating system then loads the new data you need right now. It has <quote ->swapped</quote -> the not needed data, for the data you need right now. Virtual or swap memory is not as fast as physical memory, so operating systems try to keep data (especially often used data), in the physical memory.</para> - -<para ->The total memory, is the combined total of physical memory and virtual memory.</para> +<title>Memory Types</title> + +<para>The first thing you must understand, is there are two types of <quote>memory</quote>, available to the operating system and the programs that run within it.</para> + +<para>The first type, is called physical memory. This is the memory located within the memory chips, within your computer. This is the <acronym>RAM</acronym> (for Random Access Memory) you bought when you purchased your computer.</para> + +<para>The second type of memory, is called virtual or swap memory. This block of memory, is actually space on the hard drive. The operating system reserves a space on the hard drive for <quote>swap space</quote>. The operating system can use this virtual memory (or swap space), if it runs out of physical memory. The reason this is called <quote>swap</quote> memory, is the operating system takes some data that it doesn't think you will want for a while, and saves that to disk in this reserved space. The operating system then loads the new data you need right now. It has <quote>swapped</quote> the not needed data, for the data you need right now. Virtual or swap memory is not as fast as physical memory, so operating systems try to keep data (especially often used data), in the physical memory.</para> + +<para>The total memory, is the combined total of physical memory and virtual memory.</para> </sect2> <sect2 id="memory-use"> -<title ->Memory Information Module</title> +<title>Memory Information Module</title> -<para ->This window is divided into a top and bottom section</para> +<para>This window is divided into a top and bottom section</para> -<para ->The top section shows you the total physical memory, total free physical memory, shared memory, and buffered memory.</para> +<para>The top section shows you the total physical memory, total free physical memory, shared memory, and buffered memory.</para> -<para ->All four values are represented as the total number of bytes, and as the number of megabytes (1 megabyte = slightly more than 1,000,000 bytes)</para> +<para>All four values are represented as the total number of bytes, and as the number of megabytes (1 megabyte = slightly more than 1,000,000 bytes)</para> -<para ->The bottom section shows you three graphs: </para> +<para>The bottom section shows you three graphs: </para> <itemizedlist> -<listitem -><para -><guilabel ->Total Memory</guilabel -> (this is the combination of physical and virtual memory).</para -></listitem> -<listitem -><para -><guilabel ->Physical Memory</guilabel -></para -></listitem> -<listitem -><para ->Virtual memory, or <guilabel ->Swap Space</guilabel ->.</para -></listitem> +<listitem><para><guilabel>Total Memory</guilabel> (this is the combination of physical and virtual memory).</para></listitem> +<listitem><para><guilabel>Physical Memory</guilabel></para></listitem> +<listitem><para>Virtual memory, or <guilabel>Swap Space</guilabel>.</para></listitem> </itemizedlist> -<para ->The green areas are free, and the red areas are used.</para> +<para>The green areas are free, and the red areas are used.</para> -<tip -><para ->The exact values of each type of memory are not critical, and they change regularly. When you evaluate this page, look at trends.</para> +<tip><para>The exact values of each type of memory are not critical, and they change regularly. When you evaluate this page, look at trends.</para> -<para ->Does your computer have plenty of free space (green areas)? If not, you can increase the swap size or increase the physical memory.</para> +<para>Does your computer have plenty of free space (green areas)? If not, you can increase the swap size or increase the physical memory.</para> -<para ->Also, if your computer seems sluggish: is your physical memory full, and does the hard drive always seem to be running? This suggests that you do not have enough physical memory, and your computer is relying on the slower virtual memory for commonly used data. Increasing your physical memory will improve the responsiveness of your computer.</para -></tip> +<para>Also, if your computer seems sluggish: is your physical memory full, and does the hard drive always seem to be running? This suggests that you do not have enough physical memory, and your computer is relying on the slower virtual memory for commonly used data. Increasing your physical memory will improve the responsiveness of your computer.</para></tip> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/nics/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/nics/index.docbook index fa687819ae1..bccbc49f639 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/nics/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/nics/index.docbook @@ -2,67 +2,38 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title ->Network Interfaces</title> +<title>Network Interfaces</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-11</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-11</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->Network</keyword> -<keyword ->Interfaces</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>Network</keyword> +<keyword>Interfaces</keyword> </keywordset> </articleinfo> <sect1> -<title ->Network Interfaces</title> +<title>Network Interfaces</title> -<para ->This page displays information about the network interfaces installed in your computer. </para> +<para>This page displays information about the network interfaces installed in your computer. </para> -<note -><para ->The exact information displayed is system-dependent. On some systems, this information can not yet be displayed.</para -></note> +<note><para>The exact information displayed is system-dependent. On some systems, this information can not yet be displayed.</para></note> -<para ->The user cannot modify any settings on this page.</para> +<para>The user cannot modify any settings on this page.</para> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/opengl/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/opengl/index.docbook index 3e114ff0a24..8c01cb7cdd6 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/opengl/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/opengl/index.docbook @@ -2,88 +2,42 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title -><acronym ->OpenGL</acronym -></title> +<title><acronym>OpenGL</acronym></title> <articleinfo> <authorgroup> -<author -><personname -><firstname ->Ilya</firstname -><surname ->Korniyko</surname -></personname -><email ->k_ilya@ukr.net</email -></author> -<othercredit role="translator" -><firstname ->Andrew</firstname -><surname ->Coles</surname -><affiliation -><address -><email ->andrew_coles@yahoo.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author><personname><firstname>Ilya</firstname><surname>Korniyko</surname></personname><email>k_ilya@ukr.net</email></author> +<othercredit role="translator"><firstname>Andrew</firstname><surname>Coles</surname><affiliation><address><email>andrew_coles@yahoo.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date -></date> -<releaseinfo -></releaseinfo> +<date></date> +<releaseinfo></releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->OpenGL</keyword> -<keyword ->system information</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>OpenGL</keyword> +<keyword>system information</keyword> </keywordset> </articleinfo> <sect1 id="opengl"> -<title ->OpenGL</title> +<title>OpenGL</title> -<para ->This page displays information about installed <acronym ->OpenGL</acronym -> implementation. OpenGL (for "Open Graphics Library") is a cross-platform, hardware independent interface for 3D graphics. </para> +<para>This page displays information about installed <acronym>OpenGL</acronym> implementation. OpenGL (for "Open Graphics Library") is a cross-platform, hardware independent interface for 3D graphics. </para> -<para -><acronym ->GLX</acronym -> is the binding for OpenGL to X Window system.</para> +<para><acronym>GLX</acronym> is the binding for OpenGL to X Window system.</para> -<para -><acronym ->DRI</acronym -> (Direct Rendering Infrastucture) provides hardware acceleration for OpenGL. You must have a videocard with 3D accelerator and properly installed driver for this.</para> +<para><acronym>DRI</acronym> (Direct Rendering Infrastucture) provides hardware acceleration for OpenGL. You must have a videocard with 3D accelerator and properly installed driver for this.</para> -<para ->Read more at the official OpenGL site <ulink url="http://www.opengl.org" ->http://www.opengl.org</ulink -> </para> +<para>Read more at the official OpenGL site <ulink url="http://www.opengl.org">http://www.opengl.org</ulink> </para> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/partitions/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/partitions/index.docbook index 4ef630e0a2f..43a65b35afe 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/partitions/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/partitions/index.docbook @@ -2,82 +2,44 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title ->Partition Information</title> +<title>Partition Information</title> <articleinfo> <authorgroup> -<author ->&Matthias.Hoelzer-Kluepfel;</author> -<author ->&Helge.Deller;</author> -<author ->&Duncan.Haldane;</author> -<author ->&Mike.McBride;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Matthias.Hoelzer-Kluepfel;</author> +<author>&Helge.Deller;</author> +<author>&Duncan.Haldane;</author> +<author>&Mike.McBride;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->drive partition</keyword> -<keyword ->system information</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>drive partition</keyword> +<keyword>system information</keyword> </keywordset> </articleinfo> <sect1> -<title ->Partition Information</title> +<title>Partition Information</title> -<para ->This page displays information about partitions on your hard drives.</para> +<para>This page displays information about partitions on your hard drives.</para> -<note -><para ->The exact information displayed is system-dependent. On some systems, partition information cannot be displayed yet.</para -></note> +<note><para>The exact information displayed is system-dependent. On some systems, partition information cannot be displayed yet.</para></note> -<para ->On &Linux;, this information is read from <filename class="devicefile" ->/proc/partitions</filename ->, which is only available if the <filename class="directory" ->/proc</filename -> pseudo-filesystem is compiled into the (2.1.x or later) kernel.</para> +<para>On &Linux;, this information is read from <filename class="devicefile">/proc/partitions</filename>, which is only available if the <filename class="directory">/proc</filename> pseudo-filesystem is compiled into the (2.1.x or later) kernel.</para> -<para ->The first two columns are the major and minor numbers respectively. The third column is the number of blocks (usually 1 block = 1024 bytes). The fourth column is a label for the device.</para> +<para>The first two columns are the major and minor numbers respectively. The third column is the number of blocks (usually 1 block = 1024 bytes). The fourth column is a label for the device.</para> -<para ->The user cannot modify any settings on this page.</para> +<para>The user cannot modify any settings on this page.</para> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/pci/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/pci/index.docbook index 47b2a9b2ed4..8b97e588876 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/pci/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/pci/index.docbook @@ -2,100 +2,44 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title -><acronym ->PCI</acronym ->-bus and Installed <acronym ->PCI</acronym -> Cards</title> +<title><acronym>PCI</acronym>-bus and Installed <acronym>PCI</acronym> Cards</title> <articleinfo> <authorgroup> -<author ->&Matthias.Hoelzer-Kluepfel;</author> -<author ->&Helge.Deller;</author> -<author ->&Duncan.Haldane;</author> -<author ->&Mike.McBride;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Matthias.Hoelzer-Kluepfel;</author> +<author>&Helge.Deller;</author> +<author>&Duncan.Haldane;</author> +<author>&Mike.McBride;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->PCI</keyword> -<keyword ->system information</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>PCI</keyword> +<keyword>system information</keyword> </keywordset> </articleinfo> <sect1 id="pci"> -<title -><acronym ->PCI</acronym ->-bus and Installed <acronym ->PCI</acronym -> Cards</title> +<title><acronym>PCI</acronym>-bus and Installed <acronym>PCI</acronym> Cards</title> -<para ->This page displays information about the <acronym ->PCI</acronym ->-bus and installed <acronym ->PCI</acronym -> cards, and other devices that use the Peripheral Component Interconnect (<acronym ->PCI</acronym ->) bus.</para> +<para>This page displays information about the <acronym>PCI</acronym>-bus and installed <acronym>PCI</acronym> cards, and other devices that use the Peripheral Component Interconnect (<acronym>PCI</acronym>) bus.</para> -<note -><para ->The exact information displayed is system-dependent. On some systems, <acronym ->PCI</acronym ->-information can not yet be displayed.</para -> </note> +<note><para>The exact information displayed is system-dependent. On some systems, <acronym>PCI</acronym>-information can not yet be displayed.</para> </note> -<para ->On &Linux;, this information is read from <filename class="devicefile" ->/proc/pci</filename -> which is only available if the <filename class="directory" ->/proc</filename -> pseudo-filesystem is compiled into the kernel. A listing of all <acronym ->PCI</acronym -> devices found during kernel initialisation, and their configuration, is shown.</para> +<para>On &Linux;, this information is read from <filename class="devicefile">/proc/pci</filename> which is only available if the <filename class="directory">/proc</filename> pseudo-filesystem is compiled into the kernel. A listing of all <acronym>PCI</acronym> devices found during kernel initialisation, and their configuration, is shown.</para> -<para ->Each entry begins with a bus, device and function number.</para> -<para ->The user cannot modify any settings on this page.</para> +<para>Each entry begins with a bus, device and function number.</para> +<para>The user cannot modify any settings on this page.</para> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/pcmcia/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/pcmcia/index.docbook index 8c55c7980ab..8fc1a2adf94 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/pcmcia/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/pcmcia/index.docbook @@ -2,67 +2,35 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title -><acronym ->PCMCIA</acronym -></title> +<title><acronym>PCMCIA</acronym></title> <articleinfo> <authorgroup> -<author ->&Mike.McBride;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Mike.McBride;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->Laptop</keyword> -<keyword ->PCMCIA</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>Laptop</keyword> +<keyword>PCMCIA</keyword> </keywordset> </articleinfo> <sect1 id="pcmcia"> -<title -><acronym ->PCMCIA</acronym -></title> +<title><acronym>PCMCIA</acronym></title> -<para ->This module displays information about <acronym ->PCMCIA</acronym -> Cards</para> +<para>This module displays information about <acronym>PCMCIA</acronym> Cards</para> -<para ->The exact information is system dependent. On most systems no information is displayed at all.</para> +<para>The exact information is system dependent. On most systems no information is displayed at all.</para> </sect1> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/processor/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/processor/index.docbook index c76fb5654dd..a4c73596ba5 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/processor/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/processor/index.docbook @@ -2,88 +2,45 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title ->Processor Information</title> +<title>Processor Information</title> <articleinfo> <authorgroup> -<author ->&Matthias.Hoelzer-Kluepfel;</author> -<author ->&Helge.Deller;</author> -<author ->&Duncan.Haldane;</author> -<author ->&Mike.McBride;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Matthias.Hoelzer-Kluepfel;</author> +<author>&Helge.Deller;</author> +<author>&Duncan.Haldane;</author> +<author>&Mike.McBride;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->CPU</keyword> -<keyword ->processor</keyword> -<keyword ->system information</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>CPU</keyword> +<keyword>processor</keyword> +<keyword>system information</keyword> </keywordset> </articleinfo> <sect1 id="processor"> -<title ->Processor Information</title> +<title>Processor Information</title> -<para ->This page displays information about the system Central Processing Unit (<acronym ->CPU</acronym ->).</para> +<para>This page displays information about the system Central Processing Unit (<acronym>CPU</acronym>).</para> -<note -><para ->The exact information displayed is system-dependent. On some systems, processor information cannot be displayed yet.</para -></note> +<note><para>The exact information displayed is system-dependent. On some systems, processor information cannot be displayed yet.</para></note> -<para ->On &Linux;, this information is read from <filename class="devicefile" ->/proc/cpuinfo</filename ->, which is only available if the <filename class="directory" ->/proc</filename -> pseudo-filesystem is compiled into the kernel.</para> +<para>On &Linux;, this information is read from <filename class="devicefile">/proc/cpuinfo</filename>, which is only available if the <filename class="directory">/proc</filename> pseudo-filesystem is compiled into the kernel.</para> -<para ->The exact contents of the window will depend on the <acronym ->CPU</acronym ->(s) in your machine, but the window is organised into two columns. The first column is the parameter, and the second column is the value of that parameter.</para> +<para>The exact contents of the window will depend on the <acronym>CPU</acronym>(s) in your machine, but the window is organised into two columns. The first column is the parameter, and the second column is the value of that parameter.</para> -<para ->The user cannot modify any settings on this page.</para> +<para>The user cannot modify any settings on this page.</para> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/protocols/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/protocols/index.docbook index 3596a0bc521..48c761edff1 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/protocols/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/protocols/index.docbook @@ -2,59 +2,33 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title ->Protocols</title> +<title>Protocols</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <keywordset> -<keyword ->KDE</keyword> -<keyword ->Protocols</keyword> -<keyword ->IOSlaves</keyword> +<keyword>KDE</keyword> +<keyword>Protocols</keyword> +<keyword>IOSlaves</keyword> </keywordset> </articleinfo> <sect1 id="protocols"> -<title ->Protocols</title> +<title>Protocols</title> -<para ->On the left of the panel you will see a list of the IOSlaves that are installed on your system. IOSlaves are how &kde; applications <quote ->talk</quote -> to other computers, other applications, or act on files.</para> +<para>On the left of the panel you will see a list of the IOSlaves that are installed on your system. IOSlaves are how &kde; applications <quote>talk</quote> to other computers, other applications, or act on files.</para> -<para ->Clicking on an IOSlave name will display some help information about that IOSlave, such as how to use it, and what it does.</para> +<para>Clicking on an IOSlave name will display some help information about that IOSlave, such as how to use it, and what it does.</para> -<para ->The protocols module is purely informational, you cannot change any settings here.</para> +<para>The protocols module is purely informational, you cannot change any settings here.</para> </sect1> </article>
\ No newline at end of file diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/samba/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/samba/index.docbook index c636e2c010c..bc0513467f6 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/samba/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/samba/index.docbook @@ -2,307 +2,123 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title ->Samba Status Information</title> +<title>Samba Status Information</title> <articleinfo> <authorgroup> -<author ->&Alexander.Neundorf;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> -</authorgroup -> - -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<author>&Alexander.Neundorf;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> +</authorgroup> + +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->Samba</keyword> -<keyword ->system information</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>Samba</keyword> +<keyword>system information</keyword> </keywordset> </articleinfo> <sect1 id="sambastatus"> -<title ->Samba Status Information</title> - -<para ->The Samba and <acronym ->NFS</acronym -> Status Monitor is a front end to the programs <command ->smbstatus</command -> and <command ->showmount</command ->. Smbstatus reports on current Samba connections, and is part of the suite of Samba tools, which implements the <acronym ->SMB</acronym -> (Session Message Block) protocol, also called the NetBIOS or LanManager protocol.</para> - -<para ->This protocol can be used to provide printer sharing or drive sharing services on a network including machines running the various flavours of &Microsoft; &Windows;.</para> - -<para -><command ->showmount</command -> is part of the <acronym ->NFS</acronym -> software package. <acronym ->NFS</acronym -> stands for Network File System and is the traditional &UNIX; way to share folders over the network. In this case the output of <command ->showmount</command -> <option ->-a localhost</option -> is parsed. On some systems showmount is in <filename class="directory" ->/usr/sbin</filename ->, check if you have showmount in your <envar ->PATH</envar ->.</para> +<title>Samba Status Information</title> + +<para>The Samba and <acronym>NFS</acronym> Status Monitor is a front end to the programs <command>smbstatus</command> and <command>showmount</command>. Smbstatus reports on current Samba connections, and is part of the suite of Samba tools, which implements the <acronym>SMB</acronym> (Session Message Block) protocol, also called the NetBIOS or LanManager protocol.</para> + +<para>This protocol can be used to provide printer sharing or drive sharing services on a network including machines running the various flavours of &Microsoft; &Windows;.</para> + +<para><command>showmount</command> is part of the <acronym>NFS</acronym> software package. <acronym>NFS</acronym> stands for Network File System and is the traditional &UNIX; way to share folders over the network. In this case the output of <command>showmount</command> <option>-a localhost</option> is parsed. On some systems showmount is in <filename class="directory">/usr/sbin</filename>, check if you have showmount in your <envar>PATH</envar>.</para> <sect2 id="smb-exports"> -<title ->Exports</title> - -<para ->On this page you can see a big list which shows the currently active connections to Samba shares and <acronym ->NFS</acronym -> exports of your machine. The first column shows you whether the resource is a Samba (<acronym ->SMB</acronym ->) share or a <acronym ->NFS</acronym -> export. The second column contains the name of the share, the third the name of the remote host, which accesses this share. The remaining columns have only a meaning for Samba-shares.</para> - -<para ->The fourth column contains the User <abbrev ->ID</abbrev -> of the user, who accesses this share. Note that this does not have to be equal to the &UNIX; user <abbrev ->ID</abbrev -> of this user. The same applies for the next column, which displays the group <abbrev ->ID</abbrev -> of the user.</para> - -<para ->Each connection to one of your shares is handled by a single process (<command ->smbd</command ->), the next column shows the process <abbrev ->ID</abbrev -> (<acronym ->pid</acronym ->) of this <command ->smbd</command ->. If you kill this process the connected user will be disconnected. If the remote user works from &Windows;, as soon as this process is killed a new one will be created, so he will almost not notice it.</para> - -<para ->The last column shows how many files this user has currently open. Here you see only, how many files he has <emphasis ->open</emphasis -> just now, you don't see how many he copied or formerly opened &etc;</para> +<title>Exports</title> + +<para>On this page you can see a big list which shows the currently active connections to Samba shares and <acronym>NFS</acronym> exports of your machine. The first column shows you whether the resource is a Samba (<acronym>SMB</acronym>) share or a <acronym>NFS</acronym> export. The second column contains the name of the share, the third the name of the remote host, which accesses this share. The remaining columns have only a meaning for Samba-shares.</para> + +<para>The fourth column contains the User <abbrev>ID</abbrev> of the user, who accesses this share. Note that this does not have to be equal to the &UNIX; user <abbrev>ID</abbrev> of this user. The same applies for the next column, which displays the group <abbrev>ID</abbrev> of the user.</para> + +<para>Each connection to one of your shares is handled by a single process (<command>smbd</command>), the next column shows the process <abbrev>ID</abbrev> (<acronym>pid</acronym>) of this <command>smbd</command>. If you kill this process the connected user will be disconnected. If the remote user works from &Windows;, as soon as this process is killed a new one will be created, so he will almost not notice it.</para> + +<para>The last column shows how many files this user has currently open. Here you see only, how many files he has <emphasis>open</emphasis> just now, you don't see how many he copied or formerly opened &etc;</para> </sect2> <sect2 id="smb-imports"> -<title ->Imports</title> +<title>Imports</title> -<para ->Here you see which Samba- and <acronym ->NFS</acronym ->-shares from other hosts are mounted on your local system. The first column shows wether it is a Samba- or <acronym ->NFS</acronym ->-share, the second column displays the name of the share, and the third shows where it is mounted.</para> +<para>Here you see which Samba- and <acronym>NFS</acronym>-shares from other hosts are mounted on your local system. The first column shows wether it is a Samba- or <acronym>NFS</acronym>-share, the second column displays the name of the share, and the third shows where it is mounted.</para> -<para ->The mounted <acronym ->NFS</acronym ->-shares you should see on &Linux; (this has been tested), and it should also work on &Solaris; (this has not been tested).</para> +<para>The mounted <acronym>NFS</acronym>-shares you should see on &Linux; (this has been tested), and it should also work on &Solaris; (this has not been tested).</para> </sect2> -<sect2 id="smb-log" -> -<title ->Log</title -> - -<para ->This page presents the contents of your local samba log file in a nice way. If you open this page, the list will be empty. You have to press the <guibutton ->Update</guibutton -> button, then the samba log file will be read and the results displayed. Check whether the samba log file on your system is really at the location as specified in the input line. If it is somewhere else or if it has another name, correct it. After changing the file name you have to press <guibutton ->Update</guibutton -> again.</para> - -<para ->Samba logs its actions according to the log level (see <filename ->smb.conf</filename ->). If loglevel = 1, samba logs only when somebody connects to your machine and when this connection is closed again. If log level = 2, it logs also if somebody opens a file and if he closes the file again. If the log level is higher than 2, yet more stuff is logged.</para> - -<para ->If you are interested in who accesses your machine, and which files are accessed, you should set the log level to 2 and regularly create a new samba log file (⪚ set up a <command ->cron</command -> task which once a week moves your current samba log file into another folder or something like that). Otherwise your samba log file may become very big.</para> - -<para ->With the four checkboxes below the big list you can decide, which events are displayed in the list. You have to press <guibutton ->Update</guibutton -> to see the results. If the log level of your samba is too low, you won't see everything.</para> - -<para ->By clicking on the header of one column you can sort the list by this column.</para> +<sect2 id="smb-log"> +<title>Log</title> + +<para>This page presents the contents of your local samba log file in a nice way. If you open this page, the list will be empty. You have to press the <guibutton>Update</guibutton> button, then the samba log file will be read and the results displayed. Check whether the samba log file on your system is really at the location as specified in the input line. If it is somewhere else or if it has another name, correct it. After changing the file name you have to press <guibutton>Update</guibutton> again.</para> + +<para>Samba logs its actions according to the log level (see <filename>smb.conf</filename>). If loglevel = 1, samba logs only when somebody connects to your machine and when this connection is closed again. If log level = 2, it logs also if somebody opens a file and if he closes the file again. If the log level is higher than 2, yet more stuff is logged.</para> + +<para>If you are interested in who accesses your machine, and which files are accessed, you should set the log level to 2 and regularly create a new samba log file (⪚ set up a <command>cron</command> task which once a week moves your current samba log file into another folder or something like that). Otherwise your samba log file may become very big.</para> + +<para>With the four checkboxes below the big list you can decide, which events are displayed in the list. You have to press <guibutton>Update</guibutton> to see the results. If the log level of your samba is too low, you won't see everything.</para> + +<para>By clicking on the header of one column you can sort the list by this column.</para> </sect2> <sect2 id="smb-statistics"> -<title ->Statistics</title> - -<para ->On this page you can filter the contents of the third page for certain contents.</para> - -<para ->Let's say the <guilabel ->Event</guilabel -> field (not the one in the list) is set to <userinput ->Connection</userinput ->, <guilabel ->Service/File</guilabel -> is set to <userinput ->*</userinput ->, <guilabel ->Host/User</guilabel -> is set to <userinput ->*</userinput ->, <guilabel ->Show expanded service info</guilabel -> is disabled and <guilabel ->Show expanded host info</guilabel -> is disabled.</para> - -<para ->If you press <guibutton ->Update</guibutton -> now, you will see how often a connection was opened to share <literal ->*</literal -> (&ie; to any share) from host <literal ->*</literal -> (&ie; from any host). Now enable <guilabel ->Show expanded host info</guilabel -> and press <guibutton ->Update</guibutton -> again. Now you will see for every host which matches the wildcard <literal ->*</literal ->, how many connections were opened by him.</para> - -<para ->Now press <guibutton ->clear</guibutton ->.</para> - -<para ->Now set the <guilabel ->Event</guilabel -> field to File Access and enable <guilabel ->Show expanded service info</guilabel -> and press <guibutton ->Update</guibutton -> again.</para> - -<para ->Now you will see how often every single file was accessed. If you enable <guilabel ->Show expanded host info</guilabel -> too, you will see how often every single user opened each file.</para> - -<para ->In the input lines <guilabel ->Service/File</guilabel -> and <guilabel ->Host/User</guilabel -> you can use the wildcards <literal ->*</literal -> and <literal ->?</literal -> in the same way you use them at the command line. Regular expressions are not recognised.</para> - -<para ->By clicking on the header of a column you can sort the list by this column. This way you can check out which file was opened most often, or which user opened the most files or whatever.</para> +<title>Statistics</title> + +<para>On this page you can filter the contents of the third page for certain contents.</para> + +<para>Let's say the <guilabel>Event</guilabel> field (not the one in the list) is set to <userinput>Connection</userinput>, <guilabel>Service/File</guilabel> is set to <userinput>*</userinput>, <guilabel>Host/User</guilabel> is set to <userinput>*</userinput>, <guilabel>Show expanded service info</guilabel> is disabled and <guilabel>Show expanded host info</guilabel> is disabled.</para> + +<para>If you press <guibutton>Update</guibutton> now, you will see how often a connection was opened to share <literal>*</literal> (&ie; to any share) from host <literal>*</literal> (&ie; from any host). Now enable <guilabel>Show expanded host info</guilabel> and press <guibutton>Update</guibutton> again. Now you will see for every host which matches the wildcard <literal>*</literal>, how many connections were opened by him.</para> + +<para>Now press <guibutton>clear</guibutton>.</para> + +<para>Now set the <guilabel>Event</guilabel> field to File Access and enable <guilabel>Show expanded service info</guilabel> and press <guibutton>Update</guibutton> again.</para> + +<para>Now you will see how often every single file was accessed. If you enable <guilabel>Show expanded host info</guilabel> too, you will see how often every single user opened each file.</para> + +<para>In the input lines <guilabel>Service/File</guilabel> and <guilabel>Host/User</guilabel> you can use the wildcards <literal>*</literal> and <literal>?</literal> in the same way you use them at the command line. Regular expressions are not recognised.</para> + +<para>By clicking on the header of a column you can sort the list by this column. This way you can check out which file was opened most often, or which user opened the most files or whatever.</para> </sect2> <sect2 id="smb-stat-author"> -<title ->Section Author</title> +<title>Section Author</title> -<para ->Module copyright 2000: Michael Glauche and &Alexander.Neundorf; &Alexander.Neundorf.mail;</para> +<para>Module copyright 2000: Michael Glauche and &Alexander.Neundorf; &Alexander.Neundorf.mail;</para> -<para ->Originally written by: Michael Glauche</para> +<para>Originally written by: Michael Glauche</para> -<para ->Currently maintained by: &Alexander.Neundorf; &Alexander.Neundorf.mail;</para> +<para>Currently maintained by: &Alexander.Neundorf; &Alexander.Neundorf.mail;</para> <itemizedlist> -<title ->Contributors</title> -<listitem -><para ->Conversion to kcontrol applet:</para> -<para ->&Matthias.Hoelzer-Kluepfel; &Matthias.Hoelzer-Kluepfel.mail;</para -></listitem> -<listitem -><para ->Use of <classname ->TDEProcess</classname -> instead of popen, and more error checking:</para> -<para ->&David.Faure; &David.Faure.mail;</para -></listitem> -<listitem -><para ->Conversion to tdecmodule, added tab pages 2,3,4, bug fixed:</para> -<para ->&Alexander.Neundorf; &Alexander.Neundorf.mail;</para -></listitem> +<title>Contributors</title> +<listitem><para>Conversion to kcontrol applet:</para> +<para>&Matthias.Hoelzer-Kluepfel; &Matthias.Hoelzer-Kluepfel.mail;</para></listitem> +<listitem><para>Use of <classname>TDEProcess</classname> instead of popen, and more error checking:</para> +<para>&David.Faure; &David.Faure.mail;</para></listitem> +<listitem><para>Conversion to tdecmodule, added tab pages 2,3,4, bug fixed:</para> +<para>&Alexander.Neundorf; &Alexander.Neundorf.mail;</para></listitem> </itemizedlist> -<para ->Documentation copyright 2000 &Alexander.Neundorf; &Alexander.Neundorf.mail;</para> +<para>Documentation copyright 2000 &Alexander.Neundorf; &Alexander.Neundorf.mail;</para> -<para ->Documentation translated to docbook by &Mike.McBride; &Mike.McBride.mail;</para> +<para>Documentation translated to docbook by &Mike.McBride; &Mike.McBride.mail;</para> -<para ->Conversion to British English: John Knight <email ->anarchist_tomato@herzeleid.net</email -></para -> +<para>Conversion to British English: John Knight <email>anarchist_tomato@herzeleid.net</email></para> </sect2> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/scsi/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/scsi/index.docbook index 43c77e0ee37..1f7feb0c476 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/scsi/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/scsi/index.docbook @@ -2,97 +2,45 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title -><acronym ->SCSI</acronym -> Interface Information</title> +<title><acronym>SCSI</acronym> Interface Information</title> <articleinfo> <authorgroup> -<author ->&Matthias.Hoelzer-Kluepfel;</author> -<author ->&Helge.Deller;</author> -<author ->&Duncan.Haldane;</author> -<author ->&Mike.McBride;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Matthias.Hoelzer-Kluepfel;</author> +<author>&Helge.Deller;</author> +<author>&Duncan.Haldane;</author> +<author>&Mike.McBride;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->SCSI</keyword> -<keyword ->system information</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>SCSI</keyword> +<keyword>system information</keyword> </keywordset> </articleinfo> <sect1 id="scsi"> -<title -><acronym ->SCSI</acronym -> Interface Information</title> +<title><acronym>SCSI</acronym> Interface Information</title> -<para ->This page displays information about Small Computer Systems Interface (<acronym ->SCSI</acronym ->) Interfaces and the attached <acronym ->SCSI</acronym -> devices.</para> +<para>This page displays information about Small Computer Systems Interface (<acronym>SCSI</acronym>) Interfaces and the attached <acronym>SCSI</acronym> devices.</para> -<note -><para ->The exact information displayed is system-dependent. On some systems <acronym ->SCSI</acronym -> information cannot be displayed yet.</para -></note> +<note><para>The exact information displayed is system-dependent. On some systems <acronym>SCSI</acronym> information cannot be displayed yet.</para></note> -<para ->On &Linux;, this information is read from <filename class="devicefile" ->/proc/scsi/scsi</filename ->, which is only available if the <filename class="directory" ->/proc</filename -> pseudo-filesystem is compiled into the kernel. A listing of all <acronym ->SCSI</acronym -> devices known to the kernel is shown.</para> +<para>On &Linux;, this information is read from <filename class="devicefile">/proc/scsi/scsi</filename>, which is only available if the <filename class="directory">/proc</filename> pseudo-filesystem is compiled into the kernel. A listing of all <acronym>SCSI</acronym> devices known to the kernel is shown.</para> -<para ->The devices are sorted numerically by their host, channel, and <acronym ->ID</acronym -> numbers.</para> +<para>The devices are sorted numerically by their host, channel, and <acronym>ID</acronym> numbers.</para> -<para ->The user cannot modify any settings on this page.</para> +<para>The user cannot modify any settings on this page.</para> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/sound/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/sound/index.docbook index ed86203c637..a3ee3cc6a83 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/sound/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/sound/index.docbook @@ -2,82 +2,43 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title ->Soundcard Information</title> +<title>Soundcard Information</title> <articleinfo> <authorgroup> -<author ->&Matthias.Hoelzer-Kluepfel;</author> -<author ->&Helge.Deller;</author> -<author ->&Duncan.Haldane;</author> -<author ->&Mike.McBride;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Matthias.Hoelzer-Kluepfel;</author> +<author>&Helge.Deller;</author> +<author>&Duncan.Haldane;</author> +<author>&Mike.McBride;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->soundcard</keyword> -<keyword ->system information</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>soundcard</keyword> +<keyword>system information</keyword> </keywordset> </articleinfo> <sect1 id="soundinfo"> -<title ->Soundcard Information</title> +<title>Soundcard Information</title> -<para ->This page displays information about any soundcards installed in the system.</para> +<para>This page displays information about any soundcards installed in the system.</para> -<note -><para ->The exact information displayed is system-dependent. On some systems, soundcard information cannot be displayed yet.</para -></note> +<note><para>The exact information displayed is system-dependent. On some systems, soundcard information cannot be displayed yet.</para></note> -<para ->On &Linux;, this information is read either from <filename class="devicefile" ->/dev/sndstat</filename ->, if present, or from <filename class="devicefile" ->/proc/sound</filename ->, which is only available if the <filename class="directory" ->/proc</filename -> pseudo-filesystem is compiled into the (2.1.x or later) kernel.</para> +<para>On &Linux;, this information is read either from <filename class="devicefile">/dev/sndstat</filename>, if present, or from <filename class="devicefile">/proc/sound</filename>, which is only available if the <filename class="directory">/proc</filename> pseudo-filesystem is compiled into the (2.1.x or later) kernel.</para> -<para ->The user cannot modify any settings on this page.</para> +<para>The user cannot modify any settings on this page.</para> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/usb/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/usb/index.docbook index 8da4dafa7fd..6ae4510551e 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/usb/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/usb/index.docbook @@ -2,72 +2,37 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;"> -<title -><acronym ->USB</acronym -></title> +<title><acronym>USB</acronym></title> <articleinfo> <authorgroup> -<author -><firstname -></firstname -> <surname -></surname -> </author> +<author><firstname></firstname> <surname></surname> </author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KControl</keyword> -<keyword ->USB</keyword> -<keyword ->System Information</keyword> +<keyword>KControl</keyword> +<keyword>USB</keyword> +<keyword>System Information</keyword> </keywordset> </articleinfo> <sect1 id="usb"> -<title -><acronym ->USB</acronym -></title> +<title><acronym>USB</acronym></title> -<para ->This module allows you to see the devices attached to your <acronym ->USB</acronym -> bus(es).</para> +<para>This module allows you to see the devices attached to your <acronym>USB</acronym> bus(es).</para> -<para ->This module is for information only, you cannot edit any information you see here.</para> +<para>This module is for information only, you cannot edit any information you see here.</para> </sect1> </article>
\ No newline at end of file diff --git a/tde-i18n-en_GB/docs/tdebase/kinfocenter/xserver/index.docbook b/tde-i18n-en_GB/docs/tdebase/kinfocenter/xserver/index.docbook index 71c7428594b..4f9906f190b 100644 --- a/tde-i18n-en_GB/docs/tdebase/kinfocenter/xserver/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kinfocenter/xserver/index.docbook @@ -2,79 +2,45 @@ <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <article lang="&language;" id="xserver"> -<title ->X Server Information</title> +<title>X Server Information</title> <articleinfo> <authorgroup> -<author ->&Mike.McBride;</author> +<author>&Mike.McBride;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-02-12</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2002-02-12</date> +<releaseinfo>3.00.00</releaseinfo> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KControl</keyword> -<keyword ->X server</keyword> -<keyword ->system information</keyword> +<keyword>KDE</keyword> +<keyword>KControl</keyword> +<keyword>X server</keyword> +<keyword>system information</keyword> </keywordset> </articleinfo> <sect1> -<title ->X Server Information</title> +<title>X Server Information</title> -<para ->This screen is useful for getting specific information about your X server and the current session of X.</para> +<para>This screen is useful for getting specific information about your X server and the current session of X.</para> -<para ->When you open this module, you are presented with some information. The left hand side of the window is organised into a tree. Some of the elements have a plus sign in front of the label. Clicking this sign opens a <quote ->submenu</quote -> related to the label. Clicking on a minus sign in front of a label hides the submenu.</para> +<para>When you open this module, you are presented with some information. The left hand side of the window is organised into a tree. Some of the elements have a plus sign in front of the label. Clicking this sign opens a <quote>submenu</quote> related to the label. Clicking on a minus sign in front of a label hides the submenu.</para> -<para ->The right hand side of the window contains the individual values for each of the parameters on the left.</para> +<para>The right hand side of the window contains the individual values for each of the parameters on the left.</para> -<para ->The information presented will vary depending on your setup.</para> +<para>The information presented will vary depending on your setup.</para> -<note -><para ->Some setups may not be able to determine some or all of the parameters.</para -></note> +<note><para>Some setups may not be able to determine some or all of the parameters.</para></note> -<para ->You can not change any values from this menu. It is for information only.</para> +<para>You can not change any values from this menu. It is for information only.</para> </sect1> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/klipper/index.docbook b/tde-i18n-en_GB/docs/tdebase/klipper/index.docbook index 25e9fcaec9b..ed7a04ec42c 100644 --- a/tde-i18n-en_GB/docs/tdebase/klipper/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/klipper/index.docbook @@ -4,257 +4,123 @@ <!ENTITY kappname "&klipper;"> <!ENTITY package "tdebase"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <book lang="&language;"> <bookinfo> -<title ->The &klipper; Handbook </title> +<title>The &klipper; Handbook </title> <authorgroup> -<author ->&Philip.Rodrigues; &Philip.Rodrigues.mail;</author> - -<othercredit role="developer" ->&Carsten.Pfeiffer; &Carsten.Pfeiffer.mail; </othercredit> - -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Philip.Rodrigues; &Philip.Rodrigues.mail;</author> + +<othercredit role="developer">&Carsten.Pfeiffer; &Carsten.Pfeiffer.mail; </othercredit> + +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->2000-2003</year> -<holder ->&Philip.Rodrigues;</holder> +<year>2000-2003</year> +<holder>&Philip.Rodrigues;</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2003-09-18</date> -<releaseinfo ->2.92.00</releaseinfo> +<date>2003-09-18</date> +<releaseinfo>2.92.00</releaseinfo> <abstract> -<para ->&klipper; is the &kde; clipboard cut & paste utility.</para> +<para>&klipper; is the &kde; clipboard cut & paste utility.</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->Klipper</keyword> -<keyword ->tdebase</keyword> -<keyword ->clipboard</keyword> +<keyword>KDE</keyword> +<keyword>Klipper</keyword> +<keyword>tdebase</keyword> +<keyword>clipboard</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introduction</title> -<para ->&klipper; is the &kde; clipboard utility. It stores clipboard history, and allows you to link clipboard contents to application actions. Please report any problems or feature requests to Carsten Pfeiffer &Carsten.Pfeiffer.mail;.</para> +<title>Introduction</title> +<para>&klipper; is the &kde; clipboard utility. It stores clipboard history, and allows you to link clipboard contents to application actions. Please report any problems or feature requests to Carsten Pfeiffer &Carsten.Pfeiffer.mail;.</para> </chapter> <chapter id="using-klipper"> -<title ->Using &klipper;</title> +<title>Using &klipper;</title> <sect1 id="basic-usage"> -<title ->Basic Usage</title> +<title>Basic Usage</title> <screenshot> -<screeninfo ->The &klipper; icon.</screeninfo> +<screeninfo>The &klipper; icon.</screeninfo> <mediaobject> <imageobject> <imagedata fileref="screenshot.png" format="PNG"/> </imageobject> <textobject> -<phrase ->The &klipper; icon</phrase> +<phrase>The &klipper; icon</phrase> </textobject> </mediaobject> </screenshot> -<para ->To display the clipboard history, click on the &klipper; icon in the &kde; panel, or press <keycombo action="simul" ->&Ctrl;&Alt;<keycap ->V</keycap -> </keycombo ->. Previous clipboard entries are shown at the top of the pop-up menu which appears. Selecting one of these copies it to the clipboard, from where it can be pasted into any &kde; or X application as usual.</para> - -<para ->To remove &klipper; from your panel, open the pop-up menu and select <guimenuitem ->Quit</guimenuitem ->. A dialogue will ask you whether &klipper; should start automatically when you log in.</para> +<para>To display the clipboard history, click on the &klipper; icon in the &kde; panel, or press <keycombo action="simul">&Ctrl;&Alt;<keycap>V</keycap> </keycombo>. Previous clipboard entries are shown at the top of the pop-up menu which appears. Selecting one of these copies it to the clipboard, from where it can be pasted into any &kde; or X application as usual.</para> + +<para>To remove &klipper; from your panel, open the pop-up menu and select <guimenuitem>Quit</guimenuitem>. A dialogue will ask you whether &klipper; should start automatically when you log in.</para> </sect1> <sect1 id="actions"> -<title ->Actions</title> - -<para ->&klipper; can perform actions on the contents of the clipboard, based on whether they match a particular regular expression. For example, any clipboard contents starting with <quote ->http://</quote -> can be passed to &Netscape; or &konqueror; as &URL;s to open.</para> - -<para ->To use this feature, just copy a &URL; or filename to the clipboard. If there is a matching regular expression in &klipper;'s list, a menu will appear showing you the options you have (⪚ Open &URL; in &konqueror;, open &URL; in &Netscape;). Use the mouse or keyboard to select the option you want, and &klipper; will run the program you have selected, opening the address pointed to by the clipboard contents.</para> - -<para ->If you do not want to perform any actions on the clipboard contents, select <guimenuitem ->Do Nothing</guimenuitem -> on the pop-up menu to return to what you were doing before. If you leave the menu, it will disappear, leaving you to continue your work. You can change the time that the menu remains for in the <guilabel ->Configure Klipper...</guilabel -> dialogue, with the option <guilabel ->Timeout for action pop-ups</guilabel -> under the <guilabel ->General</guilabel -> tab.</para> +<title>Actions</title> + +<para>&klipper; can perform actions on the contents of the clipboard, based on whether they match a particular regular expression. For example, any clipboard contents starting with <quote>http://</quote> can be passed to &Netscape; or &konqueror; as &URL;s to open.</para> + +<para>To use this feature, just copy a &URL; or filename to the clipboard. If there is a matching regular expression in &klipper;'s list, a menu will appear showing you the options you have (⪚ Open &URL; in &konqueror;, open &URL; in &Netscape;). Use the mouse or keyboard to select the option you want, and &klipper; will run the program you have selected, opening the address pointed to by the clipboard contents.</para> + +<para>If you do not want to perform any actions on the clipboard contents, select <guimenuitem>Do Nothing</guimenuitem> on the pop-up menu to return to what you were doing before. If you leave the menu, it will disappear, leaving you to continue your work. You can change the time that the menu remains for in the <guilabel>Configure Klipper...</guilabel> dialogue, with the option <guilabel>Timeout for action pop-ups</guilabel> under the <guilabel>General</guilabel> tab.</para> -<para ->Actions can be disabled completely by clicking on &klipper; and selecting <guimenuitem ->Actions Enabled</guimenuitem ->, or by pressing <keycombo action="simul" ->&Ctrl;&Alt;<keycap ->X</keycap -></keycombo ->.</para> - -<para ->Clipboard contents which match a regular expression can also be edited before performing an action on them. Select <guimenuitem ->Edit contents...</guimenuitem -> on the &klipper; pop-up menu, and you can change the clipboard contents in the dialogue which appears, before clicking the <guibutton ->OK</guibutton -> button to run the appropriate action.</para> - -<para ->Pressing <keycombo action="simul" ->&Ctrl;&Alt;<keycap ->R</keycap -></keycombo -> shows the pop-up menu to repeat the last action which &klipper; performed.</para> +<para>Actions can be disabled completely by clicking on &klipper; and selecting <guimenuitem>Actions Enabled</guimenuitem>, or by pressing <keycombo action="simul">&Ctrl;&Alt;<keycap>X</keycap></keycombo>.</para> + +<para>Clipboard contents which match a regular expression can also be edited before performing an action on them. Select <guimenuitem>Edit contents...</guimenuitem> on the &klipper; pop-up menu, and you can change the clipboard contents in the dialogue which appears, before clicking the <guibutton>OK</guibutton> button to run the appropriate action.</para> + +<para>Pressing <keycombo action="simul">&Ctrl;&Alt;<keycap>R</keycap></keycombo> shows the pop-up menu to repeat the last action which &klipper; performed.</para> </sect1> <sect1 id="clipboard-modes"> -<title ->Clipboard/Selection Behaviour</title> +<title>Clipboard/Selection Behaviour</title> <sect2 id="clipboard-modes-general"> -<title ->General</title> -<para ->&klipper; can be used to set the behaviour of the clipboard and selection in &kde;. </para> - -<note -><para ->The &X-Window; uses two separate clipboard buffers: the <quote ->selection</quote -> and the <quote ->clipboard</quote ->. Text is placed in the selection buffer by simply selecting it, and can be pasted with the middle mouse button. To place text in the clipboard buffer, select it and press <keycombo ->&Ctrl;<keycap ->X</keycap -> </keycombo -> or <keycombo ->&Ctrl;<keycap ->C</keycap -> </keycombo ->. Text from the clipboard buffer is pasted using <keycombo ->&Ctrl;<keycap ->V</keycap -> </keycombo -> or by selecting <menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Paste</guimenuitem -> </menuchoice ->.</para> +<title>General</title> +<para>&klipper; can be used to set the behaviour of the clipboard and selection in &kde;. </para> + +<note><para>The &X-Window; uses two separate clipboard buffers: the <quote>selection</quote> and the <quote>clipboard</quote>. Text is placed in the selection buffer by simply selecting it, and can be pasted with the middle mouse button. To place text in the clipboard buffer, select it and press <keycombo>&Ctrl;<keycap>X</keycap> </keycombo> or <keycombo>&Ctrl;<keycap>C</keycap> </keycombo>. Text from the clipboard buffer is pasted using <keycombo>&Ctrl;<keycap>V</keycap> </keycombo> or by selecting <menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem> </menuchoice>.</para> </note> <!-- &klipper; can be used to set the clipboard mode for the whole of &kde;. The first mode will be familiar to &Microsoft; &Windows; and &Mac; users: Text is inserted into the clipboard using an application's cut/copy (or generally -<keycombo ->&Ctrl;<keycap ->X</keycap -></keycombo -> and -<keycombo ->&Ctrl;<keycap ->C</keycap -></keycombo -> respectively) +<keycombo>&Ctrl;<keycap>X</keycap></keycombo> and +<keycombo>&Ctrl;<keycap>C</keycap></keycombo> respectively) function, and the application's paste (or generally -<keycombo ->&Ctrl;<keycap ->V</keycap -></keycombo ->) function pastes the +<keycombo>&Ctrl;<keycap>V</keycap></keycombo>) function pastes the contents of this clipboard. </para> <para> The second mode will be more familiar to longtime &UNIX; users: Selected text -is copied to this clipboard, and clicking the <mousebutton ->middle</mousebutton -> +is copied to this clipboard, and clicking the <mousebutton>middle</mousebutton> mouse button pastes the contents of this clipboard. --> </sect2> <sect2 id="changing-clipboard-modes"> -<title ->Changing Clipboard/Selection Behaviour</title> -<para ->In order to change clipboard/selection behaviour, select <guimenuitem ->Configure Klipper...</guimenuitem -> from the &klipper; pop-up menu, and in the dialogue box that appears, select the <guilabel ->General</guilabel -> tab. Selecting <guilabel ->Separate clipboard and selection</guilabel -> makes the clipboard and selection function as completely separate buffers as described above. With this option set, the option <guilabel ->Ignore selection</guilabel -> will prevent &klipper; from including the contents of the selection in its clipboard history and from performing actions on the contents of the selection. Selecting <guilabel ->Synchronise contents of the clipboard and the selection</guilabel -> causes the clipboard and selection buffers to always be the same, meaning that text in the selection can be pasted with either the <mousebutton ->middle</mousebutton -> mouse button or the key combination <keycombo ->&Ctrl;<keycap ->V</keycap -> </keycombo ->, and similarly for text in the clipboard buffer. </para> +<title>Changing Clipboard/Selection Behaviour</title> +<para>In order to change clipboard/selection behaviour, select <guimenuitem>Configure Klipper...</guimenuitem> from the &klipper; pop-up menu, and in the dialogue box that appears, select the <guilabel>General</guilabel> tab. Selecting <guilabel>Separate clipboard and selection</guilabel> makes the clipboard and selection function as completely separate buffers as described above. With this option set, the option <guilabel>Ignore selection</guilabel> will prevent &klipper; from including the contents of the selection in its clipboard history and from performing actions on the contents of the selection. Selecting <guilabel>Synchronise contents of the clipboard and the selection</guilabel> causes the clipboard and selection buffers to always be the same, meaning that text in the selection can be pasted with either the <mousebutton>middle</mousebutton> mouse button or the key combination <keycombo>&Ctrl;<keycap>V</keycap> </keycombo>, and similarly for text in the clipboard buffer. </para> <!-- The -<guilabel ->Synchronize contents of the clipboard and the -selection</guilabel -> check box determines the clipboard mode. If the box is +<guilabel>Synchronize contents of the clipboard and the +selection</guilabel> check box determines the clipboard mode. If the box is selected, the clipboard functions in the &UNIX; mode; if not, the &Windows;/&Mac; mode is used. --> @@ -265,141 +131,76 @@ selected, the clipboard functions in the &UNIX; mode; if not, the </chapter> <chapter id="preferences"> -<title ->Configuring Klipper</title> +<title>Configuring Klipper</title> <sect1 id="viewing-options"> -<title ->Viewing the Configuration Dialogue</title> +<title>Viewing the Configuration Dialogue</title> -<para ->To view or change &klipper;'s settings, open the &klipper; pop-up menu, and select <guimenuitem ->Configure Klipper...</guimenuitem ->. The &klipper; configuration dialogue will appear. Its contents are described below.</para> +<para>To view or change &klipper;'s settings, open the &klipper; pop-up menu, and select <guimenuitem>Configure Klipper...</guimenuitem>. The &klipper; configuration dialogue will appear. Its contents are described below.</para> </sect1> <sect1 id="general-tab"> -<title ->General Options</title> +<title>General Options</title> <variablelist> <varlistentry> -<term -><guilabel ->Popup menu at mouse-cursor position</guilabel -></term> -<listitem -><para ->Make the &klipper; pop-up menus appear at the position of the mouse cursor, instead of their default position (in the &kde; Panel). Useful if you use the mouse more than the keyboard.</para -></listitem> +<term><guilabel>Popup menu at mouse-cursor position</guilabel></term> +<listitem><para>Make the &klipper; pop-up menus appear at the position of the mouse cursor, instead of their default position (in the &kde; Panel). Useful if you use the mouse more than the keyboard.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Save clipboard contents on exit</guilabel -></term -> <listitem -><para ->If this option is on, the clipboard history will be saved when &klipper; exits, allowing you to use it next time &klipper; starts.</para> +<term><guilabel>Save clipboard contents on exit</guilabel></term> <listitem><para>If this option is on, the clipboard history will be saved when &klipper; exits, allowing you to use it next time &klipper; starts.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Remove whitespace when executing actions</guilabel -></term> -<listitem -><para ->If selected, any whitespace (spaces, tabs, &etc;) at the beginning and end of the clipboard contents will be removed before passing the clipboard contents to an application. This is useful, for example, if the clipboard contains a &URL; with spaces which, if opened by a web browser, would cause an error.</para> +<term><guilabel>Remove whitespace when executing actions</guilabel></term> +<listitem><para>If selected, any whitespace (spaces, tabs, &etc;) at the beginning and end of the clipboard contents will be removed before passing the clipboard contents to an application. This is useful, for example, if the clipboard contains a &URL; with spaces which, if opened by a web browser, would cause an error.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Replay actions on an item selected from history</guilabel -></term> -<listitem -><para ->If this is switched on, selecting an item from the history causes &klipper; to display the actions pop-up on that item, if appropriate.</para> +<term><guilabel>Replay actions on an item selected from history</guilabel></term> +<listitem><para>If this is switched on, selecting an item from the history causes &klipper; to display the actions pop-up on that item, if appropriate.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Prevent empty clipboard</guilabel -></term> -<listitem -><para ->If selected, the clipboard will never be empty: &klipper; will insert the most recent item from the clipboard history into the clipboard instead of allowing it to be empty.</para -></listitem> +<term><guilabel>Prevent empty clipboard</guilabel></term> +<listitem><para>If selected, the clipboard will never be empty: &klipper; will insert the most recent item from the clipboard history into the clipboard instead of allowing it to be empty.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Ignore selection</guilabel -></term> -<listitem -><para ->Sets the clipboard mode. See <xref linkend="clipboard-modes"/>. </para> +<term><guilabel>Ignore selection</guilabel></term> +<listitem><para>Sets the clipboard mode. See <xref linkend="clipboard-modes"/>. </para> </listitem> -</varlistentry -> +</varlistentry> <varlistentry> -<term -><guilabel ->Synchronise contents of the clipboard and the selection</guilabel -></term> -<listitem -><para ->Sets the clipboard mode. See <xref linkend="clipboard-modes"/>. </para> +<term><guilabel>Synchronise contents of the clipboard and the selection</guilabel></term> +<listitem><para>Sets the clipboard mode. See <xref linkend="clipboard-modes"/>. </para> </listitem> -</varlistentry -> +</varlistentry> <varlistentry> -<term -><guilabel ->Separate clipboard and selection</guilabel -></term> -<listitem -><para ->Sets the clipboard mode. See <xref linkend="clipboard-modes"/>. </para> +<term><guilabel>Separate clipboard and selection</guilabel></term> +<listitem><para>Sets the clipboard mode. See <xref linkend="clipboard-modes"/>. </para> </listitem> -</varlistentry -> +</varlistentry> <varlistentry> -<term -><guilabel ->Timeout for Action pop-ups</guilabel -></term> -<listitem -><para ->Set the time that a pop-up menu will remain for if you do nothing with it.</para -></listitem> +<term><guilabel>Timeout for Action pop-ups</guilabel></term> +<listitem><para>Set the time that a pop-up menu will remain for if you do nothing with it.</para></listitem> </varlistentry> -<varlistentry -><term -><guilabel ->Clipboard history size</guilabel -></term> -<listitem -><para ->Sets the number of items that are stored in the clipboard history.</para -></listitem> +<varlistentry><term><guilabel>Clipboard history size</guilabel></term> +<listitem><para>Sets the number of items that are stored in the clipboard history.</para></listitem> </varlistentry> </variablelist> @@ -407,128 +208,37 @@ selected, the clipboard functions in the &UNIX; mode; if not, the </sect1> <sect1 id="actions-tab"> -<title ->Actions Options</title> +<title>Actions Options</title> <variablelist> <varlistentry> -<term ->Editing Expressions/Actions</term> -<listitem -><para ->On the <guilabel ->Actions</guilabel -> tab, double-click the regular expression or action that you want to edit. An in-place text editing box will appear in which the text can be edited as you wish. Make sure you press <keysym ->Enter</keysym -> when you are done.</para -></listitem> +<term>Editing Expressions/Actions</term> +<listitem><para>On the <guilabel>Actions</guilabel> tab, double-click the regular expression or action that you want to edit. An in-place text editing box will appear in which the text can be edited as you wish. Make sure you press <keysym>Enter</keysym> when you are done.</para></listitem> </varlistentry> <varlistentry> -<term ->Adding Expressions/Actions</term> -<listitem -><para ->Click the <guibutton ->Add Action</guibutton -> button to add a regular expression for &klipper; to match. &klipper; uses &Qt;'s <classname ->QRegExp</classname ->, which understands most regular expressions as you would use in <application ->grep</application -> or <application ->egrep</application -> for instance.</para> -<para ->You can add a description of the regular expression type (⪚ <quote ->HTTP URL</quote ->) by <mousebutton ->left</mousebutton -> clicking in the <guilabel ->Description</guilabel -> column.</para -> - -<note -><para ->You can find detailed information about the use of <classname ->QRegExp</classname -> regular expressions at <ulink url="http://doc.trolltech.com/qregexp.html#details" ->http://doc.trolltech.com/qregexp.html#details</ulink ->. Note that &klipper; does not support the wildcard mode mentioned on this page.</para -></note -> - -<para ->Edit the regular expression as described above. To add a command to execute, <mousebutton ->right</mousebutton -> click, select <guimenuitem ->Add Command</guimenuitem -> and edit the command which appears in the tree under the regular expression.</para> - -<para ->Note that <token ->%s</token -> in the command line is replaced with the clipboard contents, ⪚ if your command definition is <userinput -><command ->kedit</command -> <token ->%s</token -></userinput -> and your clipboard contents are <filename ->/home/phil/textfile</filename ->, the command <userinput -><command ->kedit</command -> <filename ->/home/phil/textfile</filename -></userinput -> will be run. To include <token ->%s</token -> in the command line, escape it with a backslash, as so: <userinput ->\%s</userinput ->.</para -></listitem> +<term>Adding Expressions/Actions</term> +<listitem><para>Click the <guibutton>Add Action</guibutton> button to add a regular expression for &klipper; to match. &klipper; uses &Qt;'s <classname>QRegExp</classname>, which understands most regular expressions as you would use in <application>grep</application> or <application>egrep</application> for instance.</para> +<para>You can add a description of the regular expression type (⪚ <quote>HTTP URL</quote>) by <mousebutton>left</mousebutton> clicking in the <guilabel>Description</guilabel> column.</para> + +<note><para>You can find detailed information about the use of <classname>QRegExp</classname> regular expressions at <ulink url="http://doc.trolltech.com/qregexp.html#details">http://doc.trolltech.com/qregexp.html#details</ulink>. Note that &klipper; does not support the wildcard mode mentioned on this page.</para></note> + +<para>Edit the regular expression as described above. To add a command to execute, <mousebutton>right</mousebutton> click, select <guimenuitem>Add Command</guimenuitem> and edit the command which appears in the tree under the regular expression.</para> + +<para>Note that <token>%s</token> in the command line is replaced with the clipboard contents, ⪚ if your command definition is <userinput><command>kedit</command> <token>%s</token></userinput> and your clipboard contents are <filename>/home/phil/textfile</filename>, the command <userinput><command>kedit</command> <filename>/home/phil/textfile</filename></userinput> will be run. To include <token>%s</token> in the command line, escape it with a backslash, as so: <userinput>\%s</userinput>.</para></listitem> </varlistentry> -<varlistentry -><term -><guibutton ->Advanced...</guibutton -></term> -<listitem -><para ->Brings up the <guilabel ->Disable Actions for windows of type WM_CLASS</guilabel -> dialogue.</para> -<para ->Some programs, such as &konqueror;, use the clipboard internally. If you get unwanted &klipper; pop-ups all the time when using a certain application, do the following:</para> +<varlistentry><term><guibutton>Advanced...</guibutton></term> +<listitem><para>Brings up the <guilabel>Disable Actions for windows of type WM_CLASS</guilabel> dialogue.</para> +<para>Some programs, such as &konqueror;, use the clipboard internally. If you get unwanted &klipper; pop-ups all the time when using a certain application, do the following:</para> <orderedlist> -<listitem -><para ->Open the application.</para -></listitem> -<listitem -><para ->From a terminal, run <userinput -><command ->xprop</command -> | <command ->grep</command -> <parameter ->WM_CLASS</parameter -></userinput -> and then click on the window of the application you are running.</para -></listitem -> -<listitem -><para ->The first string after the equals sign is the one to enter.</para -></listitem> +<listitem><para>Open the application.</para></listitem> +<listitem><para>From a terminal, run <userinput><command>xprop</command> | <command>grep</command> <parameter>WM_CLASS</parameter></userinput> and then click on the window of the application you are running.</para></listitem> +<listitem><para>The first string after the equals sign is the one to enter.</para></listitem> </orderedlist> -<para ->Once the WM_CLASS is added, no more actions will be generated for windows of that application.</para> +<para>Once the WM_CLASS is added, no more actions will be generated for windows of that application.</para> </listitem> </varlistentry> </variablelist> @@ -536,44 +246,23 @@ selected, the clipboard functions in the &UNIX; mode; if not, the </sect1> <sect1 id="shortcuts-tab"> -<title ->Shortcuts Options</title> +<title>Shortcuts Options</title> -<para ->The shortcuts tab allows you to change the keyboard shortcuts which are used to access &klipper; functions. You can change the shortcut to one of three things:</para> +<para>The shortcuts tab allows you to change the keyboard shortcuts which are used to access &klipper; functions. You can change the shortcut to one of three things:</para> <variablelist> <varlistentry> -<term -><guilabel ->None</guilabel -></term> -<listitem -><para ->The selected action cannot be accessed directly from the keyboard</para -></listitem> +<term><guilabel>None</guilabel></term> +<listitem><para>The selected action cannot be accessed directly from the keyboard</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Default</guilabel -></term> -<listitem -><para ->The selected action uses &klipper;'s default key. These are the shortcuts referred to in this manual.</para -></listitem> +<term><guilabel>Default</guilabel></term> +<listitem><para>The selected action uses &klipper;'s default key. These are the shortcuts referred to in this manual.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Custom</guilabel -></term> -<listitem -><para ->The selected action is assigned to the keys you choose.</para> -<para ->To choose a custom key for the action you have selected, click on the representation of a key in the lower right of the screen to activate it, and type the desired key combination on your keyboard, as in any &kde; application. </para -> </listitem> +<term><guilabel>Custom</guilabel></term> +<listitem><para>The selected action is assigned to the keys you choose.</para> +<para>To choose a custom key for the action you have selected, click on the representation of a key in the lower right of the screen to activate it, and type the desired key combination on your keyboard, as in any &kde; application. </para> </listitem> </varlistentry> </variablelist> @@ -581,87 +270,51 @@ selected, the clipboard functions in the &UNIX; mode; if not, the </chapter> <chapter id="credits"> -<title ->Credits and Licence</title> - -<para ->&klipper; </para> -<para ->Program copyright 1998 Andrew Stanley-Jones <email ->asj@cban.com</email -> </para> -<para ->Program copyright 1998-2000 &Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;</para> -<para ->Currently maintained by &Carsten.Pfeiffer; </para> - -<para ->Documentation copyright 2000-2003 &Philip.Rodrigues; &Philip.Rodrigues.mail;</para> +<title>Credits and Licence</title> + +<para>&klipper; </para> +<para>Program copyright 1998 Andrew Stanley-Jones <email>asj@cban.com</email> </para> +<para>Program copyright 1998-2000 &Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;</para> +<para>Currently maintained by &Carsten.Pfeiffer; </para> + +<para>Documentation copyright 2000-2003 &Philip.Rodrigues; &Philip.Rodrigues.mail;</para> &underFDL; &underGPL; </chapter> <appendix id="installation"> -<title ->Installation</title> +<title>Installation</title> <sect1 id="getting-klipper"> -<title ->How to obtain &klipper;</title> +<title>How to obtain &klipper;</title> &install.intro.documentation; </sect1> <sect1 id="compilation"> -<title ->Compilation and Installation</title> -<para ->&klipper; should compile and install along with the tdebase package, and appear on your &kde; panel (&kicker;) when you run &kde; 3. If it does not appear, you can start it by selecting <menuchoice -><guimenu ->Panel Menu</guimenu -><guisubmenu ->Add</guisubmenu -><guisubmenu ->Applet</guisubmenu -><guimenuitem ->Klipper</guimenuitem -> </menuchoice -> in any context menu in &kicker;, the &kde; Panel.</para -> +<title>Compilation and Installation</title> +<para>&klipper; should compile and install along with the tdebase package, and appear on your &kde; panel (&kicker;) when you run &kde; 3. If it does not appear, you can start it by selecting <menuchoice><guimenu>Panel Menu</guimenu><guisubmenu>Add</guisubmenu><guisubmenu>Applet</guisubmenu><guimenuitem>Klipper</guimenuitem> </menuchoice> in any context menu in &kicker;, the &kde; Panel.</para> <screenshot> -<screeninfo ->&klipper; icon</screeninfo> +<screeninfo>&klipper; icon</screeninfo> <mediaobject> <imageobject> <imagedata fileref="screenshot.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Screenshot</phrase> + <phrase>Screenshot</phrase> </textobject> </mediaobject> </screenshot> <!-- -<para ->To remove &klipper; from your panel, select <guimenuitem ->Remove -Klipper</guimenuitem -> from the context menu (accessed by left-clicking the +<para>To remove &klipper; from your panel, select <guimenuitem>Remove +Klipper</guimenuitem> from the context menu (accessed by left-clicking the small handle to the left of the &klipper; icon).</para> --> <!-- -<para ->To disable this, simply remove the file -<filename ->$<envar ->TDEDIR</envar ->/share/autostart/klipper.desktop</filename> -or create a file <filename ->$<envar ->HOME</envar ->/share/autostart/klipper.desktop</filename> +<para>To disable this, simply remove the file +<filename>$<envar>TDEDIR</envar>/share/autostart/klipper.desktop</filename> +or create a file <filename>$<envar>HOME</envar>/share/autostart/klipper.desktop</filename> with the following contents: -<programlisting -> +<programlisting> [Desktop Entry] Hidden=true </programlisting> diff --git a/tde-i18n-en_GB/docs/tdebase/kmenuedit/index.docbook b/tde-i18n-en_GB/docs/tdebase/kmenuedit/index.docbook index a76c87faf69..a1cd85c60c5 100644 --- a/tde-i18n-en_GB/docs/tdebase/kmenuedit/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kmenuedit/index.docbook @@ -4,540 +4,194 @@ <!ENTITY kappname "&kmenuedit;"> <!ENTITY package "tdebase"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <book lang="&language;"> <bookinfo> -<title ->The &kmenuedit; Handbook</title> +<title>The &kmenuedit; Handbook</title> <authorgroup> -<author ->&Milos.Prudek; &Milos.Prudek.mail;</author> - -<othercredit role="reviewer" ->&Lauri.Watts; &Lauri.Watts.mail; </othercredit> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Milos.Prudek; &Milos.Prudek.mail;</author> + +<othercredit role="reviewer">&Lauri.Watts; &Lauri.Watts.mail; </othercredit> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->2000</year> -<holder ->&Milos.Prudek;</holder> +<year>2000</year> +<holder>&Milos.Prudek;</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2000-12-14</date> -<releaseinfo ->0.00.01</releaseinfo> +<date>2000-12-14</date> +<releaseinfo>0.00.01</releaseinfo> -<abstract -><para ->&kmenuedit; allows editing of the &kde; Main menu. </para -></abstract> +<abstract><para>&kmenuedit; allows editing of the &kde; Main menu. </para></abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KDE Menu Editor</keyword> -<keyword ->kmenuedit</keyword> -<keyword ->application</keyword> -<keyword ->program</keyword> -<keyword ->menu</keyword> -<keyword ->kicker</keyword> +<keyword>KDE</keyword> +<keyword>KDE Menu Editor</keyword> +<keyword>kmenuedit</keyword> +<keyword>application</keyword> +<keyword>program</keyword> +<keyword>menu</keyword> +<keyword>kicker</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introduction</title> - -<para ->&kmenuedit; allows editing of &kde; Main menu.</para> - -<para ->&kmenuedit; can be started either by right-clicking <inlinemediaobject -><imageobject -><imagedata fileref="i_k_button.png" format="PNG"/></imageobject -></inlinemediaobject -> the <guiicon ->K</guiicon -> Button, or by choosing <guimenuitem ->Menu Edit</guimenuitem -> from the <guisubmenu ->System</guisubmenu -> submenu of the <guimenu ->Main</guimenu -> menu.</para> - -<para ->&kmenuedit; allows you to:</para> +<title>Introduction</title> + +<para>&kmenuedit; allows editing of &kde; Main menu.</para> + +<para>&kmenuedit; can be started either by right-clicking <inlinemediaobject><imageobject><imagedata fileref="i_k_button.png" format="PNG"/></imageobject></inlinemediaobject> the <guiicon>K</guiicon> Button, or by choosing <guimenuitem>Menu Edit</guimenuitem> from the <guisubmenu>System</guisubmenu> submenu of the <guimenu>Main</guimenu> menu.</para> + +<para>&kmenuedit; allows you to:</para> <itemizedlist> -<listitem -><para ->View and edit current <guimenu ->Main</guimenu -> menu</para -></listitem> -<listitem -><para -><guimenuitem ->Cut</guimenuitem ->, <guimenuitem ->Copy</guimenuitem -> and <guimenuitem ->paste</guimenuitem -> menu items</para -></listitem> -<listitem -><para ->Create and delete submenus</para -></listitem> +<listitem><para>View and edit current <guimenu>Main</guimenu> menu</para></listitem> +<listitem><para><guimenuitem>Cut</guimenuitem>, <guimenuitem>Copy</guimenuitem> and <guimenuitem>paste</guimenuitem> menu items</para></listitem> +<listitem><para>Create and delete submenus</para></listitem> </itemizedlist> </chapter> <chapter id="using-kmenuedit"> -<title ->Using &kmenuedit;</title> +<title>Using &kmenuedit;</title> -<para ->The left application panel shows the Main menu structure. When you browse items in the left panel, the right panel shows detailed information for the highlighted menu item.</para> +<para>The left application panel shows the Main menu structure. When you browse items in the left panel, the right panel shows detailed information for the highlighted menu item.</para> <sect1 id="details-general"> -<title ->General program information</title> +<title>General program information</title> <variablelist> <varlistentry> -<term -><guilabel ->Name</guilabel -></term> -<listitem -><para ->This is the name of your program as it appears in the <guimenu ->Main</guimenu -> menu. It can be different from the real executable name. For instance the name of <command ->mc</command -> executable is "<application ->Midnight Commander</application ->".</para -></listitem> +<term><guilabel>Name</guilabel></term> +<listitem><para>This is the name of your program as it appears in the <guimenu>Main</guimenu> menu. It can be different from the real executable name. For instance the name of <command>mc</command> executable is "<application>Midnight Commander</application>".</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Comment</guilabel -></term> -<listitem -><para ->Describe the program in greater detail in this field. This is entirely optional.</para -></listitem> +<term><guilabel>Comment</guilabel></term> +<listitem><para>Describe the program in greater detail in this field. This is entirely optional.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Command</guilabel -></term> -<listitem -><para ->This is the name of the executable program. Make sure that you have permission to run the program.</para -></listitem> +<term><guilabel>Command</guilabel></term> +<listitem><para>This is the name of the executable program. Make sure that you have permission to run the program.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Type</guilabel -></term> -<listitem -><para ->This field is similar to the Comment field. Describe the type of your program here.</para -></listitem> +<term><guilabel>Type</guilabel></term> +<listitem><para>This field is similar to the Comment field. Describe the type of your program here.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Work Path</guilabel -></term> -<listitem -><para ->Specify the work path of the program. This will be the current path when the program launches. It does not need to be the same as the executable location.</para -></listitem> +<term><guilabel>Work Path</guilabel></term> +<listitem><para>Specify the work path of the program. This will be the current path when the program launches. It does not need to be the same as the executable location.</para></listitem> </varlistentry> <varlistentry> -<term -><guiicon ->Icon List</guiicon -></term> -<listitem -><para -><inlinemediaobject -><imageobject -><imagedata -fileref="icon_sets.png" format="PNG"/></imageobject -></inlinemediaobject -> Click this icon to display a choice of icons. Choose an icon for your program.</para -></listitem> +<term><guiicon>Icon List</guiicon></term> +<listitem><para><inlinemediaobject><imageobject><imagedata +fileref="icon_sets.png" format="PNG"/></imageobject></inlinemediaobject> Click this icon to display a choice of icons. Choose an icon for your program.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Run in Terminal</guilabel -></term> -<listitem -><para ->You must check this if your program requires terminal emulator in order to run. This mainly applies to <link linkend="gloss-console-application" ->console applications</link ->.</para -></listitem> +<term><guilabel>Run in Terminal</guilabel></term> +<listitem><para>You must check this if your program requires terminal emulator in order to run. This mainly applies to <link linkend="gloss-console-application">console applications</link>.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Terminal Options</guilabel -></term> -<listitem -><para ->Put all terminal options in this field.</para -></listitem> +<term><guilabel>Terminal Options</guilabel></term> +<listitem><para>Put all terminal options in this field.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Run as different user</guilabel -></term> -<listitem -><para ->If you want to run this program as a different user (not you), check this checkbox, and provide the username in the <guilabel ->Username</guilabel -> field.</para -></listitem> +<term><guilabel>Run as different user</guilabel></term> +<listitem><para>If you want to run this program as a different user (not you), check this checkbox, and provide the username in the <guilabel>Username</guilabel> field.</para></listitem> </varlistentry> </variablelist> -<para ->You can assign a special keyboard shortcut to launch your program.</para> +<para>You can assign a special keyboard shortcut to launch your program.</para> -<para ->Click the empty button to the right of the <guilabel ->Current key</guilabel -> checkbox and press the key combination on your keyboard that you want to be assigned to your program.</para> +<para>Click the empty button to the right of the <guilabel>Current key</guilabel> checkbox and press the key combination on your keyboard that you want to be assigned to your program.</para> -<para ->A dialogue box will pop up, allowing you to assign a second keybinding to the same item by checking the <guilabel ->Alternate</guilabel -> button. This might be useful, for example, if you often switch keyboard maps, and some shortcuts are not as convenient to type at all times.</para> +<para>A dialogue box will pop up, allowing you to assign a second keybinding to the same item by checking the <guilabel>Alternate</guilabel> button. This might be useful, for example, if you often switch keyboard maps, and some shortcuts are not as convenient to type at all times.</para> -<para ->Click the <guiicon ->x</guiicon -> to clear the shortcut, if you made a mistake. Check the <guilabel ->Multi-Key</guilabel -> box if you want to assign a shortcut that uses more than one key.</para> +<para>Click the <guiicon>x</guiicon> to clear the shortcut, if you made a mistake. Check the <guilabel>Multi-Key</guilabel> box if you want to assign a shortcut that uses more than one key.</para> -<para ->By default the <guilabel ->Auto-Close</guilabel -> box is checked, and the dialogue will close when you have selected a keybinding. Uncheck it if you want the dialogue to stay open.</para> +<para>By default the <guilabel>Auto-Close</guilabel> box is checked, and the dialogue will close when you have selected a keybinding. Uncheck it if you want the dialogue to stay open.</para> -</sect1 -> +</sect1> </chapter> <chapter id="menu-reference"> -<title ->Menu Reference</title> +<title>Menu Reference</title> <variablelist> <varlistentry id="file-new-item"> -<term -><menuchoice -><guimenu -><inlinemediaobject -><imageobject -><imagedata fileref="i_new_item.png" format="PNG"/></imageobject -></inlinemediaobject -> File</guimenu -> <guimenuitem ->New Item</guimenuitem -> </menuchoice -></term -> <listitem -><para -><action ->Adds new menu item.</action -></para -></listitem> +<term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="i_new_item.png" format="PNG"/></imageobject></inlinemediaobject> File</guimenu> <guimenuitem>New Item</guimenuitem> </menuchoice></term> <listitem><para><action>Adds new menu item.</action></para></listitem> </varlistentry> <varlistentry id="file-new-submenu"> -<term -><menuchoice -><guimenu -><inlinemediaobject -><imageobject -><imagedata fileref="i_new_submenu.png" format="PNG"/></imageobject -></inlinemediaobject ->File</guimenu -> <guimenuitem ->New Submenu</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action ->Adds new submenu.</action -></para -></listitem> +<term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="i_new_submenu.png" format="PNG"/></imageobject></inlinemediaobject>File</guimenu> <guimenuitem>New Submenu</guimenuitem> </menuchoice></term> +<listitem><para><action>Adds new submenu.</action></para></listitem> </varlistentry> <varlistentry id="file-quit"> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->Q</keycap -></keycombo -> </shortcut -> <guimenu ->File</guimenu -> <guimenuitem ->Quit</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action ->Quits</action -> &kmenuedit;.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem> </menuchoice></term> +<listitem><para><action>Quits</action> &kmenuedit;.</para></listitem> </varlistentry> <varlistentry id="edit-cut"> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->X</keycap -></keycombo -> </shortcut -> <guimenu -><inlinemediaobject -><imageobject -><imagedata fileref="i_cut.png" format="PNG"/></imageobject -></inlinemediaobject -> Edit</guimenu -> <guimenuitem ->Cut</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action ->Cuts the current menu item to the clipboard.</action -> If you want to move menu item, you should first cut it to the clipboard, move to the destination place using the left panel, and use the <guimenuitem ->Paste</guimenuitem -> function to paste the menu item from the clipboard.</para -></listitem -> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo> </shortcut> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_cut.png" format="PNG"/></imageobject></inlinemediaobject> Edit</guimenu> <guimenuitem>Cut</guimenuitem> </menuchoice></term> +<listitem><para><action>Cuts the current menu item to the clipboard.</action> If you want to move menu item, you should first cut it to the clipboard, move to the destination place using the left panel, and use the <guimenuitem>Paste</guimenuitem> function to paste the menu item from the clipboard.</para></listitem> </varlistentry> <varlistentry id="edit-copy"> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->C</keycap -></keycombo -> </shortcut -> <guimenu -><inlinemediaobject -><imageobject -><imagedata fileref="i_copy.png" format="PNG"/></imageobject -></inlinemediaobject -> Edit</guimenu -> <guimenuitem ->Copy</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action ->Copies the current menu item to the clipboard</action ->. You can later use the <guimenuitem ->Paste</guimenuitem -> function to paste the copied menu itemfrom the clipboard to its destination. You can paste the same item many times.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> </shortcut> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_copy.png" format="PNG"/></imageobject></inlinemediaobject> Edit</guimenu> <guimenuitem>Copy</guimenuitem> </menuchoice></term> +<listitem><para><action>Copies the current menu item to the clipboard</action>. You can later use the <guimenuitem>Paste</guimenuitem> function to paste the copied menu itemfrom the clipboard to its destination. You can paste the same item many times.</para></listitem> </varlistentry> <varlistentry id="edit-paste"> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->V</keycap -></keycombo -> </shortcut -> <guimenu -><inlinemediaobject -><imageobject -><imagedata fileref="i_paste.png" format="PNG"/></imageobject -></inlinemediaobject -> Edit</guimenu -> <guimenuitem ->Paste</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action ->Paste menu item from the clipboard</action -> to currently selected place in the <guimenu ->Main</guimenu -> menu. You must first use <guimenuitem ->Cut</guimenuitem -> or <guimenuitem ->Copy</guimenuitem -> before you can <guimenuitem ->Paste</guimenuitem ->.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo> </shortcut> <guimenu><inlinemediaobject><imageobject><imagedata fileref="i_paste.png" format="PNG"/></imageobject></inlinemediaobject> Edit</guimenu> <guimenuitem>Paste</guimenuitem> </menuchoice></term> +<listitem><para><action>Paste menu item from the clipboard</action> to currently selected place in the <guimenu>Main</guimenu> menu. You must first use <guimenuitem>Cut</guimenuitem> or <guimenuitem>Copy</guimenuitem> before you can <guimenuitem>Paste</guimenuitem>.</para></listitem> </varlistentry> <varlistentry id="edit-delete"> -<term -><menuchoice -><guimenu -><inlinemediaobject -><imageobject -><imagedata fileref="i_delete.png" format="PNG"/></imageobject -></inlinemediaobject -> Edit</guimenu -> <guimenuitem ->Delete</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action ->Deletes currently selected menu item.</action -></para -></listitem> +<term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="i_delete.png" format="PNG"/></imageobject></inlinemediaobject> Edit</guimenu> <guimenuitem>Delete</guimenuitem> </menuchoice></term> +<listitem><para><action>Deletes currently selected menu item.</action></para></listitem> </varlistentry> </variablelist> &help.menu.documentation; <glossary id="glossary"> -<title ->Glossary</title -> +<title>Glossary</title> <glossentry id="gloss-terminal-emulator"> -<glossterm ->Terminal emulator</glossterm> +<glossterm>Terminal emulator</glossterm> <glossdef> -<para ->Terminal emulator is simply a windowed shell; this is known as <quote ->command line window</quote -> in some other environments. If you want to use the shell, you should know at least a few of the system-level commands for your operating system.</para> +<para>Terminal emulator is simply a windowed shell; this is known as <quote>command line window</quote> in some other environments. If you want to use the shell, you should know at least a few of the system-level commands for your operating system.</para> </glossdef> </glossentry> <glossentry id="gloss-applet"> -<glossterm ->Applet</glossterm> -<glossdef -><para ->A small application that occupies very little memory and screen space, and at the same time gives you some useful information or provides a control shortcut. For instance the <application ->Clock</application -> applet shows current time and date (and even a month diary if you click it), and <application ->System Monitor</application -> applet shows how busy your machine currently is in real-time.</para -> </glossdef -> +<glossterm>Applet</glossterm> +<glossdef><para>A small application that occupies very little memory and screen space, and at the same time gives you some useful information or provides a control shortcut. For instance the <application>Clock</application> applet shows current time and date (and even a month diary if you click it), and <application>System Monitor</application> applet shows how busy your machine currently is in real-time.</para> </glossdef> </glossentry> <glossentry id="gloss-legacy-application"> -<glossterm ->Legacy Application</glossterm> +<glossterm>Legacy Application</glossterm> <glossdef> -<para ->An X-window application which was not written with &kde; in mind. Such applications run fine in &kde;. However, they are not warned automatically when you shut down your &kde; session. You therefore must not forget to save documents open in these applications before you log out from &kde;. </para -> <para ->Additionally, many of these applications do not support copying and pasting from &kde; compliant applications. &Netscape; 4.x browser is a prominent example of such application <footnote -><para ->Some <ulink url="http://www.gnome.org" ->GNOME</ulink -> applications may provide limited interoperability with the &kde;.</para -></footnote ->.</para> +<para>An X-window application which was not written with &kde; in mind. Such applications run fine in &kde;. However, they are not warned automatically when you shut down your &kde; session. You therefore must not forget to save documents open in these applications before you log out from &kde;. </para> <para>Additionally, many of these applications do not support copying and pasting from &kde; compliant applications. &Netscape; 4.x browser is a prominent example of such application <footnote><para>Some <ulink url="http://www.gnome.org">GNOME</ulink> applications may provide limited interoperability with the &kde;.</para></footnote>.</para> </glossdef> </glossentry> <glossentry id="gloss-console-application"> -<glossterm ->Console Application</glossterm> +<glossterm>Console Application</glossterm> <glossdef> -<para ->Application originally written for non-graphic, text oriented environment. Such applications run fine in &kde;. They must run within console emulator, like &konsole;. They are not warned automatically when you shut down your &kde; session. You therefore must not forget to save documents open in these applications before you log out from the &kde;.</para> - -<para ->Console applications support copying and pasting from KDE-compliant applications.Simply mark the text in the console application with your mouse, switch to the KDE-compliant application and press <keycombo action="simul" ->&Ctrl; <keycap ->V</keycap -></keycombo -> to paste the text. If you want to copy from &kde; application to a console application, first mark the text with your mouse, press <keycombo action="simul" ->&Ctrl; <keycap ->C</keycap -></keycombo ->, switch to the console application and press the middle button on your mouse<footnote -><para ->If your mouse does not have a middle button, you must press <mousebutton ->left</mousebutton -> and <mousebutton ->right</mousebutton -> button at the same time. This is called <quote ->middle button emulation</quote -> and it must be supported by your operating system to work.</para -></footnote ->.</para> +<para>Application originally written for non-graphic, text oriented environment. Such applications run fine in &kde;. They must run within console emulator, like &konsole;. They are not warned automatically when you shut down your &kde; session. You therefore must not forget to save documents open in these applications before you log out from the &kde;.</para> + +<para>Console applications support copying and pasting from KDE-compliant applications.Simply mark the text in the console application with your mouse, switch to the KDE-compliant application and press <keycombo action="simul">&Ctrl; <keycap>V</keycap></keycombo> to paste the text. If you want to copy from &kde; application to a console application, first mark the text with your mouse, press <keycombo action="simul">&Ctrl; <keycap>C</keycap></keycombo>, switch to the console application and press the middle button on your mouse<footnote><para>If your mouse does not have a middle button, you must press <mousebutton>left</mousebutton> and <mousebutton>right</mousebutton> button at the same time. This is called <quote>middle button emulation</quote> and it must be supported by your operating system to work.</para></footnote>.</para> </glossdef> </glossentry> @@ -547,47 +201,28 @@ fileref="icon_sets.png" format="PNG"/></imageobject <chapter id="credits"> -<title ->Credits and Licence</title> +<title>Credits and Licence</title> -<para ->&kmenuedit; </para> -<para ->Program copyright © 2002, &Raffaele.Sandrini;</para> +<para>&kmenuedit; </para> +<para>Program copyright © 2002, &Raffaele.Sandrini;</para> -<para ->Contributors:</para> +<para>Contributors:</para> <itemizedlist> -<listitem -><para ->&Matthias.Elter; &Matthias.Elter.mail; - Original Author</para -> +<listitem><para>&Matthias.Elter; &Matthias.Elter.mail; - Original Author</para> </listitem> -<listitem -><para ->&Matthias.Ettrich; &Matthias.Ettrich.mail;</para> +<listitem><para>&Matthias.Ettrich; &Matthias.Ettrich.mail;</para> </listitem> -<listitem -><para ->&Daniel.M.Duley; &Daniel.M.Duley.mail;</para> +<listitem><para>&Daniel.M.Duley; &Daniel.M.Duley.mail;</para> </listitem> -<listitem -><para ->&Preston.Brown; &Preston.Brown.mail;</para> +<listitem><para>&Preston.Brown; &Preston.Brown.mail;</para> </listitem> </itemizedlist> -<para ->Documentation copyright © 2000 &Milos.Prudek;</para> +<para>Documentation copyright © 2000 &Milos.Prudek;</para> -<para ->Updated for &kde; 3.0 by &Lauri.Watts; &Lauri.Watts.mail; 2002</para> +<para>Updated for &kde; 3.0 by &Lauri.Watts; &Lauri.Watts.mail; 2002</para> -<para ->Conversion to British English: John Knight <email ->anarchist_tomato@herzeleid.net</email -></para -> +<para>Conversion to British English: John Knight <email>anarchist_tomato@herzeleid.net</email></para> &underFDL; &underGPL; </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/konqueror/basics.docbook b/tde-i18n-en_GB/docs/tdebase/konqueror/basics.docbook index 9ef927158d5..88312563854 100644 --- a/tde-i18n-en_GB/docs/tdebase/konqueror/basics.docbook +++ b/tde-i18n-en_GB/docs/tdebase/konqueror/basics.docbook @@ -2,590 +2,174 @@ <chapterinfo> <authorgroup> -<author ->&Pamela.Roberts;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Pamela.Roberts;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-20</date -> <releaseinfo ->3.2</releaseinfo -> </chapterinfo> - -<title ->&konqueror; Basics</title> - -<important -><para ->Like all &kde; applications, &konqueror; is highly configurable. This document describes how &konqueror; behaves with the normal, default, settings.</para> -<para ->A three button mouse can be useful when you are running &konqueror; or any other &kde; application. If your mouse only has two buttons then you should be able to set your system up so that you can simulate a &MMB; by pressing both buttons at the same time. </para> -<para ->If you are used to having to double-click to perform an action, then take care, because in common with the rest of &kde;, &konqueror; defaults to single-clicking.</para -></important> +<date>2003-10-20</date> <releaseinfo>3.2</releaseinfo> </chapterinfo> + +<title>&konqueror; Basics</title> + +<important><para>Like all &kde; applications, &konqueror; is highly configurable. This document describes how &konqueror; behaves with the normal, default, settings.</para> +<para>A three button mouse can be useful when you are running &konqueror; or any other &kde; application. If your mouse only has two buttons then you should be able to set your system up so that you can simulate a &MMB; by pressing both buttons at the same time. </para> +<para>If you are used to having to double-click to perform an action, then take care, because in common with the rest of &kde;, &konqueror; defaults to single-clicking.</para></important> <sect1 id="konq-start"> -<title ->Starting &konqueror;</title> +<title>Starting &konqueror;</title> -<para ->Being a combined File Manager and Browser, &konqueror; will automatically switch between the two modes as needed when it is running, but it is convenient to be able to choose which mode is to be used when you start it up.</para> +<para>Being a combined File Manager and Browser, &konqueror; will automatically switch between the two modes as needed when it is running, but it is convenient to be able to choose which mode is to be used when you start it up.</para> <itemizedlist> -<listitem -><para ->If you have a <guiicon ->house</guiicon -> shaped icon on the panel or desktop, then <mousebutton ->left</mousebutton -> click on it to open &konqueror; as a file manager.</para -></listitem> - -<listitem -><para ->Or <mousebutton ->left</mousebutton -> click on <guiicon ->world </guiicon -> shaped icon on the panel or desktop to open &konqueror; in browser mode.</para -></listitem> - -<listitem -><para ->From the <guimenu ->K</guimenu -> menu, select <menuchoice -><guisubmenu ->Internet</guisubmenu -><guimenuitem ->Konqueror Web Browser</guimenuitem -></menuchoice -> to start it as a browser, or <guimenuitem ->Home</guimenuitem -> to launch &konqueror; in file manager mode. </para -></listitem> - -<listitem -><para -><keycombo action="simul" ->&Alt;<keycap ->F2</keycap -></keycombo -> will open a <guilabel ->Run Command</guilabel -> dialogue box, type <userinput -><command ->konqueror</command -></userinput -> (lower case) and press <keycap ->Enter</keycap -> or the <guibutton ->Run</guibutton -> button to start in file manager mode, or just enter a &URL; such as <userinput ->http://www.konqueror.org</userinput -> to start &konqueror; as a browser.</para -></listitem> +<listitem><para>If you have a <guiicon>house</guiicon> shaped icon on the panel or desktop, then <mousebutton>left</mousebutton> click on it to open &konqueror; as a file manager.</para></listitem> + +<listitem><para>Or <mousebutton>left</mousebutton> click on <guiicon>world </guiicon> shaped icon on the panel or desktop to open &konqueror; in browser mode.</para></listitem> + +<listitem><para>From the <guimenu>K</guimenu> menu, select <menuchoice><guisubmenu>Internet</guisubmenu><guimenuitem>Konqueror Web Browser</guimenuitem></menuchoice> to start it as a browser, or <guimenuitem>Home</guimenuitem> to launch &konqueror; in file manager mode. </para></listitem> + +<listitem><para><keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> will open a <guilabel>Run Command</guilabel> dialogue box, type <userinput><command>konqueror</command></userinput> (lower case) and press <keycap>Enter</keycap> or the <guibutton>Run</guibutton> button to start in file manager mode, or just enter a &URL; such as <userinput>http://www.konqueror.org</userinput> to start &konqueror; as a browser.</para></listitem> </itemizedlist> -<para ->&konqueror; is also started automatically when you <mousebutton ->left</mousebutton -> click on a desktop icon that represents a folder, such as a hard disk drive or the <guiicon ->Trash</guiicon -> icon. </para> +<para>&konqueror; is also started automatically when you <mousebutton>left</mousebutton> click on a desktop icon that represents a folder, such as a hard disk drive or the <guiicon>Trash</guiicon> icon. </para> </sect1> <sect1 id="parts"> -<title ->The Parts of &konqueror;</title> +<title>The Parts of &konqueror;</title> -<para ->A brief look at the main parts of &konqueror;'s window:</para> +<para>A brief look at the main parts of &konqueror;'s window:</para> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="parts.png"/></imageobject> +<imageobject><imagedata format="PNG" fileref="parts.png"/></imageobject> <textobject> -<phrase ->Here's a screenshot of &konqueror;</phrase> +<phrase>Here's a screenshot of &konqueror;</phrase> </textobject> </mediaobject> -<para ->The <interface ->Titlebar</interface -> is the strip across the top of &konqueror;'s window, and operates in the same way as for other &kde; applications. <mousebutton ->Right</mousebutton -> click on the central portion to bring up the neat Titlebar menu.</para> - -<para ->The <interface ->Menubar</interface -> is the strip containing the names of the drop-down menus. <mousebutton ->Left</mousebutton -> click on a name to alternately show and hide that menu, or use <keycombo action="simul" ->&Alt;<keycap ->the underlined letter</keycap -></keycombo -> in the name as a hot key, for example <keycombo action="simul" ->&Alt;<keycap ->E</keycap -></keycombo -> to show the <guimenu ->Edit</guimenu -> menu. The various menus are described in the <link linkend="menubar" ->Menubar</link -> section of this document.</para> - -<para ->The <interface ->Toolbar</interface -> contains icons for commonly used operations. <mousebutton ->Left</mousebutton -> clicking on an icon will activate it. If you have enabled tooltips in the Control Centre <menuchoice -><guimenu -> Appearance & Themes</guimenu -><guisubmenu ->Style</guisubmenu -></menuchoice -> dialogue a brief description of what that icon does will appear when you hover the pointer over it.</para> - -<para ->Some icons, for example the Up and Back icons in the previous screenshot, have a small black triangle at their bottom right corner. If you hold the &LMB; pressed while the cursor is over this type of icon a small dropdown menu will appear.</para -> <para -><mousebutton ->Right</mousebutton -> clicking on the <interface ->Toolbar </interface -> will bring up the <link linkend="rmb-menus" -><guilabel ->Toolbar Menu</guilabel -></link -> which you can use to change the <interface ->Toolbar</interface ->'s appearance and position.</para> - -<para ->The <interface ->Location Toolbar</interface -> shows the path to the directory, &URL; or file being viewed. You can type a path or &URL; here and press &Enter; or <mousebutton ->left</mousebutton -> click on the <guiicon ->Go</guiicon -> icon at the right hand end of the <interface ->Location Toolbar</interface -> to go to it. The black icon at the left hand end of the <interface ->Location Toolbar</interface -> clears the text entry box.</para> - -<para ->The <interface ->Bookmark Toolbar</interface -> is the area under the <interface ->Location Toolbar</interface -> in the previous screenshot. You can add frequently used bookmarks here, see the <link linkend="orgbmark" ->Organising Your Bookmarks</link -> section of this document.</para> - -<para ->The <interface ->Window</interface -> is the main area of &konqueror; and can show you the contents of a directory, web page, document or image. Using the <link linkend="menu-window" -><guimenu ->Window</guimenu -></link -> menu you can split &konqueror;'s main window into one or more separate views, useful for drag and drop operations, or set it to contain two or more tabbed views. </para> - -<para ->The <interface ->Status Bar</interface -> runs across the bottom of the &konqueror;'s window and often shows general information about whatever the mouse pointer is hovering over. If you have split the main window into a number of views you will get an Status Bar for each view, and it will include a small green light at the left hand end to show which is the <quote ->active</quote -> view. <mousebutton ->Right</mousebutton -> clicking on the Status Bar brings up the Status Bar <link linkend="rmb-menus" -><mousebutton ->Right</mousebutton -> Mouse Button Menu</link ->.</para> - -<note -><para ->Don't worry if your &konqueror; doesn't look exactly like this screenshot, it is highly configurable. In particular:</para> +<para>The <interface>Titlebar</interface> is the strip across the top of &konqueror;'s window, and operates in the same way as for other &kde; applications. <mousebutton>Right</mousebutton> click on the central portion to bring up the neat Titlebar menu.</para> + +<para>The <interface>Menubar</interface> is the strip containing the names of the drop-down menus. <mousebutton>Left</mousebutton> click on a name to alternately show and hide that menu, or use <keycombo action="simul">&Alt;<keycap>the underlined letter</keycap></keycombo> in the name as a hot key, for example <keycombo action="simul">&Alt;<keycap>E</keycap></keycombo> to show the <guimenu>Edit</guimenu> menu. The various menus are described in the <link linkend="menubar">Menubar</link> section of this document.</para> + +<para>The <interface>Toolbar</interface> contains icons for commonly used operations. <mousebutton>Left</mousebutton> clicking on an icon will activate it. If you have enabled tooltips in the Control Centre <menuchoice><guimenu> Appearance & Themes</guimenu><guisubmenu>Style</guisubmenu></menuchoice> dialogue a brief description of what that icon does will appear when you hover the pointer over it.</para> + +<para>Some icons, for example the Up and Back icons in the previous screenshot, have a small black triangle at their bottom right corner. If you hold the &LMB; pressed while the cursor is over this type of icon a small dropdown menu will appear.</para> <para><mousebutton>Right</mousebutton> clicking on the <interface>Toolbar </interface> will bring up the <link linkend="rmb-menus"><guilabel>Toolbar Menu</guilabel></link> which you can use to change the <interface>Toolbar</interface>'s appearance and position.</para> + +<para>The <interface>Location Toolbar</interface> shows the path to the directory, &URL; or file being viewed. You can type a path or &URL; here and press &Enter; or <mousebutton>left</mousebutton> click on the <guiicon>Go</guiicon> icon at the right hand end of the <interface>Location Toolbar</interface> to go to it. The black icon at the left hand end of the <interface>Location Toolbar</interface> clears the text entry box.</para> + +<para>The <interface>Bookmark Toolbar</interface> is the area under the <interface>Location Toolbar</interface> in the previous screenshot. You can add frequently used bookmarks here, see the <link linkend="orgbmark">Organising Your Bookmarks</link> section of this document.</para> + +<para>The <interface>Window</interface> is the main area of &konqueror; and can show you the contents of a directory, web page, document or image. Using the <link linkend="menu-window"><guimenu>Window</guimenu></link> menu you can split &konqueror;'s main window into one or more separate views, useful for drag and drop operations, or set it to contain two or more tabbed views. </para> + +<para>The <interface>Status Bar</interface> runs across the bottom of the &konqueror;'s window and often shows general information about whatever the mouse pointer is hovering over. If you have split the main window into a number of views you will get an Status Bar for each view, and it will include a small green light at the left hand end to show which is the <quote>active</quote> view. <mousebutton>Right</mousebutton> clicking on the Status Bar brings up the Status Bar <link linkend="rmb-menus"><mousebutton>Right</mousebutton> Mouse Button Menu</link>.</para> + +<note><para>Don't worry if your &konqueror; doesn't look exactly like this screenshot, it is highly configurable. In particular:</para> <itemizedlist> -<listitem -><para ->You can use the <link linkend="menu-settings" -><guimenu ->Settings</guimenu -></link -> menu to choose whether to show or hide the Menubar, Main Toolbar, Location Toolbar and Bookmark Toolbar, or even to add an Extra Toolbar.</para -></listitem> -<listitem -><para ->You can also <quote ->flatten</quote -> the toolbars by <mousebutton ->left</mousebutton -> clicking on the vertical lines at the left hand end of the bars, or move them around by holding the &LMB; down while you drag these bars around. </para -></listitem> -<listitem -><para ->This screenshot does not show the optional <link linkend="sidebar" -> Navigation Panel</link ->.</para -></listitem> +<listitem><para>You can use the <link linkend="menu-settings"><guimenu>Settings</guimenu></link> menu to choose whether to show or hide the Menubar, Main Toolbar, Location Toolbar and Bookmark Toolbar, or even to add an Extra Toolbar.</para></listitem> +<listitem><para>You can also <quote>flatten</quote> the toolbars by <mousebutton>left</mousebutton> clicking on the vertical lines at the left hand end of the bars, or move them around by holding the &LMB; down while you drag these bars around. </para></listitem> +<listitem><para>This screenshot does not show the optional <link linkend="sidebar"> Navigation Panel</link>.</para></listitem> </itemizedlist> -<para ->For more details of how to change &konqueror;'s appearance, see the <link linkend="config" ->Configuring &konqueror;</link -> section</para -></note> +<para>For more details of how to change &konqueror;'s appearance, see the <link linkend="config">Configuring &konqueror;</link> section</para></note> </sect1> <sect1 id="bubble"> -<title ->Tooltips and What's This?</title> - -<para ->You can find out a lot about how &konqueror; works without needing to read this entire document if you take advantage of <guilabel ->Tooltips</guilabel -> and the <guimenuitem ->What's This?</guimenuitem -> feature.</para> - -<para ->If <guilabel ->Tooltips</guilabel -> have been enabled in &kde; (TDE menu <menuchoice -><guimenu ->Control Centre</guimenu -><guisubmenu ->Appearance & Themes</guisubmenu -><guisubmenu ->Style</guisubmenu -></menuchoice ->, <guilabel ->Style</guilabel -> dialogue) then when you hover the mouse pointer over a Toolbar or Navigation Panel button it should bring up a terse description of what that button does.</para> - -<para -><guimenuitem ->What's This?</guimenuitem -> is invoked by the Menubar <menuchoice -><guimenu ->Help</guimenu -><guimenuitem ->What's This?</guimenuitem -></menuchoice -> item, by <keycombo action="simul" ->&Shift;<keycap ->F1</keycap -></keycombo ->, or by just &LMB; clicking on the question mark near the top right hand corner of &konqueror;'s window. It changes the cursor to show a question mark alongside the arrow.</para> - -<para ->When this question mark is visible, a &LMB; click won't actually do anything until you have clicked on a control (or the text alongside it) that supports <guimenuitem ->What's This?</guimenuitem ->, in which case it will display a reasonably comprehensive description of what the control is supposed to do. Most of the dialogue boxes that &konqueror; brings up support the <guimenuitem ->What's This?</guimenuitem -> feature.</para> +<title>Tooltips and What's This?</title> + +<para>You can find out a lot about how &konqueror; works without needing to read this entire document if you take advantage of <guilabel>Tooltips</guilabel> and the <guimenuitem>What's This?</guimenuitem> feature.</para> + +<para>If <guilabel>Tooltips</guilabel> have been enabled in &kde; (TDE menu <menuchoice><guimenu>Control Centre</guimenu><guisubmenu>Appearance & Themes</guisubmenu><guisubmenu>Style</guisubmenu></menuchoice>, <guilabel>Style</guilabel> dialogue) then when you hover the mouse pointer over a Toolbar or Navigation Panel button it should bring up a terse description of what that button does.</para> + +<para><guimenuitem>What's This?</guimenuitem> is invoked by the Menubar <menuchoice><guimenu>Help</guimenu><guimenuitem>What's This?</guimenuitem></menuchoice> item, by <keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo>, or by just &LMB; clicking on the question mark near the top right hand corner of &konqueror;'s window. It changes the cursor to show a question mark alongside the arrow.</para> + +<para>When this question mark is visible, a &LMB; click won't actually do anything until you have clicked on a control (or the text alongside it) that supports <guimenuitem>What's This?</guimenuitem>, in which case it will display a reasonably comprehensive description of what the control is supposed to do. Most of the dialogue boxes that &konqueror; brings up support the <guimenuitem>What's This?</guimenuitem> feature.</para> </sect1> <sect1 id="lmb-mmb"> -<title -><mousebutton ->Left</mousebutton -> and <mousebutton ->Middle</mousebutton -> Mouse Button Actions</title> - -<para ->If you click the &LMB; on an item in &konqueror;'s window that item will be <quote ->activated</quote ->. Thus</para> +<title><mousebutton>Left</mousebutton> and <mousebutton>Middle</mousebutton> Mouse Button Actions</title> + +<para>If you click the &LMB; on an item in &konqueror;'s window that item will be <quote>activated</quote>. Thus</para> <itemizedlist> -<listitem -><para -><mousebutton ->Left</mousebutton -> click on an icon in the Toolbar to do whatever that icon is supposed to do. </para -></listitem> -<listitem -><para -><mousebutton ->Left</mousebutton -> click on an item in the Menubar to make that menu drop down.</para -></listitem> -<listitem -><para -><mousebutton ->Left</mousebutton -> click on a menu item to do that thing.</para -></listitem -> -<listitem -><para -><mousebutton ->Left</mousebutton -> click on an icon in the Bookmark Toolbar to open that &URL;.</para -></listitem> -<listitem -><para -><mousebutton ->Left</mousebutton -> click on a link in a web page to make &konqueror; follow that link.</para -></listitem> -<listitem -><para -><mousebutton ->Left</mousebutton -> click on a folder icon or name and &konqueror; will descend into (show the contents of) that folder. </para -></listitem> -<listitem -><para -><mousebutton ->Left</mousebutton -> click on a file name or icon and &konqueror; will do whatever it thinks appropriate, based on the file type. In general this means opening <acronym ->HTML</acronym -> pages, or previewing text, image or <application ->KOffice</application -> files, showing them within &konqueror;'s window (<quote ->Preview</quote -> means that you can see the file but not change it).</para -> - -<para ->&konqueror; decides what the file type is by matching the filename extension against a list of known types. If that fails it tries to guess the type from the file contents. You can change the list of known file types and associated actions with the <guilabel ->File Associations</guilabel -> page of the <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure Konqueror... </guimenuitem -></menuchoice -> dialogue.</para -></listitem> +<listitem><para><mousebutton>Left</mousebutton> click on an icon in the Toolbar to do whatever that icon is supposed to do. </para></listitem> +<listitem><para><mousebutton>Left</mousebutton> click on an item in the Menubar to make that menu drop down.</para></listitem> +<listitem><para><mousebutton>Left</mousebutton> click on a menu item to do that thing.</para></listitem> +<listitem><para><mousebutton>Left</mousebutton> click on an icon in the Bookmark Toolbar to open that &URL;.</para></listitem> +<listitem><para><mousebutton>Left</mousebutton> click on a link in a web page to make &konqueror; follow that link.</para></listitem> +<listitem><para><mousebutton>Left</mousebutton> click on a folder icon or name and &konqueror; will descend into (show the contents of) that folder. </para></listitem> +<listitem><para><mousebutton>Left</mousebutton> click on a file name or icon and &konqueror; will do whatever it thinks appropriate, based on the file type. In general this means opening <acronym>HTML</acronym> pages, or previewing text, image or <application>KOffice</application> files, showing them within &konqueror;'s window (<quote>Preview</quote> means that you can see the file but not change it).</para> + +<para>&konqueror; decides what the file type is by matching the filename extension against a list of known types. If that fails it tries to guess the type from the file contents. You can change the list of known file types and associated actions with the <guilabel>File Associations</guilabel> page of the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror... </guimenuitem></menuchoice> dialogue.</para></listitem> </itemizedlist> -<para ->Clicking the &MMB; on a file or folder name or icon does essentially the same as <mousebutton ->left</mousebutton -> clicking except that it usually does it in a new &konqueror; window, unless the <guilabel ->Open links in new tab instead of in new window</guilabel -> box has been checked in the <guimenuitem ->Behaviour</guimenuitem -> page of the <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure Konqueror...</guimenuitem -></menuchoice -> dialogue.</para> - -<para ->Holding the &Shift; key down while pressing the &MMB; will open the link in the background.</para> -<important -><para ->If you click the &MMB; when the mouse cursor is over a blank part of the main view (not over a link or file name or icon) &konqueror; will copy the contents of the clipboard into the Location Toolbar and try to use that as a &URL;.</para -></important> +<para>Clicking the &MMB; on a file or folder name or icon does essentially the same as <mousebutton>left</mousebutton> clicking except that it usually does it in a new &konqueror; window, unless the <guilabel>Open links in new tab instead of in new window</guilabel> box has been checked in the <guimenuitem>Behaviour</guimenuitem> page of the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror...</guimenuitem></menuchoice> dialogue.</para> + +<para>Holding the &Shift; key down while pressing the &MMB; will open the link in the background.</para> +<important><para>If you click the &MMB; when the mouse cursor is over a blank part of the main view (not over a link or file name or icon) &konqueror; will copy the contents of the clipboard into the Location Toolbar and try to use that as a &URL;.</para></important> </sect1> <sect1 id="rmb-menus"> -<title -><mousebutton ->Right</mousebutton -> Mouse Button Menus</title> - -<para ->Clicking the &RMB; on almost any part of &konqueror;'s window will bring up an appropriate context menu.</para> - -<note -><para ->If you have enabled the <guilabel ->Right click goes back in history</guilabel -> option in &konqueror;'s <link linkend="othersettings" -> configuration</link -> settings a simple <mousebutton ->right</mousebutton -> click is equivalent to clicking on the <guibutton ->Back</guibutton -> button. In this case you can access the context menu by moving the mouse with the <mousebutton ->right</mousebutton -> button held down.</para -></note> +<title><mousebutton>Right</mousebutton> Mouse Button Menus</title> + +<para>Clicking the &RMB; on almost any part of &konqueror;'s window will bring up an appropriate context menu.</para> + +<note><para>If you have enabled the <guilabel>Right click goes back in history</guilabel> option in &konqueror;'s <link linkend="othersettings"> configuration</link> settings a simple <mousebutton>right</mousebutton> click is equivalent to clicking on the <guibutton>Back</guibutton> button. In this case you can access the context menu by moving the mouse with the <mousebutton>right</mousebutton> button held down.</para></note> <variablelist> <varlistentry> -<term ->On the Titlebar</term> -<listitem -><para -><mousebutton ->Right</mousebutton -> clicking on any free area of the Titlebar brings up the Titlebar Menu, allowing you to control the position of &konqueror;'s window as well as the decoration applied to all &kde; program windows. </para -></listitem> +<term>On the Titlebar</term> +<listitem><para><mousebutton>Right</mousebutton> clicking on any free area of the Titlebar brings up the Titlebar Menu, allowing you to control the position of &konqueror;'s window as well as the decoration applied to all &kde; program windows. </para></listitem> </varlistentry> <varlistentry> -<term ->On the Main Toolbar</term> -<listitem -><para -><mousebutton ->Right</mousebutton -> click on any free area of the Toolbar to bring up the Toolbar Menu. You can use it to control whether the Toolbar is at the top, bottom, left or right of &konqueror;'s window. You can also use the Toolbar Menu to set the size of the buttons on the Toolbar, and whether they are shown as icons, text or both.</para -></listitem -> +<term>On the Main Toolbar</term> +<listitem><para><mousebutton>Right</mousebutton> click on any free area of the Toolbar to bring up the Toolbar Menu. You can use it to control whether the Toolbar is at the top, bottom, left or right of &konqueror;'s window. You can also use the Toolbar Menu to set the size of the buttons on the Toolbar, and whether they are shown as icons, text or both.</para></listitem> </varlistentry> <varlistentry> -<term ->On the Location Toolbar</term> -<listitem -><para -><mousebutton ->Right</mousebutton -> click in the &URL; entry box area to perform Cut, Copy, Paste or Clear operations in this area, or to change the automatic <link linkend="path-complete" ->Text Completion</link -> features.</para -></listitem -> +<term>On the Location Toolbar</term> +<listitem><para><mousebutton>Right</mousebutton> click in the &URL; entry box area to perform Cut, Copy, Paste or Clear operations in this area, or to change the automatic <link linkend="path-complete">Text Completion</link> features.</para></listitem> </varlistentry> <varlistentry> -<term ->On the Bookmark Toolbar</term> -<listitem -><para ->If you have the Bookmark Toolbar showing, then <mousebutton ->right</mousebutton -> click on any free part of it to bring up the Bookmark Toolbar Menu which lets you change its position and whether items are shown as text, icons, or both. </para -></listitem -> +<term>On the Bookmark Toolbar</term> +<listitem><para>If you have the Bookmark Toolbar showing, then <mousebutton>right</mousebutton> click on any free part of it to bring up the Bookmark Toolbar Menu which lets you change its position and whether items are shown as text, icons, or both. </para></listitem> </varlistentry> <varlistentry> -<term ->Within a View</term> -<listitem -><para ->If you <mousebutton ->right</mousebutton -> click on any free area of a view then you will get a menu that contains, among other options, the <guiicon ->Up</guiicon ->, <guiicon ->Back</guiicon ->, <guiicon ->Forward</guiicon -> and <guiicon ->Reload</guiicon -> navigation commands. </para -></listitem> +<term>Within a View</term> +<listitem><para>If you <mousebutton>right</mousebutton> click on any free area of a view then you will get a menu that contains, among other options, the <guiicon>Up</guiicon>, <guiicon>Back</guiicon>, <guiicon>Forward</guiicon> and <guiicon>Reload</guiicon> navigation commands. </para></listitem> </varlistentry> <varlistentry> -<term ->On a File or Folder</term> -<listitem -><para ->This is a most useful feature. <mousebutton ->Right</mousebutton -> clicking on the name or icon of any file or folder not only <quote ->selects</quote -> that item but also brings up a menu allowing you to <guiicon ->Cut</guiicon ->, Move, <guiicon ->Copy</guiicon -> or Remove the item in various ways, add it to your <guimenu ->Bookmarks</guimenu ->, open it with the program of your choice or preview it, rename it, or edit the file type or properties.</para -></listitem -> </varlistentry> +<term>On a File or Folder</term> +<listitem><para>This is a most useful feature. <mousebutton>Right</mousebutton> clicking on the name or icon of any file or folder not only <quote>selects</quote> that item but also brings up a menu allowing you to <guiicon>Cut</guiicon>, Move, <guiicon>Copy</guiicon> or Remove the item in various ways, add it to your <guimenu>Bookmarks</guimenu>, open it with the program of your choice or preview it, rename it, or edit the file type or properties.</para></listitem> </varlistentry> <varlistentry> -<term ->On the Status Bar</term> -<listitem -><para -><mousebutton ->Right</mousebutton -> click on the Status Bar at the bottom of a window or view to add or remove a view within &konqueror;'s window.</para -></listitem -> +<term>On the Status Bar</term> +<listitem><para><mousebutton>Right</mousebutton> click on the Status Bar at the bottom of a window or view to add or remove a view within &konqueror;'s window.</para></listitem> </varlistentry> </variablelist> </sect1> <sect1 id="man-info"> -<title ->Viewing Help, Man and Info Pages</title> - -<para ->You can view &kde; Help and &UNIX; Man and Info pages directly in &konqueror;, without having to start up <application ->KHelpCentre</application ->. </para> - -<para ->To view a &kde; Help page, enter <userinput ->help:/<replaceable ->application name</replaceable -></userinput -> (for example <userinput ->help:/kmail</userinput -> to view the &kmail; documentation.) into &konqueror;'s Location Toolbar window. </para> - -<para ->If you want to read &UNIX; Man pages &konqueror; makes it easy. For example type <userinput ->man:/touch</userinput -> or <userinput ->#touch</userinput -> into the Location Toolbar to see the page for the <command ->touch</command -> command.</para -> - -<para ->To browse through &UNIX; Info pages, entering <userinput ->info:/dir</userinput -> takes you to Info's top level directory, then it's just a matter of clicking on the right links to find the page you want. Alternatively, use <userinput ->info:/<replaceable ->command name</replaceable -></userinput -> to go straight to the Info page you want.</para> - -<note -><para ->Unfortunately, &kde; Help pages are stored in such a way that they cannot be viewed in other browsers. If you really need to do this your only recourse is to go online and visit <ulink url="http://docs.kde.org" -> http://docs.kde.org</ulink ->.</para -></note> +<title>Viewing Help, Man and Info Pages</title> + +<para>You can view &kde; Help and &UNIX; Man and Info pages directly in &konqueror;, without having to start up <application>KHelpCentre</application>. </para> + +<para>To view a &kde; Help page, enter <userinput>help:/<replaceable>application name</replaceable></userinput> (for example <userinput>help:/kmail</userinput> to view the &kmail; documentation.) into &konqueror;'s Location Toolbar window. </para> + +<para>If you want to read &UNIX; Man pages &konqueror; makes it easy. For example type <userinput>man:/touch</userinput> or <userinput>#touch</userinput> into the Location Toolbar to see the page for the <command>touch</command> command.</para> + +<para>To browse through &UNIX; Info pages, entering <userinput>info:/dir</userinput> takes you to Info's top level directory, then it's just a matter of clicking on the right links to find the page you want. Alternatively, use <userinput>info:/<replaceable>command name</replaceable></userinput> to go straight to the Info page you want.</para> + +<note><para>Unfortunately, &kde; Help pages are stored in such a way that they cannot be viewed in other browsers. If you really need to do this your only recourse is to go online and visit <ulink url="http://docs.kde.org"> http://docs.kde.org</ulink>.</para></note> </sect1> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/konqueror/bookmarks.docbook b/tde-i18n-en_GB/docs/tdebase/konqueror/bookmarks.docbook index f2ce152d90a..3425b85dd10 100644 --- a/tde-i18n-en_GB/docs/tdebase/konqueror/bookmarks.docbook +++ b/tde-i18n-en_GB/docs/tdebase/konqueror/bookmarks.docbook @@ -1,235 +1,47 @@ <chapter id="bookmarks"> <chapterinfo> <authorgroup> -<author ->&Pamela.Roberts;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Pamela.Roberts;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-11-05</date -> <releaseinfo ->3.2</releaseinfo -> </chapterinfo> - -<title ->Using Bookmarks</title> - -<para ->Although you can use &konqueror;'s bookmarks to record the locations of your own files and folders, they are most useful when you are surfing the Web, letting you build up a list of useful sites.</para> - -<para ->To open the <guimenu ->Bookmarks</guimenu -> menu you may either <mousebutton ->left</mousebutton -> click on the <guimenu ->Bookmarks</guimenu -> menu or use the <keycombo action="simul" ->&Alt;<keycap ->B</keycap -></keycombo -> shortcut. Once the list is visible, you can navigate through it with the arrow keys or with your mouse, then press &Enter; or <mousebutton ->left</mousebutton -> click to visit the selected location.</para> - -<para ->To add a new item to the list use <menuchoice -><guimenu ->Bookmarks </guimenu -><guimenuitem ->Add Bookmark</guimenuitem -></menuchoice -> or <keycombo action="simul" ->&Ctrl;<keycap ->B</keycap -></keycombo -> or <mousebutton ->right</mousebutton -> click on a clear space in the web page or folder view and select <guimenuitem ->Bookmark this Location</guimenuitem -> from the pop up menu.</para> - -<para ->The <guimenu ->Bookmarks</guimenu -> list can contain subfolders containing other bookmarks, you can create these with <menuchoice -><guimenu ->Bookmarks </guimenu -><guimenuitem ->New Bookmark Folder...</guimenuitem -></menuchoice -> . To add a bookmark into a subfolder rather than into the main Bookmark list, select the folder from within the <guimenu ->Bookmarks</guimenu -> list and use the <guimenuitem ->Add Bookmark</guimenuitem -> item in that folder.</para> - -<para ->You can also access your bookmarks from the <link linkend="sidebar" -> <guilabel ->Navigation Panel</guilabel -></link ->.</para> +<date>2003-11-05</date> <releaseinfo>3.2</releaseinfo> </chapterinfo> + +<title>Using Bookmarks</title> + +<para>Although you can use &konqueror;'s bookmarks to record the locations of your own files and folders, they are most useful when you are surfing the Web, letting you build up a list of useful sites.</para> + +<para>To open the <guimenu>Bookmarks</guimenu> menu you may either <mousebutton>left</mousebutton> click on the <guimenu>Bookmarks</guimenu> menu or use the <keycombo action="simul">&Alt;<keycap>B</keycap></keycombo> shortcut. Once the list is visible, you can navigate through it with the arrow keys or with your mouse, then press &Enter; or <mousebutton>left</mousebutton> click to visit the selected location.</para> + +<para>To add a new item to the list use <menuchoice><guimenu>Bookmarks </guimenu><guimenuitem>Add Bookmark</guimenuitem></menuchoice> or <keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo> or <mousebutton>right</mousebutton> click on a clear space in the web page or folder view and select <guimenuitem>Bookmark this Location</guimenuitem> from the pop up menu.</para> + +<para>The <guimenu>Bookmarks</guimenu> list can contain subfolders containing other bookmarks, you can create these with <menuchoice><guimenu>Bookmarks </guimenu><guimenuitem>New Bookmark Folder...</guimenuitem></menuchoice> . To add a bookmark into a subfolder rather than into the main Bookmark list, select the folder from within the <guimenu>Bookmarks</guimenu> list and use the <guimenuitem>Add Bookmark</guimenuitem> item in that folder.</para> + +<para>You can also access your bookmarks from the <link linkend="sidebar"> <guilabel>Navigation Panel</guilabel></link>.</para> <sect1 id="orgbmark"> -<title ->The Bookmark Editor</title> - -<para ->The <menuchoice -><guimenu ->Bookmarks</guimenu -><guimenuitem ->Edit Bookmarks</guimenuitem -> </menuchoice -> option opens the <guilabel ->Bookmark Editor</guilabel ->.</para> -<para ->This shows a tree view of your bookmarks and bookmark subfolders. As is usual for tree views in &kde;, subfolders are shown with a small square at the left of the folder name; if the square contains a <keycap ->+</keycap -> sign <mousebutton ->left</mousebutton -> clicking on it will expand the view to show the contents of that subfolder and the <keycap ->+</keycap -> sign will change to <keycap ->-</keycap ->, <mousebutton ->left</mousebutton -> clicking on the <keycap ->-</keycap -> sign will collapse the subfolder view.</para> - -<para ->To select an item in the list you can <mousebutton ->left</mousebutton -> click on it, or you can navigate through the list by using the <keysym -> Up arrow</keysym -> and <keysym ->Down arrow</keysym -> keys to move around, <keysym ->Right arrow</keysym -> to expand a subfolder and <keysym -> Left arrow</keysym -> to collapse it.</para> - -<para ->You can move an item to a different place in the list by using the normal Drag and Drop or <guimenuitem ->Cut</guimenuitem -> and <guimenuitem -> Paste</guimenuitem -> methods. The order in which the items appear in the <guilabel ->Bookmark Editor</guilabel -> is the order they will appear in the <guimenu ->Bookmarks</guimenu -> drop down list. The <menuchoice -><guimenu ->Insert </guimenu -><guimenuitem ->Insert Separator</guimenuitem -></menuchoice -> option can be used to insert separating lines into the list wherever you wish.</para> - -<para ->A new subfolder can be created at the selected point in the list by using the <guimenuitem ->Create New Folder...</guimenuitem -> option in the <guimenu ->Insert</guimenu -> menu or from the drop down menu you get when you <mousebutton ->right</mousebutton -> click on an item in the main part of the window, or with <keycombo action="simul" ->&Ctrl;<keycap ->N</keycap -></keycombo -> </para> - -<para ->To change the name of a bookmark or folder select it then press <keycap ->F2</keycap -> or choose the <guimenuitem ->Rename</guimenuitem -> item from the <guimenu ->Edit</guimenu -> menu or the pop up menu that appears when you <mousebutton ->right</mousebutton -> click on the item. Similarly, you can edit the &URL; by pressing <keycap ->F3</keycap -> or choosing the <guimenuitem -> Change URL</guimenuitem -> menu item.</para> - -<para ->The <guilabel ->Bookmark Editor</guilabel -> lets you import bookmarks from a range of other browsers into &konqueror;'s bookmark list, putting them into a new folder or replacing all current bookmarks. To do this select <guisubmenu ->Import</guisubmenu -> from the <guimenu ->File</guimenu -> menu. The <menuchoice -><guimenu ->File</guimenu -><guisubmenu ->Export</guisubmenu -> </menuchoice -> option can be used to export &konqueror;'s bookmarks to a &Netscape; or Mozilla browser.</para> - -<para ->If you often use the &Netscape; browser as well as &konqueror;, then rather than importing your &Netscape; bookmarks into &konqueror; it is better to select the <guimenuitem ->Show Netscape Bookmarks in Konqueror Windows</guimenuitem -> item in the <guimenu ->Settings</guimenu -> menu. If you do this any updates to &Netscape;'s bookmarks are automatically seen by &konqueror;.</para> - -<para ->To select which bookmark subfolder is used to hold the Bookmark Toolbar items select the subfolder then choose <guimenuitem ->Set as Toolbar Folder</guimenuitem -> from the <guimenu ->Edit</guimenu -> menu.</para> - -<para ->If you are tidying up your bookmarks and have forgotten what a particular web page is, you can easily open it from within the <guilabel -> Bookmark Editor</guilabel -> by <mousebutton ->right</mousebutton -> clicking on the item and selecting <guimenuitem ->Open in Konqueror</guimenuitem -> from the pop up menu. If you just want to check that the &URL; is still valid select <guimenuitem ->Check Status</guimenuitem -> instead.</para> - -<important -><para ->Don't forget to save your changes with <menuchoice -> <guimenu ->File</guimenu -><guimenuitem ->Save</guimenuitem -></menuchoice -> or <keycombo action="simul" ->&Ctrl;<keycap ->S</keycap -></keycombo -> before you leave the <guilabel ->Bookmark Editor</guilabel ->. </para -></important> -</sect1 -> +<title>The Bookmark Editor</title> + +<para>The <menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Edit Bookmarks</guimenuitem> </menuchoice> option opens the <guilabel>Bookmark Editor</guilabel>.</para> +<para>This shows a tree view of your bookmarks and bookmark subfolders. As is usual for tree views in &kde;, subfolders are shown with a small square at the left of the folder name; if the square contains a <keycap>+</keycap> sign <mousebutton>left</mousebutton> clicking on it will expand the view to show the contents of that subfolder and the <keycap>+</keycap> sign will change to <keycap>-</keycap>, <mousebutton>left</mousebutton> clicking on the <keycap>-</keycap> sign will collapse the subfolder view.</para> + +<para>To select an item in the list you can <mousebutton>left</mousebutton> click on it, or you can navigate through the list by using the <keysym> Up arrow</keysym> and <keysym>Down arrow</keysym> keys to move around, <keysym>Right arrow</keysym> to expand a subfolder and <keysym> Left arrow</keysym> to collapse it.</para> + +<para>You can move an item to a different place in the list by using the normal Drag and Drop or <guimenuitem>Cut</guimenuitem> and <guimenuitem> Paste</guimenuitem> methods. The order in which the items appear in the <guilabel>Bookmark Editor</guilabel> is the order they will appear in the <guimenu>Bookmarks</guimenu> drop down list. The <menuchoice><guimenu>Insert </guimenu><guimenuitem>Insert Separator</guimenuitem></menuchoice> option can be used to insert separating lines into the list wherever you wish.</para> + +<para>A new subfolder can be created at the selected point in the list by using the <guimenuitem>Create New Folder...</guimenuitem> option in the <guimenu>Insert</guimenu> menu or from the drop down menu you get when you <mousebutton>right</mousebutton> click on an item in the main part of the window, or with <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo> </para> + +<para>To change the name of a bookmark or folder select it then press <keycap>F2</keycap> or choose the <guimenuitem>Rename</guimenuitem> item from the <guimenu>Edit</guimenu> menu or the pop up menu that appears when you <mousebutton>right</mousebutton> click on the item. Similarly, you can edit the &URL; by pressing <keycap>F3</keycap> or choosing the <guimenuitem> Change URL</guimenuitem> menu item.</para> + +<para>The <guilabel>Bookmark Editor</guilabel> lets you import bookmarks from a range of other browsers into &konqueror;'s bookmark list, putting them into a new folder or replacing all current bookmarks. To do this select <guisubmenu>Import</guisubmenu> from the <guimenu>File</guimenu> menu. The <menuchoice><guimenu>File</guimenu><guisubmenu>Export</guisubmenu> </menuchoice> option can be used to export &konqueror;'s bookmarks to a &Netscape; or Mozilla browser.</para> + +<para>If you often use the &Netscape; browser as well as &konqueror;, then rather than importing your &Netscape; bookmarks into &konqueror; it is better to select the <guimenuitem>Show Netscape Bookmarks in Konqueror Windows</guimenuitem> item in the <guimenu>Settings</guimenu> menu. If you do this any updates to &Netscape;'s bookmarks are automatically seen by &konqueror;.</para> + +<para>To select which bookmark subfolder is used to hold the Bookmark Toolbar items select the subfolder then choose <guimenuitem>Set as Toolbar Folder</guimenuitem> from the <guimenu>Edit</guimenu> menu.</para> + +<para>If you are tidying up your bookmarks and have forgotten what a particular web page is, you can easily open it from within the <guilabel> Bookmark Editor</guilabel> by <mousebutton>right</mousebutton> clicking on the item and selecting <guimenuitem>Open in Konqueror</guimenuitem> from the pop up menu. If you just want to check that the &URL; is still valid select <guimenuitem>Check Status</guimenuitem> instead.</para> + +<important><para>Don't forget to save your changes with <menuchoice> <guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice> or <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> before you leave the <guilabel>Bookmark Editor</guilabel>. </para></important> +</sect1> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/konqueror/browser.docbook b/tde-i18n-en_GB/docs/tdebase/konqueror/browser.docbook index 1590932907e..62bd773a736 100644 --- a/tde-i18n-en_GB/docs/tdebase/konqueror/browser.docbook +++ b/tde-i18n-en_GB/docs/tdebase/konqueror/browser.docbook @@ -2,580 +2,189 @@ <chapterinfo> <authorgroup> -<author ->&Pamela.Roberts;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Pamela.Roberts;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-11-05</date -> <releaseinfo ->3.2</releaseinfo -> </chapterinfo> +<date>2003-11-05</date> <releaseinfo>3.2</releaseinfo> </chapterinfo> -<title ->&konqueror; the Web Browser</title> +<title>&konqueror; the Web Browser</title> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="konqorg.png"/></imageobject> +<imageobject><imagedata format="PNG" fileref="konqorg.png"/></imageobject> <textobject> -<phrase ->Browsing www.konqueror.org</phrase> +<phrase>Browsing www.konqueror.org</phrase> </textobject> </mediaobject> <sect1 id="conn-inet"> -<title ->Connecting to the Internet</title> +<title>Connecting to the Internet</title> -<para ->Once you are connected to the Internet you can use &konqueror; to browse the Web just as easily as you can use it to handle your local files. Just type a &URL; into the <guilabel ->Location</guilabel -> Toolbar window, press &Enter;, and you are away!</para> +<para>Once you are connected to the Internet you can use &konqueror; to browse the Web just as easily as you can use it to handle your local files. Just type a &URL; into the <guilabel>Location</guilabel> Toolbar window, press &Enter;, and you are away!</para> <itemizedlist> -<listitem -><para ->If you use a dial-up modem connection, then you will be using &kppp; or a similar dialler program to make the connection.</para -></listitem> - -<listitem -><para ->If your machine is connected to a local area network (<acronym ->LAN</acronym ->) that gives you a proxy connection to the Internet then you will have to set &konqueror; up for the proxy connection. This can be done with the <guilabel ->Proxy</guilabel -> page of the <menuchoice -><guimenu -> Settings</guimenu -><guimenuitem ->Configure Konqueror...</guimenuitem -> </menuchoice -> dialogue.</para -></listitem> - -<listitem -><para ->If you are lucky enough to have a high speed cable connection, then the service provider will probably give you an external cable modem which needs an ethernet connection to your machine. Unfortunately the details of how to establish the connection depend on the service provider and to some extent on which Linux/&UNIX; distribution you are using. Some <acronym ->ISP</acronym ->s connect their customers to the Internet through a proxy server, in which case you will have to set up &konqueror; to use it. You may find it useful to search the archives of your distribution's user group mailing list for help.</para> +<listitem><para>If you use a dial-up modem connection, then you will be using &kppp; or a similar dialler program to make the connection.</para></listitem> + +<listitem><para>If your machine is connected to a local area network (<acronym>LAN</acronym>) that gives you a proxy connection to the Internet then you will have to set &konqueror; up for the proxy connection. This can be done with the <guilabel>Proxy</guilabel> page of the <menuchoice><guimenu> Settings</guimenu><guimenuitem>Configure Konqueror...</guimenuitem> </menuchoice> dialogue.</para></listitem> + +<listitem><para>If you are lucky enough to have a high speed cable connection, then the service provider will probably give you an external cable modem which needs an ethernet connection to your machine. Unfortunately the details of how to establish the connection depend on the service provider and to some extent on which Linux/&UNIX; distribution you are using. Some <acronym>ISP</acronym>s connect their customers to the Internet through a proxy server, in which case you will have to set up &konqueror; to use it. You may find it useful to search the archives of your distribution's user group mailing list for help.</para> </listitem> </itemizedlist> -<note -><para ->An error message such as <errorname ->Unknown Host</errorname -> usually means that &konqueror; cannot find a connection to the Internet or that you have entered an incorrect &URL;.</para -></note> +<note><para>An error message such as <errorname>Unknown Host</errorname> usually means that &konqueror; cannot find a connection to the Internet or that you have entered an incorrect &URL;.</para></note> </sect1> <sect1 id="surf"> -<title ->Surfing and Searching</title> - -<para ->Once you have a connection to the Internet, you can surf with &konqueror; just as you can with any other browser.</para> - -<para ->Type a &URL; into the Location Toolbar window, press &Enter; or <mousebutton ->left</mousebutton -> click on the <guibutton ->Go</guibutton -> button at the right hand end of the Location Toolbar, and &konqueror; will download and display that page. If you have visited the page before, &konqueror;'s <link linkend="path-complete" ->Automatic Text Completion</link -> feature can help you type the &URL; a second time, or you could look through the <guilabel ->History</guilabel -> page in the <link linkend="sidebar" ->Navigation Panel</link ->. If you want to use one of the web's search engines, &konqueror;'s <link linkend="enhanced-browsing" -> Web Shortcuts</link -> feature can make this easier.</para> - -<para -><mousebutton ->Left</mousebutton -> click on a link in the page to go there.</para> - -<para ->To open a link in a new instance of &konqueror;, leaving the old page still visible, &MMB; click on the link or <mousebutton -> right </mousebutton -> click on it and select the <guimenuitem ->Open in New Window</guimenuitem -> option.</para> - -<para ->You could also select the multiple view mode with <keycombo action="simul" ->&Ctrl;&Shift;<keycap ->L</keycap -> </keycombo -> or the Menubar <menuchoice -><guimenu ->Window</guimenu -> <guimenuitem ->Split View Left/Right</guimenuitem -></menuchoice -> option which will let you see different pages at the same time. This can be useful if you are looking through a complicated set of <acronym ->HTML</acronym -> pages, but make sure the little link box at the bottom right hand corner is empty when you are doing this.</para> -<para -><link linkend="tabbrowse" ->Tabbed Browsing</link -> will let you hold a number of pages in one &konqueror; window and quickly switch between them with a single mouse click.</para> -<para ->To go back to the previous page use the <keycombo action="simul" ->&Alt;<keysym ->Left Arrow</keysym -></keycombo -> shortcut, the <guibutton ->Back</guibutton -> button on the Toolbar, or the Menubar <menuchoice -><guimenu ->Go</guimenu -> <guimenuitem ->Back</guimenuitem -></menuchoice -> option.</para> -<para ->Similarly, once you have gone back you can go forward by using <keycombo action="simul" ->&Alt;<keysym ->Right Arrow</keysym -></keycombo ->, the <guibutton ->Forward</guibutton -> button, or the Menubar <menuchoice -><guimenu ->Go</guimenu -> <guimenuitem ->Forward</guimenuitem -></menuchoice -> option.</para> - -<para ->If you want to stop the download for any reason then use the <keycap ->Esc</keycap -> key, the Toolbar <guibutton ->Stop</guibutton -> button or the Menubar <menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Stop</guimenuitem -></menuchoice -> item.</para> - -<para ->When you are viewing a web page you should see two new icons in the Toolbar, looking like magnifying glasses with small <keycap ->+</keycap -> and <keycap ->-</keycap -> symbols. Use these to adjust the size of the text in the page if you find it difficult to read. How well this works will depend on how the web page has been constructed.</para> +<title>Surfing and Searching</title> + +<para>Once you have a connection to the Internet, you can surf with &konqueror; just as you can with any other browser.</para> + +<para>Type a &URL; into the Location Toolbar window, press &Enter; or <mousebutton>left</mousebutton> click on the <guibutton>Go</guibutton> button at the right hand end of the Location Toolbar, and &konqueror; will download and display that page. If you have visited the page before, &konqueror;'s <link linkend="path-complete">Automatic Text Completion</link> feature can help you type the &URL; a second time, or you could look through the <guilabel>History</guilabel> page in the <link linkend="sidebar">Navigation Panel</link>. If you want to use one of the web's search engines, &konqueror;'s <link linkend="enhanced-browsing"> Web Shortcuts</link> feature can make this easier.</para> + +<para><mousebutton>Left</mousebutton> click on a link in the page to go there.</para> + +<para>To open a link in a new instance of &konqueror;, leaving the old page still visible, &MMB; click on the link or <mousebutton> right </mousebutton> click on it and select the <guimenuitem>Open in New Window</guimenuitem> option.</para> + +<para>You could also select the multiple view mode with <keycombo action="simul">&Ctrl;&Shift;<keycap>L</keycap> </keycombo> or the Menubar <menuchoice><guimenu>Window</guimenu> <guimenuitem>Split View Left/Right</guimenuitem></menuchoice> option which will let you see different pages at the same time. This can be useful if you are looking through a complicated set of <acronym>HTML</acronym> pages, but make sure the little link box at the bottom right hand corner is empty when you are doing this.</para> +<para><link linkend="tabbrowse">Tabbed Browsing</link> will let you hold a number of pages in one &konqueror; window and quickly switch between them with a single mouse click.</para> +<para>To go back to the previous page use the <keycombo action="simul">&Alt;<keysym>Left Arrow</keysym></keycombo> shortcut, the <guibutton>Back</guibutton> button on the Toolbar, or the Menubar <menuchoice><guimenu>Go</guimenu> <guimenuitem>Back</guimenuitem></menuchoice> option.</para> +<para>Similarly, once you have gone back you can go forward by using <keycombo action="simul">&Alt;<keysym>Right Arrow</keysym></keycombo>, the <guibutton>Forward</guibutton> button, or the Menubar <menuchoice><guimenu>Go</guimenu> <guimenuitem>Forward</guimenuitem></menuchoice> option.</para> + +<para>If you want to stop the download for any reason then use the <keycap>Esc</keycap> key, the Toolbar <guibutton>Stop</guibutton> button or the Menubar <menuchoice><guimenu>View</guimenu> <guimenuitem>Stop</guimenuitem></menuchoice> item.</para> + +<para>When you are viewing a web page you should see two new icons in the Toolbar, looking like magnifying glasses with small <keycap>+</keycap> and <keycap>-</keycap> symbols. Use these to adjust the size of the text in the page if you find it difficult to read. How well this works will depend on how the web page has been constructed.</para> </sect1> <sect1 id="tabbrowse"> -<title ->Tabbed Browsing</title> -<para ->By using this feature you can make &konqueror; load multiple web pages in the same window, and switch between them using tabbed pages. This way, you can preload a page <quote ->in the background</quote -> while you carry on reading another.</para> - -<para ->To use tabbed browsing, <mousebutton ->right</mousebutton -> click on a link and choose <guimenuitem ->Open in New Tab</guimenuitem -> from the drop down menu. The page will be downloaded and displayed as normal, but with tabs across the top of the view, one tab for each page. <mousebutton ->Left </mousebutton -> click on a tab to view that page, or you can use the shortcuts <keycombo action="simul" ->&Ctrl;<keycap ->[</keycap -></keycombo -> and <keycombo action="simul" ->&Ctrl;<keycap ->]</keycap -></keycombo -> to cycle through the tab pages.</para> - -<para ->The <guimenuitem ->Open in Background Tab</guimenuitem -> option in the &RMB; menu also downloads the page and shows a new tab for it, but the new page will not be displayed until you <mousebutton ->left</mousebutton -> click on the tab.</para> - -<para ->If you check the <guilabel ->Open links in new tab instead of in new window </guilabel -> box in the <guimenuitem ->Web Behaviour</guimenuitem -> page of the <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure Konqueror... </guimenuitem -></menuchoice -> dialogue, &MMB; clicking on a link will open it in a new tab page and if you hold the &Shift; key down while clicking the &MMB; the link will be opened in a background tab page.</para> - -<para -><mousebutton ->Right</mousebutton -> clicking on a tab will bring up a menu with the following options:</para> +<title>Tabbed Browsing</title> +<para>By using this feature you can make &konqueror; load multiple web pages in the same window, and switch between them using tabbed pages. This way, you can preload a page <quote>in the background</quote> while you carry on reading another.</para> + +<para>To use tabbed browsing, <mousebutton>right</mousebutton> click on a link and choose <guimenuitem>Open in New Tab</guimenuitem> from the drop down menu. The page will be downloaded and displayed as normal, but with tabs across the top of the view, one tab for each page. <mousebutton>Left </mousebutton> click on a tab to view that page, or you can use the shortcuts <keycombo action="simul">&Ctrl;<keycap>[</keycap></keycombo> and <keycombo action="simul">&Ctrl;<keycap>]</keycap></keycombo> to cycle through the tab pages.</para> + +<para>The <guimenuitem>Open in Background Tab</guimenuitem> option in the &RMB; menu also downloads the page and shows a new tab for it, but the new page will not be displayed until you <mousebutton>left</mousebutton> click on the tab.</para> + +<para>If you check the <guilabel>Open links in new tab instead of in new window </guilabel> box in the <guimenuitem>Web Behaviour</guimenuitem> page of the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror... </guimenuitem></menuchoice> dialogue, &MMB; clicking on a link will open it in a new tab page and if you hold the &Shift; key down while clicking the &MMB; the link will be opened in a background tab page.</para> + +<para><mousebutton>Right</mousebutton> clicking on a tab will bring up a menu with the following options:</para> <variablelist> <varlistentry> -<term -><guimenuitem ->New Tab</guimenuitem -></term> -<listitem -><para ->This opens a new, blank, tabbed page view. You can then download a web page into it by typing the &URL; into the Location Bar or by making a selection from the Bookmark Toolbar or the <link linkend="sidebar" ->Navigation Panel</link -> history page.</para> +<term><guimenuitem>New Tab</guimenuitem></term> +<listitem><para>This opens a new, blank, tabbed page view. You can then download a web page into it by typing the &URL; into the Location Bar or by making a selection from the Bookmark Toolbar or the <link linkend="sidebar">Navigation Panel</link> history page.</para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Duplicate Tab</guimenuitem -></term> -<listitem -><para ->To create a duplicate tabbed page.</para> +<term><guimenuitem>Duplicate Tab</guimenuitem></term> +<listitem><para>To create a duplicate tabbed page.</para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Detach Tab</guimenuitem -></term> -<listitem -><para ->This option removes the selected tabbed page from the current &konqueror; window and opens it in a new instance of &konqueror;.</para> +<term><guimenuitem>Detach Tab</guimenuitem></term> +<listitem><para>This option removes the selected tabbed page from the current &konqueror; window and opens it in a new instance of &konqueror;.</para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Close Tab</guimenuitem -></term> -<listitem -><para ->To close the selected tab page.</para> +<term><guimenuitem>Close Tab</guimenuitem></term> +<listitem><para>To close the selected tab page.</para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Reload</guimenuitem -></term> -<listitem -><para ->Reloads the content of the current tab.</para> +<term><guimenuitem>Reload</guimenuitem></term> +<listitem><para>Reloads the content of the current tab.</para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Reload all Tabs</guimenuitem -></term> -<listitem -><para ->Reloads the content of every tab.</para> +<term><guimenuitem>Reload all Tabs</guimenuitem></term> +<listitem><para>Reloads the content of every tab.</para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Switch to Tab</guimenuitem -></term> -<listitem -><para ->Displays a submenu showing all other tabs. Choosing a tab from this list makes it the active tab.</para> +<term><guimenuitem>Switch to Tab</guimenuitem></term> +<listitem><para>Displays a submenu showing all other tabs. Choosing a tab from this list makes it the active tab.</para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Close Other Tabs</guimenuitem -></term> -<listitem -><para ->To close all but the selected tab page.</para> +<term><guimenuitem>Close Other Tabs</guimenuitem></term> +<listitem><para>To close all but the selected tab page.</para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="enhanced-browsing"> -<title ->Web Shortcuts</title -> <para ->If enabled, &konqueror;'s Web Shortcuts feature lets you submit a query directly to a search engine or similar web site without having to visit the site first.</para -> <para ->For example, entering <userinput ->gg:konqueror</userinput -> into the Location Bar and pressing &Enter; will ask <trademark ->Google</trademark -> to search for items related to &konqueror;.</para -> <para ->To see what Web Shortcuts are available, and perhaps add your own, use <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure Konqueror...</guimenuitem -></menuchoice -> to open the <guilabel ->Settings </guilabel -> dialogue box and click on the <guiicon ->Web Shortcuts</guiicon -> icon.</para> +<title>Web Shortcuts</title> <para>If enabled, &konqueror;'s Web Shortcuts feature lets you submit a query directly to a search engine or similar web site without having to visit the site first.</para> <para>For example, entering <userinput>gg:konqueror</userinput> into the Location Bar and pressing &Enter; will ask <trademark>Google</trademark> to search for items related to &konqueror;.</para> <para>To see what Web Shortcuts are available, and perhaps add your own, use <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror...</guimenuitem></menuchoice> to open the <guilabel>Settings </guilabel> dialogue box and click on the <guiicon>Web Shortcuts</guiicon> icon.</para> </sect1> <sect1 id="useragent"> -<title ->Browser Identification</title> -<para ->When &konqueror; connects to a web site it sends some brief browser identification information, known as the <quote ->User Agent</quote -> string. Many web sites use this information to customise the pages that they send back, based on the strengths and weaknesses of different browsers.</para> -<para ->Unfortunately, some badly designed sites refuse to work properly unless you are using a browser that the site recognizes as a <quote ->valid</quote -> one, even though if given a chance, &konqueror; will work satisfactorily with the vast majority of web pages.</para> -<para ->To overcome this problem, you can change the browser identification information that &konqueror; sends for specific sites or domains by selecting <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem -> Configure Konqueror...</guimenuitem -></menuchoice -> to bring up the <guilabel -> Settings</guilabel -> dialogue box and clicking the <guiicon ->Browser Identification</guiicon -> icon.</para> -<note -><para ->Problems with getting a web page to work properly may also be due to its use of &Java; or JavaScript. If you suspect that this may be the case check that they have been enabled in the <guiicon ->Java & JavaScript </guiicon -> section of the <guilabel ->Settings</guilabel -> dialogue box.</para -></note> +<title>Browser Identification</title> +<para>When &konqueror; connects to a web site it sends some brief browser identification information, known as the <quote>User Agent</quote> string. Many web sites use this information to customise the pages that they send back, based on the strengths and weaknesses of different browsers.</para> +<para>Unfortunately, some badly designed sites refuse to work properly unless you are using a browser that the site recognizes as a <quote>valid</quote> one, even though if given a chance, &konqueror; will work satisfactorily with the vast majority of web pages.</para> +<para>To overcome this problem, you can change the browser identification information that &konqueror; sends for specific sites or domains by selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem> Configure Konqueror...</guimenuitem></menuchoice> to bring up the <guilabel> Settings</guilabel> dialogue box and clicking the <guiicon>Browser Identification</guiicon> icon.</para> +<note><para>Problems with getting a web page to work properly may also be due to its use of &Java; or JavaScript. If you suspect that this may be the case check that they have been enabled in the <guiicon>Java & JavaScript </guiicon> section of the <guilabel>Settings</guilabel> dialogue box.</para></note> </sect1> <sect1 id="save-print-web"> -<title ->Saving and Printing Web Items</title> - -<para ->When you are viewing a web page you can save it (or at least the basic <acronym ->HTML</acronym -> or similar source text) to your local disk with <menuchoice -><guimenu ->Location</guimenu -><guimenuitem ->Save As...</guimenuitem -></menuchoice ->. If the page you are viewing uses frames, then you will also be given the <menuchoice -><guimenu ->Location</guimenu -><guimenuitem ->Save Frame As...</guimenuitem -></menuchoice -> option. <mousebutton ->Left</mousebutton -> click in the frame you want to save first.</para> - -<para ->If the page uses a background image, you can get and save that with the <menuchoice -><guimenu ->Location</guimenu -><guimenuitem ->Save Background Image As...</guimenuitem -></menuchoice -> option.</para> - -<para ->But if what you really want is that glorious picture of the latest Ferrari, then <mousebutton ->right</mousebutton -> clicking on the image will give you a drop-down menu with a <guimenuitem ->Save Image As...</guimenuitem -> option. Be sure to respect the owner's copyright, and ask for permission before using any pictures saved this way for anything other than your own viewing pleasure.</para> - -<para ->If you <mousebutton ->right</mousebutton -> click on a link (which may be a picture) and select <guimenuitem ->Save Link As...</guimenuitem -> from the pop up menu the basic <acronym ->HTML</acronym -> or similar source text will be downloaded and saved on your local disk.</para> - -<para -><mousebutton ->Right</mousebutton -> clicking on a link (which may be a picture) and choosing <guimenuitem ->Copy Link Location</guimenuitem -> will copy the &URL; of the link to the clipboard so you can then paste it into, say, an e-mail to a friend telling her about this wonderful new site.</para> - -<para -><mousebutton ->Right</mousebutton -> clicking on a picture and choosing <guimenuitem ->Copy Image Location</guimenuitem -> copies the &URL; of the picture to the clipboard.</para> - -<para ->To save a complete web page, including images, select <guimenuitem -> Archive Web Page...</guimenuitem -> from the <guimenu ->Tools</guimenu -> menu. Note that this feature is provided by a <link linkend="konq-plugin" ->plugin </link -> and may not have been installed on your system. The web page will be saved as a single file with a <literal role="extension" ->.war</literal -> extension and can be opened by <mousebutton ->left</mousebutton -> clicking on the filename in &konqueror; running in File Manager mode.</para> - -<para ->Printing a copy of the page you are viewing is easily done with the Menubar <menuchoice -><guimenu ->Location</guimenu -> <guimenuitem ->Print...</guimenuitem -></menuchoice -> or <guimenuitem ->Print Frame</guimenuitem -> option or with the Toolbar <guiicon ->Print</guiicon -> button.</para> +<title>Saving and Printing Web Items</title> + +<para>When you are viewing a web page you can save it (or at least the basic <acronym>HTML</acronym> or similar source text) to your local disk with <menuchoice><guimenu>Location</guimenu><guimenuitem>Save As...</guimenuitem></menuchoice>. If the page you are viewing uses frames, then you will also be given the <menuchoice><guimenu>Location</guimenu><guimenuitem>Save Frame As...</guimenuitem></menuchoice> option. <mousebutton>Left</mousebutton> click in the frame you want to save first.</para> + +<para>If the page uses a background image, you can get and save that with the <menuchoice><guimenu>Location</guimenu><guimenuitem>Save Background Image As...</guimenuitem></menuchoice> option.</para> + +<para>But if what you really want is that glorious picture of the latest Ferrari, then <mousebutton>right</mousebutton> clicking on the image will give you a drop-down menu with a <guimenuitem>Save Image As...</guimenuitem> option. Be sure to respect the owner's copyright, and ask for permission before using any pictures saved this way for anything other than your own viewing pleasure.</para> + +<para>If you <mousebutton>right</mousebutton> click on a link (which may be a picture) and select <guimenuitem>Save Link As...</guimenuitem> from the pop up menu the basic <acronym>HTML</acronym> or similar source text will be downloaded and saved on your local disk.</para> + +<para><mousebutton>Right</mousebutton> clicking on a link (which may be a picture) and choosing <guimenuitem>Copy Link Location</guimenuitem> will copy the &URL; of the link to the clipboard so you can then paste it into, say, an e-mail to a friend telling her about this wonderful new site.</para> + +<para><mousebutton>Right</mousebutton> clicking on a picture and choosing <guimenuitem>Copy Image Location</guimenuitem> copies the &URL; of the picture to the clipboard.</para> + +<para>To save a complete web page, including images, select <guimenuitem> Archive Web Page...</guimenuitem> from the <guimenu>Tools</guimenu> menu. Note that this feature is provided by a <link linkend="konq-plugin">plugin </link> and may not have been installed on your system. The web page will be saved as a single file with a <literal role="extension">.war</literal> extension and can be opened by <mousebutton>left</mousebutton> clicking on the filename in &konqueror; running in File Manager mode.</para> + +<para>Printing a copy of the page you are viewing is easily done with the Menubar <menuchoice><guimenu>Location</guimenu> <guimenuitem>Print...</guimenuitem></menuchoice> or <guimenuitem>Print Frame</guimenuitem> option or with the Toolbar <guiicon>Print</guiicon> button.</para> </sect1> <sect1 id="ftp"> -<title ->&FTP;</title> - -<para ->&FTP;, or File Transfer Protocol, is one of the the earliest, and still perhaps the best, way of transferring files between computers over the Internet.</para> - -<para ->With &FTP; you can see files and folders on the distant computer just as if they were on your own system, download them onto your computer using &konqueror;'s normal <guimenuitem ->Copy</guimenuitem -> and <guimenuitem ->Paste</guimenuitem -> or Drag 'n Drop methods and, if allowed, upload files from your machine to the other computer's filesystem. To try it, type the &URL;</para> - -<screen -><userinput ->ftp://ftp.kde.org/pub/kde</userinput -> +<title>&FTP;</title> + +<para>&FTP;, or File Transfer Protocol, is one of the the earliest, and still perhaps the best, way of transferring files between computers over the Internet.</para> + +<para>With &FTP; you can see files and folders on the distant computer just as if they were on your own system, download them onto your computer using &konqueror;'s normal <guimenuitem>Copy</guimenuitem> and <guimenuitem>Paste</guimenuitem> or Drag 'n Drop methods and, if allowed, upload files from your machine to the other computer's filesystem. To try it, type the &URL;</para> + +<screen><userinput>ftp://ftp.kde.org/pub/kde</userinput> </screen> -<para ->into the Location Toolbar and press &Enter;. As long as you are connected to the Internet, and as long as the &kde;'s &FTP; site is not too busy, you should end up seeing the <filename class="directory" ->/pub/kde</filename -> folder at &kde-ftp;</para> - -<note -><para ->Although, strictly speaking, &FTP; &URL;s should be entered starting with <userinput ->ftp://</userinput -> and <acronym ->WWW </acronym -> &URL;s starting with <userinput ->http://</userinput -> &konqueror; is usually smart enough to figure out what is meant, and insert these characters for you if you leave them out.</para -></note> - -<para ->When you access an &FTP; site it will usually need some form of username and password from you. To simplify things, most &FTP; sites that offer files for free downloading will accept the word <systemitem class="username" -> anonymous</systemitem -> as a username and your email address as a password, and to make your life even easier &konqueror; will automatically supply these without troubling you. </para> - -<note -><para ->If you try to access an &FTP; site that does not need a proper username or password but which is too busy to accept any more connections, &konqueror; often interprets the <quote ->busy</quote -> message as a request for a name and password and will therefore pop up a dialogue box asking you to supply them.</para -></note> - -<para ->Sites that are more concerned with security will need a proper username and password, in which case &konqueror; will ask you for them or you can include the username in the &URL; you type into the Location Toolbar, as for example</para> - -<screen -><userinput ->ftp://<replaceable ->username</replaceable ->@ftp.cia.org</userinput -> +<para>into the Location Toolbar and press &Enter;. As long as you are connected to the Internet, and as long as the &kde;'s &FTP; site is not too busy, you should end up seeing the <filename class="directory">/pub/kde</filename> folder at &kde-ftp;</para> + +<note><para>Although, strictly speaking, &FTP; &URL;s should be entered starting with <userinput>ftp://</userinput> and <acronym>WWW </acronym> &URL;s starting with <userinput>http://</userinput> &konqueror; is usually smart enough to figure out what is meant, and insert these characters for you if you leave them out.</para></note> + +<para>When you access an &FTP; site it will usually need some form of username and password from you. To simplify things, most &FTP; sites that offer files for free downloading will accept the word <systemitem class="username"> anonymous</systemitem> as a username and your email address as a password, and to make your life even easier &konqueror; will automatically supply these without troubling you. </para> + +<note><para>If you try to access an &FTP; site that does not need a proper username or password but which is too busy to accept any more connections, &konqueror; often interprets the <quote>busy</quote> message as a request for a name and password and will therefore pop up a dialogue box asking you to supply them.</para></note> + +<para>Sites that are more concerned with security will need a proper username and password, in which case &konqueror; will ask you for them or you can include the username in the &URL; you type into the Location Toolbar, as for example</para> + +<screen><userinput>ftp://<replaceable>username</replaceable>@ftp.cia.org</userinput> </screen> -<para ->&konqueror; will then prompt you for the password.</para> +<para>&konqueror; will then prompt you for the password.</para> -<para ->&konqueror; can also support automatic logins as specified in a <filename ->.netrc</filename -> file. Details of how to enable this feature are given at <ulink url="http://www.konqueror.org/faq.html#netrc" -> http://www.konqueror.org/faq.html#netrc</ulink -></para> +<para>&konqueror; can also support automatic logins as specified in a <filename>.netrc</filename> file. Details of how to enable this feature are given at <ulink url="http://www.konqueror.org/faq.html#netrc"> http://www.konqueror.org/faq.html#netrc</ulink></para> </sect1> <sect1 id="portnumbers"> -<title ->&URL;s with Port Numbers</title> -<para ->If you specify a port number in your &URL;, as in for example <userinput ->http://intranet.corp.com:1080</userinput ->, you might get the error message <quote ->Access to restricted port in POST denied</quote ->. This is done for security reasons. If you nevertheless need to access a server on this port, just add a key line <screen -><userinput> +<title>&URL;s with Port Numbers</title> +<para>If you specify a port number in your &URL;, as in for example <userinput>http://intranet.corp.com:1080</userinput>, you might get the error message <quote>Access to restricted port in POST denied</quote>. This is done for security reasons. If you nevertheless need to access a server on this port, just add a key line <screen><userinput> OverridePorts=CommaSeparatedListOfAllowedPorts -</userinput -></screen -> to <filename ->$TDEDIR/share/config/tdeio_httprc </filename -> or <filename ->~/.trinity/share/config/tdeio_httprc</filename ->.</para> -<para ->For example <screen -><userinput ->OverridePorts=23,15 -</userinput -></screen -> (it should not include any embedded spaces).</para> -<para ->&konqueror; will reject the following ports (the list is hardcoded in <filename ->tdelibs/tdeio/tdeio/job.cpp</filename ->):</para> -<para ->1, 7, 9, 11, 13, 15, 17, 19, 20, 21, 22, 23, 25, 37, 42, 43, 53, 77, 79, 87, 95, 101, 102, 103, 104, 109, 110, 111, 113, 115, 117, 119, 123, 135, 139, 143, 179, 389, 512, 513, 514, 515, 526, 530, 531, 532, 540, 556, 587, 601, 989, 990, 992, 993, 995, 1080, 2049, 4045, 6000, 6667 </para> +</userinput></screen> to <filename>$TDEDIR/share/config/tdeio_httprc </filename> or <filename>~/.trinity/share/config/tdeio_httprc</filename>.</para> +<para>For example <screen><userinput>OverridePorts=23,15 +</userinput></screen> (it should not include any embedded spaces).</para> +<para>&konqueror; will reject the following ports (the list is hardcoded in <filename>tdelibs/tdeio/tdeio/job.cpp</filename>):</para> +<para>1, 7, 9, 11, 13, 15, 17, 19, 20, 21, 22, 23, 25, 37, 42, 43, 53, 77, 79, 87, 95, 101, 102, 103, 104, 109, 110, 111, 113, 115, 117, 119, 123, 135, 139, 143, 179, 389, 512, 513, 514, 515, 526, 530, 531, 532, 540, 556, 587, 601, 989, 990, 992, 993, 995, 1080, 2049, 4045, 6000, 6667 </para> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/konqueror/commands.docbook b/tde-i18n-en_GB/docs/tdebase/konqueror/commands.docbook index 60410bfd441..1fa5132d764 100644 --- a/tde-i18n-en_GB/docs/tdebase/konqueror/commands.docbook +++ b/tde-i18n-en_GB/docs/tdebase/konqueror/commands.docbook @@ -2,81 +2,38 @@ <chapterinfo> <authorgroup> -<author ->&Pamela.Roberts;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Pamela.Roberts;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-11-06</date -> <releaseinfo ->3.2</releaseinfo -> </chapterinfo> - -<title ->Command Reference</title> - -<note -><para ->The shortcut key combinations shown in this chapter are the default ones. They can of course be <link linkend="configshort" ->changed</link ->. </para -></note> +<date>2003-11-06</date> <releaseinfo>3.2</releaseinfo> </chapterinfo> + +<title>Command Reference</title> + +<note><para>The shortcut key combinations shown in this chapter are the default ones. They can of course be <link linkend="configshort">changed</link>. </para></note> <sect1 id="specshort"> -<title ->Special Shortcuts</title> -<para ->There are some useful shortcuts that are not shown in any of the menus:</para> +<title>Special Shortcuts</title> +<para>There are some useful shortcuts that are not shown in any of the menus:</para> <variablelist> <varlistentry> -<term -><keycap ->F6</keycap -></term> +<term><keycap>F6</keycap></term> <listitem> -<para ->Sets the focus to the text entry box in the Location Toolbar.</para> +<para>Sets the focus to the text entry box in the Location Toolbar.</para> </listitem> </varlistentry> <varlistentry> -<term -><keycombo action="simul" ->&Ctrl;<keycap ->]</keycap -></keycombo -></term> +<term><keycombo action="simul">&Ctrl;<keycap>]</keycap></keycombo></term> <listitem> -<para ->Activate the next tab page.</para> +<para>Activate the next tab page.</para> </listitem> </varlistentry> <varlistentry> -<term -><keycombo action="simul" ->&Ctrl;<keycap ->[</keycap -></keycombo -></term> +<term><keycombo action="simul">&Ctrl;<keycap>[</keycap></keycombo></term> <listitem> -<para ->Activate the previous tab page.</para> +<para>Activate the previous tab page.</para> </listitem> </varlistentry> @@ -86,273 +43,77 @@ </sect1> <sect1 id="menubar"> -<title ->The Menubar</title -> <para ->Note that some menu entries only appear when they are applicable to the file you currently have open in &konqueror;. For example, the <menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Find...</guimenuitem -> </menuchoice -> item will not appear when you are viewing the contents of a directory.</para> +<title>The Menubar</title> <para>Note that some menu entries only appear when they are applicable to the file you currently have open in &konqueror;. For example, the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Find...</guimenuitem> </menuchoice> item will not appear when you are viewing the contents of a directory.</para> <sect2 id="menu-location"> -<title ->The <guimenu ->Location</guimenu -> Menu</title> +<title>The <guimenu>Location</guimenu> Menu</title> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->N</keycap -></keycombo -> </shortcut -> <guimenu ->Location</guimenu -> <guimenuitem ->New Window</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open another &konqueror; window.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;&Shift;<keycap ->N</keycap -></keycombo -> </shortcut -> <guimenu ->Location</guimenu -> <guimenuitem ->New Tab</guimenuitem -> </menuchoice -></term -> -<listitem -><para ->Open another &konqueror; tab, containing a blank page.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->D</keycap -></keycombo -> </shortcut -> <guimenu ->Location</guimenu -> <guimenuitem ->Duplicate Window</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open another &konqueror; window, duplicating the current one.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->O</keycap -></keycombo -> </shortcut -> <guimenu ->Location</guimenu -> <guimenuitem ->Open Location...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open a folder or file by entering its path (for example <filename class="directory" ->/home/pam</filename -> or <filename ->/home/pam/fred.txt</filename ->) in a simple dialogue box.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Location</guimenu -> <guimenuitem ->Send Link</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Send an email containing a link to the current location.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Location</guimenu -> <guimenuitem ->Send File</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Send an email containing the selected file as an attachment.</para -></listitem> -</varlistentry> - - -<varlistentry> -<term -><menuchoice -><guimenu ->Location</guimenu -> <guimenuitem ->Save Background Image As...</guimenuitem -> </menuchoice -></term> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo> </shortcut> <guimenu>Location</guimenu> <guimenuitem>New Window</guimenuitem> </menuchoice></term> +<listitem><para>Open another &konqueror; window.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;&Shift;<keycap>N</keycap></keycombo> </shortcut> <guimenu>Location</guimenu> <guimenuitem>New Tab</guimenuitem> </menuchoice></term> +<listitem><para>Open another &konqueror; tab, containing a blank page.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo> </shortcut> <guimenu>Location</guimenu> <guimenuitem>Duplicate Window</guimenuitem> </menuchoice></term> +<listitem><para>Open another &konqueror; window, duplicating the current one.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> </shortcut> <guimenu>Location</guimenu> <guimenuitem>Open Location...</guimenuitem> </menuchoice></term> +<listitem><para>Open a folder or file by entering its path (for example <filename class="directory">/home/pam</filename> or <filename>/home/pam/fred.txt</filename>) in a simple dialogue box.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Location</guimenu> <guimenuitem>Send Link</guimenuitem> </menuchoice></term> +<listitem><para>Send an email containing a link to the current location.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Location</guimenu> <guimenuitem>Send File</guimenuitem> </menuchoice></term> +<listitem><para>Send an email containing the selected file as an attachment.</para></listitem> +</varlistentry> + + +<varlistentry> +<term><menuchoice><guimenu>Location</guimenu> <guimenuitem>Save Background Image As...</guimenuitem> </menuchoice></term> <listitem> -<para ->Only applies if you are viewing a web page with a background image. Opens the <guilabel ->Save As dialogue</guilabel -> box to let you save the background image file to your own computer.</para> +<para>Only applies if you are viewing a web page with a background image. Opens the <guilabel>Save As dialogue</guilabel> box to let you save the background image file to your own computer.</para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->S</keycap -></keycombo -> </shortcut -> <guimenu ->Location</guimenu -> <guimenuitem ->Save As...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Only applies if you are viewing a document or web page, uses the <guilabel ->Save As...</guilabel -> dialogue box to let you save a copy to your own computer.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Location</guimenu -> <guimenuitem ->Save Frame As...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Similar to <guimenuitem ->Save As...</guimenuitem -> but for use with a web site that uses frames.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->P</keycap -></keycombo -> </shortcut -> <guimenu ->Location</guimenu -> <guimenuitem ->Print...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Print.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Location</guimenu -> <guimenuitem ->Print Frame</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Print selected frame of a Web page.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Location</guimenu -> <guimenuitem ->Open With Netscape/Mozilla</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open the web page you are viewing in &konqueror; with &Netscape;/<application ->Mozilla</application -> as well.</para -></listitem -> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->Q</keycap -></keycombo -> </shortcut -> <guimenu ->Location</guimenu -> <guimenuitem ->Quit</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Close down this instance of &konqueror;.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> </shortcut> <guimenu>Location</guimenu> <guimenuitem>Save As...</guimenuitem> </menuchoice></term> +<listitem><para>Only applies if you are viewing a document or web page, uses the <guilabel>Save As...</guilabel> dialogue box to let you save a copy to your own computer.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Location</guimenu> <guimenuitem>Save Frame As...</guimenuitem> </menuchoice></term> +<listitem><para>Similar to <guimenuitem>Save As...</guimenuitem> but for use with a web site that uses frames.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo> </shortcut> <guimenu>Location</guimenu> <guimenuitem>Print...</guimenuitem> </menuchoice></term> +<listitem><para>Print.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Location</guimenu> <guimenuitem>Print Frame</guimenuitem> </menuchoice></term> +<listitem><para>Print selected frame of a Web page.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Location</guimenu> <guimenuitem>Open With Netscape/Mozilla</guimenuitem> </menuchoice></term> +<listitem><para>Open the web page you are viewing in &konqueror; with &Netscape;/<application>Mozilla</application> as well.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu>Location</guimenu> <guimenuitem>Quit</guimenuitem> </menuchoice></term> +<listitem><para>Close down this instance of &konqueror;.</para></listitem> </varlistentry> </variablelist> @@ -360,467 +121,118 @@ </sect2> <sect2 id="menu-edit"> -<title ->The <guimenu ->Edit</guimenu -> Menu</title> - -<note -><para ->Most items in the Menubar <guimenu ->Edit</guimenu -> menu can also be found by &RMB; clicking on a free area of a view.</para -></note> +<title>The <guimenu>Edit</guimenu> Menu</title> + +<note><para>Most items in the Menubar <guimenu>Edit</guimenu> menu can also be found by &RMB; clicking on a free area of a view.</para></note> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->Z</keycap -></keycombo -> </shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Undo</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Sometimes lets you reverse a mistaken action.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->X</keycap -></keycombo -> </shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Cut</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Puts selected item(s) into the clipboard. If you then do a a <guimenuitem ->Paste</guimenuitem -> the item(s) will be moved from the original location to the new one.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->C</keycap -></keycombo -> </shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Copy</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Copy selected item(s) to the clipboard.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->V</keycap -></keycombo -> </shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Paste</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Paste item(s) from clipboard to the currently viewed folder.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -><keycap ->F2</keycap -> </shortcut -><guimenu ->Edit</guimenu -> <guimenuitem ->Rename</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Lets you rename a file or folder without having to open the <guimenuitem ->Properties...</guimenuitem -> dialogue box. </para -></listitem> -</varlistentry> - - -<varlistentry> -<term -><menuchoice -><shortcut -><keycap ->Delete</keycap -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Move to Trash</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Move selected item(s) to the Wastebin folder.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Shift;<keycap ->Delete</keycap -></keycombo -> </shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Delete</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Delete the selected item(s).</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -><keycap ->F7</keycap -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Copy Files</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Copy the selected item(s) to another folder.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Move Files</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Move the selected item(s) to another folder.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Create New</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Create a link to an application, <acronym ->URL</acronym ->, Floppy or &CD-ROM; device, or create a new Folder or text or <acronym ->HTML</acronym -> file. See the <link linkend="making" ->Create New...</link ->section for more details.</para -></listitem -> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Edit File Type...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open the <guilabel ->Edit File Type</guilabel -> dialogue box</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Properties..</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open the <guilabel ->Edit Properties</guilabel -> dialogue box</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -><guisubmenu ->Selection</guisubmenu -> </menuchoice -></term> -<listitem -><para ->Contains a number of options for changing the items selected in the &konqueror; window: <variablelist> -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->+</keycap -></keycombo -> </shortcut -> <guimenu ->Edit</guimenu -> <guisubmenu ->Selection</guisubmenu -> <guimenuitem ->Select...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Together with the <guimenuitem ->Unselect...</guimenuitem ->, <guimenuitem ->Unselect All</guimenuitem -> and <guimenuitem ->Invert</guimenuitem -> Selection commands, this provides an easy and powerful way of selecting multiple files.</para> -<para ->It brings up a simple dialogue box where you can enter a file name using the wild card characters * and ?, for example entering <literal role="extension" ->*.html</literal -> will select all files ending with <literal role="extension" ->.html</literal -> while <filename ->?a*</filename -> will select all files which have the letter a as the second character in their filename.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->-</keycap -></keycombo -> </shortcut -> <guimenu ->Edit</guimenu -> <guisubmenu ->Selection</guisubmenu -> <guimenuitem ->Unselect...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Unselect files or folders via a dialogue similar to the one used by <guimenuitem ->Select...</guimenuitem ->.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->U</keycap -></keycombo -> </shortcut -> <guimenu ->Edit</guimenu -> <guisubmenu ->Selection</guisubmenu -> <guimenuitem ->Unselect All</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Unselect all selected files or folders.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->*</keycap -></keycombo -> </shortcut -><guimenu ->Edit</guimenu -> <guisubmenu ->Selection</guisubmenu -> <guimenuitem ->Invert Selection</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Invert current selection.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->A</keycap -></keycombo -> </shortcut -><guimenu ->Edit</guimenu -> <guisubmenu ->Selection</guisubmenu -> <guimenuitem ->Select All</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Selects all text in a HTML page or in a text page being previewed, you can then <guimenuitem ->Copy</guimenuitem -> it and <guimenuitem ->Paste</guimenuitem -> it into a text editor.</para -></listitem -> </varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo> </shortcut> <guimenu>Edit</guimenu> <guimenuitem>Undo</guimenuitem> </menuchoice></term> +<listitem><para>Sometimes lets you reverse a mistaken action.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo> </shortcut> <guimenu>Edit</guimenu> <guimenuitem>Cut</guimenuitem> </menuchoice></term> +<listitem><para>Puts selected item(s) into the clipboard. If you then do a a <guimenuitem>Paste</guimenuitem> the item(s) will be moved from the original location to the new one.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> </shortcut> <guimenu>Edit</guimenu> <guimenuitem>Copy</guimenuitem> </menuchoice></term> +<listitem><para>Copy selected item(s) to the clipboard.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo> </shortcut> <guimenu>Edit</guimenu> <guimenuitem>Paste</guimenuitem> </menuchoice></term> +<listitem><para>Paste item(s) from clipboard to the currently viewed folder.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut><keycap>F2</keycap> </shortcut><guimenu>Edit</guimenu> <guimenuitem>Rename</guimenuitem> </menuchoice></term> +<listitem><para>Lets you rename a file or folder without having to open the <guimenuitem>Properties...</guimenuitem> dialogue box. </para></listitem> +</varlistentry> + + +<varlistentry> +<term><menuchoice><shortcut><keycap>Delete</keycap></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Move to Trash</guimenuitem> </menuchoice></term> +<listitem><para>Move selected item(s) to the Wastebin folder.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Shift;<keycap>Delete</keycap></keycombo> </shortcut> <guimenu>Edit</guimenu> <guimenuitem>Delete</guimenuitem> </menuchoice></term> +<listitem><para>Delete the selected item(s).</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut><keycap>F7</keycap></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Copy Files</guimenuitem> </menuchoice></term> +<listitem><para>Copy the selected item(s) to another folder.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu> <guimenuitem>Move Files</guimenuitem> </menuchoice></term> +<listitem><para>Move the selected item(s) to another folder.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu> <guimenuitem>Create New</guimenuitem> </menuchoice></term> +<listitem><para>Create a link to an application, <acronym>URL</acronym>, Floppy or &CD-ROM; device, or create a new Folder or text or <acronym>HTML</acronym> file. See the <link linkend="making">Create New...</link>section for more details.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu> <guimenuitem>Edit File Type...</guimenuitem> </menuchoice></term> +<listitem><para>Open the <guilabel>Edit File Type</guilabel> dialogue box</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu> <guimenuitem>Properties..</guimenuitem> </menuchoice></term> +<listitem><para>Open the <guilabel>Edit Properties</guilabel> dialogue box</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu><guisubmenu>Selection</guisubmenu> </menuchoice></term> +<listitem><para>Contains a number of options for changing the items selected in the &konqueror; window: <variablelist> +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo> </shortcut> <guimenu>Edit</guimenu> <guisubmenu>Selection</guisubmenu> <guimenuitem>Select...</guimenuitem> </menuchoice></term> +<listitem><para>Together with the <guimenuitem>Unselect...</guimenuitem>, <guimenuitem>Unselect All</guimenuitem> and <guimenuitem>Invert</guimenuitem> Selection commands, this provides an easy and powerful way of selecting multiple files.</para> +<para>It brings up a simple dialogue box where you can enter a file name using the wild card characters * and ?, for example entering <literal role="extension">*.html</literal> will select all files ending with <literal role="extension">.html</literal> while <filename>?a*</filename> will select all files which have the letter a as the second character in their filename.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo> </shortcut> <guimenu>Edit</guimenu> <guisubmenu>Selection</guisubmenu> <guimenuitem>Unselect...</guimenuitem> </menuchoice></term> +<listitem><para>Unselect files or folders via a dialogue similar to the one used by <guimenuitem>Select...</guimenuitem>.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo> </shortcut> <guimenu>Edit</guimenu> <guisubmenu>Selection</guisubmenu> <guimenuitem>Unselect All</guimenuitem> </menuchoice></term> +<listitem><para>Unselect all selected files or folders.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>*</keycap></keycombo> </shortcut><guimenu>Edit</guimenu> <guisubmenu>Selection</guisubmenu> <guimenuitem>Invert Selection</guimenuitem> </menuchoice></term> +<listitem><para>Invert current selection.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo> </shortcut><guimenu>Edit</guimenu> <guisubmenu>Selection</guisubmenu> <guimenuitem>Select All</guimenuitem> </menuchoice></term> +<listitem><para>Selects all text in a HTML page or in a text page being previewed, you can then <guimenuitem>Copy</guimenuitem> it and <guimenuitem>Paste</guimenuitem> it into a text editor.</para></listitem> </varlistentry> </variablelist> </para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->F</keycap -></keycombo -> </shortcut -><guimenu ->Edit</guimenu -> <guimenuitem ->Find...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Find a text string in a text page you are previewing or in an <acronym ->HTML</acronym -> page.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -><keycap ->F3</keycap -></shortcut -> <guimenu ->Edit</guimenu -> <guimenuitem ->Find Next</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Find the next occurrence of the text string in the text or <acronym ->HTML</acronym -> page.</para -></listitem -> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Go to Line...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Go to a particular line number in a text page you are previewing.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo> </shortcut><guimenu>Edit</guimenu> <guimenuitem>Find...</guimenuitem> </menuchoice></term> +<listitem><para>Find a text string in a text page you are previewing or in an <acronym>HTML</acronym> page.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut><keycap>F3</keycap></shortcut> <guimenu>Edit</guimenu> <guimenuitem>Find Next</guimenuitem> </menuchoice></term> +<listitem><para>Find the next occurrence of the text string in the text or <acronym>HTML</acronym> page.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu> <guimenuitem>Go to Line...</guimenuitem> </menuchoice></term> +<listitem><para>Go to a particular line number in a text page you are previewing.</para></listitem> </varlistentry> </variablelist> @@ -829,367 +241,114 @@ <sect2 id="menu-view"> -<title ->The <guimenu ->View</guimenu -> Menu</title> +<title>The <guimenu>View</guimenu> Menu</title> <variablelist> <varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guisubmenu ->View Mode...</guisubmenu -> </menuchoice -></term> -<listitem -><para ->Selects <guimenuitem ->Icon</guimenuitem ->, <guimenuitem ->MultiColumn</guimenuitem ->, <guimenuitem ->Tree</guimenuitem ->, <guimenuitem ->Detailed List</guimenuitem -> or <guimenuitem ->Text</guimenuitem -> view mode.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Use index.html</guimenuitem -> </menuchoice -></term> -<listitem -><para ->If a selected folder contains a file <filename ->index.html</filename ->, it will be opened as a web page rather than showing the folder as a list of files.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Lock to current location</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Lock to current location. </para -></listitem> +<term><menuchoice><guimenu>View</guimenu> <guisubmenu>View Mode...</guisubmenu> </menuchoice></term> +<listitem><para>Selects <guimenuitem>Icon</guimenuitem>, <guimenuitem>MultiColumn</guimenuitem>, <guimenuitem>Tree</guimenuitem>, <guimenuitem>Detailed List</guimenuitem> or <guimenuitem>Text</guimenuitem> view mode.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>Use index.html</guimenuitem> </menuchoice></term> +<listitem><para>If a selected folder contains a file <filename>index.html</filename>, it will be opened as a web page rather than showing the folder as a list of files.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>Lock to current location</guimenuitem> </menuchoice></term> +<listitem><para>Lock to current location. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Unlock all views</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Unlock all views. </para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Link View</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Link current view to others in a multiple view window.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -><keycap ->F5</keycap -></shortcut -> <guimenu ->View</guimenu -> <guimenuitem ->Reload</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Reload.</para -></listitem> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>Unlock all views</guimenuitem> </menuchoice></term> +<listitem><para>Unlock all views. </para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>Link View</guimenuitem> </menuchoice></term> +<listitem><para>Link current view to others in a multiple view window.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut><keycap>F5</keycap></shortcut> <guimenu>View</guimenu> <guimenuitem>Reload</guimenuitem> </menuchoice></term> +<listitem><para>Reload.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -><keycap ->Esc</keycap -></shortcut -> <guimenu ->View</guimenu -> <guimenuitem ->Stop</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Stop load (particularly useful when web browsing).</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Icon Size</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Select size of icons used when viewing a folder in Icon Mode.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guisubmenu ->Sort</guisubmenu -> </menuchoice -></term> -<listitem -><para ->Choose order in which items are presented in the window when in Icon or MultiColumn View mode.</para -></listitem> +<term><menuchoice><shortcut><keycap>Esc</keycap></shortcut> <guimenu>View</guimenu> <guimenuitem>Stop</guimenuitem> </menuchoice></term> +<listitem><para>Stop load (particularly useful when web browsing).</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>Icon Size</guimenuitem> </menuchoice></term> +<listitem><para>Select size of icons used when viewing a folder in Icon Mode.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu> <guisubmenu>Sort</guisubmenu> </menuchoice></term> +<listitem><para>Choose order in which items are presented in the window when in Icon or MultiColumn View mode.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Case Insensitive Sort</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Choose whether the sort order in Tree, Detailed List or Text View modes is case sensitive.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;<keycap ->U</keycap -> </keycombo -> </shortcut -> <guimenu ->View</guimenu -> <guimenuitem ->View Document Source</guimenuitem -> </menuchoice -></term> -<listitem -><para ->View document source text.</para> -<para ->Only available if you are viewing a document or <acronym ->HTML</acronym -> page.</para> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>Case Insensitive Sort</guimenuitem> </menuchoice></term> +<listitem><para>Choose whether the sort order in Tree, Detailed List or Text View modes is case sensitive.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>U</keycap> </keycombo> </shortcut> <guimenu>View</guimenu> <guimenuitem>View Document Source</guimenuitem> </menuchoice></term> +<listitem><para>View document source text.</para> +<para>Only available if you are viewing a document or <acronym>HTML</acronym> page.</para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->View Frame Source</guimenuitem -> </menuchoice -></term> -<listitem -><para ->View frame source text</para> -<para ->Only applies if you are viewing a web site that uses frames. Similar to <guimenuitem ->View Document Source</guimenuitem ->. </para> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>View Frame Source</guimenuitem> </menuchoice></term> +<listitem><para>View frame source text</para> +<para>Only applies if you are viewing a web site that uses frames. Similar to <guimenuitem>View Document Source</guimenuitem>. </para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -><keycombo action="simul" ->&Ctrl;<keycap ->I</keycap -> </keycombo -> </shortcut -> <guimenu ->View</guimenu -> <guimenuitem ->View Document Information</guimenuitem -> </menuchoice -></term> -<listitem -><para ->View document information, such as title, &URL;, and &HTTP; headers used in retrieving the document.</para> -<para ->Only available if you are viewing an <acronym ->HTML</acronym -> page.</para> +<term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>I</keycap> </keycombo> </shortcut> <guimenu>View</guimenu> <guimenuitem>View Document Information</guimenuitem> </menuchoice></term> +<listitem><para>View document information, such as title, &URL;, and &HTTP; headers used in retrieving the document.</para> +<para>Only available if you are viewing an <acronym>HTML</acronym> page.</para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Security...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Tells you whether the current browser connection is secured with <acronym ->SSL</acronym -> and lets you bring up the <guilabel ->Cryptography Configuration...</guilabel -> dialogue box. <mousebutton ->Left</mousebutton -> clicking on the Menubar padlock icon does the same thing.</para -></listitem -> </varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Set Encoding</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Set encoding</para> -<para ->Allows you to choose the character encoding used to display <acronym ->HTML</acronym -> pages. <guimenuitem ->Auto</guimenuitem -> is usually the best choice.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guisubmenu ->Preview</guisubmenu -> </menuchoice -></term> -<listitem -><para ->Lets you choose to show thumbnails of images, text files or HTML pages instead of the normal icons in Icon or MultiColumn View modes.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Show Hidden Files</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Show hidden (dot) files.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Show details...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Lets you choose which file and folder details are shown in Tree, Detailed List and Text views.</para -></listitem> -</varlistentry> - - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Background Colour...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Select background colour for the File Manager mode. </para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Background Image...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Select background image for the File Manager mode. </para -></listitem> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>Security...</guimenuitem> </menuchoice></term> +<listitem><para>Tells you whether the current browser connection is secured with <acronym>SSL</acronym> and lets you bring up the <guilabel>Cryptography Configuration...</guilabel> dialogue box. <mousebutton>Left</mousebutton> clicking on the Menubar padlock icon does the same thing.</para></listitem> </varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>Set Encoding</guimenuitem> </menuchoice></term> +<listitem><para>Set encoding</para> +<para>Allows you to choose the character encoding used to display <acronym>HTML</acronym> pages. <guimenuitem>Auto</guimenuitem> is usually the best choice.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu> <guisubmenu>Preview</guisubmenu> </menuchoice></term> +<listitem><para>Lets you choose to show thumbnails of images, text files or HTML pages instead of the normal icons in Icon or MultiColumn View modes.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>Show Hidden Files</guimenuitem> </menuchoice></term> +<listitem><para>Show hidden (dot) files.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>Show details...</guimenuitem> </menuchoice></term> +<listitem><para>Lets you choose which file and folder details are shown in Tree, Detailed List and Text views.</para></listitem> +</varlistentry> + + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>Background Colour...</guimenuitem> </menuchoice></term> +<listitem><para>Select background colour for the File Manager mode. </para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>Background Image...</guimenuitem> </menuchoice></term> +<listitem><para>Select background image for the File Manager mode. </para></listitem> </varlistentry> </variablelist> @@ -1197,175 +356,54 @@ </sect2> <sect2 id="menu-go"> -<title ->The <guimenu ->Go</guimenu -> Menu</title> +<title>The <guimenu>Go</guimenu> Menu</title> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Alt;<keysym ->Up Arrow</keysym -></keycombo -> </shortcut -><guimenu ->Go</guimenu -> <guimenuitem ->Up</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Go up a level in the folder hierarchy.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Alt;<keysym ->Left Arrow</keysym -></keycombo -> </shortcut -><guimenu ->Go</guimenu -> <guimenuitem ->Back</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Go back to the previous view.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Alt;<keysym ->Right Arrow</keysym -></keycombo -> </shortcut -><guimenu ->Go</guimenu -> <guimenuitem ->Forward</guimenuitem -> </menuchoice -></term> -<listitem -><para ->You can only go forward if you've just gone back.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->Home</keycap -></keycombo -> </shortcut -><guimenu ->Go</guimenu -> <guimenuitem ->Home URL</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Go to your home folder.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Go</guimenu -> <guimenuitem ->Applications</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open the folder holding your applications.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Go</guimenu -> <guimenuitem ->Trash</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open your <filename class="directory" ->Trash</filename -> folder in a separate window.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Go</guimenu -> <guimenuitem ->Templates</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open the <filename class="directory" ->Templates</filename -> folder in a separate window.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Go</guimenu -> <guimenuitem ->Autostart</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open your <filename class="directory" ->Autostart</filename -> folder in a separate window.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Go</guimenu -> <guisubmenu ->Most Often Visited</guisubmenu -> </menuchoice -></term> +<term><menuchoice><shortcut> <keycombo action="simul">&Alt;<keysym>Up Arrow</keysym></keycombo> </shortcut><guimenu>Go</guimenu> <guimenuitem>Up</guimenuitem> </menuchoice></term> +<listitem><para>Go up a level in the folder hierarchy.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Alt;<keysym>Left Arrow</keysym></keycombo> </shortcut><guimenu>Go</guimenu> <guimenuitem>Back</guimenuitem> </menuchoice></term> +<listitem><para>Go back to the previous view.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Alt;<keysym>Right Arrow</keysym></keycombo> </shortcut><guimenu>Go</guimenu> <guimenuitem>Forward</guimenuitem> </menuchoice></term> +<listitem><para>You can only go forward if you've just gone back.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Home</keycap></keycombo> </shortcut><guimenu>Go</guimenu> <guimenuitem>Home URL</guimenuitem> </menuchoice></term> +<listitem><para>Go to your home folder.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Go</guimenu> <guimenuitem>Applications</guimenuitem> </menuchoice></term> +<listitem><para>Open the folder holding your applications.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Go</guimenu> <guimenuitem>Trash</guimenuitem> </menuchoice></term> +<listitem><para>Open your <filename class="directory">Trash</filename> folder in a separate window.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Go</guimenu> <guimenuitem>Templates</guimenuitem> </menuchoice></term> +<listitem><para>Open the <filename class="directory">Templates</filename> folder in a separate window.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Go</guimenu> <guimenuitem>Autostart</guimenuitem> </menuchoice></term> +<listitem><para>Open your <filename class="directory">Autostart</filename> folder in a separate window.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Go</guimenu> <guisubmenu>Most Often Visited</guisubmenu> </menuchoice></term> <listitem> -<para ->Displays a submenu showing the &URL;s you visit most often. Selecting one of these will make &konqueror; open that &URL;.</para> +<para>Displays a submenu showing the &URL;s you visit most often. Selecting one of these will make &konqueror; open that &URL;.</para> </listitem> </varlistentry> @@ -1374,389 +412,126 @@ </sect2> <sect2 id="menu-bookmarks"> -<title ->The <guimenu ->Bookmarks</guimenu -> Menu</title> - -<note -><para ->See the section <link linkend="bookmarks" ->Using Bookmarks</link -> in this manual for a fuller description of these menu items. </para -></note> +<title>The <guimenu>Bookmarks</guimenu> Menu</title> + +<note><para>See the section <link linkend="bookmarks">Using Bookmarks</link> in this manual for a fuller description of these menu items. </para></note> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->B</keycap -></keycombo -> </shortcut -> <guimenu ->Bookmarks</guimenu -> <guimenuitem ->Add Bookmark</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Add current selection to your bookmarks.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Bookmarks</guimenu -> <guimenuitem ->Bookmark Tabs as Folder...</guimenuitem -> </menuchoice -></term> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo> </shortcut> <guimenu>Bookmarks</guimenu> <guimenuitem>Add Bookmark</guimenuitem> </menuchoice></term> +<listitem><para>Add current selection to your bookmarks.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Bookmarks</guimenu> <guimenuitem>Bookmark Tabs as Folder...</guimenuitem> </menuchoice></term> <listitem> -<para ->Create a bookmark folder containing links to all of the &URL;s currently open in &konqueror; tabs. </para> +<para>Create a bookmark folder containing links to all of the &URL;s currently open in &konqueror; tabs. </para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Bookmarks</guimenu -> <guimenuitem ->Edit Bookmarks...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open the <link linkend="bookmarks" ->Bookmark Editor</link ->. </para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Bookmarks</guimenu -> <guimenuitem ->New Bookmark Folder...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Create a new folder in your Bookmarks folder.</para -></listitem> +<term><menuchoice><guimenu>Bookmarks</guimenu> <guimenuitem>Edit Bookmarks...</guimenuitem> </menuchoice></term> +<listitem><para>Open the <link linkend="bookmarks">Bookmark Editor</link>. </para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Bookmarks</guimenu> <guimenuitem>New Bookmark Folder...</guimenuitem> </menuchoice></term> +<listitem><para>Create a new folder in your Bookmarks folder.</para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="menu-tools"> -<title ->The <guimenu ->Tools</guimenu -> Menu</title> +<title>The <guimenu>Tools</guimenu> Menu</title> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Alt;<keycap ->F2</keycap -></keycombo -></shortcut -> <guimenu ->Tools</guimenu -> <guimenuitem ->Run Command...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Run a program by entering its name in a simple dialogue box.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->T</keycap -></keycombo -></shortcut -> <guimenu ->Tools</guimenu -> <guimenuitem ->Open Terminal</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open a &konsole; terminal window.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Tools</guimenu -> <guimenuitem ->Find File...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open the &kfind; application.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo></shortcut> <guimenu>Tools</guimenu> <guimenuitem>Run Command...</guimenuitem> </menuchoice></term> +<listitem><para>Run a program by entering its name in a simple dialogue box.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo></shortcut> <guimenu>Tools</guimenu> <guimenuitem>Open Terminal</guimenuitem> </menuchoice></term> +<listitem><para>Open a &konsole; terminal window.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Tools</guimenu> <guimenuitem>Find File...</guimenuitem> </menuchoice></term> +<listitem><para>Open the &kfind; application.</para></listitem> </varlistentry> </variablelist> -<para ->If you have &konqueror; plugins installed there will be additional entries in the <guimenu ->Tools</guimenu -> menu. See the <link linkend="konq-plugin" ->&konqueror; Plugins</link -> chapter for further details.</para> +<para>If you have &konqueror; plugins installed there will be additional entries in the <guimenu>Tools</guimenu> menu. See the <link linkend="konq-plugin">&konqueror; Plugins</link> chapter for further details.</para> </sect2> <sect2 id="menu-settings"> -<title ->The <guimenu ->Settings</guimenu -> Menu</title> - -<note -><para ->See also the section <link linkend="save-settings" ->Saving Settings and Profiles</link ->.</para -></note> +<title>The <guimenu>Settings</guimenu> Menu</title> + +<note><para>See also the section <link linkend="save-settings">Saving Settings and Profiles</link>.</para></note> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->M</keycap -></keycombo -></shortcut -> <guimenu ->Settings</guimenu -> <guimenuitem ->Show Menubar</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Show/Hide the menubar.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Toolbars</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Opens a sub menu where you can choose to show or hide the various Toolbars.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;&Shift; <keycap ->F</keycap -></keycombo -> </shortcut -> <guimenu ->Settings</guimenu -> <guimenuitem ->Full Screen Mode</guimenuitem -> </menuchoice -></term> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo></shortcut> <guimenu>Settings</guimenu> <guimenuitem>Show Menubar</guimenuitem> </menuchoice></term> +<listitem><para>Show/Hide the menubar.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guimenuitem>Toolbars</guimenuitem> </menuchoice></term> +<listitem><para>Opens a sub menu where you can choose to show or hide the various Toolbars.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;&Shift; <keycap>F</keycap></keycombo> </shortcut> <guimenu>Settings</guimenu> <guimenuitem>Full Screen Mode</guimenuitem> </menuchoice></term> <listitem> -<para ->Changes &konqueror; to full screen mode, in which the &konqueror; window takes up the whole screen, and does not have the usual window decorations. To exit full screen mode, click on the <guiicon ->Exit Full Screen Mode</guiicon -> icon on the toolbar, or press <keycombo action="simul" ->&Ctrl;&Shift; <keycap ->F</keycap -></keycombo ->.</para> +<para>Changes &konqueror; to full screen mode, in which the &konqueror; window takes up the whole screen, and does not have the usual window decorations. To exit full screen mode, click on the <guiicon>Exit Full Screen Mode</guiicon> icon on the toolbar, or press <keycombo action="simul">&Ctrl;&Shift; <keycap>F</keycap></keycombo>.</para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->View Properties Saved in Folder</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Save View properties to current folder. If this is selected, a <filename ->.directory</filename -> file will be written in the current directory storing the settings you last used to view the directory. These settings are then loaded when you open the directory in &konqueror;.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Remove Folder Properties</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Remove settings stored in folder by <guimenuitem ->View Properties Saved in Folder</guimenuitem ->.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guisubmenu ->Load View Profile</guisubmenu -> </menuchoice -></term> -<listitem -><para ->Load the settings associated with a particular view profile.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Save View Profile "<replaceable ->ProfileName</replaceable ->"...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Save the current settings to the current view profile.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Configure View Profiles...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Lets you change an existing view profile or create a new one.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Configure Shortcuts...</guimenuitem -> </menuchoice -></term -> <listitem -><para ->Lets you see and change &konqueror;'s shortcut key bindings, i.e. the associations between actions such as <guimenuitem ->Copy</guimenuitem -> and keys or combinations of keys such a <keycombo action="simul" ->&Ctrl;<keycap ->V</keycap -></keycombo ->. If you do this take care not to duplicate an existing shortcut.</para> -</listitem -></varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Configure Toolbars...</guimenuitem -> </menuchoice -></term -> <listitem -><para ->Lets you configure the Main, Extra and Location Toolbars. See the section <link linkend="configure-bars" ->Changing Bars</link ->. </para -></listitem -> </varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Configure &konqueror;...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Lets you configure the File manager, File Associations, Browser, Internet Keywords, Cookies, Proxies, Cryptography, User Agent, or Toolbars by bringing up the appropriate dialogue box.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Configure Spell Checking...</guimenuitem -> </menuchoice -></term> +<term><menuchoice><guimenu>Settings</guimenu> <guimenuitem>View Properties Saved in Folder</guimenuitem> </menuchoice></term> +<listitem><para>Save View properties to current folder. If this is selected, a <filename>.directory</filename> file will be written in the current directory storing the settings you last used to view the directory. These settings are then loaded when you open the directory in &konqueror;.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guimenuitem>Remove Folder Properties</guimenuitem> </menuchoice></term> +<listitem><para>Remove settings stored in folder by <guimenuitem>View Properties Saved in Folder</guimenuitem>.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guisubmenu>Load View Profile</guisubmenu> </menuchoice></term> +<listitem><para>Load the settings associated with a particular view profile.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guimenuitem>Save View Profile "<replaceable>ProfileName</replaceable>"...</guimenuitem> </menuchoice></term> +<listitem><para>Save the current settings to the current view profile.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure View Profiles...</guimenuitem> </menuchoice></term> +<listitem><para>Lets you change an existing view profile or create a new one.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure Shortcuts...</guimenuitem> </menuchoice></term> <listitem><para>Lets you see and change &konqueror;'s shortcut key bindings, i.e. the associations between actions such as <guimenuitem>Copy</guimenuitem> and keys or combinations of keys such a <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>. If you do this take care not to duplicate an existing shortcut.</para> +</listitem></varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure Toolbars...</guimenuitem> </menuchoice></term> <listitem><para>Lets you configure the Main, Extra and Location Toolbars. See the section <link linkend="configure-bars">Changing Bars</link>. </para></listitem> </varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure &konqueror;...</guimenuitem> </menuchoice></term> +<listitem><para>Lets you configure the File manager, File Associations, Browser, Internet Keywords, Cookies, Proxies, Cryptography, User Agent, or Toolbars by bringing up the appropriate dialogue box.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure Spell Checking...</guimenuitem> </menuchoice></term> <listitem> -<para ->Displays the spell checking configuration dialogue box, in which you can change settings associated with spell checking in &konqueror;.</para> +<para>Displays the spell checking configuration dialogue box, in which you can change settings associated with spell checking in &konqueror;.</para> </listitem> </varlistentry> @@ -1766,236 +541,63 @@ </sect2> <sect2 id="menu-window"> -<title ->The <guimenu ->Window</guimenu -> Menu</title> +<title>The <guimenu>Window</guimenu> Menu</title> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;&Shift;<keycap ->L</keycap -></keycombo -></shortcut -> <guimenu ->Window</guimenu -> <guimenuitem ->Split View Left/Right</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Split View Left/Right.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;&Shift;<keycap ->T</keycap -></keycombo -></shortcut -> <guimenu ->Window</guimenu -> <guimenuitem ->Split View Top/Bottom</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Split View Top/Bottom.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;&Shift;<keycap ->R</keycap -></keycombo -></shortcut -> <guimenu ->Window</guimenu -> <guimenuitem ->Remove Active View</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Remove Active View.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;&Shift;<keycap ->N</keycap -></keycombo -></shortcut -> <guimenu ->Window</guimenu -> <guimenuitem ->New Tab</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open a new, empty, tab page.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;&Shift;<keycap ->D</keycap -></keycombo -></shortcut -> <guimenu ->Window</guimenu -> <guimenuitem ->Duplicate Current Tab</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open a duplicate tab page.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;&Shift;<keycap ->B</keycap -></keycombo -></shortcut -> <guimenu ->Window</guimenu -> <guimenuitem ->Detach Current Tab</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Show the current tab page in a new instance of &konqueror;.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->W</keycap -></keycombo -></shortcut -> <guimenu ->Window</guimenu -> <guimenuitem ->Close Current Tab</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Close the current tab page.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;&Shift;<keycap ->Left</keycap -></keycombo -></shortcut -> <guimenu ->Window</guimenu -> <guimenuitem ->Move Tab Left</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Move the current tab one place left in the list of tabs.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;&Shift;<keycap ->Left</keycap -></keycombo -></shortcut -> <guimenu ->Window</guimenu -> <guimenuitem ->Move Tab Right</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Move the current tab one place right in the list of tabs.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Window</guimenu -> <guimenuitem ->Show Terminal Emulator</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Open a small text terminal view at the bottom of the main window.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" -><keycap ->F9</keycap -></keycombo -></shortcut -> <guimenu ->Window</guimenu -> <guimenuitem ->Show Navigation Panel</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Toggles the display of the &konqueror; navigation panel. See <xref linkend="sidebar"/>.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;&Shift;<keycap>L</keycap></keycombo></shortcut> <guimenu>Window</guimenu> <guimenuitem>Split View Left/Right</guimenuitem> </menuchoice></term> +<listitem><para>Split View Left/Right.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;&Shift;<keycap>T</keycap></keycombo></shortcut> <guimenu>Window</guimenu> <guimenuitem>Split View Top/Bottom</guimenuitem> </menuchoice></term> +<listitem><para>Split View Top/Bottom.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;&Shift;<keycap>R</keycap></keycombo></shortcut> <guimenu>Window</guimenu> <guimenuitem>Remove Active View</guimenuitem> </menuchoice></term> +<listitem><para>Remove Active View.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;&Shift;<keycap>N</keycap></keycombo></shortcut> <guimenu>Window</guimenu> <guimenuitem>New Tab</guimenuitem> </menuchoice></term> +<listitem><para>Open a new, empty, tab page.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;&Shift;<keycap>D</keycap></keycombo></shortcut> <guimenu>Window</guimenu> <guimenuitem>Duplicate Current Tab</guimenuitem> </menuchoice></term> +<listitem><para>Open a duplicate tab page.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;&Shift;<keycap>B</keycap></keycombo></shortcut> <guimenu>Window</guimenu> <guimenuitem>Detach Current Tab</guimenuitem> </menuchoice></term> +<listitem><para>Show the current tab page in a new instance of &konqueror;.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></shortcut> <guimenu>Window</guimenu> <guimenuitem>Close Current Tab</guimenuitem> </menuchoice></term> +<listitem><para>Close the current tab page.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;&Shift;<keycap>Left</keycap></keycombo></shortcut> <guimenu>Window</guimenu> <guimenuitem>Move Tab Left</guimenuitem> </menuchoice></term> +<listitem><para>Move the current tab one place left in the list of tabs.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;&Shift;<keycap>Left</keycap></keycombo></shortcut> <guimenu>Window</guimenu> <guimenuitem>Move Tab Right</guimenuitem> </menuchoice></term> +<listitem><para>Move the current tab one place right in the list of tabs.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Window</guimenu> <guimenuitem>Show Terminal Emulator</guimenuitem> </menuchoice></term> +<listitem><para>Open a small text terminal view at the bottom of the main window.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul"><keycap>F9</keycap></keycombo></shortcut> <guimenu>Window</guimenu> <guimenuitem>Show Navigation Panel</guimenuitem> </menuchoice></term> +<listitem><para>Toggles the display of the &konqueror; navigation panel. See <xref linkend="sidebar"/>.</para></listitem> </varlistentry> </variablelist> @@ -2003,111 +605,38 @@ </sect2> <sect2 id="menu-help"> -<title ->The <guimenu ->Help</guimenu -> Menu</title> +<title>The <guimenu>Help</guimenu> Menu</title> <variablelist> <varlistentry> -<term -><menuchoice -><guimenu ->Help</guimenu -> <guimenuitem ->&konqueror; Handbook</guimenuitem -> </menuchoice -></term> -<listitem -><para ->View this document.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Shift;<keycap ->F1</keycap -></keycombo -></shortcut -> <guimenu ->Help</guimenu -> <guimenuitem ->What's This?</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Draws a question mark (?) beside the mouse pointer, clicking on a window item such as the <guiicon ->Stop</guiicon -> button will then display a brief explanation. See <link linkend="bubble" ->Tooltips and What's This?</link -> .</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Help</guimenu -> <guimenuitem ->&konqueror; Introduction</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Revisit the introductory pages that you got when &konqueror; was first started.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Help</guimenu -> <guimenuitem ->Report Bug...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Report bug.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Help</guimenu -> <guimenuitem ->About &konqueror;...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Display some brief information about &konqueror;'s version number, authors and licence agreement.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Help</guimenu -> <guimenuitem ->About KDE...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Show some information about the version of &kde; that you are running.</para -></listitem> +<term><menuchoice><guimenu>Help</guimenu> <guimenuitem>&konqueror; Handbook</guimenuitem> </menuchoice></term> +<listitem><para>View this document.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><shortcut> <keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo></shortcut> <guimenu>Help</guimenu> <guimenuitem>What's This?</guimenuitem> </menuchoice></term> +<listitem><para>Draws a question mark (?) beside the mouse pointer, clicking on a window item such as the <guiicon>Stop</guiicon> button will then display a brief explanation. See <link linkend="bubble">Tooltips and What's This?</link> .</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Help</guimenu> <guimenuitem>&konqueror; Introduction</guimenuitem> </menuchoice></term> +<listitem><para>Revisit the introductory pages that you got when &konqueror; was first started.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Help</guimenu> <guimenuitem>Report Bug...</guimenuitem> </menuchoice></term> +<listitem><para>Report bug.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Help</guimenu> <guimenuitem>About &konqueror;...</guimenuitem> </menuchoice></term> +<listitem><para>Display some brief information about &konqueror;'s version number, authors and licence agreement.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Help</guimenu> <guimenuitem>About KDE...</guimenuitem> </menuchoice></term> +<listitem><para>Show some information about the version of &kde; that you are running.</para></listitem> </varlistentry> </variablelist> diff --git a/tde-i18n-en_GB/docs/tdebase/konqueror/config.docbook b/tde-i18n-en_GB/docs/tdebase/konqueror/config.docbook index 473ab9af051..e0896d4091a 100644 --- a/tde-i18n-en_GB/docs/tdebase/konqueror/config.docbook +++ b/tde-i18n-en_GB/docs/tdebase/konqueror/config.docbook @@ -2,188 +2,68 @@ <chapterinfo> <authorgroup> -<author ->&Pamela.Roberts;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Pamela.Roberts;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-11-06</date -> <releaseinfo ->3.2</releaseinfo -> </chapterinfo> +<date>2003-11-06</date> <releaseinfo>3.2</releaseinfo> </chapterinfo> -<title ->Configuring &konqueror;</title> +<title>Configuring &konqueror;</title> -<para ->In common with the rest of &kde;, &konqueror; is highly configurable, so you can really get the look and feel that best fits your needs and wishes.</para> +<para>In common with the rest of &kde;, &konqueror; is highly configurable, so you can really get the look and feel that best fits your needs and wishes.</para> <sect1 id="configure-bars"> -<title ->Toolbars</title> - -<para ->When &kde; is newly installed, &konqueror;'s window contains a Menubar, Main and Location Toolbars and possibly a Bookmark Toolbar.</para> - -<para ->Maybe you don't need all these toolbars. To hide one of them, go into the <menuchoice -><guimenu ->Settings</guimenu -><guisubmenu ->Toolbars</guisubmenu -> </menuchoice -> menu and uncheck its box. To show a hidden toolbar, just check the box.</para -> - -<para ->The Menubar itself can be toggled on and off with the shortcut key combination <keycombo action="simul" ->&Ctrl;<keycap ->M</keycap -></keycombo ->. </para> +<title>Toolbars</title> + +<para>When &kde; is newly installed, &konqueror;'s window contains a Menubar, Main and Location Toolbars and possibly a Bookmark Toolbar.</para> + +<para>Maybe you don't need all these toolbars. To hide one of them, go into the <menuchoice><guimenu>Settings</guimenu><guisubmenu>Toolbars</guisubmenu> </menuchoice> menu and uncheck its box. To show a hidden toolbar, just check the box.</para> + +<para>The Menubar itself can be toggled on and off with the shortcut key combination <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>. </para> <!-- FIXME --> -<para ->On the left hand end of each bar you can see some vertical lines. By &LMB; clicking on them, you <quote ->flatten</quote -> the bar, meaning that it is hidden but can be quickly restored by clicking on the now horizontal lines. You can also drag a bar into a new position with these lines.</para> - -<para ->If you <mousebutton ->right</mousebutton -> click on a Toolbar, you will get a menu to configure this bar. You can choose the orientation, text position and icon size</para> - -<para ->The icons shown in the various bars can be changed by using the <menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Configure Toolbars...</guimenuitem -></menuchoice -> option, which brings up the <guilabel ->Configure Toolbars</guilabel -> dialogue box. The Main and Extra Toolbars are divided into sections, such as Main Toolbar <&konqueror;>, Main Toolbar <tdehtmlpart> and Extra Toolbar <tdehtmlsettingsplugin>. The number and type of these sections will depend on whether &konqueror; is in Web Browser or File Manager mode and whether you have &konqueror; plugins installed.</para> +<para>On the left hand end of each bar you can see some vertical lines. By &LMB; clicking on them, you <quote>flatten</quote> the bar, meaning that it is hidden but can be quickly restored by clicking on the now horizontal lines. You can also drag a bar into a new position with these lines.</para> + +<para>If you <mousebutton>right</mousebutton> click on a Toolbar, you will get a menu to configure this bar. You can choose the orientation, text position and icon size</para> + +<para>The icons shown in the various bars can be changed by using the <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure Toolbars...</guimenuitem></menuchoice> option, which brings up the <guilabel>Configure Toolbars</guilabel> dialogue box. The Main and Extra Toolbars are divided into sections, such as Main Toolbar <&konqueror;>, Main Toolbar <tdehtmlpart> and Extra Toolbar <tdehtmlsettingsplugin>. The number and type of these sections will depend on whether &konqueror; is in Web Browser or File Manager mode and whether you have &konqueror; plugins installed.</para> </sect1> <sect1 id="configshort"> -<title ->Shortcuts</title> -<para ->To change the shortcut key arrangements used by &konqueror; select <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure Shortcuts... </guimenuitem -></menuchoice ->. This will launch a dialogue box as shown below. </para> +<title>Shortcuts</title> +<para>To change the shortcut key arrangements used by &konqueror; select <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts... </guimenuitem></menuchoice>. This will launch a dialogue box as shown below. </para> <mediaobject> <imageobject> <imagedata fileref="shortcut1.png" format="PNG"/> </imageobject> <textobject> -<phrase ->Shortcut config screenshot 1</phrase> +<phrase>Shortcut config screenshot 1</phrase> </textobject> </mediaobject> -<para ->Search through the combo box to find the action you want to add or change the shortcut keys for and select it by <mousebutton ->left</mousebutton -> clicking on the name. You will then be able to change the shortcut by selecting the <guilabel ->None</guilabel ->, <guilabel ->Default</guilabel -> or <guilabel ->Custom</guilabel -> radio button or by clicking on the large button in the <guilabel ->Shortcut for Selected Action</guilabel -> area.</para> -<para ->The <guilabel ->Define Shortcut</guilabel -> dialogue box will then open. </para> +<para>Search through the combo box to find the action you want to add or change the shortcut keys for and select it by <mousebutton>left</mousebutton> clicking on the name. You will then be able to change the shortcut by selecting the <guilabel>None</guilabel>, <guilabel>Default</guilabel> or <guilabel>Custom</guilabel> radio button or by clicking on the large button in the <guilabel>Shortcut for Selected Action</guilabel> area.</para> +<para>The <guilabel>Define Shortcut</guilabel> dialogue box will then open. </para> <mediaobject> <imageobject> <imagedata fileref="shortcut2.png" format="PNG"/> </imageobject> <textobject> -<phrase ->Shortcut config screenshot 2</phrase> +<phrase>Shortcut config screenshot 2</phrase> </textobject> </mediaobject> -<para ->Choose whether you want to change the <guilabel ->Primary</guilabel -> or <guilabel ->Alternate</guilabel -> shortcut then press the key combination you want to act as the shortcut, for example <keycombo action="simul" -> &Ctrl;&Shift;<keycap ->S</keycap -></keycombo ->. If the <guilabel ->Auto-Close</guilabel -> box is checked the dialogue will vanish as soon as you enter the key combination, otherwise it will remain until you press <guibutton ->OK</guibutton -> or <guibutton ->Cancel</guibutton ->. Clicking on the little black icon with a white cross in it clears the shortcut.</para> +<para>Choose whether you want to change the <guilabel>Primary</guilabel> or <guilabel>Alternate</guilabel> shortcut then press the key combination you want to act as the shortcut, for example <keycombo action="simul"> &Ctrl;&Shift;<keycap>S</keycap></keycombo>. If the <guilabel>Auto-Close</guilabel> box is checked the dialogue will vanish as soon as you enter the key combination, otherwise it will remain until you press <guibutton>OK</guibutton> or <guibutton>Cancel</guibutton>. Clicking on the little black icon with a white cross in it clears the shortcut.</para> <sect2 id="userdefmenus"> -<title ->User Defined Menus</title> -<para ->You can add your own pop up menu to &konqueror; so that pressing one key combination will make the menu appear then pressing a second key, or using the <keysym ->Up arrow</keysym -> and <keysym ->Down arrow</keysym -> keys and pressing <keycap ->Enter</keycap ->, will select an item from it.</para> -<para ->To do this add a <guilabel ->Custom</guilabel -> shortcut for each of the actions you want to appear in the menu and in the <guilabel ->Define Shortcut </guilabel -> dialogue check the <guilabel ->Multi-Key</guilabel -> box, press the key combination that you want to bring up your new menu then, separately, press the key that will choose that item from the menu.</para> +<title>User Defined Menus</title> +<para>You can add your own pop up menu to &konqueror; so that pressing one key combination will make the menu appear then pressing a second key, or using the <keysym>Up arrow</keysym> and <keysym>Down arrow</keysym> keys and pressing <keycap>Enter</keycap>, will select an item from it.</para> +<para>To do this add a <guilabel>Custom</guilabel> shortcut for each of the actions you want to appear in the menu and in the <guilabel>Define Shortcut </guilabel> dialogue check the <guilabel>Multi-Key</guilabel> box, press the key combination that you want to bring up your new menu then, separately, press the key that will choose that item from the menu.</para> </sect2> </sect1> <sect1 id="othersettings"> -<title ->Other Settings</title> -<para ->Selecting <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem -> Configure Konqueror...</guimenuitem -></menuchoice -> brings up a dialogue box which you can use to control most aspects of &konqueror;'s behaviour. It contains several sections which are selected by <mousebutton ->left </mousebutton -> clicking on one of the icons at the left of the dialogue box.</para> -<para ->Pressing the <guibutton ->Help</guibutton -> button will give you detailed instructions about how to use each of these sections, or you can use the <link linkend="bubble" ->What's This?</link -> feature.</para> +<title>Other Settings</title> +<para>Selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem> Configure Konqueror...</guimenuitem></menuchoice> brings up a dialogue box which you can use to control most aspects of &konqueror;'s behaviour. It contains several sections which are selected by <mousebutton>left </mousebutton> clicking on one of the icons at the left of the dialogue box.</para> +<para>Pressing the <guibutton>Help</guibutton> button will give you detailed instructions about how to use each of these sections, or you can use the <link linkend="bubble">What's This?</link> feature.</para> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/konqueror/credits.docbook b/tde-i18n-en_GB/docs/tdebase/konqueror/credits.docbook index 88f895f231f..921b8e36475 100644 --- a/tde-i18n-en_GB/docs/tdebase/konqueror/credits.docbook +++ b/tde-i18n-en_GB/docs/tdebase/konqueror/credits.docbook @@ -2,307 +2,154 @@ <chapterinfo> <authorgroup> -<author ->&Pamela.Roberts;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Pamela.Roberts;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-11-06</date -> <releaseinfo ->3.2</releaseinfo -> </chapterinfo> +<date>2003-11-06</date> <releaseinfo>3.2</releaseinfo> </chapterinfo> -<title ->Credits and Licence</title> +<title>Credits and Licence</title> -<para ->&konqueror;. Program copyright 1999-2003, the &konqueror; developers:</para> +<para>&konqueror;. Program copyright 1999-2003, the &konqueror; developers:</para> <variablelist> <varlistentry> -<term ->&David.Faure; &David.Faure.mail;</term> -<listitem -><para ->developer (parts, I/O lib) and maintainer</para -></listitem> +<term>&David.Faure; &David.Faure.mail;</term> +<listitem><para>developer (parts, I/O lib) and maintainer</para></listitem> </varlistentry> <varlistentry> -<term ->&Simon.Hausmann; &Simon.Hausmann.mail;</term> -<listitem -><para ->developer (framework, parts)</para -></listitem> +<term>&Simon.Hausmann; &Simon.Hausmann.mail;</term> +<listitem><para>developer (framework, parts)</para></listitem> </varlistentry> <varlistentry> -<term ->&Michael.Reiher; &Michael.Reiher.mail;</term> -<listitem -><para ->developer (framework)</para -></listitem> +<term>&Michael.Reiher; &Michael.Reiher.mail;</term> +<listitem><para>developer (framework)</para></listitem> </varlistentry> <varlistentry> -<term ->&Mattias.Welk; &Mattias.Welk.mail;</term> -<listitem -><para ->developer</para -></listitem> +<term>&Mattias.Welk; &Mattias.Welk.mail;</term> +<listitem><para>developer</para></listitem> </varlistentry> <varlistentry> -<term ->&Alexander.Neundorf; &Alexander.Neundorf.mail;</term> -<listitem -><para ->developer (list views)</para -></listitem> +<term>&Alexander.Neundorf; &Alexander.Neundorf.mail;</term> +<listitem><para>developer (list views)</para></listitem> </varlistentry> <varlistentry> -<term ->&Michael.Brade; &Michael.Brade.mail;</term> -<listitem -><para ->developer (list views, I/O lib)</para -></listitem> +<term>&Michael.Brade; &Michael.Brade.mail;</term> +<listitem><para>developer (list views, I/O lib)</para></listitem> </varlistentry> <varlistentry> -<term ->&Lars.Knoll; &Lars.Knoll.mail;</term> -<listitem -><para ->developer (<acronym ->HTML</acronym -> rendering engine)</para -></listitem> +<term>&Lars.Knoll; &Lars.Knoll.mail;</term> +<listitem><para>developer (<acronym>HTML</acronym> rendering engine)</para></listitem> </varlistentry> <varlistentry> -<term ->&Antti.Koivisto; &Antti.Koivisto.mail;</term> -<listitem -><para ->developer (<acronym ->HTML</acronym -> rendering engine)</para -></listitem> +<term>&Antti.Koivisto; &Antti.Koivisto.mail;</term> +<listitem><para>developer (<acronym>HTML</acronym> rendering engine)</para></listitem> </varlistentry> <varlistentry> -<term ->&Dirk.Mueller; &Dirk.Mueller.mail;</term> -<listitem -><para ->developer (<acronym ->HTML</acronym -> rendering engine)</para -></listitem> +<term>&Dirk.Mueller; &Dirk.Mueller.mail;</term> +<listitem><para>developer (<acronym>HTML</acronym> rendering engine)</para></listitem> </varlistentry> <varlistentry> -<term ->&Peter.Kelly; &Peter.Kelly.mail;</term> -<listitem -><para ->developer (<acronym ->HTML</acronym -> rendering engine, JavaScript)</para -></listitem> +<term>&Peter.Kelly; &Peter.Kelly.mail;</term> +<listitem><para>developer (<acronym>HTML</acronym> rendering engine, JavaScript)</para></listitem> </varlistentry> <varlistentry> -<term ->&Waldo.Bastian; &Waldo.Bastian.mail;</term> -<listitem -><para ->developer (<acronym ->HTML</acronym -> rendering engine, I/O lib)</para -></listitem> +<term>&Waldo.Bastian; &Waldo.Bastian.mail;</term> +<listitem><para>developer (<acronym>HTML</acronym> rendering engine, I/O lib)</para></listitem> </varlistentry> <varlistentry> -<term ->&Matt.Koss; &Matt.Koss.mail;</term> -<listitem -><para ->developer (I/O lib)</para -></listitem> +<term>&Matt.Koss; &Matt.Koss.mail;</term> +<listitem><para>developer (I/O lib)</para></listitem> </varlistentry> <varlistentry> -<term ->&Alex.Zepeda; &Alex.Zepeda.mail;</term> -<listitem -><para ->developer (I/O lib)</para -></listitem> +<term>&Alex.Zepeda; &Alex.Zepeda.mail;</term> +<listitem><para>developer (I/O lib)</para></listitem> </varlistentry> <varlistentry> -<term ->&Stephan.Kulow; &Stephan.Kulow.mail;</term> -<listitem -><para ->developer (I/O lib)</para -></listitem> +<term>&Stephan.Kulow; &Stephan.Kulow.mail;</term> +<listitem><para>developer (I/O lib)</para></listitem> </varlistentry> <varlistentry> -<term ->&Richard.J.Moore; &Richard.J.Moore.mail;</term> -<listitem -><para ->developer (&Java; applet support)</para -></listitem> +<term>&Richard.J.Moore; &Richard.J.Moore.mail;</term> +<listitem><para>developer (&Java; applet support)</para></listitem> </varlistentry> <varlistentry> -<term ->Dima Rogozin <email ->dima@mercury.co.il</email -></term> -<listitem -><para ->developer (&Java; applet support)</para -></listitem> +<term>Dima Rogozin <email>dima@mercury.co.il</email></term> +<listitem><para>developer (&Java; applet support)</para></listitem> </varlistentry> <varlistentry> -<term ->Wynn Wilkes <email ->wynnw@calderasystems.com</email -></term> -<listitem -><para ->developer (&Java;2 manager support and other major improvements to applet support)</para -></listitem> +<term>Wynn Wilkes <email>wynnw@calderasystems.com</email></term> +<listitem><para>developer (&Java;2 manager support and other major improvements to applet support)</para></listitem> </varlistentry> <varlistentry> -<term ->&Harri.Porten; &Harri.Porten.mail;</term> -<listitem -><para ->developer (JavaScript)</para -></listitem> +<term>&Harri.Porten; &Harri.Porten.mail;</term> +<listitem><para>developer (JavaScript)</para></listitem> </varlistentry> <varlistentry> -<term ->Stefan Schimanski <email ->schimmi@kde.org</email -></term> -<listitem -><para ->developer (&Netscape; plugin support)</para -></listitem> +<term>Stefan Schimanski <email>schimmi@kde.org</email></term> +<listitem><para>developer (&Netscape; plugin support)</para></listitem> </varlistentry> <varlistentry> -<term ->&Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;</term> -<listitem -><para ->developer (framework)</para -></listitem> +<term>&Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;</term> +<listitem><para>developer (framework)</para></listitem> </varlistentry> <varlistentry> -<term ->&George.Staikos; &George.Staikos.mail;</term> -<listitem -><para ->developer (SSL support)</para -></listitem> +<term>&George.Staikos; &George.Staikos.mail;</term> +<listitem><para>developer (SSL support)</para></listitem> </varlistentry> <varlistentry> -<term ->Dawit Alemayehu <email ->adawit@kde.org</email -></term> -<listitem -><para ->developer (I/O lib, Authentication support)</para -></listitem> +<term>Dawit Alemayehu <email>adawit@kde.org</email></term> +<listitem><para>developer (I/O lib, Authentication support)</para></listitem> </varlistentry> <varlistentry> -<term ->&Torsten.Rahn; &Torsten.Rahn.mail;</term> -<listitem -><para ->Graphics / icons</para -></listitem> +<term>&Torsten.Rahn; &Torsten.Rahn.mail;</term> +<listitem><para>Graphics / icons</para></listitem> </varlistentry> <varlistentry> -<term ->Torben Weis <email ->weis@kde.org</email -></term> -<listitem -><para ->kfm author</para -></listitem> +<term>Torben Weis <email>weis@kde.org</email></term> +<listitem><para>kfm author</para></listitem> </varlistentry> <varlistentry> -<term ->&Joseph.Wenninger; &Joseph.Wenninger;</term> -<listitem -><para ->developer (navigation panel framework)</para -></listitem> +<term>&Joseph.Wenninger; &Joseph.Wenninger;</term> +<listitem><para>developer (navigation panel framework)</para></listitem> </varlistentry> </variablelist> -<para ->Documentation copyright 2000-2003</para> +<para>Documentation copyright 2000-2003</para> <itemizedlist> -<listitem -><para ->&Erwan.Loisant; &Erwan.Loisant.mail;</para -></listitem> -<listitem -><para ->&Pamela.Roberts; &Pamela.Roberts.mail;</para -></listitem> +<listitem><para>&Erwan.Loisant; &Erwan.Loisant.mail;</para></listitem> +<listitem><para>&Pamela.Roberts; &Pamela.Roberts.mail;</para></listitem> </itemizedlist> -<para ->Documentation updated for &kde; 3.2 by &Philip.Rodrigues; &Philip.Rodrigues.mail;.</para> -<para ->Conversion to British English: John Knight <email ->anarchist_tomato@herzeleid.net</email -></para -> +<para>Documentation updated for &kde; 3.2 by &Philip.Rodrigues; &Philip.Rodrigues.mail;.</para> +<para>Conversion to British English: John Knight <email>anarchist_tomato@herzeleid.net</email></para> &underFDL; &underGPL; </chapter> <!-- Local Variables: diff --git a/tde-i18n-en_GB/docs/tdebase/konqueror/faq.docbook b/tde-i18n-en_GB/docs/tdebase/konqueror/faq.docbook index 79acaced6ae..c4bc8b7881c 100644 --- a/tde-i18n-en_GB/docs/tdebase/konqueror/faq.docbook +++ b/tde-i18n-en_GB/docs/tdebase/konqueror/faq.docbook @@ -1,175 +1,59 @@ <chapter id="faq"> <chapterinfo> <authorgroup> -<author ->&Pamela.Roberts;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Pamela.Roberts;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-11-06</date -> <releaseinfo ->3.2</releaseinfo -> </chapterinfo> +<date>2003-11-06</date> <releaseinfo>3.2</releaseinfo> </chapterinfo> -<title ->Questions and Answers</title> +<title>Questions and Answers</title> <qandaset> <!-- Link is dead, unfortunately. I suppose this is a more general thing anyway <qandaentry> -<question -><para ->How can I browse web sites using non latin - scripts?</para -></question> -<answer -><para ->Detailed instructions can be found at <ulink -url="http://www.konqueror.org/i18n.html" ->http://www.konqueror.org/i18n.html</ulink -></para -></answer> +<question><para>How can I browse web sites using non latin + scripts?</para></question> +<answer><para>Detailed instructions can be found at <ulink +url="http://www.konqueror.org/i18n.html">http://www.konqueror.org/i18n.html</ulink></para></answer> </qandaentry> --> <qandaentry> -<question -><para ->Can I run &konqueror; from another window manager?</para -></question> +<question><para>Can I run &konqueror; from another window manager?</para></question> -<answer -><para ->Just install &Qt;, tdelibs and tdebase, and from your favourite window manager, launch &konqueror;. It should work just fine, but if it doesn't (&kde; developers don't test that case often), report it to <ulink url="http://bugs.kde.org" ->http://bugs.kde.org</ulink -> and try running <application ->tdeinit</application -> before running &konqueror;, it usually helps.</para -></answer> +<answer><para>Just install &Qt;, tdelibs and tdebase, and from your favourite window manager, launch &konqueror;. It should work just fine, but if it doesn't (&kde; developers don't test that case often), report it to <ulink url="http://bugs.kde.org">http://bugs.kde.org</ulink> and try running <application>tdeinit</application> before running &konqueror;, it usually helps.</para></answer> </qandaentry> <qandaentry> -<question -><para ->Where does &konqueror; keep all its configuration data?</para -></question> -<answer -><para ->Generally in the <filename ->~/.trinity</filename -> folder (this may be <filename ->~/.trinity3</filename -> on your system, depending on how &kde; 3 was installed). Do not alter these files unless you really know what you are doing.</para> +<question><para>Where does &konqueror; keep all its configuration data?</para></question> +<answer><para>Generally in the <filename>~/.trinity</filename> folder (this may be <filename>~/.trinity3</filename> on your system, depending on how &kde; 3 was installed). Do not alter these files unless you really know what you are doing.</para> <itemizedlist> -<listitem -><para ->The <filename class="directory" ->~/.trinity/share/apps/konqueror/profiles</filename -> folder holds individual files containing settings for each of your <link linkend="save-settings" ->profiles. </link -></para -></listitem> +<listitem><para>The <filename class="directory">~/.trinity/share/apps/konqueror/profiles</filename> folder holds individual files containing settings for each of your <link linkend="save-settings">profiles. </link></para></listitem> -<listitem -><para ->Your bookmarks are held in <filename class="directory" ->~/.trinity/share/apps/konqueror/bookmarks.xml</filename -></para -></listitem> -<listitem -><para ->Cookies are held in <filename class="directory" ->~/.trinity/share/apps/kcookiejar/cookies</filename -></para -></listitem> -<listitem -><para ->Your history, as used for the auto-completion feature, is in <filename ->~/.trinity/share/config/konq_history</filename -></para -></listitem> +<listitem><para>Your bookmarks are held in <filename class="directory">~/.trinity/share/apps/konqueror/bookmarks.xml</filename></para></listitem> +<listitem><para>Cookies are held in <filename class="directory">~/.trinity/share/apps/kcookiejar/cookies</filename></para></listitem> +<listitem><para>Your history, as used for the auto-completion feature, is in <filename>~/.trinity/share/config/konq_history</filename></para></listitem> -<listitem -><para ->In the folder <filename class="directory" ->~/.trinity/share/config/</filename -> the files <filename ->konqiconviewrc</filename ->, <filename ->konqlistviewrc</filename -> and <filename ->konquerorrc</filename -> hold a whole lot of general configuration settings.</para -></listitem> +<listitem><para>In the folder <filename class="directory">~/.trinity/share/config/</filename> the files <filename>konqiconviewrc</filename>, <filename>konqlistviewrc</filename> and <filename>konquerorrc</filename> hold a whole lot of general configuration settings.</para></listitem> -<listitem -><para ->The folder <filename class="directory" ->~/.trinity/share/cache/http/</filename -> contains the browser cache.</para -></listitem> +<listitem><para>The folder <filename class="directory">~/.trinity/share/cache/http/</filename> contains the browser cache.</para></listitem> -<listitem -><para ->The Navigation Panel uses the files and subfolders in <filename class="directory" ->~/.trinity/share/apps/konqsidebartng</filename -></para -></listitem> +<listitem><para>The Navigation Panel uses the files and subfolders in <filename class="directory">~/.trinity/share/apps/konqsidebartng</filename></para></listitem> </itemizedlist> -<para ->Any folder specific view settings are put into <literal role="extension" ->.directory</literal -> files in the individual folders.</para -></answer> +<para>Any folder specific view settings are put into <literal role="extension">.directory</literal> files in the individual folders.</para></answer> </qandaentry> <qandaentry> -<question -><para ->How do I clear out the history file?</para -></question> -<answer -><para ->There are two <quote ->histories</quote ->:</para> +<question><para>How do I clear out the history file?</para></question> +<answer><para>There are two <quote>histories</quote>:</para> <itemizedlist> -<listitem -><para ->One is used for text completion in the Location Toolbar text entry box. To clear this <mousebutton ->right</mousebutton -> click on the text entry box and select <guimenuitem ->Clear History </guimenuitem ->.</para> +<listitem><para>One is used for text completion in the Location Toolbar text entry box. To clear this <mousebutton>right</mousebutton> click on the text entry box and select <guimenuitem>Clear History </guimenuitem>.</para> </listitem> -<listitem -><para ->The other is the log of visited locations. Select the History page in the Navigation Panel, <mousebutton ->right</mousebutton -> click on an entry and choose <guimenuitem ->Remove Entry</guimenuitem -> to remove just that entry or <guimenuitem ->Clear History</guimenuitem -> to delete all entries.</para -></listitem> +<listitem><para>The other is the log of visited locations. Select the History page in the Navigation Panel, <mousebutton>right</mousebutton> click on an entry and choose <guimenuitem>Remove Entry</guimenuitem> to remove just that entry or <guimenuitem>Clear History</guimenuitem> to delete all entries.</para></listitem> </itemizedlist> @@ -177,106 +61,33 @@ url="http://www.konqueror.org/i18n.html" </qandaentry> <qandaentry> -<question -><para ->How do I enable, disable or clear the browser cache?</para -></question -> <answer> -<para ->If you select <guimenuitem ->Cache</guimenuitem -> in the dialogue launched by selecting <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure Konqueror... </guimenuitem -></menuchoice ->, you will be presented with a dialogue box that lets you disable the cache, clear it or set its size, and change the caching policy.</para> +<question><para>How do I enable, disable or clear the browser cache?</para></question> <answer> +<para>If you select <guimenuitem>Cache</guimenuitem> in the dialogue launched by selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror... </guimenuitem></menuchoice>, you will be presented with a dialogue box that lets you disable the cache, clear it or set its size, and change the caching policy.</para> </answer> </qandaentry> <qandaentry> -<question -><para ->How can I change the timeout values used by &konqueror; when web browsing?</para -></question -> <answer> -<para ->In the Control Centre <menuchoice -><guimenu ->Internet & Network</guimenu -> <guimenuitem ->Preferences</guimenuitem -></menuchoice -> page.</para> +<question><para>How can I change the timeout values used by &konqueror; when web browsing?</para></question> <answer> +<para>In the Control Centre <menuchoice><guimenu>Internet & Network</guimenu> <guimenuitem>Preferences</guimenuitem></menuchoice> page.</para> </answer> </qandaentry> <qandaentry> -<question -><para ->How do I set my <quote ->home</quote -> page - the page loaded on startup?</para -></question> -<answer -><para ->Start &konqueror; with the <guiicon ->Web Browser</guiicon -> icon on the panel. Open the page you want to be loaded in any new <quote ->Web Browser</quote -> window and select <guimenuitem ->Save View Profile "Web Browsing"</guimenuitem -> from the <guimenu ->Settings</guimenu -> menu.</para> +<question><para>How do I set my <quote>home</quote> page - the page loaded on startup?</para></question> +<answer><para>Start &konqueror; with the <guiicon>Web Browser</guiicon> icon on the panel. Open the page you want to be loaded in any new <quote>Web Browser</quote> window and select <guimenuitem>Save View Profile "Web Browsing"</guimenuitem> from the <guimenu>Settings</guimenu> menu.</para> -<para ->All new &konqueror; windows that are started with the <guiicon ->Web Browser</guiicon -> icon on the panel, or from the <guimenu ->location</guimenu -> menu, and new empty tabs, will now start at this page.</para> +<para>All new &konqueror; windows that are started with the <guiicon>Web Browser</guiicon> icon on the panel, or from the <guimenu>location</guimenu> menu, and new empty tabs, will now start at this page.</para> -<note -><para ->This does not change the behaviour of the <guiicon ->Home</guiicon -> button on the &konqueror; toolbar, which will continue to take you to the &URI; defined in the &konqueror; configuration module. You can reach that module from within &konqueror;, via <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure Konqueror</guimenuitem -><guilabel ->Behaviour</guilabel -></menuchoice ->. By default this is set to <userinput ->~</userinput ->, which is your Home folder. You may set this to any &URI;, either local or remote, and pressing the <guiicon ->Home</guiicon -> icon on the toolbar will display it.</para -></note> +<note><para>This does not change the behaviour of the <guiicon>Home</guiicon> button on the &konqueror; toolbar, which will continue to take you to the &URI; defined in the &konqueror; configuration module. You can reach that module from within &konqueror;, via <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror</guimenuitem><guilabel>Behaviour</guilabel></menuchoice>. By default this is set to <userinput>~</userinput>, which is your Home folder. You may set this to any &URI;, either local or remote, and pressing the <guiicon>Home</guiicon> icon on the toolbar will display it.</para></note> -<para ->To have &konqueror; start up with no page loaded, use <userinput ->about:blank</userinput ->.</para> +<para>To have &konqueror; start up with no page loaded, use <userinput>about:blank</userinput>.</para> </answer> </qandaentry> <qandaentry> -<question -><para ->I can't find the answer to my question here.</para -></question -> +<question><para>I can't find the answer to my question here.</para></question> <answer> -<para ->Take a look at <ulink url="http://www.konqueror.org/faq.html" -> http://www.konqueror.org/faq.html</ulink -> or <ulink url="http://www.konqueror.org/konq-java.html" -> http://www.konqueror.org/konq-java.html</ulink ->.</para> +<para>Take a look at <ulink url="http://www.konqueror.org/faq.html"> http://www.konqueror.org/faq.html</ulink> or <ulink url="http://www.konqueror.org/konq-java.html"> http://www.konqueror.org/konq-java.html</ulink>.</para> </answer> </qandaentry> diff --git a/tde-i18n-en_GB/docs/tdebase/konqueror/filemanager.docbook b/tde-i18n-en_GB/docs/tdebase/konqueror/filemanager.docbook index 055ca263f62..a8c396a7824 100644 --- a/tde-i18n-en_GB/docs/tdebase/konqueror/filemanager.docbook +++ b/tde-i18n-en_GB/docs/tdebase/konqueror/filemanager.docbook @@ -1,534 +1,157 @@ <chapter id="filemanager"> <chapterinfo> <authorgroup> -<author ->&Pamela.Roberts;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> -</authorgroup -> <date ->2003-10-28</date -> <releaseinfo ->3.2</releaseinfo -> </chapterinfo> - -<title ->&konqueror; the File Manager</title> +<author>&Pamela.Roberts;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> +</authorgroup> <date>2003-10-28</date> <releaseinfo>3.2</releaseinfo> </chapterinfo> + +<title>&konqueror; the File Manager</title> <sect1 id="dirfolders"> -<title ->Folders and Paths</title> -<para ->In &UNIX; and &Linux; all folders are arranged in a simple inverted tree structure descending and branching down from from a single top level folder. This means that you can get from any folder to any other by going <quote ->up</quote -> until you reach a common point then <quote ->down</quote -> through the appropriate subfolders until you reach your target. </para -> - -<para ->The position of any file or folder in the tree can be described by its <quote ->path</quote ->, which is a simple list of the folders you would have to descend through to get to the target folder or file. For example <filename class="directory" ->/home/pam</filename -> is the subfolder <filename class="directory" ->pam</filename -> of the subfolder <filename class="directory" ->home</filename -> of the top level folder, and <filename -> /home/pam/words.txt</filename -> is the file <filename ->words.txt</filename -> in that subfolder. The leading <quote ->/</quote -> in these paths represents the top level folder.</para> - -<para ->Every folder accessible by your system, including those on other hard disk partitions, your floppy and &CD-ROM;, will appear in the tree descending from /, their exact paths will depend on how your system was set up (see also the section on <link linkend="floppy-cd" ->Floppy and &CD-ROM; Drives</link ->). </para> -<para ->Every user on a &UNIX; / &Linux; system has their own <quote ->home</quote -> folder to hold their personal files and settings, for example <filename class="directory" ->/home/jon</filename -> and <filename class="directory" ->/home/mary</filename ->. The symbol <keycap ->~</keycap -> is often used to represent the user's home folder, so that <filename ->~/letter.txt</filename -> refers to the file <filename ->letter.txt</filename -> in my home folder.</para> -<para ->Note that the term <quote ->directory</quote -> is often used instead of <quote ->folder</quote ->.</para> +<title>Folders and Paths</title> +<para>In &UNIX; and &Linux; all folders are arranged in a simple inverted tree structure descending and branching down from from a single top level folder. This means that you can get from any folder to any other by going <quote>up</quote> until you reach a common point then <quote>down</quote> through the appropriate subfolders until you reach your target. </para> + +<para>The position of any file or folder in the tree can be described by its <quote>path</quote>, which is a simple list of the folders you would have to descend through to get to the target folder or file. For example <filename class="directory">/home/pam</filename> is the subfolder <filename class="directory">pam</filename> of the subfolder <filename class="directory">home</filename> of the top level folder, and <filename> /home/pam/words.txt</filename> is the file <filename>words.txt</filename> in that subfolder. The leading <quote>/</quote> in these paths represents the top level folder.</para> + +<para>Every folder accessible by your system, including those on other hard disk partitions, your floppy and &CD-ROM;, will appear in the tree descending from /, their exact paths will depend on how your system was set up (see also the section on <link linkend="floppy-cd">Floppy and &CD-ROM; Drives</link>). </para> +<para>Every user on a &UNIX; / &Linux; system has their own <quote>home</quote> folder to hold their personal files and settings, for example <filename class="directory">/home/jon</filename> and <filename class="directory">/home/mary</filename>. The symbol <keycap>~</keycap> is often used to represent the user's home folder, so that <filename>~/letter.txt</filename> refers to the file <filename>letter.txt</filename> in my home folder.</para> +<para>Note that the term <quote>directory</quote> is often used instead of <quote>folder</quote>.</para> </sect1> <sect1 id="viewmode"> -<title ->View Modes</title> -<para ->In File Manager mode, &konqueror; shows you what files and subfolders are held in a folder, and can provide you with some information about them.</para> -<para ->The <quote ->path</quote -> of the folder you are looking at is shown in the Titlebar, and also in the Location Toolbar, prefixed with <quote ->file: </quote -> to indicate that the folder is part of your computer's normal file system. For example <filename ->file:/home/pam</filename ->.</para> - -<para ->The way that &konqueror; displays the files and folders depends mainly on your choice of View Mode. This can be selected from the <menuchoice -> <guimenu ->View</guimenu -><guisubmenu ->View Mode</guisubmenu -></menuchoice -> sub menu, which gives you the following options: </para> +<title>View Modes</title> +<para>In File Manager mode, &konqueror; shows you what files and subfolders are held in a folder, and can provide you with some information about them.</para> +<para>The <quote>path</quote> of the folder you are looking at is shown in the Titlebar, and also in the Location Toolbar, prefixed with <quote>file: </quote> to indicate that the folder is part of your computer's normal file system. For example <filename>file:/home/pam</filename>.</para> + +<para>The way that &konqueror; displays the files and folders depends mainly on your choice of View Mode. This can be selected from the <menuchoice> <guimenu>View</guimenu><guisubmenu>View Mode</guisubmenu></menuchoice> sub menu, which gives you the following options: </para> <variablelist> <varlistentry> -<term -><guimenuitem ->Icon View</guimenuitem -></term> -<listitem -><para ->Displays the name and a suitable icon for each file or folder. </para -></listitem> +<term><guimenuitem>Icon View</guimenuitem></term> +<listitem><para>Displays the name and a suitable icon for each file or folder. </para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->MultiColumn View</guimenuitem -></term> -<listitem -><para ->Similar to <guimenuitem ->Icon View</guimenuitem -> except that the display is neatly formatted into regular columns.</para> +<term><guimenuitem>MultiColumn View</guimenuitem></term> +<listitem><para>Similar to <guimenuitem>Icon View</guimenuitem> except that the display is neatly formatted into regular columns.</para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Detailed List View</guimenuitem -></term> -<listitem -><para ->Displays each file or folder on a separate line, as a small icon followed by the file or folder name followed by information about the item. The amount of information shown is controlled by the <menuchoice -> <guimenu ->View</guimenu -><guisubmenu ->Show Details</guisubmenu -></menuchoice -> sub menu settings. </para -></listitem> +<term><guimenuitem>Detailed List View</guimenuitem></term> +<listitem><para>Displays each file or folder on a separate line, as a small icon followed by the file or folder name followed by information about the item. The amount of information shown is controlled by the <menuchoice> <guimenu>View</guimenu><guisubmenu>Show Details</guisubmenu></menuchoice> sub menu settings. </para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Text View</guimenuitem -></term> -<listitem -><para ->Similar to <guimenuitem ->Detailed List View</guimenuitem -> except that icons are not shown and the first character in each line will be <quote ->/</quote -> if the item is a folder. </para -></listitem> +<term><guimenuitem>Text View</guimenuitem></term> +<listitem><para>Similar to <guimenuitem>Detailed List View</guimenuitem> except that icons are not shown and the first character in each line will be <quote>/</quote> if the item is a folder. </para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Tree View</guimenuitem -></term> -<listitem -><para ->This option is useful for <link linkend="navigation" -> navigating</link -> through the folder tree below the current folder. The display is similar to <guimenuitem ->Detailed List View</guimenuitem -> except that the start of each line will show a small <keycap ->+</keycap -> sign in a box if the item is a folder. <mousebutton ->Left</mousebutton -> clicking on the box will expand the display to show the contents of that folder.</para> +<term><guimenuitem>Tree View</guimenuitem></term> +<listitem><para>This option is useful for <link linkend="navigation"> navigating</link> through the folder tree below the current folder. The display is similar to <guimenuitem>Detailed List View</guimenuitem> except that the start of each line will show a small <keycap>+</keycap> sign in a box if the item is a folder. <mousebutton>Left</mousebutton> clicking on the box will expand the display to show the contents of that folder.</para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Info List View</guimenuitem -></term> -<listitem -><para ->Similar to <guimenuitem ->Detailed List View</guimenuitem -> except that, where applicable, it shows the number of lines, words and characters and file format for each file. </para -></listitem> +<term><guimenuitem>Info List View</guimenuitem></term> +<listitem><para>Similar to <guimenuitem>Detailed List View</guimenuitem> except that, where applicable, it shows the number of lines, words and characters and file format for each file. </para></listitem> </varlistentry> </variablelist> -<para ->The default file icons shown in <guimenuitem ->Icon View</guimenuitem -> and <guimenuitem ->MultiColumn View</guimenuitem -> modes can be replaced by small preview images of the file contents, see the section <link linkend="previews" -> File Previews</link -> of this handbook for more details.</para> +<para>The default file icons shown in <guimenuitem>Icon View</guimenuitem> and <guimenuitem>MultiColumn View</guimenuitem> modes can be replaced by small preview images of the file contents, see the section <link linkend="previews"> File Previews</link> of this handbook for more details.</para> <sect2 id="filetipinfo"> -<title ->File Tip Info</title> -<para ->Checking the <guilabel ->Show file tips</guilabel -> box in the <guilabel -> Behaviour</guilabel -> page of the &konqueror; Configuration dialogue causes a small pop up information window to appear when the mouse pointer is hovered over a file or folder name or icon in <guimenuitem ->Icon View</guimenuitem -> or <guimenuitem -> MultiColumn View</guimenuitem -> mode. </para> -<para ->If the <guilabel ->Show previews in file tips</guilabel -> checkbox is checked the pop up window will also show a small image of the file contents. </para> +<title>File Tip Info</title> +<para>Checking the <guilabel>Show file tips</guilabel> box in the <guilabel> Behaviour</guilabel> page of the &konqueror; Configuration dialogue causes a small pop up information window to appear when the mouse pointer is hovered over a file or folder name or icon in <guimenuitem>Icon View</guimenuitem> or <guimenuitem> MultiColumn View</guimenuitem> mode. </para> +<para>If the <guilabel>Show previews in file tips</guilabel> checkbox is checked the pop up window will also show a small image of the file contents. </para> </sect2> <sect2 id="previews"> -<title ->File Previews</title> -<para ->Selecting <menuchoice -><guimenu ->View</guimenu -><guisubmenu ->Preview </guisubmenu -></menuchoice -> from the Menubar will bring up a sub menu that lets you enable file previews for certain types of file.</para> -<para ->Generally this means that the file's icon will be replaced by a small image showing the file contents.</para> -<para ->If file preview is enabled for <guimenuitem ->Sound Files</guimenuitem -> the file will be played whenever the mouse cursor is hovering over the file name or icon.</para> -<para ->Note that file previews are only available in <guimenuitem ->Icon View </guimenuitem -> and <guimenuitem ->MultiColumn View</guimenuitem -> modes.</para> -<para ->Because &konqueror; has to read much more data than just the file name details to generate a preview, file previews may not be appropriate when viewing files on a floppy or from a remote system. The <guilabel ->Previews </guilabel -> page of the File Manager Configuration dialogue allows you to disable file previews for protocols such as <link linkend="ftp" ->ftp</link -> where reading the extra data would take too long.</para> +<title>File Previews</title> +<para>Selecting <menuchoice><guimenu>View</guimenu><guisubmenu>Preview </guisubmenu></menuchoice> from the Menubar will bring up a sub menu that lets you enable file previews for certain types of file.</para> +<para>Generally this means that the file's icon will be replaced by a small image showing the file contents.</para> +<para>If file preview is enabled for <guimenuitem>Sound Files</guimenuitem> the file will be played whenever the mouse cursor is hovering over the file name or icon.</para> +<para>Note that file previews are only available in <guimenuitem>Icon View </guimenuitem> and <guimenuitem>MultiColumn View</guimenuitem> modes.</para> +<para>Because &konqueror; has to read much more data than just the file name details to generate a preview, file previews may not be appropriate when viewing files on a floppy or from a remote system. The <guilabel>Previews </guilabel> page of the File Manager Configuration dialogue allows you to disable file previews for protocols such as <link linkend="ftp">ftp</link> where reading the extra data would take too long.</para> </sect2> </sect1> <sect1 id="navigation"> -<title ->Navigation</title> -<para ->To get to a file with &konqueror; you first need to navigate through the folder tree to find the folder containing that file.</para> +<title>Navigation</title> +<para>To get to a file with &konqueror; you first need to navigate through the folder tree to find the folder containing that file.</para> -<para ->To move between folders you can simply step up and down the tree:</para> +<para>To move between folders you can simply step up and down the tree:</para> <itemizedlist> -<listitem -><para ->To descend into a subfolder <mousebutton ->left </mousebutton -> click on its name or icon, or if you have <quote ->selected</quote -> it (see below) then just press <keycap ->Enter</keycap ->.</para -></listitem -> -<listitem -><para ->To go up the folder tree, click on the <guiicon ->Up </guiicon -> button in the Toolbar, or use<keycombo action="simul" ->&Alt;<keysym ->Up Arrow</keysym -></keycombo ->, or use the Menubar <menuchoice -><guimenu ->Go</guimenu -><guimenuitem ->Up</guimenuitem -></menuchoice -> option.</para -></listitem> +<listitem><para>To descend into a subfolder <mousebutton>left </mousebutton> click on its name or icon, or if you have <quote>selected</quote> it (see below) then just press <keycap>Enter</keycap>.</para></listitem> +<listitem><para>To go up the folder tree, click on the <guiicon>Up </guiicon> button in the Toolbar, or use<keycombo action="simul">&Alt;<keysym>Up Arrow</keysym></keycombo>, or use the Menubar <menuchoice><guimenu>Go</guimenu><guimenuitem>Up</guimenuitem></menuchoice> option.</para></listitem> </itemizedlist> -<para ->To <quote ->select</quote -> a file or folder in the displayed folder without opening it in any way use the <keysym ->up</keysym -> and <keysym ->down </keysym -> arrow keys to move through the items. The selected item will be highlighted and some information about it will be displayed in the Status Bar.</para> - -<para ->Setting the <link linkend="viewmode" ->View Mode</link -> to <guimenuitem -> Tree View</guimenuitem -> can help you locate folders in the tree below the current folder. In this mode each folder is shown with a small box at the left. If the box contains a <keycap ->+</keycap -> sign, <mousebutton ->left </mousebutton -> clicking on the box (not on the folder name or icon) will display a sub tree showing files and subfolders contained in that folder. The small box will then change to show a <keycap ->-</keycap -> sign. <mousebutton ->Left</mousebutton -> click on that to collapse the sub tree. Once you have found the folder you are looking for, <mousebutton ->left </mousebutton -> click on the folder name or icon to open it.</para> - -<para ->The <link linkend="sidebar" ->Navigation Panel</link -> can also help you find your way around the file system.</para> - -<para ->You can go directly to any folder by typing its path into the Location Toolbar window or into the dialogue box invoked by the Menubar <menuchoice -><guimenu ->Location</guimenu -><guimenuitem ->Open Location</guimenuitem -> </menuchoice -> item or by <keycombo action="simul" ->&Ctrl;<keycap -> O</keycap -></keycombo ->. &konqueror;'s <link linkend="path-complete" -> Text Completion</link -> feature may be useful when you do this. Don't forget that in &Linux; / &UNIX; file and folder names are case sensitive.</para> - -<para ->Once you have moved to a new folder you can go back to your previous choice by using the Toolbar <guiicon ->Back</guiicon -> button, the Menubar <menuchoice -><guimenu ->Go</guimenu -> <guimenuitem ->Back</guimenuitem -></menuchoice -> item, or <keycombo action="simul" ->&Alt;<keysym ->Left Arrow</keysym -></keycombo ->.</para> - -<para ->Once you have gone back you can go forward. Use the Toolbar <guiicon ->Forward</guiicon -> button, the Menubar <menuchoice -><guimenu ->Go</guimenu -> <guimenuitem ->Forward</guimenuitem -></menuchoice -> item or <keycombo action="simul" ->&Alt;<keysym ->Right Arrow</keysym -></keycombo ->.</para> - -<tip -><para ->Holding the &LMB; pressed while the mouse pointer is over the Toolbar <guiicon ->Up</guiicon ->, <guiicon ->Back</guiicon -> or <guiicon ->Forward</guiicon -> buttons brings up a menu of recently visited locations.</para -></tip> +<para>To <quote>select</quote> a file or folder in the displayed folder without opening it in any way use the <keysym>up</keysym> and <keysym>down </keysym> arrow keys to move through the items. The selected item will be highlighted and some information about it will be displayed in the Status Bar.</para> + +<para>Setting the <link linkend="viewmode">View Mode</link> to <guimenuitem> Tree View</guimenuitem> can help you locate folders in the tree below the current folder. In this mode each folder is shown with a small box at the left. If the box contains a <keycap>+</keycap> sign, <mousebutton>left </mousebutton> clicking on the box (not on the folder name or icon) will display a sub tree showing files and subfolders contained in that folder. The small box will then change to show a <keycap>-</keycap> sign. <mousebutton>Left</mousebutton> click on that to collapse the sub tree. Once you have found the folder you are looking for, <mousebutton>left </mousebutton> click on the folder name or icon to open it.</para> + +<para>The <link linkend="sidebar">Navigation Panel</link> can also help you find your way around the file system.</para> + +<para>You can go directly to any folder by typing its path into the Location Toolbar window or into the dialogue box invoked by the Menubar <menuchoice><guimenu>Location</guimenu><guimenuitem>Open Location</guimenuitem> </menuchoice> item or by <keycombo action="simul">&Ctrl;<keycap> O</keycap></keycombo>. &konqueror;'s <link linkend="path-complete"> Text Completion</link> feature may be useful when you do this. Don't forget that in &Linux; / &UNIX; file and folder names are case sensitive.</para> + +<para>Once you have moved to a new folder you can go back to your previous choice by using the Toolbar <guiicon>Back</guiicon> button, the Menubar <menuchoice><guimenu>Go</guimenu> <guimenuitem>Back</guimenuitem></menuchoice> item, or <keycombo action="simul">&Alt;<keysym>Left Arrow</keysym></keycombo>.</para> + +<para>Once you have gone back you can go forward. Use the Toolbar <guiicon>Forward</guiicon> button, the Menubar <menuchoice><guimenu>Go</guimenu> <guimenuitem>Forward</guimenuitem></menuchoice> item or <keycombo action="simul">&Alt;<keysym>Right Arrow</keysym></keycombo>.</para> + +<tip><para>Holding the &LMB; pressed while the mouse pointer is over the Toolbar <guiicon>Up</guiicon>, <guiicon>Back</guiicon> or <guiicon>Forward</guiicon> buttons brings up a menu of recently visited locations.</para></tip> <sect2 id="file-find"> -<title ->Finding Files and Folders</title> - -<para ->If you don't know or can't remember where a file or folder is within your system, then use the Toolbar <guiicon ->Find File</guiicon -> button or the Menubar <menuchoice -><guimenu ->Tools</guimenu -><guimenuitem ->Find File...</guimenuitem -></menuchoice -> option. This will embed the file finder application &kfind; into &konqueror;'s window. See the &kfind; Handbook for help in using &kfind;. </para> - -<note -><para ->If the name of a file or folder begins with a period (dot), then it is a <quote ->hidden</quote -> file or folder, and will not normally be shown by &konqueror;. To see hidden files or folders use the Menubar <menuchoice -> <guimenu ->View</guimenu -><guimenuitem ->Show Hidden Files</guimenuitem -> </menuchoice -> option.</para> -<para ->Another reason &konqueror; may not show the file or folder you are looking for is that you may have the <link linkend="konq-plugin" -><guisubmenu -> View Filter</guisubmenu -></link -> plugin set to display only certain types of file.</para -></note> +<title>Finding Files and Folders</title> + +<para>If you don't know or can't remember where a file or folder is within your system, then use the Toolbar <guiicon>Find File</guiicon> button or the Menubar <menuchoice><guimenu>Tools</guimenu><guimenuitem>Find File...</guimenuitem></menuchoice> option. This will embed the file finder application &kfind; into &konqueror;'s window. See the &kfind; Handbook for help in using &kfind;. </para> + +<note><para>If the name of a file or folder begins with a period (dot), then it is a <quote>hidden</quote> file or folder, and will not normally be shown by &konqueror;. To see hidden files or folders use the Menubar <menuchoice> <guimenu>View</guimenu><guimenuitem>Show Hidden Files</guimenuitem> </menuchoice> option.</para> +<para>Another reason &konqueror; may not show the file or folder you are looking for is that you may have the <link linkend="konq-plugin"><guisubmenu> View Filter</guisubmenu></link> plugin set to display only certain types of file.</para></note> </sect2> <sect2 id="floppy-cd"> -<title ->Floppy and &CD-ROM; Drives</title> - -<para ->Any floppy disk, &CD; drive or other hard disk partition that you have on your system will usually appear in the <filename class="directory" ->/ </filename ->, <filename class="directory" ->/mnt</filename -> or <filename class="directory" ->/auto</filename -> folder, having a path something like <filename class="directory" ->/mnt/floppy</filename -> or <filename class="directory" ->/cdrom</filename ->. The details will depend on how your system was set up.</para> - -<para ->&UNIX; / &Linux; requires that you <command ->mount</command -> a floppy disk or &CD-ROM; when you have inserted it into the drive, and <command ->mount </command -> other hard disk partitions when you want to access them. You also need to unmount a floppy disk or &CD-ROM; before removing it to register that it is no longer available. </para> - -<para ->How you do this will depend on how your system:</para> +<title>Floppy and &CD-ROM; Drives</title> + +<para>Any floppy disk, &CD; drive or other hard disk partition that you have on your system will usually appear in the <filename class="directory">/ </filename>, <filename class="directory">/mnt</filename> or <filename class="directory">/auto</filename> folder, having a path something like <filename class="directory">/mnt/floppy</filename> or <filename class="directory">/cdrom</filename>. The details will depend on how your system was set up.</para> + +<para>&UNIX; / &Linux; requires that you <command>mount</command> a floppy disk or &CD-ROM; when you have inserted it into the drive, and <command>mount </command> other hard disk partitions when you want to access them. You also need to unmount a floppy disk or &CD-ROM; before removing it to register that it is no longer available. </para> + +<para>How you do this will depend on how your system:</para> <itemizedlist> -<listitem -><para ->You may have an <application ->Automount</application -> facility, in which case you don't have to bother about explicitly mounting and unmounting, although you may find that the &CD-ROM; occasionally starts up by itself for no apparent reason.</para -></listitem> - -<listitem -><para ->You may have <guiicon ->Floppy</guiicon ->, &CD-ROM; and hard disk icons on your desktop, in which case &LMB; click on the icon to mount it. Doing this should also bring up a &konqueror; window showing the contents of the floppy, &CD-ROM; or partition. To unmount, <mousebutton ->right</mousebutton -> click on the icon and choose the <guimenuitem ->Unmount</guimenuitem -> item. Visit the section <link linkend="making" ->Create New...</link -> in this Handbook to see how to create such an icon.</para -></listitem> - -<listitem -><para ->Or you can do it the traditional way by typing into a text console window:</para> - -<para -><userinput -><command ->mount /mnt/floppy</command -></userinput -></para> +<listitem><para>You may have an <application>Automount</application> facility, in which case you don't have to bother about explicitly mounting and unmounting, although you may find that the &CD-ROM; occasionally starts up by itself for no apparent reason.</para></listitem> + +<listitem><para>You may have <guiicon>Floppy</guiicon>, &CD-ROM; and hard disk icons on your desktop, in which case &LMB; click on the icon to mount it. Doing this should also bring up a &konqueror; window showing the contents of the floppy, &CD-ROM; or partition. To unmount, <mousebutton>right</mousebutton> click on the icon and choose the <guimenuitem>Unmount</guimenuitem> item. Visit the section <link linkend="making">Create New...</link> in this Handbook to see how to create such an icon.</para></listitem> + +<listitem><para>Or you can do it the traditional way by typing into a text console window:</para> + +<para><userinput><command>mount /mnt/floppy</command></userinput></para> <!-- This markup doesn't work properly, it puts 'mount' and '/mnt/floppy' on separate lines -<screen -> +<screen> <userinput><command>mount</command> <option><replaceable>/mnt/floppy</replaceable></option></userinput> -</screen -> --> +</screen> --> -<para ->to mount, for example, the floppy drive, and</para> +<para>to mount, for example, the floppy drive, and</para> <!-- Same as above -<screen -> +<screen> <userinput><command>umount</command> <option><replaceable>/mnt/floppy</replaceable></option></userinput></screen> --> -<para -><userinput -><command ->umount /mnt/floppy</command -></userinput -></para> - -<para ->to unmount it (<command ->umount</command -> not <command ->unmount</command ->). </para> - -<note -><para ->Rather than having to open a text console to type the <command ->mount </command -> or <command ->umount</command -> commands, you may prefer to use &konqueror;'s <menuchoice -><guimenu -> Tools</guimenu -><guimenuitem ->Execute Shell Command</guimenuitem -></menuchoice -> (<keycombo action="simul" ->&Ctrl;<keycap ->E</keycap -></keycombo ->) feature. </para -></note> +<para><userinput><command>umount /mnt/floppy</command></userinput></para> + +<para>to unmount it (<command>umount</command> not <command>unmount</command>). </para> + +<note><para>Rather than having to open a text console to type the <command>mount </command> or <command>umount</command> commands, you may prefer to use &konqueror;'s <menuchoice><guimenu> Tools</guimenu><guimenuitem>Execute Shell Command</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo>) feature. </para></note> </listitem> @@ -538,730 +161,215 @@ on separate lines </sect1> <sect1 id="deleting"> -<title ->Deleting Files and Folders</title> +<title>Deleting Files and Folders</title> -<para ->&konqueror; gives you two ways to dispose of an unwanted file or folder:</para> +<para>&konqueror; gives you two ways to dispose of an unwanted file or folder:</para> <itemizedlist> -<listitem -><para ->You can move it to the <filename ->Trash</filename -> folder, which is the safest method as you can get it back if you realise that you have made a mistake.</para -></listitem -> - -<listitem -><para ->You can just plain Delete it, which removes the entry from the folder and adds the disk area occupied by the file(s) to the system's list of free disk areas, in the same way as the <command ->rm</command -> command.</para -></listitem> +<listitem><para>You can move it to the <filename>Trash</filename> folder, which is the safest method as you can get it back if you realise that you have made a mistake.</para></listitem> + +<listitem><para>You can just plain Delete it, which removes the entry from the folder and adds the disk area occupied by the file(s) to the system's list of free disk areas, in the same way as the <command>rm</command> command.</para></listitem> </itemizedlist> -<para ->The simplest way to remove a file or folder is to position the mouse pointer over its name or icon and press the &RMB;, which will bring up a menu containing the options <guimenuitem ->Move to Wastebin</guimenuitem -> and <guimenuitem ->Delete</guimenuitem ->.</para> - -<para ->Or, if you have <quote ->selected</quote -> the item, the Menubar <guimenu ->Edit</guimenu -> menu will give you the choice of <quote -><guimenuitem ->Move to Wastebin</guimenuitem -></quote -> and <quote -><guimenuitem ->Delete</guimenuitem -></quote -> options.</para> - -<para -><keycap ->Del</keycap -> will move the selected item or items to the Wastebin.</para> - -<para -><keycombo action="simul" ->&Shift;<keycap ->Del</keycap -></keycombo -> will really, truly and irrevocably delete the selected item or items.</para> - -<note -><para ->You won't be able to remove a file or folder if you do not have the necessary permissions, see the section on <link linkend="super-user" ->Super User Mode</link -> for further details.</para -></note> +<para>The simplest way to remove a file or folder is to position the mouse pointer over its name or icon and press the &RMB;, which will bring up a menu containing the options <guimenuitem>Move to Wastebin</guimenuitem> and <guimenuitem>Delete</guimenuitem>.</para> + +<para>Or, if you have <quote>selected</quote> the item, the Menubar <guimenu>Edit</guimenu> menu will give you the choice of <quote><guimenuitem>Move to Wastebin</guimenuitem></quote> and <quote><guimenuitem>Delete</guimenuitem></quote> options.</para> + +<para><keycap>Del</keycap> will move the selected item or items to the Wastebin.</para> + +<para><keycombo action="simul">&Shift;<keycap>Del</keycap></keycombo> will really, truly and irrevocably delete the selected item or items.</para> + +<note><para>You won't be able to remove a file or folder if you do not have the necessary permissions, see the section on <link linkend="super-user">Super User Mode</link> for further details.</para></note> </sect1> <sect1 id="moving"> -<title ->Moving and Copying</title> +<title>Moving and Copying</title> -<para ->To copy a file or subfolder between folders you can:</para> +<para>To copy a file or subfolder between folders you can:</para> <itemizedlist> -<listitem -><para ->Position the mouse pointer over its name or icon and hold down the &RMB;, which will bring up a menu containing the <guimenuitem ->Copy</guimenuitem -> option. Choose that.</para> - -<para ->Or if the item is <quote ->selected</quote -> you can use the <guiicon ->Copy</guiicon -> button on the Toolbar or the Menubar <menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Copy</guimenuitem -></menuchoice -> item, or the <keycombo action="simul" ->&Ctrl;<keycap ->C</keycap -></keycombo -> shortcut key combination.</para -></listitem> - -<listitem -><para ->Navigate to the folder you want to copy the item into then Paste the item into the new folder by using the Toolbar <guiicon ->Paste</guiicon -> button or the Menubar <menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Paste</guimenuitem -></menuchoice -> option or the <keycombo action="simul" ->&Ctrl;<keycap ->V</keycap -></keycombo -> shortcut, or by moving the mouse pointer to a clear area of the window and holding the &RMB; down to bring up a menu containing the <guimenuitem ->Paste</guimenuitem -> option. </para -></listitem> +<listitem><para>Position the mouse pointer over its name or icon and hold down the &RMB;, which will bring up a menu containing the <guimenuitem>Copy</guimenuitem> option. Choose that.</para> + +<para>Or if the item is <quote>selected</quote> you can use the <guiicon>Copy</guiicon> button on the Toolbar or the Menubar <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Copy</guimenuitem></menuchoice> item, or the <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> shortcut key combination.</para></listitem> + +<listitem><para>Navigate to the folder you want to copy the item into then Paste the item into the new folder by using the Toolbar <guiicon>Paste</guiicon> button or the Menubar <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Paste</guimenuitem></menuchoice> option or the <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo> shortcut, or by moving the mouse pointer to a clear area of the window and holding the &RMB; down to bring up a menu containing the <guimenuitem>Paste</guimenuitem> option. </para></listitem> </itemizedlist> -<para ->Moving a file or subfolder between folders can be done in the same way as copying, except that you choose the <guimenuitem ->Cut</guimenuitem -> option or <keycombo action="simul" ->&Ctrl;<keycap ->X</keycap -></keycombo -> instead of <guimenuitem ->Copy</guimenuitem ->. The item that you have <guimenuitem ->Cut</guimenuitem -> will be removed from the original folder when you do the <guimenuitem ->Paste</guimenuitem -> into the new folder.</para> - -<para ->You can also copy or move selected item(s) to another folder by using <menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Copy Files</guimenuitem -></menuchoice -> (<keycap ->F7</keycap ->) or <menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Move Files</guimenuitem -> </menuchoice -> (<keycap ->F8</keycap ->), or by selecting <guimenuitem ->Copy To</guimenuitem -> or <guimenuitem ->Move To</guimenuitem -> from the drop down menu you get when you <mousebutton ->right</mousebutton -> click on an file or folder name in the File Manager window.</para> - -<note -><para ->You may not be able to copy or move a file or folder if you don't have the necessary permissions. See the section on <link linkend="super-user" ->Super User Mode</link -> for further details.</para -></note> +<para>Moving a file or subfolder between folders can be done in the same way as copying, except that you choose the <guimenuitem>Cut</guimenuitem> option or <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo> instead of <guimenuitem>Copy</guimenuitem>. The item that you have <guimenuitem>Cut</guimenuitem> will be removed from the original folder when you do the <guimenuitem>Paste</guimenuitem> into the new folder.</para> + +<para>You can also copy or move selected item(s) to another folder by using <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Copy Files</guimenuitem></menuchoice> (<keycap>F7</keycap>) or <menuchoice><guimenu>Edit</guimenu><guimenuitem>Move Files</guimenuitem> </menuchoice> (<keycap>F8</keycap>), or by selecting <guimenuitem>Copy To</guimenuitem> or <guimenuitem>Move To</guimenuitem> from the drop down menu you get when you <mousebutton>right</mousebutton> click on an file or folder name in the File Manager window.</para> + +<note><para>You may not be able to copy or move a file or folder if you don't have the necessary permissions. See the section on <link linkend="super-user">Super User Mode</link> for further details.</para></note> <sect2 id="dnd"> -<title ->Using Drag 'n Drop</title> - -<para ->&konqueror; also supports Drag and Drop copying and moving of files and folders.</para> - -<para ->You can do this by having two instances of &konqueror;, one showing the folder you want to copy from, the other showing the target folder. Position the mouse pointer over the item you wish to copy or move, then, holding the &LMB; pressed, <quote ->drag</quote -> it to a clear space in the target folder. Release the button and you will be presented with a menu choice of <guimenuitem ->Copy</guimenuitem -> or <guimenuitem ->Move</guimenuitem ->. Take care to <quote ->drop</quote -> the item into an empty area of the target folder view - dropping it on top of another file name or icon can cause problems.</para> - -<para ->You can also set up &konqueror; to show more than one folder within its window and drag & drop between them.</para> +<title>Using Drag 'n Drop</title> + +<para>&konqueror; also supports Drag and Drop copying and moving of files and folders.</para> + +<para>You can do this by having two instances of &konqueror;, one showing the folder you want to copy from, the other showing the target folder. Position the mouse pointer over the item you wish to copy or move, then, holding the &LMB; pressed, <quote>drag</quote> it to a clear space in the target folder. Release the button and you will be presented with a menu choice of <guimenuitem>Copy</guimenuitem> or <guimenuitem>Move</guimenuitem>. Take care to <quote>drop</quote> the item into an empty area of the target folder view - dropping it on top of another file name or icon can cause problems.</para> + +<para>You can also set up &konqueror; to show more than one folder within its window and drag & drop between them.</para> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="dragdrop.png"/></imageobject> +<imageobject><imagedata format="PNG" fileref="dragdrop.png"/></imageobject> <textobject> -<phrase ->Split Views for Drag & Drop</phrase> +<phrase>Split Views for Drag & Drop</phrase> </textobject> </mediaobject> -<para ->This screenshot illustrates the use of the Menubar <menuchoice -><guimenu ->Window</guimenu -> <guimenuitem ->Split View Left/Right</guimenuitem -></menuchoice -> option, also available with the shortcut <keycombo action="simul" ->&Ctrl;&Shift;<keycap ->L</keycap -> </keycombo ->, to split the main &konqueror; window into two views, each showing the contents of a different folder.</para> - -<para ->To be able to show different folders in each view they should not be linked; the little boxes at the bottom right of each view should be empty. </para> - -<para ->The <quote ->active</quote -> view, that is the one whose path is shown in the Location Toolbar and which responds to navigation and Menubar commands, is shown by the little green light in the bottom left corner. To make a view active, <mousebutton ->left</mousebutton -> click on an empty area of the view or on its Status Bar.</para> - -<para ->To remove an active view from &konqueror;'s window use the <keycombo action="simul" ->&Ctrl;&Shift;<keycap ->R</keycap -> </keycombo -> shortcut, or the Menubar <menuchoice -><guimenu ->Window</guimenu -> <guimenuitem ->Remove Active View</guimenuitem -></menuchoice -> option, or &RMB; click on the Status Bar and choose the <guimenuitem ->Remove Active View</guimenuitem -> option from the resulting menu.</para> - -<para ->If you use &konqueror; tabs, you can drag and drop between tabs by dragging the file to the tab label, without letting go yet. The destination tab will pop to the front, allowing you to continue dragging and then drop the file.</para> +<para>This screenshot illustrates the use of the Menubar <menuchoice><guimenu>Window</guimenu> <guimenuitem>Split View Left/Right</guimenuitem></menuchoice> option, also available with the shortcut <keycombo action="simul">&Ctrl;&Shift;<keycap>L</keycap> </keycombo>, to split the main &konqueror; window into two views, each showing the contents of a different folder.</para> + +<para>To be able to show different folders in each view they should not be linked; the little boxes at the bottom right of each view should be empty. </para> + +<para>The <quote>active</quote> view, that is the one whose path is shown in the Location Toolbar and which responds to navigation and Menubar commands, is shown by the little green light in the bottom left corner. To make a view active, <mousebutton>left</mousebutton> click on an empty area of the view or on its Status Bar.</para> + +<para>To remove an active view from &konqueror;'s window use the <keycombo action="simul">&Ctrl;&Shift;<keycap>R</keycap> </keycombo> shortcut, or the Menubar <menuchoice><guimenu>Window</guimenu> <guimenuitem>Remove Active View</guimenuitem></menuchoice> option, or &RMB; click on the Status Bar and choose the <guimenuitem>Remove Active View</guimenuitem> option from the resulting menu.</para> + +<para>If you use &konqueror; tabs, you can drag and drop between tabs by dragging the file to the tab label, without letting go yet. The destination tab will pop to the front, allowing you to continue dragging and then drop the file.</para> </sect2> <sect2 id="dups"> -<title ->Duplicate File Names</title> -<para ->If you try to paste a file into a folder that already contains a file with the same name, &konqueror; will pop up a dialogue box warning you that the file already exists. You can then choose to: </para> +<title>Duplicate File Names</title> +<para>If you try to paste a file into a folder that already contains a file with the same name, &konqueror; will pop up a dialogue box warning you that the file already exists. You can then choose to: </para> <itemizedlist> -<listitem -><para -><guilabel ->Overwrite</guilabel -> the old file with the newly copied one. The <guibutton ->Overwrite All</guibutton -> button can be used if you have copied multiple items.</para -></listitem> -<listitem -><para ->Cancel the paste operation by pressing the <guibutton ->Skip </guibutton -> or <guibutton ->Skip All</guibutton -> button.</para -></listitem> -<listitem -><para ->Give the file that is being copied a different name. You can do this by typing a new name into the text entry box or get &konqueror; to <guibutton ->Propose</guibutton -> one. When you have done this press the <guibutton ->Rename</guibutton -> button.</para -></listitem> +<listitem><para><guilabel>Overwrite</guilabel> the old file with the newly copied one. The <guibutton>Overwrite All</guibutton> button can be used if you have copied multiple items.</para></listitem> +<listitem><para>Cancel the paste operation by pressing the <guibutton>Skip </guibutton> or <guibutton>Skip All</guibutton> button.</para></listitem> +<listitem><para>Give the file that is being copied a different name. You can do this by typing a new name into the text entry box or get &konqueror; to <guibutton>Propose</guibutton> one. When you have done this press the <guibutton>Rename</guibutton> button.</para></listitem> </itemizedlist> </sect2> </sect1> <sect1 id="multiple"> -<title ->Selecting Multiple Files</title> - -<para ->You sometimes want to delete, copy or move a number of files that are similar in some way. For example you may wish to move all of the .png graphics files from one folder to another. &konqueror; makes this easy by letting you select multiple files based on similarities in their file names.</para> - -<para ->Use the Menubar <menuchoice -><guimenu ->Edit</guimenu -><guisubmenu ->Selection</guisubmenu -> <guimenuitem ->Select...</guimenuitem -></menuchoice -> item or the shortcut <keycombo action="simul" ->&Ctrl;<keycap ->+</keycap -></keycombo ->. This brings up a little dialogue box in which you enter a filename containing the wildcard characters <keycap ->*</keycap ->, which matches any number of characters, and <keycap ->?</keycap -> which matches a single character. Press <guibutton ->OK</guibutton -> and &konqueror; will highlight all files with matching names. For example;</para> +<title>Selecting Multiple Files</title> + +<para>You sometimes want to delete, copy or move a number of files that are similar in some way. For example you may wish to move all of the .png graphics files from one folder to another. &konqueror; makes this easy by letting you select multiple files based on similarities in their file names.</para> + +<para>Use the Menubar <menuchoice><guimenu>Edit</guimenu><guisubmenu>Selection</guisubmenu> <guimenuitem>Select...</guimenuitem></menuchoice> item or the shortcut <keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo>. This brings up a little dialogue box in which you enter a filename containing the wildcard characters <keycap>*</keycap>, which matches any number of characters, and <keycap>?</keycap> which matches a single character. Press <guibutton>OK</guibutton> and &konqueror; will highlight all files with matching names. For example;</para> <itemizedlist> -<listitem -><para -><userinput -><filename ->flag*.png</filename -></userinput -> will select all filenames starting with the letters <quote ->flag</quote -> and ending with <quote -><literal role="extension" ->.png</literal -></quote ->.</para -></listitem> -<listitem -><para -><userinput -><filename ->memo?.txt</filename -></userinput -> will select <filename ->memo1.txt</filename -> and <filename ->memo9.txt</filename -> but not <filename ->memo99.txt</filename ->.</para -></listitem> +<listitem><para><userinput><filename>flag*.png</filename></userinput> will select all filenames starting with the letters <quote>flag</quote> and ending with <quote><literal role="extension">.png</literal></quote>.</para></listitem> +<listitem><para><userinput><filename>memo?.txt</filename></userinput> will select <filename>memo1.txt</filename> and <filename>memo9.txt</filename> but not <filename>memo99.txt</filename>.</para></listitem> </itemizedlist> -<para ->When you have selected a range of files, you can narrow down the selection by uing the Menubar <menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Unselect...</guimenuitem -></menuchoice -> option or <keycombo action="simul" ->&Ctrl;<keycap ->-</keycap -></keycombo -> to specify which of the selected files should be removed from the selection.</para> - -<para ->Use <keycombo action="simul" ->&Ctrl;<keycap ->U</keycap -></keycombo -> or the Menubar <menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Unselect All</guimenuitem -></menuchoice -> option or just &LMB; click on a clear area of the view to cancel the selection.</para> - -<para ->You can even invert the selection: that is, deselect all selected files and select those that were previously unselected. Use the Menubar <menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Invert Selection</guimenuitem -></menuchoice -> option or <keycombo action="simul" ->&Ctrl;<keycap ->*</keycap -></keycombo -> to do this.</para> - -<para ->A number of useful shortcut keys can be used in list, tree and text view modes:</para> +<para>When you have selected a range of files, you can narrow down the selection by uing the Menubar <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Unselect...</guimenuitem></menuchoice> option or <keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo> to specify which of the selected files should be removed from the selection.</para> + +<para>Use <keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo> or the Menubar <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Unselect All</guimenuitem></menuchoice> option or just &LMB; click on a clear area of the view to cancel the selection.</para> + +<para>You can even invert the selection: that is, deselect all selected files and select those that were previously unselected. Use the Menubar <menuchoice><guimenu>Edit</guimenu><guimenuitem>Invert Selection</guimenuitem></menuchoice> option or <keycombo action="simul">&Ctrl;<keycap>*</keycap></keycombo> to do this.</para> + +<para>A number of useful shortcut keys can be used in list, tree and text view modes:</para> <variablelist> <varlistentry> -<term -><keycap ->Space</keycap -></term> +<term><keycap>Space</keycap></term> <listitem> -<para ->Toggle the current selection. </para> +<para>Toggle the current selection. </para> </listitem> </varlistentry> <varlistentry> -<term -><keycap ->Insert</keycap -></term> +<term><keycap>Insert</keycap></term> <listitem> -<para ->Toggle the current selection and move down to the next item. </para> +<para>Toggle the current selection and move down to the next item. </para> </listitem> </varlistentry> <varlistentry> -<term -><keycombo action="simul" ->&Ctrl;<keysym ->Up Arrow</keysym -></keycombo ->, <keycombo action="simul" ->&Ctrl;<keysym ->Down Arrow</keysym -></keycombo ->, <keycombo action="simul" ->&Ctrl;<keycap ->Home</keycap -></keycombo ->, <keycombo action="simul" ->&Ctrl;<keycap ->End</keycap -></keycombo ->, <keycombo action="simul" ->&Ctrl;<keycap ->Page Up</keycap -></keycombo ->, <keycombo action="simul" ->&Ctrl;<keycap ->Page Down</keycap -></keycombo -> </term> +<term><keycombo action="simul">&Ctrl;<keysym>Up Arrow</keysym></keycombo>, <keycombo action="simul">&Ctrl;<keysym>Down Arrow</keysym></keycombo>, <keycombo action="simul">&Ctrl;<keycap>Home</keycap></keycombo>, <keycombo action="simul">&Ctrl;<keycap>End</keycap></keycombo>, <keycombo action="simul">&Ctrl;<keycap>Page Up</keycap></keycombo>, <keycombo action="simul">&Ctrl;<keycap>Page Down</keycap></keycombo> </term> <listitem> -<para ->Move the selection, toggling the selection of everything on the way. </para> +<para>Move the selection, toggling the selection of everything on the way. </para> </listitem> </varlistentry> <varlistentry> -<term -><keycombo action="simul" ->&Shift;<keysym ->Up Arrow</keysym -></keycombo ->, <keycombo action="simul" ->&Shift;<keysym ->Down Arrow</keysym -></keycombo ->, <keycombo action="simul" ->&Shift;<keycap ->Home</keycap -></keycombo ->, <keycombo action="simul" ->&Shift;<keycap ->End</keycap -></keycombo ->, <keycombo action="simul" ->&Shift;<keycap ->Page Up</keycap -></keycombo ->, <keycombo action="simul" ->&Shift;<keycap ->Page Down</keycap -></keycombo -> </term> +<term><keycombo action="simul">&Shift;<keysym>Up Arrow</keysym></keycombo>, <keycombo action="simul">&Shift;<keysym>Down Arrow</keysym></keycombo>, <keycombo action="simul">&Shift;<keycap>Home</keycap></keycombo>, <keycombo action="simul">&Shift;<keycap>End</keycap></keycombo>, <keycombo action="simul">&Shift;<keycap>Page Up</keycap></keycombo>, <keycombo action="simul">&Shift;<keycap>Page Down</keycap></keycombo> </term> <listitem> -<para ->Deselect everything, then move the selection, selecting everything on the way. </para> +<para>Deselect everything, then move the selection, selecting everything on the way. </para> </listitem> </varlistentry> </variablelist> -<para ->Once you have selected the right files then the normal delete, copy or move commands will act on all of the selected files at once. </para> - -<note -><para ->Depending on your keyboard type and locale, you may find that the <keycombo action="simul" ->&Ctrl;<keycap ->+</keycap -></keycombo ->, <keycombo action="simul" ->&Ctrl;<keycap ->-</keycap -></keycombo -> and <keycombo action="simul" ->&Ctrl;<keycap ->*</keycap -></keycombo -> shortcuts only work with the Numeric keypad <keycap ->+</keycap ->, <keycap ->-</keycap -> and <keycap ->*</keycap -> keys.</para -></note> +<para>Once you have selected the right files then the normal delete, copy or move commands will act on all of the selected files at once. </para> + +<note><para>Depending on your keyboard type and locale, you may find that the <keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo>, <keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo> and <keycombo action="simul">&Ctrl;<keycap>*</keycap></keycombo> shortcuts only work with the Numeric keypad <keycap>+</keycap>, <keycap>-</keycap> and <keycap>*</keycap> keys.</para></note> </sect1> <sect1 id="making"> -<title ->Create New</title> +<title>Create New</title> -<para ->When &konqueror; is in File Manager mode, picking <guisubmenu ->Create New</guisubmenu -> from the <guimenu ->Edit</guimenu -> menu or from the context menu you get by &RMB; clicking on a free area in a folder view gives you a submenu letting you create any of the following in the current folder:</para> +<para>When &konqueror; is in File Manager mode, picking <guisubmenu>Create New</guisubmenu> from the <guimenu>Edit</guimenu> menu or from the context menu you get by &RMB; clicking on a free area in a folder view gives you a submenu letting you create any of the following in the current folder:</para> <variablelist> <varlistentry> -<term -><menuchoice -><guisubmenu ->File</guisubmenu -><guimenuitem ->Link To Application...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->This option is most useful if you want to create an icon that will open a particular application. It opens a dialogue box with three tabbed pages. The first, <guilabel ->General</guilabel ->, is where you choose an icon and the text that will appear with it. The second page, <guilabel ->Permissions</guilabel ->, lets you select who can use or modify the icon. In the <guilabel ->Application</guilabel -> page you must enter the <guilabel ->Command</guilabel -> that will run the application, for example, <userinput ->kedit</userinput -> to start up the &kedit; text editor. <userinput ->kedit /home/pam/todo.txt</userinput -> would open the file <filename ->/home/pam/todo.txt</filename -> in &kedit;. Advanced options such as the file types which the application can open are also available from this page.</para> - -<para ->To make the application icon appear on your desktop, create the link in your <filename class="directory" ->~/Desktop</filename -> folder (this may be called something slightly different depending on how &kde; was installed on your system) or get to the <guisubmenu ->Create New...</guisubmenu -> sub menu by <mousebutton ->right</mousebutton -> clicking on a free area of the desktop instead of within &konqueror;'s window.</para> - -<para ->If you have a lot of specialised application links and don't want to clutter up the desktop, then why not create them in your Applications folder. You can get there in &konqueror; by choosing <menuchoice -><guimenu ->Go</guimenu -> <guimenuitem ->Applications</guimenuitem -></menuchoice ->. Then create a single icon on your desktop to open your Applications folder, which is usually in <filename class="directory" ->~/.trinity/share/applnk</filename ->.</para> - -<para ->To put an application link icon into the panel, first create it in the Applications folder then drag the icon onto a clear area of the panel.</para> +<term><menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Link To Application...</guimenuitem> </menuchoice></term> +<listitem><para>This option is most useful if you want to create an icon that will open a particular application. It opens a dialogue box with three tabbed pages. The first, <guilabel>General</guilabel>, is where you choose an icon and the text that will appear with it. The second page, <guilabel>Permissions</guilabel>, lets you select who can use or modify the icon. In the <guilabel>Application</guilabel> page you must enter the <guilabel>Command</guilabel> that will run the application, for example, <userinput>kedit</userinput> to start up the &kedit; text editor. <userinput>kedit /home/pam/todo.txt</userinput> would open the file <filename>/home/pam/todo.txt</filename> in &kedit;. Advanced options such as the file types which the application can open are also available from this page.</para> + +<para>To make the application icon appear on your desktop, create the link in your <filename class="directory">~/Desktop</filename> folder (this may be called something slightly different depending on how &kde; was installed on your system) or get to the <guisubmenu>Create New...</guisubmenu> sub menu by <mousebutton>right</mousebutton> clicking on a free area of the desktop instead of within &konqueror;'s window.</para> + +<para>If you have a lot of specialised application links and don't want to clutter up the desktop, then why not create them in your Applications folder. You can get there in &konqueror; by choosing <menuchoice><guimenu>Go</guimenu> <guimenuitem>Applications</guimenuitem></menuchoice>. Then create a single icon on your desktop to open your Applications folder, which is usually in <filename class="directory">~/.trinity/share/applnk</filename>.</para> + +<para>To put an application link icon into the panel, first create it in the Applications folder then drag the icon onto a clear area of the panel.</para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guisubmenu ->File</guisubmenu -><guimenuitem ->Link To Location (URL)...</guimenuitem -></menuchoice -></term> -<listitem -><para ->This lets you create an icon to open &konqueror; at a particular folder or web page. As with <guimenuitem ->Link To Application...</guimenuitem -> you can make the application icon appear on your desktop by creating the link in your <filename ->~/Desktop</filename -> folder or going to the <guisubmenu ->Create New...</guisubmenu -> sub menu by right clicking on a free area of the desktop. When you first create it the text shown with the icon will be the full path or &URL;. You can change it by right clicking on the icon, selecting <guimenuitem ->Properties...</guimenuitem -> and entering the preferred text in the <guilabel ->General</guilabel -> tab page.</para -></listitem> +<term><menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Link To Location (URL)...</guimenuitem></menuchoice></term> +<listitem><para>This lets you create an icon to open &konqueror; at a particular folder or web page. As with <guimenuitem>Link To Application...</guimenuitem> you can make the application icon appear on your desktop by creating the link in your <filename>~/Desktop</filename> folder or going to the <guisubmenu>Create New...</guisubmenu> sub menu by right clicking on a free area of the desktop. When you first create it the text shown with the icon will be the full path or &URL;. You can change it by right clicking on the icon, selecting <guimenuitem>Properties...</guimenuitem> and entering the preferred text in the <guilabel>General</guilabel> tab page.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guisubmenu ->Device</guisubmenu -><guimenuitem ->Floppy Device...</guimenuitem -></menuchoice -></term> -<listitem -><para ->Use this option to create an icon that will mount a floppy disk and open an instance of &konqueror; showing the disk's contents. To unmount the disk when you have finished with it <mousebutton ->right</mousebutton -> click on the icon and select <guimenuitem ->Unmount</guimenuitem ->. In practice it doesn't have to be a floppy disk but can be any hard disk or partition on your system that is not normally mounted. In most cases you will want to create the icon on your desktop.</para -></listitem> +<term><menuchoice><guisubmenu>Device</guisubmenu><guimenuitem>Floppy Device...</guimenuitem></menuchoice></term> +<listitem><para>Use this option to create an icon that will mount a floppy disk and open an instance of &konqueror; showing the disk's contents. To unmount the disk when you have finished with it <mousebutton>right</mousebutton> click on the icon and select <guimenuitem>Unmount</guimenuitem>. In practice it doesn't have to be a floppy disk but can be any hard disk or partition on your system that is not normally mounted. In most cases you will want to create the icon on your desktop.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Hard Disk...</guimenuitem -></term> -<listitem -><para ->This option is similar to <guimenuitem ->Floppy Device...</guimenuitem -> but for a hard disk drive or partition.</para -></listitem> +<term><guimenuitem>Hard Disk...</guimenuitem></term> +<listitem><para>This option is similar to <guimenuitem>Floppy Device...</guimenuitem> but for a hard disk drive or partition.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->CD/DVD-ROM Device...</guimenuitem -></term> -<listitem -><para ->This option is similar to <guimenuitem ->Floppy Device...</guimenuitem -> but for a <acronym ->CD</acronym -> or <acronym ->DVD</acronym -> drive.</para -></listitem> +<term><guimenuitem>CD/DVD-ROM Device...</guimenuitem></term> +<listitem><para>This option is similar to <guimenuitem>Floppy Device...</guimenuitem> but for a <acronym>CD</acronym> or <acronym>DVD</acronym> drive.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Folder...</guimenuitem -></term> -<listitem -><para ->An easy way of creating a new (sub)folder.</para -></listitem> +<term><guimenuitem>Folder...</guimenuitem></term> +<listitem><para>An easy way of creating a new (sub)folder.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Text File...</guimenuitem -></term> -<listitem -><para ->Use this to create an ordinary, empty, text file. A dialogue box will be opened for you to enter the name of your new file.</para -></listitem> +<term><guimenuitem>Text File...</guimenuitem></term> +<listitem><para>Use this to create an ordinary, empty, text file. A dialogue box will be opened for you to enter the name of your new file.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->HTML File...</guimenuitem -></term> -<listitem -><para ->Creates a skeleton <acronym ->HTML</acronym -> source file. When you type the new file's name into the dialogue box it is probably best to give it a <literal role="extension" ->.html </literal -> extension to avoid confusion.</para -></listitem> +<term><guimenuitem>HTML File...</guimenuitem></term> +<listitem><para>Creates a skeleton <acronym>HTML</acronym> source file. When you type the new file's name into the dialogue box it is probably best to give it a <literal role="extension">.html </literal> extension to avoid confusion.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Presentation Document...</guimenuitem -></term> -<listitem -><para ->Creates a skeleton &koffice; &kpresenter; document. Give its name a <literal role="extension" ->.kpr</literal -> extension.</para -></listitem> +<term><guimenuitem>Presentation Document...</guimenuitem></term> +<listitem><para>Creates a skeleton &koffice; &kpresenter; document. Give its name a <literal role="extension">.kpr</literal> extension.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Text Document...</guimenuitem -></term> -<listitem -><para ->Creates a skeleton <application ->KOffice</application -> &kword; document using the standard &kword; style template. Give its name a <literal role="extension" ->.kwd</literal -> extension.</para -></listitem> +<term><guimenuitem>Text Document...</guimenuitem></term> +<listitem><para>Creates a skeleton <application>KOffice</application> &kword; document using the standard &kword; style template. Give its name a <literal role="extension">.kwd</literal> extension.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Spread Sheet Document...</guimenuitem -></term> -<listitem -><para ->Use this to create a new <application ->KOffice</application -> &kspread; spreadsheet file, and name it with a <literal role="extension" ->.ksp</literal -> extension.</para -></listitem> +<term><guimenuitem>Spread Sheet Document...</guimenuitem></term> +<listitem><para>Use this to create a new <application>KOffice</application> &kspread; spreadsheet file, and name it with a <literal role="extension">.ksp</literal> extension.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Illustration Document...</guimenuitem -></term> -<listitem -><para ->Creates a new <application ->KOffice</application -> &kontour; document. Name it with the extension <literal role="extension" ->.kil</literal ->.</para -></listitem> +<term><guimenuitem>Illustration Document...</guimenuitem></term> +<listitem><para>Creates a new <application>KOffice</application> &kontour; document. Name it with the extension <literal role="extension">.kil</literal>.</para></listitem> </varlistentry> </variablelist> @@ -1269,174 +377,56 @@ on separate lines </sect1> <sect1 id="newname"> -<title ->Changing Names and Permissions</title> - -<para ->The easiest way to change the name of a file or folder is to <mousebutton ->right</mousebutton -> click on it and select <guimenuitem ->Rename</guimenuitem ->.</para> - -<para ->To change the name or permissions of a file or folder <mousebutton ->right</mousebutton -> click on its name or icon and select the <guimenuitem ->Properties...</guimenuitem -> item, or if you have <quote ->selected</quote -> the file or folder, then you can use the Menubar <menuchoice -><guimenu ->Edit</guimenu -> <guimenuitem ->Properties</guimenuitem -></menuchoice -> option.</para> - -<para ->This will bring up the Properties dialogue box with two tabbed pages:</para> +<title>Changing Names and Permissions</title> + +<para>The easiest way to change the name of a file or folder is to <mousebutton>right</mousebutton> click on it and select <guimenuitem>Rename</guimenuitem>.</para> + +<para>To change the name or permissions of a file or folder <mousebutton>right</mousebutton> click on its name or icon and select the <guimenuitem>Properties...</guimenuitem> item, or if you have <quote>selected</quote> the file or folder, then you can use the Menubar <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Properties</guimenuitem></menuchoice> option.</para> + +<para>This will bring up the Properties dialogue box with two tabbed pages:</para> <itemizedlist> -<listitem -><para -><guilabel ->General</guilabel ->, which gives you some information about the item and lets you change its name and, for a folder, the associated icon.</para -></listitem> -<listitem -><para -><guilabel ->Permissions</guilabel ->, which shows you the item's ownership and access permissions and lets you change the permissions. </para -></listitem> +<listitem><para><guilabel>General</guilabel>, which gives you some information about the item and lets you change its name and, for a folder, the associated icon.</para></listitem> +<listitem><para><guilabel>Permissions</guilabel>, which shows you the item's ownership and access permissions and lets you change the permissions. </para></listitem> </itemizedlist> <sect2 id="copyrename"> -<title ->Copy and Rename</title> -<para ->If you want to make a copy of an existing file with a different name, perhaps as a backup, in the same folder as the original file, do a normal <guimenuitem ->Copy</guimenuitem -> then when you <guimenuitem ->Paste</guimenuitem -> it a dialogue box will pop up complaining that the file already exists. Just type the new name into the dialogue's text box and press the <guibutton ->Rename</guibutton -> button (or if you are feeling lazy pressing the <guibutton ->Propose</guibutton -> button will generate a new name for you).</para> +<title>Copy and Rename</title> +<para>If you want to make a copy of an existing file with a different name, perhaps as a backup, in the same folder as the original file, do a normal <guimenuitem>Copy</guimenuitem> then when you <guimenuitem>Paste</guimenuitem> it a dialogue box will pop up complaining that the file already exists. Just type the new name into the dialogue's text box and press the <guibutton>Rename</guibutton> button (or if you are feeling lazy pressing the <guibutton>Propose</guibutton> button will generate a new name for you).</para> </sect2> <sect2 id="super-user"> -<title ->Super User Mode</title> - -<para ->If you are running as a normal user and try to access files outside of your own home folder you will often be prevented from doing so and get an error message such as <errorname ->Access Denied</errorname ->. </para> - -<para ->To access these files you need to be logged in as the system administrator, often known as the Super User or <systemitem class="username" ->root</systemitem ->. </para> - -<para ->Rather than logging out then in again, you can launch &konqueror; from the <guimenu ->K</guimenu -> Menu in Super User mode by selecting <menuchoice -><guisubmenu ->System</guisubmenu -><guimenuitem ->File Manager - Super User Mode </guimenuitem -></menuchoice ->. You will be asked for the <systemitem class="username" ->root</systemitem -> login password but as long as you can provide that &konqueror; will be started up with full access privileges to all files on your system.</para> - -<warning -><para ->Take care. As Super User (<systemitem class="username" ->root</systemitem ->), you have complete control of your system, and a wrong command can easily do irrevocable damage.</para> -<para ->Also, connecting to the internet as <systemitem class="username" ->root</systemitem -> is an extremely bad idea, as it seriously increases your vulnerability to malicious hacking.</para -></warning> +<title>Super User Mode</title> + +<para>If you are running as a normal user and try to access files outside of your own home folder you will often be prevented from doing so and get an error message such as <errorname>Access Denied</errorname>. </para> + +<para>To access these files you need to be logged in as the system administrator, often known as the Super User or <systemitem class="username">root</systemitem>. </para> + +<para>Rather than logging out then in again, you can launch &konqueror; from the <guimenu>K</guimenu> Menu in Super User mode by selecting <menuchoice><guisubmenu>System</guisubmenu><guimenuitem>File Manager - Super User Mode </guimenuitem></menuchoice>. You will be asked for the <systemitem class="username">root</systemitem> login password but as long as you can provide that &konqueror; will be started up with full access privileges to all files on your system.</para> + +<warning><para>Take care. As Super User (<systemitem class="username">root</systemitem>), you have complete control of your system, and a wrong command can easily do irrevocable damage.</para> +<para>Also, connecting to the internet as <systemitem class="username">root</systemitem> is an extremely bad idea, as it seriously increases your vulnerability to malicious hacking.</para></warning> </sect2> </sect1> <sect1 id="commandline"> -<title ->At the Command Line</title> - -<para ->Although &konqueror; is a very powerful and flexible <acronym ->GUI</acronym -> file manager, there are occasions when the experienced &Linux; / &UNIX; user wants to get down to the basics and work at the text command line level.</para> - -<para ->She could, of course, open an instance of &konsole;, perhaps with &konqueror;'s Menubar <menuchoice -><guimenu ->Tools</guimenu -><guimenuitem ->Open Terminal</guimenuitem -></menuchoice -> option or with <keycombo action="simul" ->&Ctrl;<keycap ->T</keycap -></keycombo ->.</para> -<para ->If she only wants to launch a program or view a &URL;, the <menuchoice -> <guimenu ->Tools</guimenu -><guimenuitem ->Run Command</guimenuitem -></menuchoice -> (<keycombo action="simul" ->&Alt;<keycap ->F2</keycap -></keycombo ->) option may be easier.</para> - -<para -><menuchoice -><guimenu ->Tools</guimenu -><guimenuitem ->Execute Shell Command... </guimenuitem -></menuchoice -> (<keycombo action="simul" ->&Ctrl; <keycap ->E</keycap -></keycombo ->) opens a small command line dialogue window where you can enter a shell command such as <userinput ->ps -ax | grep tdeinit </userinput ->. Note that it does not support full featured terminal control characters, so applications such as <userinput ->top</userinput -> and <userinput -> less</userinput -> will not work properly, but it is available immediately without the delay involved in starting &konsole;. </para> - -<para ->For more complex operations, &konqueror; has another nice feature; the Menubar <menuchoice -><guimenu ->Window</guimenu -><guimenuitem ->Show Terminal Emulator</guimenuitem -></menuchoice -> option, which opens up a terminal window as a new view within &konqueror;. As long as the link icon is visible at the bottom right corner of each view, the terminal will follow any folder changes you make in the normal file manager view.</para> +<title>At the Command Line</title> + +<para>Although &konqueror; is a very powerful and flexible <acronym>GUI</acronym> file manager, there are occasions when the experienced &Linux; / &UNIX; user wants to get down to the basics and work at the text command line level.</para> + +<para>She could, of course, open an instance of &konsole;, perhaps with &konqueror;'s Menubar <menuchoice><guimenu>Tools</guimenu><guimenuitem>Open Terminal</guimenuitem></menuchoice> option or with <keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo>.</para> +<para>If she only wants to launch a program or view a &URL;, the <menuchoice> <guimenu>Tools</guimenu><guimenuitem>Run Command</guimenuitem></menuchoice> (<keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>) option may be easier.</para> + +<para><menuchoice><guimenu>Tools</guimenu><guimenuitem>Execute Shell Command... </guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl; <keycap>E</keycap></keycombo>) opens a small command line dialogue window where you can enter a shell command such as <userinput>ps -ax | grep tdeinit </userinput>. Note that it does not support full featured terminal control characters, so applications such as <userinput>top</userinput> and <userinput> less</userinput> will not work properly, but it is available immediately without the delay involved in starting &konsole;. </para> + +<para>For more complex operations, &konqueror; has another nice feature; the Menubar <menuchoice><guimenu>Window</guimenu><guimenuitem>Show Terminal Emulator</guimenuitem></menuchoice> option, which opens up a terminal window as a new view within &konqueror;. As long as the link icon is visible at the bottom right corner of each view, the terminal will follow any folder changes you make in the normal file manager view.</para> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="cmndline.png"/></imageobject> +<imageobject><imagedata format="PNG" fileref="cmndline.png"/></imageobject> <textobject> -<phrase ->Including the terminal emulator</phrase> +<phrase>Including the terminal emulator</phrase> </textobject> </mediaobject> diff --git a/tde-i18n-en_GB/docs/tdebase/konqueror/index.docbook b/tde-i18n-en_GB/docs/tdebase/konqueror/index.docbook index e66a34fb8fa..5faf81a696c 100644 --- a/tde-i18n-en_GB/docs/tdebase/konqueror/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/konqueror/index.docbook @@ -16,84 +16,47 @@ <!ENTITY konqueror-commands SYSTEM "commands.docbook"> <!ENTITY konqueror-faq SYSTEM "faq.docbook"> <!ENTITY konqueror-credits SYSTEM "credits.docbook"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> <!ENTITY % addindex "IGNORE"> ]> -<book lang="&language;" -> +<book lang="&language;"> <bookinfo> -<title ->The &konqueror; Handbook</title> +<title>The &konqueror; Handbook</title> <authorgroup> -<author ->&Pamela.Roberts; &Pamela.Roberts.mail;</author> +<author>&Pamela.Roberts; &Pamela.Roberts.mail;</author> <othercredit role="developer"> -<othername ->The KDE Team</othername> -<contrib ->Developers</contrib> -</othercredit -> - -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<othername>The KDE Team</othername> +<contrib>Developers</contrib> +</othercredit> + +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->2000</year -> <year ->2002</year> -<holder ->Erwan Loisant</holder> -<holder ->Pamela Roberts</holder> +<year>2000</year> <year>2002</year> +<holder>Erwan Loisant</holder> +<holder>Pamela Roberts</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2002-09-22</date> -<releaseinfo ->3.1</releaseinfo> +<date>2002-09-22</date> +<releaseinfo>3.1</releaseinfo> -<abstract -><para ->&konqueror; is &kde;'s advanced File Manager, Web Browser and Universal Viewing Application.</para> +<abstract><para>&konqueror; is &kde;'s advanced File Manager, Web Browser and Universal Viewing Application.</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->Konqueror</keyword> -<keyword ->Kdebase</keyword> -<keyword ->File Manager</keyword> -<keyword ->Browser</keyword> -<keyword ->Viewer</keyword> +<keyword>KDE</keyword> +<keyword>Konqueror</keyword> +<keyword>Kdebase</keyword> +<keyword>File Manager</keyword> +<keyword>Browser</keyword> +<keyword>Viewer</keyword> </keywordset> </bookinfo> @@ -115,28 +78,16 @@ <appendix id="installation"> -<title ->Installation</title> +<title>Installation</title> -<para ->&konqueror; is part of the tdebase package which an essential part of &kde;.</para> +<para>&konqueror; is part of the tdebase package which an essential part of &kde;.</para> -<para ->For instructions on acquiring &kde; please see <ulink url="http://www.kde.org" ->http://www.kde.org</ulink ->.</para> +<para>For instructions on acquiring &kde; please see <ulink url="http://www.kde.org">http://www.kde.org</ulink>.</para> -<para ->For further information about &konqueror; you might like to visit <ulink url="http://www.konqueror.org" ->http://www.konqueror.org</ulink ->.</para> +<para>For further information about &konqueror; you might like to visit <ulink url="http://www.konqueror.org">http://www.konqueror.org</ulink>.</para> -<para ->Conversion to British English: John Knight <email ->anarchist_tomato@herzeleid.net</email -></para -> +<para>Conversion to British English: John Knight <email>anarchist_tomato@herzeleid.net</email></para> </appendix> diff --git a/tde-i18n-en_GB/docs/tdebase/konqueror/introduction.docbook b/tde-i18n-en_GB/docs/tdebase/konqueror/introduction.docbook index 35fe37f780c..503d36e5b8c 100644 --- a/tde-i18n-en_GB/docs/tdebase/konqueror/introduction.docbook +++ b/tde-i18n-en_GB/docs/tdebase/konqueror/introduction.docbook @@ -1,77 +1,22 @@ <chapter id="introduction"> <chapterinfo> <authorgroup> -<author ->&Pamela.Roberts;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Pamela.Roberts;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-20</date -> <releaseinfo ->3.2</releaseinfo -> </chapterinfo> +<date>2003-10-20</date> <releaseinfo>3.2</releaseinfo> </chapterinfo> -<title ->Overview</title> +<title>Overview</title> -<para -><emphasis ->&konqueror;</emphasis -> is an advanced <link linkend="filemanager" ->file manager</link -> for the K Desktop Environment, providing file management functions ranging from simple cut/copy and paste operations to advanced local and remote network file browsing. Folder contents can be displayed in a variety of text and icon <link linkend="viewmode" ->view modes</link ->, which can include thumbnail preview images of file contents. File and folder properties can easily be examined and changed and applications launched with a simple click of the &LMB;.</para> +<para><emphasis>&konqueror;</emphasis> is an advanced <link linkend="filemanager">file manager</link> for the K Desktop Environment, providing file management functions ranging from simple cut/copy and paste operations to advanced local and remote network file browsing. Folder contents can be displayed in a variety of text and icon <link linkend="viewmode">view modes</link>, which can include thumbnail preview images of file contents. File and folder properties can easily be examined and changed and applications launched with a simple click of the &LMB;.</para> -<para -><emphasis ->&konqueror;</emphasis -> is an <acronym ->HTML</acronym -> 4.01 compliant <link linkend="browser" ->web browser</link -> with built in support for JavaScript (ECMA-262), <acronym ->CSS</acronym -> (Cascading Style Sheets) and bidirectional scripts (such as Arabic and Hebrew). It provides support for the secure running of &Java; applets, &Netscape; plugins for viewing &Flash;, &RealAudio; and &RealVideo; and <acronym ->SSL</acronym -> for secure communications. Advanced features include automatic &URL; and form completion, the ability to import bookmarks from other browsers and tabbed browsing. </para> +<para><emphasis>&konqueror;</emphasis> is an <acronym>HTML</acronym> 4.01 compliant <link linkend="browser">web browser</link> with built in support for JavaScript (ECMA-262), <acronym>CSS</acronym> (Cascading Style Sheets) and bidirectional scripts (such as Arabic and Hebrew). It provides support for the secure running of &Java; applets, &Netscape; plugins for viewing &Flash;, &RealAudio; and &RealVideo; and <acronym>SSL</acronym> for secure communications. Advanced features include automatic &URL; and form completion, the ability to import bookmarks from other browsers and tabbed browsing. </para> -<para -><emphasis ->&konqueror;</emphasis -> is also an excellent full featured <link linkend="ftp" ->FTP</link -> client.</para> +<para><emphasis>&konqueror;</emphasis> is also an excellent full featured <link linkend="ftp">FTP</link> client.</para> -<para -><emphasis ->&konqueror;</emphasis -> is a universal viewing application, capable of displaying images and documents without having to launch another application. It does this by embedding components (&kde; Parts) provided by other applications; from &kview; for image viewing, &kdvi; for <acronym ->DVI</acronym -> viewing, &kghostview; for &PostScript; documents and from the various &koffice; applications for their document types. </para> +<para><emphasis>&konqueror;</emphasis> is a universal viewing application, capable of displaying images and documents without having to launch another application. It does this by embedding components (&kde; Parts) provided by other applications; from &kview; for image viewing, &kdvi; for <acronym>DVI</acronym> viewing, &kghostview; for &PostScript; documents and from the various &koffice; applications for their document types. </para> -<para -><emphasis ->&konqueror;</emphasis -> is a fully customisable application which anyone can <link linkend="config" ->configure</link -> to suit their own needs, from changing the overall style and the sizes of text and icons to selecting which items appear in the Menubar, changing the number and positions of the toolbars and even defining new shortcut key combinations. Different configuration <link linkend="save-settings" ->profiles</link -> can be saved for easy recall as needed. </para> +<para><emphasis>&konqueror;</emphasis> is a fully customisable application which anyone can <link linkend="config">configure</link> to suit their own needs, from changing the overall style and the sizes of text and icons to selecting which items appear in the Menubar, changing the number and positions of the toolbars and even defining new shortcut key combinations. Different configuration <link linkend="save-settings">profiles</link> can be saved for easy recall as needed. </para> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/konqueror/path-complete.docbook b/tde-i18n-en_GB/docs/tdebase/konqueror/path-complete.docbook index 7d2bd6da42b..cbc4ad5ea27 100644 --- a/tde-i18n-en_GB/docs/tdebase/konqueror/path-complete.docbook +++ b/tde-i18n-en_GB/docs/tdebase/konqueror/path-complete.docbook @@ -2,125 +2,45 @@ <chapterinfo> <authorgroup> -<author ->&Pamela.Roberts;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> -</authorgroup -> <date ->2003-11-05</date -> <releaseinfo ->3.2</releaseinfo -> </chapterinfo> +<author>&Pamela.Roberts;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> +</authorgroup> <date>2003-11-05</date> <releaseinfo>3.2</releaseinfo> </chapterinfo> -<title ->Automatic Text Completion</title -> +<title>Automatic Text Completion</title> -<para ->You can get &konqueror; to help you enter a path or &URL; into the Location Toolbar by enabling one of the <guimenuitem ->Text Completion</guimenuitem -> features. To do this <mousebutton ->right</mousebutton -> click on a clear part of the Location Toolbar text entry box and select <guisubmenu ->Text Completion</guisubmenu -> from the pop up menu. This will let you choose between the following options:</para> +<para>You can get &konqueror; to help you enter a path or &URL; into the Location Toolbar by enabling one of the <guimenuitem>Text Completion</guimenuitem> features. To do this <mousebutton>right</mousebutton> click on a clear part of the Location Toolbar text entry box and select <guisubmenu>Text Completion</guisubmenu> from the pop up menu. This will let you choose between the following options:</para> <variablelist> <varlistentry> -<term -><guimenuitem ->None</guimenuitem -></term> -<listitem -><para ->What you get is what you type.</para -></listitem> +<term><guimenuitem>None</guimenuitem></term> +<listitem><para>What you get is what you type.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Manual</guimenuitem -></term> -<listitem -><para ->When you have typed part of a path or &URL;, pressing <keycombo action="simul" ->&Ctrl;<keycap ->E</keycap -></keycombo -> will complete the entry if it is possible to do so unambiguously.</para -></listitem -> +<term><guimenuitem>Manual</guimenuitem></term> +<listitem><para>When you have typed part of a path or &URL;, pressing <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> will complete the entry if it is possible to do so unambiguously.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Automatic</guimenuitem -></term> -<listitem -><para ->As you type into the Location Toolbar window &konqueror; will automatically extend what you type to complete one possible path or &URL;, highlighting the characters it has added. Continue typing if that is not what you wanted or press &Enter; to accept it.</para -></listitem> +<term><guimenuitem>Automatic</guimenuitem></term> +<listitem><para>As you type into the Location Toolbar window &konqueror; will automatically extend what you type to complete one possible path or &URL;, highlighting the characters it has added. Continue typing if that is not what you wanted or press &Enter; to accept it.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Dropdown List</guimenuitem -></term> -<listitem -><para ->A drop-down window will appear as you type, showing the possible matches to what you have typed so far. When the path or &URL; that you want appears in the window double click on it with the &LMB;. You can also use the <keysym ->Down Arrow</keysym -> and <keysym ->Up Arrow</keysym -> keys to select it then press &Enter;.</para -></listitem> +<term><guimenuitem>Dropdown List</guimenuitem></term> +<listitem><para>A drop-down window will appear as you type, showing the possible matches to what you have typed so far. When the path or &URL; that you want appears in the window double click on it with the &LMB;. You can also use the <keysym>Down Arrow</keysym> and <keysym>Up Arrow</keysym> keys to select it then press &Enter;.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Short Automatic</guimenuitem -></term> -<listitem -><para ->This is like Automatic mode except that it only extends what you have typed as far as the next <keycap ->/</keycap -> symbol in the path or &URL;. Press <keycombo action="simul" ->&Ctrl;<keycap ->E</keycap -></keycombo -> to accept the suggestion, &Enter; when the complete path or &URL; is shown.</para -></listitem> +<term><guimenuitem>Short Automatic</guimenuitem></term> +<listitem><para>This is like Automatic mode except that it only extends what you have typed as far as the next <keycap>/</keycap> symbol in the path or &URL;. Press <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> to accept the suggestion, &Enter; when the complete path or &URL; is shown.</para></listitem> </varlistentry> </variablelist> -<para ->You should try out these different modes and pick the one that suits you best.</para> -<para ->The history of recently visited &URL;s that &konqueror; uses for the Text Completion function can be viewed and edited in the <guilabel ->History </guilabel -> page of the <link linkend="sidebar" ->Navigation Panel</link ->.</para> +<para>You should try out these different modes and pick the one that suits you best.</para> +<para>The history of recently visited &URL;s that &konqueror; uses for the Text Completion function can be viewed and edited in the <guilabel>History </guilabel> page of the <link linkend="sidebar">Navigation Panel</link>.</para> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/konqueror/plugins.docbook b/tde-i18n-en_GB/docs/tdebase/konqueror/plugins.docbook index abf027f72b7..2ad71f8a8c0 100644 --- a/tde-i18n-en_GB/docs/tdebase/konqueror/plugins.docbook +++ b/tde-i18n-en_GB/docs/tdebase/konqueror/plugins.docbook @@ -2,265 +2,86 @@ <chapterinfo> <authorgroup> -<author ->&Pamela.Roberts;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Pamela.Roberts;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-09-22</date -> <releaseinfo ->3.1</releaseinfo -> </chapterinfo> +<date>2002-09-22</date> <releaseinfo>3.1</releaseinfo> </chapterinfo> -<title ->Plugins</title> +<title>Plugins</title> <sect1 id="netscape-plugin"> -<title ->&Netscape; Plugins</title> +<title>&Netscape; Plugins</title> -<para ->Currently, &konqueror; supports &Netscape; 4.x plugins.</para> +<para>Currently, &konqueror; supports &Netscape; 4.x plugins.</para> -<para ->Selecting <menuchoice -><guimenu ->Settings</guimenu -><guisubmenu -> Configure Konqueror...</guisubmenu -><guimenuitem ->Plugins</guimenuitem -> </menuchoice -> will give you a dialogue box with two tabbed pages; <guilabel ->Scan</guilabel -> and <guilabel ->Plugins</guilabel ->.</para> +<para>Selecting <menuchoice><guimenu>Settings</guimenu><guisubmenu> Configure Konqueror...</guisubmenu><guimenuitem>Plugins</guimenuitem> </menuchoice> will give you a dialogue box with two tabbed pages; <guilabel>Scan</guilabel> and <guilabel>Plugins</guilabel>.</para> -<para ->The <guilabel ->Scan</guilabel -> page controls how &kde; scans for new &Netscape; plugins, either manually by pressing the <guibutton ->Scan for New Plugins</guibutton -> button or automatically each time &kde; starts up.</para> +<para>The <guilabel>Scan</guilabel> page controls how &kde; scans for new &Netscape; plugins, either manually by pressing the <guibutton>Scan for New Plugins</guibutton> button or automatically each time &kde; starts up.</para> -<para ->The scan is done by looking through the folders listed in the <guilabel ->Scan Folders</guilabel -> list for <literal role="extension" ->.so</literal -> files containing plugin code. It examines every such file to find out which <acronym ->MIME</acronym -> types the plugin supports. It then creates <acronym ->MIME</acronym -> type definitions for &kde; in the user's <filename class="directory" -> ~/.trinity/share/mimelnk</filename -> folder to make other applications aware of them.</para> +<para>The scan is done by looking through the folders listed in the <guilabel>Scan Folders</guilabel> list for <literal role="extension">.so</literal> files containing plugin code. It examines every such file to find out which <acronym>MIME</acronym> types the plugin supports. It then creates <acronym>MIME</acronym> type definitions for &kde; in the user's <filename class="directory"> ~/.trinity/share/mimelnk</filename> folder to make other applications aware of them.</para> -<para ->The <guilabel ->Plugins</guilabel -> page shows you the &Netscape; plugins that &kde; has found, and for each plugin it lists the <acronym ->MIME</acronym -> types and the filename suffixes it uses to recognise them.</para> +<para>The <guilabel>Plugins</guilabel> page shows you the &Netscape; plugins that &kde; has found, and for each plugin it lists the <acronym>MIME</acronym> types and the filename suffixes it uses to recognise them.</para> -<para ->The dialogue box also contains a checkbox <guilabel -> Enable plugins globally</guilabel -> which you can use to enable or disable plugins that can be contained in <acronym ->HTML</acronym -> pages (these can be considered a security risk).</para> +<para>The dialogue box also contains a checkbox <guilabel> Enable plugins globally</guilabel> which you can use to enable or disable plugins that can be contained in <acronym>HTML</acronym> pages (these can be considered a security risk).</para> </sect1> <sect1 id="konq-plugin"> -<title ->&konqueror; Plugins</title> +<title>&konqueror; Plugins</title> -<para ->The package tdeaddons contains several useful plugins that interact with &konqueror; in various ways. These are explained briefly below, more detailed information may be obtained by looking through the <guimenuitem ->Konqueror Plugins</guimenuitem -> section in the &kde; Help Centre.</para> +<para>The package tdeaddons contains several useful plugins that interact with &konqueror; in various ways. These are explained briefly below, more detailed information may be obtained by looking through the <guimenuitem>Konqueror Plugins</guimenuitem> section in the &kde; Help Centre.</para> <variablelist> <varlistentry> -<term ->Web Page Translation</term> -<listitem -><para ->This uses AltaVista's BabelFish site to translate the current <acronym ->HTML</acronym -> page to whatever language you want (within reason). It can be launched with <menuchoice -><guimenu ->Tools</guimenu -><guisubmenu ->Translate Web Page</guisubmenu -></menuchoice ->.</para -></listitem> +<term>Web Page Translation</term> +<listitem><para>This uses AltaVista's BabelFish site to translate the current <acronym>HTML</acronym> page to whatever language you want (within reason). It can be launched with <menuchoice><guimenu>Tools</guimenu><guisubmenu>Translate Web Page</guisubmenu></menuchoice>.</para></listitem> </varlistentry> <varlistentry> -<term ->Folder View Filter</term> -<listitem -><para ->This is controlled by <menuchoice -><guimenu ->Tools</guimenu -><guisubmenu ->View Filter</guisubmenu -></menuchoice -> and allows you to choose which types of item are displayed in a folder.</para -></listitem> +<term>Folder View Filter</term> +<listitem><para>This is controlled by <menuchoice><guimenu>Tools</guimenu><guisubmenu>View Filter</guisubmenu></menuchoice> and allows you to choose which types of item are displayed in a folder.</para></listitem> </varlistentry> <varlistentry> -<term ->DOM Tree Viewer</term> -<listitem -><para ->Selecting <menuchoice -><guimenu ->Tools</guimenu -><guisubmenu ->Show DOM Tree</guisubmenu -></menuchoice -> opens a new window which displays the document object model (DOM) of the current <acronym ->HTML</acronym -> page.</para -></listitem> +<term>DOM Tree Viewer</term> +<listitem><para>Selecting <menuchoice><guimenu>Tools</guimenu><guisubmenu>Show DOM Tree</guisubmenu></menuchoice> opens a new window which displays the document object model (DOM) of the current <acronym>HTML</acronym> page.</para></listitem> </varlistentry> <varlistentry> -<term ->HTML Validator</term> -<listitem -><para ->This is started with <menuchoice -><guimenu ->Tools</guimenu -><guisubmenu ->Validate Web Page</guisubmenu -><guimenuitem ->Validate HTML</guimenuitem -></menuchoice ->. It uses the W3C HTML validator to validate the current page, very useful when creating web pages.</para -></listitem> +<term>HTML Validator</term> +<listitem><para>This is started with <menuchoice><guimenu>Tools</guimenu><guisubmenu>Validate Web Page</guisubmenu><guimenuitem>Validate HTML</guimenuitem></menuchoice>. It uses the W3C HTML validator to validate the current page, very useful when creating web pages.</para></listitem> </varlistentry> <varlistentry> -<term ->CSS Validator</term> -<listitem -><para ->Started with <menuchoice -><guimenu ->Tools</guimenu -><guisubmenu ->Validate Web Page</guisubmenu -><guimenuitem ->Validate CSS</guimenuitem -></menuchoice ->, it uses the W3C CSS validator to validate the current page's Cascading Style Sheets.</para -></listitem> +<term>CSS Validator</term> +<listitem><para>Started with <menuchoice><guimenu>Tools</guimenu><guisubmenu>Validate Web Page</guisubmenu><guimenuitem>Validate CSS</guimenuitem></menuchoice>, it uses the W3C CSS validator to validate the current page's Cascading Style Sheets.</para></listitem> </varlistentry> <varlistentry> -<term ->HTML Settings</term> -<listitem -><para ->Select <menuchoice -><guimenu ->Tools</guimenu -><guisubmenu ->HTML Settings</guisubmenu -></menuchoice -> to enable or disable a number of HTML settings without going through the <guimenu ->Settings</guimenu -> dialogue. </para -></listitem> +<term>HTML Settings</term> +<listitem><para>Select <menuchoice><guimenu>Tools</guimenu><guisubmenu>HTML Settings</guisubmenu></menuchoice> to enable or disable a number of HTML settings without going through the <guimenu>Settings</guimenu> dialogue. </para></listitem> </varlistentry> <varlistentry> -<term ->Image Gallery</term> -<listitem -><para ->In File Manager mode, you can select <menuchoice -><guimenu ->Tools</guimenu -><guisubmenu ->Create Image Gallery</guisubmenu -></menuchoice -> to create an HTML page with thumbnails of all the images in the current folder. By default the HTML page is called <filename ->images.html</filename -> and the thumbnails are put into a new <filename ->thumbs</filename -> folder. </para -></listitem> +<term>Image Gallery</term> +<listitem><para>In File Manager mode, you can select <menuchoice><guimenu>Tools</guimenu><guisubmenu>Create Image Gallery</guisubmenu></menuchoice> to create an HTML page with thumbnails of all the images in the current folder. By default the HTML page is called <filename>images.html</filename> and the thumbnails are put into a new <filename>thumbs</filename> folder. </para></listitem> </varlistentry> <varlistentry> -<term ->User Agent Changer</term> -<listitem -><para ->Select <menuchoice -><guimenu ->Tools</guimenu -><guisubmenu ->Change Browser Identification</guisubmenu -></menuchoice -> to get a menu that allows you to change the User Agent string without going through the <guimenu ->Settings </guimenu -> dialogue procedure. </para -></listitem> +<term>User Agent Changer</term> +<listitem><para>Select <menuchoice><guimenu>Tools</guimenu><guisubmenu>Change Browser Identification</guisubmenu></menuchoice> to get a menu that allows you to change the User Agent string without going through the <guimenu>Settings </guimenu> dialogue procedure. </para></listitem> </varlistentry> <varlistentry> -<term ->Archive Web Page</term> -<listitem -><para ->Invoked with <menuchoice -><guimenu ->Tools</guimenu -><guisubmenu -> Archive Web Page</guisubmenu -></menuchoice ->, this tool creates an archive (<literal role="extension" ->.war</literal -> ) file containing the web page being viewed including the images. <mousebutton ->Left</mousebutton -> click on the archive file name to view the saved page. </para -></listitem> +<term>Archive Web Page</term> +<listitem><para>Invoked with <menuchoice><guimenu>Tools</guimenu><guisubmenu> Archive Web Page</guisubmenu></menuchoice>, this tool creates an archive (<literal role="extension">.war</literal> ) file containing the web page being viewed including the images. <mousebutton>Left</mousebutton> click on the archive file name to view the saved page. </para></listitem> </varlistentry> <varlistentry> -<term ->Navigation Panel Media Player</term> -<listitem -><para ->This is a simple media player, embedded as a tab page in the Navigation Panel. You can drag songs or videos onto this page to play them. </para -></listitem> +<term>Navigation Panel Media Player</term> +<listitem><para>This is a simple media player, embedded as a tab page in the Navigation Panel. You can drag songs or videos onto this page to play them. </para></listitem> </varlistentry> </variablelist> diff --git a/tde-i18n-en_GB/docs/tdebase/konqueror/save-settings.docbook b/tde-i18n-en_GB/docs/tdebase/konqueror/save-settings.docbook index 75cee3aa13d..e16730b4ad2 100644 --- a/tde-i18n-en_GB/docs/tdebase/konqueror/save-settings.docbook +++ b/tde-i18n-en_GB/docs/tdebase/konqueror/save-settings.docbook @@ -2,153 +2,27 @@ <chapterinfo> <authorgroup> -<author ->&Pamela.Roberts;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Pamela.Roberts;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-11-06</date -> <releaseinfo ->3.2</releaseinfo -> </chapterinfo> +<date>2003-11-06</date> <releaseinfo>3.2</releaseinfo> </chapterinfo> -<title ->Saving Settings & Profiles</title> +<title>Saving Settings & Profiles</title> <sect1 id="save-settings-general"> -<title ->General Settings</title> -<para ->When you close down &konqueror; your current <guimenu ->View</guimenu -> menu settings (such as the <guimenuitem ->View Mode</guimenuitem ->, <guimenuitem ->Use index.html</guimenuitem -> and <guimenuitem ->Show Hidden Files </guimenuitem -> items) are automatically saved as the default options to be used next time &konqueror; is started.</para> +<title>General Settings</title> +<para>When you close down &konqueror; your current <guimenu>View</guimenu> menu settings (such as the <guimenuitem>View Mode</guimenuitem>, <guimenuitem>Use index.html</guimenuitem> and <guimenuitem>Show Hidden Files </guimenuitem> items) are automatically saved as the default options to be used next time &konqueror; is started.</para> -<para ->But you can also specify different <guimenu ->View</guimenu -> menu settings for an individual folder. To do this check the <guimenuitem ->View Properties Saved in Folder</guimenuitem -> box in the <guimenu ->Settings</guimenu -> menu, change the <guimenu ->View</guimenu -> settings to whatever you want then uncheck the <guimenuitem ->View Properties saved in Folder</guimenuitem -> box. Doing this creates a <filename ->.directory</filename -> file in that folder to hold the folder <guimenu ->View</guimenu -> settings. Use the <menuchoice -><guimenu -> Settings</guimenu -><guimenuitem ->Remove Folder Properties</guimenuitem -> </menuchoice -> option to remove the folder specific settings (or just delete the <filename ->.directory</filename -> file).</para> -<note -><para ->One nice use of this feature is if you have a folder full of pictures. You can set that particular folder to display thumbnails of the pictures (by choosing <guimenuitem ->Icon View</guimenuitem -> and <menuchoice -> <guisubmenu ->Preview</guisubmenu -><guimenuitem ->Show Previews</guimenuitem -> </menuchoice -> from the <guimenu ->View</guimenu -> menu) when you open it, while not displaying images as thumbnails in other folders.</para -></note> +<para>But you can also specify different <guimenu>View</guimenu> menu settings for an individual folder. To do this check the <guimenuitem>View Properties Saved in Folder</guimenuitem> box in the <guimenu>Settings</guimenu> menu, change the <guimenu>View</guimenu> settings to whatever you want then uncheck the <guimenuitem>View Properties saved in Folder</guimenuitem> box. Doing this creates a <filename>.directory</filename> file in that folder to hold the folder <guimenu>View</guimenu> settings. Use the <menuchoice><guimenu> Settings</guimenu><guimenuitem>Remove Folder Properties</guimenuitem> </menuchoice> option to remove the folder specific settings (or just delete the <filename>.directory</filename> file).</para> +<note><para>One nice use of this feature is if you have a folder full of pictures. You can set that particular folder to display thumbnails of the pictures (by choosing <guimenuitem>Icon View</guimenuitem> and <menuchoice> <guisubmenu>Preview</guisubmenu><guimenuitem>Show Previews</guimenuitem> </menuchoice> from the <guimenu>View</guimenu> menu) when you open it, while not displaying images as thumbnails in other folders.</para></note> </sect1> <sect1 id="save-settings-view-profiles"> -<title ->View Profiles</title> -<para ->&konqueror; can save a whole set of options as a <quote ->View Profile</quote ->. Some view profiles are part of the standard &konqueror; installation, such as <property ->Web Browsing</property -> and <property ->File Management</property ->, but you can add your own, too.</para> +<title>View Profiles</title> +<para>&konqueror; can save a whole set of options as a <quote>View Profile</quote>. Some view profiles are part of the standard &konqueror; installation, such as <property>Web Browsing</property> and <property>File Management</property>, but you can add your own, too.</para> -<para ->To modify a view profile (say, the <property ->Web Browsing</property -> profile), load the profile with <menuchoice -><guimenu ->Settings</guimenu -><guisubmenu ->Load View Profile</guisubmenu -><guimenuitem ->Web Browsing</guimenuitem -> </menuchoice ->, and change the &konqueror; settings to whatever you want. Now select <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Save View Profile "Web Browsing"...</guimenuitem -></menuchoice ->. In the dialogue which appears, you can change the name of the profile, which will create a new profile with that name, or you can leave the name as it is to modify the current profile. If you select <guilabel ->Save URLs in profile</guilabel ->, the current &URL; will be loaded when you load that view profile. This functions in a similar way to the <quote ->Home Page</quote -> in many web browsers. If you want &konqueror; to start up with an empty window enter <userinput ->about:blank</userinput -> into the location bar before saving the profile.</para> +<para>To modify a view profile (say, the <property>Web Browsing</property> profile), load the profile with <menuchoice><guimenu>Settings</guimenu><guisubmenu>Load View Profile</guisubmenu><guimenuitem>Web Browsing</guimenuitem> </menuchoice>, and change the &konqueror; settings to whatever you want. Now select <menuchoice><guimenu>Settings</guimenu><guimenuitem>Save View Profile "Web Browsing"...</guimenuitem></menuchoice>. In the dialogue which appears, you can change the name of the profile, which will create a new profile with that name, or you can leave the name as it is to modify the current profile. If you select <guilabel>Save URLs in profile</guilabel>, the current &URL; will be loaded when you load that view profile. This functions in a similar way to the <quote>Home Page</quote> in many web browsers. If you want &konqueror; to start up with an empty window enter <userinput>about:blank</userinput> into the location bar before saving the profile.</para> -<note -><para ->You can create a desktop icon to start &konqueror; with your new profile. First create a desktop icon by dragging the &konqueror; icon from the <guimenu ->K</guimenu -> menu onto the desktop and selecting <guimenuitem ->Copy Here</guimenuitem ->. Then <mousebutton ->right</mousebutton -> click on the new icon, select <guimenuitem ->Properties...</guimenuitem -> and change <guilabel ->Program Name</guilabel -> in the <guilabel ->Execute</guilabel -> tab page to <userinput -><command ->kfmclient</command -> <option ->openProfile <replaceable ->MyNewProfile</replaceable -></option -></userinput ->, <replaceable ->MyNewProfile</replaceable -> being what you called the new profile. Then in the <guilabel ->General</guilabel -> tab page change the name to something like <filename ->MyNewProfile</filename -> and pick a more suitable icon.</para -></note> +<note><para>You can create a desktop icon to start &konqueror; with your new profile. First create a desktop icon by dragging the &konqueror; icon from the <guimenu>K</guimenu> menu onto the desktop and selecting <guimenuitem>Copy Here</guimenuitem>. Then <mousebutton>right</mousebutton> click on the new icon, select <guimenuitem>Properties...</guimenuitem> and change <guilabel>Program Name</guilabel> in the <guilabel>Execute</guilabel> tab page to <userinput><command>kfmclient</command> <option>openProfile <replaceable>MyNewProfile</replaceable></option></userinput>, <replaceable>MyNewProfile</replaceable> being what you called the new profile. Then in the <guilabel>General</guilabel> tab page change the name to something like <filename>MyNewProfile</filename> and pick a more suitable icon.</para></note> </sect1> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/konqueror/sidebar.docbook b/tde-i18n-en_GB/docs/tdebase/konqueror/sidebar.docbook index 1bc3cf4e8dd..351ca096f33 100644 --- a/tde-i18n-en_GB/docs/tdebase/konqueror/sidebar.docbook +++ b/tde-i18n-en_GB/docs/tdebase/konqueror/sidebar.docbook @@ -2,315 +2,113 @@ <chapterinfo> <authorgroup> -<author ->&Pamela.Roberts;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Pamela.Roberts;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-09-22</date -> <releaseinfo ->3.1</releaseinfo -> </chapterinfo> +<date>2002-09-22</date> <releaseinfo>3.1</releaseinfo> </chapterinfo> -<title ->The Navigation Panel</title> +<title>The Navigation Panel</title> -<para ->The Navigation Panel appears as a separate view at the left of &konqueror;'s window. It can be invoked with <menuchoice -><guimenu ->Window </guimenu -><guimenuitem ->Show Navigation Panel</guimenuitem -></menuchoice -> or toggled on and off with the <keycap ->F9</keycap -> key.</para> +<para>The Navigation Panel appears as a separate view at the left of &konqueror;'s window. It can be invoked with <menuchoice><guimenu>Window </guimenu><guimenuitem>Show Navigation Panel</guimenuitem></menuchoice> or toggled on and off with the <keycap>F9</keycap> key.</para> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="dirtree.png"/></imageobject> +<imageobject><imagedata format="PNG" fileref="dirtree.png"/></imageobject> <textobject> -<phrase ->With the Navigation Panel</phrase -> +<phrase>With the Navigation Panel</phrase> </textobject> </mediaobject> -<para ->It contains a number of tabbed pages; <mousebutton ->left</mousebutton -> click on a tab's icon to view that page. <mousebutton ->Left</mousebutton -> clicking on the icon for the visible page will collapse the Navigation Panel so that only the tab icons are visible.</para> +<para>It contains a number of tabbed pages; <mousebutton>left</mousebutton> click on a tab's icon to view that page. <mousebutton>Left</mousebutton> clicking on the icon for the visible page will collapse the Navigation Panel so that only the tab icons are visible.</para> <variablelist> <varlistentry> -<term -><guilabel ->Bookmarks</guilabel -></term> -<listitem -><para ->This page shows a tree view of your Bookmarks. <mousebutton -> Left</mousebutton -> click on an item to open it in the main view.</para> +<term><guilabel>Bookmarks</guilabel></term> +<listitem><para>This page shows a tree view of your Bookmarks. <mousebutton> Left</mousebutton> click on an item to open it in the main view.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->History</guilabel -></term> -<listitem -><para ->This page shows a tree view of your browsing History. <mousebutton ->Left</mousebutton -> clicking on an item will open it in the main view, or you can open it in a new &konqueror; window by <mousebutton ->right </mousebutton -> clicking and selecting <guimenuitem ->New Window</guimenuitem -> from the pop up menu.</para> -<para ->You can remove an item from the history by <mousebutton ->right </mousebutton -> clicking on it and selecting <guimenuitem ->Remove Entry </guimenuitem ->. Selecting <guimenuitem ->Clear History...</guimenuitem -> will clear out the entire history.</para> -<para ->The pop up menu you get when you <mousebutton ->right</mousebutton -> click on any entry in the History page also gives you the option of choosing whether the entire history is sorted by name or by date.</para> -<para ->Selecting <guimenuitem ->Preferences...</guimenuitem -> from this pop up menu brings up the <guilabel ->History Sidebar</guilabel -> control module. This can be used to set the maximum size of your history and set a time after which items are automatically removed. You can also set different fonts for new and old &URL;s. The <guilabel ->Detailed tooltips</guilabel -> checkbox controls how much information is displayed when you hover the mouse pointer over an item in the history page.</para -></listitem> +<term><guilabel>History</guilabel></term> +<listitem><para>This page shows a tree view of your browsing History. <mousebutton>Left</mousebutton> clicking on an item will open it in the main view, or you can open it in a new &konqueror; window by <mousebutton>right </mousebutton> clicking and selecting <guimenuitem>New Window</guimenuitem> from the pop up menu.</para> +<para>You can remove an item from the history by <mousebutton>right </mousebutton> clicking on it and selecting <guimenuitem>Remove Entry </guimenuitem>. Selecting <guimenuitem>Clear History...</guimenuitem> will clear out the entire history.</para> +<para>The pop up menu you get when you <mousebutton>right</mousebutton> click on any entry in the History page also gives you the option of choosing whether the entire history is sorted by name or by date.</para> +<para>Selecting <guimenuitem>Preferences...</guimenuitem> from this pop up menu brings up the <guilabel>History Sidebar</guilabel> control module. This can be used to set the maximum size of your history and set a time after which items are automatically removed. You can also set different fonts for new and old &URL;s. The <guilabel>Detailed tooltips</guilabel> checkbox controls how much information is displayed when you hover the mouse pointer over an item in the history page.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Home Folder</guilabel -></term> -<listitem -><para ->This page shows a tree view of the subfolders your home folder. Note that <quote ->hidden</quote -> folders (those with names beginning with a dot) are not shown. <mousebutton ->Left</mousebutton -> click on an item to open it in the main view, or <mousebutton ->right</mousebutton -> click to display a pop up menu allowing you to open the subfolder in a new window or as a new tab page of the main view. </para -></listitem> +<term><guilabel>Home Folder</guilabel></term> +<listitem><para>This page shows a tree view of the subfolders your home folder. Note that <quote>hidden</quote> folders (those with names beginning with a dot) are not shown. <mousebutton>Left</mousebutton> click on an item to open it in the main view, or <mousebutton>right</mousebutton> click to display a pop up menu allowing you to open the subfolder in a new window or as a new tab page of the main view. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Network</guilabel -></term> -<listitem -><para ->This page is intended to show a tree view of your important network connections, although local folders can also be included. Again, you can <mousebutton ->left</mousebutton -> click on an item to open it in the main view or <mousebutton ->right</mousebutton -> click to bring up a menu with a wider range of possibilities.</para> -<para ->The folders shown in the <guilabel ->Network</guilabel -> page are held in the folder <filename class="directory" -> ~/.trinity/share/apps/konqsidebartng/virtual_folders/remote/</filename ->, and you can make new ones just as you would make any other subfolder. The items within these folders are held as <literal role="extension" ->.desktop</literal -> files and can be created with &konqueror;'s <menuchoice -><guisubmenu ->Create New</guisubmenu -> <guimenuitem ->Link to Location (URL)...</guimenuitem -></menuchoice -> option.</para> +<term><guilabel>Network</guilabel></term> +<listitem><para>This page is intended to show a tree view of your important network connections, although local folders can also be included. Again, you can <mousebutton>left</mousebutton> click on an item to open it in the main view or <mousebutton>right</mousebutton> click to bring up a menu with a wider range of possibilities.</para> +<para>The folders shown in the <guilabel>Network</guilabel> page are held in the folder <filename class="directory"> ~/.trinity/share/apps/konqsidebartng/virtual_folders/remote/</filename>, and you can make new ones just as you would make any other subfolder. The items within these folders are held as <literal role="extension">.desktop</literal> files and can be created with &konqueror;'s <menuchoice><guisubmenu>Create New</guisubmenu> <guimenuitem>Link to Location (URL)...</guimenuitem></menuchoice> option.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Root Folder</guilabel -></term> -<listitem -><para ->The Root Folder tree has the path <filename class="directory" ->/</filename ->, and is the base folder of your system's local files. If you expand the <quote ->Root</quote -> folder you will find another folder called <filename class="directory" ->root</filename ->. This belongs to the system administrator or Super User and is her home folder. You will also find a folder called <filename class="directory" ->home</filename ->, in which you should be able to find your own <quote ->Home</quote -> folder again.</para> +<term><guilabel>Root Folder</guilabel></term> +<listitem><para>The Root Folder tree has the path <filename class="directory">/</filename>, and is the base folder of your system's local files. If you expand the <quote>Root</quote> folder you will find another folder called <filename class="directory">root</filename>. This belongs to the system administrator or Super User and is her home folder. You will also find a folder called <filename class="directory">home</filename>, in which you should be able to find your own <quote>Home</quote> folder again.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Services</guilabel -></term> -<listitem -><para ->This page provides quick access to the following services: </para> -<para ->The <guilabel ->Audio CD Browser</guilabel ->.</para> -<para -><guilabel ->Devices</guilabel ->. This shows your hard disc partitions, floppy and &CD-ROM;. <mousebutton ->Left</mousebutton -> click on a device or partition name to mount it and display its contents in the main view. A mounted device or partition can be unmounted by <mousebutton ->right </mousebutton -> clicking on the device name and selecting <guimenuitem ->Unmount </guimenuitem -> from the pop up menu. </para> -<para ->The <guilabel ->LAN Browser</guilabel -> allows you to browse other machines connected to your Local Area Network.</para> -<para ->The <guilabel ->Print System Browser</guilabel -> tree gives you quick access to &kde;'s print manager <application ->Kprinter</application ->.</para> +<term><guilabel>Services</guilabel></term> +<listitem><para>This page provides quick access to the following services: </para> +<para>The <guilabel>Audio CD Browser</guilabel>.</para> +<para><guilabel>Devices</guilabel>. This shows your hard disc partitions, floppy and &CD-ROM;. <mousebutton>Left</mousebutton> click on a device or partition name to mount it and display its contents in the main view. A mounted device or partition can be unmounted by <mousebutton>right </mousebutton> clicking on the device name and selecting <guimenuitem>Unmount </guimenuitem> from the pop up menu. </para> +<para>The <guilabel>LAN Browser</guilabel> allows you to browse other machines connected to your Local Area Network.</para> +<para>The <guilabel>Print System Browser</guilabel> tree gives you quick access to &kde;'s print manager <application>Kprinter</application>.</para> </listitem> </varlistentry> </variablelist> -<para ->The Navigation Panel configuration can be changed by <mousebutton ->right </mousebutton -> clicking on the empty area below the bottom tab icon or by <mousebutton ->left</mousebutton -> clicking on the <guilabel ->Configuration Button</guilabel -> icon (the top icon in the previous screenshot, it may not be present in your setup). Doing this brings up a menu with the following options:</para> +<para>The Navigation Panel configuration can be changed by <mousebutton>right </mousebutton> clicking on the empty area below the bottom tab icon or by <mousebutton>left</mousebutton> clicking on the <guilabel>Configuration Button</guilabel> icon (the top icon in the previous screenshot, it may not be present in your setup). Doing this brings up a menu with the following options:</para> <variablelist> <varlistentry> -<term -><guisubmenu ->Add New</guisubmenu -></term> -<listitem -><para ->This option lets you add a new tab page to the Navigation Panel. The new page can contain the <guimenuitem ->Sidebar Media Player </guimenuitem -> (a <link linkend="konq-plugin" ->&konqueror; Plugin</link -> feature) or a new <guimenuitem ->Folder</guimenuitem -> tree view.</para> +<term><guisubmenu>Add New</guisubmenu></term> +<listitem><para>This option lets you add a new tab page to the Navigation Panel. The new page can contain the <guimenuitem>Sidebar Media Player </guimenuitem> (a <link linkend="konq-plugin">&konqueror; Plugin</link> feature) or a new <guimenuitem>Folder</guimenuitem> tree view.</para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Multiple Views</guimenuitem -></term> -<listitem -><para ->Selecting this option splits the Navigation Panel so that two tab pages can be seen at once.</para> +<term><guimenuitem>Multiple Views</guimenuitem></term> +<listitem><para>Selecting this option splits the Navigation Panel so that two tab pages can be seen at once.</para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Show Tabs Left</guimenuitem -></term> -<listitem -><para ->This option lets you choose whether the tab icons are shown at the left or right of the Navigation Panel.</para> +<term><guimenuitem>Show Tabs Left</guimenuitem></term> +<listitem><para>This option lets you choose whether the tab icons are shown at the left or right of the Navigation Panel.</para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Show Configuration Button</guimenuitem -></term> -<listitem -><para ->Use this option to show or hide the <guilabel ->Configuration Button</guilabel -> icon.</para> +<term><guimenuitem>Show Configuration Button</guimenuitem></term> +<listitem><para>Use this option to show or hide the <guilabel>Configuration Button</guilabel> icon.</para> </listitem> </varlistentry> </variablelist> -<para -><mousebutton ->Right</mousebutton -> clicking on a tab icon brings up a menu with the following options:</para> +<para><mousebutton>Right</mousebutton> clicking on a tab icon brings up a menu with the following options:</para> <variablelist> <varlistentry> -<term -><guimenuitem ->Set URL</guimenuitem -></term> -<listitem -><para ->Only available for folder pages, this option lets you change the &URL; (path) of the folder viewed in that page.</para -></listitem> +<term><guimenuitem>Set URL</guimenuitem></term> +<listitem><para>Only available for folder pages, this option lets you change the &URL; (path) of the folder viewed in that page.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Set Icon</guimenuitem -></term> -<listitem -><para ->To change the tab icon.</para -></listitem> +<term><guimenuitem>Set Icon</guimenuitem></term> +<listitem><para>To change the tab icon.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Remove</guimenuitem -></term> -<listitem -><para ->To remove the tab page from the Navigation Panel.</para> +<term><guimenuitem>Remove</guimenuitem></term> +<listitem><para>To remove the tab page from the Navigation Panel.</para> </listitem> </varlistentry> diff --git a/tde-i18n-en_GB/docs/tdebase/konsole/index.docbook b/tde-i18n-en_GB/docs/tdebase/konsole/index.docbook index a29b1a8b4cd..07e3f0ec371 100644 --- a/tde-i18n-en_GB/docs/tdebase/konsole/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/konsole/index.docbook @@ -10,512 +10,177 @@ <book lang="&language;"> <bookinfo> -<title ->The &konsole; Handbook</title> +<title>The &konsole; Handbook</title> <authorgroup> -<author ->&Jonathan.Singer; &Jonathan.Singer.mail;</author> - -<othercredit role="developer" ->&Waldo.Bastian; &Waldo.Bastian.mail; </othercredit> - -<othercredit role="reviewer" ->&Mike.McBride; &Mike.McBride.mail; </othercredit> - -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Jonathan.Singer; &Jonathan.Singer.mail;</author> + +<othercredit role="developer">&Waldo.Bastian; &Waldo.Bastian.mail; </othercredit> + +<othercredit role="reviewer">&Mike.McBride; &Mike.McBride.mail; </othercredit> + +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->2000</year -><year ->2001</year -><year ->2002</year> -<holder ->&Jonathan.Singer;</holder> +<year>2000</year><year>2001</year><year>2002</year> +<holder>&Jonathan.Singer;</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2002-10-05</date> -<releaseinfo ->1.20.00</releaseinfo> +<date>2002-10-05</date> +<releaseinfo>1.20.00</releaseinfo> -<abstract -><para ->This document is the user handbook for the &konsole; application.</para> -<para ->&konsole; is an X terminal emulator for &kde;.</para -></abstract> +<abstract><para>This document is the user handbook for the &konsole; application.</para> +<para>&konsole; is an X terminal emulator for &kde;.</para></abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->konsole</keyword> -<keyword ->tdebase</keyword> -<keyword ->command</keyword> -<keyword ->line</keyword> +<keyword>KDE</keyword> +<keyword>konsole</keyword> +<keyword>tdebase</keyword> +<keyword>command</keyword> +<keyword>line</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introduction to &konsole;</title> +<title>Introduction to &konsole;</title> <sect1 id="terminal"> -<title ->What is a terminal?</title -> <para ->&UNIX; operating systems were originally designed as text-only systems, controlled by keyboard commands -- what is known as a command-line interface (<acronym ->CLI</acronym ->). The &X-Window; and &kde; and other projects have since added the graphical interface you are now using. However, the underlying <acronym ->CLI</acronym -> system is still there, and is frequently the easiest, fastest and most powerful way to perform many tasks.</para -> <para ->&konsole; is what is known as an X terminal emulator, often referred to as a terminal or a shell. It gives you the equivalent of an old-fashioned text screen on your desktop, but one which can easily share the screen with your graphical applications. Windows users may be familiar with the <application -> MS-DOS Prompt</application -> utility, which has the analogous function of offering a <trademark ->DOS</trademark -> command-line under &Windows;. (Although the &UNIX; <acronym ->CLI</acronym ->s offer far more power and ease of use than does <acronym ->DOS</acronym ->!)</para> - -<para ->Explaining the use of the &UNIX; <acronym ->CLI</acronym -> is beyond the scope of this document, as it would require a lengthy book. Fortunately, many such books are available in every language in any good bookstore or library. There are also tutorials available on the Internet. Enjoy &kde;, but don't be shy about learning to use the command-line! You will find that even learning just the basics will make your computer use much more efficient and enjoyable.</para> +<title>What is a terminal?</title> <para>&UNIX; operating systems were originally designed as text-only systems, controlled by keyboard commands -- what is known as a command-line interface (<acronym>CLI</acronym>). The &X-Window; and &kde; and other projects have since added the graphical interface you are now using. However, the underlying <acronym>CLI</acronym> system is still there, and is frequently the easiest, fastest and most powerful way to perform many tasks.</para> <para>&konsole; is what is known as an X terminal emulator, often referred to as a terminal or a shell. It gives you the equivalent of an old-fashioned text screen on your desktop, but one which can easily share the screen with your graphical applications. Windows users may be familiar with the <application> MS-DOS Prompt</application> utility, which has the analogous function of offering a <trademark>DOS</trademark> command-line under &Windows;. (Although the &UNIX; <acronym>CLI</acronym>s offer far more power and ease of use than does <acronym>DOS</acronym>!)</para> + +<para>Explaining the use of the &UNIX; <acronym>CLI</acronym> is beyond the scope of this document, as it would require a lengthy book. Fortunately, many such books are available in every language in any good bookstore or library. There are also tutorials available on the Internet. Enjoy &kde;, but don't be shy about learning to use the command-line! You will find that even learning just the basics will make your computer use much more efficient and enjoyable.</para> </sect1> <sect1 id="features"> -<title ->What makes &konsole; special?</title -> <para ->&konsole;'s advanced features include simple configuration and the ability to use multiple terminal shells in a single window, making for a less cluttered desktop.</para> +<title>What makes &konsole; special?</title> <para>&konsole;'s advanced features include simple configuration and the ability to use multiple terminal shells in a single window, making for a less cluttered desktop.</para> -<para ->Using &konsole;, a user can open:</para> +<para>Using &konsole;, a user can open:</para> <itemizedlist> -<listitem -><para ->&Linux; console sessions</para -></listitem> -<listitem -><para ->Shell sessions</para -></listitem> -<listitem -><para -><application ->Screen</application -> sessions</para -></listitem> -<listitem -><para -><application ->Midnight Commander</application -> file manager sessions</para -></listitem> -<listitem -><para -><systemitem class="username" ->Root</systemitem -> console sessions</para -></listitem> -<listitem -><para -><systemitem class="username" ->Root</systemitem -> <application ->Midnight Commander</application -> sessions</para -></listitem> +<listitem><para>&Linux; console sessions</para></listitem> +<listitem><para>Shell sessions</para></listitem> +<listitem><para><application>Screen</application> sessions</para></listitem> +<listitem><para><application>Midnight Commander</application> file manager sessions</para></listitem> +<listitem><para><systemitem class="username">Root</systemitem> console sessions</para></listitem> +<listitem><para><systemitem class="username">Root</systemitem> <application>Midnight Commander</application> sessions</para></listitem> </itemizedlist> -<para ->These sessions can be renamed to help you keep track of all your shells, or signalled (<errorcode ->STOP</errorcode ->, <errorcode ->CONT</errorcode ->, <errorcode ->HUP</errorcode ->, <errorcode ->INT</errorcode ->, <errorcode ->TERM</errorcode ->, <errorcode ->KILL</errorcode ->).</para> - -<para ->For more control over &konsole;, a user can:</para> +<para>These sessions can be renamed to help you keep track of all your shells, or signalled (<errorcode>STOP</errorcode>, <errorcode>CONT</errorcode>, <errorcode>HUP</errorcode>, <errorcode>INT</errorcode>, <errorcode>TERM</errorcode>, <errorcode>KILL</errorcode>).</para> + +<para>For more control over &konsole;, a user can:</para> <itemizedlist> -<listitem -><para ->hide/show the menubar, toolbar, scrollbar and/or frame</para -></listitem> -<listitem -><para ->select the size of a &konsole; window, fonts, colour schemes, and key mapping</para -></listitem> -<listitem -><para ->change location of the scrollbar or hide the scrollbar</para -></listitem> +<listitem><para>hide/show the menubar, toolbar, scrollbar and/or frame</para></listitem> +<listitem><para>select the size of a &konsole; window, fonts, colour schemes, and key mapping</para></listitem> +<listitem><para>change location of the scrollbar or hide the scrollbar</para></listitem> </itemizedlist> -<para ->All chosen settings can be made the default for forthcoming sessions by saving them. </para> - -<para ->For those with a deep interest in the taxonomy of free X terminals, there are two others of this kind: <application ->xterm</application ->, the original, written even before X itself (a month or two), and <application ->xvt</application ->, a lightweight <application ->xterm</application -> clone, on which most other currently available derivatives (notably <application ->eterm</application ->) are based.</para> - -<para ->After a decade, &konsole; is the first rewrite from the ground up. While <application ->xterm</application -> has definitely been hacked to death (its <filename ->README</filename -> begins with the words <quote ->Abandon All Hope, Ye Who Enter Here</quote ->), &konsole; offers a fresh start using contemporary technologies and understanding of X.</para> +<para>All chosen settings can be made the default for forthcoming sessions by saving them. </para> + +<para>For those with a deep interest in the taxonomy of free X terminals, there are two others of this kind: <application>xterm</application>, the original, written even before X itself (a month or two), and <application>xvt</application>, a lightweight <application>xterm</application> clone, on which most other currently available derivatives (notably <application>eterm</application>) are based.</para> + +<para>After a decade, &konsole; is the first rewrite from the ground up. While <application>xterm</application> has definitely been hacked to death (its <filename>README</filename> begins with the words <quote>Abandon All Hope, Ye Who Enter Here</quote>), &konsole; offers a fresh start using contemporary technologies and understanding of X.</para> </sect1> </chapter> <chapter id="use-of-konsole"> -<title ->Use of &konsole;</title> +<title>Use of &konsole;</title> <sect1 id="startup"> -<title ->Startup</title> +<title>Startup</title> -<para ->When &konsole; is started, an application (typically a &UNIX; shell) runs in the window. Simply type at the prompt.</para> +<para>When &konsole; is started, an application (typically a &UNIX; shell) runs in the window. Simply type at the prompt.</para> <screenshot> -<screeninfo ->&konsole; Screen</screeninfo> +<screeninfo>&konsole; Screen</screeninfo> <mediaobject> <imageobject> <imagedata fileref="konsole.png" format="PNG"/> </imageobject> <textobject> -<phrase ->&konsole; Screen</phrase> +<phrase>&konsole; Screen</phrase> </textobject> </mediaobject> </screenshot> -<para ->A <quote ->Tip of the Day</quote -> window may also appear on startup, offering hints on the use of &konsole;. If you do not wish to receive tips, uncheck the <guilabel ->Show tips on startup</guilabel -> box.</para> +<para>A <quote>Tip of the Day</quote> window may also appear on startup, offering hints on the use of &konsole;. If you do not wish to receive tips, uncheck the <guilabel>Show tips on startup</guilabel> box.</para> </sect1> <sect1 id="history-option"> -<title ->History</title> - -<para ->As lines scroll off the top of the screen, they can be reviewed by moving the scroll bar upwards, scrolling with a mouse wheel or through the use of the <keycombo action="simul" ->&Shift;<keycap ->Page Up</keycap -></keycombo -> (to move back a page), <keycombo action="simul" ->&Shift;<keycap ->Page Down</keycap -></keycombo -> (to move forward a page), <keycombo action="simul" ->&Shift;<keycap ->Up</keycap -></keycombo -> (to move up a line) and <keycombo action="simul" ->&Shift;<keycap ->Down</keycap -></keycombo -> (to move down a line) keys (provided the <link linkend="settings-menu" ->History</link -> option is on).</para> - -<para ->In addition, &konsole; mimics the FreeBSD console when <keycap ->scroll lock</keycap -> is pressed. When scroll lock is on, ordinary in- and output from the shell is suspended, and you can scroll through the history with <keycap ->Page Up</keycap ->, <keycap ->Page down</keycap ->, and <keycap ->Up Arrow</keycap -> and <keycap ->Down Arrow</keycap ->.</para> +<title>History</title> + +<para>As lines scroll off the top of the screen, they can be reviewed by moving the scroll bar upwards, scrolling with a mouse wheel or through the use of the <keycombo action="simul">&Shift;<keycap>Page Up</keycap></keycombo> (to move back a page), <keycombo action="simul">&Shift;<keycap>Page Down</keycap></keycombo> (to move forward a page), <keycombo action="simul">&Shift;<keycap>Up</keycap></keycombo> (to move up a line) and <keycombo action="simul">&Shift;<keycap>Down</keycap></keycombo> (to move down a line) keys (provided the <link linkend="settings-menu">History</link> option is on).</para> + +<para>In addition, &konsole; mimics the FreeBSD console when <keycap>scroll lock</keycap> is pressed. When scroll lock is on, ordinary in- and output from the shell is suspended, and you can scroll through the history with <keycap>Page Up</keycap>, <keycap>Page down</keycap>, and <keycap>Up Arrow</keycap> and <keycap>Down Arrow</keycap>.</para> </sect1> <sect1 id="sessions"> -<title ->Sessions</title> -<para ->If you often have to log into remote machines, or always run a similar set of terminal applications, you can use &konsole;'s <quote ->Session</quote -> feature along with &kde;'s session management to automate a lot of this for you. Let's take the following example: You often have open an <application ->ssh</application -> session to the machine <replaceable ->administration</replaceable -> ready for generic administration tasks. You may have noticed the <guibutton ->New</guibutton -> button on &konsole;'s tab bar contains a menu if you click and hold on it, and you can choose new session types here. We are going to add new entries to this menu. <orderedlist> -<listitem -><para ->Click on the menu entry <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure Konsole</guimenuitem -> </menuchoice -></para -></listitem> -<listitem -><para ->Choose the <guilabel ->Session</guilabel -> tab.</para> -</listitem -> - -<listitem -><para ->Fill in the first entry with a name. This is the name that will show in the menu, and will be the default label instead of <guilabel ->Shell</guilabel -> when you start a session of this type. </para -></listitem -> - -<listitem -><para ->Enter a command just as you normally would if you opened a new shell and were going to issue that command. For our first example above, you might type <userinput -><command ->ssh</command -> <replaceable ->administration</replaceable -></userinput ->.</para -></listitem> - -<listitem -><para ->On the lower part of the panel, configure this session's appearance. You can have a different font, colour scheme, and $<envar ->TERM</envar -> type for each session.</para -></listitem> - -<listitem -><para ->Press the <guibutton ->Save Session...</guibutton -> button. A dialogue will ask you to confirm the filename. </para -></listitem> - -<listitem -><para ->Press <guibutton ->OK</guibutton ->. </para -></listitem> +<title>Sessions</title> +<para>If you often have to log into remote machines, or always run a similar set of terminal applications, you can use &konsole;'s <quote>Session</quote> feature along with &kde;'s session management to automate a lot of this for you. Let's take the following example: You often have open an <application>ssh</application> session to the machine <replaceable>administration</replaceable> ready for generic administration tasks. You may have noticed the <guibutton>New</guibutton> button on &konsole;'s tab bar contains a menu if you click and hold on it, and you can choose new session types here. We are going to add new entries to this menu. <orderedlist> +<listitem><para>Click on the menu entry <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konsole</guimenuitem> </menuchoice></para></listitem> +<listitem><para>Choose the <guilabel>Session</guilabel> tab.</para> +</listitem> + +<listitem><para>Fill in the first entry with a name. This is the name that will show in the menu, and will be the default label instead of <guilabel>Shell</guilabel> when you start a session of this type. </para></listitem> + +<listitem><para>Enter a command just as you normally would if you opened a new shell and were going to issue that command. For our first example above, you might type <userinput><command>ssh</command> <replaceable>administration</replaceable></userinput>.</para></listitem> + +<listitem><para>On the lower part of the panel, configure this session's appearance. You can have a different font, colour scheme, and $<envar>TERM</envar> type for each session.</para></listitem> + +<listitem><para>Press the <guibutton>Save Session...</guibutton> button. A dialogue will ask you to confirm the filename. </para></listitem> + +<listitem><para>Press <guibutton>OK</guibutton>. </para></listitem> </orderedlist> </para> -<para ->You should now be able to press and hold the <guibutton ->New</guibutton -> button on the tab bar, and select your new session type from the list. A new shell session will open within the &konsole; window, with the result of your executed command. In our example, you will be at an <application ->ssh</application -> passphrase prompt, and when you provide your passphrase, you will be logged into the remote machine. <footnote id="use-ssh-agent" -><para ->You can avoid this step also, by using ssh-agent, but that is a topic for another goodie.</para -></footnote -> Perhaps you want to remotely tail your <acronym ->http</acronym -> error logs on a webserver, you could use a commandline something like <userinput -><command ->ssh</command -> <option ->-f</option -> <replaceable ->webserver</replaceable -> <command ->tail</command -> <option ->-f</option -> <filename -><replaceable ->/var/log/httpd-error.log</replaceable -></filename -></userinput ->. </para> -<para ->You can use this to execute local commands as well. Try creating a session where the command is <userinput -><command ->tail</command -> <option ->-f</option -> <filename -><replaceable ->/var/log/messages</replaceable -></filename -></userinput ->. In this case, exiting the running application will close the shell session as well. </para> -<para ->One really nice use of this feature is if you find you always have the same set of open sessions, &kde; can open them all for you automatically when you start a new &kde; session. Simply have them open as you like when you exit &kde;, and they will be saved with your &kde; session, and restored just like any other application when you restart &kde;. </para> +<para>You should now be able to press and hold the <guibutton>New</guibutton> button on the tab bar, and select your new session type from the list. A new shell session will open within the &konsole; window, with the result of your executed command. In our example, you will be at an <application>ssh</application> passphrase prompt, and when you provide your passphrase, you will be logged into the remote machine. <footnote id="use-ssh-agent"><para>You can avoid this step also, by using ssh-agent, but that is a topic for another goodie.</para></footnote> Perhaps you want to remotely tail your <acronym>http</acronym> error logs on a webserver, you could use a commandline something like <userinput><command>ssh</command> <option>-f</option> <replaceable>webserver</replaceable> <command>tail</command> <option>-f</option> <filename><replaceable>/var/log/httpd-error.log</replaceable></filename></userinput>. </para> +<para>You can use this to execute local commands as well. Try creating a session where the command is <userinput><command>tail</command> <option>-f</option> <filename><replaceable>/var/log/messages</replaceable></filename></userinput>. In this case, exiting the running application will close the shell session as well. </para> +<para>One really nice use of this feature is if you find you always have the same set of open sessions, &kde; can open them all for you automatically when you start a new &kde; session. Simply have them open as you like when you exit &kde;, and they will be saved with your &kde; session, and restored just like any other application when you restart &kde;. </para> </sect1> <sect1 id="mousebuttons"> -<title ->Mouse Buttons</title> +<title>Mouse Buttons</title> <variablelist> <varlistentry> -<term -><mousebutton ->Left</mousebutton -></term> +<term><mousebutton>Left</mousebutton></term> -<listitem -><para ->Clicking the <mousebutton ->left</mousebutton -> button is passed as an event to the application running in the emulation, if it is mouse-aware. If a program will react on mouse clicks, &konsole; indicates this by showing an arrow cursor. If not, an I-beam (bar) cursor is shown.</para> +<listitem><para>Clicking the <mousebutton>left</mousebutton> button is passed as an event to the application running in the emulation, if it is mouse-aware. If a program will react on mouse clicks, &konsole; indicates this by showing an arrow cursor. If not, an I-beam (bar) cursor is shown.</para> -<para ->Holding the <mousebutton ->left</mousebutton -> button down and dragging the mouse over the screen with a mouse-unaware application running will mark a region of the text. While dragging, the marked text is displayed reversed for visual feedback. Select <guimenuitem ->Copy</guimenuitem -> from the <guimenu ->Edit</guimenu -> menu to copy the marked text to the clipboard for further use within &konsole; or another application. The selected text can also be dragged and dropped into compatible applications. Click on the selected text and drag it to the desired location. (Depending on your &kde; settings, you may need to hold the &Ctrl; key while dragging.</para> +<para>Holding the <mousebutton>left</mousebutton> button down and dragging the mouse over the screen with a mouse-unaware application running will mark a region of the text. While dragging, the marked text is displayed reversed for visual feedback. Select <guimenuitem>Copy</guimenuitem> from the <guimenu>Edit</guimenu> menu to copy the marked text to the clipboard for further use within &konsole; or another application. The selected text can also be dragged and dropped into compatible applications. Click on the selected text and drag it to the desired location. (Depending on your &kde; settings, you may need to hold the &Ctrl; key while dragging.</para> -<para ->Normally, new-line characters are inserted at the end of each line selected. This is best for cut and paste of source code, or the output of a particular command. For ordinary text, the line breaks are often not important. One might prefer, however, for the text to be a stream of characters that will be automatically re-formatted when pasted into another application. To select in text-stream mode, hold down the &Ctrl; key while selecting normally.</para> +<para>Normally, new-line characters are inserted at the end of each line selected. This is best for cut and paste of source code, or the output of a particular command. For ordinary text, the line breaks are often not important. One might prefer, however, for the text to be a stream of characters that will be automatically re-formatted when pasted into another application. To select in text-stream mode, hold down the &Ctrl; key while selecting normally.</para> -<para ->Double-click with the <mousebutton ->left</mousebutton -> button to select a word; triple-click to select an entire line.</para> +<para>Double-click with the <mousebutton>left</mousebutton> button to select a word; triple-click to select an entire line.</para> -<para ->If the upper or lower edge of the text area is touched while marking, &konsole; scrolls up or down, eventually exposing text within the history buffer. The scrolling stops when the mouse stops moving.</para> +<para>If the upper or lower edge of the text area is touched while marking, &konsole; scrolls up or down, eventually exposing text within the history buffer. The scrolling stops when the mouse stops moving.</para> -<para ->After the mouse is released, &konsole; attempts to keep the text in the clipboard visible by holding the marked area reversed. The marked area reverts back to normal as soon as the contents of the clipboard change, the text within the marked area is altered or the <mousebutton ->left</mousebutton -> mouse button is clicked.</para> +<para>After the mouse is released, &konsole; attempts to keep the text in the clipboard visible by holding the marked area reversed. The marked area reverts back to normal as soon as the contents of the clipboard change, the text within the marked area is altered or the <mousebutton>left</mousebutton> mouse button is clicked.</para> -<para ->To mark text on a mouse-aware application (Midnight Commander, for example) the &Shift; key has to be pressed when clicking.</para> +<para>To mark text on a mouse-aware application (Midnight Commander, for example) the &Shift; key has to be pressed when clicking.</para> </listitem> </varlistentry> <varlistentry> -<term -><mousebutton ->Middle</mousebutton -></term> +<term><mousebutton>Middle</mousebutton></term> -<listitem -><para ->Pressing the <mousebutton ->middle</mousebutton -> button pastes text currently in the clipboard. Holding down the &Ctrl; key as you press the <mousebutton ->middle</mousebutton -> button pastes the text and sends it to &konsole;.</para> +<listitem><para>Pressing the <mousebutton>middle</mousebutton> button pastes text currently in the clipboard. Holding down the &Ctrl; key as you press the <mousebutton>middle</mousebutton> button pastes the text and sends it to &konsole;.</para> -<note -><para ->If you have a mouse with only two buttons, pressing both the <mousebutton ->left</mousebutton -> and <mousebutton ->right</mousebutton -> buttons together emulates the <mousebutton ->middle</mousebutton -> button of a three button mouse.</para -></note> +<note><para>If you have a mouse with only two buttons, pressing both the <mousebutton>left</mousebutton> and <mousebutton>right</mousebutton> buttons together emulates the <mousebutton>middle</mousebutton> button of a three button mouse.</para></note> </listitem> </varlistentry> <varlistentry> -<term -><mousebutton ->Right</mousebutton -></term> +<term><mousebutton>Right</mousebutton></term> <listitem> -<para ->The <mousebutton ->right</mousebutton -> button brings up a menu with the <guimenuitem ->Show Menubar</guimenuitem ->, <guimenuitem ->Copy</guimenuitem ->, <guimenuitem ->Paste</guimenuitem ->, <guimenuitem ->Send Signal</guimenuitem ->, <guimenuitem ->Detach (or Attach) Session</guimenuitem ->, <guimenuitem ->Rename Session...</guimenuitem ->, <guimenuitem ->Bookmarks</guimenuitem -> <guimenuitem ->Settings</guimenuitem -> and <guimenuitem ->Close Session</guimenuitem -> menu items. The <keycombo action="simul" ->&Ctrl; <mousebutton ->right</mousebutton -></keycombo -> button brings up the <guimenu ->Session</guimenu -> menu. </para> +<para>The <mousebutton>right</mousebutton> button brings up a menu with the <guimenuitem>Show Menubar</guimenuitem>, <guimenuitem>Copy</guimenuitem>, <guimenuitem>Paste</guimenuitem>, <guimenuitem>Send Signal</guimenuitem>, <guimenuitem>Detach (or Attach) Session</guimenuitem>, <guimenuitem>Rename Session...</guimenuitem>, <guimenuitem>Bookmarks</guimenuitem> <guimenuitem>Settings</guimenuitem> and <guimenuitem>Close Session</guimenuitem> menu items. The <keycombo action="simul">&Ctrl; <mousebutton>right</mousebutton></keycombo> button brings up the <guimenu>Session</guimenu> menu. </para> </listitem> </varlistentry> </variablelist> @@ -523,735 +188,237 @@ </sect1> <sect1 id="menubar"> -<title ->Menu Bar</title> - -<para ->The menubar is at the top of the &konsole; window. It can be hidden and restored by toggling <guimenuitem ->Show Menubar</guimenuitem -> in the <guimenu ->Settings</guimenu -> menu. When the menubar is hidden, <guimenuitem ->Show Menubar</guimenuitem -> can be reached by <mousebutton ->right</mousebutton -> clicking in the window or by <keycombo action="simul" ->&Alt;&Ctrl;<keycap ->M</keycap -> </keycombo ->.</para> +<title>Menu Bar</title> + +<para>The menubar is at the top of the &konsole; window. It can be hidden and restored by toggling <guimenuitem>Show Menubar</guimenuitem> in the <guimenu>Settings</guimenu> menu. When the menubar is hidden, <guimenuitem>Show Menubar</guimenuitem> can be reached by <mousebutton>right</mousebutton> clicking in the window or by <keycombo action="simul">&Alt;&Ctrl;<keycap>M</keycap> </keycombo>.</para> <sect2 id="session-menu"> -<title -><guimenu ->Session</guimenu -> Menu</title> +<title><guimenu>Session</guimenu> Menu</title> <variablelist> <varlistentry> -<term -><menuchoice -><guimenu ->Session</guimenu -><guimenuitem ->New Shell</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Open a new session</action -> with a terminal shell. <keycombo action="simul" ->&Alt;&Ctrl;<keycap ->N</keycap -> </keycombo -> can also be used, as described in more detail below. </para -></listitem -></varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Session</guimenu -><guimenuitem ->New Linux Console</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Open a new session emulating a text-only &Linux; system.</action -></para> -<note -><para ->See the file <filename ->README.linux.console</filename -> in the &konsole; source package for detailed information on how the &Linux; console differs from a typical &UNIX; console. If this doesn't mean anything to you, you almost certainly don't need to worry about it.</para -></note> +<term><menuchoice><guimenu>Session</guimenu><guimenuitem>New Shell</guimenuitem></menuchoice></term> +<listitem><para><action>Open a new session</action> with a terminal shell. <keycombo action="simul">&Alt;&Ctrl;<keycap>N</keycap> </keycombo> can also be used, as described in more detail below. </para></listitem></varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Session</guimenu><guimenuitem>New Linux Console</guimenuitem></menuchoice></term> +<listitem><para><action>Open a new session emulating a text-only &Linux; system.</action></para> +<note><para>See the file <filename>README.linux.console</filename> in the &konsole; source package for detailed information on how the &Linux; console differs from a typical &UNIX; console. If this doesn't mean anything to you, you almost certainly don't need to worry about it.</para></note> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Session</guimenu -><guimenuitem ->New Midnight Commander</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Open a new session</action -> with the <application ->Midnight Commander</application -> file browser.</para -></listitem> +<term><menuchoice><guimenu>Session</guimenu><guimenuitem>New Midnight Commander</guimenuitem></menuchoice></term> +<listitem><para><action>Open a new session</action> with the <application>Midnight Commander</application> file browser.</para></listitem> </varlistentry> <varlistentry> <term> -<menuchoice -><guimenu ->Session</guimenu -> <guimenuitem ->New Root Console</guimenuitem -></menuchoice> +<menuchoice><guimenu>Session</guimenu> <guimenuitem>New Root Console</guimenuitem></menuchoice> </term> <listitem> -<para -><action ->Open a new session with a terminal shell</action ->, as the <systemitem class="username" ->root</systemitem -> user. </para> - -<para ->After being prompted for the <systemitem class="username" ->root</systemitem -> password, the <prompt ->#</prompt -> prompt appears, indicating that the user is working with <systemitem class="username" ->root</systemitem -> privileges. This is frequently necessary for installing new software and other system maintenance, but care should be taken to avoid accidental damage. </para> +<para><action>Open a new session with a terminal shell</action>, as the <systemitem class="username">root</systemitem> user. </para> + +<para>After being prompted for the <systemitem class="username">root</systemitem> password, the <prompt>#</prompt> prompt appears, indicating that the user is working with <systemitem class="username">root</systemitem> privileges. This is frequently necessary for installing new software and other system maintenance, but care should be taken to avoid accidental damage. </para> </listitem> </varlistentry> <varlistentry> <term> -<menuchoice -><guimenu ->Session</guimenu -> <guimenuitem ->New Root Midnight Commander</guimenuitem -></menuchoice> +<menuchoice><guimenu>Session</guimenu> <guimenuitem>New Root Midnight Commander</guimenuitem></menuchoice> </term> <listitem> -<para -><action ->Open a new session</action -> with the <application ->Midnight Commander</application -> file browser, as the <systemitem class="username" ->root</systemitem -> user. </para> -<para ->After being prompted for the <systemitem class="username" ->root</systemitem -> password, the <prompt ->#</prompt -> prompt appears under the browser window, indicating that the user is working with <systemitem class="username" ->root</systemitem -> privileges. Again, working as <systemitem class="username" ->root</systemitem -> is frequently necessary but care should be taken to avoid accidental damage. </para> +<para><action>Open a new session</action> with the <application>Midnight Commander</application> file browser, as the <systemitem class="username">root</systemitem> user. </para> +<para>After being prompted for the <systemitem class="username">root</systemitem> password, the <prompt>#</prompt> prompt appears under the browser window, indicating that the user is working with <systemitem class="username">root</systemitem> privileges. Again, working as <systemitem class="username">root</systemitem> is frequently necessary but care should be taken to avoid accidental damage. </para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Session</guimenu -><guimenuitem ->New Screen Session</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Open a new session</action -> with the <application ->Screen</application -> virtual terminal manager. See <userinput -><command ->man</command -> <option ->screen</option -> </userinput ->for more information. </para -></listitem -></varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Session</guimenu -> <guimenuitem ->New Shell at Bookmark</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Start</action -> a new terminal shell, in a folder chosen from the bookmark list.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Session</guimenu -> <guimenuitem ->Close Session</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Close</action -> the current session. </para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Session</guimenu -> <guimenuitem ->Quit</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Quit</action -> &konsole;, closing all sessions and any applications launched from them.</para -></listitem> +<term><menuchoice><guimenu>Session</guimenu><guimenuitem>New Screen Session</guimenuitem></menuchoice></term> +<listitem><para><action>Open a new session</action> with the <application>Screen</application> virtual terminal manager. See <userinput><command>man</command> <option>screen</option> </userinput>for more information. </para></listitem></varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Session</guimenu> <guimenuitem>New Shell at Bookmark</guimenuitem></menuchoice></term> +<listitem><para><action>Start</action> a new terminal shell, in a folder chosen from the bookmark list.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Session</guimenu> <guimenuitem>Close Session</guimenuitem></menuchoice></term> +<listitem><para><action>Close</action> the current session. </para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Session</guimenu> <guimenuitem>Quit</guimenuitem></menuchoice></term> +<listitem><para><action>Quit</action> &konsole;, closing all sessions and any applications launched from them.</para></listitem> </varlistentry> </variablelist> -<para ->You can also open a new session with a key shortcut. By default, <keycombo action="simul" ->&Alt;&Ctrl;<keycap ->N</keycap -> </keycombo -> is used. You can also define your own key shortcuts through the <menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Configure Shortcuts...</guimenuitem -></menuchoice -> menu command.</para> - -<para ->The files with a <literal role="extension" ->*.keytab</literal -> extension in <filename class="directory" ->$<envar ->TDEDIR</envar ->/share/apps/konsole</filename -> also define keyboard shortcuts. Use the <menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Keyboard</guimenuitem -></menuchoice -> menu command to choose a keytab file. The file <filename ->README.KeyTab</filename -> contains more information on defining shortcuts. </para> - -<para ->The list of available sessions may differ from those listed here. &konsole; detects your installed programs and customises the list to reflect the available options.</para> - -<para ->Finally, note that the session types can be modified, and new types created, by using the configuration dialogue, reached from the <menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Configure Konsole...</guimenuitem -></menuchoice -> menu entry.</para> +<para>You can also open a new session with a key shortcut. By default, <keycombo action="simul">&Alt;&Ctrl;<keycap>N</keycap> </keycombo> is used. You can also define your own key shortcuts through the <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure Shortcuts...</guimenuitem></menuchoice> menu command.</para> + +<para>The files with a <literal role="extension">*.keytab</literal> extension in <filename class="directory">$<envar>TDEDIR</envar>/share/apps/konsole</filename> also define keyboard shortcuts. Use the <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Keyboard</guimenuitem></menuchoice> menu command to choose a keytab file. The file <filename>README.KeyTab</filename> contains more information on defining shortcuts. </para> + +<para>The list of available sessions may differ from those listed here. &konsole; detects your installed programs and customises the list to reflect the available options.</para> + +<para>Finally, note that the session types can be modified, and new types created, by using the configuration dialogue, reached from the <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure Konsole...</guimenuitem></menuchoice> menu entry.</para> </sect2> <sect2 id="edit-menu"> -<title -><guimenu ->Edit</guimenu -> Menu</title> +<title><guimenu>Edit</guimenu> Menu</title> <variablelist> <varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Copy </guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Copy the selected text to the clipboard.</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Paste </guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Paste text from the clipboard at the cursor location.</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -> <guisubmenu ->Send Signal</guisubmenu -></menuchoice -></term> -<listitem -><para -><action ->Send Signal - Send the specified signal to the shell process, or other process, that was launched when the new session was started.</action -></para -><para ->Currently available signals are:</para> +<term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy </guimenuitem></menuchoice></term> +<listitem><para><action>Copy the selected text to the clipboard.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste </guimenuitem></menuchoice></term> +<listitem><para><action>Paste text from the clipboard at the cursor location.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu> <guisubmenu>Send Signal</guisubmenu></menuchoice></term> +<listitem><para><action>Send Signal - Send the specified signal to the shell process, or other process, that was launched when the new session was started.</action></para><para>Currently available signals are:</para> <informaltable> <tgroup cols="2"> <tbody> <row> -<entry -><errorcode ->STOP</errorcode -></entry> -<entry ->to stop process</entry> +<entry><errorcode>STOP</errorcode></entry> +<entry>to stop process</entry> </row> <row> -<entry -><errorcode ->CONT</errorcode -></entry> -<entry ->continue if stopped</entry> +<entry><errorcode>CONT</errorcode></entry> +<entry>continue if stopped</entry> </row> <row> -<entry -><errorcode ->HUP</errorcode -></entry> -<entry ->hangup detected on controlling terminal, or death of controlling process</entry> +<entry><errorcode>HUP</errorcode></entry> +<entry>hangup detected on controlling terminal, or death of controlling process</entry> </row> <row> -<entry -><errorcode ->INT</errorcode -></entry> -<entry ->interrupt from keyboard</entry> +<entry><errorcode>INT</errorcode></entry> +<entry>interrupt from keyboard</entry> </row> <row> -<entry -><errorcode ->TERM</errorcode -></entry> -<entry ->termination signal</entry> +<entry><errorcode>TERM</errorcode></entry> +<entry>termination signal</entry> </row> <row> -<entry -><errorcode ->KILL</errorcode -></entry> -<entry ->kill signal</entry> +<entry><errorcode>KILL</errorcode></entry> +<entry>kill signal</entry> </row> <row> -<entry -><errorcode ->USR1</errorcode -></entry> -<entry ->user signal 1</entry> +<entry><errorcode>USR1</errorcode></entry> +<entry>user signal 1</entry> </row> <row> -<entry -><errorcode ->USR2</errorcode -></entry> -<entry ->user signal 2</entry> +<entry><errorcode>USR2</errorcode></entry> +<entry>user signal 2</entry> </row> </tbody> </tgroup> </informaltable> -<para ->Refer to your system manual pages for further details by giving the command <userinput -><command ->man</command -> <option ->7 signal</option -></userinput ->.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Clear Terminal</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Clear all text from the session window.</action ->.</para -></listitem> -</varlistentry> - - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Reset and Clear Terminal</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Start a new session in the window.</action ->.</para -></listitem> -</varlistentry> - - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Find in History...</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Find a word or string of text</action -> in the current history. Options allow case sensitive or backwards searches, and the use of regular expressions in searches. Press the <guibutton ->Edit</guibutton -> button to use the &kde; graphical editor to create a regular expression.</para -></listitem> -</varlistentry> - - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Find Next</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Move to the next instance of the text for which you are searching.</action> -</para -></listitem> -</varlistentry> - - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Find Previous</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Move to the previous instance of the text for which you are searching.</action> -</para -></listitem> -</varlistentry> - - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Save History As...</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Save the current history</action -> as a text file.</para -></listitem> -</varlistentry> - - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Clear History </guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Clear the history for the current session.</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Clear All Histories </guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Clear the history for all sessions.</action> -</para -></listitem> +<para>Refer to your system manual pages for further details by giving the command <userinput><command>man</command> <option>7 signal</option></userinput>.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Clear Terminal</guimenuitem></menuchoice></term> +<listitem><para><action>Clear all text from the session window.</action>.</para></listitem> +</varlistentry> + + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Reset and Clear Terminal</guimenuitem></menuchoice></term> +<listitem><para><action>Start a new session in the window.</action>.</para></listitem> +</varlistentry> + + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Find in History...</guimenuitem></menuchoice></term> +<listitem><para><action>Find a word or string of text</action> in the current history. Options allow case sensitive or backwards searches, and the use of regular expressions in searches. Press the <guibutton>Edit</guibutton> button to use the &kde; graphical editor to create a regular expression.</para></listitem> +</varlistentry> + + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Find Next</guimenuitem></menuchoice></term> +<listitem><para><action>Move to the next instance of the text for which you are searching.</action> +</para></listitem> +</varlistentry> + + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Find Previous</guimenuitem></menuchoice></term> +<listitem><para><action>Move to the previous instance of the text for which you are searching.</action> +</para></listitem> +</varlistentry> + + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Save History As...</guimenuitem></menuchoice></term> +<listitem><para><action>Save the current history</action> as a text file.</para></listitem> +</varlistentry> + + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Clear History </guimenuitem></menuchoice></term> +<listitem><para><action>Clear the history for the current session.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Clear All Histories </guimenuitem></menuchoice></term> +<listitem><para><action>Clear the history for all sessions.</action> +</para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="view-menu"> -<title -><guimenu ->View</guimenu -> Menu</title> +<title><guimenu>View</guimenu> Menu</title> <variablelist> <varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -><guimenuitem ->Detach Session</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Open the current session in a separate window.</action -> The name of the session is displayed on the titlebar of the new window. Close the new window to restore the session to its original place, or <mousebutton ->right</mousebutton ->-click on the new window and select <guimenuitem ->Attach Session</guimenuitem ->. Note that if the main window is closed, any detached sessions will be closed with it. </para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -><guimenuitem ->Rename Session...</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Open a dialogue box allowing you to change the name of the current session.</action -> The name is displayed on the session tab. <keycombo action="simul" ->&Alt;&Ctrl;<keycap ->S</keycap -> </keycombo -> can also be used.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -><guimenuitem ->Monitor for Activity</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Flag the current session so it will show an alert if activity occurs.</action -> An icon of a lit light bulb will appear in the session's tab. Use this to alert you if something happens while you are working in another session. The time before an alert can be modified in the &konsole; preferences.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -><guimenuitem ->Monitor for Silence</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Flag the current session so it will show an alert if no activity occurs for 10 seconds.</action -> An icon of a dark light bulb will appear in the session's tab. Use this to alert you if a task stops while you are working in another session. The time before an alert can be modified in the &konsole; preferences.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -><guimenuitem ->Send Input to All Sessions</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Flag the current session so any commands entered into it will be sent to all sessions.</action -> The session will have a small icon in its tab to remind you to be careful of what you enter! <userinput -><command ->rm </command -><parameter ->-rf *</parameter -></userinput ->, for instance, is probably not a good idea.</para -></listitem> -</varlistentry> - - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -><guimenuitem ->Move Session Left</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Move the tab of the current session one tab to the left.</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -><guimenuitem ->Move Session Right</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Move the tab of the current session one tab to the right.</action -></para> -<para -><keycombo action="simul" ->&Shift; <keycap ->Left</keycap -></keycombo -> and <keycombo action="simul" ->&Shift; <keycap ->Right</keycap -></keycombo -> can be also be used to move between sessions.</para -></listitem -></varlistentry> - - -<varlistentry> -<term -><menuchoice -><guimenu ->View</guimenu -> <guimenuitem ->Session icons...</guimenuitem -></menuchoice -></term> -<listitem -><para ->At the bottom of the menu is a list of the available sessions. Selecting one makes that session active.</para -><para ->You can also use the <keycombo action="simul" ->&Shift;<keycap ->Left</keycap -></keycombo ->/<keycombo action="simul" ->&Shift;<keycap ->Right</keycap -></keycombo -> keys to cycle through the available sessions.</para> +<term><menuchoice><guimenu>View</guimenu><guimenuitem>Detach Session</guimenuitem></menuchoice></term> +<listitem><para><action>Open the current session in a separate window.</action> The name of the session is displayed on the titlebar of the new window. Close the new window to restore the session to its original place, or <mousebutton>right</mousebutton>-click on the new window and select <guimenuitem>Attach Session</guimenuitem>. Note that if the main window is closed, any detached sessions will be closed with it. </para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu><guimenuitem>Rename Session...</guimenuitem></menuchoice></term> +<listitem><para><action>Open a dialogue box allowing you to change the name of the current session.</action> The name is displayed on the session tab. <keycombo action="simul">&Alt;&Ctrl;<keycap>S</keycap> </keycombo> can also be used.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu><guimenuitem>Monitor for Activity</guimenuitem></menuchoice></term> +<listitem><para><action>Flag the current session so it will show an alert if activity occurs.</action> An icon of a lit light bulb will appear in the session's tab. Use this to alert you if something happens while you are working in another session. The time before an alert can be modified in the &konsole; preferences.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu><guimenuitem>Monitor for Silence</guimenuitem></menuchoice></term> +<listitem><para><action>Flag the current session so it will show an alert if no activity occurs for 10 seconds.</action> An icon of a dark light bulb will appear in the session's tab. Use this to alert you if a task stops while you are working in another session. The time before an alert can be modified in the &konsole; preferences.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu><guimenuitem>Send Input to All Sessions</guimenuitem></menuchoice></term> +<listitem><para><action>Flag the current session so any commands entered into it will be sent to all sessions.</action> The session will have a small icon in its tab to remind you to be careful of what you enter! <userinput><command>rm </command><parameter>-rf *</parameter></userinput>, for instance, is probably not a good idea.</para></listitem> +</varlistentry> + + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu><guimenuitem>Move Session Left</guimenuitem></menuchoice></term> +<listitem><para><action>Move the tab of the current session one tab to the left.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu><guimenuitem>Move Session Right</guimenuitem></menuchoice></term> +<listitem><para><action>Move the tab of the current session one tab to the right.</action></para> +<para><keycombo action="simul">&Shift; <keycap>Left</keycap></keycombo> and <keycombo action="simul">&Shift; <keycap>Right</keycap></keycombo> can be also be used to move between sessions.</para></listitem></varlistentry> + + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu> <guimenuitem>Session icons...</guimenuitem></menuchoice></term> +<listitem><para>At the bottom of the menu is a list of the available sessions. Selecting one makes that session active.</para><para>You can also use the <keycombo action="simul">&Shift;<keycap>Left</keycap></keycombo>/<keycombo action="simul">&Shift;<keycap>Right</keycap></keycombo> keys to cycle through the available sessions.</para> </listitem> </varlistentry> @@ -1259,73 +426,30 @@ </sect2> <sect2 id="bookmarks-menu"> -<title -><guimenu ->Bookmarks</guimenu -> Menu</title> +<title><guimenu>Bookmarks</guimenu> Menu</title> <variablelist> <varlistentry> -<term -><menuchoice -><guimenu ->Bookmarks</guimenu -><guimenuitem ->Add Bookmark</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Add the current location </action ->to the bookmark list.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Bookmarks</guimenu -><guimenuitem ->Edit Bookmarks</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Edit </action ->the bookmark list.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Bookmarks</guimenu -><guimenuitem ->New Bookmark Folder...</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Add a new folder </action ->to the bookmark list.</para -></listitem> +<term><menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Add Bookmark</guimenuitem></menuchoice></term> +<listitem><para><action>Add the current location </action>to the bookmark list.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Edit Bookmarks</guimenuitem></menuchoice></term> +<listitem><para><action>Edit </action>the bookmark list.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>New Bookmark Folder...</guimenuitem></menuchoice></term> +<listitem><para><action>Add a new folder </action>to the bookmark list.</para></listitem> </varlistentry> </variablelist> -<para ->The bookmark list is displayed at the bottom of the menu. Select a bookmark to change to that location.</para> +<para>The bookmark list is displayed at the bottom of the menu. Select a bookmark to change to that location.</para> -<note -><para ->You can use the bookmark editor to manually add URLs like ssh://user@host or telnet://host to open remote connections.</para -></note> +<note><para>You can use the bookmark editor to manually add URLs like ssh://user@host or telnet://host to open remote connections.</para></note> </sect2> @@ -1333,292 +457,84 @@ <sect2 id="settings-menu"> -<title -><guimenu ->Settings</guimenu -> Menu</title> +<title><guimenu>Settings</guimenu> Menu</title> <variablelist> <varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Show Menubar</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Show or hide the menubar.</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Show Toolbar</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Show or hide the toolbar.</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guisubmenu ->Scrollbar</guisubmenu -></menuchoice -></term> -<listitem -><para -><action ->Control location of scrollbar</action ->: <guimenuitem ->none</guimenuitem ->, <guimenuitem ->left</guimenuitem ->, or <guimenuitem ->right</guimenuitem ->.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Fullscreen</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Toggle window between full-screen and normal size.</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Bell</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Set the system bell to a &kde; System Notification or a visible flash, or turns it off. </action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guisubmenu ->Font</guisubmenu -></menuchoice -></term> -<listitem -><para -><action ->Set font and font size</action -></para> -<para ->Select the <guimenuitem ->Custom</guimenuitem -> option to use any combination of font, size and style. The <filename ->README.fonts</filename -> file in the &konsole; source package gives tips on which fonts will work well.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Keyboard</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Choose desired keymapping.</action -></para> -<para ->The list of these keymappings is taken from <filename ->$TDEDIR/share/apps/konsole/*.keytab</filename ->. The file <filename ->$TDEDIR/share/apps/konsole/README.KeyTab</filename -> describes the keytab format in more detail. Add to or modify these files to match your needs.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->Schema</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Set colours of text and background.</action -></para> -<para ->The list of these schemata is taken from <filename ->$TDEDIR/share/apps/konsole/*.schema</filename ->. The file <filename ->$TDEDIR/share/apps/konsole/README.Schema</filename -> describes the schema format in more detail. Add to or modify these files to match your needs. You can also create custom schema through the preferences dialogue at <menuchoice -><guisubmenu ->Settings</guisubmenu -> <guimenuitem ->Configure Konsole...</guimenuitem -></menuchoice ->. </para> +<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Show Menubar</guimenuitem></menuchoice></term> +<listitem><para><action>Show or hide the menubar.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Show Toolbar</guimenuitem></menuchoice></term> +<listitem><para><action>Show or hide the toolbar.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guisubmenu>Scrollbar</guisubmenu></menuchoice></term> +<listitem><para><action>Control location of scrollbar</action>: <guimenuitem>none</guimenuitem>, <guimenuitem>left</guimenuitem>, or <guimenuitem>right</guimenuitem>.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guimenuitem>Fullscreen</guimenuitem></menuchoice></term> +<listitem><para><action>Toggle window between full-screen and normal size.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guimenuitem>Bell</guimenuitem></menuchoice></term> +<listitem><para><action>Set the system bell to a &kde; System Notification or a visible flash, or turns it off. </action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guisubmenu>Font</guisubmenu></menuchoice></term> +<listitem><para><action>Set font and font size</action></para> +<para>Select the <guimenuitem>Custom</guimenuitem> option to use any combination of font, size and style. The <filename>README.fonts</filename> file in the &konsole; source package gives tips on which fonts will work well.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guimenuitem>Keyboard</guimenuitem></menuchoice></term> +<listitem><para><action>Choose desired keymapping.</action></para> +<para>The list of these keymappings is taken from <filename>$TDEDIR/share/apps/konsole/*.keytab</filename>. The file <filename>$TDEDIR/share/apps/konsole/README.KeyTab</filename> describes the keytab format in more detail. Add to or modify these files to match your needs.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guimenuitem>Schema</guimenuitem></menuchoice></term> +<listitem><para><action>Set colours of text and background.</action></para> +<para>The list of these schemata is taken from <filename>$TDEDIR/share/apps/konsole/*.schema</filename>. The file <filename>$TDEDIR/share/apps/konsole/README.Schema</filename> describes the schema format in more detail. Add to or modify these files to match your needs. You can also create custom schema through the preferences dialogue at <menuchoice><guisubmenu>Settings</guisubmenu> <guimenuitem>Configure Konsole...</guimenuitem></menuchoice>. </para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guisubmenu ->Size</guisubmenu -></menuchoice -></term> -<listitem -><para -><action ->Set size of text area (given in columns x rows).</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -> <guimenuitem ->History...</guimenuitem -></menuchoice -></term> -<listitem -><para -><anchor id="configure-history"/><action ->Open a dialogue where you can configure the history.</action -> The <guilabel ->Enable</guilabel -> checkbox toggles saving of lines that have scrolled off the top of the window. You can enter the <guilabel ->Number of lines</guilabel -> to remember in the text field, or use the spinner buttons to increase or decrease the number in steps of 100 lines. The <guibutton ->Defaults</guibutton -> button will reset the history to 1000 lines. Setting this value to 0 will cause all history to be saved. Press <guibutton ->OK</guibutton -> to save your changes, or <guibutton ->Cancel</guibutton -> to close the dialogue without saving your settings. The <guibutton ->Help</guibutton -> button will open this manual, and display the text you're reading right now.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Save Settings</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Save the current settings as the new defaults.</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Save Sessions Profile...</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Save the current set of sessions </action ->under a name you choose. The profile can then be used by starting &konsole; from the command-line with the <parameter ->--profile</parameter -> and the name of the profile.</para> +<term><menuchoice><guimenu>Settings</guimenu> <guisubmenu>Size</guisubmenu></menuchoice></term> +<listitem><para><action>Set size of text area (given in columns x rows).</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu> <guimenuitem>History...</guimenuitem></menuchoice></term> +<listitem><para><anchor id="configure-history"/><action>Open a dialogue where you can configure the history.</action> The <guilabel>Enable</guilabel> checkbox toggles saving of lines that have scrolled off the top of the window. You can enter the <guilabel>Number of lines</guilabel> to remember in the text field, or use the spinner buttons to increase or decrease the number in steps of 100 lines. The <guibutton>Defaults</guibutton> button will reset the history to 1000 lines. Setting this value to 0 will cause all history to be saved. Press <guibutton>OK</guibutton> to save your changes, or <guibutton>Cancel</guibutton> to close the dialogue without saving your settings. The <guibutton>Help</guibutton> button will open this manual, and display the text you're reading right now.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Save Settings</guimenuitem></menuchoice></term> +<listitem><para><action>Save the current settings as the new defaults.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Save Sessions Profile...</guimenuitem></menuchoice></term> +<listitem><para><action>Save the current set of sessions </action>under a name you choose. The profile can then be used by starting &konsole; from the command-line with the <parameter>--profile</parameter> and the name of the profile.</para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure Shortcuts...</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Customise keyboard shortcuts for &konsole; commands.</action -></para> +<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts...</guimenuitem></menuchoice></term> +<listitem><para><action>Customise keyboard shortcuts for &konsole; commands.</action></para> </listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Configure &konsole;...</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Open the &kcontrolcenter; module, allowing many additional changes to &konsole;'s interface and behaviour, including the creation of custom schemas and modification of the available sessions.</action -></para> +<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &konsole;...</guimenuitem></menuchoice></term> +<listitem><para><action>Open the &kcontrolcenter; module, allowing many additional changes to &konsole;'s interface and behaviour, including the creation of custom schemas and modification of the available sessions.</action></para> </listitem> </varlistentry> @@ -1626,100 +542,31 @@ </sect2> <sect2 id="help-menu"> -<title -><guimenu ->Help</guimenu -> Menu</title> +<title><guimenu>Help</guimenu> Menu</title> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -> <keycap ->F1</keycap -></shortcut -><guimenu ->Help</guimenu -> <guimenuitem ->Konsole Handbook</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Open the table of contents of this document.</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Help</guimenu -> <guimenuitem ->Tip of the Day...</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Display a helpful tip about the use of &konsole;. </action ->Check the <guilabel ->Show on start</guilabel -> box to display a tip each time &konsole; is started.</para -></listitem> -</varlistentry> -<varlistentry> -<term -><menuchoice -><guimenu ->Help</guimenu -><guimenuitem ->Report Bug...</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Submit a bug report or a feature request</action -> for &konsole;.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Help</guimenu -><guimenuitem ->About Konsole...</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Information about</action -> &konsole;'s author</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><menuchoice -><guimenu ->Help</guimenu -><guimenuitem ->About KDE...</guimenuitem -></menuchoice -></term> -<listitem -><para -><action ->Information about the KDE project</action -></para -></listitem> +<term><menuchoice><shortcut> <keycap>F1</keycap></shortcut><guimenu>Help</guimenu> <guimenuitem>Konsole Handbook</guimenuitem></menuchoice></term> +<listitem><para><action>Open the table of contents of this document.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Help</guimenu> <guimenuitem>Tip of the Day...</guimenuitem></menuchoice></term> +<listitem><para><action>Display a helpful tip about the use of &konsole;. </action>Check the <guilabel>Show on start</guilabel> box to display a tip each time &konsole; is started.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice><guimenu>Help</guimenu><guimenuitem>Report Bug...</guimenuitem></menuchoice></term> +<listitem><para><action>Submit a bug report or a feature request</action> for &konsole;.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Help</guimenu><guimenuitem>About Konsole...</guimenuitem></menuchoice></term> +<listitem><para><action>Information about</action> &konsole;'s author</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Help</guimenu><guimenuitem>About KDE...</guimenuitem></menuchoice></term> +<listitem><para><action>Information about the KDE project</action></para></listitem> </varlistentry> </variablelist> @@ -1728,468 +575,165 @@ </sect1> <sect1 id="toolbar"> -<title ->Toolbar</title> - -<para ->The toolbar is at the bottom of the &konsole; window.</para> - -<para ->It can be hidden and restored by toggling <guimenuitem ->Show Toolbar</guimenuitem -> in the <guimenu ->Settings</guimenu -> menu or by clicking the textured <quote ->handle</quote -> at the side of the bar. The bar contains a <guiicon ->New</guiicon -> icon and icons for the current sessions. Clicking <guiicon ->New</guiicon -> opens a new <quote ->Shell</quote -> session.</para> -<para ->Double-clicking a session tab opens a dialogue box enabling you to change the name of that session. <keycombo action="simul" ->&Alt;&Ctrl;<keycap ->S</keycap -> </keycombo -> can also be used to rename the active session.</para> -<para ->Clicking an existing session's icon makes that session active.</para -> <para ->When the toolbar is hidden, <keycombo action="simul" ->&Shift; <keycap ->Left</keycap -></keycombo -> and <keycombo action="simul" ->&Shift; <keycap ->Right</keycap -></keycombo -> can be used to move between sessions.</para> +<title>Toolbar</title> + +<para>The toolbar is at the bottom of the &konsole; window.</para> + +<para>It can be hidden and restored by toggling <guimenuitem>Show Toolbar</guimenuitem> in the <guimenu>Settings</guimenu> menu or by clicking the textured <quote>handle</quote> at the side of the bar. The bar contains a <guiicon>New</guiicon> icon and icons for the current sessions. Clicking <guiicon>New</guiicon> opens a new <quote>Shell</quote> session.</para> +<para>Double-clicking a session tab opens a dialogue box enabling you to change the name of that session. <keycombo action="simul">&Alt;&Ctrl;<keycap>S</keycap> </keycombo> can also be used to rename the active session.</para> +<para>Clicking an existing session's icon makes that session active.</para> <para>When the toolbar is hidden, <keycombo action="simul">&Shift; <keycap>Left</keycap></keycombo> and <keycombo action="simul">&Shift; <keycap>Right</keycap></keycombo> can be used to move between sessions.</para> </sect1> <sect1 id="command-line-options"> -<title ->Command-line Options</title> +<title>Command-line Options</title> -<para ->When &konsole; is started from the command-line, various options can be specified to modify its behaviour.</para> +<para>When &konsole; is started from the command-line, various options can be specified to modify its behaviour.</para> <variablelist> <varlistentry> -<term -><option ->--help</option -></term> -<listitem -><para -><action ->List the various options</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--name</option -> <parameter ->name</parameter -></term> -<listitem -><para -><action ->Set the name that appears in the titlebar</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--ls</option -></term> -<listitem -><para -><action ->Start with a login shell environment.</action -> What that does varies depending on your system, but generally it means that files such as <filename ->~/.profile</filename -> or <filename ->~/.bash_profile</filename -> will be read. (If that doesn't mean anything to you, don't worry about it, but keep in the back of your mind for when you realise you need it.)</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->-T</option -> <parameter ->title</parameter -></term> -<listitem -><para -><action ->Set the window title</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--tn</option -> <parameter ->terminal</parameter -></term> -<listitem -><para -><action ->Sets the environment variable TERM to the specified value.</action -> Read <userinput -><command ->man</command -> <option ->xterm</option -> </userinput -> for more information on TERM.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--xwin</option -></term> -<listitem -><para -><action ->Ignored</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--noclose</option -></term> -<listitem -><para -><action ->Prevent &konsole; from closing</action -> when an <userinput -><command ->exit</command -></userinput -> command is issued in the only session window.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--nohist</option -></term> -<listitem -><para -><action ->Disable the saving of lines that scroll off the top of the window</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--nomenubar</option -></term> -<listitem -><para -><action ->Start &konsole; without a menubar</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--notoolbar</option -></term> -<listitem -><para -><action ->Start &konsole; without a toolbar</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--noframe</option -></term> -<listitem -><para -><action ->Start &konsole; without a frame</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--noscrollbar</option -></term> -<listitem -><para -><action ->Start &konsole; without a scrollbar</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--noxft</option -></term> -<listitem -><para -><action ->Start &konsole; without Xft antialiasing.</action -> Antialiasing of a small font may be difficult to read.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--vt_sz</option -> <parameter ->CCxLL</parameter -></term> -<listitem -><para -><action ->Start a terminal window of CC Columns and LL lines</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--type</option -> <parameter ->type</parameter -></term> -<listitem -><para -><action ->Start a session of the given type rather than the default.</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--keytab</option -> <parameter ->file</parameter -></term> -<listitem -><para -><action ->Start &konsole; using a specified .keytab file</action -> to customise key bindings.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--profile</option -> <parameter ->file</parameter -></term> -<listitem -><para -><action ->Start &konsole; using a saved set of sessions.</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--schema</option -> <parameter ->file</parameter -></term> -<listitem -><para -><action ->Start &konsole; using a specified .schema file</action -> to customise appearance.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--script</option -> <parameter ->file</parameter -></term> -<listitem -><para -><action ->Allow the use of extended DCOP commands to paste text into sessions.</action -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->--workdir</option -> <parameter ->dir</parameter -></term> -<listitem -><para -><action ->Open with</action -> <parameter ->dir</parameter -> as the working folder.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><option ->-e</option -> <parameter ->command</parameter -></term> -<listitem -><para -><action ->Execute</action -> <parameter ->command</parameter -> instead of shell.</para -></listitem> +<term><option>--help</option></term> +<listitem><para><action>List the various options</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--name</option> <parameter>name</parameter></term> +<listitem><para><action>Set the name that appears in the titlebar</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--ls</option></term> +<listitem><para><action>Start with a login shell environment.</action> What that does varies depending on your system, but generally it means that files such as <filename>~/.profile</filename> or <filename>~/.bash_profile</filename> will be read. (If that doesn't mean anything to you, don't worry about it, but keep in the back of your mind for when you realise you need it.)</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>-T</option> <parameter>title</parameter></term> +<listitem><para><action>Set the window title</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--tn</option> <parameter>terminal</parameter></term> +<listitem><para><action>Sets the environment variable TERM to the specified value.</action> Read <userinput><command>man</command> <option>xterm</option> </userinput> for more information on TERM.</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--xwin</option></term> +<listitem><para><action>Ignored</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--noclose</option></term> +<listitem><para><action>Prevent &konsole; from closing</action> when an <userinput><command>exit</command></userinput> command is issued in the only session window.</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--nohist</option></term> +<listitem><para><action>Disable the saving of lines that scroll off the top of the window</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--nomenubar</option></term> +<listitem><para><action>Start &konsole; without a menubar</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--notoolbar</option></term> +<listitem><para><action>Start &konsole; without a toolbar</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--noframe</option></term> +<listitem><para><action>Start &konsole; without a frame</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--noscrollbar</option></term> +<listitem><para><action>Start &konsole; without a scrollbar</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--noxft</option></term> +<listitem><para><action>Start &konsole; without Xft antialiasing.</action> Antialiasing of a small font may be difficult to read.</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--vt_sz</option> <parameter>CCxLL</parameter></term> +<listitem><para><action>Start a terminal window of CC Columns and LL lines</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--type</option> <parameter>type</parameter></term> +<listitem><para><action>Start a session of the given type rather than the default.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--keytab</option> <parameter>file</parameter></term> +<listitem><para><action>Start &konsole; using a specified .keytab file</action> to customise key bindings.</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--profile</option> <parameter>file</parameter></term> +<listitem><para><action>Start &konsole; using a saved set of sessions.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--schema</option> <parameter>file</parameter></term> +<listitem><para><action>Start &konsole; using a specified .schema file</action> to customise appearance.</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--script</option> <parameter>file</parameter></term> +<listitem><para><action>Allow the use of extended DCOP commands to paste text into sessions.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--workdir</option> <parameter>dir</parameter></term> +<listitem><para><action>Open with</action> <parameter>dir</parameter> as the working folder.</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>-e</option> <parameter>command</parameter></term> +<listitem><para><action>Execute</action> <parameter>command</parameter> instead of shell.</para></listitem> </varlistentry> </variablelist> -<para ->For instance:</para> +<para>For instance:</para> <informalexample> -<screen -><prompt ->bash$</prompt> - <userinput -><command ->konsole</command -><option -> --vt_sz</option> - <parameter -> 90x25</parameter -><option -> --nohist</option -></userinput -></screen> - -<para ->starts a &konsole; window with 90 columns and 25 rows, with no history</para> +<screen><prompt>bash$</prompt> + <userinput><command>konsole</command><option> --vt_sz</option> + <parameter> 90x25</parameter><option> --nohist</option></userinput></screen> + +<para>starts a &konsole; window with 90 columns and 25 rows, with no history</para> </informalexample> -<para ->&konsole; also accepts generic &Qt; and &kde; options:</para> +<para>&konsole; also accepts generic &Qt; and &kde; options:</para> <variablelist> <varlistentry> -<term -><option ->--help-qt</option -></term> -<listitem -><para -><action ->List Qt-specific options</action -></para -></listitem> -</varlistentry> -<varlistentry> -<term -><option ->--help-kde</option -></term> -<listitem -><para -><action ->List KDE-specific options</action -></para -></listitem> -</varlistentry> -<varlistentry> -<term -><option ->--help-all</option -></term> -<listitem -><para -><action ->List all options</action -></para -></listitem> -</varlistentry> -<varlistentry> -<term -><option ->--author</option -></term> -<listitem -><para -><action ->Show the authors' names</action -></para -></listitem> -</varlistentry> -<varlistentry> -<term -><option ->-v,--version</option -></term> -<listitem -><para -><action ->Show the version number</action -></para -></listitem> -</varlistentry> -<varlistentry> -<term -><option ->--license</option -></term> -<listitem -><para -><action ->Show licence information</action -></para -></listitem> +<term><option>--help-qt</option></term> +<listitem><para><action>List Qt-specific options</action></para></listitem> +</varlistentry> +<varlistentry> +<term><option>--help-kde</option></term> +<listitem><para><action>List KDE-specific options</action></para></listitem> +</varlistentry> +<varlistentry> +<term><option>--help-all</option></term> +<listitem><para><action>List all options</action></para></listitem> +</varlistentry> +<varlistentry> +<term><option>--author</option></term> +<listitem><para><action>Show the authors' names</action></para></listitem> +</varlistentry> +<varlistentry> +<term><option>-v,--version</option></term> +<listitem><para><action>Show the version number</action></para></listitem> +</varlistentry> +<varlistentry> +<term><option>--license</option></term> +<listitem><para><action>Show licence information</action></para></listitem> </varlistentry> </variablelist> @@ -2198,38 +742,23 @@ </chapter> <chapter id="credits"> -<title ->Credits and Copyright</title> +<title>Credits and Copyright</title> -<para ->&konsole; is maintained by &Waldo.Bastian; &Waldo.Bastian.mail;</para> +<para>&konsole; is maintained by &Waldo.Bastian; &Waldo.Bastian.mail;</para> -<para ->The application &konsole; Copyright © 1997-2002 &Lars.Doelle; &Lars.Doelle.mail;</para> +<para>The application &konsole; Copyright © 1997-2002 &Lars.Doelle; &Lars.Doelle.mail;</para> -<para ->This document was written by &Jonathan.Singer; &Jonathan.Singer.mail;</para> +<para>This document was written by &Jonathan.Singer; &Jonathan.Singer.mail;</para> -<para ->Originally converted to DocBook <acronym ->SGML</acronym -> by &Mike.McBride; and &Lauri.Watts;</para> +<para>Originally converted to DocBook <acronym>SGML</acronym> by &Mike.McBride; and &Lauri.Watts;</para> -<para ->Conversion to British English: John Knight <email ->anarchist_tomato@herzeleid.net</email -></para -> +<para>Conversion to British English: John Knight <email>anarchist_tomato@herzeleid.net</email></para> &underFDL; &underGPL; </chapter> <appendix id="porting"> -<title ->&konsole; on non-&Linux; platforms</title> +<title>&konsole; on non-&Linux; platforms</title> -<para ->Information on building &konsole; on platforms other than &Linux; is available in the <filename ->README.ports</filename -> file in the &konsole; source package. It provides a list of experts for certain platforms (Tru64, &Solaris;, OpenBSD) and requests volunteers from other &UNIX; platforms.</para> +<para>Information on building &konsole; on platforms other than &Linux; is available in the <filename>README.ports</filename> file in the &konsole; source package. It provides a list of experts for certain platforms (Tru64, &Solaris;, OpenBSD) and requests volunteers from other &UNIX; platforms.</para> </appendix> diff --git a/tde-i18n-en_GB/docs/tdebase/kpager/index.docbook b/tde-i18n-en_GB/docs/tdebase/kpager/index.docbook index 038eb916f0b..59d211a2651 100644 --- a/tde-i18n-en_GB/docs/tdebase/kpager/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kpager/index.docbook @@ -4,262 +4,145 @@ <!ENTITY kappname "&kpager;"> <!ENTITY package "tdebase"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <book lang="&language;"> <bookinfo> -<title ->The &kpager; Handbook</title> +<title>The &kpager; Handbook</title> <authorgroup> -<author ->&Dirk.Doerflinger; &Dirk.Doerflinger.mail;</author> - -<othercredit role="developer" ->&Antonio.Larrosa.Jimenez; &Antonio.Larrosa.Jimenez.mail; </othercredit> - -<othercredit role="developer" ->&Matthias.Elter; &Matthias.Elter.mail; </othercredit> - -<othercredit role="developer" ->&Matthias.Ettrich; &Matthias.Ettrich.mail; </othercredit> - -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Dirk.Doerflinger; &Dirk.Doerflinger.mail;</author> + +<othercredit role="developer">&Antonio.Larrosa.Jimenez; &Antonio.Larrosa.Jimenez.mail; </othercredit> + +<othercredit role="developer">&Matthias.Elter; &Matthias.Elter.mail; </othercredit> + +<othercredit role="developer">&Matthias.Ettrich; &Matthias.Ettrich.mail; </othercredit> + +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->2000</year> -<holder ->&Dirk.Doerflinger;</holder> +<year>2000</year> +<holder>&Dirk.Doerflinger;</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2001-01-28</date> -<releaseinfo ->0.02.00</releaseinfo> +<date>2001-01-28</date> +<releaseinfo>0.02.00</releaseinfo> <abstract> -<para ->&kpager; gives you a thumbnail view of all virtual desktops. </para> +<para>&kpager; gives you a thumbnail view of all virtual desktops. </para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->pager</keyword> -<keyword ->kpager</keyword> -<keyword ->desktop</keyword> -<keyword ->overview</keyword> +<keyword>KDE</keyword> +<keyword>pager</keyword> +<keyword>kpager</keyword> +<keyword>desktop</keyword> +<keyword>overview</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->&kpager; gives you a thumbnail sketch of all your desktops. It is a handy tool to let you see, resize or close windows on any desktop and move windows around within or between desktops. </para> +<para>&kpager; gives you a thumbnail sketch of all your desktops. It is a handy tool to let you see, resize or close windows on any desktop and move windows around within or between desktops. </para> </chapter> <chapter id="using-kpager"> -<title ->Using &kpager;</title> +<title>Using &kpager;</title> <screenshot> -<screeninfo ->Here's a screenshot of &kpager;</screeninfo> +<screeninfo>Here's a screenshot of &kpager;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="screenshot.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Screenshot</phrase> + <phrase>Screenshot</phrase> </textobject> </mediaobject> </screenshot> <sect1 id="kpager-features"> -<title ->More &kpager; features</title> +<title>More &kpager; features</title> -<para ->&kpager; can show all virtual desktops and the applications within them. It can be used to chose an application or even to move applications within virtual desktops or to others.</para> +<para>&kpager; can show all virtual desktops and the applications within them. It can be used to chose an application or even to move applications within virtual desktops or to others.</para> </sect1> </chapter> <chapter id="commands"> -<title ->Command Reference</title> +<title>Command Reference</title> <sect1 id="kpager-mainwindow"> -<title ->The main &kpager; window</title> +<title>The main &kpager; window</title> <sect2> -<title ->Using the mouse</title> +<title>Using the mouse</title> -<para ->In &kpager; you can activate applications by clicking them with the <mousebutton ->left</mousebutton -> button.</para> +<para>In &kpager; you can activate applications by clicking them with the <mousebutton>left</mousebutton> button.</para> -<para ->The <mousebutton ->middle</mousebutton -> button of the mouse can be used for dragging applications within &kpager;. Applications can either be moved within a virtual desktop or to another one.</para -> +<para>The <mousebutton>middle</mousebutton> button of the mouse can be used for dragging applications within &kpager;. Applications can either be moved within a virtual desktop or to another one.</para> -<para ->Clicking the <mousebutton ->right</mousebutton -> mouse button anywhere in &kpager; will open a context menu.</para> +<para>Clicking the <mousebutton>right</mousebutton> mouse button anywhere in &kpager; will open a context menu.</para> </sect2> <sect2> -<title ->The Context Menu</title> - -<para ->The context menu depends on where the <mousebutton ->right</mousebutton -> mouse button is clicked: If it is clicked on the empty background of &kpager;, it only has two items: <guimenuitem ->Configure KPager</guimenuitem -> and <guimenuitem ->Quit</guimenuitem ->. Otherwise, if clicked on a window, there are also the name and the icon of the application, and <guimenuitem ->Minimise</guimenuitem ->, <guimenuitem ->Maximise</guimenuitem ->, <guimenuitem ->To Desktop</guimenuitem -> and <guimenuitem ->Close</guimenuitem -> are displayed. See below for a detailed description of the menu items.</para> +<title>The Context Menu</title> + +<para>The context menu depends on where the <mousebutton>right</mousebutton> mouse button is clicked: If it is clicked on the empty background of &kpager;, it only has two items: <guimenuitem>Configure KPager</guimenuitem> and <guimenuitem>Quit</guimenuitem>. Otherwise, if clicked on a window, there are also the name and the icon of the application, and <guimenuitem>Minimise</guimenuitem>, <guimenuitem>Maximise</guimenuitem>, <guimenuitem>To Desktop</guimenuitem> and <guimenuitem>Close</guimenuitem> are displayed. See below for a detailed description of the menu items.</para> <variablelist> <varlistentry> -<term -><menuchoice> -<guimenuitem ->Maximise</guimenuitem> -</menuchoice -></term> -<listitem -><para -><action ->Maximises the application window to the whole desktop. This item only appears if right clicked on an application window.</action -></para -></listitem> +<term><menuchoice> +<guimenuitem>Maximise</guimenuitem> +</menuchoice></term> +<listitem><para><action>Maximises the application window to the whole desktop. This item only appears if right clicked on an application window.</action></para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice> -<guimenuitem ->Minimise</guimenuitem> -</menuchoice -></term> -<listitem -><para -><action ->Iconifies the application. This item only appears if right clicked on an application window.</action -></para -></listitem> +<term><menuchoice> +<guimenuitem>Minimise</guimenuitem> +</menuchoice></term> +<listitem><para><action>Iconifies the application. This item only appears if right clicked on an application window.</action></para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice> -<guimenuitem ->To Desktop</guimenuitem> -</menuchoice -></term> -<listitem -><para -><action ->Sends the application window to the chosen virtual desktop. This item only appears if right clicked on an application window.</action -></para -></listitem> +<term><menuchoice> +<guimenuitem>To Desktop</guimenuitem> +</menuchoice></term> +<listitem><para><action>Sends the application window to the chosen virtual desktop. This item only appears if right clicked on an application window.</action></para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice> -<guimenuitem ->Close</guimenuitem> -</menuchoice -></term> -<listitem -><para -><action ->Closes the clicked application. This item only appears if right clicked on an application window.</action -></para -></listitem> +<term><menuchoice> +<guimenuitem>Close</guimenuitem> +</menuchoice></term> +<listitem><para><action>Closes the clicked application. This item only appears if right clicked on an application window.</action></para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice> -<guimenuitem ->Configure Pager</guimenuitem> -</menuchoice -></term> -<listitem -><para -><action ->Opens</action -> the <link linkend="kpager-settings" ->settings dialogue</link ->.</para -></listitem> +<term><menuchoice> +<guimenuitem>Configure Pager</guimenuitem> +</menuchoice></term> +<listitem><para><action>Opens</action> the <link linkend="kpager-settings">settings dialogue</link>.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice> -<guimenuitem ->Quit</guimenuitem> -</menuchoice -></term> -<listitem -><para -><action ->Quits</action -> &kpager;.</para -></listitem> +<term><menuchoice> +<guimenuitem>Quit</guimenuitem> +</menuchoice></term> +<listitem><para><action>Quits</action> &kpager;.</para></listitem> </varlistentry> </variablelist> @@ -268,121 +151,56 @@ </sect1> <sect1 id="kpager-settings"> -<title ->The Settings Dialogue</title> +<title>The Settings Dialogue</title> <screenshot> -<screeninfo ->Here's a screenshot of the settings dialogue</screeninfo> +<screeninfo>Here's a screenshot of the settings dialogue</screeninfo> <mediaobject> <imageobject> <imagedata fileref="settings.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Screenshot</phrase> + <phrase>Screenshot</phrase> </textobject> </mediaobject> </screenshot> -<para ->In the settings dialogue you will find five check boxes and two groups of radio buttons.</para> +<para>In the settings dialogue you will find five check boxes and two groups of radio buttons.</para> <variablelist> <varlistentry> -<term -><guilabel ->Enable Window Dragging</guilabel -></term> -<listitem -><para ->If this box is checked, you can drag windows inside of &kpager; with the &MMB;. Windows can be dragged over the desktop or even to another desktop.</para -></listitem> +<term><guilabel>Enable Window Dragging</guilabel></term> +<listitem><para>If this box is checked, you can drag windows inside of &kpager; with the &MMB;. Windows can be dragged over the desktop or even to another desktop.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Show Name</guilabel -></term> -<listitem -><para ->If this box is checked, the names of the desktops are shown in the main view of &kpager;.</para -></listitem> +<term><guilabel>Show Name</guilabel></term> +<listitem><para>If this box is checked, the names of the desktops are shown in the main view of &kpager;.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Show Number</guilabel -></term> -<listitem -><para ->If this box is checked, the numbers of the desktops are shown in the main view of &kpager;. If it is checked together with the <guilabel ->Show Name</guilabel -> box, the name is displayed with ordinals, <abbrev ->e.g.</abbrev -> <guilabel ->1. Desktop</guilabel ->.</para -></listitem -> +<term><guilabel>Show Number</guilabel></term> +<listitem><para>If this box is checked, the numbers of the desktops are shown in the main view of &kpager;. If it is checked together with the <guilabel>Show Name</guilabel> box, the name is displayed with ordinals, <abbrev>e.g.</abbrev> <guilabel>1. Desktop</guilabel>.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Show Background</guilabel -></term> -<listitem -><para ->If this box is checked, the wallpaper of each desktop - if set - will be shown as backgrounds in &kpager;, too.</para -></listitem> +<term><guilabel>Show Background</guilabel></term> +<listitem><para>If this box is checked, the wallpaper of each desktop - if set - will be shown as backgrounds in &kpager;, too.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Show Windows</guilabel -></term> -<listitem -><para ->If this box is checked, the applications on the desktops are shown in &kpager; as small views. Otherwise, &kpager; will remain empty, just for choosing the virtual desktops.</para -></listitem> +<term><guilabel>Show Windows</guilabel></term> +<listitem><para>If this box is checked, the applications on the desktops are shown in &kpager; as small views. Otherwise, &kpager; will remain empty, just for choosing the virtual desktops.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Type of Window</guilabel -></term> -<listitem -><para ->This group of radio buttons sets the kind of view for the application window views. <guilabel ->Plain</guilabel -> will show just empty rectangles with the proportions of the application window, <guilabel ->Icon</guilabel -> will show them with their standard icon and <guilabel ->Pixmap</guilabel -> with a small view of the contents of the application window. Note that using the pixmap mode is only recommended for very fast machines.</para -></listitem> +<term><guilabel>Type of Window</guilabel></term> +<listitem><para>This group of radio buttons sets the kind of view for the application window views. <guilabel>Plain</guilabel> will show just empty rectangles with the proportions of the application window, <guilabel>Icon</guilabel> will show them with their standard icon and <guilabel>Pixmap</guilabel> with a small view of the contents of the application window. Note that using the pixmap mode is only recommended for very fast machines.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Layout</guilabel -></term> -<listitem -><para ->In this group the layout of the &kpager; main view can be set. <guilabel ->Classical</guilabel -> will show &kpager; in a 2xn grid like pager applications in some other window managers, <guilabel ->Horizontal</guilabel -> will show the virtual desktops in a horizontal view and <guilabel ->Vertical</guilabel -> in a vertical row, which may perfectly fit on the side of the desktop.</para -></listitem> +<term><guilabel>Layout</guilabel></term> +<listitem><para>In this group the layout of the &kpager; main view can be set. <guilabel>Classical</guilabel> will show &kpager; in a 2xn grid like pager applications in some other window managers, <guilabel>Horizontal</guilabel> will show the virtual desktops in a horizontal view and <guilabel>Vertical</guilabel> in a vertical row, which may perfectly fit on the side of the desktop.</para></listitem> </varlistentry> </variablelist> @@ -391,61 +209,35 @@ </chapter> <chapter id="faq"> -<title ->Questions and Answers</title> +<title>Questions and Answers</title> <qandaset id="faq-questions"> <qandaentry> <question> -<para ->Why could I need &kpager;?</para> +<para>Why could I need &kpager;?</para> </question> -<answer -><para ->&kpager; can be used as an alternative to the pager applet in the panel. It has the advantage of being resizeable and within this able to show icon or pixmap views of the running applications, move the windows across desktops and run outside of the panel.</para -></answer> +<answer><para>&kpager; can be used as an alternative to the pager applet in the panel. It has the advantage of being resizeable and within this able to show icon or pixmap views of the running applications, move the windows across desktops and run outside of the panel.</para></answer> </qandaentry> <qandaentry> <question> -<para ->How can I change the behaviour of &kpager;?</para> +<para>How can I change the behaviour of &kpager;?</para> </question> -<answer -><para ->Clicking the <mousebutton ->right</mousebutton -> mouse button anywhere within &kpager; lets you chose <guilabel ->Configure</guilabel -> from the context menu for displaying the <link linkend="kpager-settings" ->settings dialogue</link -></para> +<answer><para>Clicking the <mousebutton>right</mousebutton> mouse button anywhere within &kpager; lets you chose <guilabel>Configure</guilabel> from the context menu for displaying the <link linkend="kpager-settings">settings dialogue</link></para> </answer> </qandaentry> <qandaentry> <question> -<para ->Windows are transparent by default, how do I turn this off?</para> +<para>Windows are transparent by default, how do I turn this off?</para> </question> <answer> -<para ->Currently, you cannot turn that option off within the config dialogue, but you can do it manually like this:</para> - -<para ->Open the file <filename ->$TDEHOME/share/config/kpagerrc</filename -> with any text editor like &kedit; or <application ->vi</application ->. If you have no rights to write that file, you may need to do it as root or contact your system administrator. In this file you will have to add a new key with the name <userinput ->windowTransparentMode</userinput -> with a number as value. Values are:</para> +<para>Currently, you cannot turn that option off within the config dialogue, but you can do it manually like this:</para> + +<para>Open the file <filename>$TDEHOME/share/config/kpagerrc</filename> with any text editor like &kedit; or <application>vi</application>. If you have no rights to write that file, you may need to do it as root or contact your system administrator. In this file you will have to add a new key with the name <userinput>windowTransparentMode</userinput> with a number as value. Values are:</para> <simplelist> -<member ->0 - No transparent windows at all.</member> -<member ->1 - Only maximised windows are transparent.</member> -<member ->2 - all windows are transparent (default).</member> +<member>0 - No transparent windows at all.</member> +<member>1 - Only maximised windows are transparent.</member> +<member>2 - all windows are transparent (default).</member> </simplelist> </answer> @@ -456,44 +248,31 @@ <chapter id="credits"> -<title ->Credits and Licence</title> +<title>Credits and Licence</title> -<para ->&kpager; </para> +<para>&kpager; </para> -<para ->Program copyright 2000 Antonio Larrosa <email ->larrosa@kde.org</email -> </para> +<para>Program copyright 2000 Antonio Larrosa <email>larrosa@kde.org</email> </para> -<para ->Documentation copyright 2000 by Dirk Doerflinger <email ->ddoerflinger@web.de</email -> </para> +<para>Documentation copyright 2000 by Dirk Doerflinger <email>ddoerflinger@web.de</email> </para> &underFDL; &underGPL; </chapter> <appendix id="installation"> -<title ->Installation</title> +<title>Installation</title> <sect1 id="getting-kpager"> -<title ->How to obtain &kpager;</title> +<title>How to obtain &kpager;</title> &install.intro.documentation; </sect1> <sect1 id="requirements"> -<title ->Requirements</title> +<title>Requirements</title> -<para ->As &kpager; is part of the &package; package, you will just need an installation of the main &kde; packages.</para> +<para>As &kpager; is part of the &package; package, you will just need an installation of the main &kde; packages.</para> </sect1> <sect1 id="compilation"> -<title ->Compilation and Installation</title> +<title>Compilation and Installation</title> &install.compile.documentation; </sect1> </appendix> diff --git a/tde-i18n-en_GB/docs/tdebase/ksplashml/index.docbook b/tde-i18n-en_GB/docs/tdebase/ksplashml/index.docbook index 7308d911061..2b3c23b5f52 100644 --- a/tde-i18n-en_GB/docs/tdebase/ksplashml/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/ksplashml/index.docbook @@ -9,200 +9,98 @@ <book lang="&language;"> <bookinfo> -<title ->The &ksplash; Handbook</title> +<title>The &ksplash; Handbook</title> <authorgroup> -<author ->&Teemu.Rytilahti; &Teemu.Rytilahti.mail; </author> - -<othercredit role="developer" ->&Brian.C.Ledbetter; &Brian.C.Ledbetter.mail; </othercredit> - -<othercredit role="developer" ->&Ravikiran.Rajagopal; &Ravikiran.Rajagopal.mail; </othercredit> - -<othercredit role="translator" -><firstname ->Jonathan</firstname -><surname ->Riddell</surname -><affiliation -><address -><email ->kde-en-gb@jriddell.org</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Teemu.Rytilahti; &Teemu.Rytilahti.mail; </author> + +<othercredit role="developer">&Brian.C.Ledbetter; &Brian.C.Ledbetter.mail; </othercredit> + +<othercredit role="developer">&Ravikiran.Rajagopal; &Ravikiran.Rajagopal.mail; </othercredit> + +<othercredit role="translator"><firstname>Jonathan</firstname><surname>Riddell</surname><affiliation><address><email>kde-en-gb@jriddell.org</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->2003</year> -<holder ->Teemu Rytilahti</holder> +<year>2003</year> +<holder>Teemu Rytilahti</holder> </copyright> <copyright> -<year ->2003-04</year> -<holder ->Ravikiran Rajagopal</holder> +<year>2003-04</year> +<holder>Ravikiran Rajagopal</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2003-01-10</date> -<releaseinfo ->1.01.00</releaseinfo> +<date>2003-01-10</date> +<releaseinfo>1.01.00</releaseinfo> <abstract> -<para ->&ksplash; is a nice splash screen that shows the progress of an application that is loading.</para> +<para>&ksplash; is a nice splash screen that shows the progress of an application that is loading.</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->tdebase</keyword> -<keyword ->ksplash</keyword> -<keyword ->ksplashml</keyword> -<keyword ->splashscreen</keyword> -<keyword ->eye candy</keyword> +<keyword>KDE</keyword> +<keyword>tdebase</keyword> +<keyword>ksplash</keyword> +<keyword>ksplashml</keyword> +<keyword>splashscreen</keyword> +<keyword>eye candy</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->&ksplash; is a nice splash screen that shows the progress of an application that is loading. Please report any problems or feature requests to the &kde; mailing lists. The principal features of &ksplash;: </para> +<para>&ksplash; is a nice splash screen that shows the progress of an application that is loading. Please report any problems or feature requests to the &kde; mailing lists. The principal features of &ksplash;: </para> <simplelist> -<member ->Themeable</member> -<member ->Uses plugins to be completely customisable</member> -<member ->Can be used by any application that uses DCOP</member> +<member>Themeable</member> +<member>Uses plugins to be completely customisable</member> +<member>Can be used by any application that uses DCOP</member> </simplelist> -<para ->This handbook will show you how to create themes for use with plugins that are already available. If none of the plugins available satisfy your tastes, you can learn how to customise the appearance of &ksplash; completely by writing a plugin in C++. </para> +<para>This handbook will show you how to create themes for use with plugins that are already available. If none of the plugins available satisfy your tastes, you can learn how to customise the appearance of &ksplash; completely by writing a plugin in C++. </para> </chapter> <chapter id="using-themes"> -<title ->Using themes</title> - -<para ->To use themes from <ulink url="http://www.kde-look.org" ->KDE-Look</ulink ->, extract them to <filename ->~/.trinity/share/apps/ksplash/Themes/</filename -> for a single user, or to <filename ->$<envar ->TDEDIR</envar ->/share/apps/ksplash/Themes/</filename -> to make them available to all users of your system.</para> - -<para ->You can also use the <guilabel ->Splash Screen</guilabel -> module under <guilabel ->Appearance</guilabel -> in the &kde; control centre to do this automatically.</para> +<title>Using themes</title> + +<para>To use themes from <ulink url="http://www.kde-look.org">KDE-Look</ulink>, extract them to <filename>~/.trinity/share/apps/ksplash/Themes/</filename> for a single user, or to <filename>$<envar>TDEDIR</envar>/share/apps/ksplash/Themes/</filename> to make them available to all users of your system.</para> + +<para>You can also use the <guilabel>Splash Screen</guilabel> module under <guilabel>Appearance</guilabel> in the &kde; control centre to do this automatically.</para> <sect1 id="using-kcontrol-module"> -<title ->Using the &kcontrol; Module</title> - -<para ->This module allows you to install, test and remove &ksplash; themes.</para> - -<para ->Down the side of the module is a list of currently available &ksplash; themes. As you select one, a preview will display in the main part of the window. When you have selected the one you wish to use, press <guibutton ->OK</guibutton -> or <guibutton ->Apply</guibutton ->. Press <guibutton ->Cancel</guibutton -> to exit the module without making changes, and <guibutton ->Defaults</guibutton -> to restore the system default splash screen.</para> - -<para ->To install new modules, press <guibutton ->Add...</guibutton ->, and find the theme on your computer. You do not have to unpack theme files, you can safely select the compressed theme file. Installing a theme does not make it the theme in use until you select it in the list and press either <guibutton ->OK</guibutton -> or <guibutton ->Apply</guibutton ->.</para> - -<para ->Although you can see a preview of the splash screen, you may like to see how it looks in real use, for instance to see what the animation looks like. You can test themes by selecting them in the list and clicking the <guibutton ->Test</guibutton -> button.</para> - -<para ->You can also remove themes you no longer wish to use, by selecting them and pressing the <guibutton ->Remove</guibutton -> button. Note that your user account may not have the right to remove themes installed system-wide. It is also recommended you do not uninstall the <guilabel ->Default</guilabel -> splash screen.</para> +<title>Using the &kcontrol; Module</title> + +<para>This module allows you to install, test and remove &ksplash; themes.</para> + +<para>Down the side of the module is a list of currently available &ksplash; themes. As you select one, a preview will display in the main part of the window. When you have selected the one you wish to use, press <guibutton>OK</guibutton> or <guibutton>Apply</guibutton>. Press <guibutton>Cancel</guibutton> to exit the module without making changes, and <guibutton>Defaults</guibutton> to restore the system default splash screen.</para> + +<para>To install new modules, press <guibutton>Add...</guibutton>, and find the theme on your computer. You do not have to unpack theme files, you can safely select the compressed theme file. Installing a theme does not make it the theme in use until you select it in the list and press either <guibutton>OK</guibutton> or <guibutton>Apply</guibutton>.</para> + +<para>Although you can see a preview of the splash screen, you may like to see how it looks in real use, for instance to see what the animation looks like. You can test themes by selecting them in the list and clicking the <guibutton>Test</guibutton> button.</para> + +<para>You can also remove themes you no longer wish to use, by selecting them and pressing the <guibutton>Remove</guibutton> button. Note that your user account may not have the right to remove themes installed system-wide. It is also recommended you do not uninstall the <guilabel>Default</guilabel> splash screen.</para> </sect1> </chapter> <chapter id="themes"> -<title ->How to make themes for &ksplash;</title> +<title>How to make themes for &ksplash;</title> <sect1 id="themes-general"> -<title ->General</title> -<para ->Making your own themes for &ksplash; is easy. After you have finished your themes you can post them on the <ulink url="http://www.kde-look.org" ->KDE-Look</ulink -> so that others can use it.</para> +<title>General</title> +<para>Making your own themes for &ksplash; is easy. After you have finished your themes you can post them on the <ulink url="http://www.kde-look.org">KDE-Look</ulink> so that others can use it.</para> <sect2 id="theme-syntax"> -<title ->Identifying your theme</title> - -<para ->Let us create a theme called <literal ->MyCoolTheme</literal ->. For the theme to be recognised by &ksplash;, it should be stored in a folder called <filename class="directory" ->MyCoolTheme</filename -> under <filename class="directory" ->~/.trinity/apps/ksplash/Themes/</filename ->. It should have a file called <filename ->Theme.rc</filename ->, containing the settings of the theme. You can specify large numbers of special things to theme, change the plugin engine to use, and so on. You do not have to use all the settings available; usually, the settings have an acceptable default value. The basic syntax for entries in the <filename ->Theme.rc</filename -> file is <literal ->[option] = [value]</literal -> You can find the definitions of the various options in the following sections.</para> +<title>Identifying your theme</title> + +<para>Let us create a theme called <literal>MyCoolTheme</literal>. For the theme to be recognised by &ksplash;, it should be stored in a folder called <filename class="directory">MyCoolTheme</filename> under <filename class="directory">~/.trinity/apps/ksplash/Themes/</filename>. It should have a file called <filename>Theme.rc</filename>, containing the settings of the theme. You can specify large numbers of special things to theme, change the plugin engine to use, and so on. You do not have to use all the settings available; usually, the settings have an acceptable default value. The basic syntax for entries in the <filename>Theme.rc</filename> file is <literal>[option] = [value]</literal> You can find the definitions of the various options in the following sections.</para> <example> -<title ->Simple <filename ->Theme.rc</filename -> file</title> -<programlisting ->[KSplash Theme: MyCoolTheme] +<title>Simple <filename>Theme.rc</filename> file</title> +<programlisting>[KSplash Theme: MyCoolTheme] Name = MyCoolTheme Description = A nice theme using XpLike engine Version = 1.0 @@ -214,176 +112,107 @@ Welcome Text = Loading KDE </programlisting> </example> -<para ->After specifying the name, the description and the author of the theme, you should first choose a theme engine (also known as a plugin). Then, you can customise various features of the theme engine by assigning key-value pairs as in the example file above.</para> +<para>After specifying the name, the description and the author of the theme, you should first choose a theme engine (also known as a plugin). Then, you can customise various features of the theme engine by assigning key-value pairs as in the example file above.</para> -<para ->It is important that the name of the directory under which the theme files are stored (<filename class="directory" ->~/.trinity/apps/ksplash/Themes/MyCoolTheme</filename -> in our case) and the identifier (<literal ->[KSplash Theme: MyCoolTheme] </literal -> in our case) of the theme in the <filename ->Theme.rc</filename -> file are identical. Otherwise, &ksplash; will not recognise the theme. </para> +<para>It is important that the name of the directory under which the theme files are stored (<filename class="directory">~/.trinity/apps/ksplash/Themes/MyCoolTheme</filename> in our case) and the identifier (<literal>[KSplash Theme: MyCoolTheme] </literal> in our case) of the theme in the <filename>Theme.rc</filename> file are identical. Otherwise, &ksplash; will not recognise the theme. </para> </sect2> <sect2 id="theme-files"> -<title ->Background files</title> - -<para ->When &ksplash; starts, it tries to find a background image for your current screen resolution, if the theme engine uses one. The background image file should be named in the following format: <filename ->Background-<replaceable ->WWWxHHH</replaceable ->.png</filename ->.</para> - -<para ->For example, you might use a file called <filename ->Background-1024x768</filename ->. If the background image for your screen resolution cannot be found, it tries to resize the original <filename ->Background.png</filename -> or the file specified in <filename ->Theme.rc</filename -> to suit the current resolution. Resizing on-the-fly will certainly take some time, so you should provide background images for at least the following sizes: 1280x1024, 1024x768 and 800x600.</para> +<title>Background files</title> + +<para>When &ksplash; starts, it tries to find a background image for your current screen resolution, if the theme engine uses one. The background image file should be named in the following format: <filename>Background-<replaceable>WWWxHHH</replaceable>.png</filename>.</para> + +<para>For example, you might use a file called <filename>Background-1024x768</filename>. If the background image for your screen resolution cannot be found, it tries to resize the original <filename>Background.png</filename> or the file specified in <filename>Theme.rc</filename> to suit the current resolution. Resizing on-the-fly will certainly take some time, so you should provide background images for at least the following sizes: 1280x1024, 1024x768 and 800x600.</para> </sect2> </sect1> <sect1 id="theme-engines"> -<title ->Options for Theme Engines</title> +<title>Options for Theme Engines</title> <sect2 id="standard-themes"> -<title ->Standard Theme</title> +<title>Standard Theme</title> <table> -<title ->Standard Theme Options</title> +<title>Standard Theme Options</title> <tgroup cols="3"> <tbody> <row> -<entry ->Name</entry> -<entry ->Argument</entry> -<entry ->Explanation</entry> +<entry>Name</entry> +<entry>Argument</entry> +<entry>Explanation</entry> </row> <!-- Statusbar --> <row> -<entry ->Statusbar Position</entry> -<entry ->[top/bottom]</entry> -<entry ->Toggles the position of the statusbar on the screen. Default is bottom.</entry> +<entry>Statusbar Position</entry> +<entry>[top/bottom]</entry> +<entry>Toggles the position of the statusbar on the screen. Default is bottom.</entry> </row> <row> -<entry ->Statusbar Visible</entry> -<entry ->[true/false]</entry> -<entry ->Indicates whether the statusbar should be shown. Default is true.</entry> +<entry>Statusbar Visible</entry> +<entry>[true/false]</entry> +<entry>Indicates whether the statusbar should be shown. Default is true.</entry> </row> <row> -<entry ->Progress Visible</entry> -<entry ->[true/false]</entry> -<entry ->Indicates whether loading progress should be shown. Default is true.</entry> +<entry>Progress Visible</entry> +<entry>[true/false]</entry> +<entry>Indicates whether loading progress should be shown. Default is true.</entry> </row> <!-- Fonts --> <row> -<entry ->Statusbar Font</entry> -<entry ->[fontname]</entry> -<entry ->The font used in statusbar. Default is Helvetica.</entry> +<entry>Statusbar Font</entry> +<entry>[fontname]</entry> +<entry>The font used in statusbar. Default is Helvetica.</entry> </row> <row> -<entry ->Statusbar Font Size</entry> -<entry ->[size]</entry> -<entry ->The font size for the statusbar. Default is 16.</entry> +<entry>Statusbar Font Size</entry> +<entry>[size]</entry> +<entry>The font size for the statusbar. Default is 16.</entry> </row> <row> -<entry ->Statusbar Font Bold</entry> -<entry ->[true/false]</entry> -<entry ->Indicates whether the statusbar font should be bold. Default is true.</entry> +<entry>Statusbar Font Bold</entry> +<entry>[true/false]</entry> +<entry>Indicates whether the statusbar font should be bold. Default is true.</entry> </row> <row> -<entry ->Statusbar Font Italic</entry> -<entry ->[true/false]</entry> -<entry ->Indicates whether the statusbar font should be italic. Default is false.</entry> +<entry>Statusbar Font Italic</entry> +<entry>[true/false]</entry> +<entry>Indicates whether the statusbar font should be italic. Default is false.</entry> </row> <!-- Misc. things --> <row> -<entry ->Statusbar Foreground</entry> -<entry ->[color]</entry> -<entry ->The foreground colour of statusbar. Default is white.</entry> +<entry>Statusbar Foreground</entry> +<entry>[color]</entry> +<entry>The foreground colour of statusbar. Default is white.</entry> </row> <row> -<entry ->Statusbar Background</entry> -<entry ->[color]</entry> -<entry ->The background colour of statusbar. Default is black.</entry> +<entry>Statusbar Background</entry> +<entry>[color]</entry> +<entry>The background colour of statusbar. Default is black.</entry> </row> <row> -<entry ->Statusbar Icon</entry> -<entry ->[true/false]</entry> -<entry ->Indicates whether the statusbar should have an icon.</entry> +<entry>Statusbar Icon</entry> +<entry>[true/false]</entry> +<entry>Indicates whether the statusbar should have an icon.</entry> </row> <row> -<entry ->Icons Visible</entry> -<entry ->[true/false]</entry> -<entry ->Indicates whether icons should be visible. Default is true.</entry> +<entry>Icons Visible</entry> +<entry>[true/false]</entry> +<entry>Indicates whether icons should be visible. Default is true.</entry> </row> <row> -<entry ->Icons Jumping</entry> -<entry ->[true/false]</entry> -<entry ->Indicates whether icons should be jumping. Default is true.</entry> +<entry>Icons Jumping</entry> +<entry>[true/false]</entry> +<entry>Indicates whether icons should be jumping. Default is true.</entry> </row> <row> -<entry ->Icon Position</entry> -<entry ->[0-3,10-13]</entry> -<entry ->Position where the icons are shown. Default is bottom-left.</entry> +<entry>Icon Position</entry> +<entry>[0-3,10-13]</entry> +<entry>Position where the icons are shown. Default is bottom-left.</entry> </row> <row> -<entry ->Splash Screen</entry> -<entry ->[name]</entry> -<entry ->Changes the splash screen image that is shown.</entry> +<entry>Splash Screen</entry> +<entry>[name]</entry> +<entry>Changes the splash screen image that is shown.</entry> </row> </tbody> </tgroup> @@ -391,137 +220,88 @@ Welcome Text = Loading KDE </sect2> <sect2 id="redmond-themes"> -<title ->Redmond theme</title> +<title>Redmond theme</title> <table> -<title ->Redmond theme options</title> +<title>Redmond theme options</title> <tgroup cols="3"> <tbody> <row> -<entry ->Name</entry> -<entry ->Argument</entry> -<entry ->Explanation</entry> +<entry>Name</entry> +<entry>Argument</entry> +<entry>Explanation</entry> </row> <!-- Main elements --> <row> -<entry ->Background Image</entry> -<entry ->[filename]</entry> -<entry ->User defined background image to use.</entry> +<entry>Background Image</entry> +<entry>[filename]</entry> +<entry>User defined background image to use.</entry> </row> <row> -<entry ->User Icon</entry> -<entry ->[Iconname]</entry> -<entry ->Name of standard icon to show for user. Default is <constant ->go</constant ->.</entry> +<entry>User Icon</entry> +<entry>[Iconname]</entry> +<entry>Name of standard icon to show for user. Default is <constant>go</constant>.</entry> </row> <row> -<entry ->Welcome Text</entry> -<entry ->[text]</entry> -<entry ->Text shown in splash screen. Default is "Welcome".</entry> +<entry>Welcome Text</entry> +<entry>[text]</entry> +<entry>Text shown in splash screen. Default is "Welcome".</entry> </row> <row> -<entry ->Username Text</entry> -<entry ->[text]</entry> -<entry ->Text shown instead of user's real name.</entry> +<entry>Username Text</entry> +<entry>[text]</entry> +<entry>Text shown instead of user's real name.</entry> </row> <!-- Positioning elements --> <row> -<entry ->Welcome Text Position</entry> -<entry ->[x,y]</entry> -<entry ->Position on the screen where the Welcome Text is shown.</entry> +<entry>Welcome Text Position</entry> +<entry>[x,y]</entry> +<entry>Position on the screen where the Welcome Text is shown.</entry> </row> <row> -<entry ->Username Text Position</entry> -<entry ->[x,y]</entry> -<entry ->Position on the screen where the username is shown.</entry> +<entry>Username Text Position</entry> +<entry>[x,y]</entry> +<entry>Position on the screen where the username is shown.</entry> </row> <row> -<entry ->Action Text Position</entry> -<entry ->[x,y]</entry> -<entry ->Position on the screen where the current action is shown.</entry> +<entry>Action Text Position</entry> +<entry>[x,y]</entry> +<entry>Position on the screen where the current action is shown.</entry> </row> <row> -<entry ->Icon Position</entry> -<entry ->[x,y]</entry> -<entry ->Position on the screen where the user icon is shown.</entry> +<entry>Icon Position</entry> +<entry>[x,y]</entry> +<entry>Position on the screen where the user icon is shown.</entry> </row> <!-- Show to show.. --> <row> -<entry ->Show Welcome Text</entry> -<entry ->[true/false]</entry> -<entry ->Toggles showing of welcome text. Default is true.</entry> +<entry>Show Welcome Text</entry> +<entry>[true/false]</entry> +<entry>Toggles showing of welcome text. Default is true.</entry> </row> <row> -<entry ->Show Welcome Shadow</entry> -<entry ->[true/false]</entry> -<entry ->Toggles showing of welcome text's shadow. Default is true.</entry> +<entry>Show Welcome Shadow</entry> +<entry>[true/false]</entry> +<entry>Toggles showing of welcome text's shadow. Default is true.</entry> </row> <row> -<entry ->Show Username</entry> -<entry ->[true/false]</entry> -<entry ->Toggles showing of username. Default is true.</entry> +<entry>Show Username</entry> +<entry>[true/false]</entry> +<entry>Toggles showing of username. Default is true.</entry> </row> <row> -<entry ->Show Action</entry> -<entry ->[true/false]</entry> -<entry ->Toggles showing of action currently being performed. Default is true.</entry> +<entry>Show Action</entry> +<entry>[true/false]</entry> +<entry>Toggles showing of action currently being performed. Default is true.</entry> </row> <row> -<entry ->Show Icon</entry> -<entry ->[true/false]</entry> -<entry ->Indicates whether icon should be shown. Default is true</entry> +<entry>Show Icon</entry> +<entry>[true/false]</entry> +<entry>Indicates whether icon should be shown. Default is true</entry> </row> <row> -<entry ->Use TDM User Icon</entry> -<entry ->[true/false]</entry> -<entry ->Show user's login icon. Default is true.</entry> +<entry>Use TDM User Icon</entry> +<entry>[true/false]</entry> +<entry>Show user's login icon. Default is true.</entry> </row> </tbody> </tgroup> @@ -529,68 +309,45 @@ Welcome Text = Loading KDE </sect2> <sect2 id="macx-themes"> -<title ->MacX Theme</title> +<title>MacX Theme</title> <table> -<title ->MacX Theme Options</title> +<title>MacX Theme Options</title> <tgroup cols="3"> <tbody> <row> -<entry ->Name</entry> -<entry ->Argument</entry> -<entry ->Explanation</entry> +<entry>Name</entry> +<entry>Argument</entry> +<entry>Explanation</entry> </row> <row> -<entry ->Icon Size Minimum</entry> -<entry ->[size]</entry> -<entry ->Assign the minimum size for icons. Default is 16.</entry> +<entry>Icon Size Minimum</entry> +<entry>[size]</entry> +<entry>Assign the minimum size for icons. Default is 16.</entry> </row> <row> -<entry ->Icon Size Maximum</entry> -<entry ->[size]</entry> -<entry ->Assign the maximum size for icons. Default is 64.</entry> +<entry>Icon Size Maximum</entry> +<entry>[size]</entry> +<entry>Assign the maximum size for icons. Default is 64.</entry> </row> <row> -<entry ->Optimised Icon Rendering</entry> -<entry ->[true/false]</entry> -<entry ->Optimise icon rendering. Default is true.</entry> +<entry>Optimised Icon Rendering</entry> +<entry>[true/false]</entry> +<entry>Optimise icon rendering. Default is true.</entry> </row> <row> -<entry ->Progress Bar Visible</entry> -<entry ->[true/false]</entry> -<entry ->Default is true.</entry> +<entry>Progress Bar Visible</entry> +<entry>[true/false]</entry> +<entry>Default is true.</entry> </row> <row> -<entry ->Progress Bar Position</entry> -<entry ->[top/bottom]</entry> -<entry ->Toggles whether statusbar should be in bottom or top. Default is bottom.</entry> +<entry>Progress Bar Position</entry> +<entry>[top/bottom]</entry> +<entry>Toggles whether statusbar should be in bottom or top. Default is bottom.</entry> </row> <row> -<entry ->Icons Jumping</entry> -<entry ->[true/false]</entry> -<entry ->Indicates whether icons should be jumping. Default is false.</entry> +<entry>Icons Jumping</entry> +<entry>[true/false]</entry> +<entry>Indicates whether icons should be jumping. Default is false.</entry> </row> </tbody> </tgroup> @@ -598,52 +355,35 @@ Welcome Text = Loading KDE </sect2> <sect2 id="mac-classic-themes"> -<title ->MacClassic Theme</title> +<title>MacClassic Theme</title> <table> -<title ->MacClassic Theme Options</title> +<title>MacClassic Theme Options</title> <tgroup cols="3"> <tbody> <row> -<entry ->Name</entry> -<entry ->Argument</entry> -<entry ->Explanation</entry> +<entry>Name</entry> +<entry>Argument</entry> +<entry>Explanation</entry> </row> <row> -<entry ->Icon Position</entry> -<entry ->[0-3,10-13]</entry> -<entry ->Position of the icons on the screen. Default is bottom left.</entry> +<entry>Icon Position</entry> +<entry>[0-3,10-13]</entry> +<entry>Position of the icons on the screen. Default is bottom left.</entry> </row> <row> -<entry ->Icons Jumping</entry> -<entry ->[true/false]</entry> -<entry ->Indicates whether icons should be jumping. Default is false.</entry> +<entry>Icons Jumping</entry> +<entry>[true/false]</entry> +<entry>Indicates whether icons should be jumping. Default is false.</entry> </row> <row> -<entry ->Icons Visible</entry> -<entry ->[true/false]</entry> -<entry ->Indicates whether icons should be visible. Default is true.</entry> +<entry>Icons Visible</entry> +<entry>[true/false]</entry> +<entry>Indicates whether icons should be visible. Default is true.</entry> </row> <row> -<entry ->Splash Screen</entry> -<entry ->[name]</entry> -<entry ->Changes the splash screen image that is shown.</entry> +<entry>Splash Screen</entry> +<entry>[name]</entry> +<entry>Changes the splash screen image that is shown.</entry> </row> </tbody> </tgroup> @@ -651,84 +391,55 @@ Welcome Text = Loading KDE </sect2> <sect2 id="themes-2k"> -<title ->2k theme</title> +<title>2k theme</title> <table> -<title ->2k theme options</title> +<title>2k theme options</title> <tgroup cols="3"> <tbody> <row> -<entry ->Name</entry> -<entry ->Argument</entry> -<entry ->Explanation</entry> +<entry>Name</entry> +<entry>Argument</entry> +<entry>Explanation</entry> </row> <row> -<entry ->Title Background Colour</entry> -<entry ->[color]</entry> -<entry ->The background colour of title. Default is dark blue.</entry> +<entry>Title Background Colour</entry> +<entry>[color]</entry> +<entry>The background colour of title. Default is dark blue.</entry> </row> <row> -<entry ->Title Foreground Colour</entry> -<entry ->[color]</entry> -<entry ->The foreground colour of title. Default is white.</entry> +<entry>Title Foreground Colour</entry> +<entry>[color]</entry> +<entry>The foreground colour of title. Default is white.</entry> </row> <row> -<entry ->Status Text Colour</entry> -<entry ->[color]</entry> -<entry ->The colour of status texts. Default is the same as Title Background Colour.</entry> +<entry>Status Text Colour</entry> +<entry>[color]</entry> +<entry>The colour of status texts. Default is the same as Title Background Colour.</entry> </row> <row> -<entry ->Rotator Colour 1</entry> -<entry ->[color]</entry> -<entry ->Defines the colour of rotator 1. Default is dark blue.</entry> +<entry>Rotator Colour 1</entry> +<entry>[color]</entry> +<entry>Defines the colour of rotator 1. Default is dark blue.</entry> </row> <row> -<entry ->Rotator Colour 2</entry> -<entry ->[color]</entry> -<entry ->Defines the colour of rotator 2. Default is cyan.</entry> +<entry>Rotator Colour 2</entry> +<entry>[color]</entry> +<entry>Defines the colour of rotator 2. Default is cyan.</entry> </row> <row> -<entry ->Rotator Speed</entry> -<entry ->[value]</entry> -<entry ->Defines the speed of the rotator. Default is 30.</entry> +<entry>Rotator Speed</entry> +<entry>[value]</entry> +<entry>Defines the speed of the rotator. Default is 30.</entry> </row> <row> -<entry ->Window Title</entry> -<entry ->[text]</entry> -<entry ->Specifies the title text of the window.</entry> +<entry>Window Title</entry> +<entry>[text]</entry> +<entry>Specifies the title text of the window.</entry> </row> <row> -<entry ->Logo File</entry> -<entry ->[filename]</entry> -<entry ->Defines the logo used.</entry> +<entry>Logo File</entry> +<entry>[filename]</entry> +<entry>Defines the logo used.</entry> </row> </tbody> </tgroup> @@ -738,33 +449,22 @@ Welcome Text = Loading KDE </chapter> <chapter id="from-other-applications"> -<title ->Using &ksplash; From Within Your Own Application</title> +<title>Using &ksplash; From Within Your Own Application</title> -<para ->In this chapter, we describe a simple method for using &ksplash; as the splash screen for your &kde; application. If you do not develop applications for &kde;, you can skip this chapter.</para> +<para>In this chapter, we describe a simple method for using &ksplash; as the splash screen for your &kde; application. If you do not develop applications for &kde;, you can skip this chapter.</para> <sect1 id="basic-other-reqs"> -<title ->Basic Requirements</title> - -<para ->Your &kde; application must be &DCOP;-aware. &DCOP; is the &kde; technology used to communicate between applications. If you use the standard <ulink url="http://developer.kde.org" ->&kde; application framework</ulink ->, this is taken care of automatically. For information about &DCOP; and related &kde; technologies, please visit the <ulink url="http://developer.kde.org" ->&kde; developers' corner</ulink ->.</para> +<title>Basic Requirements</title> + +<para>Your &kde; application must be &DCOP;-aware. &DCOP; is the &kde; technology used to communicate between applications. If you use the standard <ulink url="http://developer.kde.org">&kde; application framework</ulink>, this is taken care of automatically. For information about &DCOP; and related &kde; technologies, please visit the <ulink url="http://developer.kde.org">&kde; developers' corner</ulink>.</para> </sect1> <sect1 id="other-using"> -<title ->Starting &ksplash;</title> +<title>Starting &ksplash;</title> -<para ->Before your application starts its computation intensive work, or before it starts loading plugins, &etc;, invoke &ksplash; as follows:</para> +<para>Before your application starts its computation intensive work, or before it starts loading plugins, &etc;, invoke &ksplash; as follows:</para> -<programlisting ->DCOPClient *c = kapp->dcopClient(); +<programlisting>DCOPClient *c = kapp->dcopClient(); QString error; QCString KSplashName; int pid = 0; @@ -777,50 +477,39 @@ if (kapp->startServiceByDesktopName("ksplash", args, &error, &KSplash } </programlisting> -<para ->We will assume that there is only one instance of &ksplash; running. Other cases are slightly more complex. Please see the &DCOP; documentation for further details.</para> +<para>We will assume that there is only one instance of &ksplash; running. Other cases are slightly more complex. Please see the &DCOP; documentation for further details.</para> </sect1> <sect1 id="show-messages"> -<title ->Showing messages</title> +<title>Showing messages</title> -<para ->Before you show any messages, you need to set up the number of steps you will show. For example, the &kde; startup procedure uses 7 steps.</para> +<para>Before you show any messages, you need to set up the number of steps you will show. For example, the &kde; startup procedure uses 7 steps.</para> -<programlisting ->QByteArray data; +<programlisting>QByteArray data; QDataStream arg(data,IO_WriteOnly); arg << someNumber; if (!(c->send(KSplashName, "KSplashIface", "setStartupItemCount(int)", data)) // Some error processing here. </programlisting> -<para ->Whenever you want to display a message with or without an icon, use</para> +<para>Whenever you want to display a message with or without an icon, use</para> -<programlisting ->arg << QString("iconName") << QString("programName") << QString("Some description"); +<programlisting>arg << QString("iconName") << QString("programName") << QString("Some description"); if (!(c->send(KSplashName, "KSplashIface", "programStarted(QString,QString,QString)", data)) { // Some error processing here. } </programlisting> -<para ->Each time you call <constant ->programStarted</constant ->, the steps completed is incremented. When your program has finished its startup, do the following to make the splash screen go away:</para> +<para>Each time you call <constant>programStarted</constant>, the steps completed is incremented. When your program has finished its startup, do the following to make the splash screen go away:</para> -<programlisting ->if (!(c->send(KSplashName, "KSplashIface", "startupComplete()", data)) +<programlisting>if (!(c->send(KSplashName, "KSplashIface", "startupComplete()", data)) { // Some error processing here. } </programlisting> -<para ->That's it! You don't need anything more to take advantage of all that &ksplash; has to offer you.</para> +<para>That's it! You don't need anything more to take advantage of all that &ksplash; has to offer you.</para> </sect1> </chapter> @@ -829,65 +518,25 @@ if (kapp->startServiceByDesktopName("ksplash", args, &error, &KSplash <!-- will have to still translate it ... --> <chapter id="wrplugins"> -<title ->Writing new &ksplash; plugins</title> +<title>Writing new &ksplash; plugins</title> -<para ->Writing new &ksplash; plugins is not difficult. In this chapter, we will write a simple plugin that will emulate the splash screen of a well known operating system. This tutorial assumes that you know the basics of C++, and a little bit of KDE/Qt programming.</para> +<para>Writing new &ksplash; plugins is not difficult. In this chapter, we will write a simple plugin that will emulate the splash screen of a well known operating system. This tutorial assumes that you know the basics of C++, and a little bit of KDE/Qt programming.</para> <sect1 id="basic-requirements"> -<title ->Basic Requirements</title> -<para ->We will create a plugin called <literal ->2k</literal ->. The plugin name is used in various places, and is important that you consistently use it so that the plugin is recognised by &ksplash;. &ksplash; plugins are actually dynamically loadable libraries with the following naming convention: </para> +<title>Basic Requirements</title> +<para>We will create a plugin called <literal>2k</literal>. The plugin name is used in various places, and is important that you consistently use it so that the plugin is recognised by &ksplash;. &ksplash; plugins are actually dynamically loadable libraries with the following naming convention: </para> <simplelist> -<member ->The library should be named as <filename ->ksplash+lowercasethemename</filename ->. For our theme, it will be <filename ->ksplash2k</filename ->.</member> -<member ->It should have a corresponding desktop file which is named as <filename ->ksplash+lowercasethemename.desktop</filename ->. For our theme, it will be <filename ->ksplash2k.desktop</filename ->. </member> -<member ->Finally, the object that is returned by the library should be a class which is named <literal ->Theme+themename</literal ->. For our example, it will be <literal ->Theme2k</literal ->.</member> +<member>The library should be named as <filename>ksplash+lowercasethemename</filename>. For our theme, it will be <filename>ksplash2k</filename>.</member> +<member>It should have a corresponding desktop file which is named as <filename>ksplash+lowercasethemename.desktop</filename>. For our theme, it will be <filename>ksplash2k.desktop</filename>. </member> +<member>Finally, the object that is returned by the library should be a class which is named <literal>Theme+themename</literal>. For our example, it will be <literal>Theme2k</literal>.</member> </simplelist> -<para ->Do not worry about it if you don't understand all of the above. We will consider each of those points in detail later. The other very important detail is that the plugin class should be derived from <literal ->ThemeEngine</literal ->. </para> +<para>Do not worry about it if you don't understand all of the above. We will consider each of those points in detail later. The other very important detail is that the plugin class should be derived from <literal>ThemeEngine</literal>. </para> </sect1> <sect1 id="skeleton"> -<title ->Building the skeleton framework</title> -<para ->We will use the &kde; application framework which will take care of building the plugin and will provide us with platform independence without any work on our part. To do that, make sure you have the <filename ->tdesdk</filename -> package installed. Run the command <literal ->kapptemplate</literal -> to produce an application named "2k". It will create a toplevel folder which contains generic files such as AUTHORS, &etc;. We are most interested in the subfolder called <filename class="directory" ->2k</filename ->. Go into that subfolder and delete all the files there. Now we have the skeleton we require. </para> -<para ->The next step is to create a <filename ->.desktop</filename -> file which, when installed, will tell &ksplash; that our plugin is available. Consistent with the naming conventions laid out in <link linkend="basic-requirements" ->the preceding section</link ->, create a file called <filename ->ksplash2k.desktop</filename -> in that folder. It should contain the following lines: </para> -<programlisting -><literal> +<title>Building the skeleton framework</title> +<para>We will use the &kde; application framework which will take care of building the plugin and will provide us with platform independence without any work on our part. To do that, make sure you have the <filename>tdesdk</filename> package installed. Run the command <literal>kapptemplate</literal> to produce an application named "2k". It will create a toplevel folder which contains generic files such as AUTHORS, &etc;. We are most interested in the subfolder called <filename class="directory">2k</filename>. Go into that subfolder and delete all the files there. Now we have the skeleton we require. </para> +<para>The next step is to create a <filename>.desktop</filename> file which, when installed, will tell &ksplash; that our plugin is available. Consistent with the naming conventions laid out in <link linkend="basic-requirements">the preceding section</link>, create a file called <filename>ksplash2k.desktop</filename> in that folder. It should contain the following lines: </para> +<programlisting><literal> [Desktop Entry] Encoding=UTF-8 Type=Service @@ -898,94 +547,29 @@ X-TDE-Library=ksplash2k X-KSplash-Default=true X-KSplash-PluginName=2k X-KSplash-ObjectName=Theme2k -</literal -> +</literal> </programlisting> -<para ->The <literal ->Encoding</literal ->, <literal ->Type</literal ->, <literal ->Comment</literal -> and <literal ->ServiceTypes</literal -> are the same for all plugins. The plugin name and the library name follow the conventions noted earlier. The entry <literal ->X-KSplash-Default</literal -> takes a boolean value which determines whether it is shown in the control panel configuration module by default. Except for some very rare cases, it should be <constant ->true</constant ->. </para> +<para>The <literal>Encoding</literal>, <literal>Type</literal>, <literal>Comment</literal> and <literal>ServiceTypes</literal> are the same for all plugins. The plugin name and the library name follow the conventions noted earlier. The entry <literal>X-KSplash-Default</literal> takes a boolean value which determines whether it is shown in the control panel configuration module by default. Except for some very rare cases, it should be <constant>true</constant>. </para> </sect1> <sect1 id="headerfile"> -<title ->Declaration of plugin class</title> -<para ->Now that we have the preliminary work done, let us get into the actual fun part - creating a class that will provide the behaviour we want. While we are free to make this class do almost anything we want it to do, there are a few restrictions.</para> +<title>Declaration of plugin class</title> +<para>Now that we have the preliminary work done, let us get into the actual fun part - creating a class that will provide the behaviour we want. While we are free to make this class do almost anything we want it to do, there are a few restrictions.</para> <orderedlist> -<listitem -><para ->Plugin classes must inherit the <constant ->ThemeEngine</constant -> class.</para -></listitem> -<listitem -><para ->Plugin classes must be named according to the rule: <classname ->Theme+PluginName</classname ->.</para -></listitem> -<listitem -><para ->Plugin classes should provide a <literal ->static</literal -> function called <function ->names</function -> that returns a list of names by which it can be invoked.</para -></listitem> -<listitem -><para ->If the plugin can be configured in the control centre module, it should provide a <literal ->ThemeEngineConfig</literal ->-based class for the configuration.</para -></listitem> -<listitem -><para ->Plugin classes must override at least one of the virtual functions <function ->slotSetText</function ->, <function ->slotSetPixmap</function ->, <function ->slotUpdateProgress</function -> and <function ->slotUpdateSteps</function -> to make it usable.</para -></listitem> -<listitem -><para ->The constructor should take the form <literal ->ThemeEngine( QWidget *parent, const char *name, const QStringList &args )</literal -> so that it can be used with <classname ->KGenericFactory</classname ->.</para -></listitem> +<listitem><para>Plugin classes must inherit the <constant>ThemeEngine</constant> class.</para></listitem> +<listitem><para>Plugin classes must be named according to the rule: <classname>Theme+PluginName</classname>.</para></listitem> +<listitem><para>Plugin classes should provide a <literal>static</literal> function called <function>names</function> that returns a list of names by which it can be invoked.</para></listitem> +<listitem><para>If the plugin can be configured in the control centre module, it should provide a <literal>ThemeEngineConfig</literal>-based class for the configuration.</para></listitem> +<listitem><para>Plugin classes must override at least one of the virtual functions <function>slotSetText</function>, <function>slotSetPixmap</function>, <function>slotUpdateProgress</function> and <function>slotUpdateSteps</function> to make it usable.</para></listitem> +<listitem><para>The constructor should take the form <literal>ThemeEngine( QWidget *parent, const char *name, const QStringList &args )</literal> so that it can be used with <classname>KGenericFactory</classname>.</para></listitem> </orderedlist> -<para ->The last requirement may seem complicated, but, as we will see later, by adding a single line to your source files, you can usually ignore it.</para> +<para>The last requirement may seem complicated, but, as we will see later, by adding a single line to your source files, you can usually ignore it.</para> </sect1> <sect1 id="headercode"> -<title ->Code for the header file</title> -<para ->Given the constaints, we will now see what the header file <filename ->theme2k.h</filename -> looks like this:</para> +<title>Code for the header file</title> +<para>Given the constaints, we will now see what the header file <filename>theme2k.h</filename> looks like this:</para> <example> -<title ->Listing for <filename ->theme2k.h</filename -></title> -<programlisting ->#ifndef __THEME2K_H__ +<title>Listing for <filename>theme2k.h</filename></title> +<programlisting>#ifndef __THEME2K_H__ #define __THEME2K_H__ #include <qlabel.h> @@ -1049,50 +633,20 @@ private: #endif </programlisting> </example> -<para ->Let us analyse the listing above. The <classname ->Theme2k</classname -> class satisfies the naming conventions, and is inherited from <classname ->ThemeEngine</classname ->. It provides a <methodname ->Theme2k::names()</methodname ->, and has a constructor that takes the required parameters: <function ->Theme2k( QWidget *, const char *, const QStringList& );</function -> and also provides a simple <methodname ->Theme2k::slotSetText()</methodname -> method. For the moment, do not worry about the <classname ->RotWidget</classname -> class. It is a small widget that provides some eye candy for the user. Our plugin is very simple and does not display any icons or show a progressbar. If you would like to display icons, override the <function ->slotSetPixmap</function -> function. Similar functions exist for setting the progressbar range (<function ->slotUpdateSteps</function ->) and incrementing(<function ->slotUpdateProgress</function ->) the current step. </para> +<para>Let us analyse the listing above. The <classname>Theme2k</classname> class satisfies the naming conventions, and is inherited from <classname>ThemeEngine</classname>. It provides a <methodname>Theme2k::names()</methodname>, and has a constructor that takes the required parameters: <function>Theme2k( QWidget *, const char *, const QStringList& );</function> and also provides a simple <methodname>Theme2k::slotSetText()</methodname> method. For the moment, do not worry about the <classname>RotWidget</classname> class. It is a small widget that provides some eye candy for the user. Our plugin is very simple and does not display any icons or show a progressbar. If you would like to display icons, override the <function>slotSetPixmap</function> function. Similar functions exist for setting the progressbar range (<function>slotUpdateSteps</function>) and incrementing(<function>slotUpdateProgress</function>) the current step. </para> </sect1> <sect1 id="Implementation"> -<title ->Implementation of the plugin</title> -<para ->We will examine only the relevant parts of the implementation. For a listing of the whole implementation, please see the appendix. The first thing we will do is to get the library requirement out of the way:</para> +<title>Implementation of the plugin</title> +<para>We will examine only the relevant parts of the implementation. For a listing of the whole implementation, please see the appendix. The first thing we will do is to get the library requirement out of the way:</para> <example> -<title ->Library requirement</title> -<programlisting ->K_EXPORT_COMPONENT_FACTORY( ksplash2k, KGenericFactory<Theme2k> ); +<title>Library requirement</title> +<programlisting>K_EXPORT_COMPONENT_FACTORY( ksplash2k, KGenericFactory<Theme2k> ); </programlisting> </example> -<para ->The macro <constant ->K_EXPORT_COMPONENT_FACTORY</constant -> is declared in <filename ->kgenericfactory.h</filename ->. Onwards to the constructor! Since this is a very simple plugin, the constructor is pretty straightforward.</para> +<para>The macro <constant>K_EXPORT_COMPONENT_FACTORY</constant> is declared in <filename>kgenericfactory.h</filename>. Onwards to the constructor! Since this is a very simple plugin, the constructor is pretty straightforward.</para> <example> -<title ->Plugin constructor</title> -<programlisting ->Theme2k::Theme2k( QWidget *parent, const char *name, const QStringList &args ) +<title>Plugin constructor</title> +<programlisting>Theme2k::Theme2k( QWidget *parent, const char *name, const QStringList &args ) :ThemeEngine( parent, name, args ) { readSettings(); @@ -1100,15 +654,10 @@ private: } </programlisting> </example> -<para ->The method <function ->readSettings()</function -> illustrates the proper way to obtain your theme settings. (You do want people to use your plugins in their themes, don't you?)</para> +<para>The method <function>readSettings()</function> illustrates the proper way to obtain your theme settings. (You do want people to use your plugins in their themes, don't you?)</para> <example> -<title ->Obtaining theme settings</title> -<programlisting ->void Theme2k::readSettings() +<title>Obtaining theme settings</title> +<programlisting>void Theme2k::readSettings() { if( !mTheme ) return; @@ -1137,25 +686,14 @@ private: } </programlisting> </example> -<para ->Since we like our users, we provide sensible defaults for parameters that are not present in the theme file. Note that we should always set our group to "KSplash Theme: themename" to remain compatible with future theme specifications. The <function ->initUI()</function -> method is not very interesting, as it merely builds up the widgets. Please see the appendix for details. </para> +<para>Since we like our users, we provide sensible defaults for parameters that are not present in the theme file. Note that we should always set our group to "KSplash Theme: themename" to remain compatible with future theme specifications. The <function>initUI()</function> method is not very interesting, as it merely builds up the widgets. Please see the appendix for details. </para> </sect1> <sect1 id="compilingfile"> -<title ->Compiling the plugin</title> -<para ->Since we decided to use the &kde; framework for compiling the plugin, we need to create a <filename ->Makefile.am</filename ->. It should look like this:</para> +<title>Compiling the plugin</title> +<para>Since we decided to use the &kde; framework for compiling the plugin, we need to create a <filename>Makefile.am</filename>. It should look like this:</para> <example> -<title ->Listing of <filename ->Makefile.am</filename -></title> -<programlisting ->INCLUDES = $(all_includes) +<title>Listing of <filename>Makefile.am</filename></title> +<programlisting>INCLUDES = $(all_includes) kde_module_LTLIBRARIES = ksplash2k.la @@ -1174,103 +712,67 @@ themedir = $(kde_datadir)/ksplash/Themes/2k theme_DATA = Theme.rc Preview.png </programlisting> </example> -<para ->For more information on writing <filename ->Makefile.am</filename -> files for &kde;, please see the &kde; developers' <ulink url="http://developer.kde.org/documentation/other/makefile_am_howto.html" ->website</ulink ->. The only thing of note is that we provide a default theme based on this plugin, and provide a preview image for it. As a matter of courtesy to your users, you should provide an example <filename ->Theme.rc</filename -> file illustrating the use of the various options.</para> +<para>For more information on writing <filename>Makefile.am</filename> files for &kde;, please see the &kde; developers' <ulink url="http://developer.kde.org/documentation/other/makefile_am_howto.html">website</ulink>. The only thing of note is that we provide a default theme based on this plugin, and provide a preview image for it. As a matter of courtesy to your users, you should provide an example <filename>Theme.rc</filename> file illustrating the use of the various options.</para> </sect1> </chapter> <chapter id="faq"> -<title ->Questions and Answers</title> +<title>Questions and Answers</title> &reporting.bugs; &updating.documentation; <qandaset id="faqlist"> <qandaentry> <question> -<para ->I can't find any themes that work in &ksplash;. Why is that?</para> +<para>I can't find any themes that work in &ksplash;. Why is that?</para> </question> <answer> -<para ->You probably don't have the correct plugins for the theme. The plugins are in the <literal ->kde-artwork</literal -> package. Download and install it, and try then again.</para> +<para>You probably don't have the correct plugins for the theme. The plugins are in the <literal>kde-artwork</literal> package. Download and install it, and try then again.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->What is file <filename ->Theme.rc</filename -> and how do I make one?</para> +<para>What is file <filename>Theme.rc</filename> and how do I make one?</para> </question> <answer> -<para -><filename ->Theme.rc</filename -> is the file where you can specify a theme's settings. For more information, take a look at <link linkend="themes" ->How to make themes for &ksplash;</link ->. </para> +<para><filename>Theme.rc</filename> is the file where you can specify a theme's settings. For more information, take a look at <link linkend="themes">How to make themes for &ksplash;</link>. </para> </answer> </qandaentry> </qandaset> </chapter> <chapter id="credits"> -<title ->Credits and Licence</title> +<title>Credits and Licence</title> -<para ->&ksplash;</para> +<para>&ksplash;</para> -<para ->Program Copyright © 2003 &Ravikiran.Rajagopal; &Ravikiran.Rajagopal.mail;</para> +<para>Program Copyright © 2003 &Ravikiran.Rajagopal; &Ravikiran.Rajagopal.mail;</para> <itemizedlist> -<title ->Contributors</title> -<listitem -><para ->&Brian.C.Ledbetter; &Brian.C.Ledbetter.mail;</para> +<title>Contributors</title> +<listitem><para>&Brian.C.Ledbetter; &Brian.C.Ledbetter.mail;</para> </listitem> </itemizedlist> -<para ->Documentation Copyright © 2003 &Teemu.Rytilahti; &Teemu.Rytilahti.mail;</para> +<para>Documentation Copyright © 2003 &Teemu.Rytilahti; &Teemu.Rytilahti.mail;</para> &underFDL; &underGPL; </chapter> <appendix id="installation"> -<title ->Installation</title> +<title>Installation</title> <sect1 id="requirements"> -<title ->Requirements</title> +<title>Requirements</title> -<para ->In order to successfully use &ksplash;, you need &kde; version 3.2 or higher. Some themes may require specific plugins. If a theme does not work, please contact the theme author to find out where to obtain the appropriate plugin.</para> +<para>In order to successfully use &ksplash;, you need &kde; version 3.2 or higher. Some themes may require specific plugins. If a theme does not work, please contact the theme author to find out where to obtain the appropriate plugin.</para> </sect1> <sect1 id="compilation"> -<title ->Compilation and Installation</title> +<title>Compilation and Installation</title> &install.compile.documentation; </sect1> </appendix> <appendix id="srccode"> -<title ->Source code</title> +<title>Source code</title> <sect1 id="theme2kcpp"> -<title ->Listing of <filename ->theme2k.cpp</filename -></title> -<programlisting ->#include <qlabel.h> +<title>Listing of <filename>theme2k.cpp</filename></title> +<programlisting>#include <qlabel.h> #include <qwidget.h> #include <tdeapplication.h> @@ -1377,12 +879,8 @@ void Theme2k::readSettings() </programlisting> </sect1> <sect1 id="rotwidgeth"> -<title ->Listing of <filename ->rotwidget.h</filename -></title> -<programlisting ->#ifndef __ROTWIDGET_H__ +<title>Listing of <filename>rotwidget.h</filename></title> +<programlisting>#ifndef __ROTWIDGET_H__ #define __ROTWIDGET_H__ #include <qlabel.h> @@ -1421,12 +919,8 @@ protected: </programlisting> </sect1> <sect1 id="rotwidgetcpp"> -<title ->Listing of <filename ->rotwidget.cpp</filename -></title> -<programlisting ->#include <kdebug.h> +<title>Listing of <filename>rotwidget.cpp</filename></title> +<programlisting>#include <kdebug.h> #include <kdialogbase.h> #include <kpixmapeffect.h> diff --git a/tde-i18n-en_GB/docs/tdebase/ksysguard/index.docbook b/tde-i18n-en_GB/docs/tdebase/ksysguard/index.docbook index 49c19b2d9a5..2ca53be8c21 100644 --- a/tde-i18n-en_GB/docs/tdebase/ksysguard/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/ksysguard/index.docbook @@ -4,659 +4,318 @@ <!ENTITY kappname "&ksysguard;"> <!ENTITY package "tdebase"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <book lang="&language;"> <bookinfo> -<title ->The &ksysguard; Handbook</title> +<title>The &ksysguard; Handbook</title> <authorgroup> -<author ->&Chris.Schlaeger;&Chris.Schlaeger.mail; </author> - -<othercredit role="developer" ->&Chris.Schlaeger;&Chris.Schlaeger.mail; </othercredit> - -<othercredit role="developer" ->&Tobias.Koenig;&Tobias.Koenig.mail; </othercredit> - -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Chris.Schlaeger;&Chris.Schlaeger.mail; </author> + +<othercredit role="developer">&Chris.Schlaeger;&Chris.Schlaeger.mail; </othercredit> + +<othercredit role="developer">&Tobias.Koenig;&Tobias.Koenig.mail; </othercredit> + +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->2000</year> -<holder ->&Chris.Schlaeger;</holder> +<year>2000</year> +<holder>&Chris.Schlaeger;</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2000-12-14</date> -<releaseinfo ->1.00.00</releaseinfo> +<date>2000-12-14</date> +<releaseinfo>1.00.00</releaseinfo> -<abstract -><para ->&ksysguard; is a network enabled task manager and system monitor application, with the additional functionality of <application ->top</application ->.</para -></abstract -> +<abstract><para>&ksysguard; is a network enabled task manager and system monitor application, with the additional functionality of <application>top</application>.</para></abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KSysGuard</keyword> -<keyword ->process monitor</keyword> -<keyword ->top</keyword> -<keyword ->ps</keyword> +<keyword>KDE</keyword> +<keyword>KSysGuard</keyword> +<keyword>process monitor</keyword> +<keyword>top</keyword> +<keyword>ps</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->&ksysguard; is the &kde; Task Manager and Performance Monitor. It features a client/server architecture that allows monitoring of local as well as remote hosts. The graphical front end uses so-called sensors to retrieve the information it displays. A sensor can return simple values or more complex information like tables. For each type of information, one or more displays are provided. Displays are organised in work sheets that can be saved and loaded independently from each other. So, &ksysguard; is not only a simple task manager but also a very powerful tool to control large server farms.</para> +<para>&ksysguard; is the &kde; Task Manager and Performance Monitor. It features a client/server architecture that allows monitoring of local as well as remote hosts. The graphical front end uses so-called sensors to retrieve the information it displays. A sensor can return simple values or more complex information like tables. For each type of information, one or more displays are provided. Displays are organised in work sheets that can be saved and loaded independently from each other. So, &ksysguard; is not only a simple task manager but also a very powerful tool to control large server farms.</para> </chapter> <chapter id="usingtheksysguard"> -<title ->Using &ksysguard;</title> +<title>Using &ksysguard;</title> <sect1 id="getting-started"> -<title ->Getting started</title> - -<para ->&ksysguard; can be started from the start menu, using the entry <guimenuitem ->KDE System Guard</guimenuitem -> in the <guimenu ->Systems</guimenu -> menu. Alternatively, you can start it by typing <command ->ksysguard</command -> in a terminal.</para> - -<para ->The &ksysguard; main window consists of a menu bar, an optional tool bar and status bar, the sensor browser and the work space. When first started you see your local machine listed as <guilabel ->localhost</guilabel -> in the sensor browser and 2 pages in the work space area. This is the default setup.</para> - -<para ->This default setup is sufficient enough for an inexperienced user to do some system management. An experienced user or even a system administrator of a large computer lab has different needs. To address a wide range of users, &ksysguard; is highly flexible.</para> +<title>Getting started</title> + +<para>&ksysguard; can be started from the start menu, using the entry <guimenuitem>KDE System Guard</guimenuitem> in the <guimenu>Systems</guimenu> menu. Alternatively, you can start it by typing <command>ksysguard</command> in a terminal.</para> + +<para>The &ksysguard; main window consists of a menu bar, an optional tool bar and status bar, the sensor browser and the work space. When first started you see your local machine listed as <guilabel>localhost</guilabel> in the sensor browser and 2 pages in the work space area. This is the default setup.</para> + +<para>This default setup is sufficient enough for an inexperienced user to do some system management. An experienced user or even a system administrator of a large computer lab has different needs. To address a wide range of users, &ksysguard; is highly flexible.</para> </sect1> <sect1 id="the-sensor-browser"> -<title ->The Sensor Browser</title> +<title>The Sensor Browser</title> -<para ->The sensor browser displays the registered hosts and their sensors in a tree form. Click on the tree handles to open or close a branch. Each sensor monitors a certain system value.</para> +<para>The sensor browser displays the registered hosts and their sensors in a tree form. Click on the tree handles to open or close a branch. Each sensor monitors a certain system value.</para> <sect2 id="connectingtootherhosts"> -<title ->Connecting to other hosts</title> - -<para ->To connect to a new host use <guimenuitem ->Connect Hosts</guimenuitem -> from the <guimenu ->File</guimenu -> menu. A dialogue box will appear and allows you to enter the name of the host you want to connect to. Below the name you can choose the connection method. The default is <application ->ssh</application ->, the secure shell. Alternatively the <application ->rsh</application ->, the remote shell, or the daemon mode can be used. Click <guibutton ->OK</guibutton -> to establish the connection. Shortly afterwards the new host will appear in the sensor browser and you can browse the list of sensors.</para> - -<para ->To establish a connection, a program called <application ->ksysguardd</application ->, that can be started in the following two modes, must be installed on the new host.</para> +<title>Connecting to other hosts</title> + +<para>To connect to a new host use <guimenuitem>Connect Hosts</guimenuitem> from the <guimenu>File</guimenu> menu. A dialogue box will appear and allows you to enter the name of the host you want to connect to. Below the name you can choose the connection method. The default is <application>ssh</application>, the secure shell. Alternatively the <application>rsh</application>, the remote shell, or the daemon mode can be used. Click <guibutton>OK</guibutton> to establish the connection. Shortly afterwards the new host will appear in the sensor browser and you can browse the list of sensors.</para> + +<para>To establish a connection, a program called <application>ksysguardd</application>, that can be started in the following two modes, must be installed on the new host.</para> <variablelist> <varlistentry> -<term ->daemon mode</term> +<term>daemon mode</term> <listitem> -<para ->You can start <application ->ksysguardd</application -> at boot time in <guilabel ->Daemon</guilabel -> mode by adding <parameter ->-d</parameter -> as the argument. In this case, you have to select daemon mode at the connection dialogue of <application ->ksysguard</application ->. A disadvantage of this connection type is that you won't be able to kill or renice a process with the <guilabel ->Process Controller</guilabel -> and the data exchange over network won't be encrypted.</para> +<para>You can start <application>ksysguardd</application> at boot time in <guilabel>Daemon</guilabel> mode by adding <parameter>-d</parameter> as the argument. In this case, you have to select daemon mode at the connection dialogue of <application>ksysguard</application>. A disadvantage of this connection type is that you won't be able to kill or renice a process with the <guilabel>Process Controller</guilabel> and the data exchange over network won't be encrypted.</para> </listitem> </varlistentry> <varlistentry> -<term ->shell mode</term> +<term>shell mode</term> <listitem> -<para ->In this mode <application ->ksysguardd</application -> is started at connecting time by <application ->ksysguard</application ->. To make that possible, its location needs to be included in your <envar ->PATH</envar ->. Unfortunately the ssh does not source your <filename ->.profile</filename -> file, so your regular <envar ->PATH</envar -> setting will not be available. Instead it uses a default <envar ->PATH</envar -> like <parameter ->/bin:/usr/bin</parameter ->. Since it is very likely that &kde; is not installed in these folders you need to create or update a file in your home folder. The file is called <filename ->environment</filename -> and needs to be in a hidden folder called <filename ->.ssh</filename ->. See the manual page for <application ->ssh</application -> for more details. The file needs to contain a line similar to:</para> - -<screen -><userinput ->PATH=/bin:/usr/bin:/opt/kde/bin</userinput -> +<para>In this mode <application>ksysguardd</application> is started at connecting time by <application>ksysguard</application>. To make that possible, its location needs to be included in your <envar>PATH</envar>. Unfortunately the ssh does not source your <filename>.profile</filename> file, so your regular <envar>PATH</envar> setting will not be available. Instead it uses a default <envar>PATH</envar> like <parameter>/bin:/usr/bin</parameter>. Since it is very likely that &kde; is not installed in these folders you need to create or update a file in your home folder. The file is called <filename>environment</filename> and needs to be in a hidden folder called <filename>.ssh</filename>. See the manual page for <application>ssh</application> for more details. The file needs to contain a line similar to:</para> + +<screen><userinput>PATH=/bin:/usr/bin:/opt/kde/bin</userinput> </screen> -<para ->assuming that <application ->ksysguardd</application -> can be found under <filename ->/opt/kde/bin/ksysguardd</filename ->.</para> - -<tip -><para ->When using <application ->ssh</application -> you should make sure that you have your <filename ->identity.pub</filename -> installed on the remote machine and the host key of the remote machine is already registered on your machine. The easiest way to check this is to type <command ->ssh <option ->remotehost ksysguardd</option -></command -> in a shell. If you are greeted by <application ->ksysguardd</application -> you can type <userinput ->quit</userinput -> and everything is in order.</para -></tip> +<para>assuming that <application>ksysguardd</application> can be found under <filename>/opt/kde/bin/ksysguardd</filename>.</para> + +<tip><para>When using <application>ssh</application> you should make sure that you have your <filename>identity.pub</filename> installed on the remote machine and the host key of the remote machine is already registered on your machine. The easiest way to check this is to type <command>ssh <option>remotehost ksysguardd</option></command> in a shell. If you are greeted by <application>ksysguardd</application> you can type <userinput>quit</userinput> and everything is in order.</para></tip> </listitem> </varlistentry> </variablelist> -<note -><para ->For experts: <application ->ksysguardd</application -> is a very small program that is only linked against the libc. So it can also be used on machines that do not have a fully blown &kde; installation, such as servers. If you choose the custom command option in the host connector you need to specify the complete command to start <application ->ksysguardd</application ->.</para -></note> +<note><para>For experts: <application>ksysguardd</application> is a very small program that is only linked against the libc. So it can also be used on machines that do not have a fully blown &kde; installation, such as servers. If you choose the custom command option in the host connector you need to specify the complete command to start <application>ksysguardd</application>.</para></note> </sect2> <sect2 id="disconnecting-hosts"> -<title ->Disconnecting hosts</title> - -<para ->To disconnect from a host, select the host in the sensor browser and choose <guimenuitem ->Disconnect Host</guimenuitem -> from the <guimenu ->File</guimenu -> menu. If you still have sensors in use, the display frames will be greyed and the displays won't update any longer.</para> +<title>Disconnecting hosts</title> + +<para>To disconnect from a host, select the host in the sensor browser and choose <guimenuitem>Disconnect Host</guimenuitem> from the <guimenu>File</guimenu> menu. If you still have sensors in use, the display frames will be greyed and the displays won't update any longer.</para> </sect2> </sect1> <sect1 id="the-workspace"> -<title ->The Work Space</title> - -<para ->The work space is organised as work sheets. Select <guimenuitem ->New</guimenuitem -> from the <guimenu ->File</guimenu -> menu to create a new work sheet. A dialogue will appear where you can set the name, the dimension and the update interval of the work sheet. To remove a work sheet again, select <guimenuitem ->Close</guimenuitem -> from the <guimenu ->File</guimenu -> menu. Any modifications will be saved to the work sheet file. If a work sheet has never been saved, you will be asked for a file name. Work sheets consist of cells organised as a grid.</para> - -<para ->Each cell can be filled with a display for one or more sensors. You can fill a cell by dragging a sensor from the sensor browser and dropping it over the cell. If there is more than one type of display available for that type of sensor, a popup menu will appear. You can then select which display you prefer to use. Certain types of displays can display more than one sensor. Add more sensors to a display by dragging them over from the sensor browser and dropping them over the already existing display.</para> - -<para ->Work sheets can be configured by clicking <guimenuitem ->Configure Worksheet </guimenuitem -> at the <guimenu ->Edit</guimenu -> menu. In the appearing dialogue you can set the dimension and the update interval. This update interval is used by all displays of the worksheet, which has the <guilabel ->use update interval of worksheet</guilabel -> set in its timer configuration dialogue.</para> - -<para ->The entry <guimenuitem ->Configure Style</guimenuitem -> of the <guimenu ->Settings</guimenu -> menu gives you the possibility to configure the global style attributes and apply them to the current active worksheet.</para> - -<para ->Displays can be configured by clicking with the right mouse button on them. A popup menu appear where you can select whether you want to change the properties of that display, remove it from the work sheet, change its update interval type and value or pause and restart its updating.</para> +<title>The Work Space</title> + +<para>The work space is organised as work sheets. Select <guimenuitem>New</guimenuitem> from the <guimenu>File</guimenu> menu to create a new work sheet. A dialogue will appear where you can set the name, the dimension and the update interval of the work sheet. To remove a work sheet again, select <guimenuitem>Close</guimenuitem> from the <guimenu>File</guimenu> menu. Any modifications will be saved to the work sheet file. If a work sheet has never been saved, you will be asked for a file name. Work sheets consist of cells organised as a grid.</para> + +<para>Each cell can be filled with a display for one or more sensors. You can fill a cell by dragging a sensor from the sensor browser and dropping it over the cell. If there is more than one type of display available for that type of sensor, a popup menu will appear. You can then select which display you prefer to use. Certain types of displays can display more than one sensor. Add more sensors to a display by dragging them over from the sensor browser and dropping them over the already existing display.</para> + +<para>Work sheets can be configured by clicking <guimenuitem>Configure Worksheet </guimenuitem> at the <guimenu>Edit</guimenu> menu. In the appearing dialogue you can set the dimension and the update interval. This update interval is used by all displays of the worksheet, which has the <guilabel>use update interval of worksheet</guilabel> set in its timer configuration dialogue.</para> + +<para>The entry <guimenuitem>Configure Style</guimenuitem> of the <guimenu>Settings</guimenu> menu gives you the possibility to configure the global style attributes and apply them to the current active worksheet.</para> + +<para>Displays can be configured by clicking with the right mouse button on them. A popup menu appear where you can select whether you want to change the properties of that display, remove it from the work sheet, change its update interval type and value or pause and restart its updating.</para> <sect2 id="signal-plotter"> -<title ->Signal Plotter</title> +<title>Signal Plotter</title> -<para ->The signal plotter prints samples of one or more sensors over time. If, several sensors are displayed, the values are piled in different colours. If the display is large enough a grid will be displayed to show the range of the plotted samples. By default, the automatic range mode is active so the minimum and maximum values will be set automatically. Sometimes you want fixed minimum and maximum values. In that case, you can deactivate automatic range mode and set the values in the properties dialogue.</para> +<para>The signal plotter prints samples of one or more sensors over time. If, several sensors are displayed, the values are piled in different colours. If the display is large enough a grid will be displayed to show the range of the plotted samples. By default, the automatic range mode is active so the minimum and maximum values will be set automatically. Sometimes you want fixed minimum and maximum values. In that case, you can deactivate automatic range mode and set the values in the properties dialogue.</para> </sect2> <sect2 id="multimeter"> -<title ->Multimeter</title> +<title>Multimeter</title> -<para ->The multimeter displays the sensor values as a digital meter. In the properties dialogue you can specify a lower and upper limit. If the range is exceeded, the display is coloured in the alarm colour.</para> +<para>The multimeter displays the sensor values as a digital meter. In the properties dialogue you can specify a lower and upper limit. If the range is exceeded, the display is coloured in the alarm colour.</para> </sect2> <sect2 id="process-controller"> -<title ->Process Controller</title> +<title>Process Controller</title> -<para ->The Process Controller gives you a list of processes on your system. The list can be sorted by each column. Just press the left mouse button at the head of the column. </para> +<para>The Process Controller gives you a list of processes on your system. The list can be sorted by each column. Just press the left mouse button at the head of the column. </para> -<para ->The list shows the following information about each process. Please note that not all properties are available on every operating system.</para> +<para>The list shows the following information about each process. Please note that not all properties are available on every operating system.</para> <variablelist> <varlistentry> -<term -><guilabel ->Name</guilabel -></term> -<listitem -><para ->The name of the executable that started the process.</para> +<term><guilabel>Name</guilabel></term> +<listitem><para>The name of the executable that started the process.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->PID</guilabel -></term> -<listitem -><para ->The Process <abbrev ->ID</abbrev ->. A unique number for each process.</para -></listitem> +<term><guilabel>PID</guilabel></term> +<listitem><para>The Process <abbrev>ID</abbrev>. A unique number for each process.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->PPID</guilabel -></term> -<listitem -><para ->The Process <abbrev ->ID</abbrev -> of the process parent.</para> +<term><guilabel>PPID</guilabel></term> +<listitem><para>The Process <abbrev>ID</abbrev> of the process parent.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->UID</guilabel -></term> -<listitem -><para ->The <abbrev ->ID</abbrev -> of the user that started the process.</para> +<term><guilabel>UID</guilabel></term> +<listitem><para>The <abbrev>ID</abbrev> of the user that started the process.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->GID</guilabel -></term> -<listitem -><para ->The <abbrev ->ID</abbrev -> of the group the process belongs to.</para> +<term><guilabel>GID</guilabel></term> +<listitem><para>The <abbrev>ID</abbrev> of the group the process belongs to.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Status</guilabel -></term> -<listitem -><para ->The process status.</para -></listitem> +<term><guilabel>Status</guilabel></term> +<listitem><para>The process status.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->User%</guilabel -></term> +<term><guilabel>User%</guilabel></term> <listitem> -<para ->The processor load of the process in user space (in percent).</para> +<para>The processor load of the process in user space (in percent).</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->System%</guilabel -></term> +<term><guilabel>System%</guilabel></term> <listitem> -<para ->The processor load of the process in system space (in percent).</para> +<para>The processor load of the process in system space (in percent).</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Nice</guilabel -></term> -<listitem -><para ->The scheduling priority.</para -></listitem> +<term><guilabel>Nice</guilabel></term> +<listitem><para>The scheduling priority.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->VmSize</guilabel -></term> -<listitem -><para ->The total amount of virtual memory used by the process (in kBytes).</para -></listitem> +<term><guilabel>VmSize</guilabel></term> +<listitem><para>The total amount of virtual memory used by the process (in kBytes).</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->VmRss</guilabel -></term> -<listitem -><para ->The total amount of physical memory used by the process (in kBytes).</para -></listitem> +<term><guilabel>VmRss</guilabel></term> +<listitem><para>The total amount of physical memory used by the process (in kBytes).</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Login</guilabel -></term> -<listitem -><para ->The login name of the user that started the process.</para> +<term><guilabel>Login</guilabel></term> +<listitem><para>The login name of the user that started the process.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Command</guilabel -></term> -<listitem -><para ->The complete start command of the process.</para -></listitem> +<term><guilabel>Command</guilabel></term> +<listitem><para>The complete start command of the process.</para></listitem> </varlistentry> </variablelist> -<para ->Underneath the table you find four buttons which will be described now from left to right.</para> +<para>Underneath the table you find four buttons which will be described now from left to right.</para> <sect3 id="the-tree-view"> -<title ->The <guibutton ->Tree</guibutton -> View</title> +<title>The <guibutton>Tree</guibutton> View</title> -<para ->The tree view has been designed to show the relationships between the running processes. A process that is started by another process is called the child of that process. A tree is an elegant way to show this parent-child relationship. The <emphasis ->init</emphasis -> process is the ancestor of all processes.</para> +<para>The tree view has been designed to show the relationships between the running processes. A process that is started by another process is called the child of that process. A tree is an elegant way to show this parent-child relationship. The <emphasis>init</emphasis> process is the ancestor of all processes.</para> -<para ->If you are not interested in the children of a particular process you can click on the little box to the left of the parent and the subtree will collapse. Another click on that box will unfold the subtree again.</para> +<para>If you are not interested in the children of a particular process you can click on the little box to the left of the parent and the subtree will collapse. Another click on that box will unfold the subtree again.</para> </sect3> <sect3 id="the-process-filter"> -<title ->The Process Filter </title> +<title>The Process Filter </title> -<para ->The Process Filter can be used to reduce the number of processes displayed in the table. You can filter out processes you are not interested in. Currently you can display all processes, system processes only, user processes only or your processes only.</para> +<para>The Process Filter can be used to reduce the number of processes displayed in the table. You can filter out processes you are not interested in. Currently you can display all processes, system processes only, user processes only or your processes only.</para> </sect3> <sect3 id="therefreshbutton"> -<title ->The <guibutton ->Refresh</guibutton -> Button </title> +<title>The <guibutton>Refresh</guibutton> Button </title> -<para ->This button can be used to force an immediate update of the process list.</para> +<para>This button can be used to force an immediate update of the process list.</para> </sect3> <sect3 id="thekillbutton"> -<title ->The <guibutton ->Kill</guibutton -> Button </title> +<title>The <guibutton>Kill</guibutton> Button </title> -<para ->If you have selected one or more processes you can press the kill button to kill them. A so called <errorcode ->SIGKIL</errorcode -> is sent to the processes which causes them to terminate immediately. If these applications still have unsaved data this data will be lost. So use this button with care.</para> +<para>If you have selected one or more processes you can press the kill button to kill them. A so called <errorcode>SIGKIL</errorcode> is sent to the processes which causes them to terminate immediately. If these applications still have unsaved data this data will be lost. So use this button with care.</para> </sect3> </sect2> <sect2 id="bargraph"> -<title ->BarGraph</title> +<title>BarGraph</title> -<para ->The bargraph displays the sensor values as dancing bars. In the properties dialogue you can specify minimum and maximum values of range and a lower and upper limit. If the range is exceeded, the display is coloured in the alarm colour.</para> +<para>The bargraph displays the sensor values as dancing bars. In the properties dialogue you can specify minimum and maximum values of range and a lower and upper limit. If the range is exceeded, the display is coloured in the alarm colour.</para> </sect2> <sect2 id="sensorlogger"> -<title ->Sensor Logger</title> +<title>Sensor Logger</title> -<para ->The sensor logger does not display any values, but logs them in a file with additional date and time information. For each sensor you can specify a lower and upper limit in the properties dialogue. If the range is exceeded, the entry of the sensor table is coloured in the alarm colour and a <application ->knotify</application -> event is sent.</para> +<para>The sensor logger does not display any values, but logs them in a file with additional date and time information. For each sensor you can specify a lower and upper limit in the properties dialogue. If the range is exceeded, the entry of the sensor table is coloured in the alarm colour and a <application>knotify</application> event is sent.</para> </sect2> <sect2 id="logfile"> -<title ->Log File</title> - -<para ->The log file monitor displays the content of a file ⪚ <filename ->/var/log/messages</filename ->. In the properties dialogue, you can compose a list of regular expressions that will be compared with the content of the file. If one of the expressions match, a <application ->knotify</application -> event will be sent. </para> +<title>Log File</title> + +<para>The log file monitor displays the content of a file ⪚ <filename>/var/log/messages</filename>. In the properties dialogue, you can compose a list of regular expressions that will be compared with the content of the file. If one of the expressions match, a <application>knotify</application> event will be sent. </para> </sect2> <sect2 id="listview"> -<title ->List View</title> +<title>List View</title> -<para ->The listview displays the data of some sensors in the form of a table.</para> +<para>The listview displays the data of some sensors in the form of a table.</para> </sect2> </sect1> </chapter> <chapter id="multiple-platforms"> -<title ->Configuring <application ->ksysguardd</application -></title> +<title>Configuring <application>ksysguardd</application></title> -<para ->The graphical front-end is available on any platform that &kde; runs on. The back-end is at the moment available on the following flavours of &UNIX;:</para> +<para>The graphical front-end is available on any platform that &kde; runs on. The back-end is at the moment available on the following flavours of &UNIX;:</para> <variablelist> <varlistentry> -<term ->&Linux; 2.x</term> -<listitem -><para ->For <application ->ksysguardd</application -> to work it is necessary to compile the &Linux; Kernel with the <filename ->/proc</filename -> Filesystem enabled. This is the default setting and most &Linux; Distributions have it already.</para -> </listitem> +<term>&Linux; 2.x</term> +<listitem><para>For <application>ksysguardd</application> to work it is necessary to compile the &Linux; Kernel with the <filename>/proc</filename> Filesystem enabled. This is the default setting and most &Linux; Distributions have it already.</para> </listitem> </varlistentry> <varlistentry> -<term ->FreeBSD</term> -<listitem -><para ->The <application ->ksysguardd</application -> program needs to be owned by the <systemitem class="groupname" ->kmem</systemitem -> group and needs to have the setgid bit set.</para -></listitem -> +<term>FreeBSD</term> +<listitem><para>The <application>ksysguardd</application> program needs to be owned by the <systemitem class="groupname">kmem</systemitem> group and needs to have the setgid bit set.</para></listitem> </varlistentry> <varlistentry> -<term ->&Solaris;</term> -<listitem -><para ->To be written</para -></listitem> +<term>&Solaris;</term> +<listitem><para>To be written</para></listitem> </varlistentry> </variablelist> -<para ->Support for other platforms is in progress. Your help is greatly appreciated.</para> +<para>Support for other platforms is in progress. Your help is greatly appreciated.</para> </chapter> <chapter id="credits-and-licenses"> -<title ->Credits and Licences</title> - -<para ->&ksysguard; is currently developed and maintained by Chris Schläger <email ->cs@kde.org</email ->. &ksysguard; is a rewrite of <application ->KTop</application ->, the KDE 1.x task manager. Several other people have worked on <application ->KTop</application ->:</para> +<title>Credits and Licences</title> + +<para>&ksysguard; is currently developed and maintained by Chris Schläger <email>cs@kde.org</email>. &ksysguard; is a rewrite of <application>KTop</application>, the KDE 1.x task manager. Several other people have worked on <application>KTop</application>:</para> <itemizedlist> -<listitem -><para ->A. Sanda <email ->alex@darkstar.ping.at</email -></para -></listitem> -<listitem -><para ->Ralf Mueller <email ->ralf@bj-ig.de</email -></para -></listitem> -<listitem -><para ->Bernd Johannes Wuebben <email ->wuebben@math.cornell.edu</email -></para -></listitem> -<listitem -><para ->Nicolas Leclercq <email ->nicknet@planete.net</email -></para -></listitem> +<listitem><para>A. Sanda <email>alex@darkstar.ping.at</email></para></listitem> +<listitem><para>Ralf Mueller <email>ralf@bj-ig.de</email></para></listitem> +<listitem><para>Bernd Johannes Wuebben <email>wuebben@math.cornell.edu</email></para></listitem> +<listitem><para>Nicolas Leclercq <email>nicknet@planete.net</email></para></listitem> </itemizedlist> -<para ->The porting to other platforms than &Linux; was done by:</para> +<para>The porting to other platforms than &Linux; was done by:</para> <itemizedlist> -<listitem -><para ->FreeBSD: Hans Petter Bieker <email ->zerium@traad.lavvu.no</email -></para -></listitem -> </itemizedlist -> &underFDL; &underGPL; </chapter> +<listitem><para>FreeBSD: Hans Petter Bieker <email>zerium@traad.lavvu.no</email></para></listitem> </itemizedlist> &underFDL; &underGPL; </chapter> </book> <!-- diff --git a/tde-i18n-en_GB/docs/tdebase/kwrite/index.docbook b/tde-i18n-en_GB/docs/tdebase/kwrite/index.docbook index f1247088cc8..a6a9a99b430 100644 --- a/tde-i18n-en_GB/docs/tdebase/kwrite/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kwrite/index.docbook @@ -1,912 +1,294 @@ <?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 kappname "&kwrite;"> <!ENTITY package "tdebase"> - <!ENTITY % addindex "IGNORE" -> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> -<book lang="&language;" -> - -<bookinfo -> -<title ->The &kwrite; Handbook</title -> -<authorgroup -> -<author ->&Thad.McGinnis; &Thad.McGinnis.mail;</author> - -<othercredit role="developer" ->&Christoph.Cullmann; &Christoph.Cullmann.mail; </othercredit> - -<othercredit role="reviewer" ->&Lauri.Watts; &Lauri.Watts.mail; </othercredit> - -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<book lang="&language;"> + +<bookinfo> +<title>The &kwrite; Handbook</title> +<authorgroup> +<author>&Thad.McGinnis; &Thad.McGinnis.mail;</author> + +<othercredit role="developer">&Christoph.Cullmann; &Christoph.Cullmann.mail; </othercredit> + +<othercredit role="reviewer">&Lauri.Watts; &Lauri.Watts.mail; </othercredit> + +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->2000</year -><year ->2001</year> -<holder ->&Thad.McGinnis;</holder> +<year>2000</year><year>2001</year> +<holder>&Thad.McGinnis;</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2004-08-27</date> -<releaseinfo ->2.00.00</releaseinfo> +<date>2004-08-27</date> +<releaseinfo>2.00.00</releaseinfo> <abstract> -<para ->&kwrite; is a text editor for &kde;</para> +<para>&kwrite; is a text editor for &kde;</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KWrite</keyword> -<keyword ->text</keyword> -<keyword ->editor</keyword> +<keyword>KDE</keyword> +<keyword>KWrite</keyword> +<keyword>text</keyword> +<keyword>editor</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->&kwrite; is more than a text editor for the &kde; 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 colourised syntax, customised for many different programming languages such as: C/C++, &Java;, Python, Perl, Bash, Modula 2, <acronym ->HTML</acronym ->, and Ada. </para> +<para>&kwrite; is more than a text editor for the &kde; 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 colourised syntax, customised for many different programming languages such as: C/C++, &Java;, Python, Perl, Bash, Modula 2, <acronym>HTML</acronym>, and Ada. </para> </chapter> -<chapter id="on-screen-fundamentals" -> -<title ->Some Fundamentals</title -> +<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> +<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 -> +<sect1 id="drag-and-drop"> +<title>Drag and Drop</title> -<para ->&kwrite; uses the &kde; 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> +<para>&kwrite; uses the &kde; 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 KDE 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 -> +<sect1 id="command-line-options"> +<title>Command Line Options</title> + +<para>Though &kwrite; may most often be started from the KDE 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 -> +<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> +<title>Other Command Line Options</title> -<para ->The following command line help options are available</para> +<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 &kde;.</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;, &kde;, and &kwrite;. Also available through <userinput -><command ->kwrite</command -> <option ->-V</option -></userinput -> </para -></listitem> -</varlistentry -> -</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 &kde;.</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;, &kde;, and &kwrite;. Also available through <userinput><command>kwrite</command> <option>-V</option></userinput> </para></listitem> +</varlistentry> +</variablelist> </sect2> -</sect1 -> - -<sect1 id="keybindings" -> -<title ->Key Bindings</title -> - -<para ->Many of the key bindings (shortcuts) are configurable by way of the <link linkend="settings" ->Settings</link -> menu. By default &kwrite; honours the following key bindings.</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 -> +</sect1> + +<sect1 id="keybindings"> +<title>Key Bindings</title> + +<para>Many of the key bindings (shortcuts) are configurable by way of the <link linkend="settings">Settings</link> menu. By default &kwrite; honours the following key bindings.</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" -><keycap ->Page Down</keycap -></keycombo -></para -></entry -> -<entry -><para ->Move the cursor down one page </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" ->&Ctrl;<keycap ->F</keycap -></keycombo -></para -></entry -> -<entry -><para -><link linkend="find" ->Find</link -></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" ->&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 ->B</keycap -></keycombo -></para -></entry -> -<entry -><para ->Set a Bookmark</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 ->P</keycap -></keycombo -></para -></entry -> -<entry -><para -><link linkend="print" ->Print</link -> </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"><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">&Ctrl;<keycap>F</keycap></keycombo></para></entry> +<entry><para><link linkend="find">Find</link></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">&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>B</keycap></keycombo></para></entry> +<entry><para>Set a Bookmark</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>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> +<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> +<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> +<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 ->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 ->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 -> -</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 -> +<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>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> +</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 -> +<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 -> +<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 -> +<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> </shortcut> <guimenu>File</guimenu> <guimenuitem>Open...</guimenuitem> </menuchoice> +</term> <listitem> <!-- @@ -926,12 +308,8 @@ this is a filter which similarly may have data entered directly or chosen from a dropdown list 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 +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. @@ -954,264 +332,111 @@ 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 &kde; <guilabel ->Open File</guilabel -> dialogue. 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 &kde; <guilabel ->Open File</guilabel -> dialogue in the &kde; User Guide.</para> +<para>Displays a standard &kde; <guilabel>Open File</guilabel> dialogue. 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 &kde; <guilabel>Open File</guilabel> dialogue in the &kde; User Guide.</para> </listitem> -</varlistentry -> +</varlistentry> -<varlistentry -> +<varlistentry> <term id="open-recent"> -<menuchoice -><guimenu ->File</guimenu -> <guisubmenu ->Open Recent</guisubmenu -> </menuchoice> -</term -> +<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> +<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 -> +<varlistentry> <term id="save"> -<menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->S</keycap -></keycombo -> </shortcut -> <guimenu ->File</guimenu -> <guimenuitem ->Save</guimenuitem -> </menuchoice> -</term -> +<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 dialogue (described below) will be invoked. </para> -</listitem -> -</varlistentry -> - -<varlistentry -> +<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 dialogue (described below) will be invoked. </para> +</listitem> +</varlistentry> + +<varlistentry> <term id="save-as"> -<menuchoice -><guimenu ->File</guimenu -> <guimenuitem ->Save As...</guimenuitem -> </menuchoice> -</term -> +<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 dialogue box described above in the <link linkend="open" ->Open</link -> section of this help file. </para> +<para>This allows a document to be saved with a new file name. This is done by means of the file dialogue box described above in the <link linkend="open">Open</link> section of this help file. </para> </listitem> </varlistentry> -<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 dialogue allowing the user to specify what, where, and how to print </para -> -</listitem -> -</varlistentry -> +<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 dialogue allowing the user to specify what, where, and how to print </para> +</listitem> +</varlistentry> <!-- -<varlistentry -> +<varlistentry> <term id="new-view"> -<menuchoice -> -<guimenu ->File</guimenu> -<guimenuitem ->New View</guimenuitem> +<menuchoice> +<guimenu>File</guimenu> +<guimenuitem>New View</guimenuitem> </menuchoice> -</term -> -<listitem -> +</term> +<listitem> <para> This creates a new view of the current document, &ie;, a new instance of &kwrite; (as explained in the previous entry) but containing the same document. </para> -</listitem -> -</varlistentry -> +</listitem> +</varlistentry> //--> -<varlistentry -> +<varlistentry> <term id="close"> -<menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->Q</keycap -></keycombo -> </shortcut -> <guimenu ->File</guimenu -> <guimenuitem ->Quit</guimenuitem -> </menuchoice> +<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> +<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 -> +</varlistentry> -</variablelist -> +</variablelist> -</sect1 -> +</sect1> -<sect1 id="edit" -> -<title ->The <guimenu ->Edit</guimenu -> Menu</title -> +<sect1 id="edit"> +<title>The <guimenu>Edit</guimenu> Menu</title> -<variablelist -> +<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. </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="undohistory"/><menuchoice -> -<guimenu ->Edit</guimenu -><guimenuitem ->Undo/Redo -History</guimenuitem -></menuchoice -></term -> -<listitem -> -<para ->This will call a display box showing a list of the most recent actions on +<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. </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="undohistory"/><menuchoice> +<guimenu>Edit</guimenu><guimenuitem>Undo/Redo +History</guimenuitem></menuchoice></term> +<listitem> +<para>This will call a display box showing a list of the most recent actions on the left and another list of actions which have been 'undone' on the right. There are also three buttons at the right of the box labeled -<guibutton ->Undo</guibutton ->, <guibutton ->Redo</guibutton ->, and -<guibutton ->Close</guibutton ->. Clicking on the <guibutton ->Undo</guibutton -> +<guibutton>Undo</guibutton>, <guibutton>Redo</guibutton>, and +<guibutton>Close</guibutton>. Clicking on the <guibutton>Undo</guibutton> button will cause the action at the top of the Undo list to be reversed which will place that particular action at the top of the Redo list. Likewise, -clicking on the <guibutton ->Redo</guibutton -> button will reinstate the reversed +clicking on the <guibutton>Redo</guibutton> button will reinstate the reversed action and move it back to the top of the Undo list. Clicking on an item below @@ -1226,297 +451,94 @@ useful when the user knows precisely the point to which she or he would like to proceed - making it unnecessary to go through a series of single undo or redo -actions.</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 KDE 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 KDE that works invisibly to provide a way to transfer data between applications.</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 KDE 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="invert-the-selection"/><menuchoice -> -<guimenu ->Edit</guimenu -><guimenuitem ->Invert -Selection</guimenuitem -></menuchoice -></term -> -<listitem -> -<para ->This selects any unselected text while unselecting any selected text - -effectively reversing the current state of selection.</para -> -</listitem -> -</varlistentry -> //--> - -<varlistentry -> +actions.</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 KDE 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 KDE that works invisibly to provide a way to transfer data between applications.</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 KDE 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="invert-the-selection"/><menuchoice> +<guimenu>Edit</guimenu><guimenuitem>Invert +Selection</guimenuitem></menuchoice></term> +<listitem> +<para>This selects any unselected text while unselecting any selected text - +effectively reversing the current state of selection.</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 dialogue 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 analogue manner. </para -> -</listitem -> +<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 dialogue 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 analogue manner. </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 dialogue 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 dialogue box.</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 dialogue 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 dialogue 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> +<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 dialogue box, and searching backwards instead of forwards through the document. </para> +<para>This repeats the last find operation, if any, without calling the find dialogue 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 dialogue box. The replace dialogue is almost identical to the above-mentioned find dialogue. In addition to the features in the find dialogue it contains a <guilabel ->Replace With:</guilabel -> text entry/dropdown box. Using this dialogue 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> +<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 dialogue box. The replace dialogue is almost identical to the above-mentioned find dialogue. In addition to the features in the find dialogue it contains a <guilabel>Replace With:</guilabel> text entry/dropdown box. Using this dialogue 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> <menuchoice> <shortcut> -<keycombo action="simul" ->&Ctrl;<keycap ->M</keycap -></keycombo> +<keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo> </shortcut> -<guimenu ->Edit</guimenu> -<guimenuitem ->Editing Command</guimenuitem> +<guimenu>Edit</guimenu> +<guimenuitem>Editing Command</guimenuitem> </menuchoice> </term> <listitem> @@ -1524,36 +546,23 @@ effectively reversing the current state of selection.</para To be written </para> </listitem> -</varlistentry ->//--> +</varlistentry>//--> </variablelist> -</sect1 -> - -<sect1 id="go" -> -<title ->The <guimenu ->Bookmarks</guimenu -> Menu</title -> -<variablelist -> +</sect1> + +<sect1 id="go"> +<title>The <guimenu>Bookmarks</guimenu> Menu</title> +<variablelist> <!-- <varlistentry> <term id="toggle-bookmarks"> <menuchoice> <shortcut> -<keycombo action="simul" ->&Ctrl;<keycap ->B</keycap -></keycombo> +<keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo> </shortcut> -<guimenu ->Bookmarks</guimenu> -<guimenuitem ->Toggle Bookmark</guimenuitem> +<guimenu>Bookmarks</guimenu> +<guimenuitem>Toggle Bookmark</guimenuitem> </menuchoice> </term> <listitem> @@ -1565,345 +574,129 @@ To be written --> <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 -> +<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> </variablelist> -<para ->At the bottom of this menu, a list of markers appears if any markers are available for this window. </para> +<para>At the bottom of this menu, a list of markers appears if any markers are available for this window. </para> -</sect1 -> +</sect1> -<sect1 id="tools" -> -<title ->The <guimenu ->Tools</guimenu -> Menu</title -> +<sect1 id="tools"> +<title>The <guimenu>Tools</guimenu> Menu</title> <variablelist> <varlistentry> -<term -><anchor id="Spelling..."/><menuchoice -><guimenu ->Tools</guimenu -><guimenuitem ->Spelling...</guimenuitem -></menuchoice -></term> - -<listitem -><para -><action ->This initiates the spell checking 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 dialogue box through which the user can control the process. There are four settings lined up vertically in the centre of the dialogue with their corresponding labels just to the left. Starting at the top they are:</para> +<term><anchor id="Spelling..."/><menuchoice><guimenu>Tools</guimenu><guimenuitem>Spelling...</guimenuitem></menuchoice></term> + +<listitem><para><action>This initiates the spell checking 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 dialogue box through which the user can control the process. There are four settings lined up vertically in the centre of the dialogue 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 spell checker 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> +<term><guilabel>Unknown word:</guilabel></term> +<listitem><para>Here, the spell checker 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> +<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> +<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> +<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 dialogue box are 5 buttons that allow the user to control the spell check process. They are:</para> +<para>On the right side of the dialogue box are 5 buttons that allow the user to control the spell check 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> +<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> +<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> +<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> +<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 spell check run. If the checker is run again later it will stop on this same word.</para -></note -></listitem> +<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 spell check 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 spell check dialog is a +<!--<para>Located horizontally along the bottom of the spell check 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 ->//--> +the center of the progress bar.</para>//--> -<!--<note -><para ->A numerical display of the spell check +<!--<note><para>A numerical display of the spell check 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 ->//--> +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 spell check dialogue. They are:</para> +<para>Three more buttons are located horizontally along the bottom of the spell check dialogue. They are:</para> <variablelist> <varlistentry> -<term -><guibutton ->Help</guibutton -></term> -<listitem -><para ->This invokes the KDE help system starting at the &kwrite; help pages (this document).</para -></listitem> +<term><guibutton>Help</guibutton></term> +<listitem><para>This invokes the KDE 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 spell check process, and returns to the document.</para -></listitem> +<term><guibutton>Finished</guibutton></term> +<listitem><para>This button ends the spell check process, and returns to the document.</para></listitem> </varlistentry> <varlistentry> -<term -><guibutton ->Cancel</guibutton -></term> -<listitem -><para ->This button cancels the spell check process, all modifications are reverted, and you will return to your document.</para -></listitem> +<term><guibutton>Cancel</guibutton></term> +<listitem><para>This button cancels the spell check process, all modifications are reverted, and you will return to your document.</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 ->Not yet implemented</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> +<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>Not yet implemented</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> +<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> </variablelist> </listitem> @@ -1913,181 +706,71 @@ of the editor just outside of the text entry area.</para </sect1> <sect1 id="settings"> -<title ->The <guimenu ->Settings</guimenu -> Menu</title> +<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 moveable toolbar containing buttons used to initiate frequently used commands. When unchecked the toolbar is hidden. </para -> -</listitem -> +<term><anchor id="show-toolbar"/><menuchoice><guimenu>Settings</guimenu> <guimenuitem>Show Toolbar</guimenuitem> </menuchoice> +</term> +<listitem> +<para>When checked, this displays a moveable 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 title bar 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> +<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 title bar 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 dialogue whereby several different <link linkend="pref-dialog" ->settings</link -> may be adjusted. </para> -</listitem -> +<para>This menu item opens a dialogue whereby several different <link linkend="pref-dialog">settings</link> may be adjusted. </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 dialogue box whereby the <link linkend="keybindings" ->key bindings</link -> may be changed. A display window at the top of the dialogue 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 dialogue. 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 KDE 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 he or she held down the &Ctrl; and <keycap ->Alt</keycap -> buttons and pressed <keycap ->K</keycap -> (while using &kwrite;) the About KDE 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 dialogue 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><anchor id="configure-keybindings"/><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts...</guimenuitem></menuchoice></term> +<listitem> +<para>This command opens a dialogue box whereby the <link linkend="keybindings">key bindings</link> may be changed. A display window at the top of the dialogue 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 dialogue. 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 KDE 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 he or she held down the &Ctrl; and <keycap>Alt</keycap> buttons and pressed <keycap>K</keycap> (while using &kwrite;) the About KDE 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 dialogue 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 -> +<varlistentry> <term> -<menuchoice -><guimenu -> ->Settings</guimenu -><guimenuitem ->Configure -Highlighting</guimenuitem -></menuchoice -></term -> -<listitem -><para ->Opens a dialog box allowing configuration of the syntax +<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 -> --> +linkend="pref-highlighting"/>.</para></listitem> +</varlistentry> --> <!--<varlistentry> <term> <menuchoice> <shortcut> -<keycombo action="simul" -><keycap ->F6</keycap -></keycombo> +<keycombo action="simul"><keycap>F6</keycap></keycombo> </shortcut> -<guimenu ->Settings</guimenu> -<guimenuitem ->Show Icon Border</guimenuitem> +<guimenu>Settings</guimenu> +<guimenuitem>Show Icon Border</guimenuitem> </menuchoice> </term> <listitem> @@ -2096,530 +779,210 @@ 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>//--> <!--<varlistentry> <term id="vertical-selection"> <menuchoice> <shortcut> -<keycombo action="simul" -><keycap ->F4</keycap -></keycombo> +<keycombo action="simul"><keycap>F4</keycap></keycombo> </shortcut> -<guimenu ->Settings</guimenu> -<guimenuitem ->Vertical Selection</guimenuitem> +<guimenu>Settings</guimenu> +<guimenuitem>Vertical Selection</guimenuitem> </menuchoice> -</term -> -<listitem -> +</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 -> +</para> +</listitem> +</varlistentry> //--> + +<!--<varlistentry> <term id="set-highlight"> -<menuchoice -> -<guimenu ->Settings</guimenu> -<guisubmenu ->Highlight Mode</guisubmenu> +<menuchoice> +<guimenu>Settings</guimenu> +<guisubmenu>Highlight Mode</guisubmenu> </menuchoice> </term> -<listitem -> +<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 +</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 <guimenuitem ->Help</guimenuitem -> Menu</title -> &help.menu.documentation; </sect1 -> +</listitem> +</varlistentry> //--> + +</variablelist> +</sect1> + +<sect1 id="help"> +<title>The <guimenuitem>Help</guimenuitem> 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 -> dialogue box. This dialogue 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 dialogue. By means of three buttons along the bottom of the box the user can control the process. </para> - -<para ->She or he may invoke the <guilabel ->Help</guilabel -> system, accept the current settings and close the dialogue by means of the <guibutton ->OK</guibutton -> button, or <guibutton ->Cancel</guibutton -> the process. The categories <guilabel ->Colours</guilabel ->, <guilabel ->Fonts</guilabel -> <guilabel ->Indent</guilabel ->, <guilabel ->Select</guilabel ->, <guilabel ->Edit</guilabel ->, <guilabel ->Spelling</guilabel -> and <guilabel ->Highlighting</guilabel -> are detailed below. </para> +<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> dialogue box. This dialogue 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 dialogue. By means of three buttons along the bottom of the box the user can control the process. </para> + +<para>She or he may invoke the <guilabel>Help</guilabel> system, accept the current settings and close the dialogue by means of the <guibutton>OK</guibutton> button, or <guibutton>Cancel</guibutton> the process. The categories <guilabel>Colours</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="prefcolors"> -<title ->Colours</title> - -<para ->This section provides access to <link linkend="pref-color-settings" ->two different colour settings</link ->, described below. Each of these settings may be changed by clicking on its corresponding button. These are special wide buttons that are the colour of the current setting. Clicking on one of the buttons calls a special colour dialogue box used to change the setting.</para -> - -<para ->The colour dialogue box provides a convenient and graphical way to select a colour. In the upper left of the box is a rectangular display of a spectrum of colours. To the immediate right of this, is vertical bar displaying a range of intensity from the most dark at the bottom to the most light at the top. The user may select and adjust a colour by clicking in these two boxes. Clicking in the rectangular display selects a particular mix of red, green, and blue colours and in the vertical bar selects a level of intensity (value). The various colour attributes are displayed in numerical form in small text boxes located directly below the spectral rectangle and the user can see them change as the colour is adjusted. These attributes include the mix of the basic colour components (red, green, and blue) as well as hue and saturation levels. Alternatively the user can enter figures directly in these boxes. There is also a square at the bottom centre of the dialogue box which displays the colour which is under consideration at any time. To the right of this display is another text box labelled <guilabel ->HTML:</guilabel -> This shows the user the colour code that would be used to specify the particular displayed colour in <acronym ->HTML</acronym -> code which is widely used for web pages.</para -> - -<para ->In addition to the above, the colour dialogue allows the capture of any colour currently displayed on the desktop or in another program. Clicking on the button with the dropper icon (located on the right side of the dialogue box,) changes the shape of the mouse cursor to a set of crosshairs. Clicking again will pick up the colour attributes of whatever colour is displayed under the cross hairs.</para -> - -<para ->Furthermore the user has the option of adding any colour to a personal palette of <quote ->Custom Colours</quote -> by clicking on the wide button labelled <guibutton ->Add to Custom Colours</guibutton -> (which is located directly above the display square.) This adds the current colour to the custom colour palette. This palette and any other available palettes can be displayed using the drop down selection box located directly above the palette display at the top right of the dialogue box. Besides the custom colours, the user can access a number of pre-prepared palettes.</para> - -<variablelist -> - -<varlistentry id="pref-color-settings" -> -<term -><guilabel ->Background</guilabel -></term -> -<listitem -><para ->Here the user can specify a colour for the general background of &kwrite;.</para -></listitem -> -</varlistentry -> - -<varlistentry -> -<term -><guilabel ->Selected</guilabel -></term -> -<listitem -><para ->This allows the user to select a colour to be used for indicating selected (or highlighted) portions of the document.</para -></listitem -> </varlistentry -> -</variablelist -> -</sect1 -> +<title>Colours</title> + +<para>This section provides access to <link linkend="pref-color-settings">two different colour settings</link>, described below. Each of these settings may be changed by clicking on its corresponding button. These are special wide buttons that are the colour of the current setting. Clicking on one of the buttons calls a special colour dialogue box used to change the setting.</para> + +<para>The colour dialogue box provides a convenient and graphical way to select a colour. In the upper left of the box is a rectangular display of a spectrum of colours. To the immediate right of this, is vertical bar displaying a range of intensity from the most dark at the bottom to the most light at the top. The user may select and adjust a colour by clicking in these two boxes. Clicking in the rectangular display selects a particular mix of red, green, and blue colours and in the vertical bar selects a level of intensity (value). The various colour attributes are displayed in numerical form in small text boxes located directly below the spectral rectangle and the user can see them change as the colour is adjusted. These attributes include the mix of the basic colour components (red, green, and blue) as well as hue and saturation levels. Alternatively the user can enter figures directly in these boxes. There is also a square at the bottom centre of the dialogue box which displays the colour which is under consideration at any time. To the right of this display is another text box labelled <guilabel>HTML:</guilabel> This shows the user the colour code that would be used to specify the particular displayed colour in <acronym>HTML</acronym> code which is widely used for web pages.</para> + +<para>In addition to the above, the colour dialogue allows the capture of any colour currently displayed on the desktop or in another program. Clicking on the button with the dropper icon (located on the right side of the dialogue box,) changes the shape of the mouse cursor to a set of crosshairs. Clicking again will pick up the colour attributes of whatever colour is displayed under the cross hairs.</para> + +<para>Furthermore the user has the option of adding any colour to a personal palette of <quote>Custom Colours</quote> by clicking on the wide button labelled <guibutton>Add to Custom Colours</guibutton> (which is located directly above the display square.) This adds the current colour to the custom colour palette. This palette and any other available palettes can be displayed using the drop down selection box located directly above the palette display at the top right of the dialogue box. Besides the custom colours, the user can access a number of pre-prepared palettes.</para> + +<variablelist> + +<varlistentry id="pref-color-settings"> +<term><guilabel>Background</guilabel></term> +<listitem><para>Here the user can specify a colour for the general background of &kwrite;.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Selected</guilabel></term> +<listitem><para>This allows the user to select a colour to be used for indicating selected (or highlighted) portions of the document.</para></listitem> </varlistentry> +</variablelist> +</sect1> <sect1 id="pref-fonts"> -<title ->Fonts</title> +<title>Fonts</title> -<para ->Here you can choose the default font for &kwrite;. You can choose from any font available on your system, and set a default size and encoding. A sample text displays at the bottom of the dialogue, so you can see the effect of your choices. </para> +<para>Here you can choose the default font for &kwrite;. You can choose from any font available on your system, and set a default size and encoding. A sample text displays at the bottom of the dialogue, so you can see the effect of your choices. </para> </sect1> -<sect1 id="pref-indent" -> -<title ->Indent</title -> -<variablelist -> - -<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 -> - -<varlistentry -> -<term -><guilabel ->Indent With Spaces</guilabel -></term -> <listitem -><para ->This replaces tabs with the number of spaces selected in the Tab Width window in the <link linkend="pref-edit" ->Edit</link -> section of the preferences dialogue.</para -></listitem -> -</varlistentry -> - -<varlistentry -> -<term -><guilabel ->Backspace Key Indents</guilabel -></term -> -<listitem -><para ->This allows the <keycombo action="simul" -><keycap ->backspace</keycap -></keycombo -> key to be used to indent.</para -></listitem -> -</varlistentry -> - -<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 ->Keep Extra Spaces</guilabel -></term -> -<listitem -><para ->Indentations of more than the selected number of spaces will not be shortened.</para -></listitem -> -</varlistentry -> - -</variablelist -> -</sect1 -> +<sect1 id="pref-indent"> +<title>Indent</title> +<variablelist> + +<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> + +<varlistentry> +<term><guilabel>Indent With Spaces</guilabel></term> <listitem><para>This replaces tabs with the number of spaces selected in the Tab Width window in the <link linkend="pref-edit">Edit</link> section of the preferences dialogue.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Backspace Key Indents</guilabel></term> +<listitem><para>This allows the <keycombo action="simul"><keycap>backspace</keycap></keycombo> key to be used to indent.</para></listitem> +</varlistentry> + +<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>Keep Extra Spaces</guilabel></term> +<listitem><para>Indentations of more than the selected number of spaces will not be shortened.</para></listitem> +</varlistentry> + +</variablelist> +</sect1> <!-- 2004-08-27 Out of date - getting it out of the translators' way - Phil -<sect1 id="pref-select" -> -<title ->Select</title -> -<variablelist -> - -<varlistentry -> -<term -><guilabel ->Persistent Selections</guilabel -></term -> -<listitem -><para ->This prevents key input or cursor movement by way of the +<sect1 id="pref-select"> +<title>Select</title> +<variablelist> + +<varlistentry> +<term><guilabel>Persistent Selections</guilabel></term> +<listitem><para>This prevents key input or cursor movement by way of the arrow keys from causing the elimination of text -selection. </para -><note -><para ->(Note: If the Overwrite Selections option is +selection. </para><note><para>(Note: If the Overwrite Selections option is activated then any typed character input or paste operation will replace -the selected text.)</para -></note -></listitem -> </varlistentry -> - -<varlistentry -> <term -><guilabel ->Overwrite Selections</guilabel -></term -> -<listitem -><para ->Any keyed character input or paste operation will replace -the selected text. </para -></listitem -> -</varlistentry -> - -<varlistentry -> -<term -><guilabel ->Mouse Autocopy</guilabel -></term -> <listitem -><para ->Any text +the selected text.)</para></note></listitem> </varlistentry> + +<varlistentry> <term><guilabel>Overwrite Selections</guilabel></term> +<listitem><para>Any keyed character input or paste operation will replace +the selected text. </para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Mouse Autocopy</guilabel></term> <listitem><para>Any text selected with the mouse will be automatically copied to the -clipboard.</para -></listitem -> -</varlistentry -> - -<varlistentry -> -<term -><guilabel ->X11-like Single Selection</guilabel -></term -> -<listitem -><para ->Not implemented yet.</para -></listitem -> -</varlistentry -> - - -<varlistentry -> -<term ->Toggle Old</term -> <listitem -><para ->Not yet implemented</para -></listitem -> -</varlistentry -> - -</variablelist -> -</sect1 -> +clipboard.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>X11-like Single Selection</guilabel></term> +<listitem><para>Not implemented yet.</para></listitem> +</varlistentry> + + +<varlistentry> +<term>Toggle Old</term> <listitem><para>Not yet implemented</para></listitem> +</varlistentry> + +</variablelist> +</sect1> --> -<sect1 id="pref-edit" -> -<title ->Edit</title -> -<variablelist -> -<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 -></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 -> - -<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 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 -> - -<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> +<sect1 id="pref-edit"> +<title>Edit</title> +<variablelist> +<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></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> + +<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 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> + +<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> <!-- Outdated <varlistentry> -<term id="group-undos" -><guilabel ->Group Undos</guilabel -></term> -<listitem -><para ->Groups of similar actions are to be considered a single -<link linkend="undo" ->Undo</link -> step by &kwrite;. In other words, a series +<term id="group-undos"><guilabel>Group Undos</guilabel></term> +<listitem><para>Groups of similar actions are to be considered a single +<link linkend="undo">Undo</link> step by &kwrite;. In other words, a series of regular character keystrokes (words or expressions) would be considered one step and therefore be removed by a single undo operation. If the series of character entries were interrupted by a non-character entry operation (such as a backspace), invoking undo would only remove the entries made since that operation. The next undo would then reverse that operation and so on.</para> -<para -> When this option is not selected &kwrite; considers +<para> When this option is not selected &kwrite; considers each keystroke to be a single step. So if the user (with this option active) were to type several words or even sentences without having to make corrections or cut or paste or some other non-character entry operation @@ -2628,85 +991,36 @@ since the last non-entry operation. A second click would eliminate that operation and a third any operation or series of entries that occurred before the operation and so on. When not selected three clicks of the undo button would only remove the last three letters typed, or the last three -operations.</para -></listitem -> -</varlistentry -> +operations.</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 -> +<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> <!-- <varlistentry> -<term -><guilabel ->Smart Home</guilabel -></term> -<listitem -><para ->Not yet implemented</para -></listitem> +<term><guilabel>Smart Home</guilabel></term> +<listitem><para>Not yet implemented</para></listitem> </varlistentry> --> <varlistentry> -<term -><guilabel ->Page Up/Down Moves Cursor</guilabel -></term> -<listitem -><para ->This option changes the behaviour 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> +<term><guilabel>Page Up/Down Moves Cursor</guilabel></term> +<listitem><para>This option changes the behaviour 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 ->Wrap Cursor</term -> -<listitem -><para ->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> -<para ->When this option is chosen, clicking with the mouse past the end of a line of text will place the insert cursor <emphasis ->at the end of the text</emphasis ->, and not in the place you clicked. This avoids accidentally adding an empty space in the middle of text, and is the default behaviour of most editors. </para> +<term>Wrap Cursor</term> +<listitem><para>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> +<para>When this option is chosen, clicking with the mouse past the end of a line of text will place the insert cursor <emphasis>at the end of the text</emphasis>, and not in the place you clicked. This avoids accidentally adding an empty space in the middle of text, and is the default behaviour of most editors. </para> </listitem> </varlistentry> <varlistentry> -<term -><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> +<term><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> <!-- Outdated <varlistentry> -<term ->Encoding</term> +<term>Encoding</term> <listitem> <para> This sets the character encoding for your file. @@ -2718,73 +1032,29 @@ This sets the character encoding for your file. </sect1> <sect1 id="prefspellchecker"> -<title ->Spelling</title -> <para ->A spell checker is a program designed to help the user catch and correct any spelling errors. This section of the preferences dialogue allows certain important settings to be adjusted in this regard.</para> +<title>Spelling</title> <para>A spell checker is a program designed to help the user catch and correct any spelling errors. This section of the preferences dialogue allows certain important settings to be adjusted in this regard.</para> <variablelist> <varlistentry> -<term -><guilabel ->Create root/affix combinations not in dictionary</guilabel -></term -> <listitem -><para ->Selecting this option allows the spell checker to register as 'correct' combinations of root words with suffixes or prefixes even if the particular combination is not listed in its dictionary data base of words.</para -></listitem> +<term><guilabel>Create root/affix combinations not in dictionary</guilabel></term> <listitem><para>Selecting this option allows the spell checker to register as 'correct' combinations of root words with suffixes or prefixes even if the particular combination is not listed in its dictionary data base of words.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Consider run-together words as spelling errors</guilabel -></term -> <listitem -><para ->Selecting this will cause the spell checker to register as 'misspelled' two or more correctly spelled words that are 'run-together', <abbrev ->i.e.</abbrev ->, that do not have spaces separating them.</para -></listitem> +<term><guilabel>Consider run-together words as spelling errors</guilabel></term> <listitem><para>Selecting this will cause the spell checker to register as 'misspelled' two or more correctly spelled words that are 'run-together', <abbrev>i.e.</abbrev>, that do not have spaces separating them.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Dictionary:</guilabel -></term -> <listitem -><para ->Depending on the user's installation one or more different language spelling dictionaries may be available. This drop down box allows the user to choose which language the spell checker should use.</para -></listitem> - -</varlistentry -> - -<varlistentry -> -<term -><guilabel ->Encoding:</guilabel -></term -> <listitem -><para ->There are different coding systems used to associate particular codes with particular characters and symbols. If the user knows which code he or she is using this drop down box allows this code to be specified so that the spell checker can do its job correctly. </para -></listitem -> </varlistentry> +<term><guilabel>Dictionary:</guilabel></term> <listitem><para>Depending on the user's installation one or more different language spelling dictionaries may be available. This drop down box allows the user to choose which language the spell checker should use.</para></listitem> + +</varlistentry> + +<varlistentry> +<term><guilabel>Encoding:</guilabel></term> <listitem><para>There are different coding systems used to associate particular codes with particular characters and symbols. If the user knows which code he or she is using this drop down box allows this code to be specified so that the spell checker can do its job correctly. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Client:</guilabel -></term -> <listitem -><para ->Since &kwrite; does not contain its own spell checker, an external one must be chosen. This is where the user may specify which spell check program to use.</para -></listitem -> </varlistentry> +<term><guilabel>Client:</guilabel></term> <listitem><para>Since &kwrite; does not contain its own spell checker, an external one must be chosen. This is where the user may specify which spell check program to use.</para></listitem> </varlistentry> </variablelist> </sect1> @@ -2795,33 +1065,19 @@ This sets the character encoding for your file. Whole chapter is out of date, moving out of translators' way -Phil <chapter id="pref-highlighting"> -<title ->Highlighting</title> - -<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 +<title>Highlighting</title> + +<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 +<para>Items available on the <guilabel>Defaults</guilabel> page are as follows:</para> <variablelist> <varlistentry> -<term -><guilabel ->Default Item Styles</guilabel -></term> +<term><guilabel>Default Item Styles</guilabel></term> <listitem> <para> The user can configure the default appearance for particular items. @@ -2831,384 +1087,196 @@ This would allow a programmer to more easily identify different items <variablelist> <varlistentry> -<term -><guilabel ->Item</guilabel -></term> -<listitem -><para ->This drop down list 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 +<term><guilabel>Item</guilabel></term> +<listitem><para>This drop down list 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> +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 +<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> +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> +<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> +<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 +<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> +linkend="prefcolors">Colors</link> section of <link +linkend="pref-dialog">Configure KWrite</link>.</para> </listitem> </varlistentry> </variablelist> </listitem> </varlistentry> -</variablelist -> +</variablelist> -<para ->Items on the <guilabel ->Highlight Modes</guilabel -> tab allow the user to define +<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 +<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 +(<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 -> +<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> +<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 list, and then choose Comment in the -<guilabel ->Item</guilabel -> drop down list. To have <quote ->comments</quote -> look +<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 list, and then choose Comment in the +<guilabel>Item</guilabel> drop down list. 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> +<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 -> checkbox causes the default +<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> checkbox 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> +<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 +<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> +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 -> checkbox 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> +<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> checkbox 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> -</chapter -> +</chapter> --> -<chapter id="credits" -> -<title ->Credits and Licences</title -> +<chapter id="credits"> +<title>Credits and Licences</title> -<para ->&kwrite; Copyright 2001 by the &kate; team.</para> +<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>Based on the original &kwrite;, which was Copyright 2000 by Jochen Wilhelmy <email>digisnap@cs.tu-berlin.de</email> </para> -<para ->Contributions:</para -> +<para>Contributions:</para> <itemizedlist> <listitem> -<para ->&Christoph.Cullmann; &Christoph.Cullmann.mail;</para> +<para>&Christoph.Cullmann; &Christoph.Cullmann.mail;</para> </listitem> <listitem> -<para ->Michael Bartl <email ->michael.bartl1@chello.at</email -></para> +<para>Michael Bartl <email>michael.bartl1@chello.at</email></para> </listitem> <listitem> -<para ->Phlip <email ->phlip_cpp@my-deja.com</email -></para> +<para>Phlip <email>phlip_cpp@my-deja.com</email></para> </listitem> <listitem> -<para ->&Anders.Lund; &Anders.Lund.mail;</para> +<para>&Anders.Lund; &Anders.Lund.mail;</para> </listitem> <listitem> -<para ->Matt Newell <email ->newellm@proaxis.com</email -></para> +<para>Matt Newell <email>newellm@proaxis.com</email></para> </listitem> <listitem> -<para ->&Joseph.Wenninger; &Joseph.Wenninger.mail;</para> +<para>&Joseph.Wenninger; &Joseph.Wenninger.mail;</para> </listitem> <listitem> -<para ->Jochen Wilhely <email ->digisnap@cs.tu-berlin.de</email -></para> +<para>Jochen Wilhely <email>digisnap@cs.tu-berlin.de</email></para> </listitem> <listitem> -<para ->&Michael.Koch; &Michael.Koch.mail;</para> +<para>&Michael.Koch; &Michael.Koch.mail;</para> </listitem> <listitem> -<para ->&Christian.Gebauer; &Christian.Gebauer.mail;</para> +<para>&Christian.Gebauer; &Christian.Gebauer.mail;</para> </listitem> <listitem> -<para ->&Simon.Hausmann; &Simon.Hausmann.mail;</para> +<para>&Simon.Hausmann; &Simon.Hausmann.mail;</para> </listitem> <listitem> -<para ->Glen Parker <email ->glenebob@nwlink.com</email -></para> +<para>Glen Parker <email>glenebob@nwlink.com</email></para> </listitem> <listitem> -<para ->Scott Manson <email ->sdmanson@altel.net</email -></para> +<para>Scott Manson <email>sdmanson@altel.net</email></para> </listitem> <listitem> -<para ->&John.Firebaugh; &John.Firebaugh.mail;</para> +<para>&John.Firebaugh; &John.Firebaugh.mail;</para> </listitem> </itemizedlist> -<para ->Original documentation by &Thad.McGinnis; &Thad.McGinnis.mail; </para> +<para>Original documentation by &Thad.McGinnis; &Thad.McGinnis.mail; </para> -<para ->This version of the &kwrite; Handbook is based on the original by &Cristian.Tibirna; &Cristian.Tibirna.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> +<para>Converted to docbook/proofreading by &Lauri.Watts; &Lauri.Watts.mail; </para> -<para ->Conversion to British English: John Knight <email ->anarchist_tomato@herzeleid.net</email -></para -> -&underFDL; &underGPL; </chapter -> +<para>Conversion to British English: John Knight <email>anarchist_tomato@herzeleid.net</email></para> +&underFDL; &underGPL; </chapter> &documentation.index; -</book -> +</book> <!-- Local Variables: mode: sgml diff --git a/tde-i18n-en_GB/docs/tdebase/kxkb/index.docbook b/tde-i18n-en_GB/docs/tdebase/kxkb/index.docbook index 227f8914731..3ed9805ef7a 100644 --- a/tde-i18n-en_GB/docs/tdebase/kxkb/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kxkb/index.docbook @@ -4,227 +4,117 @@ <!ENTITY kappname "&kxkb;"> <!ENTITY package "tdebase"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <book lang="&language;"> <bookinfo> -<title ->The &kxkb; Handbook</title> +<title>The &kxkb; Handbook</title> <authorgroup> -<author ->&Andriy.Rysin; &Andriy.Rysin.mail; </author> - -<othercredit role="developer" ->&Andriy.Rysin; &Andriy.Rysin.mail; </othercredit> - -<othercredit role="translator" -><firstname ->Jonathan</firstname -><surname ->Riddell</surname -><affiliation -><address -><email ->kde-en-gb@jriddell.org</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Andriy.Rysin; &Andriy.Rysin.mail; </author> + +<othercredit role="developer">&Andriy.Rysin; &Andriy.Rysin.mail; </othercredit> + +<othercredit role="translator"><firstname>Jonathan</firstname><surname>Riddell</surname><affiliation><address><email>kde-en-gb@jriddell.org</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->2003</year> -<holder ->&Andriy.Rysin;</holder> +<year>2003</year> +<holder>&Andriy.Rysin;</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2003-08-23</date> -<releaseinfo ->1.01.00</releaseinfo> +<date>2003-08-23</date> +<releaseinfo>1.01.00</releaseinfo> -<abstract -><para ->&kxkb; is a keyboard layout switching utility based on X11 xkb extension.</para -></abstract -> +<abstract><para>&kxkb; is a keyboard layout switching utility based on X11 xkb extension.</para></abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->kxkb</keyword> -<keyword ->keyboard</keyword> -<keyword ->layout</keyword> +<keyword>KDE</keyword> +<keyword>kxkb</keyword> +<keyword>keyboard</keyword> +<keyword>layout</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->&kxkb; is the &kde; keyboard layout switching utility. It is based on X11 xkb extension and allows to use different keyboard layouts for inputing text. &kxkb; features keyboard layout indicator. </para> +<para>&kxkb; is the &kde; keyboard layout switching utility. It is based on X11 xkb extension and allows to use different keyboard layouts for inputing text. &kxkb; features keyboard layout indicator. </para> </chapter> <chapter id="usingthekxkb"> -<title ->Using &kxkb;</title> +<title>Using &kxkb;</title> <sect1 id="getting-started"> -<title ->Getting Started</title> - -<para ->&kxkb; starts automatically and stays in system tray as a flag with 2 or 3 letter abbreviation of layout name on top of it if more than one layout is defined or <guilabel ->Show indicator for single layout</guilabel -> option is turned on.</para> - -<para ->When &kxkb; is running you can change layouts clicking on its tray icon with the mouse or pressing its keyboard shortcut. Keyboard shortcut or mouse click will switch to next layout or alternatively you can &RMB; click the &kxkb; icon and select layout from the list.</para> - -<para ->&RMB; clicking on the &kxkb; icon you can start its configuration by selecting <guimenuitem ->Configure...</guimenuitem -> or by opening <application ->Control Centre</application -> and selecting Localisation/Keyboard Layout. Alternatively, you can start it by typing <command ->tdecmshell keyboard_layout</command -> in a terminal.</para> +<title>Getting Started</title> + +<para>&kxkb; starts automatically and stays in system tray as a flag with 2 or 3 letter abbreviation of layout name on top of it if more than one layout is defined or <guilabel>Show indicator for single layout</guilabel> option is turned on.</para> + +<para>When &kxkb; is running you can change layouts clicking on its tray icon with the mouse or pressing its keyboard shortcut. Keyboard shortcut or mouse click will switch to next layout or alternatively you can &RMB; click the &kxkb; icon and select layout from the list.</para> + +<para>&RMB; clicking on the &kxkb; icon you can start its configuration by selecting <guimenuitem>Configure...</guimenuitem> or by opening <application>Control Centre</application> and selecting Localisation/Keyboard Layout. Alternatively, you can start it by typing <command>tdecmshell keyboard_layout</command> in a terminal.</para> </sect1> </chapter> <chapter id="configuringkxkb"> -<title ->Configuring &kxkb;</title> +<title>Configuring &kxkb;</title> <sect1 id="general-config"> -<title ->General Information</title> -<para ->KXKB Configuration consists of two tabs: Layout Configuration and XKB Options which are mutually independent. The first one defines layouts you want to use and their options and second defines parameters for Xkb extension on which &kxkb; is based. Xkb options are property of X and are not handled in any way by kxkb - it just sets it up. </para> -<note -><para ->&kxkb; configuration does not change anything in XFree86 configuration files and Layout settings from XFree86 configuration are overridden by &kxkb; if <option ->Enable keyboard layout</option -> option is turned on. </para -></note> -<note -><para ->To make your XFree86 configuration work you have to turn off both <option ->Enable keyboard layout</option -> in layout configuration tab <emphasis ->and</emphasis -> <option ->Enable xkb options</option -> in Xkb options configuration tab (for the latter the same effect can be reached if <option ->Reset Old Options</option -> is turned off and none of xkb options are set). </para -></note> -<para ->&kxkb; does most of its actions through <command ->setxkbmap</command -> command. You can see the commandline to be executed for each active layout when you select it and, on the xkb options tab, its available xkb option set. </para> +<title>General Information</title> +<para>KXKB Configuration consists of two tabs: Layout Configuration and XKB Options which are mutually independent. The first one defines layouts you want to use and their options and second defines parameters for Xkb extension on which &kxkb; is based. Xkb options are property of X and are not handled in any way by kxkb - it just sets it up. </para> +<note><para>&kxkb; configuration does not change anything in XFree86 configuration files and Layout settings from XFree86 configuration are overridden by &kxkb; if <option>Enable keyboard layout</option> option is turned on. </para></note> +<note><para>To make your XFree86 configuration work you have to turn off both <option>Enable keyboard layout</option> in layout configuration tab <emphasis>and</emphasis> <option>Enable xkb options</option> in Xkb options configuration tab (for the latter the same effect can be reached if <option>Reset Old Options</option> is turned off and none of xkb options are set). </para></note> +<para>&kxkb; does most of its actions through <command>setxkbmap</command> command. You can see the commandline to be executed for each active layout when you select it and, on the xkb options tab, its available xkb option set. </para> </sect1> <sect1 id="layout-config"> -<title ->Layout Configuration</title> -<para ->In layout configuration dialogue the list of available layouts on your left. You have to choose each layout you want to use and add them (one by one) to the list of active layouts on the right. You can also change the order in which active layouts will be switched when toggled by keyboard shortcut or mouse button. The first layout in the list becomes default layout. </para> -<para ->Some layouts have several variants. Layout variants usually represent different key maps for the same language. For example, Ukrainian layout might have four variants: basic, winkeys (as in Windows), typewriter (as in typewriters) and phonetic (each Ukrainian letter is placed on a transliterated latin one). If your layout is multi-variant one you can the variant in combobox below the active layouts list. </para> -<para ->Keyboard model setting is independent of your keyboard layout and refers to the "hardware" model, i.e. the way your keyboard is manufactured. Modern keyboards that come with your computer usually have two extra keys and are referred to as "104-key" models, which is probably what you want if you don't know what kind of keyboard you have. </para> -<para ->You can also choose switching policy for keyboard layout. By default it's <option ->Global meaning</option -> all applications will share the same current layout. <option ->Application</option -> means each application will have it's own layout and switching layout while you are working with one application will not impact layout for any others. <option ->Window</option -> will make every window have its own layout even if they belong to the same program. </para> -<para ->If you set only one active layout, at startup kxkb configures the keyboard and exits thus its indicator will not appear. If you still want kxkb indicator select <option ->Show indicator for single layout</option -> option. </para> +<title>Layout Configuration</title> +<para>In layout configuration dialogue the list of available layouts on your left. You have to choose each layout you want to use and add them (one by one) to the list of active layouts on the right. You can also change the order in which active layouts will be switched when toggled by keyboard shortcut or mouse button. The first layout in the list becomes default layout. </para> +<para>Some layouts have several variants. Layout variants usually represent different key maps for the same language. For example, Ukrainian layout might have four variants: basic, winkeys (as in Windows), typewriter (as in typewriters) and phonetic (each Ukrainian letter is placed on a transliterated latin one). If your layout is multi-variant one you can the variant in combobox below the active layouts list. </para> +<para>Keyboard model setting is independent of your keyboard layout and refers to the "hardware" model, i.e. the way your keyboard is manufactured. Modern keyboards that come with your computer usually have two extra keys and are referred to as "104-key" models, which is probably what you want if you don't know what kind of keyboard you have. </para> +<para>You can also choose switching policy for keyboard layout. By default it's <option>Global meaning</option> all applications will share the same current layout. <option>Application</option> means each application will have it's own layout and switching layout while you are working with one application will not impact layout for any others. <option>Window</option> will make every window have its own layout even if they belong to the same program. </para> +<para>If you set only one active layout, at startup kxkb configures the keyboard and exits thus its indicator will not appear. If you still want kxkb indicator select <option>Show indicator for single layout</option> option. </para> <note> -<para ->If you leave active layout list empty keyboard layouts will be disabled </para> +<para>If you leave active layout list empty keyboard layouts will be disabled </para> </note> </sect1> <sect1 id="xkboptions-config"> -<title ->XKB Options Configuration</title> -<para ->Xkb options allow you to select behaviour of your keyboard. These options are not handled by &kxkb; but may help tune your keyboard to your needs. </para> +<title>XKB Options Configuration</title> +<para>Xkb options allow you to select behaviour of your keyboard. These options are not handled by &kxkb; but may help tune your keyboard to your needs. </para> </sect1> </chapter> <chapter id="kxkbtroubleshooting"> -<title ->Troubleshooting</title> +<title>Troubleshooting</title> <sect1 id="troubles"> -<title ->Common Problems</title> +<title>Common Problems</title> -<para ->If you switch to some layout and you can not see some characters from your layout as you type, please check your local settings. ⪚ <filename ->~/.i18n</filename -> or <filename ->/etc/sysconfig/i18n</filename ->, locale you have before starting kde applications must have an encoding which contains characters from your layout. For example, to enter ukrainian symbols you must have encoding KOI8-U, CP1251 or UTF-8. The last one is a good choice to try for most of the languages if you have such a problem. </para> +<para>If you switch to some layout and you can not see some characters from your layout as you type, please check your local settings. ⪚ <filename>~/.i18n</filename> or <filename>/etc/sysconfig/i18n</filename>, locale you have before starting kde applications must have an encoding which contains characters from your layout. For example, to enter ukrainian symbols you must have encoding KOI8-U, CP1251 or UTF-8. The last one is a good choice to try for most of the languages if you have such a problem. </para> -<para ->If kxkb does not switch with keyboard shortcut when you switch it to some layout but switching with mouse is ok may mean that your layout does not contain the key assigned in shortcut.</para> +<para>If kxkb does not switch with keyboard shortcut when you switch it to some layout but switching with mouse is ok may mean that your layout does not contain the key assigned in shortcut.</para> -<para ->In XFree86 prior to version 4.3.0 non-latin layouts mutually included latin group and this group was the default thus pressing <keycombo action="simul" ->&Ctrl;&Alt;<keycap ->k</keycap -></keycombo -> always yielded the right combination. From version 4.3.0 by default all layouts contain only one group thus non-latin layouts may not work here.</para> +<para>In XFree86 prior to version 4.3.0 non-latin layouts mutually included latin group and this group was the default thus pressing <keycombo action="simul">&Ctrl;&Alt;<keycap>k</keycap></keycombo> always yielded the right combination. From version 4.3.0 by default all layouts contain only one group thus non-latin layouts may not work here.</para> -<para ->Possible solutions are:</para> +<para>Possible solutions are:</para> <orderedlist> <listitem> -<para ->add your layout to $nonlatin or $oldlayouts lists in <filename ->/etc/X11/xkb/rules/xfree86</filename -> or the location of the xkb rules on your computer.</para> +<para>add your layout to $nonlatin or $oldlayouts lists in <filename>/etc/X11/xkb/rules/xfree86</filename> or the location of the xkb rules on your computer.</para> </listitem> <listitem> -<para ->Change the shortcut to something language neutral, ⪚ <keycombo action="simul" ->&Ctrl;<keycap ->Menu</keycap -></keycombo -></para> +<para>Change the shortcut to something language neutral, ⪚ <keycombo action="simul">&Ctrl;<keycap>Menu</keycap></keycombo></para> </listitem> <listitem> -<para ->Turn on the option to include the <quote ->us</quote -> group in your layout (effectively the same as solution 1).</para> +<para>Turn on the option to include the <quote>us</quote> group in your layout (effectively the same as solution 1).</para> </listitem> </orderedlist> @@ -232,64 +122,26 @@ </chapter> <chapter id="xkb-files"> -<title ->Files and Layout Descriptions</title> +<title>Files and Layout Descriptions</title> <sect1 id="xkb-files-and-layouts"> -<title -><application ->xkb</application -> Files and Layouts</title> - -<para ->All available keyboard layouts are described in <filename ->/etc/X11/xkb/rules/xfree86.lst</filename -> (and <filename ->/etc/X11/xkb/rules/xfree86.xml</filename -> since XFree86 4.3.0), the layouts themselves can be found in <filename ->/etc/X11/xkb/symbols/pc</filename -> (or <filename ->/etc/X11/xkb/symbols</filename -> for XFree86 4.2.x and older). Note that the location of these files may differ depending on your operating system and distribution.</para> - -<para ->&kxkb; now uses the xkb extension instead of xmodmap, so to define your own layout you have to get one from <filename class="directory" ->/etc/X11/xkb/symbols</filename -> which is closest to what you want to get (or <filename class="directory" ->/etc/X11/xkb/symbold/pc</filename -> for XFree86 4.3.0), rename it to something you like and edit it. Then just add the name to <filename ->/etc/X11/xkb/rules/xfree86.lst</filename -> (and for XFree86 4.3.0 or later it is a good idea to add the name also to <filename ->/etc/X11/xkb/ruls/xfree86.xml</filename -> - some packages already use it, not &kxkb; though yet) kxkb will pick it up on restart. Note: you have to be root to edit those files.</para> +<title><application>xkb</application> Files and Layouts</title> + +<para>All available keyboard layouts are described in <filename>/etc/X11/xkb/rules/xfree86.lst</filename> (and <filename>/etc/X11/xkb/rules/xfree86.xml</filename> since XFree86 4.3.0), the layouts themselves can be found in <filename>/etc/X11/xkb/symbols/pc</filename> (or <filename>/etc/X11/xkb/symbols</filename> for XFree86 4.2.x and older). Note that the location of these files may differ depending on your operating system and distribution.</para> + +<para>&kxkb; now uses the xkb extension instead of xmodmap, so to define your own layout you have to get one from <filename class="directory">/etc/X11/xkb/symbols</filename> which is closest to what you want to get (or <filename class="directory">/etc/X11/xkb/symbold/pc</filename> for XFree86 4.3.0), rename it to something you like and edit it. Then just add the name to <filename>/etc/X11/xkb/rules/xfree86.lst</filename> (and for XFree86 4.3.0 or later it is a good idea to add the name also to <filename>/etc/X11/xkb/ruls/xfree86.xml</filename> - some packages already use it, not &kxkb; though yet) kxkb will pick it up on restart. Note: you have to be root to edit those files.</para> </sect1> </chapter> <chapter id="credits-and-licenses"> -<title ->Credits and Licences</title> +<title>Credits and Licences</title> -<para ->&kxkb; is currently developed and maintained by Andriy Rysin <email ->rysin@kde.org</email ->. Several other people have worked on <application ->kxkb</application ->:</para> +<para>&kxkb; is currently developed and maintained by Andriy Rysin <email>rysin@kde.org</email>. Several other people have worked on <application>kxkb</application>:</para> <itemizedlist> -<listitem -><para ->Shaheed Haque <email ->srhaque@iee.org</email -></para -></listitem> -<listitem -><para ->Ilya Konstantinov <email ->kde-devel@future.galanet.net</email -></para -></listitem> +<listitem><para>Shaheed Haque <email>srhaque@iee.org</email></para></listitem> +<listitem><para>Ilya Konstantinov <email>kde-devel@future.galanet.net</email></para></listitem> </itemizedlist> &underFDL; &underGPL; </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/quickstart/index.docbook b/tde-i18n-en_GB/docs/tdebase/quickstart/index.docbook index 6d3404a9284..91a053116e2 100644 --- a/tde-i18n-en_GB/docs/tdebase/quickstart/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/quickstart/index.docbook @@ -4,606 +4,292 @@ <!ENTITY kappname "&kde; Quick Start Guide"> <!ENTITY package "tdebase"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <book lang="&language;"> <bookinfo> -<title ->An Introduction to &kde;</title> +<title>An Introduction to &kde;</title> <authorgroup> <author> -<surname ->The KDE Team</surname> +<surname>The KDE Team</surname> </author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2004-08-28</date> -<releaseinfo ->3.00.00</releaseinfo> +<date>2004-08-28</date> +<releaseinfo>3.00.00</releaseinfo> <copyright> -<year ->1999</year -><year ->2000</year -><year ->2001</year -><year ->2002</year> -<holder ->The KDE Team</holder> +<year>1999</year><year>2000</year><year>2001</year><year>2002</year> +<holder>The KDE Team</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> <abstract> -<para ->An introduction to the K Desktop Environment</para> -<para ->Quick Start Guide to &kde;</para -></abstract> +<para>An introduction to the K Desktop Environment</para> +<para>Quick Start Guide to &kde;</para></abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->quick start</keyword> -<keyword ->introduction</keyword> +<keyword>KDE</keyword> +<keyword>quick start</keyword> +<keyword>introduction</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introduction</title> - -<para ->This document is a brief introduction to the K Desktop Environment. It will familiarise you with some of the basic features of &kde;. </para> - -<para ->This guide is far from covering all aspects of the K Desktop or even most of them. It will only describe some of the most basic ways to accomplish a few of the most common tasks. </para> - -<para ->We assume that you are already familiar with at least one graphical user interface, for example <trademark ->CDE</trademark ->, <trademark ->Geos</trademark ->, <trademark ->GEM</trademark ->, &NeXTSTEP;, &Mac;, <trademark ->OS/2</trademark -> or &Microsoft; &Windows;. So we will not explain the usage of the mouse or the keyboard but concentrate on hopefully more interesting things. </para> +<title>Introduction</title> + +<para>This document is a brief introduction to the K Desktop Environment. It will familiarise you with some of the basic features of &kde;. </para> + +<para>This guide is far from covering all aspects of the K Desktop or even most of them. It will only describe some of the most basic ways to accomplish a few of the most common tasks. </para> + +<para>We assume that you are already familiar with at least one graphical user interface, for example <trademark>CDE</trademark>, <trademark>Geos</trademark>, <trademark>GEM</trademark>, &NeXTSTEP;, &Mac;, <trademark>OS/2</trademark> or &Microsoft; &Windows;. So we will not explain the usage of the mouse or the keyboard but concentrate on hopefully more interesting things. </para> </chapter> <chapter id="an-overview-of-kde"> -<title ->An Overview of &kde;</title> +<title>An Overview of &kde;</title> -<para ->This section is for users who prefer to learn by exploring and want only a brief orientation to get started. Later sections provide a more thorough introduction to the environment, with helpful hints and shortcuts. If you are impatient to get started, skim this section, go play for a bit, then come back and peruse the other sections of this guide as needed. </para> +<para>This section is for users who prefer to learn by exploring and want only a brief orientation to get started. Later sections provide a more thorough introduction to the environment, with helpful hints and shortcuts. If you are impatient to get started, skim this section, go play for a bit, then come back and peruse the other sections of this guide as needed. </para> <note> -<para ->&kde; provides a highly configurable desktop environment. This overview assumes that you are using the default environment. </para> +<para>&kde; provides a highly configurable desktop environment. This overview assumes that you are using the default environment. </para> </note> <sect1 id="the-kde-desktop"> -<title ->The &kde; Desktop</title> +<title>The &kde; Desktop</title> -<para ->A typical &kde; desktop consists of several parts:</para> +<para>A typical &kde; desktop consists of several parts:</para> <itemizedlist> <listitem> -<para ->A <interface ->panel</interface -> at the bottom of the screen, used to start applications and switch between desktops. Among other things, it contains the &kmenu;, a large &ticon; which displays a menu of applications to start when clicked. </para> +<para>A <interface>panel</interface> at the bottom of the screen, used to start applications and switch between desktops. Among other things, it contains the &kmenu;, a large &ticon; which displays a menu of applications to start when clicked. </para> </listitem> <listitem> -<para ->A <interface ->taskbar</interface ->, by default embedded in the panel, used to switch between and manage currently running applications. Click on an application on the taskbar to switch to the application. </para> -</listitem -> +<para>A <interface>taskbar</interface>, by default embedded in the panel, used to switch between and manage currently running applications. Click on an application on the taskbar to switch to the application. </para> +</listitem> <listitem> -<para ->The <interface ->desktop</interface -> itself, on which frequently used files and folders may be placed. &kde; provides multiple desktops, each of which has its own windows. Click on the numbered buttons on the panel to switch between desktops. </para> +<para>The <interface>desktop</interface> itself, on which frequently used files and folders may be placed. &kde; provides multiple desktops, each of which has its own windows. Click on the numbered buttons on the panel to switch between desktops. </para> </listitem> </itemizedlist> </sect1> <sect1 id="ready-set-go"> -<title ->Ready, Set, Go!</title> +<title>Ready, Set, Go!</title> -<para ->Here are a few quick tips to get you up and running.</para> +<para>Here are a few quick tips to get you up and running.</para> <itemizedlist> <listitem> -<para ->To start an application, click on the &ticon; button on the panel (called the <link linkend="starter" ->&kmenu;</link ->) and choose an item from the menu. </para> +<para>To start an application, click on the &ticon; button on the panel (called the <link linkend="starter">&kmenu;</link>) and choose an item from the menu. </para> </listitem> <listitem> -<para ->Click the icon that looks like a folder with a picture of a house on the panel to access the files in your home folder using &konqueror;, &kde;'s File Manager utility. </para> +<para>Click the icon that looks like a folder with a picture of a house on the panel to access the files in your home folder using &konqueror;, &kde;'s File Manager utility. </para> </listitem> <listitem> -<para ->Choose <menuchoice -><guimenu ->TDE menu</guimenu -> <guisubmenu ->System</guisubmenu -> <guimenuitem ->Konsole</guimenuitem -></menuchoice -> to get a &UNIX; command prompt, or press <keycombo action="simul" ->&Alt; <keycap ->F2</keycap -></keycombo -> to get a mini command prompt window to execute a single command. </para> +<para>Choose <menuchoice><guimenu>TDE menu</guimenu> <guisubmenu>System</guisubmenu> <guimenuitem>Konsole</guimenuitem></menuchoice> to get a &UNIX; command prompt, or press <keycombo action="simul">&Alt; <keycap>F2</keycap></keycombo> to get a mini command prompt window to execute a single command. </para> </listitem> <listitem> -<para ->Choose the <menuchoice -><guisubmenu ->Settings</guisubmenu -><guimenuitem ->Control Centre</guimenuitem -> </menuchoice ->item on the &kmenu; to configure &kde;. </para> -</listitem -> +<para>Choose the <menuchoice><guisubmenu>Settings</guisubmenu><guimenuitem>Control Centre</guimenuitem> </menuchoice>item on the &kmenu; to configure &kde;. </para> +</listitem> <listitem> -<para ->Press <keycombo action="simul" ->&Alt;<keycap ->Tab</keycap -></keycombo -> to switch between applications and <keycombo action="simul" ->&Ctrl;<keycap ->Tab</keycap -></keycombo -> to switch between desktops using the keyboard. </para> -</listitem -> +<para>Press <keycombo action="simul">&Alt;<keycap>Tab</keycap></keycombo> to switch between applications and <keycombo action="simul">&Ctrl;<keycap>Tab</keycap></keycombo> to switch between desktops using the keyboard. </para> +</listitem> <listitem> -<para ->Use the &RMB; mouse button to access context menus for the panel, desktop, and most &kde; applications. </para> -</listitem -> +<para>Use the &RMB; mouse button to access context menus for the panel, desktop, and most &kde; applications. </para> +</listitem> </itemizedlist> </sect1> </chapter> <chapter id="launching-applications"> -<title ->Launching Applications</title> +<title>Launching Applications</title> <sect1 id="starter"> -<title ->Using the &kmenu; and the Panel</title> +<title>Using the &kmenu; and the Panel</title> -<para ->At the bottom of the screen you will find the desktop panel, which is called &kicker;. You use the panel to launch applications. Have a look at the button on the left with a large &ticon;. </para> +<para>At the bottom of the screen you will find the desktop panel, which is called &kicker;. You use the panel to launch applications. Have a look at the button on the left with a large &ticon;. </para> -<para ->This button is called the &kmenu;. It has a small arrow on the top to indicate that it will pop up a menu if you click on it. Just do it! The pop-up offers you easy access to all &kde; applications installed on your computer system. </para> +<para>This button is called the &kmenu;. It has a small arrow on the top to indicate that it will pop up a menu if you click on it. Just do it! The pop-up offers you easy access to all &kde; applications installed on your computer system. </para> <sect2> -<title ->Customising &kicker;</title> +<title>Customising &kicker;</title> <!-- FIXME: To add a button, use the little arrows on kicker, not the TDE menu --> -<para ->If you use one application or tool very often, then you may want to have even faster access to it, of course. In this case, you can add a single application, or an entire sub-menu of the &kmenu;, as a special quick-launch button, on to the panel. If you want to reach the &kfind; application directly via a launch button, simply choose <menuchoice -><guimenu ->TDE menu</guimenu -> <guisubmenu ->Panel Menu</guisubmenu -> <guisubmenu ->Add</guisubmenu -> <guisubmenu ->Button</guisubmenu -> <guimenuitem ->Find Files</guimenuitem -></menuchoice -> (By this we mean that you should first click the &kmenu;, then select <guisubmenu ->Panel Menu</guisubmenu ->, where the small arrow to the right indicates that another menu will pop up. In this menu, choose <guisubmenu ->Add</guisubmenu ->, then <guisubmenu ->Button</guisubmenu ->, and in the next sub-menu, <guimenuitem ->Find Files</guimenuitem ->). </para> +<para>If you use one application or tool very often, then you may want to have even faster access to it, of course. In this case, you can add a single application, or an entire sub-menu of the &kmenu;, as a special quick-launch button, on to the panel. If you want to reach the &kfind; application directly via a launch button, simply choose <menuchoice><guimenu>TDE menu</guimenu> <guisubmenu>Panel Menu</guisubmenu> <guisubmenu>Add</guisubmenu> <guisubmenu>Button</guisubmenu> <guimenuitem>Find Files</guimenuitem></menuchoice> (By this we mean that you should first click the &kmenu;, then select <guisubmenu>Panel Menu</guisubmenu>, where the small arrow to the right indicates that another menu will pop up. In this menu, choose <guisubmenu>Add</guisubmenu>, then <guisubmenu>Button</guisubmenu>, and in the next sub-menu, <guimenuitem>Find Files</guimenuitem>). </para> -<para ->You can add an entire menu this way, or one of the &ticon; button sub-menus. For example, if you have &koffice; installed and want quick access to all the &koffice; applications, without having to navigate through the &kmenu;, then instead of choosing an application, click on the <guimenuitem ->Add this menu</guimenuitem -> menu entry. Now you will have instant access to all the &koffice; applications, without having to put an icon for each on the panel. </para> +<para>You can add an entire menu this way, or one of the &ticon; button sub-menus. For example, if you have &koffice; installed and want quick access to all the &koffice; applications, without having to navigate through the &kmenu;, then instead of choosing an application, click on the <guimenuitem>Add this menu</guimenuitem> menu entry. Now you will have instant access to all the &koffice; applications, without having to put an icon for each on the panel. </para> <note> -<para ->You can move all items of the panel around with the <guimenuitem ->Move</guimenuitem -> command of the context menu. Just click with the <mousebutton ->third</mousebutton -> mouse button (the <mousebutton ->third</mousebutton -> mouse button is normally the <mousebutton ->right</mousebutton -> button, but if you have configured your mouse differently, for example for left-handers, it might also be the <mousebutton ->left</mousebutton -> one). A menu will pop up where you can choose <guimenuitem ->Move</guimenuitem ->. Now move the mouse and see how the icon follows while still staying on the panel. When you are done, simply hit the <mousebutton ->first</mousebutton -> mouse button (by default the <mousebutton ->left</mousebutton -> one). As you may have noticed, there is also a menu entry <guimenuitem ->Remove</guimenuitem -> in case you are tired of a certain launch button on your desktop. </para -> +<para>You can move all items of the panel around with the <guimenuitem>Move</guimenuitem> command of the context menu. Just click with the <mousebutton>third</mousebutton> mouse button (the <mousebutton>third</mousebutton> mouse button is normally the <mousebutton>right</mousebutton> button, but if you have configured your mouse differently, for example for left-handers, it might also be the <mousebutton>left</mousebutton> one). A menu will pop up where you can choose <guimenuitem>Move</guimenuitem>. Now move the mouse and see how the icon follows while still staying on the panel. When you are done, simply hit the <mousebutton>first</mousebutton> mouse button (by default the <mousebutton>left</mousebutton> one). As you may have noticed, there is also a menu entry <guimenuitem>Remove</guimenuitem> in case you are tired of a certain launch button on your desktop. </para> </note> </sect2> <sect2> -<title ->Using Context menus</title> - -<para ->This leads us to another interesting topic: in many places, you can click the <mousebutton ->right</mousebutton -> mouse button to display a <interface ->context menu</interface -> with choices that are applicable to the item you clicked. It is therefore always a good idea to try out the <mousebutton ->third</mousebutton -> mouse button on something, if you do not know what to do with it. Even the background of the desktops has such a menu! </para> +<title>Using Context menus</title> + +<para>This leads us to another interesting topic: in many places, you can click the <mousebutton>right</mousebutton> mouse button to display a <interface>context menu</interface> with choices that are applicable to the item you clicked. It is therefore always a good idea to try out the <mousebutton>third</mousebutton> mouse button on something, if you do not know what to do with it. Even the background of the desktops has such a menu! </para> </sect2> <sect2> -<title ->Other Panel features</title> - -<para ->There are other interesting things possible with the panel. One may be important if you have a low resolution on your monitor: it is the <quote ->hide-and-show</quote -> function, activated by clicking on the small arrowed button, which is at one or both ends of the panel. </para> - -<para ->Perhaps you just don't like the panel extending the full width of the screen. That's easily changed! &RMB; on an empty space in the panel, and choose <menuchoice -><guimenuitem ->Configure Panel...</guimenuitem -></menuchoice ->. In the &kcontrol; dialogue that pops up, you can choose <guilabel ->Length</guilabel -> on the <guilabel ->Appearance</guilabel -> tab, and use the slider there to set the panel to less than 100% width. </para> - -<para ->If you're following along, and have that dialogue open anyway, then feel free to play with all the options, and use the <guibutton ->Apply</guibutton -> to see the effect they have. You can easily reset everything to the default configuration, by simply pressing the <guibutton ->Use Defaults</guibutton -> button. </para> - -<para ->By the way, if you are not sure what a certain button does in &kde;, just move the mouse pointer over it and wait for a short while: &kde; has a built-in mini context help, called <quote ->tool tips</quote ->, which explains the functionality of such controls in a few words. </para> +<title>Other Panel features</title> + +<para>There are other interesting things possible with the panel. One may be important if you have a low resolution on your monitor: it is the <quote>hide-and-show</quote> function, activated by clicking on the small arrowed button, which is at one or both ends of the panel. </para> + +<para>Perhaps you just don't like the panel extending the full width of the screen. That's easily changed! &RMB; on an empty space in the panel, and choose <menuchoice><guimenuitem>Configure Panel...</guimenuitem></menuchoice>. In the &kcontrol; dialogue that pops up, you can choose <guilabel>Length</guilabel> on the <guilabel>Appearance</guilabel> tab, and use the slider there to set the panel to less than 100% width. </para> + +<para>If you're following along, and have that dialogue open anyway, then feel free to play with all the options, and use the <guibutton>Apply</guibutton> to see the effect they have. You can easily reset everything to the default configuration, by simply pressing the <guibutton>Use Defaults</guibutton> button. </para> + +<para>By the way, if you are not sure what a certain button does in &kde;, just move the mouse pointer over it and wait for a short while: &kde; has a built-in mini context help, called <quote>tool tips</quote>, which explains the functionality of such controls in a few words. </para> </sect2> </sect1> <sect1 id="want-command-line-back"> -<title ->But I want my command line back!</title> - -<para ->Just calm down, there is nothing to fear. &kde; does not want to take your beloved (and sometimes very effective) command line away from you. You can move your files with the desktop, but you can also use the &UNIX; commands you are accustomed to. In fact,&kde; puts command line power at your fingertips, in perhaps some surprising places. </para> - -<para ->&kde; provides a very sophisticated command line window called &konsole;. Choose <menuchoice -><guimenu ->TDE menu</guimenu -> <guisubmenu ->System</guisubmenu -> <guimenuitem ->Konsole</guimenuitem -></menuchoice -> to start it. This may be something you want on your panel: luckily it is already there in the default configuration! </para> +<title>But I want my command line back!</title> + +<para>Just calm down, there is nothing to fear. &kde; does not want to take your beloved (and sometimes very effective) command line away from you. You can move your files with the desktop, but you can also use the &UNIX; commands you are accustomed to. In fact,&kde; puts command line power at your fingertips, in perhaps some surprising places. </para> + +<para>&kde; provides a very sophisticated command line window called &konsole;. Choose <menuchoice><guimenu>TDE menu</guimenu> <guisubmenu>System</guisubmenu> <guimenuitem>Konsole</guimenuitem></menuchoice> to start it. This may be something you want on your panel: luckily it is already there in the default configuration! </para> -<para ->Sometimes, you only want to enter one command on the command line. In these cases, you do not need a full-blown terminal. Just hit <keycombo ->&Alt;<keycap ->F2</keycap -></keycombo -> and you get a small command line where you can enter one command. The command line window will disappear afterwards, but it remembers your command. </para> - -<para ->When you pop up this window (which we call <application ->minicli</application -> by the way) and hit the <keycap ->Up arrow</keycap ->, you can browse through all the commands you have previously entered. Also, you can enter &URL;s in <application ->minicli</application -> to open a &konqueror; window with the specified &URL;. </para> - -<para ->&konqueror; and the editor &kate; can both display terminal windows, which behave just like &konsole;. In &konqueror;, you can turn this on with the menu choice <menuchoice -><guimenu ->Window</guimenu -><guimenuitem ->Show Terminal Emulator</guimenuitem -></menuchoice ->. The embedded terminal will display at the bottom of your &konqueror; window, and the really clever thing is that it will follow your clicks in the file manager view, changing folder as you do. In &kate; you can display a terminal with the menu choice <menuchoice -><guimenu ->Settings</guimenu -><guimenuitem ->Show Console</guimenuitem -></menuchoice ->. </para> +<para>Sometimes, you only want to enter one command on the command line. In these cases, you do not need a full-blown terminal. Just hit <keycombo>&Alt;<keycap>F2</keycap></keycombo> and you get a small command line where you can enter one command. The command line window will disappear afterwards, but it remembers your command. </para> + +<para>When you pop up this window (which we call <application>minicli</application> by the way) and hit the <keycap>Up arrow</keycap>, you can browse through all the commands you have previously entered. Also, you can enter &URL;s in <application>minicli</application> to open a &konqueror; window with the specified &URL;. </para> + +<para>&konqueror; and the editor &kate; can both display terminal windows, which behave just like &konsole;. In &konqueror;, you can turn this on with the menu choice <menuchoice><guimenu>Window</guimenu><guimenuitem>Show Terminal Emulator</guimenuitem></menuchoice>. The embedded terminal will display at the bottom of your &konqueror; window, and the really clever thing is that it will follow your clicks in the file manager view, changing folder as you do. In &kate; you can display a terminal with the menu choice <menuchoice><guimenu>Settings</guimenu><guimenuitem>Show Console</guimenuitem></menuchoice>. </para> <tip> -<para ->To display a &UNIX; man page, enter <userinput -><command ->man:</command -><replaceable ->command</replaceable -></userinput -> in <application ->minicli</application ->, where <replaceable ->command</replaceable -> is the name of a &UNIX; command. </para> +<para>To display a &UNIX; man page, enter <userinput><command>man:</command><replaceable>command</replaceable></userinput> in <application>minicli</application>, where <replaceable>command</replaceable> is the name of a &UNIX; command. </para> </tip> <tip> -<para ->To search for a word or words on the Google search engine, you can try entering <userinput -><command ->gg:</command -><replaceable ->word or words</replaceable -></userinput ->. There are a whole lot more of these shortcut commands, and you can even add your own! Take a look in &kcontrol;, in the tab <menuchoice -><guilabel ->Web Browsing</guilabel -> <guilabel ->Enhanced Browsing</guilabel -></menuchoice ->. </para> +<para>To search for a word or words on the Google search engine, you can try entering <userinput><command>gg:</command><replaceable>word or words</replaceable></userinput>. There are a whole lot more of these shortcut commands, and you can even add your own! Take a look in &kcontrol;, in the tab <menuchoice><guilabel>Web Browsing</guilabel> <guilabel>Enhanced Browsing</guilabel></menuchoice>. </para> </tip> -<para ->Finally, there's a way to have your command line always available, no matter what you're doing - add one to your &kicker; panel! </para> - -<para ->Simply &RMB; click on an empty space in the panel, and choose <menuchoice -><guimenu ->Panel</guimenu -> <guisubmenu ->Add</guisubmenu -> <guisubmenu ->Applet</guisubmenu -> <guimenuitem ->Application Launcher</guimenuitem -></menuchoice ->. This will embed a mini-cli directly into your panel, complete with command history. </para> - -<para ->So, in conclusion, the command line is never far from view when you're using &kde;. </para> +<para>Finally, there's a way to have your command line always available, no matter what you're doing - add one to your &kicker; panel! </para> + +<para>Simply &RMB; click on an empty space in the panel, and choose <menuchoice><guimenu>Panel</guimenu> <guisubmenu>Add</guisubmenu> <guisubmenu>Applet</guisubmenu> <guimenuitem>Application Launcher</guimenuitem></menuchoice>. This will embed a mini-cli directly into your panel, complete with command history. </para> + +<para>So, in conclusion, the command line is never far from view when you're using &kde;. </para> </sect1> </chapter> <chapter id="working-with-windows"> -<title ->Working with Windows</title> +<title>Working with Windows</title> -<para ->If you have not already done so, start an application using the <link linkend="starter" ->&kmenu;</link ->; say, <guimenuitem ->Find Files</guimenuitem ->. </para> +<para>If you have not already done so, start an application using the <link linkend="starter">&kmenu;</link>; say, <guimenuitem>Find Files</guimenuitem>. </para> <sect1 id="window-what-now"> -<title ->A window! What now?</title> +<title>A window! What now?</title> -<para ->Well, usually people work <emphasis ->inside</emphasis -> windows, but sometimes you may want to manipulate windows. Here's a quick overview of some of the most common window related functions: </para> +<para>Well, usually people work <emphasis>inside</emphasis> windows, but sometimes you may want to manipulate windows. Here's a quick overview of some of the most common window related functions: </para> <variablelist> <varlistentry> -<term ->Move a window</term> +<term>Move a window</term> <listitem> -<para ->Drag the window's title bar, or hold the &Alt; key down and drag anywhere in the window. </para> -</listitem -> +<para>Drag the window's title bar, or hold the &Alt; key down and drag anywhere in the window. </para> +</listitem> </varlistentry> <varlistentry> -<term ->Resize a window:</term> +<term>Resize a window:</term> <listitem> -<para ->Drag the window's border, or hold the &Alt; key down and drag with the &RMB; anywhere in the window. </para> +<para>Drag the window's border, or hold the &Alt; key down and drag with the &RMB; anywhere in the window. </para> </listitem> </varlistentry> <varlistentry> -<term ->Maximise a window</term> +<term>Maximise a window</term> <listitem> -<para ->Click the maximise button in the title bar (in the default decoration it is the square, next to the X) to make the window fill the screen, or if the window is already maximised, to shrink it back to its original size. Clicking with the &MMB; maximises the window vertically, and with the &RMB;, horizontally. </para> +<para>Click the maximise button in the title bar (in the default decoration it is the square, next to the X) to make the window fill the screen, or if the window is already maximised, to shrink it back to its original size. Clicking with the &MMB; maximises the window vertically, and with the &RMB;, horizontally. </para> </listitem> </varlistentry> <varlistentry> -<term ->Iconify a window</term> +<term>Iconify a window</term> <listitem> -<para ->Click the iconify button in the title bar (next to Maximise) to hide the window. Restore it by clicking on the window's icon in the taskbar. </para> -</listitem -> +<para>Click the iconify button in the title bar (next to Maximise) to hide the window. Restore it by clicking on the window's icon in the taskbar. </para> +</listitem> </varlistentry> <varlistentry> -<term ->Switch between windows</term> +<term>Switch between windows</term> <listitem> -<para ->Aside from the usual mouse click to switch to another window, you can use <keycombo action="simul" ->&Alt; <keycap ->Tab</keycap -></keycombo -> to switch windows. See below for more techniques. </para> +<para>Aside from the usual mouse click to switch to another window, you can use <keycombo action="simul">&Alt; <keycap>Tab</keycap></keycombo> to switch windows. See below for more techniques. </para> </listitem> </varlistentry> </variablelist> <sect2> -<title ->Title bar buttons</title> +<title>Title bar buttons</title> -<para ->&kde; windows have some pretty standard buttons on their title bars which give you fast access to some common operations. The default button layout looks like this: </para> +<para>&kde; windows have some pretty standard buttons on their title bars which give you fast access to some common operations. The default button layout looks like this: </para> <itemizedlist> -<title ->On the left side:</title> +<title>On the left side:</title> <listitem> -<para ->A menu button. This usually shows a mini icon for the application. Click on it to get a window operations menu. Shortcut: <keycombo action="simul" ->&Alt;<keycap ->F3</keycap -></keycombo -> opens the window menu. </para> +<para>A menu button. This usually shows a mini icon for the application. Click on it to get a window operations menu. Shortcut: <keycombo action="simul">&Alt;<keycap>F3</keycap></keycombo> opens the window menu. </para> </listitem> <listitem> -<para ->A sticky button, with a picture of a tack. What the heck is this? Stay tuned! </para> -</listitem -> +<para>A sticky button, with a picture of a tack. What the heck is this? Stay tuned! </para> +</listitem> </itemizedlist> <itemizedlist> -<title ->On the right side:</title> +<title>On the right side:</title> <listitem> -<para ->An iconify button. </para> +<para>An iconify button. </para> </listitem> <listitem> -<para ->A maximise button. </para> +<para>A maximise button. </para> </listitem> <listitem> -<para ->A close button. This closes the window. Shortcut: <keycombo action="simul" ->&Alt;<keycap ->F4</keycap -></keycombo ->. </para> +<para>A close button. This closes the window. Shortcut: <keycombo action="simul">&Alt;<keycap>F4</keycap></keycombo>. </para> </listitem> </itemizedlist> </sect2> <sect2> -<title ->Switching between windows</title> +<title>Switching between windows</title> -<para ->Now that we know how to deal with windows, we encourage you to open some other windows using the panel, since we will now discuss how to switch between different windows. Since this is such a common activity, &kde; offers several ways to do it; pick your favourite! </para> +<para>Now that we know how to deal with windows, we encourage you to open some other windows using the panel, since we will now discuss how to switch between different windows. Since this is such a common activity, &kde; offers several ways to do it; pick your favourite! </para> -<para ->Many window systems require you to click the mouse in another window to begin using it. This is &kde;'s default behaviour, termed <quote ->Click To Focus</quote -> focus policy. But you can also configure your desktop in a way that moving the mouse pointer on to a window will activate it. This is called <quote ->Focus Follows Mouse</quote ->. If you select this policy using the <link linkend="configure" ->&kde; Control Centre</link ->, the window under the mouse pointer is always the active one. It doesn't necessarily come to the front automatically, but you can still click on to the title bar or the border of a window or, a &kde; special, you can use the &Alt; key and click the &MMB; anywhere on the window to raise it. </para> +<para>Many window systems require you to click the mouse in another window to begin using it. This is &kde;'s default behaviour, termed <quote>Click To Focus</quote> focus policy. But you can also configure your desktop in a way that moving the mouse pointer on to a window will activate it. This is called <quote>Focus Follows Mouse</quote>. If you select this policy using the <link linkend="configure">&kde; Control Centre</link>, the window under the mouse pointer is always the active one. It doesn't necessarily come to the front automatically, but you can still click on to the title bar or the border of a window or, a &kde; special, you can use the &Alt; key and click the &MMB; anywhere on the window to raise it. </para> -<para ->Here are some other methods to switch windows: </para> +<para>Here are some other methods to switch windows: </para> <itemizedlist> <listitem> -<para ->Pick a window from the <emphasis ->window list</emphasis -> menu. To open the menu, click the &MMB; on an empty area of the desktop, or click the icon with several windows on the panel, or finally click the up arrow at the left hand end of the taskbar in the panel. </para> -</listitem -> +<para>Pick a window from the <emphasis>window list</emphasis> menu. To open the menu, click the &MMB; on an empty area of the desktop, or click the icon with several windows on the panel, or finally click the up arrow at the left hand end of the taskbar in the panel. </para> +</listitem> <listitem> -<para ->Hold down the &Alt; key and press <keycap ->Tab</keycap -> to cycle through the windows. </para> -</listitem -> +<para>Hold down the &Alt; key and press <keycap>Tab</keycap> to cycle through the windows. </para> +</listitem> <listitem> -<para ->Use the taskbar (see below). </para> +<para>Use the taskbar (see below). </para> </listitem> </itemizedlist> @@ -611,276 +297,144 @@ </sect1> <sect1 id="using-taskbar"> -<title ->Using the Taskbar</title> - -<para ->The <interface ->taskbar</interface -> displays a list of small icons, one for each window on the desktop. In the default &kde; setup the taskbar is located inside the panel, but it can also be located at the top or the bottom of the screen. </para> - -<para ->The taskbar is very powerful. In the default configuration, if you have more than one window from the same application open, they will be <quote ->grouped</quote ->, so that you see one icon per application in the taskbar.</para> - -<para ->A simple &LMB; click on the taskbar button will pop up a list of the open windows for that application and you can choose the window you want to use. Choosing one of these entries with the <mousebutton ->left</mousebutton -> will bring you to the selected window immediately. Click on a taskbar entry with the <mousebutton ->right</mousebutton -> and you will see a menu allowing you to operate on all the windows grouped under that icon, or each window individually.</para> - -<para ->You can choose to see all the windows on all the desktops in your taskbar, no matter which desktop you are currently viewing, or to only see the icons for the desktop you are looking at. You can also choose to ungroup the icons, so that each open window will have its own icon in the taskbar. These and many more options are available simply by right clicking on the taskbar handle (the small textured bar at the left hand side) and choosing <guimenuitem ->Configure Taskbar...</guimenuitem ->. </para> - -<para ->The icons on the taskbar resize themselves to make room for applications, so you can fit many more applications than you might think. Making the panel wider will let the taskbar icons take on a row and column layout, but they will still resize to fit more icons. </para> +<title>Using the Taskbar</title> + +<para>The <interface>taskbar</interface> displays a list of small icons, one for each window on the desktop. In the default &kde; setup the taskbar is located inside the panel, but it can also be located at the top or the bottom of the screen. </para> + +<para>The taskbar is very powerful. In the default configuration, if you have more than one window from the same application open, they will be <quote>grouped</quote>, so that you see one icon per application in the taskbar.</para> + +<para>A simple &LMB; click on the taskbar button will pop up a list of the open windows for that application and you can choose the window you want to use. Choosing one of these entries with the <mousebutton>left</mousebutton> will bring you to the selected window immediately. Click on a taskbar entry with the <mousebutton>right</mousebutton> and you will see a menu allowing you to operate on all the windows grouped under that icon, or each window individually.</para> + +<para>You can choose to see all the windows on all the desktops in your taskbar, no matter which desktop you are currently viewing, or to only see the icons for the desktop you are looking at. You can also choose to ungroup the icons, so that each open window will have its own icon in the taskbar. These and many more options are available simply by right clicking on the taskbar handle (the small textured bar at the left hand side) and choosing <guimenuitem>Configure Taskbar...</guimenuitem>. </para> + +<para>The icons on the taskbar resize themselves to make room for applications, so you can fit many more applications than you might think. Making the panel wider will let the taskbar icons take on a row and column layout, but they will still resize to fit more icons. </para> </sect1> <sect1 id="using-v-desktops"> -<title ->Using Virtual Desktops</title> +<title>Using Virtual Desktops</title> -<para ->Now, what was that <quote ->sticky</quote -> thing? </para> +<para>Now, what was that <quote>sticky</quote> thing? </para> -<para ->It may happen that you have more windows open than space on your desktop. In this case you have three possibilities: </para> +<para>It may happen that you have more windows open than space on your desktop. In this case you have three possibilities: </para> <orderedlist> <listitem> -<para ->Leave all windows open (cluttered desktop) </para> +<para>Leave all windows open (cluttered desktop) </para> </listitem> <listitem> -<para ->Iconify those windows which you do not need at present and use the taskbar or <keycombo action="simul" ->&Alt; <keycap ->Tab</keycap -></keycombo -> to switch between them (still a bit confusing and much work!) </para> -</listitem -> +<para>Iconify those windows which you do not need at present and use the taskbar or <keycombo action="simul">&Alt; <keycap>Tab</keycap></keycombo> to switch between them (still a bit confusing and much work!) </para> +</listitem> <listitem> -<para ->Recommended: Do what a real operating system does if there is not enough physical memory: Use virtual memory, in this case virtual desktops. </para> +<para>Recommended: Do what a real operating system does if there is not enough physical memory: Use virtual memory, in this case virtual desktops. </para> </listitem> </orderedlist> -<para ->The third option is the way to go! &kde; can handle several different desktops, each with its own windows. The default configuration provides four desktops. You can switch between the virtual desktops easily with a click on one of the desktop buttons on the panel. Also <keycombo action="simul" ->&Ctrl;<keycap ->F1...F4</keycap -></keycombo -> will send you to the corresponding desktop immediately, or <keycombo action="simul" ->&Ctrl; <keycap ->Tab</keycap -></keycombo -> will cycle through the desktops. </para> - -<para ->Virtual desktops are very nice. But sometimes you want a window to be present on <emphasis ->every</emphasis -> desktop. This could be, for example, a small chat window, an alarm clock or whatever. In this case you can use the above mentioned <quote ->sticky</quote -> button which will pin the window on the background so that it will appear on every virtual desktop. </para -> - -<para ->The sticky button can also be used to move a window from one virtual desktop to another one: push the sticky pin on the window, switch to a different desktop, and release the pin by pushing it again. You can achieve the same result by using the context pop-up menu of the window's entry in the taskbar (menu item <guimenuitem ->To Current Desktop</guimenuitem ->) or the <guimenuitem ->To Desktop</guimenuitem -> option on the window operations menu. </para> +<para>The third option is the way to go! &kde; can handle several different desktops, each with its own windows. The default configuration provides four desktops. You can switch between the virtual desktops easily with a click on one of the desktop buttons on the panel. Also <keycombo action="simul">&Ctrl;<keycap>F1...F4</keycap></keycombo> will send you to the corresponding desktop immediately, or <keycombo action="simul">&Ctrl; <keycap>Tab</keycap></keycombo> will cycle through the desktops. </para> + +<para>Virtual desktops are very nice. But sometimes you want a window to be present on <emphasis>every</emphasis> desktop. This could be, for example, a small chat window, an alarm clock or whatever. In this case you can use the above mentioned <quote>sticky</quote> button which will pin the window on the background so that it will appear on every virtual desktop. </para> + +<para>The sticky button can also be used to move a window from one virtual desktop to another one: push the sticky pin on the window, switch to a different desktop, and release the pin by pushing it again. You can achieve the same result by using the context pop-up menu of the window's entry in the taskbar (menu item <guimenuitem>To Current Desktop</guimenuitem>) or the <guimenuitem>To Desktop</guimenuitem> option on the window operations menu. </para> </sect1> </chapter> <chapter id="managing-your-files"> -<title ->Managing your files</title> +<title>Managing your files</title> <!-- NB Deliberate use of 'directory' rather than 'folder', since we're talking --> <!-- about directories on disk --> -<para ->A common metaphor of graphical desktops is the use of folders to represent directories on your hard disk. Folders contain files and other folders. A &kde; application called &konqueror;, the K File Manager, uses this metaphor to help you manage your files. </para> +<para>A common metaphor of graphical desktops is the use of folders to represent directories on your hard disk. Folders contain files and other folders. A &kde; application called &konqueror;, the K File Manager, uses this metaphor to help you manage your files. </para> <sect1 id="using-konqueror"> -<title ->Using &konqueror;</title> +<title>Using &konqueror;</title> -<para ->The first time you start &kde;, a window with lots of icons in it appears. This is a &konqueror; window displaying the files in your home folder (the area where your personal files are stored). The pathname of the folder is displayed under the window's tool bar. If you do not see such a window now, click the icon on the panel that looks like a folder with a picture of a house. </para> +<para>The first time you start &kde;, a window with lots of icons in it appears. This is a &konqueror; window displaying the files in your home folder (the area where your personal files are stored). The pathname of the folder is displayed under the window's tool bar. If you do not see such a window now, click the icon on the panel that looks like a folder with a picture of a house. </para> -<para ->To open a file or folder, simply click it once with the &LMB;. You can also choose <menuchoice -><guimenu ->Window</guimenu -><guimenuitem ->Show Navigation Panel</guimenuitem -></menuchoice -> from the menu to display the folder hierarchy for more direct navigation. Or you can edit the path displayed under the toolbar to get to a specific folder quickly. </para> +<para>To open a file or folder, simply click it once with the &LMB;. You can also choose <menuchoice><guimenu>Window</guimenu><guimenuitem>Show Navigation Panel</guimenuitem></menuchoice> from the menu to display the folder hierarchy for more direct navigation. Or you can edit the path displayed under the toolbar to get to a specific folder quickly. </para> <sect2> -<title ->Opening Files</title> +<title>Opening Files</title> -<para ->&kde; comes with a set of applications to view and edit files of many common types, and when you click a file containing, say, a document or image, &konqueror; will start the appropriate application to display the file. If it doesn't know what application to start to open a file you clicked, &konqueror; will prompt you for the name of the application to run, and when you have chosen, &konqueror; will offer to remember your choice for the next time you open a file of that type. </para> +<para>&kde; comes with a set of applications to view and edit files of many common types, and when you click a file containing, say, a document or image, &konqueror; will start the appropriate application to display the file. If it doesn't know what application to start to open a file you clicked, &konqueror; will prompt you for the name of the application to run, and when you have chosen, &konqueror; will offer to remember your choice for the next time you open a file of that type. </para> <note> -<para ->&konqueror; uses MIME types to associate files with applications. </para> -</note -> +<para>&konqueror; uses MIME types to associate files with applications. </para> +</note> </sect2> <sect2> -<title ->Dragging and Dropping Icons</title> +<title>Dragging and Dropping Icons</title> -<para ->To copy or move a file, simply drag its icon to the desktop, to another &konqueror; window, or to a folder icon. When you release the button, &konqueror; displays a menu to allow you to choose to copy, move, or create a link to the file. </para> +<para>To copy or move a file, simply drag its icon to the desktop, to another &konqueror; window, or to a folder icon. When you release the button, &konqueror; displays a menu to allow you to choose to copy, move, or create a link to the file. </para> <note> -<para ->Note that if you choose to create a link, &kde; creates a &UNIX; symbolic link (not a hard link), so if you move or delete the original file, the link will be broken. </para> +<para>Note that if you choose to create a link, &kde; creates a &UNIX; symbolic link (not a hard link), so if you move or delete the original file, the link will be broken. </para> </note> -<para ->Most &kde; applications also support drag and drop operations: you can drag an icon on to a window of a running application, or on to an icon of an application that is not started, to have the application open the file. Try it! </para> +<para>Most &kde; applications also support drag and drop operations: you can drag an icon on to a window of a running application, or on to an icon of an application that is not started, to have the application open the file. Try it! </para> </sect2> <sect2> -<title ->Setting File Properties</title> +<title>Setting File Properties</title> -<para ->To change file properties, such as its name and permissions, &RMB; click the icon and choose <guimenuitem ->Properties</guimenuitem -> from the menu. </para> +<para>To change file properties, such as its name and permissions, &RMB; click the icon and choose <guimenuitem>Properties</guimenuitem> from the menu. </para> </sect2> </sect1> <sect1 id="archives-and-networks"> -<title ->Working with Archives and Networks</title> - -<para ->In the recent past, you needed special software to access files on the Internet. Not any more! </para> - -<para ->&kde; supports a technology called <quote ->Network Transparent Access</quote -> (<acronym ->NTA</acronym ->) which allows you to work with files on the other side of the world as easily as those on your local hard disk.</para> - -<para ->For example, to access files on an &FTP; server, just choose <menuchoice -><guimenu ->Location</guimenu -><guimenuitem ->Open Location</guimenuitem -></menuchoice -> from a &konqueror; menu, and enter the <acronym ->URL</acronym -> of an &FTP; server. You can drag and drop files to and from the folders on the server just as if they were on your local disk. You'll even be able to open files on the &FTP; server without having to manually copy them to your local disk (&kde; does it for you when necessary). </para> +<title>Working with Archives and Networks</title> + +<para>In the recent past, you needed special software to access files on the Internet. Not any more! </para> + +<para>&kde; supports a technology called <quote>Network Transparent Access</quote> (<acronym>NTA</acronym>) which allows you to work with files on the other side of the world as easily as those on your local hard disk.</para> + +<para>For example, to access files on an &FTP; server, just choose <menuchoice><guimenu>Location</guimenu><guimenuitem>Open Location</guimenuitem></menuchoice> from a &konqueror; menu, and enter the <acronym>URL</acronym> of an &FTP; server. You can drag and drop files to and from the folders on the server just as if they were on your local disk. You'll even be able to open files on the &FTP; server without having to manually copy them to your local disk (&kde; does it for you when necessary). </para> <note> -<para ->Note that &konqueror; uses anonymous &FTP; access, which may restrict your access to files on the &FTP; server. If you have an account on the server, you can supply your user <abbrev ->ID</abbrev -> as part of the <acronym ->URL</acronym ->, like this: <userinput -><command ->ftp://</command -><parameter ->userid</parameter ->@<parameter ->server</parameter ->/<parameter ->folder</parameter -></userinput -> </para> - -<para ->&konqueror; will prompt you for your password, and if the login succeeds, you will have full access to your files on the server. </para> +<para>Note that &konqueror; uses anonymous &FTP; access, which may restrict your access to files on the &FTP; server. If you have an account on the server, you can supply your user <abbrev>ID</abbrev> as part of the <acronym>URL</acronym>, like this: <userinput><command>ftp://</command><parameter>userid</parameter>@<parameter>server</parameter>/<parameter>folder</parameter></userinput> </para> + +<para>&konqueror; will prompt you for your password, and if the login succeeds, you will have full access to your files on the server. </para> </note> -<para ->If you are used to the <trademark -><application ->WinZip</application -></trademark -> utility on &Microsoft; &Windows;, then you will be happy to hear that &kde; can look into tar archives, too. It treats such archives just like a normal folder, and you can browse into the archive, open files, &etc; In general, accessing files on the Internet and in archives should look and feel just like accessing files on your local disk, except for delays imposed by the network and extracting the archive. </para> +<para>If you are used to the <trademark><application>WinZip</application></trademark> utility on &Microsoft; &Windows;, then you will be happy to hear that &kde; can look into tar archives, too. It treats such archives just like a normal folder, and you can browse into the archive, open files, &etc; In general, accessing files on the Internet and in archives should look and feel just like accessing files on your local disk, except for delays imposed by the network and extracting the archive. </para> </sect1> <sect1 id="using-templates"> -<title ->Using Templates to access Applications and Devices</title> +<title>Using Templates to access Applications and Devices</title> -<para ->In &kde; it's easy to put icons on the panel or the desktop to access your applications. It's just as easy to add icons to access other items of interest. &kde; has templates for shortcuts to: </para> +<para>In &kde; it's easy to put icons on the panel or the desktop to access your applications. It's just as easy to add icons to access other items of interest. &kde; has templates for shortcuts to: </para> <itemizedlist> <listitem> -<para ->Applications </para> +<para>Applications </para> </listitem> <listitem> -<para ->Printers </para> +<para>Printers </para> </listitem> <listitem> -<para ->Mountable Devices (⪚ floppy drives) </para> -</listitem -> +<para>Mountable Devices (⪚ floppy drives) </para> +</listitem> <listitem> -<para ->Internet resources (⪚ <acronym ->WWW</acronym -> documents, &FTP; folders) </para> +<para>Internet resources (⪚ <acronym>WWW</acronym> documents, &FTP; folders) </para> </listitem> <listitem> -<para ->Documents for some of &kde;'s &koffice; applications. </para> +<para>Documents for some of &kde;'s &koffice; applications. </para> </listitem> </itemizedlist> -<para ->You can add any of these items to the desktop by &RMB; clicking where you want the icon, and choosing <guisubmenu ->Create New</guisubmenu -> and selecting the item you want to link to. </para> - -<para ->Nearly every item in the &kmenu;, on the desktop, and on the panel refers to a <literal role="extension" ->.desktop</literal -> file on disk. The <literal role="extension" ->.desktop</literal -> file specifies what icon to display, as well as specific information about what the icon represents (an application, device, or <acronym ->URL</acronym ->). You can drag any <literal role="extension" ->.desktop</literal -> file to the panel to create a quick-launch button. </para> +<para>You can add any of these items to the desktop by &RMB; clicking where you want the icon, and choosing <guisubmenu>Create New</guisubmenu> and selecting the item you want to link to. </para> + +<para>Nearly every item in the &kmenu;, on the desktop, and on the panel refers to a <literal role="extension">.desktop</literal> file on disk. The <literal role="extension">.desktop</literal> file specifies what icon to display, as well as specific information about what the icon represents (an application, device, or <acronym>URL</acronym>). You can drag any <literal role="extension">.desktop</literal> file to the panel to create a quick-launch button. </para> <!-- <sect2> -<title ->Setting up printers</title> +<title>Setting up printers</title> <para> You can create icons for your printers so that you can print a file by @@ -888,467 +442,234 @@ dragging it to a printer icon. Here's how: </para> <procedure> -<step -><para ->Open the Templates folder located on the desktop. </para -></step> -<step -><para ->Drag the Program icon in the folder to the desktop. Choose -<guimenuitem ->Copy</guimenuitem -> from the menu that appears when you drop the -icon.</para -></step> -<step -><para -><mousebutton ->Right</mousebutton -> click the new icon, and choose -<guimenuitem ->Properties</guimenuitem -> from the context menu.</para -></step> -<step -><para ->On the <guilabel ->General</guilabel -> tab, change the name to -<filename ->Printer.kdelnk</filename ->.</para -></step> -<step -><para ->On the <guilabel ->Execute</guilabel -> tab, enter the following in the -first <guilabel ->Execute</guilabel -> field:</para> -<screen -><command>lpr <option>%f</option></command></screen> -<note -><para ->This example assumes that you print using the <command ->lpr</command> +<step><para>Open the Templates folder located on the desktop. </para></step> +<step><para>Drag the Program icon in the folder to the desktop. Choose +<guimenuitem>Copy</guimenuitem> from the menu that appears when you drop the +icon.</para></step> +<step><para><mousebutton>Right</mousebutton> click the new icon, and choose +<guimenuitem>Properties</guimenuitem> from the context menu.</para></step> +<step><para>On the <guilabel>General</guilabel> tab, change the name to +<filename>Printer.kdelnk</filename>.</para></step> +<step><para>On the <guilabel>Execute</guilabel> tab, enter the following in the +first <guilabel>Execute</guilabel> field:</para> +<screen><command>lpr <option>%f</option></command></screen> +<note><para>This example assumes that you print using the <command>lpr</command> command. If you use a different command, enter the one you -use.</para -></note -></step> -<step -><para ->Still in the <guilabel ->Execute</guilabel -> tab, click the icon that -looks like a <guiicon ->cog</guiicon ->, and select the <guiicon ->Printer</guiicon -> icon from the list that appears.</para -></step> +use.</para></note></step> +<step><para>Still in the <guilabel>Execute</guilabel> tab, click the icon that +looks like a <guiicon>cog</guiicon>, and select the <guiicon>Printer</guiicon> icon from the list that appears.</para></step> </procedure> -<para ->Now you should be able to drag a file to the Printer icon and have it -printed on your default printer.</para -> +<para>Now you should be able to drag a file to the Printer icon and have it +printed on your default printer.</para> </sect2> --> <sect2> -<title ->Mounting devices</title> - -<para ->&UNIX; provides access to storage devices other than the primary <hardware ->hard disk</hardware -> through a process called <emphasis ->mounting</emphasis ->. &kde; uses <literal role="extension" ->.desktop</literal -> files to allow you to easily mount, unmount, and access files on secondary storage devices such as <hardware ->floppy</hardware -> drives and &cdrom; drives. </para> - -<para ->As an example, here are the steps needed to create an icon to access files on a floppy disk: </para> +<title>Mounting devices</title> + +<para>&UNIX; provides access to storage devices other than the primary <hardware>hard disk</hardware> through a process called <emphasis>mounting</emphasis>. &kde; uses <literal role="extension">.desktop</literal> files to allow you to easily mount, unmount, and access files on secondary storage devices such as <hardware>floppy</hardware> drives and &cdrom; drives. </para> + +<para>As an example, here are the steps needed to create an icon to access files on a floppy disk: </para> <note> -<para ->Many systems require you to be logged in as <systemitem class="username" ->root</systemitem -> to mount and unmount devices. </para> +<para>Many systems require you to be logged in as <systemitem class="username">root</systemitem> to mount and unmount devices. </para> </note> <procedure> <step> -<para -><mousebutton ->Right</mousebutton -> click on the desktop and choose <menuchoice -><guisubmenu ->Create New</guisubmenu -> <guimenuitem ->Floppy Device...</guimenuitem -></menuchoice ->. </para> +<para><mousebutton>Right</mousebutton> click on the desktop and choose <menuchoice><guisubmenu>Create New</guisubmenu> <guimenuitem>Floppy Device...</guimenuitem></menuchoice>. </para> </step> <step> -<para ->On the <guilabel ->General</guilabel -> tab of the resulting dialogue, change the name to whatever you like, in the text box at the top. </para> +<para>On the <guilabel>General</guilabel> tab of the resulting dialogue, change the name to whatever you like, in the text box at the top. </para> </step> <step> -<para ->On the <guilabel ->Device</guilabel -> tab, enter <filename class="devicefile" ->/dev/fd0</filename -> (or the path to the floppy device as it is named on your system) as the <guilabel ->Device</guilabel ->. </para> +<para>On the <guilabel>Device</guilabel> tab, enter <filename class="devicefile">/dev/fd0</filename> (or the path to the floppy device as it is named on your system) as the <guilabel>Device</guilabel>. </para> </step> <step> -<para ->You can add a <guilabel ->Mount Point</guilabel -> here too. This should be an existing folder, but empty. Common mount points are <filename class="directory" ->/mnt/floppy</filename -> or <filename class="directory" ->/floppy</filename ->, but you can just as easily have floppy disks mounted on <filename class="directory" ->~/mydisk</filename -> if you want. </para> -</step -> +<para>You can add a <guilabel>Mount Point</guilabel> here too. This should be an existing folder, but empty. Common mount points are <filename class="directory">/mnt/floppy</filename> or <filename class="directory">/floppy</filename>, but you can just as easily have floppy disks mounted on <filename class="directory">~/mydisk</filename> if you want. </para> +</step> <step> -<para ->Click the <guilabel ->Unmounted Icon</guilabel -> and select the picture of a floppy disk without the green light. </para> +<para>Click the <guilabel>Unmounted Icon</guilabel> and select the picture of a floppy disk without the green light. </para> </step> <step> -<para ->Once you're happy with your choices, choose <guibutton ->OK</guibutton -> and you are finished! </para> +<para>Once you're happy with your choices, choose <guibutton>OK</guibutton> and you are finished! </para> </step> </procedure> -<para ->Now, place a properly formatted floppy in the drive and click the <guiicon ->Floppy</guiicon -> icon to have &kde; mount the floppy drive and display the files on the disk. Before removing the disk from the drive, &RMB; click the <guiicon ->Floppy</guiicon -> icon and choose <guimenuitem ->Unmount</guimenuitem -> from the menu. </para> +<para>Now, place a properly formatted floppy in the drive and click the <guiicon>Floppy</guiicon> icon to have &kde; mount the floppy drive and display the files on the disk. Before removing the disk from the drive, &RMB; click the <guiicon>Floppy</guiicon> icon and choose <guimenuitem>Unmount</guimenuitem> from the menu. </para> </sect2> </sect1> </chapter> <chapter id="configure"> -<title ->Configuring your desktop</title> +<title>Configuring your desktop</title> -<para ->If you do not like something about the way the desktop looks or operates, you can probably change it. &kde; is very configurable and you can change almost every aspect of the appearance and the behaviour of your desktop. Unlike many other &UNIX; desktop environments, you do not have to edit cryptic configuration files either (but you can if you really want to!) You use the &kcontrol;, a special program for configuring your desktop. </para> +<para>If you do not like something about the way the desktop looks or operates, you can probably change it. &kde; is very configurable and you can change almost every aspect of the appearance and the behaviour of your desktop. Unlike many other &UNIX; desktop environments, you do not have to edit cryptic configuration files either (but you can if you really want to!) You use the &kcontrol;, a special program for configuring your desktop. </para> <sect1 id="using-kde-control"> -<title ->Using the <application ->&kde; Control Centre</application -></title> - -<para ->Launch the &kcontrol; from the <link linkend="starter" ->&kmenu;</link ->. A window with two panes appears, displaying a list of modules in the left pane. </para -> - -<para ->Open a module by clicking its name; a list of submodules will appear. Then, click one of the submodule category names to edit its configuration in the right pane. </para> - -<para ->Changing the configuration is fairly straightforward. A help button is available on each configuration panel to explain settings that are not obvious. Each panel has buttons labelled <guibutton ->Help</guibutton ->, <guibutton ->Use Defaults</guibutton ->, <guibutton ->Apply</guibutton ->, and <guibutton ->Reset</guibutton ->, which work as follows: </para> +<title>Using the <application>&kde; Control Centre</application></title> + +<para>Launch the &kcontrol; from the <link linkend="starter">&kmenu;</link>. A window with two panes appears, displaying a list of modules in the left pane. </para> + +<para>Open a module by clicking its name; a list of submodules will appear. Then, click one of the submodule category names to edit its configuration in the right pane. </para> + +<para>Changing the configuration is fairly straightforward. A help button is available on each configuration panel to explain settings that are not obvious. Each panel has buttons labelled <guibutton>Help</guibutton>, <guibutton>Use Defaults</guibutton>, <guibutton>Apply</guibutton>, and <guibutton>Reset</guibutton>, which work as follows: </para> <variablelist> <varlistentry> -<term -><guibutton ->Help</guibutton -></term> +<term><guibutton>Help</guibutton></term> <listitem> -<para ->Displays a short help text in the left hand pane, including a link to a longer manual for the module in question. </para> +<para>Displays a short help text in the left hand pane, including a link to a longer manual for the module in question. </para> </listitem> </varlistentry> <varlistentry> -<term -><guibutton ->Use Defaults</guibutton -></term> +<term><guibutton>Use Defaults</guibutton></term> <listitem> -<para ->Sets all the options in the current module back to the default at the time &kde; was installed. </para> +<para>Sets all the options in the current module back to the default at the time &kde; was installed. </para> </listitem> </varlistentry> <varlistentry> -<term -><guibutton ->Apply</guibutton -></term> +<term><guibutton>Apply</guibutton></term> <listitem> -<para ->Applies the current settings in the currently open module. </para> +<para>Applies the current settings in the currently open module. </para> </listitem> </varlistentry> <varlistentry> -<term -><guibutton ->Reset</guibutton -></term> +<term><guibutton>Reset</guibutton></term> <listitem> -<para ->Resets the options to the state they were in when you opened the module. If you have already used the <guibutton ->Apply</guibutton -> button, then this button will reset the options to the state they were in when you pressed <guibutton ->Apply</guibutton ->. </para> +<para>Resets the options to the state they were in when you opened the module. If you have already used the <guibutton>Apply</guibutton> button, then this button will reset the options to the state they were in when you pressed <guibutton>Apply</guibutton>. </para> </listitem> </varlistentry> </variablelist> <note> -<para ->If you make changes on one configuration panel and move to a different module without clicking <guibutton ->OK</guibutton -> or <guibutton ->Apply</guibutton -> first, &kcontrol; will prompt you to ask whether your changes should be applied first. </para> +<para>If you make changes on one configuration panel and move to a different module without clicking <guibutton>OK</guibutton> or <guibutton>Apply</guibutton> first, &kcontrol; will prompt you to ask whether your changes should be applied first. </para> </note> </sect1> <sect1 id="configuration-modules"> -<title ->Configuration Modules</title> +<title>Configuration Modules</title> -<para ->Here is a brief overview of the major configuration modules categories: </para> +<para>Here is a brief overview of the major configuration modules categories: </para> <variablelist> <varlistentry> -<term -><guilabel ->File Browsing</guilabel -></term> +<term><guilabel>File Browsing</guilabel></term> <listitem> -<para ->Contains options that relate to how you view the contents of your local system. </para> +<para>Contains options that relate to how you view the contents of your local system. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Information</guilabel -></term> +<term><guilabel>Information</guilabel></term> <listitem> -<para ->Contains modules that you normally can't use to change anything. They display useful information about your computer instead. </para> +<para>Contains modules that you normally can't use to change anything. They display useful information about your computer instead. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Appearance & Themes</guilabel -></term> +<term><guilabel>Appearance & Themes</guilabel></term> <listitem> -<para ->Here you find the modules that have the most visible effect on your environment: Colours, styles, window decorations. Nearly everything you see can be customised to suit your tastes, and the few things that can't be, soon will. </para> +<para>Here you find the modules that have the most visible effect on your environment: Colours, styles, window decorations. Nearly everything you see can be customised to suit your tastes, and the few things that can't be, soon will. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Network</guilabel -></term> +<term><guilabel>Network</guilabel></term> <listitem> -<para ->The place to configure how your computer sees the world outside, as well as how the world sees you. Among other things, you can set up central email identities that many &kde; applications can use, to save you having to enter the same information over and over, you can set up SOCKS firewall support, and you can configure &Windows; (<acronym ->SMB</acronym ->) shares... and much more. </para> +<para>The place to configure how your computer sees the world outside, as well as how the world sees you. Among other things, you can set up central email identities that many &kde; applications can use, to save you having to enter the same information over and over, you can set up SOCKS firewall support, and you can configure &Windows; (<acronym>SMB</acronym>) shares... and much more. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Peripherals</guilabel -></term> +<term><guilabel>Peripherals</guilabel></term> <listitem> -<para ->Contains settings for your keyboard and mouse, and for printers. </para> +<para>Contains settings for your keyboard and mouse, and for printers. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Personalisation</guilabel -></term> +<term><guilabel>Personalisation</guilabel></term> <listitem> -<para ->Here you can set up things that make your life easier, from accessibility features to localisation, so that &kde; applications know how you like to see numbers and dates formatted, for example. </para> +<para>Here you can set up things that make your life easier, from accessibility features to localisation, so that &kde; applications know how you like to see numbers and dates formatted, for example. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Power Control</guilabel -></term> +<term><guilabel>Power Control</guilabel></term> <listitem> -<para ->If your computer supports <acronym ->APM</acronym -> power saving features, or you are using a laptop, this is the place to configure them. </para> +<para>If your computer supports <acronym>APM</acronym> power saving features, or you are using a laptop, this is the place to configure them. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Sound</guilabel -></term> +<term><guilabel>Sound</guilabel></term> <listitem> -<para ->Configure the sound daemon (&artsd;) and other audio behaviour. </para> +<para>Configure the sound daemon (&artsd;) and other audio behaviour. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->System</guilabel -></term> +<term><guilabel>System</guilabel></term> <listitem> -<para ->Here you can set the remaining system features - how the &konsole; and &tdm; applications behave, set up printing, and set your system date. You might not be able to set some of these options unless you are logged in as <systemitem class="username" ->root</systemitem ->, but &kcontrol; will let you know if this is the case. </para> +<para>Here you can set the remaining system features - how the &konsole; and &tdm; applications behave, set up printing, and set your system date. You might not be able to set some of these options unless you are logged in as <systemitem class="username">root</systemitem>, but &kcontrol; will let you know if this is the case. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Web Browsing</guilabel -></term> +<term><guilabel>Web Browsing</guilabel></term> <listitem> -<para ->With the Internet, and especially the web, being such an integral part of today's computer world, there are many options to be set to enhance your experience. You'll find them all here, from setting up custom style sheets, to proxies and caching. </para> +<para>With the Internet, and especially the web, being such an integral part of today's computer world, there are many options to be set to enhance your experience. You'll find them all here, from setting up custom style sheets, to proxies and caching. </para> </listitem> </varlistentry> </variablelist> -<para ->Go ahead! Explore the configuration possibilities and discover the flexibility of &kde;. </para> +<para>Go ahead! Explore the configuration possibilities and discover the flexibility of &kde;. </para> </sect1> </chapter> <chapter id="logging-out"> -<title ->Logging out</title> - -<para ->We sincerely hope that using &kde; gives you so much fun and pleasure that you never want to log out. But if you do, simply choose <menuchoice -><guimenu ->TDE menu</guimenu -> <guimenuitem ->Logout</guimenuitem -></menuchoice ->. </para> - -<para ->There is also a logout button directly on the panel, which looks like a small power button. Or you can press <keycombo action="simul" ->&Ctrl; &Alt; <keycap ->Delete</keycap -></keycombo -> to log out. </para> +<title>Logging out</title> + +<para>We sincerely hope that using &kde; gives you so much fun and pleasure that you never want to log out. But if you do, simply choose <menuchoice><guimenu>TDE menu</guimenu> <guimenuitem>Logout</guimenuitem></menuchoice>. </para> + +<para>There is also a logout button directly on the panel, which looks like a small power button. Or you can press <keycombo action="simul">&Ctrl; &Alt; <keycap>Delete</keycap></keycombo> to log out. </para> <sect1 id="session-management"> -<title ->Session Management</title> - -<para ->When you log out, &kde; can remember which applications you had open, as well as where all the windows were located, so that it can open them for you the next time you log in. This feature is termed <emphasis ->Session Management</emphasis ->. &kde;-aware applications will restore themselves to the state they were in when you logged out. For example, &kate; remembers which files you were editing. </para> - -<para ->Non-&kde; applications do not memorise their state on logout, and &kde; will warn you to make sure that you have saved any important data in them when you start to log out. </para> - -<para ->To illustrate session management, choose <menuchoice -> <guimenu ->TDE menu</guimenu -><guisubmenu ->Editors</guisubmenu -> <guimenuitem ->Kate</guimenuitem -> </menuchoice -> to start &kate;. Open a text document to edit. Now log out and back in. You will observe that &kate; will be restored to the exact same position on the screen, including the right virtual desktop, and the document we left open in &kate; before we logged out is opened again automatically. &kate; will even remember whether you had unsaved changes to your document before you logged out and will save them to the file you were working on if you choose <guimenuitem ->Save</guimenuitem -> from the <guimenu ->File</guimenu -> menu. </para> +<title>Session Management</title> + +<para>When you log out, &kde; can remember which applications you had open, as well as where all the windows were located, so that it can open them for you the next time you log in. This feature is termed <emphasis>Session Management</emphasis>. &kde;-aware applications will restore themselves to the state they were in when you logged out. For example, &kate; remembers which files you were editing. </para> + +<para>Non-&kde; applications do not memorise their state on logout, and &kde; will warn you to make sure that you have saved any important data in them when you start to log out. </para> + +<para>To illustrate session management, choose <menuchoice> <guimenu>TDE menu</guimenu><guisubmenu>Editors</guisubmenu> <guimenuitem>Kate</guimenuitem> </menuchoice> to start &kate;. Open a text document to edit. Now log out and back in. You will observe that &kate; will be restored to the exact same position on the screen, including the right virtual desktop, and the document we left open in &kate; before we logged out is opened again automatically. &kate; will even remember whether you had unsaved changes to your document before you logged out and will save them to the file you were working on if you choose <guimenuitem>Save</guimenuitem> from the <guimenu>File</guimenu> menu. </para> </sect1> </chapter> <chapter id="kde-an-exciting-journey"> -<title ->&kde;, an exciting Journey</title> +<title>&kde;, an exciting Journey</title> -<para ->We hope you enjoyed this brief tour of the K Desktop environment and that this unique desktop environment will help you get your work done faster and more comfortably than ever. </para> +<para>We hope you enjoyed this brief tour of the K Desktop environment and that this unique desktop environment will help you get your work done faster and more comfortably than ever. </para> -<para ->Please remember that the &kde; project is not a commercial venture, but rather a project run by volunteers from all over the world. We would like to invite you to join the &kde; project and become part of this unique network of people. If you are a programmer you might consider helping us write &kde; applications. If you are an artist or have experience with graphic design, consider creating icons sets, colour schemes, sound schemes and logos for &kde;. If you enjoy writing we would love for you to join our documentation project. </para> +<para>Please remember that the &kde; project is not a commercial venture, but rather a project run by volunteers from all over the world. We would like to invite you to join the &kde; project and become part of this unique network of people. If you are a programmer you might consider helping us write &kde; applications. If you are an artist or have experience with graphic design, consider creating icons sets, colour schemes, sound schemes and logos for &kde;. If you enjoy writing we would love for you to join our documentation project. </para> -<para ->As you can see there are many ways in which you can help. You are cordially invited to join this world-wide network of people dedicated to making &kde; the best desktop environment for any computer. Please visit <ulink url="http://www.kde.org" ->www.kde.org</ulink -> for more information. </para> +<para>As you can see there are many ways in which you can help. You are cordially invited to join this world-wide network of people dedicated to making &kde; the best desktop environment for any computer. Please visit <ulink url="http://www.kde.org">www.kde.org</ulink> for more information. </para> <para> -<emphasis ->Welcome aboard on this exciting journey, </emphasis> +<emphasis>Welcome aboard on this exciting journey, </emphasis> </para> <para> -<literal ->Your &kde; Team</literal> +<literal>Your &kde; Team</literal> </para> </chapter> @@ -1357,26 +678,18 @@ printed on your default printer.</para Removed because it probably shouldn't be here, and it'll only end up getting out-of-date if it is (Phil) <chapter id="advanced-topics"> -<title ->Advanced Topics</title> +<title>Advanced Topics</title> <sect1 id="mime"> -<title ->&MIME; Types</title> +<title>&MIME; Types</title> <para> &kde; comes with a number of &MIME; types predefined, but you can add your own &MIME; types by choosing -<menuchoice -><guimenu ->Settings</guimenu> -<guisubmenu ->Configure Konqueror...</guisubmenu> -</menuchoice -> and then <guilabel ->File -Associations</guilabel -> in a &konqueror; window. +<menuchoice><guimenu>Settings</guimenu> +<guisubmenu>Configure Konqueror...</guisubmenu> +</menuchoice> and then <guilabel>File +Associations</guilabel> in a &konqueror; window. </para> <para> @@ -1389,8 +702,7 @@ click menu on the file in question. <procedure> -<title ->To link a certain file type with a particular application:</title> +<title>To link a certain file type with a particular application:</title> <step> <para> Make sure the application you want to start this file type has an @@ -1399,47 +711,26 @@ entry in the &kmenu;. </step> <step> -<para ->In &konqueror; find or make a file with the extension you wish to +<para>In &konqueror; find or make a file with the extension you wish to link. </para> -</step -> +</step> <step> <para> -<mousebutton ->Right</mousebutton -> click on the file, and choose -<guimenuitem ->Edit File Type</guimenuitem -> from the context menu, or -choose <menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Edit File -Type</guimenuitem -></menuchoice -> in &konqueror;'s menu bar. +<mousebutton>Right</mousebutton> click on the file, and choose +<guimenuitem>Edit File Type</guimenuitem> from the context menu, or +choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Edit File +Type</guimenuitem></menuchoice> in &konqueror;'s menu bar. </para> </step> -<step -> <para -> Add file masks for the application by clicking the -<guibutton ->Add</guibutton -> button, and entering the file pattern you +<step> <para> Add file masks for the application by clicking the +<guibutton>Add</guibutton> button, and entering the file pattern you want. Remember that &UNIX; is case sensitive, so you may need to add -variations - <userinput ->*.mp3</userinput -> may need -<userinput ->*.MP3</userinput -> added as well, for example. Add as many -extensions as you like in this way. </para -> </step> +variations - <userinput>*.mp3</userinput> may need +<userinput>*.MP3</userinput> added as well, for example. Add as many +extensions as you like in this way. </para> </step> <step> <para> @@ -1448,13 +739,8 @@ Add a description if you like. This is optional. </step> <step> -<para ->In the section labeled <guilabel ->Application Preference -Order</guilabel ->, press the <guibutton ->Add</guibutton -> button. A +<para>In the section labeled <guilabel>Application Preference +Order</guilabel>, press the <guibutton>Add</guibutton> button. A miniature copy of the &kmenu; will open, where you can choose the application you want files of this type to be opened with. @@ -1468,32 +754,19 @@ file type. For example, you might like to use &kate; to open text files you wish to edit, and &kedit; for text files that you just want to take a quick peek into. You can add more applications in the same way as you did in the last step, and you can change the preferred -order using the <guibutton ->Move Up</guibutton -> and <guibutton ->Move -Down</guibutton -> buttons. +order using the <guibutton>Move Up</guibutton> and <guibutton>Move +Down</guibutton> buttons. </para> -</step -> +</step> <step> <para> If you're satisfied with your choices, you can click the -<guibutton ->Apply</guibutton -> button to save your changes without +<guibutton>Apply</guibutton> button to save your changes without closing the dialog box. This gives you the opportunity to test in the -<application ->Konqueror</application -> window that your file association -is correct. You can choose <guibutton ->OK</guibutton -> to save your -changes and close the dialog box, or <guibutton ->Cancel</guibutton -> if +<application>Konqueror</application> window that your file association +is correct. You can choose <guibutton>OK</guibutton> to save your +changes and close the dialog box, or <guibutton>Cancel</guibutton> if you have changed your mind and just want to close the dialog box. </para> </step> @@ -1511,12 +784,9 @@ program needed to edit it should start. be used to using file extensions for that purpose, and you may know that on &UNIX; systems the file extension often bears little or no relation to the contents of the file. On the other hand, it may be -vital - for example, some implementations of <command ->gunzip</command> +vital - for example, some implementations of <command>gunzip</command> won't operate on files that aren't named <literal -role="extension" ->.gz</literal ->. +role="extension">.gz</literal>. </para> <para> @@ -1526,19 +796,9 @@ like. For example, if you always want to open any files relating to a particular client with &kate;, and you make a habit of naming the files with the client's name at the beginning so that they naturally group in the &konqueror; window, then you can set up a filename pattern that -matches <literal ->^<replaceable ->clientname</replaceable ->*</literal ->. -Then any files that have <replaceable ->clientname</replaceable -> at the -beginning (the <token ->^</token -> character means <quote ->starts with...</quote ->) and +matches <literal>^<replaceable>clientname</replaceable>*</literal>. +Then any files that have <replaceable>clientname</replaceable> at the +beginning (the <token>^</token> character means <quote>starts with...</quote>) and without any regard to the rest of the filename. </para> </note> @@ -1548,62 +808,21 @@ without any regard to the rest of the filename. </chapter> --> <chapter id="credits"> -<title ->Credits</title> +<title>Credits</title> <sect1 id="authors"> -<title ->Authors</title> +<title>Authors</title> <itemizedlist> -<listitem -><para ->Matthias Ettrich <email ->ettrich@kde.org</email -></para -></listitem> -<listitem -><para ->Kalle Dahlheimer <email ->kalle@kde.org</email -></para -></listitem> -<listitem -><para ->Torben Weiss <email ->weis@kde.org</email -></para -></listitem> -<listitem -><para ->Bernd Wuebben <email ->wuebben@kde.org</email -></para -></listitem> -<listitem -><para ->Stephen Schaub <email ->sschaub@bju.edu</email -> - Editor</para -></listitem> -<listitem -><para ->Robert Williams <email ->rwilliams@kde.org</email -> - Editor</para -></listitem> -<listitem -><para ->Lauri Watts <email ->lauri@kde.org</email -></para -></listitem> +<listitem><para>Matthias Ettrich <email>ettrich@kde.org</email></para></listitem> +<listitem><para>Kalle Dahlheimer <email>kalle@kde.org</email></para></listitem> +<listitem><para>Torben Weiss <email>weis@kde.org</email></para></listitem> +<listitem><para>Bernd Wuebben <email>wuebben@kde.org</email></para></listitem> +<listitem><para>Stephen Schaub <email>sschaub@bju.edu</email> - Editor</para></listitem> +<listitem><para>Robert Williams <email>rwilliams@kde.org</email> - Editor</para></listitem> +<listitem><para>Lauri Watts <email>lauri@kde.org</email></para></listitem> </itemizedlist> -<para ->Conversion to British English: Malcolm Hunter <email ->malcolm.hunter@gmx.co.uk</email -></para -> +<para>Conversion to British English: Malcolm Hunter <email>malcolm.hunter@gmx.co.uk</email></para> &underFDL; </sect1> </chapter> </book> diff --git a/tde-i18n-en_GB/docs/tdebase/tdedebugdialog/index.docbook b/tde-i18n-en_GB/docs/tdebase/tdedebugdialog/index.docbook index da8a975e139..c2bdb328b71 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdedebugdialog/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdedebugdialog/index.docbook @@ -1,194 +1,89 @@ <?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ - <!ENTITY tdedebugdialog "<application ->TDEDebugDialog</application ->"> + <!ENTITY tdedebugdialog "<application>TDEDebugDialog</application>"> <!ENTITY kappname "&tdedebugdialog;"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <book lang="&language;"> <bookinfo> -<title ->The &tdedebugdialog; Handbook</title> +<title>The &tdedebugdialog; Handbook</title> <authorgroup> -<author ->&David.Faure; &David.Faure.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&David.Faure; &David.Faure.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2001-02-13</date> -<releaseinfo ->0.03.00</releaseinfo> +<date>2001-02-13</date> +<releaseinfo>0.03.00</releaseinfo> <abstract> -<para ->This document describes &tdedebugdialog;.</para> +<para>This document describes &tdedebugdialog;.</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->TDEDebugdialog</keyword> +<keyword>KDE</keyword> +<keyword>TDEDebugdialog</keyword> </keywordset> </bookinfo> <chapter id="Introduction"> -<title ->What is TDEDebugDialog?</title> - -<para ->It is a dialogue box for managing diagnostic messages at runtime. </para> - -<para ->If you simply start <command ->tdedebugdialog</command ->, you will see a list of <quote ->areas</quote ->, that can be disabled or enabled. A <function ->kdDebug(area)</function -> call in the code will show something in the debug output only if the area is enabled.</para> - -<note -><para ->Note that kdWarning, kdError and kdFatal always appear, they are NOT controlled by this setting. </para -></note> +<title>What is TDEDebugDialog?</title> + +<para>It is a dialogue box for managing diagnostic messages at runtime. </para> + +<para>If you simply start <command>tdedebugdialog</command>, you will see a list of <quote>areas</quote>, that can be disabled or enabled. A <function>kdDebug(area)</function> call in the code will show something in the debug output only if the area is enabled.</para> + +<note><para>Note that kdWarning, kdError and kdFatal always appear, they are NOT controlled by this setting. </para></note> <variablelist> <varlistentry> -<term -><guilabel ->Area</guilabel -></term> +<term><guilabel>Area</guilabel></term> <listitem> -<para ->The areas which should only be output. Every message that is not mentioned here will simply not be output (unless this field remains empty, which is the default, and means that all messages should be output). You can enter several areas separated by commas here, and you can also use area ranges with the syntax start-end. Thus a valid entry could be: 117,214-289,356-359,221. Do not use whitespaces.</para> +<para>The areas which should only be output. Every message that is not mentioned here will simply not be output (unless this field remains empty, which is the default, and means that all messages should be output). You can enter several areas separated by commas here, and you can also use area ranges with the syntax start-end. Thus a valid entry could be: 117,214-289,356-359,221. Do not use whitespaces.</para> </listitem> </varlistentry> </variablelist> -<para ->If you start <command ->tdedebugdialog</command -> <option ->--fullmode</option ->, then for every severity level you can define separately what should be done with the diagnostic messages of that level, and the same for each debug area.</para> +<para>If you start <command>tdedebugdialog</command> <option>--fullmode</option>, then for every severity level you can define separately what should be done with the diagnostic messages of that level, and the same for each debug area.</para> -<para ->In full mode, first you should select the debug area you are interested in from the drop down list at the top.</para> +<para>In full mode, first you should select the debug area you are interested in from the drop down list at the top.</para> -<para ->You may independently set the output for various types of messages:</para> +<para>You may independently set the output for various types of messages:</para> <itemizedlist> -<listitem -><para -><guilabel ->Information</guilabel -></para -></listitem> -<listitem -><para -><guilabel ->Warning</guilabel -></para -></listitem> -<listitem -><para -><guilabel ->Error</guilabel -></para -></listitem> -<listitem -><para -><guilabel ->Fatal Error</guilabel -></para -></listitem> +<listitem><para><guilabel>Information</guilabel></para></listitem> +<listitem><para><guilabel>Warning</guilabel></para></listitem> +<listitem><para><guilabel>Error</guilabel></para></listitem> +<listitem><para><guilabel>Fatal Error</guilabel></para></listitem> </itemizedlist> -<para ->For each of these types, you can set the following:</para> +<para>For each of these types, you can set the following:</para> <variablelist> <varlistentry> -<term -><guilabel ->Output to:</guilabel -></term> +<term><guilabel>Output to:</guilabel></term> <listitem> -<para ->In this Combobox, you can choose where the messages should be output. The choices are: <quote ->File</quote ->, <quote ->Message Box</quote ->, <quote ->Shell</quote -> (meaning stderr) and <quote ->Syslog</quote ->. Please do not direct fatal messages to syslog unless you are the system administrator yourself. The default is <quote ->Message Box</quote ->.</para -> +<para>In this Combobox, you can choose where the messages should be output. The choices are: <quote>File</quote>, <quote>Message Box</quote>, <quote>Shell</quote> (meaning stderr) and <quote>Syslog</quote>. Please do not direct fatal messages to syslog unless you are the system administrator yourself. The default is <quote>Message Box</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Filename:</guilabel -></term> -<listitem -><para ->This is only enabled when you have chosen <quote ->File</quote -> as the output and provides the name of that file (which is interpreted as relative to the current folder). The default is <filename ->kdebug.dbg</filename ->.</para> +<term><guilabel>Filename:</guilabel></term> +<listitem><para>This is only enabled when you have chosen <quote>File</quote> as the output and provides the name of that file (which is interpreted as relative to the current folder). The default is <filename>kdebug.dbg</filename>.</para> </listitem> </varlistentry> </variablelist> -<para ->Apart from this, you can also tick the checkbox <guilabel ->Abort on fatal errors</guilabel ->. In this case, if a diagnostic message with the severity level <computeroutput ->KDEBUG_FATAL</computeroutput -> is output, the application aborts with a SIGABRT after outputting the message.</para> - -<para ->When you close the dialogue by pressing <guibutton ->OK</guibutton ->, your entries apply immediately and are saved in <filename ->kdebugrc</filename ->. When you press <guibutton ->Cancel</guibutton ->, your entries are discarded and the old ones are restored.</para> - -<para ->Credits to Kalle Dalheimer for the original version of &tdedebugdialog;</para> +<para>Apart from this, you can also tick the checkbox <guilabel>Abort on fatal errors</guilabel>. In this case, if a diagnostic message with the severity level <computeroutput>KDEBUG_FATAL</computeroutput> is output, the application aborts with a SIGABRT after outputting the message.</para> + +<para>When you close the dialogue by pressing <guibutton>OK</guibutton>, your entries apply immediately and are saved in <filename>kdebugrc</filename>. When you press <guibutton>Cancel</guibutton>, your entries are discarded and the old ones are restored.</para> + +<para>Credits to Kalle Dalheimer for the original version of &tdedebugdialog;</para> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/audiocd.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/audiocd.docbook index 10008a8b8c7..de9a9d33c62 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/audiocd.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/audiocd.docbook @@ -1,291 +1,112 @@ <article lang="&language;" id="audiocd"> -<title ->audiocd</title> +<title>audiocd</title> <articleinfo> <authorgroup> -<author ->&Rik.Hemsley; &Rik.Hemsley.mail; </author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Rik.Hemsley; &Rik.Hemsley.mail; </author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2001-07-14</date> -<releaseinfo ->2.20.00</releaseinfo> +<date>2001-07-14</date> +<releaseinfo>2.20.00</releaseinfo> </articleinfo> -<para ->Allows treating audio <acronym ->CD</acronym ->s like a <quote ->real</quote -> filesystem, where tracks are represented as files and, when copied from the folder, are digitally extracted from the <acronym ->CD</acronym ->. This ensures a perfect copy of the audio data.</para> +<para>Allows treating audio <acronym>CD</acronym>s like a <quote>real</quote> filesystem, where tracks are represented as files and, when copied from the folder, are digitally extracted from the <acronym>CD</acronym>. This ensures a perfect copy of the audio data.</para> -<para ->To see how this slave works, insert an audio <acronym ->CD</acronym -> in your &CD-ROM; drive and type <userinput ->audiocd:/</userinput -> into &konqueror;. Within a few seconds you should see a list of tracks and some folders.</para> +<para>To see how this slave works, insert an audio <acronym>CD</acronym> in your &CD-ROM; drive and type <userinput>audiocd:/</userinput> into &konqueror;. Within a few seconds you should see a list of tracks and some folders.</para> -<para ->Audio <acronym ->CD</acronym ->s don't really have folders, but the audiocd slave provides them as a convenience. If you look inside these folders you will see that they all contain the same number of tracks. If you are connected to the Internet, some folders will have the actual track titles shown as the filenames.</para> +<para>Audio <acronym>CD</acronym>s don't really have folders, but the audiocd slave provides them as a convenience. If you look inside these folders you will see that they all contain the same number of tracks. If you are connected to the Internet, some folders will have the actual track titles shown as the filenames.</para> -<para ->The reason that these separate folders exist are so that you can choose in which format you would like to listen to (or copy) the tracks on the <acronym ->CD</acronym ->.</para> +<para>The reason that these separate folders exist are so that you can choose in which format you would like to listen to (or copy) the tracks on the <acronym>CD</acronym>.</para> -<para ->If you drag a track from the <filename class="directory" ->Ogg Vorbis</filename -> folder and drop it on another &konqueror; window open at your home folder, you should see a progress window showing you that the track is being extracted from the <acronym ->CD</acronym -> and saved to a file. Note that Ogg Vorbis is a compressed format, so the file in your home folder will appear a great deal smaller than it would have been if you had copied the raw data.</para> +<para>If you drag a track from the <filename class="directory">Ogg Vorbis</filename> folder and drop it on another &konqueror; window open at your home folder, you should see a progress window showing you that the track is being extracted from the <acronym>CD</acronym> and saved to a file. Note that Ogg Vorbis is a compressed format, so the file in your home folder will appear a great deal smaller than it would have been if you had copied the raw data.</para> -<para ->The mechanism behind this is quite simple. When the audiocd slave is asked to retrieve a track from the <filename class="directory" ->Ogg Vorbis</filename -> folder, it starts extracting the digital audio data from the <acronym ->CD</acronym ->. As it sends the data over to the file in your home folder, it simultaneously encodes it in Ogg Vorbis format (<acronym ->CD</acronym -> audio is in an uncompressed format to start with).</para> +<para>The mechanism behind this is quite simple. When the audiocd slave is asked to retrieve a track from the <filename class="directory">Ogg Vorbis</filename> folder, it starts extracting the digital audio data from the <acronym>CD</acronym>. As it sends the data over to the file in your home folder, it simultaneously encodes it in Ogg Vorbis format (<acronym>CD</acronym> audio is in an uncompressed format to start with).</para> -<para ->You could also try dragging a file ending in <literal role="extension" ->.wav</literal -> and dropping it on the &kde; Media Player, &noatun;. In this case, the procedure that happens behind the scenes is similar, except that instead of encoding the audio data in Ogg Vorbis format, it is put through a very simple conversion, from raw binary data (which the <literal role="extension" ->.cda</literal -> files in the toplevel folder represent) to <quote ->RIFF WAV</quote -> format, a non-compressed format that most media players understand.</para> +<para>You could also try dragging a file ending in <literal role="extension">.wav</literal> and dropping it on the &kde; Media Player, &noatun;. In this case, the procedure that happens behind the scenes is similar, except that instead of encoding the audio data in Ogg Vorbis format, it is put through a very simple conversion, from raw binary data (which the <literal role="extension">.cda</literal> files in the toplevel folder represent) to <quote>RIFF WAV</quote> format, a non-compressed format that most media players understand.</para> -<para ->&noatun; should quite happily play the <literal role="extension" ->.wav</literal -> file, but if it has trouble, you may consider using the <option ->paranoia_level</option -> option, explained below.</para> +<para>&noatun; should quite happily play the <literal role="extension">.wav</literal> file, but if it has trouble, you may consider using the <option>paranoia_level</option> option, explained below.</para> <variablelist> -<title ->Options</title> +<title>Options</title> <varlistentry> -<term -><option ->device</option -></term> +<term><option>device</option></term> <listitem> -<para ->Set the path to the audio <acronym ->CD</acronym -> device, ⪚ <userinput ->audiocd:/<option ->?device</option ->=<parameter ->/dev/sdc</parameter -></userinput ->. Normally, the slave will try to find a <acronym ->CD</acronym -> drive with an audio <acronym ->CD</acronym -> inserted, but if it fails or you have more than one <acronym ->CD</acronym -> drive, you may want to try this option. Note that the configuration dialogue allows you to set a default value for this option.</para> +<para>Set the path to the audio <acronym>CD</acronym> device, ⪚ <userinput>audiocd:/<option>?device</option>=<parameter>/dev/sdc</parameter></userinput>. Normally, the slave will try to find a <acronym>CD</acronym> drive with an audio <acronym>CD</acronym> inserted, but if it fails or you have more than one <acronym>CD</acronym> drive, you may want to try this option. Note that the configuration dialogue allows you to set a default value for this option.</para> </listitem> </varlistentry> <varlistentry> -<term -><option ->paranoia_level</option -></term> +<term><option>paranoia_level</option></term> <listitem> -<para ->Set the amount of error detection and correction used when extracting data.</para> +<para>Set the amount of error detection and correction used when extracting data.</para> <variablelist> <varlistentry> -<term ->Level 0</term> +<term>Level 0</term> <listitem> -<para ->No detection or correction. Only useful if you have a perfect <acronym ->CD</acronym -> drive (unlikely).</para> +<para>No detection or correction. Only useful if you have a perfect <acronym>CD</acronym> drive (unlikely).</para> </listitem> </varlistentry> <varlistentry> -<term ->Level 1</term> +<term>Level 1</term> <listitem> -<para ->Enable basic error checking and correction.</para> +<para>Enable basic error checking and correction.</para> </listitem> </varlistentry> <varlistentry> -<term ->Level 2</term> +<term>Level 2</term> <listitem> -<para ->Default. Specifies that only a perfect extraction will be accepted.</para> +<para>Default. Specifies that only a perfect extraction will be accepted.</para> </listitem> </varlistentry> </variablelist> -<para ->Note that there is a disadvantage to level 2. Extraction can be very slow, so real-time digital playback may not work properly. If you have a good quality <acronym ->CD</acronym -> drive (note that more expensive does not necessarily mean better quality) then you probably won't experience very slow extraction, but a poor drive may take days (!) to extract the audio from one <acronym ->CD</acronym ->.</para> +<para>Note that there is a disadvantage to level 2. Extraction can be very slow, so real-time digital playback may not work properly. If you have a good quality <acronym>CD</acronym> drive (note that more expensive does not necessarily mean better quality) then you probably won't experience very slow extraction, but a poor drive may take days (!) to extract the audio from one <acronym>CD</acronym>.</para> </listitem> </varlistentry> <varlistentry> -<term -><option ->use_cddb</option -></term> +<term><option>use_cddb</option></term> <listitem> -<para ->Specify that track names for the inserted <acronym ->CD</acronym -> will be looked up on the Internet <acronym ->CD</acronym -> Database. Audio <acronym ->CD</acronym ->s don't have track names, but the Internet <acronym ->CD</acronym -> Database is a clever system which uses a special unique identifier generated from the number and length of tracks on each <acronym ->CD</acronym -> to cross-reference a track listing. Track listings are contributed by the Internet community and made available to all.</para> +<para>Specify that track names for the inserted <acronym>CD</acronym> will be looked up on the Internet <acronym>CD</acronym> Database. Audio <acronym>CD</acronym>s don't have track names, but the Internet <acronym>CD</acronym> Database is a clever system which uses a special unique identifier generated from the number and length of tracks on each <acronym>CD</acronym> to cross-reference a track listing. Track listings are contributed by the Internet community and made available to all.</para> -<para ->You can submit your own track listings using &kscd;, the &kde; <acronym ->CD</acronym -> player.</para> +<para>You can submit your own track listings using &kscd;, the &kde; <acronym>CD</acronym> player.</para> -<para ->This option is on by default. If your Internet connection is not set up correctly, you may find that your <acronym ->CD</acronym -> tracks don't appear. In this case, you can try <userinput ->audiocd:/?<option ->use_cddb</option ->=<parameter ->0</parameter -></userinput -> to switch this option off.</para> +<para>This option is on by default. If your Internet connection is not set up correctly, you may find that your <acronym>CD</acronym> tracks don't appear. In this case, you can try <userinput>audiocd:/?<option>use_cddb</option>=<parameter>0</parameter></userinput> to switch this option off.</para> </listitem> </varlistentry> <varlistentry> -<term -><option ->cddb_server</option -></term> +<term><option>cddb_server</option></term> <listitem> -<para ->Set the Internet <acronym ->CD</acronym -> Database server to contact. By default, this is <systemitem ->freedb.freedb.org:888</systemitem ->, which means server <systemitem ->freedb.freedb.org</systemitem -> at port 888.</para> +<para>Set the Internet <acronym>CD</acronym> Database server to contact. By default, this is <systemitem>freedb.freedb.org:888</systemitem>, which means server <systemitem>freedb.freedb.org</systemitem> at port 888.</para> </listitem> </varlistentry> </variablelist> <variablelist> -<title ->Examples</title> +<title>Examples</title> <varlistentry> -<term -><userinput ->audiocd:/?device=/dev/scd0&paranoia_level=0&use_cddb=0</userinput -></term> +<term><userinput>audiocd:/?device=/dev/scd0&paranoia_level=0&use_cddb=0</userinput></term> <listitem> -<para ->Gives a listing of the tracks on the audio <acronym ->CD</acronym -> inserted in <filename class="devicefile" ->/dev/scd0</filename ->, which on &Linux; specifies the first <acronym ->SCSI</acronym -> &CD-ROM; device. If you copy tracks from the <acronym ->CD</acronym ->, digital extraction will be performed without error correction or detection. No Internet <acronym ->CD</acronym -> Database will be contacted.</para> +<para>Gives a listing of the tracks on the audio <acronym>CD</acronym> inserted in <filename class="devicefile">/dev/scd0</filename>, which on &Linux; specifies the first <acronym>SCSI</acronym> &CD-ROM; device. If you copy tracks from the <acronym>CD</acronym>, digital extraction will be performed without error correction or detection. No Internet <acronym>CD</acronym> Database will be contacted.</para> </listitem> </varlistentry> </variablelist> <qandaset> -<title ->Frequently Asked Question</title> +<title>Frequently Asked Question</title> <qandaentry> <question> -<para ->I get <errorname ->The file or folder / does not exist</errorname ->. How do I fix that? I have an audio <acronym ->CD</acronym -> in my drive!</para> +<para>I get <errorname>The file or folder / does not exist</errorname>. How do I fix that? I have an audio <acronym>CD</acronym> in my drive!</para> </question> <answer> -<para ->Try running <userinput -><command ->cdparanoia</command -> <option ->-vsQ</option -></userinput -> as yourself (not <systemitem class="username" ->root</systemitem ->). Do you see a track list? If not, make sure you have permission to access the <acronym ->CD</acronym -> device. If you're using <acronym ->SCSI</acronym -> emulation (possible if you have an <acronym ->IDE</acronym -> <acronym ->CD</acronym -> writer) then make sure you check that you have read and write permissions on the generic <acronym ->SCSI</acronym -> device, which is probably <filename class="devicefile" ->/dev/sg0</filename ->, <filename class="devicefile" ->/dev/sg1</filename ->, &etc;. If it still doesn't work, try typing <userinput ->audiocd:/?device=/dev/sg0</userinput -> (or similar) to tell tdeio_audiocd which device your &CD-ROM; is.</para -> +<para>Try running <userinput><command>cdparanoia</command> <option>-vsQ</option></userinput> as yourself (not <systemitem class="username">root</systemitem>). Do you see a track list? If not, make sure you have permission to access the <acronym>CD</acronym> device. If you're using <acronym>SCSI</acronym> emulation (possible if you have an <acronym>IDE</acronym> <acronym>CD</acronym> writer) then make sure you check that you have read and write permissions on the generic <acronym>SCSI</acronym> device, which is probably <filename class="devicefile">/dev/sg0</filename>, <filename class="devicefile">/dev/sg1</filename>, &etc;. If it still doesn't work, try typing <userinput>audiocd:/?device=/dev/sg0</userinput> (or similar) to tell tdeio_audiocd which device your &CD-ROM; is.</para> </answer> </qandaentry> </qandaset> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/bzip.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/bzip.docbook index 422781d17ec..f3097629509 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/bzip.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/bzip.docbook @@ -1,46 +1,18 @@ <article lang="&language;" id="bzip"> -<title ->bzip</title> +<title>bzip</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para -><command ->bzip</command -> is a compression program. It is rarely used today, having been replaced with bzip2, which offers much better compression.</para> +<para><command>bzip</command> is a compression program. It is rarely used today, having been replaced with bzip2, which offers much better compression.</para> -<para ->The bzip tdeioslave is not directly usable, and is intended for use as a filter. For example, the tar tdeioslave can filter a file through the bzip tdeioslave, in order to display the contents of a <literal role="extension" ->tar.bz</literal -> file directly in a &konqueror; window.</para> +<para>The bzip tdeioslave is not directly usable, and is intended for use as a filter. For example, the tar tdeioslave can filter a file through the bzip tdeioslave, in order to display the contents of a <literal role="extension">tar.bz</literal> file directly in a &konqueror; window.</para> -<para ->If you click on a file compressed with a <literal role="extension" ->bz</literal -> extension in &konqueror;, this tdeioslave is used to uncompress it and display it as a normal (uncompressed) file.</para> +<para>If you click on a file compressed with a <literal role="extension">bz</literal> extension in &konqueror;, this tdeioslave is used to uncompress it and display it as a normal (uncompressed) file.</para> -<para ->If you are a developer, and would like to use the bzip filter, you can find documentation on using tdeioslaves at <ulink url="http://developer.kde.org" ->http://developer.kde.org</ulink -></para> +<para>If you are a developer, and would like to use the bzip filter, you can find documentation on using tdeioslaves at <ulink url="http://developer.kde.org">http://developer.kde.org</ulink></para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/bzip2.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/bzip2.docbook index 7c510be806c..8349e4cde52 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/bzip2.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/bzip2.docbook @@ -1,49 +1,20 @@ <article lang="&language;" id="bzip2"> -<title ->bzip2</title> +<title>bzip2</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->Bzip2 is a compression program</para> +<para>Bzip2 is a compression program</para> -<para ->The bzip2 tdeioslave is not directly usable, and is intended for use as a filter. For example, the tar tdeioslave can filter a file through the bzip2 tdeioslave, in order to display the contents of a <literal role="extension" ->tar.bz2</literal -> file directly in a &konqueror; window.</para> +<para>The bzip2 tdeioslave is not directly usable, and is intended for use as a filter. For example, the tar tdeioslave can filter a file through the bzip2 tdeioslave, in order to display the contents of a <literal role="extension">tar.bz2</literal> file directly in a &konqueror; window.</para> -<para ->If you click on a file compressed with a <literal role="extension" ->.bz2</literal -> in &konqueror;, this tdeioslave is used to uncompress it and display it as a normal (uncompressed) file.</para> +<para>If you click on a file compressed with a <literal role="extension">.bz2</literal> in &konqueror;, this tdeioslave is used to uncompress it and display it as a normal (uncompressed) file.</para> -<para ->If you are a developer, and would like to use the bzip2 filter, you can find documentation on using tdeioslaves at <ulink url="http://developer.kde.org" ->http://developer.kde.org</ulink -></para> +<para>If you are a developer, and would like to use the bzip2 filter, you can find documentation on using tdeioslaves at <ulink url="http://developer.kde.org">http://developer.kde.org</ulink></para> -<para ->See the manual: <ulink url="man:/bzip2" ->bzip2</ulink ->. </para> +<para>See the manual: <ulink url="man:/bzip2">bzip2</ulink>. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/cgi.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/cgi.docbook index b51eae877e8..4d03bd4a59c 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/cgi.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/cgi.docbook @@ -1,46 +1,14 @@ <article lang="&language;" id="cgi"> -<title ->cgi</title> +<title>cgi</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts;&Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts;&Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->The <acronym ->CGI</acronym -> slave provides a way to execute <acronym ->CGI</acronym -> programs without the need to have a running web server. This can for example be used for local testing of <acronym ->CGI</acronym -> programs or for using search engines that only provide a <acronym ->CGI</acronym -> frontend like the one from <application ->Doxygen</application ->.</para> +<para>The <acronym>CGI</acronym> slave provides a way to execute <acronym>CGI</acronym> programs without the need to have a running web server. This can for example be used for local testing of <acronym>CGI</acronym> programs or for using search engines that only provide a <acronym>CGI</acronym> frontend like the one from <application>Doxygen</application>.</para> -<para ->The slave implements the <command ->cgi:</command -> protocol. It uses the filename from the given &URL; and searches a configurable list of folders. If it finds an executable with the given name it executes it, passes the arguments of the &URL; and sets the environment variables needed by <acronym ->CGI</acronym -> programs.</para> +<para>The slave implements the <command>cgi:</command> protocol. It uses the filename from the given &URL; and searches a configurable list of folders. If it finds an executable with the given name it executes it, passes the arguments of the &URL; and sets the environment variables needed by <acronym>CGI</acronym> programs.</para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/data.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/data.docbook index fe7f3908dda..39c460755f5 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/data.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/data.docbook @@ -1,75 +1,26 @@ <article lang="&language;" id="data"> -<title ->Data URLs</title> +<title>Data URLs</title> <articleinfo> <authorgroup> -<author -><personname -><firstname ->Leo</firstname -><surname ->Savernik</surname -></personname -> <address -><email ->l.savernik@aon.at</email -></address -> </author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author><personname><firstname>Leo</firstname><surname>Savernik</surname></personname> <address><email>l.savernik@aon.at</email></address> </author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-02-06</date> -<!--releaseinfo ->2.20.00</releaseinfo--> +<date>2003-02-06</date> +<!--releaseinfo>2.20.00</releaseinfo--> </articleinfo> -<para ->Data URLs allow small document data to be included in the URL itself. This is useful for very small HTML testcases or other occasions that do not justify a document of their own.</para> +<para>Data URLs allow small document data to be included in the URL itself. This is useful for very small HTML testcases or other occasions that do not justify a document of their own.</para> -<para -><userinput ->data:,foobar</userinput -> (note the comma after the colon) will deliver a text document that contains nothing but <literal ->foobar</literal -> </para> +<para><userinput>data:,foobar</userinput> (note the comma after the colon) will deliver a text document that contains nothing but <literal>foobar</literal> </para> -<para ->The last example delivered a text document. For HTML documents one has to specify the MIME type <literal ->text/html</literal ->: <userinput ->data:text/html,<title>Testcase</title><p>This is a testcase</p></userinput ->. This will produce exactly the same output as if the content had been loaded from a document of its own. </para> +<para>The last example delivered a text document. For HTML documents one has to specify the MIME type <literal>text/html</literal>: <userinput>data:text/html,<title>Testcase</title><p>This is a testcase</p></userinput>. This will produce exactly the same output as if the content had been loaded from a document of its own. </para> -<para ->Specifying alternate character sets is also possible. Note that 8-Bit characters have to be escaped by a percentage sign and their two-digit hexadecimal codes: <userinput ->data:;charset=iso-8859-1,Gr%FC%DFe aus Schl%E4gl</userinput -> results in <literal ->Grüße aus Schlägl</literal -> whereas omitting the charset attribute might lead to something like <literal ->Gr??e aus Schl?gl</literal -> </para> +<para>Specifying alternate character sets is also possible. Note that 8-Bit characters have to be escaped by a percentage sign and their two-digit hexadecimal codes: <userinput>data:;charset=iso-8859-1,Gr%FC%DFe aus Schl%E4gl</userinput> results in <literal>Grüße aus Schlägl</literal> whereas omitting the charset attribute might lead to something like <literal>Gr??e aus Schl?gl</literal> </para> -<para -><ulink url="http://www.ietf.org/rfc/rfc2397.txt" ->IETF RFC2397</ulink -> provides more information.</para> +<para><ulink url="http://www.ietf.org/rfc/rfc2397.txt">IETF RFC2397</ulink> provides more information.</para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/file.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/file.docbook index b4f6c3fcea3..d9e9c33824d 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/file.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/file.docbook @@ -1,37 +1,13 @@ <article lang="&language;" id="file"> -<title ->file</title> +<title>file</title> <articleinfo> <authorgroup> -<author ->&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->The <emphasis ->file</emphasis -> protocol is used by all &kde; applications to display locally available files. </para> -<para ->Entering <userinput -><command ->file:/directoryname</command -></userinput -> in &konqueror; lists the files of this folder. </para> +<para>The <emphasis>file</emphasis> protocol is used by all &kde; applications to display locally available files. </para> +<para>Entering <userinput><command>file:/directoryname</command></userinput> in &konqueror; lists the files of this folder. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/finger.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/finger.docbook index 50d791cf561..179ae3c8826 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/finger.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/finger.docbook @@ -1,61 +1,24 @@ <article lang="&language;" id="finger"> -<title ->finger</title> +<title>finger</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts;&Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts;&Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->Finger is a program to display information about users.</para> - -<para ->If finger is enabled on the remote machine, you may be given information on the user's real name, if they are currently logged in, if they have mail and the text of their <filename ->.plan</filename -> file in their home folder.</para> - -<para ->Finger is normally associated with a user@hostname address, which may or may not be the same as a users email address.</para> - -<para ->Most Internet Service Providers no longer allow finger access, so, you may find that you get no useful answer for most people.</para> - -<para ->Other people use their local <filename ->.plan</filename -> file to hold such information as <acronym ->PGP</acronym -> keys, the fact they are on vacation, and all sorts of information.</para> - -<para ->Use the finger tdeioslave like this: <userinput ->finger://<replaceable ->username</replaceable ->@<replaceable ->hostname</replaceable -></userinput -></para> - -<para ->See the manual: <ulink url="man:/finger" ->finger</ulink ->. </para> +<para>Finger is a program to display information about users.</para> + +<para>If finger is enabled on the remote machine, you may be given information on the user's real name, if they are currently logged in, if they have mail and the text of their <filename>.plan</filename> file in their home folder.</para> + +<para>Finger is normally associated with a user@hostname address, which may or may not be the same as a users email address.</para> + +<para>Most Internet Service Providers no longer allow finger access, so, you may find that you get no useful answer for most people.</para> + +<para>Other people use their local <filename>.plan</filename> file to hold such information as <acronym>PGP</acronym> keys, the fact they are on vacation, and all sorts of information.</para> + +<para>Use the finger tdeioslave like this: <userinput>finger://<replaceable>username</replaceable>@<replaceable>hostname</replaceable></userinput></para> + +<para>See the manual: <ulink url="man:/finger">finger</ulink>. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/fish.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/fish.docbook index 21173bcbe61..d4925e3ccc9 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/fish.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/fish.docbook @@ -1,110 +1,22 @@ <article lang="&language;" id="fish"> -<title ->fish</title> +<title>fish</title> <articleinfo> <authorgroup> -<author ->&Joerg.Walter; &Joerg.Walter.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Joerg.Walter; &Joerg.Walter.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-06-23</date> -<releaseinfo ->1.1.1</releaseinfo> +<date>2002-06-23</date> +<releaseinfo>1.1.1</releaseinfo> </articleinfo> -<para ->Allows you to access another computer's files using a simple <acronym ->SSH</acronym -> shell account and standard &UNIX; utilities on the remote side. This way, no server software is needed and you gain access to that computer's files as if they were local (or on <acronym ->NFS</acronym ->, since it is slower than local access). It uses the same protocol as <application ->MidnightCommander</application ->'s #sh <acronym ->VFS</acronym -> handler.</para> +<para>Allows you to access another computer's files using a simple <acronym>SSH</acronym> shell account and standard &UNIX; utilities on the remote side. This way, no server software is needed and you gain access to that computer's files as if they were local (or on <acronym>NFS</acronym>, since it is slower than local access). It uses the same protocol as <application>MidnightCommander</application>'s #sh <acronym>VFS</acronym> handler.</para> -<para ->Fish should work with any roughly <acronym ->POSIX</acronym -> compatible &UNIX; based remote computer. It uses the shell commands <command ->cat</command ->, <command ->chgrp</command ->, <command ->chmod</command ->, <command ->chown</command ->, <command ->cp</command ->, <command ->dd</command ->, <command ->env</command ->, <command ->expr</command ->, <command ->grep</command ->, <command ->ls</command ->, <command ->mkdir</command ->, <command ->mv</command ->, <command ->rm</command ->, <command ->rmdir</command ->, <command ->sed</command ->, and <command ->wc</command ->. Fish starts <command ->/bin/sh</command -> as its shell and expects it to be a Bourne shell (or compatible, like <command ->bash</command ->). If the <command ->sed</command -> and <command ->file</command -> commands are available, as well as a <filename ->/etc/apache/magic</filename -> file with &MIME; type signatures, these will be used to guess &MIME; types. </para> +<para>Fish should work with any roughly <acronym>POSIX</acronym> compatible &UNIX; based remote computer. It uses the shell commands <command>cat</command>, <command>chgrp</command>, <command>chmod</command>, <command>chown</command>, <command>cp</command>, <command>dd</command>, <command>env</command>, <command>expr</command>, <command>grep</command>, <command>ls</command>, <command>mkdir</command>, <command>mv</command>, <command>rm</command>, <command>rmdir</command>, <command>sed</command>, and <command>wc</command>. Fish starts <command>/bin/sh</command> as its shell and expects it to be a Bourne shell (or compatible, like <command>bash</command>). If the <command>sed</command> and <command>file</command> commands are available, as well as a <filename>/etc/apache/magic</filename> file with &MIME; type signatures, these will be used to guess &MIME; types. </para> -<para ->If <application ->Perl</application -> is available on the remote machine, it will be used instead. Then only <command ->env</command -> and <command ->/bin/sh</command -> are needed. Using <application ->Perl</application -> has the additional benefit of being faster.</para> +<para>If <application>Perl</application> is available on the remote machine, it will be used instead. Then only <command>env</command> and <command>/bin/sh</command> are needed. Using <application>Perl</application> has the additional benefit of being faster.</para> -<para ->Fish may even work on &Windows; machines, if tools like <application ->Cygwin</application -> are installed. All the above utilities must be in the system <envar ->PATH</envar ->, and the initial shell must be able to process the command <command ->echo FISH:;/bin/sh</command -> correctly.</para> +<para>Fish may even work on &Windows; machines, if tools like <application>Cygwin</application> are installed. All the above utilities must be in the system <envar>PATH</envar>, and the initial shell must be able to process the command <command>echo FISH:;/bin/sh</command> correctly.</para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/floppy.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/floppy.docbook index 845131fb7c6..4dd257049e6 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/floppy.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/floppy.docbook @@ -1,83 +1,27 @@ <article lang="&language;" id="floppy"> -<title ->Floppy</title> +<title>Floppy</title> <articleinfo> <authorgroup> -<author ->&Alexander.Neundorf; &Alexander.Neundorf.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Alexander.Neundorf; &Alexander.Neundorf.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->The floppy ioslave gives you easy access to the floppy disk drives installed on your system. </para> +<para>The floppy ioslave gives you easy access to the floppy disk drives installed on your system. </para> -<para ->The drive letter becomes the first subdirectory in the floppy &URL;. Let's say there is a file <filename ->logo.png</filename -> on your floppy disk in drive A, then the &URL; will be <userinput -><command ->floppy:</command -><replaceable ->/a/logo.png</replaceable -></userinput -> </para> +<para>The drive letter becomes the first subdirectory in the floppy &URL;. Let's say there is a file <filename>logo.png</filename> on your floppy disk in drive A, then the &URL; will be <userinput><command>floppy:</command><replaceable>/a/logo.png</replaceable></userinput> </para> -<para ->If you want to access drive B, <userinput -><command ->floppy:/b</command -></userinput -> will do it. <command ->floppy:/</command -> is a shortcut for <command ->floppy:/a</command ->. </para> +<para>If you want to access drive B, <userinput><command>floppy:/b</command></userinput> will do it. <command>floppy:/</command> is a shortcut for <command>floppy:/a</command>. </para> -<note -><para ->Note that <command ->floppy:/logo.png</command -> means you have a disk drive named <filename ->logo.png</filename ->.</para -></note> +<note><para>Note that <command>floppy:/logo.png</command> means you have a disk drive named <filename>logo.png</filename>.</para></note> -<para ->To use it you need to have the mtools package installed, and the floppy ioslave supports everything the various mtools command line utilities support. You don't have to mount your floppy disks, simply enter <userinput ->floppy:/</userinput -> in any &kde; 3.x app and you will be able to read from and write to your floppy drive.</para> +<para>To use it you need to have the mtools package installed, and the floppy ioslave supports everything the various mtools command line utilities support. You don't have to mount your floppy disks, simply enter <userinput>floppy:/</userinput> in any &kde; 3.x app and you will be able to read from and write to your floppy drive.</para> -<para ->It also works with USB sticks, ZIP and JAZ drives. You can use <command ->floppy:/u</command -> for the USB stick and <command ->floppy:/z</command -> for the zip drive, for example. To make this work, you might need to adjust your <filename ->/etc/mtools</filename -> file. See the manpage for documentation. </para> +<para>It also works with USB sticks, ZIP and JAZ drives. You can use <command>floppy:/u</command> for the USB stick and <command>floppy:/z</command> for the zip drive, for example. To make this work, you might need to adjust your <filename>/etc/mtools</filename> file. See the manpage for documentation. </para> -<para ->The ioslave gives read and write access to the floppy drive, but not simultaneously. While you can read and write to the floppy during the same session, reading and writing have to happen one after the other, not at the same time.</para> +<para>The ioslave gives read and write access to the floppy drive, but not simultaneously. While you can read and write to the floppy during the same session, reading and writing have to happen one after the other, not at the same time.</para> -<para ->Author: Alexander Neundorf <email ->neundorf@kde.org</email -></para> +<para>Author: Alexander Neundorf <email>neundorf@kde.org</email></para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/ftp.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/ftp.docbook index b42e7c08e60..28aaf46fbb1 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/ftp.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/ftp.docbook @@ -1,55 +1,23 @@ <article id="ftp"> -<title ->&FTP;</title> +<title>&FTP;</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->&FTP; is the Internet service used to transfer a data file from the disk of one computer to the disk of another, regardless of the operating system type. </para> +<para>&FTP; is the Internet service used to transfer a data file from the disk of one computer to the disk of another, regardless of the operating system type. </para> -<para ->Similar to other Internet applications, &FTP; uses the client-server approach — a user invokes an &FTP; program on the computer, instructs it to contact a remote computer, and then requests the transfer of one or more files. The local &FTP; program becomes a client that uses <acronym ->TCP</acronym -> to contact an &FTP; server program on the remote computer. Each time the user requests a file transfer, the client and the server programs cooperate to send a copy of the data across the Internet. </para> +<para>Similar to other Internet applications, &FTP; uses the client-server approach — a user invokes an &FTP; program on the computer, instructs it to contact a remote computer, and then requests the transfer of one or more files. The local &FTP; program becomes a client that uses <acronym>TCP</acronym> to contact an &FTP; server program on the remote computer. Each time the user requests a file transfer, the client and the server programs cooperate to send a copy of the data across the Internet. </para> -<para ->&FTP; servers which allow <quote ->anonymous &FTP;</quote -> permit any user, not only users with accounts on the host, to browse the <quote ->ftp</quote -> archives and download files. Some &FTP; servers are configured to allow users to upload files. </para> +<para>&FTP; servers which allow <quote>anonymous &FTP;</quote> permit any user, not only users with accounts on the host, to browse the <quote>ftp</quote> archives and download files. Some &FTP; servers are configured to allow users to upload files. </para> -<para ->&FTP; is commonly used to retrieve information and obtain software stored in files at &FTP; archive sites throughout the world. </para> +<para>&FTP; is commonly used to retrieve information and obtain software stored in files at &FTP; archive sites throughout the world. </para> -<para ->Source: Paraphrased from <ulink url="http://tlc.nlm.nih.gov/resources/tutorials/internetdistlrn/ftpdef.htm" -> http://tlc.nlm.nih.gov/resources/tutorials/internetdistlrn/ftpdef.htm</ulink -> </para> +<para>Source: Paraphrased from <ulink url="http://tlc.nlm.nih.gov/resources/tutorials/internetdistlrn/ftpdef.htm"> http://tlc.nlm.nih.gov/resources/tutorials/internetdistlrn/ftpdef.htm</ulink> </para> -<para ->See the manual: <ulink url="man:/ftp" ->ftp</ulink ->.</para> +<para>See the manual: <ulink url="man:/ftp">ftp</ulink>.</para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/gopher.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/gopher.docbook index e65acb27954..f338aa289cb 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/gopher.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/gopher.docbook @@ -1,49 +1,17 @@ <article lang="&language;" id="gopher"> -<title ->gopher</title> +<title>gopher</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para -><command ->gopher</command -> began as a distributed campus information service at the University of Minnesota. Gopher allows the user to access information on Gopher servers running on Internet hosts.</para> +<para><command>gopher</command> began as a distributed campus information service at the University of Minnesota. Gopher allows the user to access information on Gopher servers running on Internet hosts.</para> -<para ->Gopher is an Internet information browsing service that uses a menu-driven interface. Users select information from menus, which may return another menu or display a text file. An item may reside on a Gopher server you originally queried, or it may be on another Gopher server (or another host). Gopher can <quote ->tunnel</quote -> from one Gopher to another without the user knowing that the server and/or host machine have changed. Gopher keeps the exact location of computers hidden from the user, providing the <quote ->illusion</quote -> of a single, large set of interconnected menus. </para> +<para>Gopher is an Internet information browsing service that uses a menu-driven interface. Users select information from menus, which may return another menu or display a text file. An item may reside on a Gopher server you originally queried, or it may be on another Gopher server (or another host). Gopher can <quote>tunnel</quote> from one Gopher to another without the user knowing that the server and/or host machine have changed. Gopher keeps the exact location of computers hidden from the user, providing the <quote>illusion</quote> of a single, large set of interconnected menus. </para> -<para ->Gopher permits the user to record an item's location in a <quote ->bookmark</quote -> thereby allowing users to follow a <quote ->bookmark</quote -> directly to a particular item without searching the menu system. Gopher menus are not standardised, inasmuch as each Gopher server is individually determined. </para> +<para>Gopher permits the user to record an item's location in a <quote>bookmark</quote> thereby allowing users to follow a <quote>bookmark</quote> directly to a particular item without searching the menu system. Gopher menus are not standardised, inasmuch as each Gopher server is individually determined. </para> -<para ->Source: <ulink url="http://tlc.nlm.nih.gov/resources/tutorials/internetdistlrn/gophrdef.htm" -> http://tlc.nlm.nih.gov/resources/tutorials/internetdistlrn/gophrdef.htm</ulink -> </para> +<para>Source: <ulink url="http://tlc.nlm.nih.gov/resources/tutorials/internetdistlrn/gophrdef.htm"> http://tlc.nlm.nih.gov/resources/tutorials/internetdistlrn/gophrdef.htm</ulink> </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/gzip.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/gzip.docbook index 2a53bf30384..3a7f07d42cb 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/gzip.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/gzip.docbook @@ -1,51 +1,20 @@ <article lang="&language;" id="gzip"> -<title ->gzip</title> +<title>gzip</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para -><command ->gzip</command -> is a compression program</para> +<para><command>gzip</command> is a compression program</para> -<para ->The gzip tdeioslave is not directly usable, and is intended for use as a filter. For example, the tar tdeioslave can filter a file through the gzip tdeioslave, in order to display the contents of a <literal role="extension" ->tar.gz</literal -> file directly in a &konqueror; window.</para> +<para>The gzip tdeioslave is not directly usable, and is intended for use as a filter. For example, the tar tdeioslave can filter a file through the gzip tdeioslave, in order to display the contents of a <literal role="extension">tar.gz</literal> file directly in a &konqueror; window.</para> -<para ->If you click on a file compressed with a <literal role="extension" ->gz</literal -> extension in &konqueror;, this tdeioslave is used to uncompress it and display it as a normal (uncompressed) file.</para> +<para>If you click on a file compressed with a <literal role="extension">gz</literal> extension in &konqueror;, this tdeioslave is used to uncompress it and display it as a normal (uncompressed) file.</para> -<para ->If you are a developer, and would like to use the gzip filter, you can find documentation on using tdeioslaves at <ulink url="http://developer.kde.org" ->http://developer.kde.org</ulink -></para> +<para>If you are a developer, and would like to use the gzip filter, you can find documentation on using tdeioslaves at <ulink url="http://developer.kde.org">http://developer.kde.org</ulink></para> -<para ->See the manual: <ulink url="man:/gzip" ->gzip</ulink ->. </para> +<para>See the manual: <ulink url="man:/gzip">gzip</ulink>. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/help.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/help.docbook index 407fe86647d..730d7a29873 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/help.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/help.docbook @@ -1,33 +1,13 @@ <article lang="&language;" id="help"> -<title ->help</title> +<title>help</title> <articleinfo> <authorgroup> -<author ->&Ferdinand.Gassauer;&Ferdinand.Gassauer.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Ferdinand.Gassauer;&Ferdinand.Gassauer.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->The help system of &kde; </para> -<para ->See <ulink url="help:/" ->The &khelpcenter;</ulink ->. </para> +<para>The help system of &kde; </para> +<para>See <ulink url="help:/">The &khelpcenter;</ulink>. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/http.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/http.docbook index c8fd823a278..68f69d93dfa 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/http.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/http.docbook @@ -1,56 +1,18 @@ <article lang="&language;" id="http"> -<title ->http</title> +<title>http</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para -><acronym ->http</acronym -> is the <emphasis ->H</emphasis ->yper<emphasis ->T</emphasis ->ext <emphasis ->T</emphasis ->ransfer <emphasis ->P</emphasis ->rotocol.</para> +<para><acronym>http</acronym> is the <emphasis>H</emphasis>yper<emphasis>T</emphasis>ext <emphasis>T</emphasis>ransfer <emphasis>P</emphasis>rotocol.</para> -<para ->The http tdeioslave is used by all &kde; applications to handle connections to http servers, that is, web servers. The most common usage is to view web pages in the &konqueror; web browser.</para> +<para>The http tdeioslave is used by all &kde; applications to handle connections to http servers, that is, web servers. The most common usage is to view web pages in the &konqueror; web browser.</para> -<para ->You can use the http tdeioslave in &konqueror; by giving it a <acronym ->URL</acronym ->. <userinput ->http://<replaceable ->www.kde.org</replaceable -></userinput ->.</para> +<para>You can use the http tdeioslave in &konqueror; by giving it a <acronym>URL</acronym>. <userinput>http://<replaceable>www.kde.org</replaceable></userinput>.</para> -<para ->See the manual: <ulink url="man:/http" ->http</ulink ->. </para> +<para>See the manual: <ulink url="man:/http">http</ulink>. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/https.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/https.docbook index 41412ed18fb..fe46817c423 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/https.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/https.docbook @@ -1,34 +1,13 @@ <article lang="&language;" id="https"> -<title ->https</title> +<title>https</title> <articleinfo> <authorgroup> -<author ->&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->HTTPS is <ulink url="help:/tdeioslave/http.html" ->HTTP</ulink -> encapsulated in an SSL/TLS stream. </para> -<para ->SSL is the Secure Sockets Layer protocol, a security protocol that provides communications privacy over the Internet. The protocol allows client/server applications to communicate in a way that is designed to prevent eavesdropping, tampering, or message forgery. </para> -<para ->TLS stands for Transport Layer Security </para> +<para>HTTPS is <ulink url="help:/tdeioslave/http.html">HTTP</ulink> encapsulated in an SSL/TLS stream. </para> +<para>SSL is the Secure Sockets Layer protocol, a security protocol that provides communications privacy over the Internet. The protocol allows client/server applications to communicate in a way that is designed to prevent eavesdropping, tampering, or message forgery. </para> +<para>TLS stands for Transport Layer Security </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/imap.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/imap.docbook index 0dc1aef152b..37a0b21281c 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/imap.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/imap.docbook @@ -1,44 +1,20 @@ <article lang="&language;" id="imap"> -<title ->imap</title> +<title>imap</title> <articleinfo> <authorgroup> -<author ->&Michael.Haeckel; &Michael.Haeckel.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Michael.Haeckel; &Michael.Haeckel.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2001-08-07</date> +<date>2001-08-07</date> </articleinfo> -<para ->The IMAP4rev1 protocol (Internet Message Access Protocol) allows access to messages in mail folders on a server. Unlike POP3, which is designed to download the mails and delete them from the server, the purpose of IMAP is to store all mails on the server to be able to access these mails from everywhere. Messages can be stored on the server, retrieved from there or moved between folders.</para> +<para>The IMAP4rev1 protocol (Internet Message Access Protocol) allows access to messages in mail folders on a server. Unlike POP3, which is designed to download the mails and delete them from the server, the purpose of IMAP is to store all mails on the server to be able to access these mails from everywhere. Messages can be stored on the server, retrieved from there or moved between folders.</para> -<para ->This plugin is currently mainly used by KMail, but you can also use it in any other KDE application that uses tdeioslave plugins.</para> +<para>This plugin is currently mainly used by KMail, but you can also use it in any other KDE application that uses tdeioslave plugins.</para> -<para ->For example in &konqueror;, simply type <userinput ->imap://username@your.mail.server/</userinput -> to get your IMAP folders listed. You can then deal with the folders and mails like with folders and files on a local file system. IMAP URLs are defined in <ulink url="http://www.ietf.org/rfc/rfc2192.txt?number=2192" ->RFC 2192</ulink ->. </para> +<para>For example in &konqueror;, simply type <userinput>imap://username@your.mail.server/</userinput> to get your IMAP folders listed. You can then deal with the folders and mails like with folders and files on a local file system. IMAP URLs are defined in <ulink url="http://www.ietf.org/rfc/rfc2192.txt?number=2192">RFC 2192</ulink>. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/imaps.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/imaps.docbook index 8d09e5f8f76..b4a7e2f2a3e 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/imaps.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/imaps.docbook @@ -1,36 +1,16 @@ <article lang="&language;" id="imaps"> -<title ->imaps</title> +<title>imaps</title> <articleinfo> <authorgroup> -<author ->&Michael.Haeckel; &Michael.Haeckel.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Michael.Haeckel; &Michael.Haeckel.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2001-08-07</date> +<date>2001-08-07</date> </articleinfo> -<para ->IMAPS is the <ulink url="help:/tdeioslave/imap.html" ->IMAP</ulink -> protocol encrypted via SSL.</para> +<para>IMAPS is the <ulink url="help:/tdeioslave/imap.html">IMAP</ulink> protocol encrypted via SSL.</para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/index.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/index.docbook index 391ecd32b1e..05cad79b5a6 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/index.docbook @@ -23,8 +23,7 @@ <!ENTITY tdeio-mailto SYSTEM "mailto.docbook"> <!ENTITY tdeio-mac SYSTEM "mac.docbook"> <!ENTITY tdeio-man SYSTEM "man.docbook"> -<!ENTITY tdeio-mrml SYSTEM "mrml.docbook" -> <!-- post release, put this in the right module --> +<!ENTITY tdeio-mrml SYSTEM "mrml.docbook"> <!-- post release, put this in the right module --> <!ENTITY tdeio-news SYSTEM "news.docbook"> <!ENTITY tdeio-nfs SYSTEM "nfs.docbook"> <!ENTITY tdeio-nntp SYSTEM "nntp.docbook"> @@ -41,26 +40,14 @@ <!ENTITY tdeio-thumbnail SYSTEM "thumbnail.docbook"> <!ENTITY tdeio-webdav SYSTEM "webdav.docbook"> <!ENTITY tdeio-webdavs SYSTEM "webdavs.docbook"> -<!ENTITY tdeprint "<application ->TDEPrint</application ->"> -<!ENTITY Ferdinand.Gassauer '<personname -><firstname ->Ferdinand</firstname -><surname ->Gassauer</surname -></personname ->'> -<!ENTITY Ferdinand.Gassauer.mail '<email ->f.gassauer@aon.at</email ->'> +<!ENTITY tdeprint "<application>TDEPrint</application>"> +<!ENTITY Ferdinand.Gassauer '<personname><firstname>Ferdinand</firstname><surname>Gassauer</surname></personname>'> +<!ENTITY Ferdinand.Gassauer.mail '<email>f.gassauer@aon.at</email>'> <!ENTITY % addindex "IGNORE"> -<!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> +<!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <part lang="&language;"> -<title ->IO-Slaves</title> +<title>IO-Slaves</title> &tdeio-bzip; &tdeio-bzip2; &tdeio-cgi; &tdeio-data; &tdeio-file; &tdeio-finger; &tdeio-fish; &tdeio-floppy; &tdeio-ftp; &tdeio-gopher; &tdeio-gzip; &tdeio-help; &tdeio-http; &tdeio-https; &tdeio-imap; &tdeio-imaps; &tdeio-info; &tdeio-lan; &tdeio-ldap; &tdeio-mailto; &tdeio-mac; &tdeio-man; &tdeio-mrml; &tdeio-news; &tdeio-nfs; &tdeio-nntp; &tdeio-pop3; &tdeio-pop3s; &tdeio-print; &tdeio-rlan; &tdeio-rlogin; &tdeio-sftp; &tdeio-smb; &tdeio-smtp; &tdeio-tar; &tdeio-telnet; &tdeio-thumbnail; &tdeio-webdav; &tdeio-webdavs; </part> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/info.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/info.docbook index 641c86b4e47..d6edf6da290 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/info.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/info.docbook @@ -1,58 +1,22 @@ <article lang="&language;" id="info"> -<title ->Info</title> +<title>Info</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->Info is a type of documentation. The documents are in a file format called texinfo, and can be read on the command line with the <command ->info</command -> program.</para> +<para>Info is a type of documentation. The documents are in a file format called texinfo, and can be read on the command line with the <command>info</command> program.</para> -<para ->The Info ioslave allows you to read the info pages installed on your system, from within &konqueror;. You can use it very easily:</para> +<para>The Info ioslave allows you to read the info pages installed on your system, from within &konqueror;. You can use it very easily:</para> -<screen -><userinput -><command ->info:/</command ->gcc</userinput -></screen> +<screen><userinput><command>info:/</command>gcc</userinput></screen> -<para ->This would show you the top level node of the Info documentation for the <command ->gcc</command -> compiler.</para> +<para>This would show you the top level node of the Info documentation for the <command>gcc</command> compiler.</para> -<para ->Info is a <acronym ->GNU</acronym -> replacement for <command ->man</command ->, but is not widely used outside of <acronym ->GNU</acronym -> software.</para> +<para>Info is a <acronym>GNU</acronym> replacement for <command>man</command>, but is not widely used outside of <acronym>GNU</acronym> software.</para> -<para ->You can quite easily browse the info documentation you have installed from within the &khelpcenter; application, or you can use the info ioslave directly from within both &konqueror; and the mini-cli.</para> +<para>You can quite easily browse the info documentation you have installed from within the &khelpcenter; application, or you can use the info ioslave directly from within both &konqueror; and the mini-cli.</para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/lan.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/lan.docbook index bd340b6e345..f0b3b71eb55 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/lan.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/lan.docbook @@ -1,53 +1,16 @@ <article lang="&language;" id="lan"> -<title ->lan</title> +<title>lan</title> <articleinfo> <authorgroup> -<author ->&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->This protocol is intended to provide a kind of <quote ->network neighbourhood</quote -> but only relying on the TCP/IP protocol stack and with the ability to use other protocols than just <acronym ->SMB</acronym ->.</para> +<para>This protocol is intended to provide a kind of <quote>network neighbourhood</quote> but only relying on the TCP/IP protocol stack and with the ability to use other protocols than just <acronym>SMB</acronym>.</para> -<para ->The lan tdeioslave can use &FTP;, &HTTP;, <acronym ->SMB</acronym ->, <acronym ->NFS</acronym ->, and <acronym ->FISH</acronym -></para> +<para>The lan tdeioslave can use &FTP;, &HTTP;, <acronym>SMB</acronym>, <acronym>NFS</acronym>, and <acronym>FISH</acronym></para> -<para ->It must first be configured in &kcontrol;, <menuchoice -><guimenu ->Network</guimenu -><guimenuitem ->LAN-Browsing</guimenuitem -> </menuchoice -> and for more information see <ulink url="help:/lisa" ->the Lan Browsing manual</ulink ->.</para> +<para>It must first be configured in &kcontrol;, <menuchoice><guimenu>Network</guimenu><guimenuitem>LAN-Browsing</guimenuitem> </menuchoice> and for more information see <ulink url="help:/lisa">the Lan Browsing manual</ulink>.</para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/ldap.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/ldap.docbook index 36e1daf1ec3..027ea0b8a50 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/ldap.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/ldap.docbook @@ -1,46 +1,18 @@ <article lang="&language;" id="ldap"> -<title ->ldap</title> +<title>ldap</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para -><acronym ->ldap</acronym -> is the lightweight directory access protocol. It provides access to an X.500 directory, or to a stand-alone <acronym ->LDAP</acronym -> server.</para> +<para><acronym>ldap</acronym> is the lightweight directory access protocol. It provides access to an X.500 directory, or to a stand-alone <acronym>LDAP</acronym> server.</para> -<para ->You can use the ldap tdeioslave as follows:</para> +<para>You can use the ldap tdeioslave as follows:</para> -<para -><userinput ->ldap://host:port/ou=People,o=where,c=de??sub</userinput -> for a subtree-query</para> +<para><userinput>ldap://host:port/ou=People,o=where,c=de??sub</userinput> for a subtree-query</para> -<para ->or <userinput ->ldap://host:port/cn=MM,ou=People,o=where,c=de??base</userinput -> for a complete branch.</para> +<para>or <userinput>ldap://host:port/cn=MM,ou=People,o=where,c=de??base</userinput> for a complete branch.</para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/mac.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/mac.docbook index 5eba03e0941..848b170bba1 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/mac.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/mac.docbook @@ -1,77 +1,23 @@ <article lang="&language;" id="mac"> -<title ->mac</title> +<title>mac</title> <articleinfo> <authorgroup> -<author -><personname -><firstname ->Johnathan</firstname -><surname ->Riddell</surname -></personname -><email ->jr@jriddell.org</email -> </author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author><personname><firstname>Johnathan</firstname><surname>Riddell</surname></personname><email>jr@jriddell.org</email> </author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->The mac ioslave lets you read an HFS+ partition from &konqueror; or any other &kde; file dialogue. It uses <ulink url="http://www.google.com/search?hl=en&q=hfsplus+utils" -> hfsplus tools</ulink ->, so you will need these installed for it to work.</para> +<para>The mac ioslave lets you read an HFS+ partition from &konqueror; or any other &kde; file dialogue. It uses <ulink url="http://www.google.com/search?hl=en&q=hfsplus+utils"> hfsplus tools</ulink>, so you will need these installed for it to work.</para> -<para ->Enter <userinput ->mac:/</userinput -> into &konqueror; and you should see the contents of your &MacOS; partition. If you have not used tdeio-mac before, you will probably get an error message saying you have not specified the right partition. Enter something like <userinput ->mac:/<option ->?dev=/dev/hda2</option -></userinput -> to specify the partition (if you don't know which partition &MacOS; is on, you can probably guess by changing hda2 to hda3 and so on or use the print command from <command ->mac-fdisk</command ->). This partition will be used the next time, so you do not have to specify it each time.</para> +<para>Enter <userinput>mac:/</userinput> into &konqueror; and you should see the contents of your &MacOS; partition. If you have not used tdeio-mac before, you will probably get an error message saying you have not specified the right partition. Enter something like <userinput>mac:/<option>?dev=/dev/hda2</option></userinput> to specify the partition (if you don't know which partition &MacOS; is on, you can probably guess by changing hda2 to hda3 and so on or use the print command from <command>mac-fdisk</command>). This partition will be used the next time, so you do not have to specify it each time.</para> -<para -><application ->Hfsplus tools</application -> let you see the file and copy data from the HFS+ partition, but not to copy data to it or change the filenames.</para> +<para><application>Hfsplus tools</application> let you see the file and copy data from the HFS+ partition, but not to copy data to it or change the filenames.</para> -<para ->HFS+ actually keeps two files for every one you see (called forks), a resource fork and a data fork. The default copy mode when you are copying files across to your native drive is raw data, which means it only copies the data fork. Text files are copied in text mode (same as raw format but changes the line endings to be &UNIX; friendly and gets rid of some extra characters - strongly advised for text files), unless you specify otherwise. You can also copy the files across in Mac Binary II format or specify text or raw format with another query: <userinput ->mac:/<option ->myfile?mode=b</option -></userinput -> or <userinput ->mac:/<option ->myfile?mode=t</option -></userinput ->. See the <command ->hpcopy</command -> man page for more.</para> +<para>HFS+ actually keeps two files for every one you see (called forks), a resource fork and a data fork. The default copy mode when you are copying files across to your native drive is raw data, which means it only copies the data fork. Text files are copied in text mode (same as raw format but changes the line endings to be &UNIX; friendly and gets rid of some extra characters - strongly advised for text files), unless you specify otherwise. You can also copy the files across in Mac Binary II format or specify text or raw format with another query: <userinput>mac:/<option>myfile?mode=b</option></userinput> or <userinput>mac:/<option>myfile?mode=t</option></userinput>. See the <command>hpcopy</command> man page for more.</para> -<para ->Note that you need permissions to read your HFS+ partition. How you get this depends on your distribution. </para> +<para>Note that you need permissions to read your HFS+ partition. How you get this depends on your distribution. </para> -<para ->For some reason some folders in &MacOS; end in a funny tall <quote ->f</quote -> character. This seems to confuse hfstools.</para> +<para>For some reason some folders in &MacOS; end in a funny tall <quote>f</quote> character. This seems to confuse hfstools.</para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/mailto.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/mailto.docbook index 9b5eff6d154..d78fc254b56 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/mailto.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/mailto.docbook @@ -1,36 +1,12 @@ <article lang="&language;" id="mailto"> -<title ->mailto</title> +<title>mailto</title> <articleinfo> <authorgroup> -<author ->&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->The mailto tdeioslave is used when you click on a mailto link in an <acronym ->HTML</acronym -> page. &konqueror; will open the preferred mail client you have configured, with a composer window. Any information supplied in the <acronym ->URL</acronym -> will be filled in for you.</para> +<para>The mailto tdeioslave is used when you click on a mailto link in an <acronym>HTML</acronym> page. &konqueror; will open the preferred mail client you have configured, with a composer window. Any information supplied in the <acronym>URL</acronym> will be filled in for you.</para> -<para ->See the manual: <ulink url="man:/mailto" ->mailto</ulink ->. </para> +<para>See the manual: <ulink url="man:/mailto">mailto</ulink>. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/man.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/man.docbook index 1176e76b2f4..5f4a1db9dc1 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/man.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/man.docbook @@ -1,88 +1,35 @@ <article lang="&language;" id="man"> -<title ->Man</title> +<title>Man</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->Using the man ioslave you are able to read the man pages installed on your system. It is easy to use: </para> +<para>Using the man ioslave you are able to read the man pages installed on your system. It is easy to use: </para> <variablelist> <varlistentry> -<term -><userinput -><command ->man:/</command -></userinput -></term> +<term><userinput><command>man:/</command></userinput></term> <listitem> -<para ->See the sections of the manual, click to find the rest. </para> +<para>See the sections of the manual, click to find the rest. </para> </listitem> </varlistentry> <varlistentry> -<term -><userinput -><command ->man:</command ->fopen</userinput -></term> +<term><userinput><command>man:</command>fopen</userinput></term> <listitem> -<para ->See the man page of <command ->fopen</command ->. </para> +<para>See the man page of <command>fopen</command>. </para> </listitem> </varlistentry> </variablelist> -<para ->There is also a shortcut: <userinput -><command ->#fopen</command -></userinput ->, which has the same effect as above. </para> +<para>There is also a shortcut: <userinput><command>#fopen</command></userinput>, which has the same effect as above. </para> -<para ->If you don't find all your man pages, adjust the environment variables <envar ->MANPATH</envar -> and <envar ->MANSECT</envar ->. </para> +<para>If you don't find all your man pages, adjust the environment variables <envar>MANPATH</envar> and <envar>MANSECT</envar>. </para> -<para ->As with any other &kde; ioslave, it is possible to enter a &URL;, like <userinput -><command ->man:socket</command -></userinput -> in <emphasis ->any</emphasis -> &kde; application. Try it in &kwrite; and you will see the man page in <acronym ->HTML</acronym -> format. </para> +<para>As with any other &kde; ioslave, it is possible to enter a &URL;, like <userinput><command>man:socket</command></userinput> in <emphasis>any</emphasis> &kde; application. Try it in &kwrite; and you will see the man page in <acronym>HTML</acronym> format. </para> -<para ->Contact mailing list: <email ->kde-devel@kde.org</email -> </para> +<para>Contact mailing list: <email>kde-devel@kde.org</email> </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/mrml.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/mrml.docbook index d0cb42f3611..1edaf10a498 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/mrml.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/mrml.docbook @@ -1,50 +1,20 @@ <article lang="&language;" id="mrml"> -<title ->mrml</title> +<title>mrml</title> <articleinfo> <authorgroup> -<author ->&Carsten.Pfeiffer; &Carsten.Pfeiffer.mail; </author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Carsten.Pfeiffer; &Carsten.Pfeiffer.mail; </author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-01-08</date> +<date>2003-01-08</date> </articleinfo> -<para -><acronym ->MRML</acronym -> stands for Multimedia Retrieval Markup Language. <acronym ->MRML</acronym -> is an XML-based protocol to provide standardised access to Multimedia retrieval software. See <ulink url="http://www.mrml.net" ->http://www.mrml.net</ulink -> for more information. </para> +<para><acronym>MRML</acronym> stands for Multimedia Retrieval Markup Language. <acronym>MRML</acronym> is an XML-based protocol to provide standardised access to Multimedia retrieval software. See <ulink url="http://www.mrml.net">http://www.mrml.net</ulink> for more information. </para> -<para ->tdeio_mrml is used for the Image Finding feature in &kde;</para> +<para>tdeio_mrml is used for the Image Finding feature in &kde;</para> -<para ->⪚ type <userinput ->mrml:/</userinput -> or <userinput ->mrml:/some.other.server</userinput -> in &konqueror; to start searching for images. </para> +<para>⪚ type <userinput>mrml:/</userinput> or <userinput>mrml:/some.other.server</userinput> in &konqueror; to start searching for images. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/news.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/news.docbook index 32ce32b5491..382745523f1 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/news.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/news.docbook @@ -1,37 +1,15 @@ <article lang="&language;" id="news"> -<title ->news</title> +<title>news</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->The news tdeioslave is used when you click on a news link on a web page. It will open &knode;, and if the group referred to in the news link is available from your server, it will subscribe you to the group, in the first available account you have configured in &knode;</para> +<para>The news tdeioslave is used when you click on a news link on a web page. It will open &knode;, and if the group referred to in the news link is available from your server, it will subscribe you to the group, in the first available account you have configured in &knode;</para> -<para ->You can unsubscribe from within &knode; if you decide you don't want to read the group, by <mousebutton ->right</mousebutton -> clicking and selecting <guimenuitem ->Unsubscribe from Group</guimenuitem ->.</para> +<para>You can unsubscribe from within &knode; if you decide you don't want to read the group, by <mousebutton>right</mousebutton> clicking and selecting <guimenuitem>Unsubscribe from Group</guimenuitem>.</para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/nfs.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/nfs.docbook index c627b6d2629..46ed738e733 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/nfs.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/nfs.docbook @@ -1,55 +1,18 @@ <article lang="&language;" id="nfs"> -<title ->nfs</title> +<title>nfs</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->Sun's <acronym ->NFS</acronym -> protocol provides transparent remote access to shared file systems across networks. The <acronym ->NFS</acronym -> protocol is designed to be machine, operating system, network architecture, and transport protocol independent. This independence is achieved through the use of Remote Procedure Call (<acronym ->RPC</acronym ->) primitives built on top of an eXternal Data Representation (<acronym ->XDR</acronym ->). </para> +<para>Sun's <acronym>NFS</acronym> protocol provides transparent remote access to shared file systems across networks. The <acronym>NFS</acronym> protocol is designed to be machine, operating system, network architecture, and transport protocol independent. This independence is achieved through the use of Remote Procedure Call (<acronym>RPC</acronym>) primitives built on top of an eXternal Data Representation (<acronym>XDR</acronym>). </para> -<para ->The supporting MOUNT protocol performs the operating system-specific functions that allow clients to attach remote folder trees to a point within the local file system. The mount process also allows the server to grant remote access privileges to a restricted set of clients via export control.</para> +<para>The supporting MOUNT protocol performs the operating system-specific functions that allow clients to attach remote folder trees to a point within the local file system. The mount process also allows the server to grant remote access privileges to a restricted set of clients via export control.</para> -<para ->The Lock Manager provides support for file locking when used in the <acronym ->NFS</acronym -> environment. The Network Lock Manager (<acronym ->NLM</acronym ->) protocol isolates the inherently stateful aspects of file locking into a separate protocol.</para> +<para>The Lock Manager provides support for file locking when used in the <acronym>NFS</acronym> environment. The Network Lock Manager (<acronym>NLM</acronym>) protocol isolates the inherently stateful aspects of file locking into a separate protocol.</para> -<para ->Source: <ulink url="http://www.networksorcery.com/enp/protocol/nfs.htm" -> http://www.networksorcery.com/enp/protocol/nfs.htm</ulink -> </para> +<para>Source: <ulink url="http://www.networksorcery.com/enp/protocol/nfs.htm"> http://www.networksorcery.com/enp/protocol/nfs.htm</ulink> </para> -<para ->See the manual: <ulink url="man:/nfs" ->nfs</ulink ->. </para> +<para>See the manual: <ulink url="man:/nfs">nfs</ulink>. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/nntp.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/nntp.docbook index 6e723e3ba3f..54db48f1c50 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/nntp.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/nntp.docbook @@ -1,65 +1,23 @@ <article lang="&language;" id="nntp"> -<title ->nntp</title> +<title>nntp</title> <articleinfo> <authorgroup> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->The nntp tdeioslave accesses <acronym ->NNTP</acronym -> servers directly.</para> +<para>The nntp tdeioslave accesses <acronym>NNTP</acronym> servers directly.</para> -<para ->This tdeioslave can not be used with servers that do not implement the <command ->GROUP</command -> command, including some versions of the popular <application ->INN</application -> news server which is often used by <acronym ->ISP</acronym ->s. It does work with <application ->leafnode</application ->, which many people use to keep an offline cache of news articles on their own hard drive or within their <acronym ->LAN</acronym ->.</para> +<para>This tdeioslave can not be used with servers that do not implement the <command>GROUP</command> command, including some versions of the popular <application>INN</application> news server which is often used by <acronym>ISP</acronym>s. It does work with <application>leafnode</application>, which many people use to keep an offline cache of news articles on their own hard drive or within their <acronym>LAN</acronym>.</para> -<para ->You can use the nntp tdeioslave by typing <userinput ->nntp://yourserver/groupname</userinput -> into the &konqueror; <acronym ->URL</acronym -> bar.</para> +<para>You can use the nntp tdeioslave by typing <userinput>nntp://yourserver/groupname</userinput> into the &konqueror; <acronym>URL</acronym> bar.</para> -<para ->If you enter a group name, as above, and the group is available, you will see the messages stored for that group as icons in &konqueror;.</para> +<para>If you enter a group name, as above, and the group is available, you will see the messages stored for that group as icons in &konqueror;.</para> -<para ->Clicking on a message will display it as plain text, including all headers. This could be useful for debugging a news client to news server connection, for example, to ensure that your new <application ->leafnode</application -> server is working correctly.</para> +<para>Clicking on a message will display it as plain text, including all headers. This could be useful for debugging a news client to news server connection, for example, to ensure that your new <application>leafnode</application> server is working correctly.</para> -<para ->If you don't enter a group name, and only the server name, you will see a list of available groups. </para> +<para>If you don't enter a group name, and only the server name, you will see a list of available groups. </para> -<para ->Please be aware that this could take an enormous amount of time, and will cause a lot of network traffic. Some commercial usenet servers have 60,000 or more groups available, and doing such a thing may cause your desktop to freeze.</para -> +<para>Please be aware that this could take an enormous amount of time, and will cause a lot of network traffic. Some commercial usenet servers have 60,000 or more groups available, and doing such a thing may cause your desktop to freeze.</para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/pop3.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/pop3.docbook index 677522da456..9c151245ae2 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/pop3.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/pop3.docbook @@ -1,28 +1,11 @@ <article lang="&language;" id="pop3"> -<title ->pop3</title> +<title>pop3</title> <articleinfo> <authorgroup> -<author ->&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->The Post Office Protocol (POP3) allows a user's workstation to access mail from a mailbox server. </para> +<para>The Post Office Protocol (POP3) allows a user's workstation to access mail from a mailbox server. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/pop3s.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/pop3s.docbook index 27a0540bcb0..e6c9cc972ff 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/pop3s.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/pop3s.docbook @@ -1,28 +1,11 @@ <article lang="&language;" id="pop3s"> -<title ->pop3s</title> +<title>pop3s</title> <articleinfo> <authorgroup> -<author ->&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->POP3S is the POP3 protocol encrypted via SSL. </para> +<para>POP3S is the POP3 protocol encrypted via SSL. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/print.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/print.docbook index bf781fedf7f..79b33943792 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/print.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/print.docbook @@ -1,217 +1,95 @@ <article lang="&language;" id="print"> -<title ->print</title> +<title>print</title> <articleinfo> <authorgroup> -<author ->&Kurt.Pfeifle; &Kurt.Pfeifle.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Kurt.Pfeifle; &Kurt.Pfeifle.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-06-23</date> -<releaseinfo ->1.00.00</releaseinfo> +<date>2002-06-23</date> +<releaseinfo>1.00.00</releaseinfo> </articleinfo> -<para ->The <acronym ->print</acronym -> KIOSlave gives quick access to browse different &tdeprint; sections via <quote ->virtual folders</quote ->. These folders provide some information about and quick access to your print subsystem.</para> - -<para -><command ->print:/</command -> represents one more of those useful KIOSlaves implemented by &kde;. To access it, just type <userinput ->print:/ </userinput -> into the address field of &konqueror;. <userinput ->print:/ </userinput -> doesn't purely provide <quote ->read-only</quote -> access to your print subsystem, but it also allows you to change settings of your printers, of your print system and lets you create new printers and classes.</para> - -<para ->You are asked for the Administrator or root password, if you are not allowed a view or an operation as a normal user.</para> - -<para ->You can bookmark frequently used shortcuts like <command ->print:/manager</command -></para> - -<para ->Valid syntax is either <userinput ->print:/[path-to-virtual-folder]</userinput -> or <userinput ->print:[path-to-virtual-folder]</userinput -></para> - -<para ->Note, that some of the views and actions offered do heavily depend on the print subsystem that is installed on your box and presently activated for &kde;. Pages showing printer information display only those parts that are valid for the &kde; selected print subsystem. (So if you normally run <acronym ->CUPS</acronym ->, but switched temporarily to <quote ->Generic UNIX LPD Printing</quote ->, which is possible, you will see less printer info, because LPD is not capable of using the same amount of print settings as are possible in CUPS).</para> - -<para ->Valid syntax to access different virtual folders and a short explanation of what they represent:</para> +<para>The <acronym>print</acronym> KIOSlave gives quick access to browse different &tdeprint; sections via <quote>virtual folders</quote>. These folders provide some information about and quick access to your print subsystem.</para> + +<para><command>print:/</command> represents one more of those useful KIOSlaves implemented by &kde;. To access it, just type <userinput>print:/ </userinput> into the address field of &konqueror;. <userinput>print:/ </userinput> doesn't purely provide <quote>read-only</quote> access to your print subsystem, but it also allows you to change settings of your printers, of your print system and lets you create new printers and classes.</para> + +<para>You are asked for the Administrator or root password, if you are not allowed a view or an operation as a normal user.</para> + +<para>You can bookmark frequently used shortcuts like <command>print:/manager</command></para> + +<para>Valid syntax is either <userinput>print:/[path-to-virtual-folder]</userinput> or <userinput>print:[path-to-virtual-folder]</userinput></para> + +<para>Note, that some of the views and actions offered do heavily depend on the print subsystem that is installed on your box and presently activated for &kde;. Pages showing printer information display only those parts that are valid for the &kde; selected print subsystem. (So if you normally run <acronym>CUPS</acronym>, but switched temporarily to <quote>Generic UNIX LPD Printing</quote>, which is possible, you will see less printer info, because LPD is not capable of using the same amount of print settings as are possible in CUPS).</para> + +<para>Valid syntax to access different virtual folders and a short explanation of what they represent:</para> <variablelist> -<title ->Some examples</title> +<title>Some examples</title> <varlistentry> -<term -><userinput ->print:/ </userinput -> (&ie; the root of print-tdeioslave)</term> +<term><userinput>print:/ </userinput> (&ie; the root of print-tdeioslave)</term> <listitem> -<para ->virtual root for browsing your print subsystem. It displays subfolders <quote ->Classes</quote ->, <quote ->Jobs</quote ->, <quote ->Manager</quote ->, <quote ->Printers</quote ->, and <quote ->Specials</quote -></para> +<para>virtual root for browsing your print subsystem. It displays subfolders <quote>Classes</quote>, <quote>Jobs</quote>, <quote>Manager</quote>, <quote>Printers</quote>, and <quote>Specials</quote></para> </listitem> </varlistentry> <varlistentry> -<term -><userinput ->print:/classes</userinput -> or <userinput ->print:classes </userinput -> </term -> <listitem> -<para ->view your printer classes (supported by and useful for CUPS only) </para> +<term><userinput>print:/classes</userinput> or <userinput>print:classes </userinput> </term> <listitem> +<para>view your printer classes (supported by and useful for CUPS only) </para> </listitem> </varlistentry> <varlistentry> -<term -><userinput ->print:/classes/class_name </userinput -> or <userinput ->print:classes/class_name </userinput -> </term -> <listitem> -<para ->view all members of the named printer class (supported by and useful only for CUPS) </para> +<term><userinput>print:/classes/class_name </userinput> or <userinput>print:classes/class_name </userinput> </term> <listitem> +<para>view all members of the named printer class (supported by and useful only for CUPS) </para> </listitem> </varlistentry> <varlistentry> -<term -><userinput ->print:/jobs </userinput -> or <userinput ->print:jobs </userinput -></term> +<term><userinput>print:/jobs </userinput> or <userinput>print:jobs </userinput></term> <listitem> -<para ->lists the current and pending jobs. </para> +<para>lists the current and pending jobs. </para> </listitem> </varlistentry> <varlistentry> -<term -><userinput ->print:/printers </userinput -> or <userinput ->print:printers </userinput -></term> +<term><userinput>print:/printers </userinput> or <userinput>print:printers </userinput></term> <listitem> -<para ->lists all your printers. Clicking on a printer name shows more info about that printer. </para> +<para>lists all your printers. Clicking on a printer name shows more info about that printer. </para> </listitem> </varlistentry> <varlistentry> -<term -><userinput ->print:/printers/printer_name </userinput -> or <userinput ->print:printers/printer_name </userinput -> </term> +<term><userinput>print:/printers/printer_name </userinput> or <userinput>print:printers/printer_name </userinput> </term> <listitem> -<para ->displays useful info about the named printer </para> +<para>displays useful info about the named printer </para> </listitem> </varlistentry> <varlistentry> -<term -><userinput ->print:/manager </userinput -> or <userinput ->print:manager </userinput -> </term -> <listitem> -<para ->opens a page very similar to the &tdeprint; Manager module inside the &kde; Control Centre. Switch to a different printing system here or do every other administrative task. </para> -<para ->This is the most important of access points to your printing system. </para> +<term><userinput>print:/manager </userinput> or <userinput>print:manager </userinput> </term> <listitem> +<para>opens a page very similar to the &tdeprint; Manager module inside the &kde; Control Centre. Switch to a different printing system here or do every other administrative task. </para> +<para>This is the most important of access points to your printing system. </para> </listitem> </varlistentry> <varlistentry> -<term -><userinput ->print:/specials </userinput -> or <userinput ->print:specials </userinput -> </term -><listitem> -<para ->lists all presently available <quote ->special printers</quote ->: Likely you'll see:</para> +<term><userinput>print:/specials </userinput> or <userinput>print:specials </userinput> </term><listitem> +<para>lists all presently available <quote>special printers</quote>: Likely you'll see:</para> <itemizedlist> <listitem> - <para ->The two that let you save a printfile to disk, in &PostScript; or <acronym ->PDF</acronym -> format.</para> + <para>The two that let you save a printfile to disk, in &PostScript; or <acronym>PDF</acronym> format.</para> </listitem> <listitem> - <para ->One that sends it as a <acronym ->PDF</acronym -> attachment via &kmail;.</para> + <para>One that sends it as a <acronym>PDF</acronym> attachment via &kmail;.</para> </listitem> <listitem> - <para ->And last, send it via fax, if you have one of the supported fax backends active, <application ->Hylafax</application -> or <application ->efax</application ->.</para> + <para>And last, send it via fax, if you have one of the supported fax backends active, <application>Hylafax</application> or <application>efax</application>.</para> </listitem> </itemizedlist> </listitem> @@ -219,32 +97,8 @@ </variablelist> -<tip -><para ->You can also put <command ->print:/manager</command -> or similar as the command in the <quote ->Quick Command</quote -> utility (started via <keycombo action="simul" ->&Alt;<keycap ->F2</keycap -></keycombo ->)</para -></tip> - -<para ->You can learn more about printing and &tdeprint;'s powerful abilities by reading the <ulink url="help:/tdeprint/index.html" ->&tdeprint; Handbook locally</ulink -> or at the <ulink url="http://printing.kde.org/" ->&tdeprint; Website</ulink -> where there are documents online (<acronym ->HTML</acronym -> and <acronym ->PDF</acronym ->),containing <ulink url="http://printing.kde.org/documentation/tutorials/" ->Tutorials</ulink ->, as well as <ulink url="http://printing.kde.org/faq/" ->FAQs</ulink -> and Tips and Tricks related to printing in general.</para> +<tip><para>You can also put <command>print:/manager</command> or similar as the command in the <quote>Quick Command</quote> utility (started via <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>)</para></tip> + +<para>You can learn more about printing and &tdeprint;'s powerful abilities by reading the <ulink url="help:/tdeprint/index.html">&tdeprint; Handbook locally</ulink> or at the <ulink url="http://printing.kde.org/">&tdeprint; Website</ulink> where there are documents online (<acronym>HTML</acronym> and <acronym>PDF</acronym>),containing <ulink url="http://printing.kde.org/documentation/tutorials/">Tutorials</ulink>, as well as <ulink url="http://printing.kde.org/faq/">FAQs</ulink> and Tips and Tricks related to printing in general.</para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/rlan.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/rlan.docbook index 5c486134867..ca2c8100b17 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/rlan.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/rlan.docbook @@ -1,28 +1,11 @@ <article lang="&language;" id="rlan"> -<title ->rlan</title> +<title>rlan</title> <articleinfo> <authorgroup> -<corpauthor ->The &kde; team</corpauthor> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<corpauthor>The &kde; team</corpauthor> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->Not yet documented</para> +<para>Not yet documented</para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/rlogin.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/rlogin.docbook index 71ada32f0c5..5a97809c265 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/rlogin.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/rlogin.docbook @@ -1,62 +1,22 @@ <article lang="&language;" id="rlogin"> -<title ->rlogin</title> +<title>rlogin</title> <articleinfo> <authorgroup> -<author -><personname -><firstname ->Christian</firstname -><surname ->Bunting</surname -></personname -></author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author><personname><firstname>Christian</firstname><surname>Bunting</surname></personname></author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->Using &konqueror; you can start up an <command ->rlogin</command -> session with a server hosting the rlogin service.</para> +<para>Using &konqueror; you can start up an <command>rlogin</command> session with a server hosting the rlogin service.</para> -<para ->To use this tdeioslave feature, in the &konqueror; <acronym ->URL</acronym -> bar, type <userinput ->rlogin:/host_to_connect_to</userinput -></para> +<para>To use this tdeioslave feature, in the &konqueror; <acronym>URL</acronym> bar, type <userinput>rlogin:/host_to_connect_to</userinput></para> -<para ->This will initialise &konsole; with an <command ->rlogin</command -> session, prompting you for your password.</para> +<para>This will initialise &konsole; with an <command>rlogin</command> session, prompting you for your password.</para> -<para ->The <command ->rlogin</command -> tdeioslave uses the username of the account you are currently using in &kde;.</para> +<para>The <command>rlogin</command> tdeioslave uses the username of the account you are currently using in &kde;.</para> -<para ->After you have successfully entered your password, you can begin your remote session.</para> +<para>After you have successfully entered your password, you can begin your remote session.</para> -<para ->See the manual: <ulink url="man:/rlogin" ->rlogin</ulink ->. </para> +<para>See the manual: <ulink url="man:/rlogin">rlogin</ulink>. </para> <!-- By Christian Bunting (need to ask if he wants crediting and email) --> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/sftp.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/sftp.docbook index 6783abb2839..3de4eed416d 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/sftp.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/sftp.docbook @@ -1,41 +1,13 @@ <article lang="&language;" id="sftp"> -<title ->sftp</title> +<title>sftp</title> <articleinfo> <authorgroup> -<author ->&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para -><acronym ->SFTP</acronym -> is a Secure file transfer protocol. <command ->sftp</command -> is an interactive file transfer program, similar to ftp, but it performs all operations over an encrypted <command ->ssh</command -> transport. It may use many of the features of <command ->ssh</command ->, including public key authentication and compression.</para> +<para><acronym>SFTP</acronym> is a Secure file transfer protocol. <command>sftp</command> is an interactive file transfer program, similar to ftp, but it performs all operations over an encrypted <command>ssh</command> transport. It may use many of the features of <command>ssh</command>, including public key authentication and compression.</para> -<para ->See the manual: <ulink url="man:/sftp" ->sftp</ulink ->. </para> +<para>See the manual: <ulink url="man:/sftp">sftp</ulink>. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/smb.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/smb.docbook index 163e83eb98b..20150cbf54b 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/smb.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/smb.docbook @@ -1,108 +1,26 @@ <article lang="&language;" id="smb"> -<title ->SMB</title> +<title>SMB</title> <articleinfo> <authorgroup> -<author ->&Alexander.Neundorf; &Alexander.Neundorf.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Alexander.Neundorf; &Alexander.Neundorf.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->The smb ioslave enables you to browse the shares of a &Windows; (or Samba) network. </para> +<para>The smb ioslave enables you to browse the shares of a &Windows; (or Samba) network. </para> -<para ->To see the workgroups, enter <userinput -><command ->smb:/</command -></userinput ->. </para> -<para -><userinput -><command ->smb:/</command -><replaceable ->a_workgroup</replaceable -></userinput -> will list the hosts in this workgroup. </para> -<para ->To see the shares of a host, enter <userinput -><command ->smb://</command -><replaceable ->the_host</replaceable -></userinput -> or <userinput -><command ->smb:/</command -><replaceable ->a_workgroup</replaceable ->/<replaceable ->the_host</replaceable -></userinput ->. </para> -<para ->To access a share directly enter <userinput -><command ->smb://</command -><replaceable ->the_host/the_share</replaceable -></userinput -> or <userinput -><command ->smb:/</command -><replaceable ->a_workgroup</replaceable ->/<replaceable ->the_host</replaceable ->/<replaceable ->the_share</replaceable -></userinput -> </para> +<para>To see the workgroups, enter <userinput><command>smb:/</command></userinput>. </para> +<para><userinput><command>smb:/</command><replaceable>a_workgroup</replaceable></userinput> will list the hosts in this workgroup. </para> +<para>To see the shares of a host, enter <userinput><command>smb://</command><replaceable>the_host</replaceable></userinput> or <userinput><command>smb:/</command><replaceable>a_workgroup</replaceable>/<replaceable>the_host</replaceable></userinput>. </para> +<para>To access a share directly enter <userinput><command>smb://</command><replaceable>the_host/the_share</replaceable></userinput> or <userinput><command>smb:/</command><replaceable>a_workgroup</replaceable>/<replaceable>the_host</replaceable>/<replaceable>the_share</replaceable></userinput> </para> -<para ->The smb ioslave is a wrapper around the command line tool <command ->smbclient</command ->, which is part of the Samba package. This means you need to have Samba installed to use this ioslave. </para> +<para>The smb ioslave is a wrapper around the command line tool <command>smbclient</command>, which is part of the Samba package. This means you need to have Samba installed to use this ioslave. </para> -<para ->To be able to authenticate to &Windows; <acronym ->NT</acronym -> Domain Controllers, you need at least Samba 2.0. To access the shares of &Windows; 2000 machines, you need at least Samba 2.0.7. To be able to write to Windows shares, you need at least Samba 2.2.4 or the patch from <ulink url="http://lisa-home.sourceforge.net/smbclientpatch.html" ->http://lisa-home.sourceforge.net/smbclientpatch.html</ulink ->. </para> +<para>To be able to authenticate to &Windows; <acronym>NT</acronym> Domain Controllers, you need at least Samba 2.0. To access the shares of &Windows; 2000 machines, you need at least Samba 2.0.7. To be able to write to Windows shares, you need at least Samba 2.2.4 or the patch from <ulink url="http://lisa-home.sourceforge.net/smbclientpatch.html">http://lisa-home.sourceforge.net/smbclientpatch.html</ulink>. </para> -<para ->You can set your default user name and password in the &kcontrol; in <menuchoice -><guisubmenu ->Network</guisubmenu -><guimenuitem ->Windows Shares</guimenuitem -></menuchoice ->. This is especially useful if you are a member of a &Windows; <acronym ->NT</acronym -> domain. There you can also set your workgroup name, but in most cases this is not required. </para> +<para>You can set your default user name and password in the &kcontrol; in <menuchoice><guisubmenu>Network</guisubmenu><guimenuitem>Windows Shares</guimenuitem></menuchoice>. This is especially useful if you are a member of a &Windows; <acronym>NT</acronym> domain. There you can also set your workgroup name, but in most cases this is not required. </para> -<para ->This ioslave is tested and developed using mainly Samba 2.0.7, but other versions of Samba should work too. </para> +<para>This ioslave is tested and developed using mainly Samba 2.0.7, but other versions of Samba should work too. </para> -<para ->Author: Alexander Neundorf <email ->neundorf@kde.org</email -> </para> +<para>Author: Alexander Neundorf <email>neundorf@kde.org</email> </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/smtp.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/smtp.docbook index 7a9796c0014..e9fc2e10812 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/smtp.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/smtp.docbook @@ -1,33 +1,13 @@ <article lang="&language;" id="smtp"> -<title ->smtp</title> +<title>smtp</title> <articleinfo> <authorgroup> -<author ->&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->A protocol to send mail from the client workstation to the mail server. </para> +<para>A protocol to send mail from the client workstation to the mail server. </para> -<para ->See : <ulink url="http://cr.yp.to/smtp.html" ->Simple Mail Transfer Protocol </ulink ->. </para> +<para>See : <ulink url="http://cr.yp.to/smtp.html">Simple Mail Transfer Protocol </ulink>. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/tar.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/tar.docbook index b625adf9f4f..2c1078dffc5 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/tar.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/tar.docbook @@ -1,33 +1,13 @@ <article lang="&language;" id="tar"> -<title ->tar</title> +<title>tar</title> <articleinfo> <authorgroup> -<author ->&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->An archiving program designed to store and extract files from an archive file known as a tarfile. A tarfile may be made on a tape drive, however, it is also common to write a tarfile to a normal file. </para> +<para>An archiving program designed to store and extract files from an archive file known as a tarfile. A tarfile may be made on a tape drive, however, it is also common to write a tarfile to a normal file. </para> -<para ->See the manual: <ulink url="man:/tar" ->tar</ulink ->. </para> +<para>See the manual: <ulink url="man:/tar">tar</ulink>. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/telnet.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/telnet.docbook index 27f5e5d46a9..09cbc6144f4 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/telnet.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/telnet.docbook @@ -1,33 +1,13 @@ <article lang="&language;" id="telnet"> -<title ->telnet</title> +<title>telnet</title> <articleinfo> <authorgroup> -<author ->&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Ferdinand.Gassauer; &Ferdinand.Gassauer.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->The network terminal protocol (TELNET) allows a user to log in on any other computer on the network supporting TELNET. </para> +<para>The network terminal protocol (TELNET) allows a user to log in on any other computer on the network supporting TELNET. </para> -<para ->See the manual: <ulink url="man:/telnet" ->telnet</ulink ->. </para> +<para>See the manual: <ulink url="man:/telnet">telnet</ulink>. </para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/thumbnail.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/thumbnail.docbook index bc9d6f408d5..7e0649c07c5 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/thumbnail.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/thumbnail.docbook @@ -1,49 +1,17 @@ <article lang="&language;" id="thumbnail"> -<title ->thumbnail</title> +<title>thumbnail</title> <articleinfo> <authorgroup> -<author ->&Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </articleinfo> -<para ->The thumbnail tdeioslave is used by &kde; for network transparent and persistent generation of thumbnails.</para> +<para>The thumbnail tdeioslave is used by &kde; for network transparent and persistent generation of thumbnails.</para> -<para ->The thumbnail tdeioslave uses plugins to generate the actual thumbnails. You can enable viewing of these thumbnails from the <menuchoice -><guimenu ->View</guimenu -> <guisubmenu ->Preview</guisubmenu -></menuchoice -> submenu, available in &konqueror; in file manager mode.</para> +<para>The thumbnail tdeioslave uses plugins to generate the actual thumbnails. You can enable viewing of these thumbnails from the <menuchoice><guimenu>View</guimenu> <guisubmenu>Preview</guisubmenu></menuchoice> submenu, available in &konqueror; in file manager mode.</para> -<para ->The thumbnail tdeioslave is not directly useful to a user, but if you are a developer, you can use it within your own applications to create file previews.</para> +<para>The thumbnail tdeioslave is not directly useful to a user, but if you are a developer, you can use it within your own applications to create file previews.</para> -<para ->See the documentation in the sources for more information. You will find these at <filename ->$<envar ->TDEDIR</envar ->/include/tdeio/thumbcreator.h</filename -> or in the source folder <filename class="directory" ->tdebase/tdeioslave/thumbnail</filename -></para> +<para>See the documentation in the sources for more information. You will find these at <filename>$<envar>TDEDIR</envar>/include/tdeio/thumbcreator.h</filename> or in the source folder <filename class="directory">tdebase/tdeioslave/thumbnail</filename></para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/webdav.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/webdav.docbook index 5fc85060f49..ca9544d7dba 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/webdav.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/webdav.docbook @@ -1,85 +1,40 @@ <article lang="&language;" id="webdav"> -<title ->webdav</title> +<title>webdav</title> <articleinfo> <authorgroup> -<author ->&Hamish.Rodda; &Hamish.Rodda.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Hamish.Rodda; &Hamish.Rodda.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-01-21</date> +<date>2002-01-21</date> </articleinfo> -<para -><acronym ->WebDAV</acronym -> is a <emphasis ->D</emphasis ->istributed <emphasis ->A</emphasis ->uthoring and <emphasis ->V</emphasis ->ersioning protocol for the World Wide Web. It allows for easy management of documents and scripts on a <ulink url="help:/tdeioslave/webdav.html" ->http</ulink -> server, and has additional features designed to simplify version management amongst multiple authors.</para> +<para><acronym>WebDAV</acronym> is a <emphasis>D</emphasis>istributed <emphasis>A</emphasis>uthoring and <emphasis>V</emphasis>ersioning protocol for the World Wide Web. It allows for easy management of documents and scripts on a <ulink url="help:/tdeioslave/webdav.html">http</ulink> server, and has additional features designed to simplify version management amongst multiple authors.</para> -<para ->Usage of this protocol is simple. Type the location you want to view, similar to a <acronym ->http</acronym -> URL except for the webdav:// protocol name at the start. An example is <userinput ->webdav://<replaceable ->www.hostname.com/path/</replaceable -></userinput ->. If you specify a folder name, a list of files and folders will be displayed, and you can manipulate these folders and files just as you would with any other filesystem.</para> +<para>Usage of this protocol is simple. Type the location you want to view, similar to a <acronym>http</acronym> URL except for the webdav:// protocol name at the start. An example is <userinput>webdav://<replaceable>www.hostname.com/path/</replaceable></userinput>. If you specify a folder name, a list of files and folders will be displayed, and you can manipulate these folders and files just as you would with any other filesystem.</para> <variablelist> -<title ->WebDAV Features</title> +<title>WebDAV Features</title> <varlistentry> -<term ->Locking</term> +<term>Locking</term> <listitem> -<para ->File locking allows users to lock a file, informing others that they are currently working on this file. This way, editing can be done without fear that the changes may be overwritten by another person who is also editing the same document.</para> +<para>File locking allows users to lock a file, informing others that they are currently working on this file. This way, editing can be done without fear that the changes may be overwritten by another person who is also editing the same document.</para> </listitem> </varlistentry> <varlistentry> -<term ->Source file access</term> +<term>Source file access</term> <listitem> -<para -><acronym ->WebDAV</acronym -> allows access to the script which is called to produce a specific page, so changes can be made to the script itself.</para> +<para><acronym>WebDAV</acronym> allows access to the script which is called to produce a specific page, so changes can be made to the script itself.</para> </listitem> </varlistentry> <varlistentry> -<term ->Per-document property support</term> +<term>Per-document property support</term> <listitem> -<para ->Arbitrary properties may be set to assist identification of a document, such as the author.</para> +<para>Arbitrary properties may be set to assist identification of a document, such as the author.</para> </listitem> </varlistentry> </variablelist> -<para ->To take advantage of these additional capabilities, you will need an application which supports them. No application currently supports them through this tdeioslave.</para> +<para>To take advantage of these additional capabilities, you will need an application which supports them. No application currently supports them through this tdeioslave.</para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeioslave/webdavs.docbook b/tde-i18n-en_GB/docs/tdebase/tdeioslave/webdavs.docbook index 8918fe1986c..659f6d8fdf5 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeioslave/webdavs.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeioslave/webdavs.docbook @@ -1,36 +1,16 @@ <article lang="&language;" id="webdavs"> -<title ->webdavs</title> +<title>webdavs</title> <articleinfo> <authorgroup> -<author ->&Hamish.Rodda; &Hamish.Rodda.mail;</author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Hamish.Rodda; &Hamish.Rodda.mail;</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2002-01-21</date> +<date>2002-01-21</date> </articleinfo> -<para ->WebDAVS is the <ulink url="help:/tdeioslave/webdav.html" ->WebDAV</ulink -> protocol encrypted via SSL.</para> +<para>WebDAVS is the <ulink url="help:/tdeioslave/webdav.html">WebDAV</ulink> protocol encrypted via SSL.</para> </article> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeprint/add-printer-wiz.docbook b/tde-i18n-en_GB/docs/tdebase/tdeprint/add-printer-wiz.docbook index 1ece07bc322..ff7d67d277b 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeprint/add-printer-wiz.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeprint/add-printer-wiz.docbook @@ -1,341 +1,200 @@ <chapter id="add-printer-wizard-2"> -<title ->The <quote ->Add Printer Wizard</quote -> for &CUPS;</title> - -<para ->Clicking on the leftmost icon on the toolbar <inlinemediaobject -><imageobject -> <imagedata fileref="cr32-action-wizard.png" format="PNG"/></imageobject -> </inlinemediaobject -> in the upper part of the window starts the <quote ->Add Printer Wizard</quote ->.</para> - -<para ->This wizard steps you through various screens to install a new printer. At present this Wizard works for &CUPS; and the <acronym ->RLPR</acronym -> environment module. The number of steps depend on the actual print-subsystem which is active and available to you on your box.</para> +<title>The <quote>Add Printer Wizard</quote> for &CUPS;</title> + +<para>Clicking on the leftmost icon on the toolbar <inlinemediaobject><imageobject> <imagedata fileref="cr32-action-wizard.png" format="PNG"/></imageobject> </inlinemediaobject> in the upper part of the window starts the <quote>Add Printer Wizard</quote>.</para> + +<para>This wizard steps you through various screens to install a new printer. At present this Wizard works for &CUPS; and the <acronym>RLPR</acronym> environment module. The number of steps depend on the actual print-subsystem which is active and available to you on your box.</para> <sect1> -<title ->Starting</title> +<title>Starting</title> -<para ->The welcome screen informs you that you can go back any time to change a setting. </para> +<para>The welcome screen informs you that you can go back any time to change a setting. </para> <screenshot> -<screeninfo ->The &tdeprint; wizard introduction screen</screeninfo> +<screeninfo>The &tdeprint; wizard introduction screen</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsaddprinterwizard1.png" format="PNG"/></imageobject> <textobject> -<phrase ->The introduction screen of the printer wizard</phrase -></textobject> +<phrase>The introduction screen of the printer wizard</phrase></textobject> </mediaobject> </screenshot> </sect1> <sect1 id="backend-selection"> -<title ->Backend Selection</title> +<title>Backend Selection</title> -<para ->Choose the <quote ->backend</quote -> protocol that &CUPS; is supposed to use with your new printer. There are:</para> +<para>Choose the <quote>backend</quote> protocol that &CUPS; is supposed to use with your new printer. There are:</para> <itemizedlist> <listitem> -<para ->local printer (serial, parallel, <acronym ->USB</acronym ->)</para> +<para>local printer (serial, parallel, <acronym>USB</acronym>)</para> </listitem> <listitem> -<para ->remote <acronym ->LPD</acronym -> queue</para> +<para>remote <acronym>LPD</acronym> queue</para> </listitem> <listitem> -<para -><acronym ->SMB</acronym -> shared printer (&Windows;)</para> +<para><acronym>SMB</acronym> shared printer (&Windows;)</para> </listitem> <listitem> -<para ->Network Printer (<acronym ->TCP</acronym ->, &HP; JetDirect, AppSocket)</para> +<para>Network Printer (<acronym>TCP</acronym>, &HP; JetDirect, AppSocket)</para> </listitem> <listitem> -<para ->Network printer with &IPP; (&IPP;/<acronym ->HTTP</acronym ->)</para> +<para>Network printer with &IPP; (&IPP;/<acronym>HTTP</acronym>)</para> </listitem> <listitem> -<para ->File printer</para> +<para>File printer</para> </listitem> <listitem> -<para ->serial fax /modem printer</para> +<para>serial fax /modem printer</para> </listitem> <listitem> -<para ->Class of Printers</para> +<para>Class of Printers</para> </listitem> </itemizedlist> -<para ->If some choices are greyed out, they are not available. For example, you may have no FAX backend software or no modem installed to use it.</para> +<para>If some choices are greyed out, they are not available. For example, you may have no FAX backend software or no modem installed to use it.</para> <screenshot> -<screeninfo ->Choosing your Printer system</screeninfo> +<screeninfo>Choosing your Printer system</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsaddprinterwizard2_backendselection.png" format="PNG"/></imageobject> <textobject> -<phrase ->Choosing your Printer System</phrase -></textobject> +<phrase>Choosing your Printer System</phrase></textobject> </mediaobject> </screenshot> </sect1> <sect1 id="direct-network-settings"> -<title ->Direct Network Setting</title> +<title>Direct Network Setting</title> -<para ->The contents of your next screen is dependent on your choice in the previous screen. If you know the details, just type them in to configure your network settings directly.</para> +<para>The contents of your next screen is dependent on your choice in the previous screen. If you know the details, just type them in to configure your network settings directly.</para> -<para ->In other cases the wizard can scan the network for you, to help you decide which setting could be useful. </para> +<para>In other cases the wizard can scan the network for you, to help you decide which setting could be useful. </para> <screenshot> -<screeninfo ->&tdeprint; wizard network scan</screeninfo> +<screeninfo>&tdeprint; wizard network scan</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsaddprinterwizard3_networkscan.png" format="PNG"/></imageobject> <textobject> -<phrase ->In the &tdeprint; wizard, you can enter network details directly, or you can scan the network automatically.</phrase -></textobject> +<phrase>In the &tdeprint; wizard, you can enter network details directly, or you can scan the network automatically.</phrase></textobject> </mediaobject> </screenshot> </sect1> <sect1 id="information-retrieval-by-network-scanning"> -<title ->Information Retrieval by Scanning the Network</title> - -<para ->If you use one of the network connections (remote <acronym ->LPD</acronym ->, <acronym ->SMB</acronym ->, remote &CUPS;, network printer with &IPP;), you have an option for scanning the network. Be careful when applying this; in some environments network scanning is considered to be hostile and harmful!</para> - -<para ->In the case of <acronym ->SMB</acronym ->, &tdeprint; will use the Samba utilities <command ->nmblookup</command -> and <command ->smbclient</command -> (which need to be installed for this to work) to retrieve the information it presents in a tree structure.</para> - -<para ->In the case of &IPP; (Port 631) and <acronym ->TCP</acronym -> Network/AppSocket (Port 9100) &tdeprint; will try to open the port and, if successful, send an <command ->ipp-get-printer-attribute</command -> request to the printer. For newer &HP; printers the latter usually works, because they support both AppSocket and &IPP;.</para> - -<para ->Some printers or manufacturers use other port numbers for direct TCP/IP printing. You may need to look up which one to use. The <guilabel ->Settings</guilabel -> button in the dialogue lets you configure your scan, including <acronym ->IP</acronym -> addresses, ports and timeout to use.</para> - -<para ->Once again: be careful not to be mistaken for an intruder on your network, if you use the scanning technique.</para> +<title>Information Retrieval by Scanning the Network</title> + +<para>If you use one of the network connections (remote <acronym>LPD</acronym>, <acronym>SMB</acronym>, remote &CUPS;, network printer with &IPP;), you have an option for scanning the network. Be careful when applying this; in some environments network scanning is considered to be hostile and harmful!</para> + +<para>In the case of <acronym>SMB</acronym>, &tdeprint; will use the Samba utilities <command>nmblookup</command> and <command>smbclient</command> (which need to be installed for this to work) to retrieve the information it presents in a tree structure.</para> + +<para>In the case of &IPP; (Port 631) and <acronym>TCP</acronym> Network/AppSocket (Port 9100) &tdeprint; will try to open the port and, if successful, send an <command>ipp-get-printer-attribute</command> request to the printer. For newer &HP; printers the latter usually works, because they support both AppSocket and &IPP;.</para> + +<para>Some printers or manufacturers use other port numbers for direct TCP/IP printing. You may need to look up which one to use. The <guilabel>Settings</guilabel> button in the dialogue lets you configure your scan, including <acronym>IP</acronym> addresses, ports and timeout to use.</para> + +<para>Once again: be careful not to be mistaken for an intruder on your network, if you use the scanning technique.</para> <screenshot> -<screeninfo ->&tdeprint; wizard network configuration dialogue</screeninfo> +<screeninfo>&tdeprint; wizard network configuration dialogue</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsaddprinterwizard4_networkscan_config.png" format="PNG"/></imageobject> <textobject> -<phrase ->In the &tdeprint; wizard, you can enter parameters to have the wizard scan parts of your network.</phrase -></textobject> +<phrase>In the &tdeprint; wizard, you can enter parameters to have the wizard scan parts of your network.</phrase></textobject> </mediaobject> </screenshot> </sect1> <sect1 id="printer-model-selection"> -<title ->Printer Model Selection</title> +<title>Printer Model Selection</title> -<para ->The hardest part is probably the <quote ->Printer Model Selection</quote ->. In former years the situation was difficult, because there were hardly any drivers to find. The difficulty now is there are too many; though some of them are very good, many are quite broken. </para> +<para>The hardest part is probably the <quote>Printer Model Selection</quote>. In former years the situation was difficult, because there were hardly any drivers to find. The difficulty now is there are too many; though some of them are very good, many are quite broken. </para> -<para ->If you have a current <quote ->database</quote -> of available drivers on your system, select the manufacturer in the left part of the window first, then the device model in the right part. This split window shows all &PPD;s found by &CUPS; in its standard repository of installable &PPD;s. This repository normally is <filename class="directory" ->/usr/share/cups/model/</filename ->. If you want your driver to be found automatically by &CUPS; and &tdeprint;, place it in there.</para> +<para>If you have a current <quote>database</quote> of available drivers on your system, select the manufacturer in the left part of the window first, then the device model in the right part. This split window shows all &PPD;s found by &CUPS; in its standard repository of installable &PPD;s. This repository normally is <filename class="directory">/usr/share/cups/model/</filename>. If you want your driver to be found automatically by &CUPS; and &tdeprint;, place it in there.</para> <!-- Insert Screenshot here: --> </sect1> <sect1 id="driver-selection"> -<title ->Driver Selection</title> +<title>Driver Selection</title> -<para ->On the next screen you will see a description of the driver selected previously. This description is extracted from the actual &PPD; used.</para> +<para>On the next screen you will see a description of the driver selected previously. This description is extracted from the actual &PPD; used.</para> <warning> -<para ->For a real &PostScript; printer <emphasis ->never</emphasis -> try to install a <quote ->Foomatic</quote -> or <quote ->Gimp-Print</quote -> &PPD;, even if it is offered. You won't be happy with it. Instead find the original &PPD; from the manufacturer, preferably the one written for &Windows; NT and use it. </para> +<para>For a real &PostScript; printer <emphasis>never</emphasis> try to install a <quote>Foomatic</quote> or <quote>Gimp-Print</quote> &PPD;, even if it is offered. You won't be happy with it. Instead find the original &PPD; from the manufacturer, preferably the one written for &Windows; NT and use it. </para> </warning> -<para ->Some &Linux; distributions have supplied for &CUPS; every possible combination of <application ->Ghostscript</application -> filters and <quote ->foomatic</quote -> &PPD; files they could find on the net. Many of these are quite useless; they were generated a year ago, when the people at <ulink url="http://www.linuxprinting.org" ->www.linuxprinting.org</ulink -> began their first experiments with supplying third party &PPD;s for &CUPS;. Although dubbed <quote ->Alpha</quote -> at the time, these started to take on a life of their own and can now be found at various places on the net, doing &CUPS; no favours.</para> +<para>Some &Linux; distributions have supplied for &CUPS; every possible combination of <application>Ghostscript</application> filters and <quote>foomatic</quote> &PPD; files they could find on the net. Many of these are quite useless; they were generated a year ago, when the people at <ulink url="http://www.linuxprinting.org">www.linuxprinting.org</ulink> began their first experiments with supplying third party &PPD;s for &CUPS;. Although dubbed <quote>Alpha</quote> at the time, these started to take on a life of their own and can now be found at various places on the net, doing &CUPS; no favours.</para> -<para ->If you are not sure which ones to use go to:</para> +<para>If you are not sure which ones to use go to:</para> <itemizedlist> <listitem> -<para -><ulink -url="http://www.linuxprinting.org" ->http://www.linuxprinting.org</ulink> +<para><ulink +url="http://www.linuxprinting.org">http://www.linuxprinting.org</ulink> </para> </listitem> <listitem> <para> -<ulink url="http://www.cups.org" ->http://www.cups.org</ulink> +<ulink url="http://www.cups.org">http://www.cups.org</ulink> </para> </listitem> </itemizedlist> -<para ->And ask for help. At a later stage, a document detailing the differences between the different driver and &PPD; models will appear at <ulink url="http://tdeprint.sourceforge.net" ->http://tdeprint.sourceforge.net/</ulink -> Watch out for this!</para> +<para>And ask for help. At a later stage, a document detailing the differences between the different driver and &PPD; models will appear at <ulink url="http://tdeprint.sourceforge.net">http://tdeprint.sourceforge.net/</ulink> Watch out for this!</para> -<para ->Via the <guibutton ->Other...</guibutton -> button you are able to retrieve any &PPD; located somewhere on your available file system.</para> +<para>Via the <guibutton>Other...</guibutton> button you are able to retrieve any &PPD; located somewhere on your available file system.</para> <!-- Insert Screenshot here: --> </sect1> <sect1 id="printer-test-and-finding-settings"> -<title ->Printer Test and Finding the Right Settings</title> +<title>Printer Test and Finding the Right Settings</title> -<para ->Specify your first driver settings now. The most important one is the default paper size. In many cases this is set to <quote ->Letter</quote ->. If you live in an <quote ->A4</quote -> country and don't want your first test page to jam: now is the time to prevent this. </para> +<para>Specify your first driver settings now. The most important one is the default paper size. In many cases this is set to <quote>Letter</quote>. If you live in an <quote>A4</quote> country and don't want your first test page to jam: now is the time to prevent this. </para> -<para ->You are ready to start a test print. Hit the <guibutton ->Test</guibutton -> button.</para> +<para>You are ready to start a test print. Hit the <guibutton>Test</guibutton> button.</para> <!-- Insert Screenshot here: --> </sect1> <sect1 id="banner-selection"> -<title ->Banner Selection</title> +<title>Banner Selection</title> -<para ->The last but one screen lets you select whether you want banners, and which ones you want to use, to mark the beginning and/or end of every printjob on that printer. You can also select and deselect banners before printing in the job options dialogues.</para> +<para>The last but one screen lets you select whether you want banners, and which ones you want to use, to mark the beginning and/or end of every printjob on that printer. You can also select and deselect banners before printing in the job options dialogues.</para> -<para ->If you need to use custom banners, copy them into <filename class="directory" ->/usr/share/cups/banners/</filename -> to make them available for selection. They must be &PostScript; files, however.</para> +<para>If you need to use custom banners, copy them into <filename class="directory">/usr/share/cups/banners/</filename> to make them available for selection. They must be &PostScript; files, however.</para> <!-- Insert Screenshot here: --> </sect1> <sect1 id="baptizing-your-printer"> -<title ->Finally: Baptising Your New Printer</title> - -<para ->The last screen lets you insert a name for your new printer.</para> - -<para ->The name must start with a letter and may contain numbers and underscores with a maximum size of 128 characters. Conform to this if you want to avoid erratic behaviour of your &CUPS; daemon. The printer names in &CUPS; are <emphasis ->not</emphasis -> case sensitive! This is a requirement of &IPP;. So the names <systemitem class="resource" ->DANKA_infotec</systemitem ->, <systemitem class="resource" ->Danka_Infotec</systemitem -> and <systemitem class="resource" ->danka_infotec</systemitem -> all represent the same printer.</para> +<title>Finally: Baptising Your New Printer</title> + +<para>The last screen lets you insert a name for your new printer.</para> + +<para>The name must start with a letter and may contain numbers and underscores with a maximum size of 128 characters. Conform to this if you want to avoid erratic behaviour of your &CUPS; daemon. The printer names in &CUPS; are <emphasis>not</emphasis> case sensitive! This is a requirement of &IPP;. So the names <systemitem class="resource">DANKA_infotec</systemitem>, <systemitem class="resource">Danka_Infotec</systemitem> and <systemitem class="resource">danka_infotec</systemitem> all represent the same printer.</para> <!-- Insert Screenshot here: --> </sect1> <sect1 id="final-confirmation-screen"> -<title ->The Final Confirmation Screen</title> +<title>The Final Confirmation Screen</title> -<para -> +<para> <!-- Insert Screenshot here: --> </para> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeprint/cups-config.docbook b/tde-i18n-en_GB/docs/tdebase/tdeprint/cups-config.docbook index 49e387f3a2f..bc3580e81bd 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeprint/cups-config.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeprint/cups-config.docbook @@ -1,309 +1,184 @@ <chapter id="cups-configuration"> -<title ->Print Server Configuration: CUPS</title> - -<para ->Start the print server configuration (now that you have chosen &CUPS;, this is equivalent to the configuration of the &CUPS; daemon) by clicking on the appropriate button. You can find it by moving the mouse slowly over the buttons and reading the tooltips. It should be the 11th from the left , or third from the right; its icon is a <guiicon ->wrench</guiicon ->.</para> - -<para ->The &CUPS; Server Configuration window pops up. It gives you a structured view of all the settings that apply to the &CUPS; daemon. The configuration file for that daemon is normally located in <filename ->/etc/cups/cupsd.conf</filename ->. This is a plain <acronym ->ASCII</acronym -> file with a syntax similar to the configuration file of the <application ->Apache</application -> web server. It is a good idea to create a backup copy, just in case something goes wrong with the configuration through &tdeprint;/&CUPS; Server Configuration dialogues:</para> - -<screen -><userinput -><command ->cp</command -> <filename ->/etc/cups/cupsd.conf</filename -> <filename ->/etc/cups/cupsd.conf.bak</filename -></userinput -></screen> - -<para ->As this graphical user interface to edit the configuration file is such a new feature, you should have the second chance of resorting to the original file. So back it up, please.</para> +<title>Print Server Configuration: CUPS</title> + +<para>Start the print server configuration (now that you have chosen &CUPS;, this is equivalent to the configuration of the &CUPS; daemon) by clicking on the appropriate button. You can find it by moving the mouse slowly over the buttons and reading the tooltips. It should be the 11th from the left , or third from the right; its icon is a <guiicon>wrench</guiicon>.</para> + +<para>The &CUPS; Server Configuration window pops up. It gives you a structured view of all the settings that apply to the &CUPS; daemon. The configuration file for that daemon is normally located in <filename>/etc/cups/cupsd.conf</filename>. This is a plain <acronym>ASCII</acronym> file with a syntax similar to the configuration file of the <application>Apache</application> web server. It is a good idea to create a backup copy, just in case something goes wrong with the configuration through &tdeprint;/&CUPS; Server Configuration dialogues:</para> + +<screen><userinput><command>cp</command> <filename>/etc/cups/cupsd.conf</filename> <filename>/etc/cups/cupsd.conf.bak</filename></userinput></screen> + +<para>As this graphical user interface to edit the configuration file is such a new feature, you should have the second chance of resorting to the original file. So back it up, please.</para> <sect1 id="quick-help"> -<title ->Quick Help</title> - -<para ->One very nice feature is the <quote ->Quick Help</quote -> available. If you click on the little question mark (<guiicon ->What's this?</guiicon ->) on your window title bar, you'll see the cursor changing its form. Now click on a <command ->cupsd</command -> configuration setting field to find out what it means and what your options are. In most cases you should understand the meaning immediately, otherwise turn to the excellent &CUPS; documentation. (If your &CUPS; Daemon is running, you have it online on your own host at <ulink url="http://localhost:631/documentation.html" ->http://localhost:631/documentation.html</ulink ->.</para> -<para ->If &CUPS; is not running, but installed on your system you could find it in your own host's file system. The exact location depends on your &OS;, but on &Linux; the default is <filename class="directory" ->/usr/share/doc/cups/</filename -> or <filename class="directory" -> /usr/share/doc/cups/documentation.html</filename ->.</para> +<title>Quick Help</title> + +<para>One very nice feature is the <quote>Quick Help</quote> available. If you click on the little question mark (<guiicon>What's this?</guiicon>) on your window title bar, you'll see the cursor changing its form. Now click on a <command>cupsd</command> configuration setting field to find out what it means and what your options are. In most cases you should understand the meaning immediately, otherwise turn to the excellent &CUPS; documentation. (If your &CUPS; Daemon is running, you have it online on your own host at <ulink url="http://localhost:631/documentation.html">http://localhost:631/documentation.html</ulink>.</para> +<para>If &CUPS; is not running, but installed on your system you could find it in your own host's file system. The exact location depends on your &OS;, but on &Linux; the default is <filename class="directory">/usr/share/doc/cups/</filename> or <filename class="directory"> /usr/share/doc/cups/documentation.html</filename>.</para> </sect1> <sect1 id="longer-help"> -<title ->Longer Help</title> +<title>Longer Help</title> -<para ->For the best, most detailed and most recent information you should always refer to the original &CUPS; documentation. &CUPS; is, much like &kde; in a rapid development process. There are constantly new features being added. New features might for times be only configurable by directly editing the configuration files. The &tdeprint; &GUI; might not have caught up with &CUPS; development.</para> +<para>For the best, most detailed and most recent information you should always refer to the original &CUPS; documentation. &CUPS; is, much like &kde; in a rapid development process. There are constantly new features being added. New features might for times be only configurable by directly editing the configuration files. The &tdeprint; &GUI; might not have caught up with &CUPS; development.</para> -<para ->Just in case you want to look at the original configuration files of your &CUPS; system -- they are here:</para> +<para>Just in case you want to look at the original configuration files of your &CUPS; system -- they are here:</para> <note> -<para ->These paths are based on the default installation. Your &OS; may have installed them to a different prefix, for example, <filename class="directory" ->/usr/local/</filename ->, but the hierarchy should still match that shown below.</para> +<para>These paths are based on the default installation. Your &OS; may have installed them to a different prefix, for example, <filename class="directory">/usr/local/</filename>, but the hierarchy should still match that shown below.</para> </note> <variablelist> <varlistentry> -<term -><filename class="directory" ->/etc/cups/</filename -></term> +<term><filename class="directory">/etc/cups/</filename></term> <listitem> -<para ->The folder with the configuration files</para> +<para>The folder with the configuration files</para> </listitem> </varlistentry> <varlistentry> -<term -><filename ->/etc/cups/cupsd.conf</filename -></term> +<term><filename>/etc/cups/cupsd.conf</filename></term> <listitem> -<para ->The configuration file for the &CUPS; daemon</para> +<para>The configuration file for the &CUPS; daemon</para> </listitem> </varlistentry> <varlistentry> -<term -><filename ->/etc/cups/printers.conf</filename -></term> +<term><filename>/etc/cups/printers.conf</filename></term> <listitem> -<para ->The configuration file that contains the information about your locally installed printers.</para> +<para>The configuration file that contains the information about your locally installed printers.</para> </listitem> </varlistentry> <varlistentry> -<term -><filename class="directory" ->/etc/cups/ppd/</filename -></term> +<term><filename class="directory">/etc/cups/ppd/</filename></term> <listitem> -<para ->The folder with &PPD; files of your installed printers.</para> +<para>The folder with &PPD; files of your installed printers.</para> </listitem> </varlistentry> </variablelist> -<para ->The following links only work if your &CUPS; daemon is up and running. To access all the original &CUPS; documentation, go to:</para> +<para>The following links only work if your &CUPS; daemon is up and running. To access all the original &CUPS; documentation, go to:</para> <variablelist> <varlistentry> -<term -><ulink url="http://localhost:631/documentation.html" ->http://localhost:631/documentation.html</ulink -></term> +<term><ulink url="http://localhost:631/documentation.html">http://localhost:631/documentation.html</ulink></term> <listitem> -<para ->A page with all the links to the other documents.</para> +<para>A page with all the links to the other documents.</para> </listitem> </varlistentry> <varlistentry> -<term -><ulink url="http://localhost:631/sam.html" ->http://localhost:631/sam.html</ulink -></term> +<term><ulink url="http://localhost:631/sam.html">http://localhost:631/sam.html</ulink></term> <listitem> -<para ->Direct access to the &CUPS; Software Administrator Manual in <acronym ->HTML</acronym -> format.</para> +<para>Direct access to the &CUPS; Software Administrator Manual in <acronym>HTML</acronym> format.</para> </listitem> </varlistentry> <varlistentry> -<term -><ulink url="http://localhost:631/sam.pdf" ->http://localhost:631/sam.pdf</ulink -></term> +<term><ulink url="http://localhost:631/sam.pdf">http://localhost:631/sam.pdf</ulink></term> <listitem> -<para ->Direct access to the &CUPS; Software Administrator Manual in <acronym ->PDF</acronym -> format.</para> +<para>Direct access to the &CUPS; Software Administrator Manual in <acronym>PDF</acronym> format.</para> </listitem> </varlistentry> <varlistentry> -<term -><ulink url="http://www.cups.org/documentation.html" ->http://www.cups.org/documentation.html</ulink -></term> +<term><ulink url="http://www.cups.org/documentation.html">http://www.cups.org/documentation.html</ulink></term> <listitem> -<para ->The latest on line documentation from the &CUPS; web site.</para> +<para>The latest on line documentation from the &CUPS; web site.</para> </listitem> </varlistentry> </variablelist> -<para ->The following links give you access to the same files (probably icons and graphics will be missing) even if your CUPS daemon is not up and running. You need, however, CUPS installed on your system. (Some distributions might place the files somewhere else -- you're on your own then to find out where...) To access all the original CUPS documentation, go to:</para> +<para>The following links give you access to the same files (probably icons and graphics will be missing) even if your CUPS daemon is not up and running. You need, however, CUPS installed on your system. (Some distributions might place the files somewhere else -- you're on your own then to find out where...) To access all the original CUPS documentation, go to:</para> -<para ->This documentation is available even when the &CUPS; daemon is not installed, although you may find images and icons are missing when you view the <acronym ->HTML</acronym -> files.</para> +<para>This documentation is available even when the &CUPS; daemon is not installed, although you may find images and icons are missing when you view the <acronym>HTML</acronym> files.</para> -<para ->As noted above, the hierarchy below should be intact, but your &OS; may have installed &CUPS; to a different location.</para> +<para>As noted above, the hierarchy below should be intact, but your &OS; may have installed &CUPS; to a different location.</para> <variablelist> <varlistentry> -<term -><filename ->/usr/share/doc/cups/documentation.html</filename -></term> +<term><filename>/usr/share/doc/cups/documentation.html</filename></term> <listitem> -<para ->A page with all the links to the other documents.</para> +<para>A page with all the links to the other documents.</para> </listitem> </varlistentry> <varlistentry> -<term -><filename ->/usr/share/doc/cups/sam.html</filename -></term> +<term><filename>/usr/share/doc/cups/sam.html</filename></term> <listitem> -<para ->Direct access to the &CUPS; Software Administrator Manual in <acronym ->HTML</acronym -> format.</para> +<para>Direct access to the &CUPS; Software Administrator Manual in <acronym>HTML</acronym> format.</para> </listitem> </varlistentry> <varlistentry> -<term -><filename ->/usr/share/doc/cups/sam.pdf</filename -></term> +<term><filename>/usr/share/doc/cups/sam.pdf</filename></term> <listitem> -<para ->Direct access to the &CUPS; Software Administrator Manual in <acronym ->PDF</acronym -> format.</para> +<para>Direct access to the &CUPS; Software Administrator Manual in <acronym>PDF</acronym> format.</para> </listitem> </varlistentry> </variablelist> -<para ->There are a few WebSites and Newsgroups discussing &CUPS; (and &Linux; Printing in General) and giving help to newbies at:</para> +<para>There are a few WebSites and Newsgroups discussing &CUPS; (and &Linux; Printing in General) and giving help to newbies at:</para> <variablelist> <varlistentry> -<term -><ulink url="http://www.cups.org/newsgroups.php" ->http://www.cups.org/newsgroups.php</ulink -></term> +<term><ulink url="http://www.cups.org/newsgroups.php">http://www.cups.org/newsgroups.php</ulink></term> <listitem> -<para ->The &CUPS; website.</para> +<para>The &CUPS; website.</para> </listitem> </varlistentry> <varlistentry> -<term -><ulink url="http://www.linuxprinting.org/newsportal/" ->http://www.linuxprinting.org/newsportal/</ulink -></term> +<term><ulink url="http://www.linuxprinting.org/newsportal/">http://www.linuxprinting.org/newsportal/</ulink></term> <listitem> -<para ->LinuxPrinting.org, the home of the Linuxprinting HOWTO and the &Linux; Printer Database</para> +<para>LinuxPrinting.org, the home of the Linuxprinting HOWTO and the &Linux; Printer Database</para> </listitem> </varlistentry> </variablelist> -<para ->And finally, there will be a WebSite for &tdeprint; and related documentation, at <ulink url="http://tdeprint.sourceforge.net/" -> http://tdeprint.sourceforge.net/</ulink -></para> +<para>And finally, there will be a WebSite for &tdeprint; and related documentation, at <ulink url="http://tdeprint.sourceforge.net/"> http://tdeprint.sourceforge.net/</ulink></para> -<para ->In the next section I will step you through most of the configuration options of &tdeprint; with &CUPS;.</para> +<para>In the next section I will step you through most of the configuration options of &tdeprint; with &CUPS;.</para> </sect1> <sect1 id="explaining-different-gui-elements"> -<title ->Explaining different elements of the &GUI;</title> +<title>Explaining different elements of the &GUI;</title> <sect2> -<title ->Upper Window: View on Printers, both Real and Virtual</title> +<title>Upper Window: View on Printers, both Real and Virtual</title> -<para ->This section is not yet complete</para> +<para>This section is not yet complete</para> <itemizedlist> <listitem> -<para ->Tree view, icon view and list view</para> +<para>Tree view, icon view and list view</para> </listitem> <listitem> -<para ->The icons of the task bar</para> +<para>The icons of the task bar</para> </listitem> <listitem> -<para ->Different fonts for different printers</para> +<para>Different fonts for different printers</para> </listitem> <listitem> -<para ->Different printer icons mean different things</para> +<para>Different printer icons mean different things</para> </listitem> </itemizedlist> </sect2> <sect2> -<title ->Lower Window: Tabbed View of Details</title> +<title>Lower Window: Tabbed View of Details</title> -<para ->This section is not yet complete.</para> +<para>This section is not yet complete.</para> <itemizedlist> <listitem> -<para ->The icons of the task bar</para> +<para>The icons of the task bar</para> </listitem> <listitem> -<para ->The Tabs</para> +<para>The Tabs</para> </listitem> <listitem> -<para ->Changing printer settings</para> +<para>Changing printer settings</para> </listitem> </itemizedlist> @@ -313,498 +188,229 @@ <sect1 id="welcome-to-cups-server-configuration"> -<title ->Welcome to the &CUPS; Server Configuration</title> +<title>Welcome to the &CUPS; Server Configuration</title> -<para ->This is the Welcome Screen for your server configuration dialogues. Clicking onto one of the items of the tree view on left side of the screen opens the appropriate part of the configuration settings.</para> +<para>This is the Welcome Screen for your server configuration dialogues. Clicking onto one of the items of the tree view on left side of the screen opens the appropriate part of the configuration settings.</para> -<para ->Every setting has a default value. The defaults let &CUPS; normally work as a fully functional client. The clients listen on TCP/IP Port 631 for infos broadcast by &CUPS; servers on the <acronym ->LAN</acronym ->. This information let the clients print immediately after receiving them, without installing any driver or configuring any printer on the clients.</para> +<para>Every setting has a default value. The defaults let &CUPS; normally work as a fully functional client. The clients listen on TCP/IP Port 631 for infos broadcast by &CUPS; servers on the <acronym>LAN</acronym>. This information let the clients print immediately after receiving them, without installing any driver or configuring any printer on the clients.</para> -<para ->To configure a &CUPS; server (which is broadcasting its service to the <acronym ->LAN</acronym ->) you need to change settings from the defaults.</para> +<para>To configure a &CUPS; server (which is broadcasting its service to the <acronym>LAN</acronym>) you need to change settings from the defaults.</para> -<para ->The dialogue to configure the &CUPS; server: welcome screen. </para> +<para>The dialogue to configure the &CUPS; server: welcome screen. </para> <screenshot> -<screeninfo ->CUPS server configuration dialogue: welcome screen</screeninfo> +<screeninfo>CUPS server configuration dialogue: welcome screen</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration1_welcome.png" format="PNG"/></imageobject> <textobject> -<phrase ->The dialogue to configure the &CUPS; server: welcome screen</phrase -></textobject> -<caption -><para ->The dialogue to configure the &CUPS; server: welcome screen</para -></caption> +<phrase>The dialogue to configure the &CUPS; server: welcome screen</phrase></textobject> +<caption><para>The dialogue to configure the &CUPS; server: welcome screen</para></caption> </mediaobject> </screenshot> -<para ->To select the default setting of any item just enable the checkbox on the right side of the screen. To set an item to a different value, disable the checkbox and then go on to do the setting you want on the left side of the screen.</para> +<para>To select the default setting of any item just enable the checkbox on the right side of the screen. To set an item to a different value, disable the checkbox and then go on to do the setting you want on the left side of the screen.</para> -<para ->The complete server configuration includes:</para> +<para>The complete server configuration includes:</para> <itemizedlist> <listitem> -<para -><link linkend="server-general-configuration" -><guilabel ->Server</guilabel -> General Configuration</link -></para> +<para><link linkend="server-general-configuration"><guilabel>Server</guilabel> General Configuration</link></para> </listitem> <listitem> -<para -><link linkend="server-logging-configuration" ->Server <guilabel ->Log</guilabel ->ging Configuration</link -></para> +<para><link linkend="server-logging-configuration">Server <guilabel>Log</guilabel>ging Configuration</link></para> </listitem> <listitem> -<para -><link -linkend="server-directories-configuration" ->Server <guilabel ->Folders</guilabel -> and Path Definitions</link -></para> +<para><link +linkend="server-directories-configuration">Server <guilabel>Folders</guilabel> and Path Definitions</link></para> </listitem> <listitem> -<para -><link linkend="server-configuration" ->Server <guilabel ->HTTP</guilabel -> Configuration</link -></para> +<para><link linkend="server-configuration">Server <guilabel>HTTP</guilabel> Configuration</link></para> </listitem> <listitem> -<para -><link linkend="server-encryption-support-configuration" ->Server <guilabel ->Encryption</guilabel -> and Certificate Support Configuration</link -></para> +<para><link linkend="server-encryption-support-configuration">Server <guilabel>Encryption</guilabel> and Certificate Support Configuration</link></para> </listitem> <listitem> -<para -><link linkend="server-miscellaneous-configuration" ->Server <guilabel ->Misc</guilabel ->ellaneous Configuration</link -></para> +<para><link linkend="server-miscellaneous-configuration">Server <guilabel>Misc</guilabel>ellaneous Configuration</link></para> </listitem> <listitem> -<para -><guilabel ->Network</guilabel -> General Configuration</para> +<para><guilabel>Network</guilabel> General Configuration</para> </listitem> <listitem> -<para -><link linkend="network-clients-configuration" ->Network <guilabel ->Clients</guilabel -> Configuration</link -></para> +<para><link linkend="network-clients-configuration">Network <guilabel>Clients</guilabel> Configuration</link></para> </listitem> <listitem> -<para -><link -linkend="browsing-general-configuration" -><guilabel ->Browsing</guilabel -> General Configuration</link -></para> +<para><link +linkend="browsing-general-configuration"><guilabel>Browsing</guilabel> General Configuration</link></para> </listitem> <listitem> -<para -><link linkend="browsing-connection-configuration" ->Browsing <guilabel ->Connection</guilabel -> Configuration</link -></para> +<para><link linkend="browsing-connection-configuration">Browsing <guilabel>Connection</guilabel> Configuration</link></para> </listitem> <listitem> -<para -><link -linkend="browsing-masks-configuration" ->Browsing <guilabel ->Masks</guilabel -> Configuration</link -></para> +<para><link +linkend="browsing-masks-configuration">Browsing <guilabel>Masks</guilabel> Configuration</link></para> </listitem> <listitem> -<para -><link linkend="browsing-timeouts-configuration" ->Browsing <guilabel ->Timeouts</guilabel -> Configuration</link -></para> +<para><link linkend="browsing-timeouts-configuration">Browsing <guilabel>Timeouts</guilabel> Configuration</link></para> </listitem> <listitem> -<para -><link linkend="browsing-relay-configuration" ->Browsing <guilabel ->Relay</guilabel -> Configuration</link -></para> +<para><link linkend="browsing-relay-configuration">Browsing <guilabel>Relay</guilabel> Configuration</link></para> </listitem> <listitem> -<para -><link -linkend="security-configuration" -><guilabel ->Security</guilabel -> Configuration</link -></para> +<para><link +linkend="security-configuration"><guilabel>Security</guilabel> Configuration</link></para> </listitem> </itemizedlist> -<para ->Each of these configuration items will be described in the following sections of the manual.</para> +<para>Each of these configuration items will be described in the following sections of the manual.</para> </sect1> <sect1 id="server-general-configuration"> -<title ->Server General Configuration</title> +<title>Server General Configuration</title> -<para ->The server general configuration is done on this screen. It includes:</para> +<para>The server general configuration is done on this screen. It includes:</para> <itemizedlist> -<listitem -><para -><guilabel ->Server name</guilabel -></para -></listitem> -<listitem -><para -><guilabel ->Administrator's email</guilabel -></para -></listitem> -<listitem -><para -><guilabel ->Server user</guilabel -></para -></listitem> -<listitem -><para -><guilabel ->Server group</guilabel -></para -></listitem> -<listitem -><para -><guilabel ->Remote user name</guilabel -></para -></listitem> +<listitem><para><guilabel>Server name</guilabel></para></listitem> +<listitem><para><guilabel>Administrator's email</guilabel></para></listitem> +<listitem><para><guilabel>Server user</guilabel></para></listitem> +<listitem><para><guilabel>Server group</guilabel></para></listitem> +<listitem><para><guilabel>Remote user name</guilabel></para></listitem> </itemizedlist> -<para ->The tab window to configure the &CUPS; server general settings lets you the change the default values. Click on the little question mark and then on one of the fields to get a <quote ->Quick Help</quote -> about the meaning of the setting.</para> - -<para ->If you are unsure, leave alone and turn to the original &CUPS; documentation first. If your &CUPS; daemon is already running, it is readable from the &konqueror; by pointing it to &URL; <ulink url="http://localhost:631/documentation.html" -> http://localhost:631/documentation.html</ulink ->.</para> - -<para ->There, first <quote ->make friends</quote -> with the Software Administrator Manual. Otherwise, for example, if the &CUPS; daemon is not running, try looking in your local file system, by default at <filename class="directory" ->/usr/share/doc/cups/</filename -> or <filename ->/usr/share/doc/cups/documentation.html</filename ->.</para> +<para>The tab window to configure the &CUPS; server general settings lets you the change the default values. Click on the little question mark and then on one of the fields to get a <quote>Quick Help</quote> about the meaning of the setting.</para> + +<para>If you are unsure, leave alone and turn to the original &CUPS; documentation first. If your &CUPS; daemon is already running, it is readable from the &konqueror; by pointing it to &URL; <ulink url="http://localhost:631/documentation.html"> http://localhost:631/documentation.html</ulink>.</para> + +<para>There, first <quote>make friends</quote> with the Software Administrator Manual. Otherwise, for example, if the &CUPS; daemon is not running, try looking in your local file system, by default at <filename class="directory">/usr/share/doc/cups/</filename> or <filename>/usr/share/doc/cups/documentation.html</filename>.</para> <screenshot> -<screeninfo ->&CUPS; server general configuration dialogue: ServerName, AdminMail, ServerUser, ServerGroup, RemoteUserName</screeninfo> +<screeninfo>&CUPS; server general configuration dialogue: ServerName, AdminMail, ServerUser, ServerGroup, RemoteUserName</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration2_general.png" format="PNG"/></imageobject> <textobject> -<phrase ->The dialogue to configure the &CUPS; server general settings: ServerName, AdminMail, ServerUser, ServerGroup, RemoteUserName </phrase -></textobject> +<phrase>The dialogue to configure the &CUPS; server general settings: ServerName, AdminMail, ServerUser, ServerGroup, RemoteUserName </phrase></textobject> </mediaobject> </screenshot> <variablelist> <varlistentry> -<term -><guilabel ->Server Name</guilabel -></term> +<term><guilabel>Server Name</guilabel></term> <listitem> -<para ->The hostname of your server, as advertised to the world. By default, &CUPS; will use the hostname of the system. To set the default server usd by clients, see the <filename ->client.conf</filename -> file.</para> +<para>The hostname of your server, as advertised to the world. By default, &CUPS; will use the hostname of the system. To set the default server usd by clients, see the <filename>client.conf</filename> file.</para> <informalexample> -<para ->For example, enter <userinput ->myhost.domain.com</userinput -></para> +<para>For example, enter <userinput>myhost.domain.com</userinput></para> </informalexample> -<para ->This is the hostname that is reported to clients. Should you ever encounter strange problems in accessing the server, put here its <acronym ->IP</acronym -> address for troubleshooting. This way you eliminate any potential name resolution problems; and you can more easily nail the real problem down.</para> +<para>This is the hostname that is reported to clients. Should you ever encounter strange problems in accessing the server, put here its <acronym>IP</acronym> address for troubleshooting. This way you eliminate any potential name resolution problems; and you can more easily nail the real problem down.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Administrator's email</guilabel -></term> +<term><guilabel>Administrator's email</guilabel></term> <listitem> -<para ->This is the email address to send all complaints or problems to. By default &CUPS; will use <quote ->root@hostname</quote ->.</para> +<para>This is the email address to send all complaints or problems to. By default &CUPS; will use <quote>root@hostname</quote>.</para> <informalexample> -<para ->For example, enter <userinput ->root@myhost.com</userinput ->.</para> +<para>For example, enter <userinput>root@myhost.com</userinput>.</para> </informalexample> <note> -<para ->Contrary to what the quickhelp suggests, it is also legal to send an email full of praise and enthusiasm about &CUPS; and &tdeprint; to the server administrator.</para> +<para>Contrary to what the quickhelp suggests, it is also legal to send an email full of praise and enthusiasm about &CUPS; and &tdeprint; to the server administrator.</para> </note> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Server User</guilabel -></term> +<term><guilabel>Server User</guilabel></term> <listitem> -<para ->The user the server runs under. Normally this must be <systemitem class="username" ->lp</systemitem ->, however you can configure things for another user if needed.</para> +<para>The user the server runs under. Normally this must be <systemitem class="username">lp</systemitem>, however you can configure things for another user if needed.</para> <note> -<para ->The server must be initially run as root to support the default <acronym ->IPP</acronym -> port of 631. It changes users whenever an external program is run.</para> +<para>The server must be initially run as root to support the default <acronym>IPP</acronym> port of 631. It changes users whenever an external program is run.</para> </note> <informalexample> -<para ->Enter for example <userinput ->lp</userinput ->.</para> +<para>Enter for example <userinput>lp</userinput>.</para> </informalexample> -<para ->This is the &UNIX; user account for filters and <acronym ->CGI</acronym -> programs to run under. <acronym ->CGI</acronym -> programs are responsible for showing you the nice web administration interface accessible via <ulink url="http://localhost:631/" ->http://localhost:631/</ulink ->).</para> +<para>This is the &UNIX; user account for filters and <acronym>CGI</acronym> programs to run under. <acronym>CGI</acronym> programs are responsible for showing you the nice web administration interface accessible via <ulink url="http://localhost:631/">http://localhost:631/</ulink>).</para> <warning> -<para ->There is no need to set the <guilabel ->User</guilabel -> directive to <systemitem class="username" ->root</systemitem ->, so never do this, as it only involves dangers. Should anyone discover security vulnerabilities in one of the used file filters, printer drivers or <acronym ->CGI</acronym -> programs, he could remotely execute arbitrary commands on your system with root user privileges. Always use an unprivileged account for the server directive <guilabel ->User</guilabel ->.</para> +<para>There is no need to set the <guilabel>User</guilabel> directive to <systemitem class="username">root</systemitem>, so never do this, as it only involves dangers. Should anyone discover security vulnerabilities in one of the used file filters, printer drivers or <acronym>CGI</acronym> programs, he could remotely execute arbitrary commands on your system with root user privileges. Always use an unprivileged account for the server directive <guilabel>User</guilabel>.</para> </warning> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Server group</guilabel -></term> +<term><guilabel>Server group</guilabel></term> <listitem> -<para ->The group the server runs under. Normally this must be <systemitem class="groupname" ->sys</systemitem ->, however you can configure things for another group as needed.</para> +<para>The group the server runs under. Normally this must be <systemitem class="groupname">sys</systemitem>, however you can configure things for another group as needed.</para> <informalexample> -<para ->Enter for example <userinput ->sys</userinput ->.</para> +<para>Enter for example <userinput>sys</userinput>.</para> </informalexample> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Remote user name</guilabel -></term> +<term><guilabel>Remote user name</guilabel></term> <listitem> -<para ->The name of the user assigned to unauthenticated accesses from remote systems. By default <userinput ->remroot</userinput ->.</para> +<para>The name of the user assigned to unauthenticated accesses from remote systems. By default <userinput>remroot</userinput>.</para> -<para ->This name will appear in log files and in queries about the job owner &etc;, for all resources and locations of the &CUPS; server that are configured to allow access <emphasis ->without</emphasis -> authentication. Authenticated entries will carry the authenticated names.</para> +<para>This name will appear in log files and in queries about the job owner &etc;, for all resources and locations of the &CUPS; server that are configured to allow access <emphasis>without</emphasis> authentication. Authenticated entries will carry the authenticated names.</para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="server-logging-configuration"> -<title ->Server Logging Configuration</title> +<title>Server Logging Configuration</title> -<para ->The server logging configuration is done on this screen. It includes:</para> +<para>The server logging configuration is done on this screen. It includes:</para> <itemizedlist> -<listitem -><para -><guilabel ->Access log file</guilabel -> setting</para -></listitem> -<listitem -><para -><guilabel ->Error log file</guilabel -> setting</para -></listitem> -<listitem -><para -><guilabel ->Page log</guilabel -> file setting</para -></listitem> -<listitem -><para -><guilabel ->Log level</guilabel -> setting</para -></listitem> -<listitem -><para -><guilabel ->Max log file size</guilabel -> setting</para -></listitem> +<listitem><para><guilabel>Access log file</guilabel> setting</para></listitem> +<listitem><para><guilabel>Error log file</guilabel> setting</para></listitem> +<listitem><para><guilabel>Page log</guilabel> file setting</para></listitem> +<listitem><para><guilabel>Log level</guilabel> setting</para></listitem> +<listitem><para><guilabel>Max log file size</guilabel> setting</para></listitem> </itemizedlist> -<para ->This is an important screen for you. Should you ever encounter problems: here is the place to set the Log level to <quote ->debug</quote ->, restart the &CUPS; daemon and then look at the Error log file defined here for entries that might give you an insight to the trouble.</para> +<para>This is an important screen for you. Should you ever encounter problems: here is the place to set the Log level to <quote>debug</quote>, restart the &CUPS; daemon and then look at the Error log file defined here for entries that might give you an insight to the trouble.</para> <screenshot> -<screeninfo ->&CUPS; server configuration dialogue: <guilabel ->Server logging</guilabel -> </screeninfo> +<screeninfo>&CUPS; server configuration dialogue: <guilabel>Server logging</guilabel> </screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration3_logging.png" format="PNG"/></imageobject> <textobject> -<phrase ->The dialogue to configure the &CUPS; server: <guilabel ->Server logging</guilabel -></phrase -></textobject> +<phrase>The dialogue to configure the &CUPS; server: <guilabel>Server logging</guilabel></phrase></textobject> </mediaobject> </screenshot> <variablelist> <varlistentry> -<term -><guilabel ->Access log file</guilabel -></term> +<term><guilabel>Access log file</guilabel></term> <listitem> -<para ->This is where accesses to the server are logged. If this does not start with a leading <literal ->/</literal ->, then it is assumed to be relative to the server root.</para> +<para>This is where accesses to the server are logged. If this does not start with a leading <literal>/</literal>, then it is assumed to be relative to the server root.</para> -<para ->You can also use the special name <userinput ->syslog</userinput -> to send the output to the syslog file or daemon.</para> +<para>You can also use the special name <userinput>syslog</userinput> to send the output to the syslog file or daemon.</para> <informalexample> -<para ->Enter a path, for example <userinput -><filename ->/var/log/cups/acces_log</filename -></userinput ->.</para> +<para>Enter a path, for example <userinput><filename>/var/log/cups/acces_log</filename></userinput>.</para> </informalexample> -<para ->The format of this file is stored in the so-called <quote ->Common Log Format</quote ->. This way you can use programs such as <application ->Webalizer</application -> or any other Web access reporting tool to generate reports on the &CUPS; server activities.</para> - -<para ->To include the server name in the file name use a <token ->%s</token -> in the name. Example: <userinput -><filename ->/var/log/cups/access_log-%s</filename -></userinput ->.</para> - -<screen -><prompt ->kurt@transmeta:~ -></prompt -><userinput -><command ->tail</command -> <parameter ->/var/log/cups/access_log</parameter -></userinput> +<para>The format of this file is stored in the so-called <quote>Common Log Format</quote>. This way you can use programs such as <application>Webalizer</application> or any other Web access reporting tool to generate reports on the &CUPS; server activities.</para> + +<para>To include the server name in the file name use a <token>%s</token> in the name. Example: <userinput><filename>/var/log/cups/access_log-%s</filename></userinput>.</para> + +<screen><prompt>kurt@transmeta:~ ></prompt><userinput><command>tail</command> <parameter>/var/log/cups/access_log</parameter></userinput> <computeroutput> 127.0.0.1 - - [04/Aug/2001:20:11:39 +0100] "POST /printers/ HTTP/1.1" 200 109 127.0.0.1 - - [04/Aug/2001:20:11:39 +0100] "POST /admin/ HTTP/1.1" 401 0 @@ -818,127 +424,49 @@ format="PNG"/></imageobject> 127.0.0.1 - - [04/Aug/2001:20:11:40 +0100] "POST / HTTP/1.1" 200 139 10.160.16.45 - - [04/Aug/2001:20:11:39 +0100] "GET /printers/DANKA_P450 HTTP/1.0" 200 7319 10.160.16.45 - - [04/Aug/2001:20:11:40 +0100] "GET /images/title-logo.gif HTTP/1.0" 200 5729 -</computeroutput -></screen> - -<para ->You see a separate line for each single access, showing the <acronym ->IP</acronym -> address of the accessing client, date and time of access, method of access (<command ->POST</command -> or <command ->GET</command ->), the requested ressource, the &HTTP; version used by the client, status code and the number of transferred bytes. Status code <errorcode ->200</errorcode -> means <errorname ->successful-OK</errorname -> the <errorcode ->401</errorcode -> in the above example was an <errorname ->unauthorized access</errorname -> which was denied. For a detailed explanation of the log format go to <ulink url="http://localhost:631/sam.html#7_6_1" ->the &CUPS; Software Administrator Manual</ulink ->.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><guilabel ->Error log file</guilabel -></term> -<listitem> -<para ->If this does not start with a leading <literal ->/</literal ->, then it is assumed to be relative to the server root. The default setting is <filename ->/var/log/cups/error_log</filename ->.</para> - -<para ->You can also use the special name <userinput ->syslog</userinput -> to send the output to the syslog file or daemon.</para> +</computeroutput></screen> + +<para>You see a separate line for each single access, showing the <acronym>IP</acronym> address of the accessing client, date and time of access, method of access (<command>POST</command> or <command>GET</command>), the requested ressource, the &HTTP; version used by the client, status code and the number of transferred bytes. Status code <errorcode>200</errorcode> means <errorname>successful-OK</errorname> the <errorcode>401</errorcode> in the above example was an <errorname>unauthorized access</errorname> which was denied. For a detailed explanation of the log format go to <ulink url="http://localhost:631/sam.html#7_6_1">the &CUPS; Software Administrator Manual</ulink>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Error log file</guilabel></term> +<listitem> +<para>If this does not start with a leading <literal>/</literal>, then it is assumed to be relative to the server root. The default setting is <filename>/var/log/cups/error_log</filename>.</para> + +<para>You can also use the special name <userinput>syslog</userinput> to send the output to the syslog file or daemon.</para> <informalexample> -<para ->Enter the path, for example <userinput -><filename ->/var/log/cups/error_log</filename -></userinput ->.</para> +<para>Enter the path, for example <userinput><filename>/var/log/cups/error_log</filename></userinput>.</para> </informalexample> -<para ->The error log excerpt below shows you the part logged for printing the test page with the default setting of <guilabel ->Log level</guilabel -> to <quote ->info</quote ->. For an explanation of the <guilabel ->Log Level</guilabel -> setting see further below.</para> - -<screen -><prompt ->kurt@transmeta:~ -></prompt -><userinput -><command -> tail </command -> <parameter ->/var/log/cups/error_log</parameter -></userinput> +<para>The error log excerpt below shows you the part logged for printing the test page with the default setting of <guilabel>Log level</guilabel> to <quote>info</quote>. For an explanation of the <guilabel>Log Level</guilabel> setting see further below.</para> + +<screen><prompt>kurt@transmeta:~ ></prompt><userinput><command> tail </command> <parameter>/var/log/cups/error_log</parameter></userinput> <computeroutput> I [04/Aug/2001:23:15:10 +0100] Job 213 queued on 'DANKA_P450' by 'root' I [04/Aug/2001:23:15:10 +0100] Started filter /usr/lib/cups/filter/pstops (PID 18891) for job 213. I [04/Aug/2001:23:15:10 +0100] Started backend /usr/lib/cups/backend/lpd (PID 18892) for job 213. -</computeroutput -></screen> +</computeroutput></screen> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Page log file</guilabel -></term> +<term><guilabel>Page log file</guilabel></term> <listitem> -<para ->If this does not start with a leading <literal ->/</literal -> then it is assumed to be relative to the server root. The default is <filename ->/var/log/cups/page_log</filename -></para> +<para>If this does not start with a leading <literal>/</literal> then it is assumed to be relative to the server root. The default is <filename>/var/log/cups/page_log</filename></para> -<para ->You can also use the special name <userinput ->syslog</userinput -> to send the output to the syslog file or daemon.</para> +<para>You can also use the special name <userinput>syslog</userinput> to send the output to the syslog file or daemon.</para> <informalexample> -<para ->Enter the path, for example <userinput -><filename ->/var/log/cups/page_log</filename -></userinput ->.</para> +<para>Enter the path, for example <userinput><filename>/var/log/cups/page_log</filename></userinput>.</para> </informalexample> -<para ->The page log file has a line for every single page of every job printed.</para> - -<para ->Here is what some entries look like:</para> - -<screen -><prompt ->kurt@transmeta:~ -></prompt -><userinput -><command -> tail </command -> <parameter ->/var/log/cups/page_log</parameter -></userinput> +<para>The page log file has a line for every single page of every job printed.</para> + +<para>Here is what some entries look like:</para> + +<screen><prompt>kurt@transmeta:~ ></prompt><userinput><command> tail </command> <parameter>/var/log/cups/page_log</parameter></userinput> <computeroutput> GIMP_print_stp_HP kdetest 201 [03/Aug/2001:03:18:03 +0100] 4 1 GIMP_print_stp_HP kdetest 201 [03/Aug/2001:03:18:03 +0100] 5 1 @@ -950,168 +478,81 @@ DANKA_infotec_P450 kurt 204 [04/Aug/2001:03:29:00 +0100] 3 33 DANKA_infotec_P450 kurt 204 [04/Aug/2001:03:29:00 +0100] 4 33 DANKA_infotec_P450 root 205 [04/Aug/2001:19:12:34 +0100] 1 14 DANKA_infotec_P450 root 206 [04/Aug/2001:19:15:20 +0100] 1 1 -</computeroutput -></screen> - -<para ->In this excerpt of the file you find information on the name of the printers (<systemitem class="resource" ->GIMP_print_stp_HP</systemitem -> and <systemitem class="resource" ->DANKA_infotec_P450</systemitem ->) used through this server, the user names (<systemitem class="username" ->kdetest</systemitem ->, <systemitem class="username" ->kurt</systemitem -> and <systemitem class="username" ->root</systemitem ->), the job-IDs (<quote ->201</quote -> to <quote ->205</quote ->), time of printing, page number inside the job and the number of copies for the pages. For example, job-ID 204 had 4 pages and 33 copies printed, job-ID 205 had 14 copies of just 1 page) .</para> +</computeroutput></screen> + +<para>In this excerpt of the file you find information on the name of the printers (<systemitem class="resource">GIMP_print_stp_HP</systemitem> and <systemitem class="resource">DANKA_infotec_P450</systemitem>) used through this server, the user names (<systemitem class="username">kdetest</systemitem>, <systemitem class="username">kurt</systemitem> and <systemitem class="username">root</systemitem>), the job-IDs (<quote>201</quote> to <quote>205</quote>), time of printing, page number inside the job and the number of copies for the pages. For example, job-ID 204 had 4 pages and 33 copies printed, job-ID 205 had 14 copies of just 1 page) .</para> <note> -<para ->&CUPS; is dependent (for its calculation of the number of pages in a job) on passing the &PostScript; through the <quote ->pstops</quote -> filter. See the <link linkend="architecture-diagram" ->&kivio; Flowchart</link -> on the &CUPS; filter architecture for an idea about were this filter fits into the whole printing process). More, <command ->pstops</command -> depends for the counting on a <acronym ->DSC</acronym -> conforming (<acronym ->DSC</acronym -> is Document Structuring Conventions, a standard defined by Adobe) to be sent by the client. In most cases this is working.</para> - -<para ->However, this page accounting does not work for any <quote ->raw</quote -> printer queues (as those, by definition, don't use any filtering on the &CUPS; host and are by-passing <command ->pstops</command ->.) Every job going through a <quote ->raw</quote -> queue is counted as a 1-page-job (with possibly multiple copies). This is especially true for all Jobs send from &Microsoft; &Windows; clients via <application ->Samba</application -> to the &CUPS; server, as those jobs are already arriving in the correct format for the printer, because the clients use the original printer driver.</para> +<para>&CUPS; is dependent (for its calculation of the number of pages in a job) on passing the &PostScript; through the <quote>pstops</quote> filter. See the <link linkend="architecture-diagram">&kivio; Flowchart</link> on the &CUPS; filter architecture for an idea about were this filter fits into the whole printing process). More, <command>pstops</command> depends for the counting on a <acronym>DSC</acronym> conforming (<acronym>DSC</acronym> is Document Structuring Conventions, a standard defined by Adobe) to be sent by the client. In most cases this is working.</para> + +<para>However, this page accounting does not work for any <quote>raw</quote> printer queues (as those, by definition, don't use any filtering on the &CUPS; host and are by-passing <command>pstops</command>.) Every job going through a <quote>raw</quote> queue is counted as a 1-page-job (with possibly multiple copies). This is especially true for all Jobs send from &Microsoft; &Windows; clients via <application>Samba</application> to the &CUPS; server, as those jobs are already arriving in the correct format for the printer, because the clients use the original printer driver.</para> </note> <note> -<para ->I am still looking for someone who will write a nice &CUPS; page log analysing tool. It should generate a report with a graphical output similar to the <application ->Webalizer</application ->'s access log reports. This way you could have nice statistics to be used for accounting about usage of printers, load dependent on daytime or weekday, users &etc; Anyone?</para> +<para>I am still looking for someone who will write a nice &CUPS; page log analysing tool. It should generate a report with a graphical output similar to the <application>Webalizer</application>'s access log reports. This way you could have nice statistics to be used for accounting about usage of printers, load dependent on daytime or weekday, users &etc; Anyone?</para> </note> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Log level</guilabel -></term> +<term><guilabel>Log level</guilabel></term> <listitem> -<para ->This setting controls the number of messages logged to the error log file. It can be one of the following:</para> +<para>This setting controls the number of messages logged to the error log file. It can be one of the following:</para> <variablelist> <varlistentry> -<term ->debug2</term> +<term>debug2</term> <listitem> -<para ->Log everything.</para> +<para>Log everything.</para> </listitem> </varlistentry> <varlistentry> -<term ->debug</term> +<term>debug</term> <listitem> -<para ->Log almost everything.</para> +<para>Log almost everything.</para> </listitem> </varlistentry> <varlistentry> -<term ->info</term> +<term>info</term> <listitem> -<para ->Log all requests and state changes.</para> +<para>Log all requests and state changes.</para> </listitem> </varlistentry> <varlistentry> -<term ->warn</term> +<term>warn</term> <listitem> -<para ->Log errors and warnings.</para> +<para>Log errors and warnings.</para> </listitem> </varlistentry> <varlistentry> -<term ->error</term> +<term>error</term> <listitem> -<para ->Log only errors.</para> +<para>Log only errors.</para> </listitem> </varlistentry> <varlistentry> -<term ->none</term> +<term>none</term> <listitem> -<para ->Log nothing.</para> +<para>Log nothing.</para> </listitem> </varlistentry> </variablelist> -<para ->If you need to troubleshoot (or if you want to study the inner workings of &CUPS;), set the log level to debug or debug2. Then the error_log will have a lot more entries (not just errors, but also informational entries).</para -> - -<para ->You can use this to watch <quote ->live</quote -> what &CUPS; is doing when you send a print job. In a &konsole; type:</para> - -<screen -><prompt ->kurt@transmeta:~ -></prompt -><userinput -><command ->tail</command -> <option ->-f</option -> <option ->-n</option -><parameter ->100</parameter -> <parameter ->/var/log/cups/error_log</parameter -></userinput -></screen> - -<para ->This will give you the last 100 lines (<option ->-n</option -> <parameter ->100</parameter ->) of the file onto the screen and a <quote ->realtime</quote -> update (<option ->-f</option ->)of what is happening. The following listing shows the printing of a test page (some pieces have been cut off for space reasons... Try it yourself if you need more info):</para> - -<screen -><computeroutput -> +<para>If you need to troubleshoot (or if you want to study the inner workings of &CUPS;), set the log level to debug or debug2. Then the error_log will have a lot more entries (not just errors, but also informational entries).</para> + +<para>You can use this to watch <quote>live</quote> what &CUPS; is doing when you send a print job. In a &konsole; type:</para> + +<screen><prompt>kurt@transmeta:~ ></prompt><userinput><command>tail</command> <option>-f</option> <option>-n</option><parameter>100</parameter> <parameter>/var/log/cups/error_log</parameter></userinput></screen> + +<para>This will give you the last 100 lines (<option>-n</option> <parameter>100</parameter>) of the file onto the screen and a <quote>realtime</quote> update (<option>-f</option>)of what is happening. The following listing shows the printing of a test page (some pieces have been cut off for space reasons... Try it yourself if you need more info):</para> + +<screen><computeroutput> I [04/Aug/2001:23:15:12 +0100] Job 214 queued on 'DANKA_P450' by 'root' D [04/Aug/2001:23:15:12 +0100] StartJob(214, 08426fe0) D [04/Aug/2001:23:15:12 +0100] StartJob() id = 214, file = 0/1 @@ -1130,36 +571,20 @@ D [04/Aug/2001:23:15:12 +0100] StartJob: backend = "/usr/lib/cups/backend/lpd" D [04/Aug/2001:23:15:12 +0100] StartJob: filterfds[1] = -1, 7 D [04/Aug/2001:23:15:12 +0100] start_process("/usr/lib/cups/backend/lpd", [....] I [04/Aug/2001:23:15:12 +0100] Started backend /usr/lib/cups/backend/lpd (PID 18992) for job 214. -D [04/Aug/2001:23:15:12 +0100] Page = 595x842; 15,16 to 580,833 [....] </computeroutput -></screen -> +D [04/Aug/2001:23:15:12 +0100] Page = 595x842; 15,16 to 580,833 [....] </computeroutput></screen> -<para ->The lines tagged <quote ->D</quote -> at the beginning are debug level entries, the ones tagged <quote ->I</quote -> are there in <quote ->info</quote -> level.</para> +<para>The lines tagged <quote>D</quote> at the beginning are debug level entries, the ones tagged <quote>I</quote> are there in <quote>info</quote> level.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Max log file size</guilabel -></term> +<term><guilabel>Max log file size</guilabel></term> <listitem> -<para ->Controls the maximum size of each log file before they are rotated. Defaults to 1048576 (1 Mb). Set this to 0 to disable log rotation.</para> +<para>Controls the maximum size of each log file before they are rotated. Defaults to 1048576 (1 Mb). Set this to 0 to disable log rotation.</para> <informalexample> -<para ->Enter an size in bytes, for example <userinput ->1048576</userinput -></para> +<para>Enter an size in bytes, for example <userinput>1048576</userinput></para> </informalexample> </listitem> @@ -1168,373 +593,195 @@ D [04/Aug/2001:23:15:12 +0100] Page = 595x842; 15,16 to 580,833 [....] </comput </sect1> <sect1 id="server-directories-configuration"> -<title ->Server Folders Configuration</title> +<title>Server Folders Configuration</title> -<para ->The dialogue to configure the &CUPS; server. Different folders are to be set here. Normally you don't need to change anything in this section. In case you play around with fancy (TrueType, &PostScript; or other) fonts on your system, this qis the place to do the settings for using those fonts when printing. Server folder settings include:</para> +<para>The dialogue to configure the &CUPS; server. Different folders are to be set here. Normally you don't need to change anything in this section. In case you play around with fancy (TrueType, &PostScript; or other) fonts on your system, this qis the place to do the settings for using those fonts when printing. Server folder settings include:</para> <itemizedlist> <listitem> -<para -><guilabel ->Executables</guilabel ->: where to find the server executables</para> +<para><guilabel>Executables</guilabel>: where to find the server executables</para> </listitem> <listitem> -<para -><guilabel ->Configuration</guilabel ->: where to find the server configuration files</para> +<para><guilabel>Configuration</guilabel>: where to find the server configuration files</para> </listitem> <listitem> -<para -><guilabel ->Data</guilabel ->: where to find the server data files</para> +<para><guilabel>Data</guilabel>: where to find the server data files</para> </listitem> <listitem> -<para -><guilabel ->Temporary files</guilabel ->: where to put the server temporary print files </para> +<para><guilabel>Temporary files</guilabel>: where to put the server temporary print files </para> </listitem> <listitem> -<para -><guilabel ->Temporary Requests</guilabel ->: where to find the server </para> +<para><guilabel>Temporary Requests</guilabel>: where to find the server </para> </listitem> <listitem> -<para -><guilabel ->Font Path</guilabel ->: where to find the server fonts</para> +<para><guilabel>Font Path</guilabel>: where to find the server fonts</para> </listitem> </itemizedlist> <screenshot> -<screeninfo ->&CUPS; server configuration dialogue: &HTTP; configuration</screeninfo> +<screeninfo>&CUPS; server configuration dialogue: &HTTP; configuration</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration4_directories.png" format="PNG"/></imageobject> <textobject> -<phrase ->The dialogue to configure the &CUPS; server: &HTTP; configuration</phrase -></textobject> +<phrase>The dialogue to configure the &CUPS; server: &HTTP; configuration</phrase></textobject> </mediaobject> </screenshot> <variablelist> <varlistentry> -<term -><guilabel ->Executables</guilabel -></term> +<term><guilabel>Executables</guilabel></term> <listitem> -<para ->The root folder for the scheduler executables. By default this is <filename class="directory" ->/usr/lib/cups</filename -> (or <filename class="directory" ->/usr/lib32/cups</filename -> on IRIX 6.5)</para> +<para>The root folder for the scheduler executables. By default this is <filename class="directory">/usr/lib/cups</filename> (or <filename class="directory">/usr/lib32/cups</filename> on IRIX 6.5)</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Configuration</guilabel -></term> +<term><guilabel>Configuration</guilabel></term> <listitem> -<para ->The root folder for the scheduler. By default, <filename class="directory" ->/etc/cups</filename ->.</para> -<para ->On the authors SuSE system, this is <filename class="directory" ->/usr/share/doc/cups</filename ->. It contains all the <acronym ->HTML</acronym -> or <acronym ->PDF</acronym -> documentation for &CUPS; which is available through the Web interface at <ulink url="http://localhost:631/documentation.html" -> http://localhost:631/documentation.html</ulink -></para> +<para>The root folder for the scheduler. By default, <filename class="directory">/etc/cups</filename>.</para> +<para>On the authors SuSE system, this is <filename class="directory">/usr/share/doc/cups</filename>. It contains all the <acronym>HTML</acronym> or <acronym>PDF</acronym> documentation for &CUPS; which is available through the Web interface at <ulink url="http://localhost:631/documentation.html"> http://localhost:631/documentation.html</ulink></para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Data</guilabel -></term> +<term><guilabel>Data</guilabel></term> <listitem> -<para ->The root folder for the &CUPS; data files. By default this is <filename class="directory" ->/usr/share/cups</filename -></para> -<para ->It contains such things as banners, charsets, data, drivers, fonts, and <command ->pstoraster</command -> templates.</para> +<para>The root folder for the &CUPS; data files. By default this is <filename class="directory">/usr/share/cups</filename></para> +<para>It contains such things as banners, charsets, data, drivers, fonts, and <command>pstoraster</command> templates.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Temporary files</guilabel -></term> +<term><guilabel>Temporary files</guilabel></term> <listitem> -<para ->The folder to put temporary files in. This folder must be writable by the user defined on the previous screen. This defaults to either <filename class="directory" ->/var/spool/cups/tmp</filename -> or the value of the <envar ->TMPDIR</envar -> environment variable.</para> +<para>The folder to put temporary files in. This folder must be writable by the user defined on the previous screen. This defaults to either <filename class="directory">/var/spool/cups/tmp</filename> or the value of the <envar>TMPDIR</envar> environment variable.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Temporary Requests</guilabel -></term> +<term><guilabel>Temporary Requests</guilabel></term> <listitem> -<para ->The folder where request files are stored. By default this is <filename class="directory" ->/var/spool/cups</filename -></para> +<para>The folder where request files are stored. By default this is <filename class="directory">/var/spool/cups</filename></para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Font path</guilabel -></term> +<term><guilabel>Font path</guilabel></term> <listitem> -<para ->The place to configure the &CUPS; server for handling your fancy fonts (TrueType or &PostScript;). &CUPS; will look here for fonts to embed in printfiles. This currently only affects the <command ->pstoraster</command -> filter, and the default is <filename class="directory" ->/usr/share/cups/fonts</filename ->.</para> +<para>The place to configure the &CUPS; server for handling your fancy fonts (TrueType or &PostScript;). &CUPS; will look here for fonts to embed in printfiles. This currently only affects the <command>pstoraster</command> filter, and the default is <filename class="directory">/usr/share/cups/fonts</filename>.</para> -<para ->To specify more than one folder, list them with double colons as separator. Do it like this:</para> +<para>To specify more than one folder, list them with double colons as separator. Do it like this:</para> <informalexample> -<para -><userinput ->/path/to/first/fontdir/:/path/to/second/fontdir/:/path/to/last/fontdir/</userinput -></para> +<para><userinput>/path/to/first/fontdir/:/path/to/second/fontdir/:/path/to/last/fontdir/</userinput></para> </informalexample> -<para ->For the Font path directive to work as intended, the application that wants to print needs to:</para> +<para>For the Font path directive to work as intended, the application that wants to print needs to:</para> <itemizedlist> <listitem> -<para ->Either correctly reference its desired fonts in the header of the generated &PostScript;</para> +<para>Either correctly reference its desired fonts in the header of the generated &PostScript;</para> </listitem> <listitem> -<para ->Or embed the font into the &PostScript; file.</para> +<para>Or embed the font into the &PostScript; file.</para> </listitem> </itemizedlist> -<para -><emphasis ->Referencing</emphasis -> the font by name leaves it up to the <acronym ->RIP</acronym -> and print device to respect and actually use it. <acronym ->RIP</acronym -> or printer <emphasis ->can</emphasis -> only use the desired font, if it is available on the system.</para> - -<para ->In the case of a &PostScript; printer, this needs to be a printer-resident font. If the printer doesn't have this font, it will try and replace it by an adequately similar font.</para> - -<para ->In the case of a non &PostScript; printer, this is done by &CUPS; and its <acronym ->RIP</acronym ->-ing filtering system. &CUPS; will use the font path directive to grab the correct font when <acronym ->RIP</acronym ->-ing the &PostScript; in the <command ->pstoraster</command -> filter. </para> - -<para ->In the case of a &PostScript; output device, &CUPS; is just spooling the file (actually, it is passing it through the <command ->pstops</command -> filter for accounting or n-up purposes), not <quote ->working</quote -> on it. Therefore, if you print to a &PostScript; printer it is solely the printer's responsibility to use the font asked for. It can't, if the font is neither loaded into the printer nor embedded in the &PostScript;. </para> +<para><emphasis>Referencing</emphasis> the font by name leaves it up to the <acronym>RIP</acronym> and print device to respect and actually use it. <acronym>RIP</acronym> or printer <emphasis>can</emphasis> only use the desired font, if it is available on the system.</para> + +<para>In the case of a &PostScript; printer, this needs to be a printer-resident font. If the printer doesn't have this font, it will try and replace it by an adequately similar font.</para> + +<para>In the case of a non &PostScript; printer, this is done by &CUPS; and its <acronym>RIP</acronym>-ing filtering system. &CUPS; will use the font path directive to grab the correct font when <acronym>RIP</acronym>-ing the &PostScript; in the <command>pstoraster</command> filter. </para> + +<para>In the case of a &PostScript; output device, &CUPS; is just spooling the file (actually, it is passing it through the <command>pstops</command> filter for accounting or n-up purposes), not <quote>working</quote> on it. Therefore, if you print to a &PostScript; printer it is solely the printer's responsibility to use the font asked for. It can't, if the font is neither loaded into the printer nor embedded in the &PostScript;. </para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="server-configuration"> -<title ->Server <acronym ->HTTP</acronym -> Configuration</title> - -<para ->The dialogue to configure the &CUPS; server &HTTP; settings is shown here. </para> -<para ->&CUPS; server &HTTP; settings are the following ones: </para> +<title>Server <acronym>HTTP</acronym> Configuration</title> + +<para>The dialogue to configure the &CUPS; server &HTTP; settings is shown here. </para> +<para>&CUPS; server &HTTP; settings are the following ones: </para> <itemizedlist> -<listitem -><para ->the <guilabel ->Document folder</guilabel -></para -></listitem> -<listitem -><para ->the <guilabel ->Default Language</guilabel -></para -></listitem> -<listitem -><para ->the <guilabel ->Default Charset</guilabel -></para -></listitem> +<listitem><para>the <guilabel>Document folder</guilabel></para></listitem> +<listitem><para>the <guilabel>Default Language</guilabel></para></listitem> +<listitem><para>the <guilabel>Default Charset</guilabel></para></listitem> </itemizedlist> <screenshot> -<screeninfo ->Dialogue to configure the &CUPS; server &HTTP; settings </screeninfo> +<screeninfo>Dialogue to configure the &CUPS; server &HTTP; settings </screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration5_HTTP.png" format="PNG"/></imageobject> <textobject> -<phrase ->Dialogue to configure the &CUPS; server &HTTP; settings </phrase -></textobject> +<phrase>Dialogue to configure the &CUPS; server &HTTP; settings </phrase></textobject> </mediaobject> </screenshot> <variablelist> <varlistentry> -<term -><guilabel ->Document folder</guilabel -></term> +<term><guilabel>Document folder</guilabel></term> <listitem> -<para ->The root folder for &HTTP; documents that are served. By default the compiled in folder, <filename class="directory" ->/usr/share/cups/doc</filename -></para> +<para>The root folder for &HTTP; documents that are served. By default the compiled in folder, <filename class="directory">/usr/share/cups/doc</filename></para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Default Language</guilabel -></term> +<term><guilabel>Default Language</guilabel></term> <listitem> -<para ->The default language, if not specified by the browser. If not specified, the current locale is used.</para> +<para>The default language, if not specified by the browser. If not specified, the current locale is used.</para> <informalexample> -<para ->Use the two letter locale codes, for example <userinput ->en</userinput -> or <userinput ->de</userinput ->.</para> +<para>Use the two letter locale codes, for example <userinput>en</userinput> or <userinput>de</userinput>.</para> </informalexample> <!-- available languages? --> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Default charset</guilabel -></term> +<term><guilabel>Default charset</guilabel></term> <listitem> -<para ->The default character set to use. If not specified, this defaults to UTF-8. This can also be overridden directly in the <acronym ->HTML</acronym -> documents.</para> +<para>The default character set to use. If not specified, this defaults to UTF-8. This can also be overridden directly in the <acronym>HTML</acronym> documents.</para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="server-encryption-support-configuration"> -<title -><guilabel ->Server encryption support configuration</guilabel -></title> +<title><guilabel>Server encryption support configuration</guilabel></title> -<para ->This is the dialogue to configure the &CUPS; server security settings. The server encryption support settings are these: </para> +<para>This is the dialogue to configure the &CUPS; server security settings. The server encryption support settings are these: </para> <itemizedlist> -<listitem -><para -><guilabel ->Server certificate</guilabel ->: the file to read containing the server's certificate</para -></listitem -> -<listitem -><para ->Server key: the file to read containing the server's key</para -></listitem> +<listitem><para><guilabel>Server certificate</guilabel>: the file to read containing the server's certificate</para></listitem> +<listitem><para>Server key: the file to read containing the server's key</para></listitem> </itemizedlist> <screenshot> -<screeninfo ->&CUPS; server configuration dialogue: security overview</screeninfo> +<screeninfo>&CUPS; server configuration dialogue: security overview</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration6_encryption.png" format="PNG"/></imageobject> <textobject> -<phrase ->The dialogue to configure the &CUPS; server: security settings</phrase -></textobject> +<phrase>The dialogue to configure the &CUPS; server: security settings</phrase></textobject> </mediaobject> </screenshot> <variablelist> <varlistentry> -<term -><guilabel ->Server certificate</guilabel -></term> +<term><guilabel>Server certificate</guilabel></term> <listitem> -<para ->The file to read containing the server's certificate. Defaults to <filename ->/etc/cups/ssl/server.crt</filename ->.</para> +<para>The file to read containing the server's certificate. Defaults to <filename>/etc/cups/ssl/server.crt</filename>.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Server key</guilabel -></term> +<term><guilabel>Server key</guilabel></term> <listitem> -<para ->The file to read containing the server's key. Defaults to <filename ->/etc/cups/ssl/server.key</filename -></para> +<para>The file to read containing the server's key. Defaults to <filename>/etc/cups/ssl/server.key</filename></para> </listitem> </varlistentry> </variablelist> @@ -1542,251 +789,124 @@ format="PNG"/></imageobject> </sect1> <sect1 id="server-miscellaneous-configuration"> -<title ->Server Miscellaneous Configuration</title> +<title>Server Miscellaneous Configuration</title> -<para ->The dialogue to configure the &CUPS; server miscellaneous settings is shown here. The following server settings are done through this screen:</para> +<para>The dialogue to configure the &CUPS; server miscellaneous settings is shown here. The following server settings are done through this screen:</para> <itemizedlist> -<listitem -><para -><guilabel ->Preserve job history</guilabel ->: whether to preserve a job history for later re-view</para -></listitem> -<listitem -><para -><guilabel ->Preserve job files</guilabel ->: whether to preserve fully <acronym ->RIP</acronym ->-ed job files for later re-print</para -></listitem -> -<listitem -><para -><guilabel ->Printcap file</guilabel ->: setting the name of and the path to a printcap file</para -></listitem> -<listitem -><para -><guilabel ->RIP Cache</guilabel ->: setting the size of the <acronym ->RIP</acronym -> cache in memory</para -></listitem> -<listitem -><para -><guilabel ->Filter Limit</guilabel ->: defining a filter limit</para -></listitem> +<listitem><para><guilabel>Preserve job history</guilabel>: whether to preserve a job history for later re-view</para></listitem> +<listitem><para><guilabel>Preserve job files</guilabel>: whether to preserve fully <acronym>RIP</acronym>-ed job files for later re-print</para></listitem> +<listitem><para><guilabel>Printcap file</guilabel>: setting the name of and the path to a printcap file</para></listitem> +<listitem><para><guilabel>RIP Cache</guilabel>: setting the size of the <acronym>RIP</acronym> cache in memory</para></listitem> +<listitem><para><guilabel>Filter Limit</guilabel>: defining a filter limit</para></listitem> </itemizedlist> <screenshot> -<screeninfo ->Dialogue to configure the &CUPS; server miscellaneous settings</screeninfo> +<screeninfo>Dialogue to configure the &CUPS; server miscellaneous settings</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration7_miscellanious.png" format="PNG"/></imageobject> <textobject> -<phrase ->Dialogue to configure the &CUPS; server miscellaneous settings</phrase -></textobject> +<phrase>Dialogue to configure the &CUPS; server miscellaneous settings</phrase></textobject> </mediaobject> </screenshot> <variablelist> <varlistentry> -<term -><guilabel ->Preserve job history (after completion)</guilabel -></term> +<term><guilabel>Preserve job history (after completion)</guilabel></term> <listitem> -<para ->Whether or not to preserve the job history after a job is completed, canceled, or stopped. The default is yes</para> +<para>Whether or not to preserve the job history after a job is completed, canceled, or stopped. The default is yes</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Preserve job file (after completion)</guilabel -></term> +<term><guilabel>Preserve job file (after completion)</guilabel></term> <listitem> -<para ->Whether or not to preserve the job files after a job is completed, canceled, or stopped. The default is no.</para> +<para>Whether or not to preserve the job files after a job is completed, canceled, or stopped. The default is no.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Printcap file</guilabel -></term> +<term><guilabel>Printcap file</guilabel></term> <listitem> -<para ->The name of the printcap file. The default is no filename. Leave this blank, to disable printcap file generation.</para> -<para ->The printcap setting is only needed to satisfy older applications in need of such a file.</para> +<para>The name of the printcap file. The default is no filename. Leave this blank, to disable printcap file generation.</para> +<para>The printcap setting is only needed to satisfy older applications in need of such a file.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->RIP cache</guilabel -></term> +<term><guilabel>RIP cache</guilabel></term> <listitem> -<para ->The amount of memory that each <acronym ->RIP</acronym -> should use to cache bitmaps. The value can be any real number, followed by <quote ->k</quote -> for kilobytes, <quote ->m</quote -> for megabytes, <quote ->g</quote ->for gigabytes, or <quote ->t</quote -> for tiles, where one tile is 256 x 256 pixels. The default value is 8m.</para> +<para>The amount of memory that each <acronym>RIP</acronym> should use to cache bitmaps. The value can be any real number, followed by <quote>k</quote> for kilobytes, <quote>m</quote> for megabytes, <quote>g</quote>for gigabytes, or <quote>t</quote> for tiles, where one tile is 256 x 256 pixels. The default value is 8m.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Filter limit</guilabel -></term> +<term><guilabel>Filter limit</guilabel></term> <listitem> -<para ->Sets the maximum cost of all job filters that can be run at the same time. A limit of 0 means no limit. A typical job may need a filter limit of at least 200. Limits less than the minimum required by a job force a single job to be printed at any time. The default limit is 0 (unlimited).</para> +<para>Sets the maximum cost of all job filters that can be run at the same time. A limit of 0 means no limit. A typical job may need a filter limit of at least 200. Limits less than the minimum required by a job force a single job to be printed at any time. The default limit is 0 (unlimited).</para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="network-general-configuration"> -<title ->Network General Configuration</title> +<title>Network General Configuration</title> -<para ->The dialogue to configure the &CUPS; server network settings is shown here. It includes:</para> +<para>The dialogue to configure the &CUPS; server network settings is shown here. It includes:</para> <itemizedlist> -<listitem -><para -><guilabel ->Look for hostname on IP addresses</guilabel -></para -></listitem> -<listitem -><para -><guilabel ->Port</guilabel -></para -></listitem> -<listitem -><para -><guilabel ->Max request size</guilabel -></para -></listitem> -<listitem -><para -><guilabel ->Timeout</guilabel -></para -></listitem> +<listitem><para><guilabel>Look for hostname on IP addresses</guilabel></para></listitem> +<listitem><para><guilabel>Port</guilabel></para></listitem> +<listitem><para><guilabel>Max request size</guilabel></para></listitem> +<listitem><para><guilabel>Timeout</guilabel></para></listitem> </itemizedlist> <screenshot> -<screeninfo ->Dialogue to configure the &CUPS; server network settings</screeninfo> +<screeninfo>Dialogue to configure the &CUPS; server network settings</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration8_networkgeneral.png" format="PNG"/></imageobject> <textobject> -<phrase ->Dialogue to configure the &CUPS; server network settings</phrase -></textobject> +<phrase>Dialogue to configure the &CUPS; server network settings</phrase></textobject> </mediaobject> </screenshot> <variablelist> <varlistentry> -<term -><guilabel ->Look for hostname on IP addresses</guilabel -></term> +<term><guilabel>Look for hostname on IP addresses</guilabel></term> <listitem> -<para ->Whether or not to do lookups on <acronym ->IP</acronym -> addresses to get a fully-qualified hostname. This defaults to off, for performance reasons.</para> +<para>Whether or not to do lookups on <acronym>IP</acronym> addresses to get a fully-qualified hostname. This defaults to off, for performance reasons.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Port</guilabel -></term> +<term><guilabel>Port</guilabel></term> <listitem> -<para ->Enter here Ports and addresses that the server will listen to. The default port 631 is reserved for the Internet Printing Protocol, and is what we use here.</para> -<para ->You can have multiple entries, to listen to more than one port or address, or to restrict access.</para> +<para>Enter here Ports and addresses that the server will listen to. The default port 631 is reserved for the Internet Printing Protocol, and is what we use here.</para> +<para>You can have multiple entries, to listen to more than one port or address, or to restrict access.</para> <note> -<para ->Unfortunately, most web browsers don't support <acronym ->TLS</acronym -> or &HTTP; upgrades for encryption. If you want to support web-based encryption, you'll probably need to listen on port 443, the <acronym ->HTTPS</acronym -> port.</para> +<para>Unfortunately, most web browsers don't support <acronym>TLS</acronym> or &HTTP; upgrades for encryption. If you want to support web-based encryption, you'll probably need to listen on port 443, the <acronym>HTTPS</acronym> port.</para> </note> -<para ->Use the <guibutton ->Add</guibutton -> and <guibutton ->Remove</guibutton -> buttons to add and remove entries from the list.</para> +<para>Use the <guibutton>Add</guibutton> and <guibutton>Remove</guibutton> buttons to add and remove entries from the list.</para> <informalexample> -<para ->You can enter ports on their own, ⪚ <userinput ->631</userinput ->, or hostnames with ports, ⪚ <userinput ->myhost:80</userinput -> or <userinput ->1.2.3.4:631</userinput ->.</para> +<para>You can enter ports on their own, ⪚ <userinput>631</userinput>, or hostnames with ports, ⪚ <userinput>myhost:80</userinput> or <userinput>1.2.3.4:631</userinput>.</para> </informalexample> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Max request size</guilabel -></term> +<term><guilabel>Max request size</guilabel></term> <listitem> -<para ->Controls the maximum size of &HTTP; requests and print files. The default setting is 0, which disables this feature.</para> +<para>Controls the maximum size of &HTTP; requests and print files. The default setting is 0, which disables this feature.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Timeout</guilabel -></term> +<term><guilabel>Timeout</guilabel></term> <listitem> -<para ->The timeout (in seconds) before requests time out. The default is 300 seconds.</para> +<para>The timeout (in seconds) before requests time out. The default is 300 seconds.</para> </listitem> </varlistentry> </variablelist> @@ -1794,73 +914,45 @@ format="PNG"/></imageobject> </sect1> <sect1 id="network-clients-configuration"> -<title ->Network Clients Configuration</title> +<title>Network Clients Configuration</title> -<para ->The dialogue to configure the &CUPS; network client settings is shown here. It includes:</para> +<para>The dialogue to configure the &CUPS; network client settings is shown here. It includes:</para> <itemizedlist> -<listitem -><para -><guilabel ->Accept "Keep Alive" requests</guilabel -></para -></listitem> -<listitem -><para ->KeepAliveTimeout:</para -> </listitem> -<listitem -><para ->MaxClients: </para -></listitem> +<listitem><para><guilabel>Accept "Keep Alive" requests</guilabel></para></listitem> +<listitem><para>KeepAliveTimeout:</para> </listitem> +<listitem><para>MaxClients: </para></listitem> </itemizedlist> <screenshot> -<screeninfo ->dialogue to configure the &CUPS; network client settings</screeninfo> +<screeninfo>dialogue to configure the &CUPS; network client settings</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration9_networkclients.png" format="PNG"/></imageobject> <textobject> -<phrase ->Dialogue to configure the &CUPS; network client settings</phrase -></textobject> +<phrase>Dialogue to configure the &CUPS; network client settings</phrase></textobject> </mediaobject> </screenshot> <variablelist> <varlistentry> -<term -><guilabel ->Accept "Keep Alive" requests</guilabel -></term> +<term><guilabel>Accept "Keep Alive" requests</guilabel></term> <listitem> -<para ->Whether or not to support the Keep-Alive connection option. The default is on.</para> +<para>Whether or not to support the Keep-Alive connection option. The default is on.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Keep alive timeout</guilabel -></term> +<term><guilabel>Keep alive timeout</guilabel></term> <listitem> -<para ->The timeout (in seconds) before Keep-Alive connections are automatically closed. The default is 60 seconds.</para> +<para>The timeout (in seconds) before Keep-Alive connections are automatically closed. The default is 60 seconds.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Max number of clients</guilabel -></term> +<term><guilabel>Max number of clients</guilabel></term> <listitem> -<para ->Controls the maximum number of simultaneous clients that will be handled. Defaults to 100.</para> +<para>Controls the maximum number of simultaneous clients that will be handled. Defaults to 100.</para> </listitem> </varlistentry> </variablelist> @@ -1868,405 +960,214 @@ format="PNG"/></imageobject> </sect1> <sect1 id="browsing-general-configuration"> -<title ->Browsing General Configuration</title> +<title>Browsing General Configuration</title> -<para ->The dialogue to configure the &CUPS; browsing general settings is shown here. It includes: </para> +<para>The dialogue to configure the &CUPS; browsing general settings is shown here. It includes: </para> <itemizedlist> -<listitem -><para -><guilabel ->Enable browsing</guilabel -></para -></listitem> -<listitem -><para -><guilabel ->Use short names when possible</guilabel -></para -></listitem> -<listitem -><para -><guilabel ->Use implicit classes</guilabel -></para -></listitem> +<listitem><para><guilabel>Enable browsing</guilabel></para></listitem> +<listitem><para><guilabel>Use short names when possible</guilabel></para></listitem> +<listitem><para><guilabel>Use implicit classes</guilabel></para></listitem> </itemizedlist> <screenshot> -<screeninfo ->Dialogue to configure the &CUPS; browsing general settings</screeninfo> +<screeninfo>Dialogue to configure the &CUPS; browsing general settings</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration10_browsinggeneral.png" format="PNG"/></imageobject> <textobject> -<phrase ->Dialogue to configure the &CUPS; browsing general settings</phrase -></textobject> +<phrase>Dialogue to configure the &CUPS; browsing general settings</phrase></textobject> </mediaobject> </screenshot> <variablelist> <varlistentry> -<term -><guilabel ->Enable browsing</guilabel -></term> +<term><guilabel>Enable browsing</guilabel></term> <listitem> -<para ->Whether or not to broadcast printer information to other &CUPS; servers. Enabled by default.</para> +<para>Whether or not to broadcast printer information to other &CUPS; servers. Enabled by default.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Use short names when possible</guilabel -></term> +<term><guilabel>Use short names when possible</guilabel></term> <listitem> -<para ->Whether or not to use <quote ->short</quote -> names for remote printers when possible (⪚ <systemitem class="resource" ->printer</systemitem -> instead of <systemitem class="resource" ->printer@host</systemitem ->). Enabled by default.</para> +<para>Whether or not to use <quote>short</quote> names for remote printers when possible (⪚ <systemitem class="resource">printer</systemitem> instead of <systemitem class="resource">printer@host</systemitem>). Enabled by default.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Use implicit classes</guilabel -></term> +<term><guilabel>Use implicit classes</guilabel></term> <listitem> -<para ->Whether or not to use implicit classes.</para> -<para ->Printer classes can be specified explicitly, in the <filename ->classes.conf</filename -> file, implicitly based upon the printers available on the <acronym ->LAN</acronym ->, or both.</para> -<para ->When Implicit classes are enabled, printers on the <acronym ->LAN</acronym -> with the same name (⪚ <systemitem class="resource" ->Acme-LaserPrint-1000</systemitem ->) will be put into a class with the same name. This allows you to setup multiple redundant queues on a <acronym ->LAN</acronym -> without a lot of administrative difficulties. If a user sends a job to <systemitem class="resource" ->Acme-LaserPrint-1000</systemitem ->, the job will go to the first available queue.</para> -<para ->This option is enabled by default.</para> +<para>Whether or not to use implicit classes.</para> +<para>Printer classes can be specified explicitly, in the <filename>classes.conf</filename> file, implicitly based upon the printers available on the <acronym>LAN</acronym>, or both.</para> +<para>When Implicit classes are enabled, printers on the <acronym>LAN</acronym> with the same name (⪚ <systemitem class="resource">Acme-LaserPrint-1000</systemitem>) will be put into a class with the same name. This allows you to setup multiple redundant queues on a <acronym>LAN</acronym> without a lot of administrative difficulties. If a user sends a job to <systemitem class="resource">Acme-LaserPrint-1000</systemitem>, the job will go to the first available queue.</para> +<para>This option is enabled by default.</para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="browsing-connection-configuration"> -<title ->Browsing Connection Configuration</title> +<title>Browsing Connection Configuration</title> -<para ->The dialogue to configure the &CUPS; server browsing connection is shown here. Browsing connection settings include:</para> +<para>The dialogue to configure the &CUPS; server browsing connection is shown here. Browsing connection settings include:</para> <itemizedlist> -<listitem -><para -><guilabel ->Broadcast addresses</guilabel ->: The (<acronym ->UDP</acronym ->) broadcast address to transmit printer information to</para -></listitem> -<listitem -><para -><guilabel ->Broadcast Port</guilabel ->: The port number to use for broadcasting</para -></listitem -> -<listitem -><para -><guilabel ->Poll addresses</guilabel ->: The address(es) to poll for information about printers on servers that might not broadcast (or whose broadcasts might not reach your <acronym ->LAN</acronym -> due to routers in between).</para -></listitem> +<listitem><para><guilabel>Broadcast addresses</guilabel>: The (<acronym>UDP</acronym>) broadcast address to transmit printer information to</para></listitem> +<listitem><para><guilabel>Broadcast Port</guilabel>: The port number to use for broadcasting</para></listitem> +<listitem><para><guilabel>Poll addresses</guilabel>: The address(es) to poll for information about printers on servers that might not broadcast (or whose broadcasts might not reach your <acronym>LAN</acronym> due to routers in between).</para></listitem> </itemizedlist> <screenshot> -<screeninfo ->Dialogue to configure the &CUPS; server browsing connection</screeninfo> +<screeninfo>Dialogue to configure the &CUPS; server browsing connection</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration11_browsingconnections.png" format="PNG"/></imageobject> <textobject> -<phrase ->Dialogue to configure the &CUPS; server browsing connection</phrase -></textobject> +<phrase>Dialogue to configure the &CUPS; server browsing connection</phrase></textobject> </mediaobject> </screenshot> <variablelist> <varlistentry> -<term -><guilabel ->Broadcast addresses</guilabel -></term> +<term><guilabel>Broadcast addresses</guilabel></term> <listitem> -<para ->After pressing the <guibutton ->Add</guibutton -> button, you will see the following dialogue to enter a new value for outgoing broadcasting browse packets. It is the same kind of dialogue as for adding other &CUPS; server addresses to be polled for printer information.</para> +<para>After pressing the <guibutton>Add</guibutton> button, you will see the following dialogue to enter a new value for outgoing broadcasting browse packets. It is the same kind of dialogue as for adding other &CUPS; server addresses to be polled for printer information.</para> <screenshot> -<screeninfo ->Dialogue to enter a new value for broadcasting browse packets to</screeninfo> +<screeninfo>Dialogue to enter a new value for broadcasting browse packets to</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfig_browsingmasks_add_button.png" format="PNG"/></imageobject> <textobject> -<phrase ->Dialogue to enter a new value for broadcasting browse packets to</phrase -></textobject> +<phrase>Dialogue to enter a new value for broadcasting browse packets to</phrase></textobject> </mediaobject> </screenshot> -<para ->This option specifies a broadcast address to be used. By default, browsing information is broadcast to all active interfaces.</para> +<para>This option specifies a broadcast address to be used. By default, browsing information is broadcast to all active interfaces.</para> <note> -<para ->&HP-UX; 10.20 and earlier do not properly handle broadcast unless you have a Class A, B, C or D netmask (&ie;, there is no <acronym ->CIDR</acronym -> support).</para> +<para>&HP-UX; 10.20 and earlier do not properly handle broadcast unless you have a Class A, B, C or D netmask (&ie;, there is no <acronym>CIDR</acronym> support).</para> </note> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Broadcast port</guilabel -></term> +<term><guilabel>Broadcast port</guilabel></term> <listitem> -<para ->The port used for <acronym ->UDP</acronym -> broadcasts. By default this is the <acronym ->IPP</acronym -> port; if you change this, you need to do it on all servers. Only one BrowsePort is recognised.</para> +<para>The port used for <acronym>UDP</acronym> broadcasts. By default this is the <acronym>IPP</acronym> port; if you change this, you need to do it on all servers. Only one BrowsePort is recognised.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Poll addresses</guilabel -></term> +<term><guilabel>Poll addresses</guilabel></term> <listitem> -<para ->Poll the named server(s) for printers.</para> +<para>Poll the named server(s) for printers.</para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="browsing-masks-configuration"> -<title ->Browsing Masks Configuration</title> +<title>Browsing Masks Configuration</title> -<para ->The dialogue to configure the &CUPS; server allowed and/or denied browse packets from other servers is shown here. </para> +<para>The dialogue to configure the &CUPS; server allowed and/or denied browse packets from other servers is shown here. </para> <itemizedlist> -<listitem -><para -><guilabel ->Browse allow</guilabel ->: </para -></listitem> -<listitem -><para -><guilabel ->Browse deny</guilabel ->: </para -></listitem> -<listitem -><para -><guilabel ->Browse order</guilabel ->: </para -></listitem> +<listitem><para><guilabel>Browse allow</guilabel>: </para></listitem> +<listitem><para><guilabel>Browse deny</guilabel>: </para></listitem> +<listitem><para><guilabel>Browse order</guilabel>: </para></listitem> </itemizedlist> <screenshot> -<screeninfo ->Dialogue to configure the &CUPS; server allowed and/or denied browse packets from other servers</screeninfo> +<screeninfo>Dialogue to configure the &CUPS; server allowed and/or denied browse packets from other servers</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration11_browsingmasks.png" format="PNG"/></imageobject> <textobject> -<phrase ->Dialogue to configure the &CUPS; server allowed and/or denied browse packets from other servers</phrase -></textobject> +<phrase>Dialogue to configure the &CUPS; server allowed and/or denied browse packets from other servers</phrase></textobject> </mediaobject> </screenshot> <variablelist> <varlistentry> -<term -><guilabel ->Add Browse Address</guilabel -> dialogue</term> +<term><guilabel>Add Browse Address</guilabel> dialogue</term> <listitem> -<para ->The dialogue to enter a new value for the address of another &CUPS; server to accept browse packets from is shown here. It is opened by clicking on the <guibutton ->Add...</guibutton -> button beside the field named <guilabel ->Browse Allow:</guilabel ->. It is the same dialogue as for adding <quote ->denied</quote -> broadcast sending addresses.</para> +<para>The dialogue to enter a new value for the address of another &CUPS; server to accept browse packets from is shown here. It is opened by clicking on the <guibutton>Add...</guibutton> button beside the field named <guilabel>Browse Allow:</guilabel>. It is the same dialogue as for adding <quote>denied</quote> broadcast sending addresses.</para> -<para ->The dialogue to enter a new value for the address of another &CUPS; server to accept browse packets from is shown here.</para> +<para>The dialogue to enter a new value for the address of another &CUPS; server to accept browse packets from is shown here.</para> <screenshot> -<screeninfo ->Dialogue to enter a new value for the address of another &CUPS; server to accept browse packets from</screeninfo> +<screeninfo>Dialogue to enter a new value for the address of another &CUPS; server to accept browse packets from</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfig_browsingmasks_add_button.png" format="PNG"/></imageobject> <textobject> -<phrase ->Dialogue to enter a new value for the address of another &CUPS; server to accept browse packets from</phrase -></textobject> +<phrase>Dialogue to enter a new value for the address of another &CUPS; server to accept browse packets from</phrase></textobject> </mediaobject> </screenshot> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Browse allow</guilabel -> and <guilabel ->Browse deny</guilabel -></term> +<term><guilabel>Browse allow</guilabel> and <guilabel>Browse deny</guilabel></term> <listitem> -<para -><guilabel ->Browse allow</guilabel -> specifies an address mask to allow for incoming browser packets. The default is to allow packets from all addresses.</para> -<para -><guilabel ->Browse deny</guilabel -> specifies an address mask to deny for incoming browser packets. The default is to deny packets from no addresses.</para> -<para ->Both <guilabel ->Browse allow</guilabel -> and <guilabel ->Browse deny</guilabel -> accept the following notations for addresses:</para> +<para><guilabel>Browse allow</guilabel> specifies an address mask to allow for incoming browser packets. The default is to allow packets from all addresses.</para> +<para><guilabel>Browse deny</guilabel> specifies an address mask to deny for incoming browser packets. The default is to deny packets from no addresses.</para> +<para>Both <guilabel>Browse allow</guilabel> and <guilabel>Browse deny</guilabel> accept the following notations for addresses:</para> <informalexample> <itemizedlist> <listitem> -<para -><userinput ->All</userinput -></para> +<para><userinput>All</userinput></para> </listitem> <listitem> -<para -><userinput ->None</userinput -></para> +<para><userinput>None</userinput></para> </listitem> <listitem> -<para -><userinput ->*.domain.com</userinput -></para> +<para><userinput>*.domain.com</userinput></para> </listitem> <listitem> -<para -><userinput ->.domain.com</userinput -></para> +<para><userinput>.domain.com</userinput></para> </listitem> <listitem> -<para -><userinput ->host.domain.com</userinput -></para> +<para><userinput>host.domain.com</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.*</userinput -></para> +<para><userinput>nnn.*</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.nnn.*</userinput -></para> +<para><userinput>nnn.nnn.*</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.nnn.nnn.*</userinput -></para> +<para><userinput>nnn.nnn.nnn.*</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.nnn.nnn.nnn</userinput -></para> +<para><userinput>nnn.nnn.nnn.nnn</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.nnn.nnn.nnn/mmm</userinput -></para> +<para><userinput>nnn.nnn.nnn.nnn/mmm</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm</userinput -></para> +<para><userinput>nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm</userinput></para> </listitem> </itemizedlist> </informalexample> -<para ->The hostname/domain name restrictions will only work if you have turned hostname lookups on!</para> +<para>The hostname/domain name restrictions will only work if you have turned hostname lookups on!</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Browse order</guilabel -></term> +<term><guilabel>Browse order</guilabel></term> <listitem> -<para ->Specifies the order of the allow/deny comparisons.</para> +<para>Specifies the order of the allow/deny comparisons.</para> </listitem> </varlistentry> </variablelist> @@ -2274,132 +1175,87 @@ format="PNG"/></imageobject> </sect1> <sect1 id="browsing-timeouts-configuration"> -<title ->Browsing Timeouts Configuration</title> +<title>Browsing Timeouts Configuration</title> -<para ->The dialogue to configure the &CUPS; server browse timeout settings is shown here. Browse timeout settings include:</para> +<para>The dialogue to configure the &CUPS; server browse timeout settings is shown here. Browse timeout settings include:</para> <itemizedlist> -<listitem -><para -><guilabel ->Browse Interval</guilabel -></para -></listitem> -<listitem -><para -><guilabel ->Browse Timeout</guilabel -></para -></listitem> +<listitem><para><guilabel>Browse Interval</guilabel></para></listitem> +<listitem><para><guilabel>Browse Timeout</guilabel></para></listitem> </itemizedlist> <screenshot> -<screeninfo ->Dialogue to configure the &CUPS; server browse timeout settings</screeninfo> +<screeninfo>Dialogue to configure the &CUPS; server browse timeout settings</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration12_browsingtimeouts.png" format="PNG"/></imageobject> <textobject> -<phrase ->dialogue to configure the &CUPS; server browse timeout settings</phrase -></textobject> +<phrase>dialogue to configure the &CUPS; server browse timeout settings</phrase></textobject> </mediaobject> </screenshot> <variablelist> <varlistentry> -<term -><guilabel ->Browse interval</guilabel -></term> +<term><guilabel>Browse interval</guilabel></term> <listitem> -<para ->The time between browsing updates in seconds. The default is 30 seconds.</para> -<para ->Note that browsing information is sent whenever a printer's state changes as well, so this represents the maximum time between updates.</para> -<para ->Set this to 0 to disable outgoing broadcasts so your local printers are not advertised, but you can still see printers on other hosts.</para> +<para>The time between browsing updates in seconds. The default is 30 seconds.</para> +<para>Note that browsing information is sent whenever a printer's state changes as well, so this represents the maximum time between updates.</para> +<para>Set this to 0 to disable outgoing broadcasts so your local printers are not advertised, but you can still see printers on other hosts.</para> </listitem> </varlistentry> <varlistentry> -<term ->Browse timeouts</term> +<term>Browse timeouts</term> <listitem> -<para ->The timeout (in seconds) for network printers - if we don't get an update within this time, the printer will be removed from the printer list.</para> -<para ->This number definitely should not be less than the browse interval period, for obvious reasons. Defaults to 300 seconds.</para> +<para>The timeout (in seconds) for network printers - if we don't get an update within this time, the printer will be removed from the printer list.</para> +<para>This number definitely should not be less than the browse interval period, for obvious reasons. Defaults to 300 seconds.</para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="browsing-relay-configuration"> -<title ->Browsing Relay Configuration</title> +<title>Browsing Relay Configuration</title> -<para ->The dialogue to configure the &CUPS; server as a browsing relay is shown here. Browsing relay settings include:</para> +<para>The dialogue to configure the &CUPS; server as a browsing relay is shown here. Browsing relay settings include:</para> <itemizedlist> -<listitem -><para -><guilabel ->Browser packets relay</guilabel -></para -></listitem> +<listitem><para><guilabel>Browser packets relay</guilabel></para></listitem> </itemizedlist> <screenshot> -<screeninfo ->Dialogue to configure the &CUPS; server as a browsing relay</screeninfo -> +<screeninfo>Dialogue to configure the &CUPS; server as a browsing relay</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration14_browsingrelay.png" format="PNG"/></imageobject> <textobject> -<phrase ->Dialogue to configure the &CUPS; server as a browsing relay</phrase -></textobject -> +<phrase>Dialogue to configure the &CUPS; server as a browsing relay</phrase></textobject> </mediaobject> </screenshot> <variablelist> <varlistentry> -<term ->Add Browse Relay dialogue</term> +<term>Add Browse Relay dialogue</term> <listitem> -<para ->The dialogue to enter a new value for an address pair to define browsing relaying between a &CUPS; server and a network is shown here.</para> +<para>The dialogue to enter a new value for an address pair to define browsing relaying between a &CUPS; server and a network is shown here.</para> <screenshot> -<screeninfo ->The dialogue to enter a new value for an address pair to define browsing relaying between a &CUPS; server and a network</screeninfo> +<screeninfo>The dialogue to enter a new value for an address pair to define browsing relaying between a &CUPS; server and a network</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfig_browse_relay_add_button.png" format="PNG"/></imageobject> <textobject> -<phrase ->The dialogue to enter a new value for an address pair to define browsing relaying between a &CUPS; server and a network</phrase -></textobject> +<phrase>The dialogue to enter a new value for an address pair to define browsing relaying between a &CUPS; server and a network</phrase></textobject> </mediaobject> </screenshot> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Browser packets relay</guilabel -></term> +<term><guilabel>Browser packets relay</guilabel></term> <listitem> -<para ->Relay browser packets from one address or network to another.</para> +<para>Relay browser packets from one address or network to another.</para> </listitem> </varlistentry> </variablelist> @@ -2407,273 +1263,140 @@ format="PNG"/></imageobject> </sect1> <sect1 id="security-configuration"> -<title ->Security Configuration</title> +<title>Security Configuration</title> -<para ->The dialogue to configure the &CUPS; server security settings for any of the defined server locations is shown here. It contains the following settings, which may be defined separately for any valid resource (or location) of the &CUPS; server:</para> +<para>The dialogue to configure the &CUPS; server security settings for any of the defined server locations is shown here. It contains the following settings, which may be defined separately for any valid resource (or location) of the &CUPS; server:</para> <itemizedlist> -<listitem -><para ->System Group:</para -></listitem> -<listitem -><para ->Access Permissions: </para -></listitem> -<listitem -><para ->Auth Type:</para -></listitem> -<listitem -><para ->Auth Class:</para -></listitem> -<listitem -><para ->Auth Group Name:</para -></listitem> -<listitem -><para ->Encryption:</para -></listitem> -<listitem -><para ->Allow:</para -></listitem> -<listitem -><para ->Deny:</para -></listitem> -<listitem -><para ->Order:</para -></listitem> +<listitem><para>System Group:</para></listitem> +<listitem><para>Access Permissions: </para></listitem> +<listitem><para>Auth Type:</para></listitem> +<listitem><para>Auth Class:</para></listitem> +<listitem><para>Auth Group Name:</para></listitem> +<listitem><para>Encryption:</para></listitem> +<listitem><para>Allow:</para></listitem> +<listitem><para>Deny:</para></listitem> +<listitem><para>Order:</para></listitem> </itemizedlist> -<para ->Valid resources (or locations) of the &CUPS; server are:</para> +<para>Valid resources (or locations) of the &CUPS; server are:</para> <itemizedlist> -<listitem -><para ->Server Root Location: <systemitem class="resource" ->/</systemitem -> </para -></listitem -> -<listitem -><para ->Server Administration Location: <systemitem class="resource" ->/admin</systemitem -></para -></listitem> -<listitem -><para ->All printers on the server: <systemitem class="resource" ->/printers</systemitem -></para -></listitem> -<listitem -><para ->Any individual printer on the server: ⪚ <systemitem class="resource" ->/printers/infotec_P320</systemitem -></para -></listitem -> -<listitem -><para ->All printer classes on the server: <systemitem class="resource" ->/classes</systemitem ->:</para -></listitem -> -<listitem -><para ->Any individual printer class on the server: ⪚ <systemitem class="resource" ->/classes/all_infotecs_P320_or_P450</systemitem -></para -></listitem -> +<listitem><para>Server Root Location: <systemitem class="resource">/</systemitem> </para></listitem> +<listitem><para>Server Administration Location: <systemitem class="resource">/admin</systemitem></para></listitem> +<listitem><para>All printers on the server: <systemitem class="resource">/printers</systemitem></para></listitem> +<listitem><para>Any individual printer on the server: ⪚ <systemitem class="resource">/printers/infotec_P320</systemitem></para></listitem> +<listitem><para>All printer classes on the server: <systemitem class="resource">/classes</systemitem>:</para></listitem> +<listitem><para>Any individual printer class on the server: ⪚ <systemitem class="resource">/classes/all_infotecs_P320_or_P450</systemitem></para></listitem> </itemizedlist> <screenshot> -<screeninfo ->Dialogue to configure the &CUPS; server security settings for any of the defined server locations</screeninfo> +<screeninfo>Dialogue to configure the &CUPS; server security settings for any of the defined server locations</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration_securityoverview.png" format="PNG"/></imageobject> <textobject> -<phrase ->dialogue to configure the &CUPS; server security settings for any of the defined server locations</phrase -></textobject> +<phrase>dialogue to configure the &CUPS; server security settings for any of the defined server locations</phrase></textobject> </mediaobject> </screenshot> <note> -<para ->For all locations that are not defined separately the setting of the location <quote ->above</quote -> it is valid.</para> - -<para ->For example, you have a printer named <systemitem class="resource" ->infotec_P450</systemitem -> with no set security options. Then the security of the location <systemitem class="resource" ->/printers</systemitem -> will take the responsibility for this printer as it is a sub-location of<systemitem class="resource" ->/printers</systemitem ->. If, in turn there is no security set for <systemitem class="resource" ->/printers</systemitem ->, then the security for <systemitem class="resource" ->/</systemitem -> (the general security) of the server takes responsibility. Either you have set this for your purpose or the compiled-in default value takes over.</para> +<para>For all locations that are not defined separately the setting of the location <quote>above</quote> it is valid.</para> + +<para>For example, you have a printer named <systemitem class="resource">infotec_P450</systemitem> with no set security options. Then the security of the location <systemitem class="resource">/printers</systemitem> will take the responsibility for this printer as it is a sub-location of<systemitem class="resource">/printers</systemitem>. If, in turn there is no security set for <systemitem class="resource">/printers</systemitem>, then the security for <systemitem class="resource">/</systemitem> (the general security) of the server takes responsibility. Either you have set this for your purpose or the compiled-in default value takes over.</para> </note> <variablelist> <varlistentry> -<term ->SystemGroup</term> +<term>SystemGroup</term> <listitem> -<para ->The group name for <systemitem class="groupname" ->System</systemitem -> or printer administration access. The default varies depending on the operating system, but will be <systemitem class="groupname" ->sys</systemitem ->, <systemitem class="groupname" ->system</systemitem -> or <systemitem class="groupname" ->root</systemitem -> (checked for in that order).</para> +<para>The group name for <systemitem class="groupname">System</systemitem> or printer administration access. The default varies depending on the operating system, but will be <systemitem class="groupname">sys</systemitem>, <systemitem class="groupname">system</systemitem> or <systemitem class="groupname">root</systemitem> (checked for in that order).</para> </listitem> </varlistentry> <varlistentry> -<term ->Access Permissions</term> +<term>Access Permissions</term> <listitem> -<para ->Access permissions for each folder served by the scheduler. Locations are relative to the document root.</para> +<para>Access permissions for each folder served by the scheduler. Locations are relative to the document root.</para> </listitem> </varlistentry> <varlistentry> -<term ->Authorisation Type</term> +<term>Authorisation Type</term> <listitem> -<para ->The authorisation to use:</para> +<para>The authorisation to use:</para> <variablelist> <varlistentry> -<term ->None</term> +<term>None</term> <listitem> -<para ->Perform no authentication.</para> +<para>Perform no authentication.</para> </listitem> </varlistentry> <varlistentry> -<term ->Basic</term> +<term>Basic</term> <listitem> -<para ->Perform authentication using the &HTTP; Basic method.</para> +<para>Perform authentication using the &HTTP; Basic method.</para> </listitem> </varlistentry> <varlistentry> -<term ->Digest</term> +<term>Digest</term> <listitem> -<para ->Perform authentication using the &HTTP; Digest method.</para> +<para>Perform authentication using the &HTTP; Digest method.</para> </listitem> </varlistentry> </variablelist> <note> -<para ->Local certificate authentication can be substituted by the client for Basic or Digest, when connecting to the localhost interface.</para> +<para>Local certificate authentication can be substituted by the client for Basic or Digest, when connecting to the localhost interface.</para> </note> </listitem> </varlistentry> <varlistentry> -<term ->Authorisation Class</term> +<term>Authorisation Class</term> <listitem> -<para ->The authorisation class. Currently only <quote ->Anonymous</quote ->, <quote ->User</quote ->, <quote ->System</quote -> (valid user belonging to the group set as system group), and <quote ->group</quote -> (valid user belonging to the specified group) are supported.</para> +<para>The authorisation class. Currently only <quote>Anonymous</quote>, <quote>User</quote>, <quote>System</quote> (valid user belonging to the group set as system group), and <quote>group</quote> (valid user belonging to the specified group) are supported.</para> </listitem> </varlistentry> <varlistentry> -<term ->Authorisation Group Name</term> +<term>Authorisation Group Name</term> <listitem> -<para ->The group name for <quote ->Group</quote -> authorisation</para> +<para>The group name for <quote>Group</quote> authorisation</para> </listitem> </varlistentry> <varlistentry> -<term ->Encryption</term> +<term>Encryption</term> <listitem> -<para ->Whether or not to use encryption. This depends on having the <application ->OpenSSL</application -> linked into the &CUPS; library and scheduler.</para> -<para ->Possible values are:</para> +<para>Whether or not to use encryption. This depends on having the <application>OpenSSL</application> linked into the &CUPS; library and scheduler.</para> +<para>Possible values are:</para> <variablelist> <varlistentry> -<term ->Always</term> +<term>Always</term> <listitem> -<para ->Always use encryption (<acronym ->SSL</acronym ->)</para> +<para>Always use encryption (<acronym>SSL</acronym>)</para> </listitem> </varlistentry> <varlistentry> -<term ->Never</term> +<term>Never</term> <listitem> -<para ->Never use encryption.</para> +<para>Never use encryption.</para> </listitem> </varlistentry> <varlistentry> -<term ->Required</term> +<term>Required</term> <listitem> -<para ->Use <acronym ->TLS</acronym -> encryption upgrade.</para> +<para>Use <acronym>TLS</acronym> encryption upgrade.</para> </listitem> </varlistentry> <varlistentry> -<term ->IfRequested</term> +<term>IfRequested</term> <listitem> -<para ->Use encryption if the server requests it.</para> +<para>Use encryption if the server requests it.</para> </listitem> </varlistentry> </variablelist> @@ -2681,310 +1404,189 @@ format="PNG"/></imageobject> </varlistentry> <varlistentry> -<term -><guilabel ->Allow</guilabel -></term> +<term><guilabel>Allow</guilabel></term> <listitem> -<para ->Allows access from the specified hostname, domain, <acronym ->IP</acronym -> address or network. Possible values are:</para> +<para>Allows access from the specified hostname, domain, <acronym>IP</acronym> address or network. Possible values are:</para> <informalexample> <itemizedlist> <listitem> -<para -><userinput ->All</userinput -></para> +<para><userinput>All</userinput></para> </listitem> <listitem> -<para -><userinput ->None</userinput -></para> +<para><userinput>None</userinput></para> </listitem> <listitem> -<para -><userinput ->*.domain.com</userinput -></para> +<para><userinput>*.domain.com</userinput></para> </listitem> <listitem> -<para -><userinput ->.domain.com</userinput -></para> +<para><userinput>.domain.com</userinput></para> </listitem> <listitem> -<para -><userinput ->host.domain.com</userinput -></para> +<para><userinput>host.domain.com</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.*</userinput -></para> +<para><userinput>nnn.*</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.nnn.*</userinput -></para> +<para><userinput>nnn.nnn.*</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.nnn.nnn.*</userinput -></para> +<para><userinput>nnn.nnn.nnn.*</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.nnn.nnn.nnn</userinput -></para> +<para><userinput>nnn.nnn.nnn.nnn</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.nnn.nnn.nnn/mmm</userinput -></para> +<para><userinput>nnn.nnn.nnn.nnn/mmm</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm</userinput -></para> +<para><userinput>nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm</userinput></para> </listitem> </itemizedlist> </informalexample> -<para ->The host and domain address require that you enable hostname lookups, as described earlier.</para> +<para>The host and domain address require that you enable hostname lookups, as described earlier.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Deny</guilabel -></term> +<term><guilabel>Deny</guilabel></term> <listitem> -<para ->Denies access from the specified hostname, domain, <acronym ->IP</acronym -> address or network. Possible values are:</para> +<para>Denies access from the specified hostname, domain, <acronym>IP</acronym> address or network. Possible values are:</para> <informalexample> <itemizedlist> <listitem> -<para -><userinput ->All</userinput -></para> +<para><userinput>All</userinput></para> </listitem> <listitem> -<para -><userinput ->None</userinput -></para> +<para><userinput>None</userinput></para> </listitem> <listitem> -<para -><userinput ->*.domain.com</userinput -></para> +<para><userinput>*.domain.com</userinput></para> </listitem> <listitem> -<para -><userinput ->.domain.com</userinput -></para> +<para><userinput>.domain.com</userinput></para> </listitem> <listitem> -<para -><userinput ->host.domain.com</userinput -></para> +<para><userinput>host.domain.com</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.*</userinput -></para> +<para><userinput>nnn.*</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.nnn.*</userinput -></para> +<para><userinput>nnn.nnn.*</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.nnn.nnn.*</userinput -></para> +<para><userinput>nnn.nnn.nnn.*</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.nnn.nnn.nnn</userinput -></para> +<para><userinput>nnn.nnn.nnn.nnn</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.nnn.nnn.nnn/mmm</userinput -></para> +<para><userinput>nnn.nnn.nnn.nnn/mmm</userinput></para> </listitem> <listitem> -<para -><userinput ->nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm</userinput -></para> +<para><userinput>nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm</userinput></para> </listitem> </itemizedlist> </informalexample> -<para ->The host and domain address require that you enable hostname lookups, as described earlier.</para> +<para>The host and domain address require that you enable hostname lookups, as described earlier.</para> </listitem> </varlistentry> <varlistentry> -<term ->Order</term> +<term>Order</term> <listitem> -<para ->The order of the allow and deny processing.</para> +<para>The order of the allow and deny processing.</para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="example-how-define-security-for-all-printers"> -<title ->Example: How To Define The Security For All Printers</title> - -<para ->The dialogue to configure the &CUPS; server security settings is discussed here. We use the example to add security definitions other than the default ones for the resource named <systemitem class="resource" ->all printers</systemitem ->. For the &CUPS; web server, this is the location you access through <ulink url="http://localhost:631/printers/" -> http://localhost:631/printers/</ulink -> or (remotely) through <ulink url="http://cups.server.name:631/printers/" -> http://cups.server.name:631/printers/</ulink -></para> - -<para ->The first screenshot shows the general location for this setting. <guilabel ->Select</guilabel -> <guibutton ->Add</guibutton -> or <guibutton ->Modify</guibutton -> a resource for which you want to decide about its security settings.</para> +<title>Example: How To Define The Security For All Printers</title> + +<para>The dialogue to configure the &CUPS; server security settings is discussed here. We use the example to add security definitions other than the default ones for the resource named <systemitem class="resource">all printers</systemitem>. For the &CUPS; web server, this is the location you access through <ulink url="http://localhost:631/printers/"> http://localhost:631/printers/</ulink> or (remotely) through <ulink url="http://cups.server.name:631/printers/"> http://cups.server.name:631/printers/</ulink></para> + +<para>The first screenshot shows the general location for this setting. <guilabel>Select</guilabel> <guibutton>Add</guibutton> or <guibutton>Modify</guibutton> a resource for which you want to decide about its security settings.</para> <screenshot> -<screeninfo ->Dialogue to configure the &CUPS; server security settings</screeninfo -><mediaobject> +<screeninfo>Dialogue to configure the &CUPS; server security settings</screeninfo><mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration15a_resourceallprinters_defineaccess.png" format="PNG"/></imageobject> <textobject> -<phrase ->Dialogue to configure the &CUPS; server security settings</phrase -></textobject> +<phrase>Dialogue to configure the &CUPS; server security settings</phrase></textobject> </mediaobject> </screenshot> -<para ->This dialogue is to add a new resource. It looks similar if you want to modify an already existing resource. Here are the general options:</para> +<para>This dialogue is to add a new resource. It looks similar if you want to modify an already existing resource. Here are the general options:</para> <screenshot> -<screeninfo ->Dialogue to add a new resource.</screeninfo> +<screeninfo>Dialogue to add a new resource.</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration15b_resourceallprinters_defineaccess.png" format="PNG"/></imageobject> <textobject> -<phrase ->Dialogue to add a new resource.</phrase -></textobject> +<phrase>Dialogue to add a new resource.</phrase></textobject> </mediaobject> </screenshot> -<para ->.This is the second part or the dialogue is to add a new ressource. It looks similar if you want to modify an already existing resource. Here you define the actual access masks for the resource in question. </para> +<para>.This is the second part or the dialogue is to add a new ressource. It looks similar if you want to modify an already existing resource. Here you define the actual access masks for the resource in question. </para> <screenshot> -<screeninfo ->Dialogue to add a new resource.</screeninfo> +<screeninfo>Dialogue to add a new resource.</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration15c_resourceallprinters_defineaccess.png" format="PNG"/></imageobject> <textobject> -<phrase ->Dialogue to add a new resource.</phrase -></textobject> +<phrase>Dialogue to add a new resource.</phrase></textobject> </mediaobject> </screenshot> <screenshot> -<screeninfo ->Resource dialogue</screeninfo> +<screeninfo>Resource dialogue</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration_resourceadminaccessmasks.png" format="PNG"/></imageobject> <textobject> -<phrase ->Resource dialogue</phrase -></textobject> +<phrase>Resource dialogue</phrase></textobject> </mediaobject> </screenshot> <screenshot> -<screeninfo ->Resource dialogue</screeninfo> +<screeninfo>Resource dialogue</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration_resourceadminaddprinters.png" format="PNG"/></imageobject> <textobject> -<phrase ->Resource dialogue</phrase -></textobject> +<phrase>Resource dialogue</phrase></textobject> </mediaobject> </screenshot> <screenshot> -<screeninfo ->Resource dialogue</screeninfo> +<screeninfo>Resource dialogue</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration_resourceadminaddprinters_defineaccess.png" format="PNG"/></imageobject> <textobject> -<phrase ->Resource dialogue</phrase -></textobject> +<phrase>Resource dialogue</phrase></textobject> </mediaobject> </screenshot> <screenshot> -<screeninfo ->Resource dialogue</screeninfo> +<screeninfo>Resource dialogue</screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsserverconfiguration_resourceadminauthorization.png" format="PNG"/></imageobject> <textobject> -<phrase ->Resource dialogue</phrase -></textobject> +<phrase>Resource dialogue</phrase></textobject> </mediaobject> </screenshot> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeprint/cupsoptions.docbook b/tde-i18n-en_GB/docs/tdebase/tdeprint/cupsoptions.docbook index a6ecddc1ee0..50d5a4fd8f4 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeprint/cupsoptions.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeprint/cupsoptions.docbook @@ -1,84 +1,48 @@ <chapter id="cupsoptions-presently-outside-kcontrol"> -<title ->&CUPS; options presently not available through &kcontrol;</title> +<title>&CUPS; options presently not available through &kcontrol;</title> -<para ->This chapter gives you some hints about further configuration possibilities which may not be available through the &tdeprint; &GUI; interface to &CUPS;.</para> +<para>This chapter gives you some hints about further configuration possibilities which may not be available through the &tdeprint; &GUI; interface to &CUPS;.</para> <sect1> -<title ->Overview of provided features</title> +<title>Overview of provided features</title> -<para ->All of the most often used features and functions &CUPS; provides are supported in &tdeprint;.</para> +<para>All of the most often used features and functions &CUPS; provides are supported in &tdeprint;.</para> <itemizedlist> <listitem> -<para ->Printer management is supported: add, remove, modify, configure, test, disable, enable ...</para> +<para>Printer management is supported: add, remove, modify, configure, test, disable, enable ...</para> </listitem> <listitem> -<para ->Job management is supported: cancel, hold, release, move to different printer</para> +<para>Job management is supported: cancel, hold, release, move to different printer</para> </listitem> <listitem> -<para ->Print options: for full control as provided by &CUPS;.</para> +<para>Print options: for full control as provided by &CUPS;.</para> </listitem> </itemizedlist> </sect1> <sect1 id="where-to-find-further-chupshelp"> -<title ->Where to find help when using &CUPS;</title> +<title>Where to find help when using &CUPS;</title> -<para ->A lot of information about the inner workings of &CUPS; is available through the web interface, which &CUPS; will always support. It works with any browser (yes, even text-based ones). Just go to <ulink url="http://localhost:631/" ->http://localhost:631/</ulink -> for a start. There you find a link to locally available &CUPS; documentation in <acronym ->HTML</acronym -> and <acronym ->PDF</acronym -> if you are new to &CUPS;.</para> +<para>A lot of information about the inner workings of &CUPS; is available through the web interface, which &CUPS; will always support. It works with any browser (yes, even text-based ones). Just go to <ulink url="http://localhost:631/">http://localhost:631/</ulink> for a start. There you find a link to locally available &CUPS; documentation in <acronym>HTML</acronym> and <acronym>PDF</acronym> if you are new to &CUPS;.</para> -<para ->&CUPS; is accessible through other means than &tdeprint;: commandline and browser are two native &CUPS; interfaces. The many commandline utilities add up to the most complete control you have on &CUPS;. The web interface is only a subset of all available configuration or control options. </para> +<para>&CUPS; is accessible through other means than &tdeprint;: commandline and browser are two native &CUPS; interfaces. The many commandline utilities add up to the most complete control you have on &CUPS;. The web interface is only a subset of all available configuration or control options. </para> -<para ->This is also true for &tdeprint;. Generally, as &CUPS; develops, most new features will first be implemented through the commandline. Be sure to check the latest versions of the man pages for &CUPS; to stay up-to-date with new features after you install a new version.</para> +<para>This is also true for &tdeprint;. Generally, as &CUPS; develops, most new features will first be implemented through the commandline. Be sure to check the latest versions of the man pages for &CUPS; to stay up-to-date with new features after you install a new version.</para> <tip> -<para ->Depending on your update method for &CUPS;, your active configuration file might not have been re-placed by a new one; thus your new, more capable &CUPS;-daemon might not have been told by the old configuration file about the new features to use.</para> +<para>Depending on your update method for &CUPS;, your active configuration file might not have been re-placed by a new one; thus your new, more capable &CUPS;-daemon might not have been told by the old configuration file about the new features to use.</para> </tip> -<para ->A complete list of available files and man pages should always be in the &CUPS; Software Administrator Manual (<ulink url="http://localhost:631/sam.html#FILES" ->http://localhost:631/sam.html#FILES</ulink ->. In the &konqueror; &URL;/location field, type <userinput ->man:/lpadmin</userinput -> and <userinput ->man:/cupsd.conf</userinput -> to find out about the most important command and configuration file. You knew already about &konqueror;'s nice abilities to show you the traditional &UNIX; man pages, didn't you? Read this. From there you find more interesting hints and links to other man pages and documentation.</para> +<para>A complete list of available files and man pages should always be in the &CUPS; Software Administrator Manual (<ulink url="http://localhost:631/sam.html#FILES">http://localhost:631/sam.html#FILES</ulink>. In the &konqueror; &URL;/location field, type <userinput>man:/lpadmin</userinput> and <userinput>man:/cupsd.conf</userinput> to find out about the most important command and configuration file. You knew already about &konqueror;'s nice abilities to show you the traditional &UNIX; man pages, didn't you? Read this. From there you find more interesting hints and links to other man pages and documentation.</para> <sect2> -<title ->How to find &CUPS; related man pages</title> - -<para ->Here is a way to find out which &CUPS; related man pages there are on your system: </para> - -<screen -><prompt ->kurt@transmeta:~ -></prompt -> <userinput -><command ->apropos</command -> <parameter ->cups</parameter -></userinput> +<title>How to find &CUPS; related man pages</title> + +<para>Here is a way to find out which &CUPS; related man pages there are on your system: </para> + +<screen><prompt>kurt@transmeta:~ ></prompt> <userinput><command>apropos</command> <parameter>cups</parameter></userinput> <computeroutput> cups-calibrate (8)- ESP Printer Calibration Tool lpstat (1) - print cups status information @@ -103,429 +67,168 @@ lpadmin (8) - configure cups printers and classes printers.conf (5) - printer configuration file for cups cupsd.conf (5) - server configuration file for cups filter (1) - cups file conversion filter interfaces -</computeroutput -></screen> +</computeroutput></screen> </sect2> </sect1> <sect1 id="tips-and-tricks-for-cups"> -<title ->Outside &tdeprint;: Hints & Tips Tricks with &CUPS; on the Commandline</title> +<title>Outside &tdeprint;: Hints & Tips Tricks with &CUPS; on the Commandline</title> -<para ->Here are a few examples of options that are presently only available if you use the commandline. </para> +<para>Here are a few examples of options that are presently only available if you use the commandline. </para> <sect2> -<title ->Allowing or denying printer access for certain users</title> - -<para ->When installing (or modifying) a printer through the command line, you can either deny or allow the usage of that printer to certain users:</para> - -<screen -><userinput -><command ->lpadmin</command -> <option ->-p</option -><parameter ->HeidelbergDigimaster9110</parameter -> <option ->-v</option -> <parameter ->lpd:/10.160.16.99/mqueue</parameter -> <option ->-u</option -> <parameter ->allow:kurt,sylvi,hansjoerg</parameter -> <option ->-E</option -> <option ->-P</option -> <parameter ->/home/kurt/PPDs/DVHV.ppd</parameter -></userinput -></screen> - -<para ->will allow the usage of this (believe me: very nice and also very professional) printer to only the three mentioned users and at the same time deny it to all others. If another user wants to print on the DigiMaster via this &CUPS; server, he will receive an error message along the lines <errortype ->client-error-not-possible</errortype ->.</para> - -<screen -><userinput -><command ->lpadmin</command -> <option ->-p</option -> <parameter ->HeidelbergDigimaster9110</parameter -> <option ->-v</option -> <parameter ->lpd:/10.160.16.99/mqueue</parameter -> <option ->-u</option -> <parameter ->deny:tackat,boss,waba</parameter -> <option ->-E</option -> <option ->-P</option -> <parameter ->/home/kurt/PPDs/DVHV.ppd</parameter -></userinput -></screen> - -<para ->will deny the usage of this same printer to the three mentioned users and at the same time allow it to all others. If <quote ->denied</quote -> user wants to print on the DigiMaster via this &CUPS; server, he will receive an error message along the lines <errortype ->client-error-not-possible</errortype ->.</para> +<title>Allowing or denying printer access for certain users</title> + +<para>When installing (or modifying) a printer through the command line, you can either deny or allow the usage of that printer to certain users:</para> + +<screen><userinput><command>lpadmin</command> <option>-p</option><parameter>HeidelbergDigimaster9110</parameter> <option>-v</option> <parameter>lpd:/10.160.16.99/mqueue</parameter> <option>-u</option> <parameter>allow:kurt,sylvi,hansjoerg</parameter> <option>-E</option> <option>-P</option> <parameter>/home/kurt/PPDs/DVHV.ppd</parameter></userinput></screen> + +<para>will allow the usage of this (believe me: very nice and also very professional) printer to only the three mentioned users and at the same time deny it to all others. If another user wants to print on the DigiMaster via this &CUPS; server, he will receive an error message along the lines <errortype>client-error-not-possible</errortype>.</para> + +<screen><userinput><command>lpadmin</command> <option>-p</option> <parameter>HeidelbergDigimaster9110</parameter> <option>-v</option> <parameter>lpd:/10.160.16.99/mqueue</parameter> <option>-u</option> <parameter>deny:tackat,boss,waba</parameter> <option>-E</option> <option>-P</option> <parameter>/home/kurt/PPDs/DVHV.ppd</parameter></userinput></screen> + +<para>will deny the usage of this same printer to the three mentioned users and at the same time allow it to all others. If <quote>denied</quote> user wants to print on the DigiMaster via this &CUPS; server, he will receive an error message along the lines <errortype>client-error-not-possible</errortype>.</para> <note> -<para ->Only one of the two options may be used at one time; at present there is no support to have a similar option in a per-group based way. This will be implemented in the future.</para> +<para>Only one of the two options may be used at one time; at present there is no support to have a similar option in a per-group based way. This will be implemented in the future.</para> </note> </sect2> <sect2> -<title ->Imposing Quotas for certain printers</title> +<title>Imposing Quotas for certain printers</title> -<para ->Sometimes you want to impose quotas for certain printers. With quotas you can set upper limits for the number of pages or the amount of data to be printed over a certain period to a certain printer.</para> +<para>Sometimes you want to impose quotas for certain printers. With quotas you can set upper limits for the number of pages or the amount of data to be printed over a certain period to a certain printer.</para> -<para ->Quotas can be set with the <option ->-o</option -> option when installing a printer with the <command ->lpadmin</command -> command, or afterwards for an already existing printer. Following are some guidelines (which are missing at the time of writing in the, official &CUPS; documentation):</para> +<para>Quotas can be set with the <option>-o</option> option when installing a printer with the <command>lpadmin</command> command, or afterwards for an already existing printer. Following are some guidelines (which are missing at the time of writing in the, official &CUPS; documentation):</para> <itemizedlist> <listitem> -<para ->With &CUPS; you may have pagecount- and filesize-based quotas for individual printers.</para> +<para>With &CUPS; you may have pagecount- and filesize-based quotas for individual printers.</para> </listitem> <listitem> -<para ->Quotas are calculated for each user individually (so a single set of limits applies to all users for the printer concerned).</para> +<para>Quotas are calculated for each user individually (so a single set of limits applies to all users for the printer concerned).</para> </listitem> <listitem> -<para ->Quotas include banner pages (if those are used).</para> +<para>Quotas include banner pages (if those are used).</para> </listitem> <listitem> -<para ->This means: you can limit every user to 20 pages per day on an expensive printer, but you cannot limit every user except <systemitem class="username" ->Kurt</systemitem -> or <systemitem class="username" ->root</systemitem ->.</para> +<para>This means: you can limit every user to 20 pages per day on an expensive printer, but you cannot limit every user except <systemitem class="username">Kurt</systemitem> or <systemitem class="username">root</systemitem>.</para> </listitem> <listitem> -<para ->There are <option ->job-k-limit</option ->, <option ->job-page-limit</option ->, and <option ->job-quota-period</option -> options to give when setting up a printer.</para> +<para>There are <option>job-k-limit</option>, <option>job-page-limit</option>, and <option>job-quota-period</option> options to give when setting up a printer.</para> </listitem> <listitem> -<para -><option ->job-quota-period</option -> sets a time interval for quota computing (intervals are determined in seconds; so a day is 60x60x24=86.400, a week is 60x60x24x7=604,800, and a month is 60x60x24x30=2.592.000 seconds.)</para> +<para><option>job-quota-period</option> sets a time interval for quota computing (intervals are determined in seconds; so a day is 60x60x24=86.400, a week is 60x60x24x7=604,800, and a month is 60x60x24x30=2.592.000 seconds.)</para> </listitem> <listitem> -<para ->For quotas to be enforced, the time-period <emphasis ->plus</emphasis -> at least one job-limit must be set to non-zero.</para> +<para>For quotas to be enforced, the time-period <emphasis>plus</emphasis> at least one job-limit must be set to non-zero.</para> </listitem> <listitem> -<para ->The default value of 0 for <option ->job-k-limit</option -> specifies that there is no limit.</para> +<para>The default value of 0 for <option>job-k-limit</option> specifies that there is no limit.</para> </listitem> <listitem> -<para ->The default value of 0 for <option ->job-page-limit</option -> specifies that there is no limit.</para> +<para>The default value of 0 for <option>job-page-limit</option> specifies that there is no limit.</para> </listitem> <listitem> -<para ->The default value of 0 for <option ->job-quota-period</option -> specifies that the limits apply to all jobs that have been printed by a user that are still known to the system.</para> +<para>The default value of 0 for <option>job-quota-period</option> specifies that the limits apply to all jobs that have been printed by a user that are still known to the system.</para> </listitem> </itemizedlist> <sect3> -<title ->Working Examples:</title> - -<para ->Working, as both, time-period <emphasis ->plus</emphasis -> one or both job-limits are defined</para> - -<screen -><userinput -><command ->lpadmin</command -> <option ->-p</option -> <parameter ->danka_infotec_4850</parameter -> <option ->-o</option -> <parameter ->job-quota-period=604800</parameter -> <option ->-o</option -> <parameter ->job-k-limit=1024</parameter -></userinput -></screen> - -<para ->This sets a limit of a file size of 1 MB (in total) for each user of existing printer <systemitem class="resource" ->danka_infotec_4850</systemitem -> during one week.</para> - -<screen -><userinput -><command ->lpadmin</command -> <option ->p</option -> <parameter ->danka_infotec_4105</parameter -> <option ->-o</option -> <parameter ->job-quota-period=604800</parameter -> <option ->-o</option -> <parameter ->job-page-limit=100</parameter -></userinput -></screen> - -<para ->This sets a limit of 100 pages (in total) for each user of existing printer <systemitem class="resource" ->danka_infotec_4105</systemitem -> during one week.</para> - -<screen -><userinput -><command ->lpadmin</command -> <option ->-p</option -> <parameter ->danka_infotec_P450</parameter -> <option ->-o</option -> <parameter ->job-quota-period=604800</parameter -> <option ->-o</option -> <parameter ->job-k-limit=1024</parameter -> <option ->-o</option -> <parameter ->job-page-limit=100</parameter -></userinput -></screen> - -<para ->This sets a combined limit of 1 MB (in total) and 100 pages (in total) for each user of existing printer <systemitem class="resource" ->danka_infotec_P450</systemitem -> during one week. Whichever limit is reached first will take effect.</para> +<title>Working Examples:</title> + +<para>Working, as both, time-period <emphasis>plus</emphasis> one or both job-limits are defined</para> + +<screen><userinput><command>lpadmin</command> <option>-p</option> <parameter>danka_infotec_4850</parameter> <option>-o</option> <parameter>job-quota-period=604800</parameter> <option>-o</option> <parameter>job-k-limit=1024</parameter></userinput></screen> + +<para>This sets a limit of a file size of 1 MB (in total) for each user of existing printer <systemitem class="resource">danka_infotec_4850</systemitem> during one week.</para> + +<screen><userinput><command>lpadmin</command> <option>p</option> <parameter>danka_infotec_4105</parameter> <option>-o</option> <parameter>job-quota-period=604800</parameter> <option>-o</option> <parameter>job-page-limit=100</parameter></userinput></screen> + +<para>This sets a limit of 100 pages (in total) for each user of existing printer <systemitem class="resource">danka_infotec_4105</systemitem> during one week.</para> + +<screen><userinput><command>lpadmin</command> <option>-p</option> <parameter>danka_infotec_P450</parameter> <option>-o</option> <parameter>job-quota-period=604800</parameter> <option>-o</option> <parameter>job-k-limit=1024</parameter> <option>-o</option> <parameter>job-page-limit=100</parameter></userinput></screen> + +<para>This sets a combined limit of 1 MB (in total) and 100 pages (in total) for each user of existing printer <systemitem class="resource">danka_infotec_P450</systemitem> during one week. Whichever limit is reached first will take effect.</para> </sect3> <sect3> -<title ->Not working examples</title> - -<para -><emphasis ->NOT</emphasis -> working, as only <emphasis ->one</emphasis ->, time-period <emphasis ->or</emphasis -> job-limit is defined)</para> - -<screen -><userinput -><command ->lpadmin</command -> <option ->-p</option -> <parameter ->danka_infotec_P320</parameter -> <option ->-o</option -> <parameter ->job-quota-period=604800</parameter -></userinput> - -<userinput -><command ->lpadmin</command -> <option ->-p</option -> <parameter ->danka_infotec_FullColor</parameter -> <option ->-o</option -> <parameter ->job-page-limit=100</parameter -></userinput> - -<userinput -><command ->lpadmin</command -> <option ->-p</option -> <parameter ->danka_infotec_HiSpeed</parameter -> <option ->-o</option -> <parameter ->job-k-limit=1024</parameter -></userinput -></screen> +<title>Not working examples</title> + +<para><emphasis>NOT</emphasis> working, as only <emphasis>one</emphasis>, time-period <emphasis>or</emphasis> job-limit is defined)</para> + +<screen><userinput><command>lpadmin</command> <option>-p</option> <parameter>danka_infotec_P320</parameter> <option>-o</option> <parameter>job-quota-period=604800</parameter></userinput> + +<userinput><command>lpadmin</command> <option>-p</option> <parameter>danka_infotec_FullColor</parameter> <option>-o</option> <parameter>job-page-limit=100</parameter></userinput> + +<userinput><command>lpadmin</command> <option>-p</option> <parameter>danka_infotec_HiSpeed</parameter> <option>-o</option> <parameter>job-k-limit=1024</parameter></userinput></screen> </sect3> <sect3> -<title ->Related Error Messages</title> +<title>Related Error Messages</title> -<para ->Once a user reaches his quota limit, he'll get a <errortype ->client-error-not-possible</errortype -> message, if he wants to print.</para> +<para>Once a user reaches his quota limit, he'll get a <errortype>client-error-not-possible</errortype> message, if he wants to print.</para> </sect3> </sect2> <sect2> -<title ->Installing a <quote ->raw</quote -> printer</title> - -<para ->There are different ways to define a <quote ->raw</quote -> printer. One comfortable one is to use the <command ->lpadmin</command -> command. Just don't define a &PPD; file to be used for that printer and it will be a raw one:</para> - -<screen -><userinput -><command ->lpadmin</command -> <option ->-p</option -> <parameter ->Raw_Danka_infotec</parameter -> <option ->-E</option -> <option ->-v</option -> <parameter ->lpd://10.160.16.137/PORT1</parameter -></userinput -></screen> - -<para ->Raw printer queues are those which don't touch the print file to transform it to a different file format. You need this for example when printing from &Windows; clients via Samba through a &CUPS; server to a <acronym ->PCL</acronym -> printer: in this case the &Windows; side printer driver would generate the finished print file format for the target printer and filtering it through &CUPS; filters would only harm the purpose. Under certain circumstances (if you want to make sure that the file goes to the printer <quote ->unfiltered</quote -> by &CUPS;) the <quote -><command ->lpadmin</command -> without a &PPD;</quote -> comes in handy.</para> +<title>Installing a <quote>raw</quote> printer</title> + +<para>There are different ways to define a <quote>raw</quote> printer. One comfortable one is to use the <command>lpadmin</command> command. Just don't define a &PPD; file to be used for that printer and it will be a raw one:</para> + +<screen><userinput><command>lpadmin</command> <option>-p</option> <parameter>Raw_Danka_infotec</parameter> <option>-E</option> <option>-v</option> <parameter>lpd://10.160.16.137/PORT1</parameter></userinput></screen> + +<para>Raw printer queues are those which don't touch the print file to transform it to a different file format. You need this for example when printing from &Windows; clients via Samba through a &CUPS; server to a <acronym>PCL</acronym> printer: in this case the &Windows; side printer driver would generate the finished print file format for the target printer and filtering it through &CUPS; filters would only harm the purpose. Under certain circumstances (if you want to make sure that the file goes to the printer <quote>unfiltered</quote> by &CUPS;) the <quote><command>lpadmin</command> without a &PPD;</quote> comes in handy.</para> </sect2> </sect1> <sect1 id="troubleshooting-cups"> -<title ->Troubleshooting &CUPS; in &tdeprint;</title> +<title>Troubleshooting &CUPS; in &tdeprint;</title> -<para ->This section of the &tdeprint; Handbook will live from the readers' feedback. Here is just a small beginning.</para> +<para>This section of the &tdeprint; Handbook will live from the readers' feedback. Here is just a small beginning.</para> <sect2> -<title ->Error Messages</title> +<title>Error Messages</title> <qandaset> <qandaentry> <question> -<para ->What does the error <errortype ->client-error-bad-request</errortype -> mean?</para> +<para>What does the error <errortype>client-error-bad-request</errortype> mean?</para> </question> <answer> -<para ->The user sent a file to the &CUPS; which the server could not process. You get this also upon sending an <quote ->empty</quote -> file.</para> +<para>The user sent a file to the &CUPS; which the server could not process. You get this also upon sending an <quote>empty</quote> file.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->And <errortype ->client-error-not-possible</errortype ->?</para> +<para>And <errortype>client-error-not-possible</errortype>?</para> </question> <answer> -<para ->User is either not allowed to print to a certain printer or has achieved his quota (based on file size and/or page number)</para> +<para>User is either not allowed to print to a certain printer or has achieved his quota (based on file size and/or page number)</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How about <errortype ->client-error-not-found</errortype ->?</para> +<para>How about <errortype>client-error-not-found</errortype>?</para> </question> <answer> -<para ->The user tried to access a nonexistent resource on the &CUPS; server, such as trying to print a nonexistent file, or one that you are denied permission to read.</para> +<para>The user tried to access a nonexistent resource on the &CUPS; server, such as trying to print a nonexistent file, or one that you are denied permission to read.</para> </answer> </qandaentry> @@ -534,362 +237,165 @@ filter (1) - cups file conversion filter interfaces </sect2> <sect2> -<title ->Questions and Answers</title> +<title>Questions and Answers</title> <qandaset> <qandaentry> <question> -<para ->Why can't I re-start my jobs?</para> +<para>Why can't I re-start my jobs?</para> </question> <answer> -<para ->To be able to re-start your <quote ->completed</quote -> jobs from the web interface, you need a setting in the <filename ->/etc/cups/cupsd.conf</filename -> file: set <userinput ->PreserveJobFiles True</userinput ->.</para> +<para>To be able to re-start your <quote>completed</quote> jobs from the web interface, you need a setting in the <filename>/etc/cups/cupsd.conf</filename> file: set <userinput>PreserveJobFiles True</userinput>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I get rid of the long list of completed jobs in the web interface?</para> +<para>How do I get rid of the long list of completed jobs in the web interface?</para> </question> <answer> -<para ->TODO</para> +<para>TODO</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How does page accounting work?</para> +<para>How does page accounting work?</para> </question> <answer> -<para ->&CUPS; does the <quote ->print accounting</quote -> by passing nearly every job through the <quote ->pstops</quote -> filter. This one does, amongst other things, the page counting. Output of this filter there may be piped into other filters (like pstoraster --> rastertopcl) or sent to the printer directly (if it is a &PostScript; printer).</para> - -<para ->In any case, this works for network, parallel, serial or <acronym ->USB</acronym -> printers the same. For pstops to work, it needs <acronym ->DSC</acronym ->, Document Structuring Convention compliant &PostScript; (or near-equivalent) as input. So it calculates the pages during filtering on the print server and writes info about every single page (what time, which user, which job-ID and -name, which printer, how many copies of which pages of the document, how many kilo-bytes?) into <filename ->/var/log/cups/page_log</filename ->.</para> - -<para ->By the way: on my personal <quote ->wishlist</quote -> is a hack of <quote ->webalizer</quote -> to read and analyse the page_log and give a similar output. Anyone?</para> - -<para ->However, it is <emphasis ->not</emphasis -> giving correct results in the following cases:</para> +<para>&CUPS; does the <quote>print accounting</quote> by passing nearly every job through the <quote>pstops</quote> filter. This one does, amongst other things, the page counting. Output of this filter there may be piped into other filters (like pstoraster --> rastertopcl) or sent to the printer directly (if it is a &PostScript; printer).</para> + +<para>In any case, this works for network, parallel, serial or <acronym>USB</acronym> printers the same. For pstops to work, it needs <acronym>DSC</acronym>, Document Structuring Convention compliant &PostScript; (or near-equivalent) as input. So it calculates the pages during filtering on the print server and writes info about every single page (what time, which user, which job-ID and -name, which printer, how many copies of which pages of the document, how many kilo-bytes?) into <filename>/var/log/cups/page_log</filename>.</para> + +<para>By the way: on my personal <quote>wishlist</quote> is a hack of <quote>webalizer</quote> to read and analyse the page_log and give a similar output. Anyone?</para> + +<para>However, it is <emphasis>not</emphasis> giving correct results in the following cases:</para> <itemizedlist> <listitem> -<para ->The printer jams and maybe therefore throw away the job (real live experience; or maybe throwing away the job because of problems with the data format)</para> +<para>The printer jams and maybe therefore throw away the job (real live experience; or maybe throwing away the job because of problems with the data format)</para> </listitem> <listitem> -<para ->Jobs printed as <quote ->raw</quote -> are always counted as size of 1 page (and maybe multiple copies).</para> +<para>Jobs printed as <quote>raw</quote> are always counted as size of 1 page (and maybe multiple copies).</para> </listitem> </itemizedlist> -<para ->Therefore the page accounting of &CUPS; is <quote ->only</quote -> an approximation (in many cases an excellent or at least good one, in others a quite poor one). The only reliable print count is the one done by the internal printer counter. (Because this is the one you pay for, if you are on a <quote ->click price</quote -> or similar.) Some, by far not most, printers can be queried remotely for that information via <acronym ->SNMP</acronym -> (Simple Network Management Protocol). That means, in a bigger network with many different printers there <emphasis ->is</emphasis -> just no completely reliable and accurate page accounting tool!</para> +<para>Therefore the page accounting of &CUPS; is <quote>only</quote> an approximation (in many cases an excellent or at least good one, in others a quite poor one). The only reliable print count is the one done by the internal printer counter. (Because this is the one you pay for, if you are on a <quote>click price</quote> or similar.) Some, by far not most, printers can be queried remotely for that information via <acronym>SNMP</acronym> (Simple Network Management Protocol). That means, in a bigger network with many different printers there <emphasis>is</emphasis> just no completely reliable and accurate page accounting tool!</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Why doesn't page-accounting work with &Windows; clients?</para> +<para>Why doesn't page-accounting work with &Windows; clients?</para> </question> <answer> -<para ->From &Windows; clients jobs nearly always need to be sent as <quote ->raw</quote ->. Why? If &CUPS; works as a print server for &Windows; clients using the original native &Windows; driver for the target print device, this guarantees the correct formatting of the job on the clients already; therefor the server should not touch it and print <quote ->raw</quote ->; therefor no filtering is started (and this is not even possible as the input from the clients is not &PostScript; as pstops expects; hence no page-count other than the default <quote ->1</quote ->.</para> +<para>From &Windows; clients jobs nearly always need to be sent as <quote>raw</quote>. Why? If &CUPS; works as a print server for &Windows; clients using the original native &Windows; driver for the target print device, this guarantees the correct formatting of the job on the clients already; therefor the server should not touch it and print <quote>raw</quote>; therefor no filtering is started (and this is not even possible as the input from the clients is not &PostScript; as pstops expects; hence no page-count other than the default <quote>1</quote>.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I get a list of available options for a given printer or a &PPD; file?</para> +<para>How do I get a list of available options for a given printer or a &PPD; file?</para> </question> <answer> -<para ->See the man page for the <command ->lpoptions</command -> command. You may investigate a &CUPS;-enabled box about any option of its available printers. There is no need to have the printer installed locally. As long as the printer is available locally (through the &CUPS; <quote ->printer browsing</quote -> feature), it will also work remote.</para> - -<para ->To query for a printers' option typing <userinput -><command ->lpoptions</command -> <option ->-p</option -> <parameter ->HitachiDDP70MicroPress</parameter -> <option ->-l</option -></userinput -> will give a long listing of all available options as read from the &PPD; file for the given Hitachi-Printer (in my case installed on remote server transmeta). Remote server <systemitem class="systemname" ->Transmeta</systemitem -> and its &CUPS; daemon as well as the localhost's &CUPS; daemon need to be up and running for this to succeed.</para> +<para>See the man page for the <command>lpoptions</command> command. You may investigate a &CUPS;-enabled box about any option of its available printers. There is no need to have the printer installed locally. As long as the printer is available locally (through the &CUPS; <quote>printer browsing</quote> feature), it will also work remote.</para> + +<para>To query for a printers' option typing <userinput><command>lpoptions</command> <option>-p</option> <parameter>HitachiDDP70MicroPress</parameter> <option>-l</option></userinput> will give a long listing of all available options as read from the &PPD; file for the given Hitachi-Printer (in my case installed on remote server transmeta). Remote server <systemitem class="systemname">Transmeta</systemitem> and its &CUPS; daemon as well as the localhost's &CUPS; daemon need to be up and running for this to succeed.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I read the listing retrieved by the <command ->lpoptions</command -> command?</para> +<para>How do I read the listing retrieved by the <command>lpoptions</command> command?</para> </question> <answer> -<para ->You know that for &PostScript; printer manufacturers it is <quote ->legal</quote -> to define their own internal names and procedures even for standard &PostScript; options. As long as the driver is able to retrieve the option from the &PPD; and show it to the user in a way that he understands it everything is OK. But what do <emphasis ->you</emphasis -> do, if you want to use some obscure printer options on the command line? How do you find out its exact syntax?</para> - -<para ->Let's take an example. Looking at Hitachi's DDP70 printer and how it implements duplex printing is revealing somehow. How do you tell how to print double sided? duplex or Duplex? Or another name altogether?.</para> - -<screen -><userinput -><command ->lpoptions</command -> <option ->-h</option -> <parameter ->transmeta</parameter -> <option ->-p</option -> <parameter ->Hitachi_DDP70_ClusterPrintingSystem</parameter -> <option ->-l</option -> | <command ->grep</command -> <parameter ->uplex</parameter -></userinput -></screen> - -<para ->This leads to the output</para> - -<screen -><computeroutput ->TR-Duplex/Duplex: False *True</computeroutput -></screen> - -<para ->This is to be interpreted like follows:</para> +<para>You know that for &PostScript; printer manufacturers it is <quote>legal</quote> to define their own internal names and procedures even for standard &PostScript; options. As long as the driver is able to retrieve the option from the &PPD; and show it to the user in a way that he understands it everything is OK. But what do <emphasis>you</emphasis> do, if you want to use some obscure printer options on the command line? How do you find out its exact syntax?</para> + +<para>Let's take an example. Looking at Hitachi's DDP70 printer and how it implements duplex printing is revealing somehow. How do you tell how to print double sided? duplex or Duplex? Or another name altogether?.</para> + +<screen><userinput><command>lpoptions</command> <option>-h</option> <parameter>transmeta</parameter> <option>-p</option> <parameter>Hitachi_DDP70_ClusterPrintingSystem</parameter> <option>-l</option> | <command>grep</command> <parameter>uplex</parameter></userinput></screen> + +<para>This leads to the output</para> + +<screen><computeroutput>TR-Duplex/Duplex: False *True</computeroutput></screen> + +<para>This is to be interpreted like follows:</para> <itemizedlist> <listitem> -<para ->The name of the investigated option is <option ->TR-Duplex</option ->;</para> +<para>The name of the investigated option is <option>TR-Duplex</option>;</para> </listitem> <listitem> -<para ->Behind the slash you see the translation of the option, as it should be shown in a &GUI; or Web interface (<quote ->Duplex</quote ->);</para> +<para>Behind the slash you see the translation of the option, as it should be shown in a &GUI; or Web interface (<quote>Duplex</quote>);</para> </listitem> <listitem> -<para ->The option may take one of the two values <parameter ->False</parameter -> or <parameter ->True</parameter ->;</para> +<para>The option may take one of the two values <parameter>False</parameter> or <parameter>True</parameter>;</para> </listitem> <listitem> -<para ->The present setting is <parameter ->True</parameter -> to be recognised by the marking with a star <literal ->*</literal ->.</para> +<para>The present setting is <parameter>True</parameter> to be recognised by the marking with a star <literal>*</literal>.</para> </listitem> </itemizedlist> -<para ->To override the present default setting (duplex) and print a job in simplex, you need to use the following command: </para> - -<screen -><userinput -><command ->lpr</command -> <option ->-P</option -> <parameter ->Hitachi_DDP70_ClusterPrintingSystem</parameter -> <option ->-o</option -> <parameter ->TR-Duplex=False</parameter -> <parameter ->/path/to/your/printjob</parameter -></userinput -></screen> +<para>To override the present default setting (duplex) and print a job in simplex, you need to use the following command: </para> + +<screen><userinput><command>lpr</command> <option>-P</option> <parameter>Hitachi_DDP70_ClusterPrintingSystem</parameter> <option>-o</option> <parameter>TR-Duplex=False</parameter> <parameter>/path/to/your/printjob</parameter></userinput></screen> </answer> </qandaentry> <qandaentry> <question> -<para ->How do I get a nicely formatted listing of available options for a given printer or &PPD;?</para> +<para>How do I get a nicely formatted listing of available options for a given printer or &PPD;?</para> </question> <answer> -<para ->Use the <command ->lphelp</command -> command which may be installed on your system locally. There is not yet a man page for <command ->lphelp</command ->.</para> - -<screen -><userinput -><command ->lphelp</command -> <parameter ->infotecP450</parameter -></userinput -></screen> - -<para ->This lists the available options for the named printer. It is nicely formatted and does explain every available option and how to use it. You can query different printers' options at once:</para> - -<screen -><userinput -><command ->lphelp</command -> <parameter ->infotec7410color</parameter -> <parameter ->DANKA_fullcolor_D2000</parameter -> <parameter ->HP_ColorLaserJet8550</parameter -></userinput -></screen> - -<para ->It also works for &PPD; files. Just specify the path to the &PPD;:</para> - -<screen -><userinput -><command ->lphelp</command -> <filename ->/home/kurt/PPDs/HP-ColorLaserJet8550.ppd</filename -></userinput -></screen> +<para>Use the <command>lphelp</command> command which may be installed on your system locally. There is not yet a man page for <command>lphelp</command>.</para> + +<screen><userinput><command>lphelp</command> <parameter>infotecP450</parameter></userinput></screen> + +<para>This lists the available options for the named printer. It is nicely formatted and does explain every available option and how to use it. You can query different printers' options at once:</para> + +<screen><userinput><command>lphelp</command> <parameter>infotec7410color</parameter> <parameter>DANKA_fullcolor_D2000</parameter> <parameter>HP_ColorLaserJet8550</parameter></userinput></screen> + +<para>It also works for &PPD; files. Just specify the path to the &PPD;:</para> + +<screen><userinput><command>lphelp</command> <filename>/home/kurt/PPDs/HP-ColorLaserJet8550.ppd</filename></userinput></screen> </answer> </qandaentry> </qandaset> </sect2> <sect2> -<title ->Solving Problems</title> +<title>Solving Problems</title> -<para ->No system is perfect. Here are some commonly seen traps people have fallen into.</para> +<para>No system is perfect. Here are some commonly seen traps people have fallen into.</para> <qandaset> <qandaentry> <question> -<para ->My printer named <quote ->3-lp-duplex</quote -> shows erratic behaviour. What's wrong?</para> +<para>My printer named <quote>3-lp-duplex</quote> shows erratic behaviour. What's wrong?</para> </question> <answer> -<para ->The printer names used in &CUPS; shall start with a letter and may contain up to 128 letters, numbers or underscores. Using dashes may lead to problems. Speaking about naming: printer names in &CUPS; are not case sensitive. So a printer named <systemitem class="resource" ->Best_of_Danka</systemitem -> will be the same as <systemitem class="resource" ->best_of_danka</systemitem -> or <systemitem class="resource" ->BEST_OF_DANKA</systemitem ->. (This is a requirement of &IPP;, which &CUPS; is fully compliant with).</para> +<para>The printer names used in &CUPS; shall start with a letter and may contain up to 128 letters, numbers or underscores. Using dashes may lead to problems. Speaking about naming: printer names in &CUPS; are not case sensitive. So a printer named <systemitem class="resource">Best_of_Danka</systemitem> will be the same as <systemitem class="resource">best_of_danka</systemitem> or <systemitem class="resource">BEST_OF_DANKA</systemitem>. (This is a requirement of &IPP;, which &CUPS; is fully compliant with).</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Why do I get <errortype ->Unable to connect to SAMBA host: Success</errortype -> with my printer shares from &Windows; accessed via Samba?</para> +<para>Why do I get <errortype>Unable to connect to SAMBA host: Success</errortype> with my printer shares from &Windows; accessed via Samba?</para> </question> <answer> -<para ->Are the rights on the remote &Windows; box set correctly for you? Are you actually allowed to print on the &Windows; shared printer?</para> +<para>Are the rights on the remote &Windows; box set correctly for you? Are you actually allowed to print on the &Windows; shared printer?</para> </answer> </qandaentry> <qandaentry> <question> -<para ->My files for printer <systemitem class="resource" ->lp</systemitem -> sometimes mysteriously disappear and two days later I am told they got printed on a printer three floors below my office. What is going on?</para> +<para>My files for printer <systemitem class="resource">lp</systemitem> sometimes mysteriously disappear and two days later I am told they got printed on a printer three floors below my office. What is going on?</para> </question> <answer> -<para ->Believe me, it is very unlikely that your printer is the only one with the name <systemitem class="resource" ->lp</systemitem ->. Maybe &CUPS; is playing a trick on you. As you might have the setting <quote ->ImplicitClasses On</quote -> activated, &CUPS; tries to stuff all printers it sees on the network into a <quote ->Class</quote -> name lp. All jobs destined to lp are sent to this class and the first available member prints it. So if you had this nice fellow (who listened closely when you raved about &CUPS; and &tdeprint;) install &CUPS; and poke around the system...get the idea?</para> - -<para ->Take my advice: choose a unique name for any network printer! (Mind you, the one on your parallel port also turns out to be a network printer for the rest of the world if you don't take care of your settings).</para> +<para>Believe me, it is very unlikely that your printer is the only one with the name <systemitem class="resource">lp</systemitem>. Maybe &CUPS; is playing a trick on you. As you might have the setting <quote>ImplicitClasses On</quote> activated, &CUPS; tries to stuff all printers it sees on the network into a <quote>Class</quote> name lp. All jobs destined to lp are sent to this class and the first available member prints it. So if you had this nice fellow (who listened closely when you raved about &CUPS; and &tdeprint;) install &CUPS; and poke around the system...get the idea?</para> + +<para>Take my advice: choose a unique name for any network printer! (Mind you, the one on your parallel port also turns out to be a network printer for the rest of the world if you don't take care of your settings).</para> </answer> </qandaentry> </qandaset> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeprint/extensions.docbook b/tde-i18n-en_GB/docs/tdebase/tdeprint/extensions.docbook index 8d1feffc7ba..19c5daf9827 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeprint/extensions.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeprint/extensions.docbook @@ -1,86 +1,53 @@ <chapter id="extensions-to-all-printsubsystems"> -<title ->&tdeprint; Extensions To All Print Subsystems</title> +<title>&tdeprint; Extensions To All Print Subsystems</title> <sect1> -<title -><quote ->Virtual</quote -> Printers</title> +<title><quote>Virtual</quote> Printers</title> <sect2> -<title ->The <quote ->Fax</quote -> Printer</title> +<title>The <quote>Fax</quote> Printer</title> -<para ->To be written</para> +<para>To be written</para> </sect2> <sect2> -<title ->The <quote ->File</quote -> Printer</title> +<title>The <quote>File</quote> Printer</title> -<para ->To be written</para> +<para>To be written</para> </sect2> <sect2> -<title ->The <quote -><acronym ->PDF</acronym -></quote -> Printer</title> +<title>The <quote><acronym>PDF</acronym></quote> Printer</title> -<para ->To be written</para> +<para>To be written</para> </sect2> </sect1> <sect1 id="external-filters"> -<title -><quote ->External</quote -> Filters</title> +<title><quote>External</quote> Filters</title> <sect2> -<title ->The <command ->enscript</command -> Filter for Text Files</title> +<title>The <command>enscript</command> Filter for Text Files</title> -<para ->To be written</para> +<para>To be written</para> </sect2> <sect2> -<title ->The <quote ->n-up</quote -> Filter for Any File</title> +<title>The <quote>n-up</quote> Filter for Any File</title> -<para ->To be written</para> +<para>To be written</para> </sect2> <sect2> -<title ->Three different <quote ->Make Pamphlet</quote -> Filters for &PostScript; Files</title> +<title>Three different <quote>Make Pamphlet</quote> Filters for &PostScript; Files</title> -<para ->To be written</para> +<para>To be written</para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeprint/external-command.docbook b/tde-i18n-en_GB/docs/tdebase/tdeprint/external-command.docbook index 40f62dde1a0..04bd961a719 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeprint/external-command.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeprint/external-command.docbook @@ -1,26 +1,20 @@ <chapter id="external-printcommand-module"> -<title ->Module For External Print Command (&Netscape;-like) </title> +<title>Module For External Print Command (&Netscape;-like) </title> -<para ->This module allows the print command to be specified completely (&Netscape;-like). An edit line is added in the print dialogue for that purpose. Can be used in many cases, for example with a self-made print program. </para> +<para>This module allows the print command to be specified completely (&Netscape;-like). An edit line is added in the print dialogue for that purpose. Can be used in many cases, for example with a self-made print program. </para> <sect1> -<title ->Overview of provided features</title> +<title>Overview of provided features</title> <itemizedlist> <listitem> -<para ->Printer management: not supported</para> +<para>Printer management: not supported</para> </listitem> <listitem> -<para ->Job management: not supported.</para> +<para>Job management: not supported.</para> </listitem> <listitem> -<para ->Print options: basic control, depending on your knowledge of the print command</para> +<para>Print options: basic control, depending on your knowledge of the print command</para> </listitem> </itemizedlist> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeprint/final-word.docbook b/tde-i18n-en_GB/docs/tdebase/tdeprint/final-word.docbook index 7fb084fd0e4..2a9fbf094ae 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeprint/final-word.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeprint/final-word.docbook @@ -1,91 +1,59 @@ <chapter id="final-word-from-author"> -<title ->Final word from the Author</title> +<title>Final word from the Author</title> <sect1 id="who-am-i"> -<title ->Who am I, what is my business? </title> +<title>Who am I, what is my business? </title> -<para ->My employer is Danka Deutschland GmbH, a leading and manufacturer-independent provider of professional and hi-speed digital printing systems, black-and-white as well as colour. Danka provides hardware, software, service, maintenance, consumables and customised solutions for the products in its portfolio. I work there as a System Engineer. Amongst the brands Danka offers are Heidelberg (formerly Kodak), Canon, &Hewlett-Packard;, Hitachi, Infotec and EfI.</para> +<para>My employer is Danka Deutschland GmbH, a leading and manufacturer-independent provider of professional and hi-speed digital printing systems, black-and-white as well as colour. Danka provides hardware, software, service, maintenance, consumables and customised solutions for the products in its portfolio. I work there as a System Engineer. Amongst the brands Danka offers are Heidelberg (formerly Kodak), Canon, &Hewlett-Packard;, Hitachi, Infotec and EfI.</para> -<para ->My acquaintance with &Linux; and the Free Software community is not too old. When I started to play around with &Linux; at the beginning of 1999, my deepest disappointment was the poor support for printing. True, I made all our machines spit out simplex prints -- but what about duplex? What about punching the output? How to make sorting work? Or stapling, cover sheets and all the other beautiful finishing options our engines offer to customers? No way -- at least for me as a non-geek!</para> +<para>My acquaintance with &Linux; and the Free Software community is not too old. When I started to play around with &Linux; at the beginning of 1999, my deepest disappointment was the poor support for printing. True, I made all our machines spit out simplex prints -- but what about duplex? What about punching the output? How to make sorting work? Or stapling, cover sheets and all the other beautiful finishing options our engines offer to customers? No way -- at least for me as a non-geek!</para> -<para ->I began a search on the Internet for a solution. Fortunately not much later, in May 1999, Mike Sweet, principal developer of &CUPS;, announced the first Beta release of this superb piece of printing software. After trying it briefly, I knew this was it!</para> +<para>I began a search on the Internet for a solution. Fortunately not much later, in May 1999, Mike Sweet, principal developer of &CUPS;, announced the first Beta release of this superb piece of printing software. After trying it briefly, I knew this was it!</para> -<para ->Next thing I attempted: to make &Linux; distributions interested in this new stuff. Believe me -- it was more than tenacious! They seemed to think they already had the best thing they could get in printing. One reason probably was that they (and many &Linux; developers) never had to think about how to best support a printer duplexer -- because one had never come near their own desks...</para> +<para>Next thing I attempted: to make &Linux; distributions interested in this new stuff. Believe me -- it was more than tenacious! They seemed to think they already had the best thing they could get in printing. One reason probably was that they (and many &Linux; developers) never had to think about how to best support a printer duplexer -- because one had never come near their own desks...</para> -<para ->Finally, my attempts to make some &Linux; print publications interested in &CUPS; <quote ->backfired</quote -> on me - one editor squeezed me into writing a series on the subject myself. And this is how some people started to give me the nickname <quote ->CUPS Evangelist</quote ->. I will not get rid of this nick anytime soon, now that even the &kde; people wedged me into their timeframe of releases. Oh, boy...</para> +<para>Finally, my attempts to make some &Linux; print publications interested in &CUPS; <quote>backfired</quote> on me - one editor squeezed me into writing a series on the subject myself. And this is how some people started to give me the nickname <quote>CUPS Evangelist</quote>. I will not get rid of this nick anytime soon, now that even the &kde; people wedged me into their timeframe of releases. Oh, boy...</para> -<para ->Anyway, &CUPS; is now making its way around the world and it might well become a triumphal one: I am a little bit proud to have supported and contributed to this from near the beginning.</para> +<para>Anyway, &CUPS; is now making its way around the world and it might well become a triumphal one: I am a little bit proud to have supported and contributed to this from near the beginning.</para> -<para ->It should encourage you: even if some more experienced &Linux; users than you are skeptical about it, and even if your programming skills are next to zero (like mine) - there are a lot of tasks and jobs and ideas, and talent that you can contribute to the Free Software community. Not least within the &kde; project... </para> +<para>It should encourage you: even if some more experienced &Linux; users than you are skeptical about it, and even if your programming skills are next to zero (like mine) - there are a lot of tasks and jobs and ideas, and talent that you can contribute to the Free Software community. Not least within the &kde; project... </para> </sect1> <sect1 id="credits"> -<title ->Credits</title> +<title>Credits</title> -<para ->I'd like to thank...</para> +<para>I'd like to thank...</para> <itemizedlist> <listitem> -<para ->Mike Sweet for developing &CUPS; in the first place</para> +<para>Mike Sweet for developing &CUPS; in the first place</para> </listitem> <listitem> -<para ->Jean-Eric Cuendet for starting <application ->kups</application -> and <application ->qtcups</application ->, the predecessors of &tdeprint;</para> +<para>Jean-Eric Cuendet for starting <application>kups</application> and <application>qtcups</application>, the predecessors of &tdeprint;</para> </listitem> <listitem> -<para ->Michael Goffioul for doing all the hard work recently</para> +<para>Michael Goffioul for doing all the hard work recently</para> </listitem> <listitem> -<para ->Martin Konold for thinking twice</para> +<para>Martin Konold for thinking twice</para> </listitem> <listitem> -<para ->Sven Guckes for teaching me a few things about the art of <quote ->survival on the terminal</quote -> (just in case &kde; is not there ;-) )</para> +<para>Sven Guckes for teaching me a few things about the art of <quote>survival on the terminal</quote> (just in case &kde; is not there ;-) )</para> </listitem> <listitem> -<para ->...too numerous others to mention who also let me snatch bits and bytes of knowledge off them</para> +<para>...too numerous others to mention who also let me snatch bits and bytes of knowledge off them</para> </listitem> <listitem> -<para ->and last, but not least: Tom Schwaller for encouraging me to get into <quote ->documentation writing</quote -></para> +<para>and last, but not least: Tom Schwaller for encouraging me to get into <quote>documentation writing</quote></para> </listitem> </itemizedlist> </sect1> <sect1 id="caveats"> -<title ->Caveats</title> +<title>Caveats</title> -<para ->&tdeprint; has been developed on a system using &CUPS; 1.1.6. &tdeprint; has been tested on other versions of &CUPS; and so far no incompatibilities are known. By the time of writing this Handbook, &CUPS; 1.1.9 is out with a few new features not yet supported by &tdeprint;. Of course you are able to access these features, but you will need to bypass &tdeprint; and use the &CUPS; command-line tools or edit configuration files manually. &tdeprint;'s development will go on and this Handbook strives to always be the best available user documentation resource for it.</para> +<para>&tdeprint; has been developed on a system using &CUPS; 1.1.6. &tdeprint; has been tested on other versions of &CUPS; and so far no incompatibilities are known. By the time of writing this Handbook, &CUPS; 1.1.9 is out with a few new features not yet supported by &tdeprint;. Of course you are able to access these features, but you will need to bypass &tdeprint; and use the &CUPS; command-line tools or edit configuration files manually. &tdeprint;'s development will go on and this Handbook strives to always be the best available user documentation resource for it.</para> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeprint/getting-started.docbook b/tde-i18n-en_GB/docs/tdebase/tdeprint/getting-started.docbook index 481237028fa..ad6b8bfd8ff 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeprint/getting-started.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeprint/getting-started.docbook @@ -1,169 +1,80 @@ <chapter id="getting-started"> -<title ->Getting Started</title> +<title>Getting Started</title> -<para ->This chapter of the &tdeprint; Handbook will walk you through most of the configuration or selection options of &tdeprint;. It will mainly deal with &CUPS; in this version, as the author is most familiar with it, and also because &tdeprint; started off with supporting &CUPS; best. Later versions of the &tdeprint; software and editions of this handbook will support and explore other printing systems more closely.</para> +<para>This chapter of the &tdeprint; Handbook will walk you through most of the configuration or selection options of &tdeprint;. It will mainly deal with &CUPS; in this version, as the author is most familiar with it, and also because &tdeprint; started off with supporting &CUPS; best. Later versions of the &tdeprint; software and editions of this handbook will support and explore other printing systems more closely.</para> <sect1 id="selecting-your-print-subsystem"> -<title ->Selecting Your Print Subsystem</title> - -<para ->You need to define your print subsystem, before you are able to install any printer with the &tdeprint; framework. There are two areas where you can define this: either in &kcontrol; (The <guilabel ->Printing Manager</guilabel -> section), or directly and <quote ->on the fly</quote -> from the print dialogue.</para> - -<para ->Navigate to <menuchoice -><guimenu ->TDE Menu</guimenu -> <guisubmenu ->Preferences</guisubmenu -> <guisubmenu ->System</guisubmenu -> <guimenuitem ->Printing Manager</guimenuitem -></menuchoice ->. At the bottom you can see a button that lets you select which printing subsystem you want to use. In &kde; 2.2 you can choose from the following alternatives:</para> +<title>Selecting Your Print Subsystem</title> + +<para>You need to define your print subsystem, before you are able to install any printer with the &tdeprint; framework. There are two areas where you can define this: either in &kcontrol; (The <guilabel>Printing Manager</guilabel> section), or directly and <quote>on the fly</quote> from the print dialogue.</para> + +<para>Navigate to <menuchoice><guimenu>TDE Menu</guimenu> <guisubmenu>Preferences</guisubmenu> <guisubmenu>System</guisubmenu> <guimenuitem>Printing Manager</guimenuitem></menuchoice>. At the bottom you can see a button that lets you select which printing subsystem you want to use. In &kde; 2.2 you can choose from the following alternatives:</para> <itemizedlist> <listitem> -<para ->&CUPS; (Common &UNIX; Printing System)</para> +<para>&CUPS; (Common &UNIX; Printing System)</para> </listitem> <listitem> -<para ->Print through an external program (generic)</para> +<para>Print through an external program (generic)</para> </listitem> <listitem> -<para -><acronym ->LPR</acronym -> (Standard <acronym ->BSD</acronym -> Print System)</para> +<para><acronym>LPR</acronym> (Standard <acronym>BSD</acronym> Print System)</para> </listitem> <listitem> -<para ->Generic &UNIX; <acronym ->LPD</acronym -> print system (the default)</para> +<para>Generic &UNIX; <acronym>LPD</acronym> print system (the default)</para> </listitem> <listitem> -<para -><acronym ->RLPR</acronym -> environment (print to remote <acronym ->LPD</acronym -> servers from the command line)</para> +<para><acronym>RLPR</acronym> environment (print to remote <acronym>LPD</acronym> servers from the command line)</para> </listitem> </itemizedlist> -<para ->Of course, the chosen system must be installed, and up and running on your box prior to your selection, or before it takes effect. </para> +<para>Of course, the chosen system must be installed, and up and running on your box prior to your selection, or before it takes effect. </para> -<para ->On it's first startup, &tdeprint; will try an autodetection. This only works for:</para> +<para>On it's first startup, &tdeprint; will try an autodetection. This only works for:</para> <itemizedlist> <listitem> -<para ->&CUPS;, as it is checking first for a running &CUPS; daemon</para> +<para>&CUPS;, as it is checking first for a running &CUPS; daemon</para> </listitem> <listitem> -<para -><acronym ->LPD</acronym ->, as it is checking for a running <acronym ->LPD</acronym -> daemon, plus a <filename ->printcap</filename -> file.</para> +<para><acronym>LPD</acronym>, as it is checking for a running <acronym>LPD</acronym> daemon, plus a <filename>printcap</filename> file.</para> </listitem> </itemizedlist> <!-- <para> Go to System->XY->ABC. Now you can choose from the following alternatives: -</para ->--> +</para>--> -<para ->The system you choose must be installed on your system prior to your selection. The author's personal recommendation is &CUPS;.</para> +<para>The system you choose must be installed on your system prior to your selection. The author's personal recommendation is &CUPS;.</para> -<para ->Once autodetected, chosen, or changed, the active print subsystem will take effect for all &kde; applications. Different users may have different print subsystems in use, if those do exist on the computer and are compliant with each other. Their settings are stored in the <filename ->tdeprintrc</filename ->. This file is unique to every user, and is normally installed in <filename ->$<envar ->HOME</envar ->/.trinity/share/config/tdeprintrc</filename ->.</para> +<para>Once autodetected, chosen, or changed, the active print subsystem will take effect for all &kde; applications. Different users may have different print subsystems in use, if those do exist on the computer and are compliant with each other. Their settings are stored in the <filename>tdeprintrc</filename>. This file is unique to every user, and is normally installed in <filename>$<envar>HOME</envar>/.trinity/share/config/tdeprintrc</filename>.</para> <warning> -<para ->This file is not intended to be directly editable, and all available options can be set from the &tdeprint; &GUI;.</para> +<para>This file is not intended to be directly editable, and all available options can be set from the &tdeprint; &GUI;.</para> </warning> -<para ->You may even select a different printer subsystem, on the fly, from the &kprinter; dialogue box.</para> +<para>You may even select a different printer subsystem, on the fly, from the &kprinter; dialogue box.</para> </sect1> <sect1 id="working-with-printing-manger"> -<title ->Working with the Printing Manager</title> - -<para ->Once you have chosen your preferred and installed print subsystem, you are ready to investigate, configure administer and work with this system through the &tdeprint; framework.</para> - -<para ->Navigate to <menuchoice -><guimenu ->TDE Menu</guimenu -> <guisubmenu ->Preferences</guisubmenu -> <guisubmenu ->System</guisubmenu -> <guimenuitem ->Printing Manager</guimenuitem -></menuchoice ->. In the right part of the window you will see at least 4 printers predefined. These are the virtual or special purpose printers, explained in section . You will probably see a toolbar with 13 icons at the top of the window, and at least 4 tabs in the lower half of the window, labelled <guilabel ->Information</guilabel ->, <guilabel ->Jobs</guilabel ->, <guilabel ->Properties</guilabel -> and <guilabel ->Instances</guilabel ->.</para> +<title>Working with the Printing Manager</title> + +<para>Once you have chosen your preferred and installed print subsystem, you are ready to investigate, configure administer and work with this system through the &tdeprint; framework.</para> + +<para>Navigate to <menuchoice><guimenu>TDE Menu</guimenu> <guisubmenu>Preferences</guisubmenu> <guisubmenu>System</guisubmenu> <guimenuitem>Printing Manager</guimenuitem></menuchoice>. In the right part of the window you will see at least 4 printers predefined. These are the virtual or special purpose printers, explained in section . You will probably see a toolbar with 13 icons at the top of the window, and at least 4 tabs in the lower half of the window, labelled <guilabel>Information</guilabel>, <guilabel>Jobs</guilabel>, <guilabel>Properties</guilabel> and <guilabel>Instances</guilabel>.</para> <!-- Not needed: the default view is as described, this can be mentioned --> -<!-- elsewhere <para ->If you start the <guilabel ->Printing --> -<!-- Manager</guilabel -> module for the first time, you may be missing --> -<!-- Icons or tabs. <mousebutton ->Right</mousebutton ->-clicking the mouse --> +<!-- elsewhere <para>If you start the <guilabel>Printing --> +<!-- Manager</guilabel> module for the first time, you may be missing --> +<!-- Icons or tabs. <mousebutton>Right</mousebutton>-clicking the mouse --> <!-- on the white background of the right part of the window opens a --> <!-- Menu to select your viewing preferences. To get the same view as in --> -<!-- most screenshots, select: <guimenuitem ->View Toolbar</guimenuitem -> --> -<!-- and <guimenuitem ->View Printer Information</guimenuitem -> and --> -<!-- <guimenuitem ->View Icons</guimenuitem -> and <guimenuitem ->Orientation --> -<!-- Vertical</guimenuitem ->. Moving the mouse over one Button and --> +<!-- most screenshots, select: <guimenuitem>View Toolbar</guimenuitem> --> +<!-- and <guimenuitem>View Printer Information</guimenuitem> and --> +<!-- <guimenuitem>View Icons</guimenuitem> and <guimenuitem>Orientation --> +<!-- Vertical</guimenuitem>. Moving the mouse over one Button and --> <!-- waiting a second gives you a tooltip hint about its functions. --> <!-- diff --git a/tde-i18n-en_GB/docs/tdebase/tdeprint/highlights.docbook b/tde-i18n-en_GB/docs/tdebase/tdeprint/highlights.docbook index 9f2c2e1fae9..09c3ec3c6c4 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeprint/highlights.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeprint/highlights.docbook @@ -1,62 +1,28 @@ <chapter id="tdeprint-highlights"> -<title ->&tdeprint;'s Highlights</title> +<title>&tdeprint;'s Highlights</title> -<para ->The new &tdeprint; system includes more than one highlight. Having worked in an environment in the past that is not exactly sophisticated, as far as printing is concerned, take a look at some of the benefits that come with &tdeprint;</para> +<para>The new &tdeprint; system includes more than one highlight. Having worked in an environment in the past that is not exactly sophisticated, as far as printing is concerned, take a look at some of the benefits that come with &tdeprint;</para> <sect1 id="add-printer-wizard"> -<title ->The <quote ->Add Printer</quote -> Wizard</title> - -<para ->&tdeprint; has an <quote ->Add Printer Wizard</quote ->. The Add Printer Wizard helps you with adding and configuring a new printer. Of course, you may do this manually as well.</para> - -<para ->&tdeprint; helps you <quote ->discover</quote -> printers. It is able to scan the environment for available devices and queues. This works for network connections using <acronym ->TCP</acronym -> (AppSocket, <acronym ->aka</acronym -> &HP; <trademark class="registered" ->JetDirect</trademark ->, or <acronym ->IPP</acronym ->) or <acronym ->SMB</acronym ->/Samba (<quote ->shared</quote -> &Windows;) printers and partially for directly attached printers over parallel, serial, or <acronym ->USB</acronym -> connections.</para> +<title>The <quote>Add Printer</quote> Wizard</title> + +<para>&tdeprint; has an <quote>Add Printer Wizard</quote>. The Add Printer Wizard helps you with adding and configuring a new printer. Of course, you may do this manually as well.</para> + +<para>&tdeprint; helps you <quote>discover</quote> printers. It is able to scan the environment for available devices and queues. This works for network connections using <acronym>TCP</acronym> (AppSocket, <acronym>aka</acronym> &HP; <trademark class="registered">JetDirect</trademark>, or <acronym>IPP</acronym>) or <acronym>SMB</acronym>/Samba (<quote>shared</quote> &Windows;) printers and partially for directly attached printers over parallel, serial, or <acronym>USB</acronym> connections.</para> <screenshot> -<screeninfo ->A screenshot of the new <quote ->Add Printer Wizard</quote -></screeninfo> +<screeninfo>A screenshot of the new <quote>Add Printer Wizard</quote></screeninfo> <mediaobject> <imageobject> <imagedata fileref="cupsaddprinterwizard1.png" format="PNG"/> </imageobject> <textobject> -<phrase ->Here's a screenshot of the <quote ->Add Printer Wizard</quote -> (this one is not very exciting yet; but...)</phrase> +<phrase>Here's a screenshot of the <quote>Add Printer Wizard</quote> (this one is not very exciting yet; but...)</phrase> </textobject> </mediaobject> </screenshot> -<para ->The wizard makes the installation and handling of the drivers <quote ->a snap</quote ->. Selecting, configuring and testing should be easy as never before on any &Linux;-like system.</para> +<para>The wizard makes the installation and handling of the drivers <quote>a snap</quote>. Selecting, configuring and testing should be easy as never before on any &Linux;-like system.</para> <!-- LW: needs some info where to find it, or a pointer to where in this --> <!-- doc that is covered --> @@ -64,82 +30,49 @@ </sect1> <sect1 id="print-job-control"> -<title ->Full Print Job Control</title> +<title>Full Print Job Control</title> -<para ->The Print Job Viewer is automatically started by &kprinter;. It may be docked into the &kde; panel (in the system tray). The Print Job Viewer allows full job management, if supported by the print subsystem.</para> +<para>The Print Job Viewer is automatically started by &kprinter;. It may be docked into the &kde; panel (in the system tray). The Print Job Viewer allows full job management, if supported by the print subsystem.</para> -<para ->You can:</para> +<para>You can:</para> <itemizedlist> <listitem> -<para ->Hold and release jobs,</para> +<para>Hold and release jobs,</para> </listitem> <listitem> -<para ->Move pending jobs to another printer,</para> +<para>Move pending jobs to another printer,</para> </listitem> <listitem> -<para ->Cancel pending or processing jobs.</para> +<para>Cancel pending or processing jobs.</para> </listitem> </itemizedlist> -<para ->A screenshot of the &tdeprint; PrintJob Viewer shows the information you get: Job-ID, target printer, job name, job owner, job status and job size. In the next &tdeprint; release you will also see information about the number of pages (as &CUPS; calculates it; see chapter on page accounting for more information about its merits and limitations).</para> +<para>A screenshot of the &tdeprint; PrintJob Viewer shows the information you get: Job-ID, target printer, job name, job owner, job status and job size. In the next &tdeprint; release you will also see information about the number of pages (as &CUPS; calculates it; see chapter on page accounting for more information about its merits and limitations).</para> <screenshot> -<screeninfo ->A screenshot of the &tdeprint; PrintJob Viewer</screeninfo> +<screeninfo>A screenshot of the &tdeprint; PrintJob Viewer</screeninfo> <mediaobject> <imageobject> <imagedata fileref="tdeprint-jobviewer.png" format="PNG"/> </imageobject> <textobject> -<phrase ->Here's a screenshot of the &tdeprint; PrintJob Viewer.</phrase> +<phrase>Here's a screenshot of the &tdeprint; PrintJob Viewer.</phrase> </textobject> -<caption -><para ->A screenshot of the &tdeprint; PrintJob Viewer.</para -></caption> +<caption><para>A screenshot of the &tdeprint; PrintJob Viewer.</para></caption> </mediaobject> </screenshot> -<para ->An alternative way to looking at the same information (and having the same amount of control is through the <inlinemediaobject -><imageobject -> <imagedata fileref="kcontrol-icon.png" format="PNG"/></imageobject -> </inlinemediaobject -> &kcontrolcenter; selecting <menuchoice -><guilabel ->System</guilabel -><guilabel ->Printing Manager</guilabel -></menuchoice ->. If you don't see the <guilabel ->Printer Information</guilabel ->, <mousebutton ->right</mousebutton -> click on the window background and select <guilabel ->View Printer Information</guilabel ->. Then go to the <guilabel ->Jobs</guilabel -> tab to see this:</para> +<para>An alternative way to looking at the same information (and having the same amount of control is through the <inlinemediaobject><imageobject> <imagedata fileref="kcontrol-icon.png" format="PNG"/></imageobject> </inlinemediaobject> &kcontrolcenter; selecting <menuchoice><guilabel>System</guilabel><guilabel>Printing Manager</guilabel></menuchoice>. If you don't see the <guilabel>Printer Information</guilabel>, <mousebutton>right</mousebutton> click on the window background and select <guilabel>View Printer Information</guilabel>. Then go to the <guilabel>Jobs</guilabel> tab to see this:</para> <screenshot> -<screeninfo -></screeninfo> +<screeninfo></screeninfo> <mediaobject> <imageobject> <imagedata fileref="kcontrolcenter-printmanager-jobcontrol-2.png" format="PNG"/> </imageobject> <textobject> -<phrase ->Here's a screenshot of the &tdeprint; PrintJob Viewer.</phrase> +<phrase>Here's a screenshot of the &tdeprint; PrintJob Viewer.</phrase> </textobject> </mediaobject> </screenshot> @@ -147,269 +80,140 @@ </sect1> <sect1 id="modules-for-different-subsystems"> -<title ->Modules for different print subsystems</title> +<title>Modules for different print subsystems</title> -<para ->&tdeprint; uses different modules to realise the interface to the possible print subsystems. Not all the modules are yet developed fully, but you will have basic printing functionality with:</para> +<para>&tdeprint; uses different modules to realise the interface to the possible print subsystems. Not all the modules are yet developed fully, but you will have basic printing functionality with:</para> <itemizedlist> <listitem> -<para -><acronym ->LPD</acronym -> (<acronym ->BSD</acronym -> style)</para> +<para><acronym>LPD</acronym> (<acronym>BSD</acronym> style)</para> </listitem> <listitem> -<para -><acronym ->LPRng</acronym -> (&RedHat;, if you just use it's <acronym ->BSD</acronym -> style subset),</para> +<para><acronym>LPRng</acronym> (&RedHat;, if you just use it's <acronym>BSD</acronym> style subset),</para> </listitem> <listitem> -<para -><acronym ->RLPR</acronym -> (a command-line <acronym ->LPR</acronym -> utility, which doesn't need a <filename ->printcap</filename -> file.</para> +<para><acronym>RLPR</acronym> (a command-line <acronym>LPR</acronym> utility, which doesn't need a <filename>printcap</filename> file.</para> </listitem> <listitem> -<para -><quote ->external</quote -> print commands (&Netscape; like).</para> +<para><quote>external</quote> print commands (&Netscape; like).</para> </listitem> </itemizedlist> -<para ->Most importantly, full support for &CUPS; is already there. Modules for other print subsystems, such as <acronym ->PLP</acronym ->, <acronym ->PPR</acronym -> and <acronym ->PDQ</acronym -> may be available later.</para> +<para>Most importantly, full support for &CUPS; is already there. Modules for other print subsystems, such as <acronym>PLP</acronym>, <acronym>PPR</acronym> and <acronym>PDQ</acronym> may be available later.</para> -<para ->&tdeprint; makes &kde; much more flexible. It gives freedom of choice to &kde; 2.2 users. To use different available print subsystems, these must, of course, be installed independently from &kde;. In former versions, users were stuck with the old <acronym ->LPD</acronym -> style print subsystems. Now they can even use &CUPS;. In the future, there will be easy integration of new subsystems, as they appear on the scene.</para> +<para>&tdeprint; makes &kde; much more flexible. It gives freedom of choice to &kde; 2.2 users. To use different available print subsystems, these must, of course, be installed independently from &kde;. In former versions, users were stuck with the old <acronym>LPD</acronym> style print subsystems. Now they can even use &CUPS;. In the future, there will be easy integration of new subsystems, as they appear on the scene.</para> </sect1> <sect1 id="tdeprint-goodies"> -<title ->More &tdeprint; <quote ->Goodies</quote -></title> -<subtitle ->Benefitting all Print SubSystems.</subtitle> - -<para ->Some specific features of &tdeprint; depend on the chosen print subsystem. This dependency might exist because those features are only implemented there; remember, &tdeprint; is an intermediate layer between &kde; applications, and the print subsystem, but it's no replacement for any print subsystem by itself. Such dependency may exist for another reason: that &tdeprint; has not yet implemented an interface to all the features of all the subsystems.</para> - -<para ->Other features include benefits from &tdeprint; that are independent of the chosen print subsystem, and are available with all of them. At present there are <quote ->special</quote -> or <quote ->virtual</quote -> printers, and some generic <quote ->pre-filters</quote ->.</para> +<title>More &tdeprint; <quote>Goodies</quote></title> +<subtitle>Benefitting all Print SubSystems.</subtitle> + +<para>Some specific features of &tdeprint; depend on the chosen print subsystem. This dependency might exist because those features are only implemented there; remember, &tdeprint; is an intermediate layer between &kde; applications, and the print subsystem, but it's no replacement for any print subsystem by itself. Such dependency may exist for another reason: that &tdeprint; has not yet implemented an interface to all the features of all the subsystems.</para> + +<para>Other features include benefits from &tdeprint; that are independent of the chosen print subsystem, and are available with all of them. At present there are <quote>special</quote> or <quote>virtual</quote> printers, and some generic <quote>pre-filters</quote>.</para> <variablelist> <varlistentry> -<term -><guilabel ->Print Preview</guilabel -></term> +<term><guilabel>Print Preview</guilabel></term> <listitem> -<para ->From the Print Dialogue, you can select to look at a preview. For this, the print file is passed through filters which make it suitable for displaying on screen using &kghostview;.</para> +<para>From the Print Dialogue, you can select to look at a preview. For this, the print file is passed through filters which make it suitable for displaying on screen using &kghostview;.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Special Printers</guilabel -></term> +<term><guilabel>Special Printers</guilabel></term> <listitem> -<para ->Amongst these additional &tdeprint; features are a few <quote ->special</quote -> or <quote ->virtual</quote -> printers:</para> +<para>Amongst these additional &tdeprint; features are a few <quote>special</quote> or <quote>virtual</quote> printers:</para> -<para ->These special printers may:</para> +<para>These special printers may:</para> <variablelist> <varlistentry> -<term -><guilabel ->Print to PDF</guilabel -></term> +<term><guilabel>Print to PDF</guilabel></term> <listitem> -<para ->Convert your document into a <acronym ->PDF</acronym -> file with the help of an external program.</para> +<para>Convert your document into a <acronym>PDF</acronym> file with the help of an external program.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Print to email</guilabel -></term> +<term><guilabel>Print to email</guilabel></term> <listitem> -<para ->Send your document as an email attached <acronym ->PDF</acronym -> file.</para> +<para>Send your document as an email attached <acronym>PDF</acronym> file.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Print to PS file</guilabel -></term> +<term><guilabel>Print to PS file</guilabel></term> <listitem> -<para ->Save your document as a &PostScript; file.</para> +<para>Save your document as a &PostScript; file.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Print to Fax</guilabel -></term> +<term><guilabel>Print to Fax</guilabel></term> <listitem> -<para ->Send it through an available backend, such as <application ->Hylafax</application -> as a fax.</para> +<para>Send it through an available backend, such as <application>Hylafax</application> as a fax.</para> </listitem> </varlistentry> </variablelist> -<para ->These <quote ->special</quote -> printers appear in the user print dialogue just like <quote ->normal</quote -> printers. They are entirely configurable on a per-user basis.</para> +<para>These <quote>special</quote> printers appear in the user print dialogue just like <quote>normal</quote> printers. They are entirely configurable on a per-user basis.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Generic Pre-Filtering</guilabel -></term> +<term><guilabel>Generic Pre-Filtering</guilabel></term> <listitem> -<para ->&tdeprint; provides you with a framework to define and configure your own <quote ->pre-filters</quote ->. These pre-filters may take effect <emphasis ->before</emphasis -> they are passed to your print subsystem for further processing, but <emphasis ->after</emphasis -> the (&PostScript;, plain text or other) print files have been generated by your application.</para> - -<para ->There are a few useful filters already predefined. These are:</para> +<para>&tdeprint; provides you with a framework to define and configure your own <quote>pre-filters</quote>. These pre-filters may take effect <emphasis>before</emphasis> they are passed to your print subsystem for further processing, but <emphasis>after</emphasis> the (&PostScript;, plain text or other) print files have been generated by your application.</para> + +<para>There are a few useful filters already predefined. These are:</para> <itemizedlist> <listitem> -<para ->The <quote ->multiple pages per sheet</quote -> filter,</para> +<para>The <quote>multiple pages per sheet</quote> filter,</para> </listitem> <listitem> -<para ->the <quote ->enscript</quote -> text filter,</para> +<para>the <quote>enscript</quote> text filter,</para> </listitem> <listitem> -<para ->and three filters to help print pamphlets.</para> +<para>and three filters to help print pamphlets.</para> </listitem> </itemizedlist> -<para ->You may create your own filters based on any third party program that is able to process &PostScript;, plain text or image files, and output any one of those formats.</para> +<para>You may create your own filters based on any third party program that is able to process &PostScript;, plain text or image files, and output any one of those formats.</para> -<para ->These filters are configured through <acronym ->XML</acronym -> files. This makes an extension of the concept very easy for experienced developers, but end-user configuration is also done through an intuitive graphical user interface. So, fear not, you don't need to learn <acronym ->XML</acronym -> because of &tdeprint;!</para> +<para>These filters are configured through <acronym>XML</acronym> files. This makes an extension of the concept very easy for experienced developers, but end-user configuration is also done through an intuitive graphical user interface. So, fear not, you don't need to learn <acronym>XML</acronym> because of &tdeprint;!</para> <variablelist> <varlistentry> -<term -><guilabel ->Multiple Pages Per Sheet Filter</guilabel -></term> +<term><guilabel>Multiple Pages Per Sheet Filter</guilabel></term> <listitem> -<para ->This is a predefined filter that installs with &tdeprint;. It allows you to create a modified &PostScript; output, from &PostScript; input, that prints 1, 2, or 4 logical pages on a single sheet of paper.</para> +<para>This is a predefined filter that installs with &tdeprint;. It allows you to create a modified &PostScript; output, from &PostScript; input, that prints 1, 2, or 4 logical pages on a single sheet of paper.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Enscript Text Filter</guilabel -></term> +<term><guilabel>Enscript Text Filter</guilabel></term> <listitem> -<para ->This is a predefined filter that installs with &tdeprint;. It allows you to create &PostScript; output from any text file input, that includes syntax highlighting for program listings, pretty-printing, and nice configurable page frames and headers.</para> +<para>This is a predefined filter that installs with &tdeprint;. It allows you to create &PostScript; output from any text file input, that includes syntax highlighting for program listings, pretty-printing, and nice configurable page frames and headers.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Pamphlet Printing Filters</guilabel -></term> +<term><guilabel>Pamphlet Printing Filters</guilabel></term> <listitem> -<para ->If your printer is able to produce duplex output, using either one-pass or two-pass technology, you may be able to use one, or a combination, of the <quote ->pamphlet</quote -> filters.</para> - -<para ->For duplexing printers, make sure you use the duplex option that <quote ->turns</quote -> the output along the short paper edge. Folding the printed paper along the middle turns your document into a nice pamphlet.</para> - -<para ->If you are stuck with using a simplex-only device, you can do the same, using two different filters and a few additional steps.</para> - -<para ->Depending on your model, first use the filter for printing the <quote ->odd</quote -> pages, then insert the paper in the correct order back into the paper tray to get the even pages printed on the reverse side. These can then be folded to make a pamphlet.</para> +<para>If your printer is able to produce duplex output, using either one-pass or two-pass technology, you may be able to use one, or a combination, of the <quote>pamphlet</quote> filters.</para> + +<para>For duplexing printers, make sure you use the duplex option that <quote>turns</quote> the output along the short paper edge. Folding the printed paper along the middle turns your document into a nice pamphlet.</para> + +<para>If you are stuck with using a simplex-only device, you can do the same, using two different filters and a few additional steps.</para> + +<para>Depending on your model, first use the filter for printing the <quote>odd</quote> pages, then insert the paper in the correct order back into the paper tray to get the even pages printed on the reverse side. These can then be folded to make a pamphlet.</para> </listitem> </varlistentry> @@ -420,276 +224,101 @@ </variablelist> </sect1> <sect1 id="cups-plugin"> -<title ->&CUPS; Support: the Most Important Module in &tdeprint;</title> - -<para ->&tdeprint; contains a module for &CUPS;. &CUPS;, the <quote ->Common &UNIX; Printing System</quote -> (<ulink url="http://www.cups.org" ->http://www.cups.org/</ulink ->), is the most advanced, powerful and flexible of all print subsystems on &UNIX; and other &UNIX;-like operating systems. It is still quite new on the horizon, but is based on <acronym ->IPP</acronym ->, the Internet Printing Protocol, the newly emerging standard for the future of network printing. &CUPS; is clearly the print system of choice for Michael Goffioul, the principal &tdeprint; developer.</para> - -<para ->Experienced &kde; users may already be familiar with Michael's utilities <application ->qtcups</application -> and <application ->kups</application -> (co-developed with Jean-Eric Cuendet). These were, up until now, the graphical &GUI; front ends for &CUPS; with a strong relation to &kde;.</para> +<title>&CUPS; Support: the Most Important Module in &tdeprint;</title> + +<para>&tdeprint; contains a module for &CUPS;. &CUPS;, the <quote>Common &UNIX; Printing System</quote> (<ulink url="http://www.cups.org">http://www.cups.org/</ulink>), is the most advanced, powerful and flexible of all print subsystems on &UNIX; and other &UNIX;-like operating systems. It is still quite new on the horizon, but is based on <acronym>IPP</acronym>, the Internet Printing Protocol, the newly emerging standard for the future of network printing. &CUPS; is clearly the print system of choice for Michael Goffioul, the principal &tdeprint; developer.</para> + +<para>Experienced &kde; users may already be familiar with Michael's utilities <application>qtcups</application> and <application>kups</application> (co-developed with Jean-Eric Cuendet). These were, up until now, the graphical &GUI; front ends for &CUPS; with a strong relation to &kde;.</para> <sect2> -<title -><application ->qtcups</application -> and <application ->kups</application -> — The Predecessors</title> - -<para ->Both utilities are probably still widely used. For those not familiar with them, here are brief explanations.</para> - -<para -><application ->qtcups</application -> was a graphical front end for the <command ->lp</command -> or <command ->lpr</command -> print commands as installed by &CUPS;. Using <application ->qtcups</application -> opened a dialogue. This dialogue let you comfortably select your printer and the print job options. <application ->qtcups</application -> worked from the command line, or from within applications, when the application in question had a configurable print command.</para> - -<para -><application ->kups</application -> was a graphical wrapper to do the administration tasks for your &CUPS; server, and the &CUPS; daemon at the heart of it. You could add, delete, modify, configure, start, and stop printers. You could cancel, delete, move, stop and restart print jobs, and you could change the settings of the daemon, start, stop, and restart it.</para> +<title><application>qtcups</application> and <application>kups</application> — The Predecessors</title> + +<para>Both utilities are probably still widely used. For those not familiar with them, here are brief explanations.</para> + +<para><application>qtcups</application> was a graphical front end for the <command>lp</command> or <command>lpr</command> print commands as installed by &CUPS;. Using <application>qtcups</application> opened a dialogue. This dialogue let you comfortably select your printer and the print job options. <application>qtcups</application> worked from the command line, or from within applications, when the application in question had a configurable print command.</para> + +<para><application>kups</application> was a graphical wrapper to do the administration tasks for your &CUPS; server, and the &CUPS; daemon at the heart of it. You could add, delete, modify, configure, start, and stop printers. You could cancel, delete, move, stop and restart print jobs, and you could change the settings of the daemon, start, stop, and restart it.</para> </sect2> <sect2> -<title ->&tdeprint; — The Heir</title> - -<para ->The &CUPS; Module in &tdeprint; now contains all (and more) functions that were provided by <application ->qtcups</application -> and <application ->kups</application -> in former &kde; versions.</para> - -<para ->Instead of <command ->qtcups</command -> you can now use the <command ->kprinter</command -> command. And in place of <command ->kups</command -> you will probably use <command ->tdecmshell printmgr</command -> from now on. </para> - -<para ->The &tdeprint; module for &CUPS; also lets you fully administer the print subsystem, just like <application ->kups</application -> did before. It can start, stop and configure your &CUPS; daemon. It can also start, stop, add and delete <quote ->printers</quote -> (&ie; printer queues) and printer <quote ->instances</quote ->. Printer instances are printer queues that point to the same physical output device but with a different default setting of print options.</para> +<title>&tdeprint; — The Heir</title> + +<para>The &CUPS; Module in &tdeprint; now contains all (and more) functions that were provided by <application>qtcups</application> and <application>kups</application> in former &kde; versions.</para> + +<para>Instead of <command>qtcups</command> you can now use the <command>kprinter</command> command. And in place of <command>kups</command> you will probably use <command>tdecmshell printmgr</command> from now on. </para> + +<para>The &tdeprint; module for &CUPS; also lets you fully administer the print subsystem, just like <application>kups</application> did before. It can start, stop and configure your &CUPS; daemon. It can also start, stop, add and delete <quote>printers</quote> (&ie; printer queues) and printer <quote>instances</quote>. Printer instances are printer queues that point to the same physical output device but with a different default setting of print options.</para> </sect2> <sect2> -<title ->&kprinter; — Graphical Print Command</title> - -<para ->&tdeprint;'s &CUPS; module gives you access to a <quote ->graphical print command</quote ->, like <application ->qtcups</application -> did before.</para> - -<para ->Use &kprinter; in any application, even a non-&kde; application, that lets you configure your print command. Examples of these are &Netscape; and <application ->StarOffice</application ->, but <emphasis ->not</emphasis -> most pre-&kde; 2.2 programs.</para> - -<para ->A screenshot how to use the new <command ->kprinter</command -> print command instead of the old-fashioned <command ->lpr</command ->... Of course you need to have <command ->kprinter</command -> in your $<envar ->PATH</envar ->, or give the full path in the dialogue; ⪚ <userinput -><filename ->/opt/kde/bin/kprinter</filename -></userinput ->. &Netscape; will remember this and with further print jobs you will get the <command ->kprinter</command -> dialogue to configure your printouts.</para> +<title>&kprinter; — Graphical Print Command</title> + +<para>&tdeprint;'s &CUPS; module gives you access to a <quote>graphical print command</quote>, like <application>qtcups</application> did before.</para> + +<para>Use &kprinter; in any application, even a non-&kde; application, that lets you configure your print command. Examples of these are &Netscape; and <application>StarOffice</application>, but <emphasis>not</emphasis> most pre-&kde; 2.2 programs.</para> + +<para>A screenshot how to use the new <command>kprinter</command> print command instead of the old-fashioned <command>lpr</command>... Of course you need to have <command>kprinter</command> in your $<envar>PATH</envar>, or give the full path in the dialogue; ⪚ <userinput><filename>/opt/kde/bin/kprinter</filename></userinput>. &Netscape; will remember this and with further print jobs you will get the <command>kprinter</command> dialogue to configure your printouts.</para> <screenshot> -<screeninfo ->A screenshot of the <command ->kprinter</command -> print command in action.</screeninfo> +<screeninfo>A screenshot of the <command>kprinter</command> print command in action.</screeninfo> <mediaobject> <imageobject> <imagedata fileref="kprinter-as-netscape-printcommand.png" format="PNG"/> </imageobject> <textobject> -<phrase ->Here's a screenshot showing how to use the new <command ->kprinter</command -> print command instead of the old-fashioned <command ->lp</command -> or <command ->lpr</command -> in &Netscape;.</phrase> +<phrase>Here's a screenshot showing how to use the new <command>kprinter</command> print command instead of the old-fashioned <command>lp</command> or <command>lpr</command> in &Netscape;.</phrase> </textobject> </mediaobject> </screenshot> -<para ->You can also use <command ->&kprinter;</command -> from the command line and see the resulting dialogue box pop up:</para> +<para>You can also use <command>&kprinter;</command> from the command line and see the resulting dialogue box pop up:</para> <screenshot> -<screeninfo ->Screenshot of the <command ->kprinter</command -> command</screeninfo> +<screeninfo>Screenshot of the <command>kprinter</command> command</screeninfo> <mediaobject> <imageobject> <imagedata fileref="kprinter.png" format="PNG"/></imageobject> <textobject> -<phrase ->Screenshot showing use of the <command ->kprinter</command -> command from the command line.</phrase -></textobject> +<phrase>Screenshot showing use of the <command>kprinter</command> command from the command line.</phrase></textobject> </mediaobject> </screenshot> -<note -><para ->Just make sure you give at least the file to be printed from the command line as well: <userinput -><command ->kprinter</command -> <option ->/usr/share/doc/packages/cups/sam.pdf</option -></userinput ->. This will hand over the &CUPS; Software Administrator Manual to the <command ->kprinter</command -> dialogue, which will then pop up with the default printer pre-selected.</para> - -<para ->To pre-select a specific printer from the command line, use the <option ->-d</option -> option, ⪚: <userinput -><command ->kprinter</command -> <option ->-d DANKAcolorC2000</option -> <option ->/home/kurt/linuxtag2001-paper.ps</option -></userinput ->. You can still de-select the printer <option ->DANKAcolorC2000</option -> and choose a different one.</para> - -<para ->You <emphasis ->cannot</emphasis -> however call <userinput -><command ->kprinter</command -></userinput -> without a print file and hope to open a file selection dialogue box from the &kprinter; window. This is a feature that will be implemented only in the next version.</para> +<note><para>Just make sure you give at least the file to be printed from the command line as well: <userinput><command>kprinter</command> <option>/usr/share/doc/packages/cups/sam.pdf</option></userinput>. This will hand over the &CUPS; Software Administrator Manual to the <command>kprinter</command> dialogue, which will then pop up with the default printer pre-selected.</para> + +<para>To pre-select a specific printer from the command line, use the <option>-d</option> option, ⪚: <userinput><command>kprinter</command> <option>-d DANKAcolorC2000</option> <option>/home/kurt/linuxtag2001-paper.ps</option></userinput>. You can still de-select the printer <option>DANKAcolorC2000</option> and choose a different one.</para> + +<para>You <emphasis>cannot</emphasis> however call <userinput><command>kprinter</command></userinput> without a print file and hope to open a file selection dialogue box from the &kprinter; window. This is a feature that will be implemented only in the next version.</para> </note> -<para ->Using <command ->kprinter</command -> you are able to <quote ->ring all the bells and blow all the whistles</quote -> of your printer. You will need a device-specific so-called &PPD; (&PostScript; Printer Description) to enable &CUPS; to make this nice tandem team do this for you. Read more about this in <xref linkend="ppd-files"/>.</para> +<para>Using <command>kprinter</command> you are able to <quote>ring all the bells and blow all the whistles</quote> of your printer. You will need a device-specific so-called &PPD; (&PostScript; Printer Description) to enable &CUPS; to make this nice tandem team do this for you. Read more about this in <xref linkend="ppd-files"/>.</para> </sect2> </sect1> <sect1 id="future-plans"> -<title ->Plans for Future Development</title> - -<para ->What you have now is the first, already very feature-rich version of &tdeprint;. This version is, of course, fully usable for printing. You might even think that <quote ->it was never so easy</quote -> (not even back in the days when you had to use &Microsoft; &Windows;).</para> - -<para ->In the future, &tdeprint; will become even better. It will do a better job of <quote ->detecting</quote -> your installed print subsystem itself. Already &tdeprint; is doing quite well in automatically sensing if you have &CUPS; on your system. But in many cases you will have to tell &tdeprint; what you are using, if you want to keep a legacy print system.</para> - -<para ->The most important improvement in the near future will be a completion of the <application ->LPRng</application -> plugin. This at present is still very basic. It is restricted to the pure classical <acronym ->LPD</acronym -> part of <application ->LPRng</application ->.</para> - -<para ->Also, you may be able to add printers directly from the print dialogue to your system <quote ->just in time</quote ->, without going to &kcontrol; first.</para> - -<para ->Some smaller improvements already planned are:</para> +<title>Plans for Future Development</title> + +<para>What you have now is the first, already very feature-rich version of &tdeprint;. This version is, of course, fully usable for printing. You might even think that <quote>it was never so easy</quote> (not even back in the days when you had to use &Microsoft; &Windows;).</para> + +<para>In the future, &tdeprint; will become even better. It will do a better job of <quote>detecting</quote> your installed print subsystem itself. Already &tdeprint; is doing quite well in automatically sensing if you have &CUPS; on your system. But in many cases you will have to tell &tdeprint; what you are using, if you want to keep a legacy print system.</para> + +<para>The most important improvement in the near future will be a completion of the <application>LPRng</application> plugin. This at present is still very basic. It is restricted to the pure classical <acronym>LPD</acronym> part of <application>LPRng</application>.</para> + +<para>Also, you may be able to add printers directly from the print dialogue to your system <quote>just in time</quote>, without going to &kcontrol; first.</para> + +<para>Some smaller improvements already planned are:</para> <itemizedlist> -<listitem -><para ->add a file selection dialogue from the &kprinter; window to allow combining of additional files to the present printjob</para -></listitem -> <listitem -><para ->add a <quote ->history</quote -> button to the <application ->KJobViewer</application -> window and also a column to show the number of pages &CUPS; calculates for the job.</para -></listitem> +<listitem><para>add a file selection dialogue from the &kprinter; window to allow combining of additional files to the present printjob</para></listitem> <listitem><para>add a <quote>history</quote> button to the <application>KJobViewer</application> window and also a column to show the number of pages &CUPS; calculates for the job.</para></listitem> </itemizedlist> -<para ->Finally, there will be an <quote ->IO slave</quote -> that will give you access to your print subsystem, via &konqueror; for example. With this you will soon be able to browse your print subsystem from &konqueror; through a &URL; like shortcut such as <userinput ->print://printers/printername</userinput ->. A KPart will add a virtual folder to the services section of the &konqueror; navigation panel, giving a nice integrated way to browse and manage your print system via the &URL; <userinput ->print:/manager</userinput ->.</para> - -<para ->Please contact Michael Goffioul at <email ->tdeprint@swing.be</email -> with any further user or developer suggestions.</para> +<para>Finally, there will be an <quote>IO slave</quote> that will give you access to your print subsystem, via &konqueror; for example. With this you will soon be able to browse your print subsystem from &konqueror; through a &URL; like shortcut such as <userinput>print://printers/printername</userinput>. A KPart will add a virtual folder to the services section of the &konqueror; navigation panel, giving a nice integrated way to browse and manage your print system via the &URL; <userinput>print:/manager</userinput>.</para> + +<para>Please contact Michael Goffioul at <email>tdeprint@swing.be</email> with any further user or developer suggestions.</para> </sect1> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeprint/index.docbook b/tde-i18n-en_GB/docs/tdebase/tdeprint/index.docbook index 47edbac8971..f511c1833f7 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeprint/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeprint/index.docbook @@ -1,24 +1,12 @@ <?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ - <!ENTITY tdeprint "<application ->TDEPrint</application ->"> - <!ENTITY kprinter "<command ->kprinter</command ->"> - <!ENTITY CUPS "<acronym ->CUPS</acronym ->"> - <!ENTITY PPD "<acronym ->PPD</acronym ->"> - <!ENTITY IPP "<acronym ->IPP</acronym ->"> - <!ENTITY ghostscript "<application ->ghostscript</application ->"> + <!ENTITY tdeprint "<application>TDEPrint</application>"> + <!ENTITY kprinter "<command>kprinter</command>"> + <!ENTITY CUPS "<acronym>CUPS</acronym>"> + <!ENTITY PPD "<acronym>PPD</acronym>"> + <!ENTITY IPP "<acronym>IPP</acronym>"> + <!ENTITY ghostscript "<application>ghostscript</application>"> <!ENTITY tech-overview-doc SYSTEM "tech-overview.docbook"> <!ENTITY highlights-doc SYSTEM "highlights.docbook"> <!ENTITY getting-started-doc SYSTEM "getting-started.docbook"> @@ -34,172 +22,90 @@ <!ENTITY external-command-doc SYSTEM "external-command.docbook"> <!ENTITY extensions-doc SYSTEM "extensions.docbook"> <!ENTITY final-word-doc SYSTEM "final-word.docbook"> - <!ENTITY kappname "&tdeprint;" -><!-- replace kapp here --> + <!ENTITY kappname "&tdeprint;"><!-- replace kapp here --> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -><!-- change language only here --> + <!ENTITY % British-English "INCLUDE"><!-- change language only here --> ]> <book lang="&language;"> <bookinfo> -<title ->The &tdeprint; Handbook</title> +<title>The &tdeprint; Handbook</title> <authorgroup> -<author -><firstname ->Kurt</firstname -> <surname ->Pfeifle</surname -> <affiliation -> <address -><email ->kpfeifle@danka.de</email -></address> +<author><firstname>Kurt</firstname> <surname>Pfeifle</surname> <affiliation> <address><email>kpfeifle@danka.de</email></address> </affiliation> </author> -<othercredit role="developer" -><firstname ->Michael</firstname -> <surname ->Goffioul</surname -> <affiliation -> <address -><email ->tdeprint@swing.be</email -></address> +<othercredit role="developer"><firstname>Michael</firstname> <surname>Goffioul</surname> <affiliation> <address><email>tdeprint@swing.be</email></address> </affiliation> -<contrib ->Developer</contrib> +<contrib>Developer</contrib> </othercredit> -<othercredit role="reviewer" -><firstname ->Lauri</firstname -> <surname ->Watts</surname -> <affiliation -> <address -><email ->lauri@kde.org</email -></address> +<othercredit role="reviewer"><firstname>Lauri</firstname> <surname>Watts</surname> <affiliation> <address><email>lauri@kde.org</email></address> </affiliation> -<contrib ->Reviewer</contrib> +<contrib>Reviewer</contrib> </othercredit> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->2001</year> -<holder ->Kurt Pfeifle</holder> +<year>2001</year> +<holder>Kurt Pfeifle</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2001-08-09</date> -<releaseinfo ->1.00.04</releaseinfo> +<date>2001-08-09</date> +<releaseinfo>1.00.04</releaseinfo> <abstract> -<para ->This handbook describes &tdeprint;. &tdeprint; is not a standalone program. It is the new printing framework for &kde; 2.2. &tdeprint; is an intermediate layer between &kde; (or other) applications and the selected (and installed) print subsystem of your OS (&OS;).</para> +<para>This handbook describes &tdeprint;. &tdeprint; is not a standalone program. It is the new printing framework for &kde; 2.2. &tdeprint; is an intermediate layer between &kde; (or other) applications and the selected (and installed) print subsystem of your OS (&OS;).</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->tdebase</keyword> -<keyword ->tdeprint</keyword> -<keyword ->print</keyword> -<keyword ->printing</keyword> -<keyword ->CUPS</keyword> -<keyword ->LPR</keyword> +<keyword>KDE</keyword> +<keyword>tdebase</keyword> +<keyword>tdeprint</keyword> +<keyword>print</keyword> +<keyword>printing</keyword> +<keyword>CUPS</keyword> +<keyword>LPR</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->This handbook describes &tdeprint;. &tdeprint; is not a standalone program. It is the new printing framework for &kde; 2.2. &tdeprint; is an intermediate layer between &kde; (or other) applications and the selected (and installed) print subsystem of your OS (&OS;).</para> +<para>This handbook describes &tdeprint;. &tdeprint; is not a standalone program. It is the new printing framework for &kde; 2.2. &tdeprint; is an intermediate layer between &kde; (or other) applications and the selected (and installed) print subsystem of your OS (&OS;).</para> -<para ->It should be noted that both the developer of this application, and the author of this document are most familiar with &CUPS; as a printing system. At the time of writing, &CUPS; is the best supported printing subsystem, and it is the best documented.</para> +<para>It should be noted that both the developer of this application, and the author of this document are most familiar with &CUPS; as a printing system. At the time of writing, &CUPS; is the best supported printing subsystem, and it is the best documented.</para> -<para ->This handbook is a work in progress, and later versions of the &tdeprint; software and editions of this handbook will support and explore more closely other printing systems.</para> +<para>This handbook is a work in progress, and later versions of the &tdeprint; software and editions of this handbook will support and explore more closely other printing systems.</para> -<para ->In the meantime, even if your printing subsystem is not yet well covered, you are encouraged to explore the <guilabel ->Printing Manager</guilabel -> module in &kcontrol;, and you will find its operation to hopefully be fairly self evident, no matter what printing subsystem you use.</para> +<para>In the meantime, even if your printing subsystem is not yet well covered, you are encouraged to explore the <guilabel>Printing Manager</guilabel> module in &kcontrol;, and you will find its operation to hopefully be fairly self evident, no matter what printing subsystem you use.</para> -<para ->Lauri Watts, &kde; documentation team</para> +<para>Lauri Watts, &kde; documentation team</para> -<!-- Insert here screenshot : <steinbruch_scaled.png -> --> +<!-- Insert here screenshot : <steinbruch_scaled.png> --> <sect1> -<title ->To configure your printing subsystem from &kcontrol;</title> - -<para ->To configure your printing subsystem from &kcontrol;, go to <menuchoice -><guilabel ->System</guilabel -><guilabel ->Printing Manager</guilabel -></menuchoice -> and select your subsystem. Or you can let &tdeprint; try to determine it... </para> +<title>To configure your printing subsystem from &kcontrol;</title> + +<para>To configure your printing subsystem from &kcontrol;, go to <menuchoice><guilabel>System</guilabel><guilabel>Printing Manager</guilabel></menuchoice> and select your subsystem. Or you can let &tdeprint; try to determine it... </para> <screenshot> -<screeninfo ->&CUPS; Printing Manager dialogue: overview via &kcontrol;</screeninfo> +<screeninfo>&CUPS; Printing Manager dialogue: overview via &kcontrol;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="steinbruch_scaled.png" format="PNG"/></imageobject> <textobject> -<phrase ->The dialogue to configure the &CUPS; server: security settings</phrase -></textobject> -<caption -><para ->Configuration of printing subsystem from &kcontrol;</para -></caption> +<phrase>The dialogue to configure the &CUPS; server: security settings</phrase></textobject> +<caption><para>Configuration of printing subsystem from &kcontrol;</para></caption> </mediaobject> </screenshot> </sect1> @@ -235,22 +141,10 @@ format="PNG"/></imageobject> &final-word-doc; <chapter id="credits-and-license"> -<title ->Credits And Licences</title> - -<para ->&tdeprint; copyright 2001, Michael Goffioul <email ->tdeprint@swing.be</email -></para> -&underGPL; <para ->Documentation copyright 2001, Kurt Pfeifle, <email ->kpfeifle@danka.de</email -></para -> &underFDL; <para ->Conversion to British English: Malcolm Hunter <email ->malcolm.hunter@gmx.co.uk</email -></para -> +<title>Credits And Licences</title> + +<para>&tdeprint; copyright 2001, Michael Goffioul <email>tdeprint@swing.be</email></para> +&underGPL; <para>Documentation copyright 2001, Kurt Pfeifle, <email>kpfeifle@danka.de</email></para> &underFDL; <para>Conversion to British English: Malcolm Hunter <email>malcolm.hunter@gmx.co.uk</email></para> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeprint/lpd.docbook b/tde-i18n-en_GB/docs/tdebase/tdeprint/lpd.docbook index 8c39ba87173..e99e2abeea7 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeprint/lpd.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeprint/lpd.docbook @@ -1,27 +1,13 @@ <chapter id="lpd-module"> -<title ->Generic <acronym ->LPD</acronym -> Module (&UNIX;)</title> +<title>Generic <acronym>LPD</acronym> Module (&UNIX;)</title> <sect1> -<title ->Overview of Provided Features</title> +<title>Overview of Provided Features</title> -<para ->Module used by default (on first start for example).</para> +<para>Module used by default (on first start for example).</para> -<para ->Generic module that only allows sending of print jobs. No printer or job management supported. It is made to work on a wide variety of &UNIX; flavours: &Linux;/<acronym ->LPR</acronym ->, &HP-UX;, Solaris, &IRIX;. It also supports some <application ->LPRng</application -> extensions (like the absence of continuation character <literal ->\</literal -> in <filename ->printcap</filename -> files).</para> +<para>Generic module that only allows sending of print jobs. No printer or job management supported. It is made to work on a wide variety of &UNIX; flavours: &Linux;/<acronym>LPR</acronym>, &HP-UX;, Solaris, &IRIX;. It also supports some <application>LPRng</application> extensions (like the absence of continuation character <literal>\</literal> in <filename>printcap</filename> files).</para> </sect1> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeprint/lpr-bsd.docbook b/tde-i18n-en_GB/docs/tdebase/tdeprint/lpr-bsd.docbook index 9d6bcbbf86d..cda258b7be3 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeprint/lpr-bsd.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeprint/lpr-bsd.docbook @@ -1,36 +1,20 @@ <chapter id="lpr-bsd-style-module"> -<title -><acronym ->LPR</acronym -> (<acronym ->BSD</acronym ->)</title> +<title><acronym>LPR</acronym> (<acronym>BSD</acronym>)</title> -<para ->Plain (old?) <acronym ->LPR</acronym -> support. An <acronym ->LPRng</acronym -> module is in development, and hopefully available for 2.3 release.</para> +<para>Plain (old?) <acronym>LPR</acronym> support. An <acronym>LPRng</acronym> module is in development, and hopefully available for 2.3 release.</para> <sect1> -<title ->Overview of Provided Features</title> +<title>Overview of Provided Features</title> <itemizedlist> <listitem> -<para ->Printer management: basic support to add/remove/configure a printer, compatible with &RedHat;-6.x systems (<command ->printtool</command -> + rhs-printfilers packages).</para> +<para>Printer management: basic support to add/remove/configure a printer, compatible with &RedHat;-6.x systems (<command>printtool</command> + rhs-printfilers packages).</para> </listitem> <listitem> -<para ->Job management: not supported</para> +<para>Job management: not supported</para> </listitem> <listitem> -<para ->Print options: basic control</para> +<para>Print options: basic control</para> </listitem> </itemizedlist> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeprint/lprng.docbook b/tde-i18n-en_GB/docs/tdebase/tdeprint/lprng.docbook index 193747db5f2..a765cbc23ff 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeprint/lprng.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeprint/lprng.docbook @@ -1,12 +1,6 @@ <chapter id="lprng-module"> -<title -><application ->LPRng</application -></title> +<title><application>LPRng</application></title> -<para ->An <application ->LPRng</application -> module for &tdeprint; is in development, and hopefully available for the &kde; 2.3 release.</para> +<para>An <application>LPRng</application> module for &tdeprint; is in development, and hopefully available for the &kde; 2.3 release.</para> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeprint/rlpr.docbook b/tde-i18n-en_GB/docs/tdebase/tdeprint/rlpr.docbook index 88b2ac1dd7b..3c7858fda5d 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeprint/rlpr.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeprint/rlpr.docbook @@ -1,24 +1,12 @@ <chapter id="rlpr-module"> -<title ->Module Built Around <application ->rlpr</application -> Utility</title> +<title>Module Built Around <application>rlpr</application> Utility</title> <sect1> -<title ->Overview of provided features</title> +<title>Overview of provided features</title> -<para ->Printer management: basic operations are supported (add/remove/modify).</para> +<para>Printer management: basic operations are supported (add/remove/modify).</para> -<para ->Each user can predefine the printers he wants to use by specifying the host and related printer queues. Printers are stored on a <quote ->per user basis</quote ->. This module is built around the <application ->rlpr</application -> utility <ulink url="http://truffula.com/rlpr/" ->rlpr</ulink -></para> +<para>Each user can predefine the printers he wants to use by specifying the host and related printer queues. Printers are stored on a <quote>per user basis</quote>. This module is built around the <application>rlpr</application> utility <ulink url="http://truffula.com/rlpr/">rlpr</ulink></para> </sect1> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeprint/tech-overview.docbook b/tde-i18n-en_GB/docs/tdebase/tdeprint/tech-overview.docbook index 05bfbc915c4..37fa1a89985 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeprint/tech-overview.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeprint/tech-overview.docbook @@ -1,164 +1,86 @@ <chapter id="technical-overview"> -<title ->Technical Overview</title> +<title>Technical Overview</title> -<para ->This chapter aims to give a technical overview of &tdeprint; which non-programmers can comprehend.</para> +<para>This chapter aims to give a technical overview of &tdeprint; which non-programmers can comprehend.</para> -<para ->&tdeprint; is a new and revolutionary tool to give easy access to printing services for both &kde; users and &kde; developers.</para> +<para>&tdeprint; is a new and revolutionary tool to give easy access to printing services for both &kde; users and &kde; developers.</para> <sect1 id="brief-description"> -<title ->A Brief Description of &tdeprint;</title> +<title>A Brief Description of &tdeprint;</title> -<para ->You can access the functions of &tdeprint; in different ways: through the Printing Manger in the &kcontrol;, through the <command ->kprinter</command -> command or through the dialogue that pops up if you want to print.</para> +<para>You can access the functions of &tdeprint; in different ways: through the Printing Manger in the &kcontrol;, through the <command>kprinter</command> command or through the dialogue that pops up if you want to print.</para> <sect2 id="what-tdeprint-is-not"> -<title ->What it is <emphasis ->not</emphasis -></title> - -<para ->&tdeprint; is <emphasis ->not</emphasis -> a replacement for the printing subsystem itself. &tdeprint; does <emphasis ->not</emphasis -> therefore give provision for spooling, and it does <emphasis ->not</emphasis -> do the basic processing of &PostScript; or other print data.</para> +<title>What it is <emphasis>not</emphasis></title> + +<para>&tdeprint; is <emphasis>not</emphasis> a replacement for the printing subsystem itself. &tdeprint; does <emphasis>not</emphasis> therefore give provision for spooling, and it does <emphasis>not</emphasis> do the basic processing of &PostScript; or other print data.</para> </sect2> <sect2 id="what-kde-print-is"> -<title ->What it <emphasis ->is</emphasis -></title> -<para ->&tdeprint; is an intermediate layer between the spooling and the data processing print subsystem (as installed), and the application that seeks to print. &tdeprint; provides a common interface for &kde; developers and &kde; users, to various supported print subsystems. At the same time, it is customisable, and highly configurable.</para> +<title>What it <emphasis>is</emphasis></title> +<para>&tdeprint; is an intermediate layer between the spooling and the data processing print subsystem (as installed), and the application that seeks to print. &tdeprint; provides a common interface for &kde; developers and &kde; users, to various supported print subsystems. At the same time, it is customisable, and highly configurable.</para> -<para ->&tdeprint; is easy to use for both &kde; developers and end-users. Developers can port their applications, with minimal changes, to use &tdeprint; instead of the old &Qt; print <quote ->system</quote ->. Users can easily choose and configure their print subsystem.</para> +<para>&tdeprint; is easy to use for both &kde; developers and end-users. Developers can port their applications, with minimal changes, to use &tdeprint; instead of the old &Qt; print <quote>system</quote>. Users can easily choose and configure their print subsystem.</para> -<para ->For a reference to new &kde; users: &Qt; is the basic library and graphical toolkit, which is used by all &kde; applications; &Qt; is developed by TrollTech, a Norwegian software company.</para> +<para>For a reference to new &kde; users: &Qt; is the basic library and graphical toolkit, which is used by all &kde; applications; &Qt; is developed by TrollTech, a Norwegian software company.</para> </sect2> </sect1> <sect1 id="different-users"> -<title ->&tdeprint; -- Different Usage for Different People</title> +<title>&tdeprint; -- Different Usage for Different People</title> -<para ->&tdeprint; has different faces for different people.</para> +<para>&tdeprint; has different faces for different people.</para> <sect2 id="what-users-can-do"> -<title ->What users and administrators can do with &tdeprint;</title> - -<para ->&tdeprint; allows users and/or administrators, depending on their rights, access to printing subsystems (&CUPS;, <acronym ->LPD</acronym ->, <acronym ->RLPR</acronym ->, <application ->LPRng</application ->, <application ->PDQ</application -> &etc;) through a &kde; graphical user interface (&GUI;). Using &tdeprint;, they can print, administer jobs, printers and the printing daemon, all in a comfortable manner.</para> - -<para ->Experienced users will like the capability to plug any working filter for the print data between the output of their application and the input, into the chosen print subsystem. Some examples for this already ship with <quote ->plain vanilla</quote -> &tdeprint;. Read on.</para> +<title>What users and administrators can do with &tdeprint;</title> + +<para>&tdeprint; allows users and/or administrators, depending on their rights, access to printing subsystems (&CUPS;, <acronym>LPD</acronym>, <acronym>RLPR</acronym>, <application>LPRng</application>, <application>PDQ</application> &etc;) through a &kde; graphical user interface (&GUI;). Using &tdeprint;, they can print, administer jobs, printers and the printing daemon, all in a comfortable manner.</para> + +<para>Experienced users will like the capability to plug any working filter for the print data between the output of their application and the input, into the chosen print subsystem. Some examples for this already ship with <quote>plain vanilla</quote> &tdeprint;. Read on.</para> </sect2> <sect2 id="what-developers-can-do"> -<title ->What &kde; developers can do with it...</title> - -<para ->If a &kde; developer needs printing access for his application, he does not code the printing functions from scratch. Before &kde; 2.2 this service was provided by the <classname ->QPrinter</classname -> class, a library function of the &Qt; Toolkit. The <classname ->QPrinter</classname -> class relied on the out-moded <quote ->Line Printer Daemon</quote -> (<acronym ->LPD</acronym ->). The &tdeprint; library bases itself firmly on the more modern Common &UNIX; Printing System (&CUPS;), while at the same time keeping backward compatibility with <acronym ->LPD</acronym -> and other legacy, or less elaborate, print systems. It also <quote ->leaves the door open</quote -> for any new development that might occur.</para> - -<para ->For &kde; developers to use the new &tdeprint; class in their applications, they require only minimal changes to their code: for every call of <classname ->QPrinter</classname ->, they just need to change this to <classname ->KPrinter</classname ->. Replacing one (!) letter in a few spots, and automatically they are done; their application can then use all of the features of the new &tdeprint; library.</para> - -<para ->More ambitious developers, or ones with special requirements, can do more: despite &tdeprint;'s feature-rich framework, they are still able to customise the print dialogue of their application by creating an additional <quote ->Tab</quote ->, where their extensions to the standard &tdeprint; will feel right at home.</para> - - -<para ->This last mentioned feature has not been used widely inside &kde; so far, as developers are not yet fully aware of &tdeprint;'s power. Expect more of this in the near future. One example I discovered is the &kcron; application. It lets you edit the crontab through a &GUI;. The developers have implemented a printing feature that lets you (or <systemitem class="username" ->root</systemitem ->) choose if you want to print the whole of crontab (for all users) or just the part that is marked. You can see the effects on &tdeprint; in the following screenshots.</para> - -<para ->This shot shows a sample from the &kcron; utility. <screenshot> -<screeninfo ->&kcron; utility: a small sample of a system's cronjobs as shown through the &kde; <acronym ->GUI</acronym ->&GUI;.</screeninfo> +<title>What &kde; developers can do with it...</title> + +<para>If a &kde; developer needs printing access for his application, he does not code the printing functions from scratch. Before &kde; 2.2 this service was provided by the <classname>QPrinter</classname> class, a library function of the &Qt; Toolkit. The <classname>QPrinter</classname> class relied on the out-moded <quote>Line Printer Daemon</quote> (<acronym>LPD</acronym>). The &tdeprint; library bases itself firmly on the more modern Common &UNIX; Printing System (&CUPS;), while at the same time keeping backward compatibility with <acronym>LPD</acronym> and other legacy, or less elaborate, print systems. It also <quote>leaves the door open</quote> for any new development that might occur.</para> + +<para>For &kde; developers to use the new &tdeprint; class in their applications, they require only minimal changes to their code: for every call of <classname>QPrinter</classname>, they just need to change this to <classname>KPrinter</classname>. Replacing one (!) letter in a few spots, and automatically they are done; their application can then use all of the features of the new &tdeprint; library.</para> + +<para>More ambitious developers, or ones with special requirements, can do more: despite &tdeprint;'s feature-rich framework, they are still able to customise the print dialogue of their application by creating an additional <quote>Tab</quote>, where their extensions to the standard &tdeprint; will feel right at home.</para> + + +<para>This last mentioned feature has not been used widely inside &kde; so far, as developers are not yet fully aware of &tdeprint;'s power. Expect more of this in the near future. One example I discovered is the &kcron; application. It lets you edit the crontab through a &GUI;. The developers have implemented a printing feature that lets you (or <systemitem class="username">root</systemitem>) choose if you want to print the whole of crontab (for all users) or just the part that is marked. You can see the effects on &tdeprint; in the following screenshots.</para> + +<para>This shot shows a sample from the &kcron; utility. <screenshot> +<screeninfo>&kcron; utility: a small sample of a system's cronjobs as shown through the &kde; <acronym>GUI</acronym>&GUI;.</screeninfo> <mediaobject> <imageobject> <imagedata fileref="kcron_to_be_printed.png" format="PNG"/></imageobject> <textobject> -<phrase ->The &kcron; developers let you choose to print the whole of the cron table or just the marked part of it.</phrase -></textobject> +<phrase>The &kcron; developers let you choose to print the whole of the cron table or just the marked part of it.</phrase></textobject> </mediaobject> </screenshot> </para> -<para ->The dialogue to configure &kcron;'s printing options: the additional tab titled <guilabel ->Cron Options</guilabel -> is from inside &kcron;, not &tdeprint;; it is a special extension added by the &kcron; developers for printing purposes, not originating from, but executed by &tdeprint;. Developers of other applications are free to implement their own goodies, if they feel need for it.</para> +<para>The dialogue to configure &kcron;'s printing options: the additional tab titled <guilabel>Cron Options</guilabel> is from inside &kcron;, not &tdeprint;; it is a special extension added by the &kcron; developers for printing purposes, not originating from, but executed by &tdeprint;. Developers of other applications are free to implement their own goodies, if they feel need for it.</para> <screenshot> -<screeninfo ->&kcron;'s addition to the &tdeprint; dialogue.</screeninfo> +<screeninfo>&kcron;'s addition to the &tdeprint; dialogue.</screeninfo> <mediaobject> <imageobject> <imagedata fileref="kprinter_with_kcron_developer_special.png" format="PNG"/></imageobject> <textobject> -<phrase ->&kcron;'s addition to the &tdeprint; dialogue.</phrase -></textobject> +<phrase>&kcron;'s addition to the &tdeprint; dialogue.</phrase></textobject> <caption> -<para ->&kcron;'s addition to the &tdeprint; dialogue.</para> +<para>&kcron;'s addition to the &tdeprint; dialogue.</para> </caption> </mediaobject> </screenshot> @@ -166,161 +88,69 @@ format="PNG"/></imageobject> </sect2> <sect2> -<title ->What &tdeprint; offers to everybody...</title> - -<para ->&tdeprint;'s easy-to-use interface for all supported print subsystems of course does not eliminate basic traditional weaknesses of some of those systems. But it smooths some rough edges. Different users may use different printing systems on the same box. A user is free to even switch <quote ->on the fly</quote ->, from the print dialogue, the print subsystem to be used for the next job. (This is possible if different systems are installed in a way that they don't <quote ->get in each other's way</quote ->.)</para> - -<para ->Most &UNIX; users are used to <acronym ->LPD</acronym -> printing. <acronym ->LPD</acronym -> provides only basic printing functions, is very inflexible and does not utilise the many options of more modern print systems like &CUPS;. While also working remotely over any distance (like every TCP/IP based protocol), <acronym ->LPD</acronym -> lacks bi-directional communication, authentication, access control and encryption support.</para> - -<para ->&tdeprint; can use &CUPS; to support:</para> +<title>What &tdeprint; offers to everybody...</title> + +<para>&tdeprint;'s easy-to-use interface for all supported print subsystems of course does not eliminate basic traditional weaknesses of some of those systems. But it smooths some rough edges. Different users may use different printing systems on the same box. A user is free to even switch <quote>on the fly</quote>, from the print dialogue, the print subsystem to be used for the next job. (This is possible if different systems are installed in a way that they don't <quote>get in each other's way</quote>.)</para> + +<para>Most &UNIX; users are used to <acronym>LPD</acronym> printing. <acronym>LPD</acronym> provides only basic printing functions, is very inflexible and does not utilise the many options of more modern print systems like &CUPS;. While also working remotely over any distance (like every TCP/IP based protocol), <acronym>LPD</acronym> lacks bi-directional communication, authentication, access control and encryption support.</para> + +<para>&tdeprint; can use &CUPS; to support:</para> <itemizedlist> <listitem> -<para ->Querying the <acronym ->LAN</acronym -> for available printers,</para> +<para>Querying the <acronym>LAN</acronym> for available printers,</para> </listitem> <listitem> -<para ->Basic, Digest, and Certificate Authentication,</para> +<para>Basic, Digest, and Certificate Authentication,</para> </listitem> <listitem> -<para ->Access Control based on <acronym ->IP</acronym -> addresses, net addresses, netmasks, host- and domain names,</para> +<para>Access Control based on <acronym>IP</acronym> addresses, net addresses, netmasks, host- and domain names,</para> </listitem> <listitem> -<para ->and 128-Bit TLS or SSL3 encryption of print data, to prevent eavesdropping, or at least make it much more difficult.</para> +<para>and 128-Bit TLS or SSL3 encryption of print data, to prevent eavesdropping, or at least make it much more difficult.</para> </listitem> </itemizedlist> -<para ->This makes &tdeprint; a much more robust and reliable solution than using the venerable <acronym ->LPD</acronym ->.</para> +<para>This makes &tdeprint; a much more robust and reliable solution than using the venerable <acronym>LPD</acronym>.</para> </sect2> <sect2> -<title ->How to access &tdeprint; </title> +<title>How to access &tdeprint; </title> -<para ->You get access to &tdeprint;, or parts of it, in four different ways:</para> +<para>You get access to &tdeprint;, or parts of it, in four different ways:</para> <itemizedlist> -<listitem -><para ->through your applications: if you call the printing dialogue (either <menuchoice -><guilabel ->File</guilabel -> <guilabel ->Print...</guilabel -></menuchoice ->) or the button with the little printer icon on it; this opens the printing dialogue.</para -></listitem> - -<listitem -><para ->through the typed command <command ->kprinter</command -> in a <application ->terminal</application -> or a &konsole; window or from the <guilabel ->Run Command...</guilabel -> mini-<acronym ->CLI</acronym -> window: this also opens the printing dialogue.</para -></listitem> - -<listitem -><para ->from the <inlinemediaobject -><imageobject -> <imagedata fileref="kcontrol-icon.png" format="PNG"/></imageobject -> </inlinemediaobject -> button, starting &kcontrol;, and then go to <menuchoice -><guilabel ->System</guilabel -><guilabel ->Printing Manager</guilabel -></menuchoice ->. This opens the &tdeprint; administration which is part of the &kcontrolcenter; and also lets you switch to other parts of the &kcontrol;</para -></listitem> - -<listitem -><para ->from a command line (&konsole; or mini-<acronym ->CLI</acronym ->) type <userinput -> <command ->tdecmshell</command -> <option ->printmgr</option -></userinput ->. This opens just the &tdeprint; part of &kcontrol; to change your settings </para -></listitem> +<listitem><para>through your applications: if you call the printing dialogue (either <menuchoice><guilabel>File</guilabel> <guilabel>Print...</guilabel></menuchoice>) or the button with the little printer icon on it; this opens the printing dialogue.</para></listitem> + +<listitem><para>through the typed command <command>kprinter</command> in a <application>terminal</application> or a &konsole; window or from the <guilabel>Run Command...</guilabel> mini-<acronym>CLI</acronym> window: this also opens the printing dialogue.</para></listitem> + +<listitem><para>from the <inlinemediaobject><imageobject> <imagedata fileref="kcontrol-icon.png" format="PNG"/></imageobject> </inlinemediaobject> button, starting &kcontrol;, and then go to <menuchoice><guilabel>System</guilabel><guilabel>Printing Manager</guilabel></menuchoice>. This opens the &tdeprint; administration which is part of the &kcontrolcenter; and also lets you switch to other parts of the &kcontrol;</para></listitem> + +<listitem><para>from a command line (&konsole; or mini-<acronym>CLI</acronym>) type <userinput> <command>tdecmshell</command> <option>printmgr</option></userinput>. This opens just the &tdeprint; part of &kcontrol; to change your settings </para></listitem> </itemizedlist> <screenshot> -<screeninfo ->&kprinter; dialogue to be started from <guilabel ->Run Command...</guilabel -> window</screeninfo> +<screeninfo>&kprinter; dialogue to be started from <guilabel>Run Command...</guilabel> window</screeninfo> <mediaobject> <imageobject> <imagedata fileref="kprinter_called_from_run_command.png" format="PNG"/></imageobject> <textobject> -<phrase ->Starting the &kprinter; dialogue from a <guilabel ->Run Command...</guilabel -> window.</phrase -></textobject> -<caption -><para ->Starting the &kprinter; dialogue from a <guilabel ->Run Command...</guilabel -> window.</para -></caption> +<phrase>Starting the &kprinter; dialogue from a <guilabel>Run Command...</guilabel> window.</phrase></textobject> +<caption><para>Starting the &kprinter; dialogue from a <guilabel>Run Command...</guilabel> window.</para></caption> </mediaobject> </screenshot> -<!-- TODO: This one ought to be a screenshot LW. --> <para ->Here is a &kivio; drawing of the &kprinter; dialogue as it pops up after being started... You can always add a new printer by clicking on the small <guiicon ->Wizard</guiicon -> button (marked red/yellow in this drawing).</para> +<!-- TODO: This one ought to be a screenshot LW. --> <para>Here is a &kivio; drawing of the &kprinter; dialogue as it pops up after being started... You can always add a new printer by clicking on the small <guiicon>Wizard</guiicon> button (marked red/yellow in this drawing).</para> <screenshot> -<screeninfo ->&kprinter; dialogue started (&kivio; draft drawing) </screeninfo> +<screeninfo>&kprinter; dialogue started (&kivio; draft drawing) </screeninfo> <mediaobject> <imageobject> <imagedata fileref="kprinter-kivio.png" format="PNG"/></imageobject> <textobject> -<phrase ->&kprinter; dialogue started (&kivio; draft drawing)</phrase -></textobject> -<caption -><para ->&kprinter; dialogue started (&kivio; draft drawing)</para -></caption> +<phrase>&kprinter; dialogue started (&kivio; draft drawing)</phrase></textobject> +<caption><para>&kprinter; dialogue started (&kivio; draft drawing)</para></caption> </mediaobject> </screenshot> diff --git a/tde-i18n-en_GB/docs/tdebase/tdeprint/theory.docbook b/tde-i18n-en_GB/docs/tdebase/tdeprint/theory.docbook index d39e0969f85..7578f1a633b 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdeprint/theory.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdeprint/theory.docbook @@ -1,75 +1,36 @@ <chapter id="theory"> -<title ->Some Theoretical Background: &CUPS;, <acronym ->IPP</acronym ->, &PostScript; and <application ->Ghostscript</application -></title> - -<para ->This chapter aims to give a bit of theoretical background to printing in general, and to &CUPS; especially. If you are not in need of this, you might like to skip ahead to the <link linkend="getting-started" ->next chapter</link ->. Chances are you will come back to this chapter at some point anyway, because sometimes one needs extra theory to solve a practical problem.</para> +<title>Some Theoretical Background: &CUPS;, <acronym>IPP</acronym>, &PostScript; and <application>Ghostscript</application></title> + +<para>This chapter aims to give a bit of theoretical background to printing in general, and to &CUPS; especially. If you are not in need of this, you might like to skip ahead to the <link linkend="getting-started">next chapter</link>. Chances are you will come back to this chapter at some point anyway, because sometimes one needs extra theory to solve a practical problem.</para> <sect1 id="basics-of-printing"> -<title ->Basics About Printing</title> +<title>Basics About Printing</title> -<para ->Printing is one of the more complicated chapters in <acronym ->IT</acronym -> technology.</para> +<para>Printing is one of the more complicated chapters in <acronym>IT</acronym> technology.</para> -<para ->Earlier on in history, every developer of a program that was capable of producing printable output had to write his own printer drivers too. That was quite complicated, because different programs have different file formats. Even programs with the same purpose, for example: word processors, often do not understand each other's formats. There was therefore no common interface to all printers, hence the programmers often supported only a few selected models.</para> +<para>Earlier on in history, every developer of a program that was capable of producing printable output had to write his own printer drivers too. That was quite complicated, because different programs have different file formats. Even programs with the same purpose, for example: word processors, often do not understand each other's formats. There was therefore no common interface to all printers, hence the programmers often supported only a few selected models.</para> -<para ->A new device appearing on the market required the program authors to write a new driver if they wanted their program to support it. Also for manufacturers, it was impossible to make sure their device was supported by any program known to the world (although there were far fewer than today).</para> +<para>A new device appearing on the market required the program authors to write a new driver if they wanted their program to support it. Also for manufacturers, it was impossible to make sure their device was supported by any program known to the world (although there were far fewer than today).</para> -<para ->Having to support ten application programs and a dozen printers, meant a system administrator had to deal with 120 drivers. So the development of unified interfaces between programs and printers became an urgent need.</para> +<para>Having to support ten application programs and a dozen printers, meant a system administrator had to deal with 120 drivers. So the development of unified interfaces between programs and printers became an urgent need.</para> -<para ->The appearance of <quote ->Page Description Languages</quote ->, describing the graphical representation of ink and toner on sheets of paper (or other output devices, like monitors, photo typesetters, &etc;) in a common way, was a move that filled a big gap. </para> +<para>The appearance of <quote>Page Description Languages</quote>, describing the graphical representation of ink and toner on sheets of paper (or other output devices, like monitors, photo typesetters, &etc;) in a common way, was a move that filled a big gap. </para> -<para ->One such development was &PostScript; by Adobe. It meant that an application programmer could concentrate on making his program generate a &PostScript; language description of his printable page, while printing device developers could focus on making their devices &PostScript; literate.</para> +<para>One such development was &PostScript; by Adobe. It meant that an application programmer could concentrate on making his program generate a &PostScript; language description of his printable page, while printing device developers could focus on making their devices &PostScript; literate.</para> -<para ->Of course, over time, there came the development of other description methods. The most important competitors to &PostScript; were <acronym ->PCL</acronym -> (<quote ->Print Control Language</quote ->, from &Hewlett-Packard;), <quote ->ESC/P</quote -> (from Epson) and <acronym ->GDI</acronym -> (<quote ->Graphical Device Interface</quote -> from &Microsoft;).</para> +<para>Of course, over time, there came the development of other description methods. The most important competitors to &PostScript; were <acronym>PCL</acronym> (<quote>Print Control Language</quote>, from &Hewlett-Packard;), <quote>ESC/P</quote> (from Epson) and <acronym>GDI</acronym> (<quote>Graphical Device Interface</quote> from &Microsoft;).</para> -<para ->The appearance of these page description languages made life easier, and facilitated further development for everybody. Yet the fact that there still remained different, incompatible, and competing page description languages keeps life for users, administrators, developers and manufacturers difficult enough.</para> +<para>The appearance of these page description languages made life easier, and facilitated further development for everybody. Yet the fact that there still remained different, incompatible, and competing page description languages keeps life for users, administrators, developers and manufacturers difficult enough.</para> <sect2> -<title ->&PostScript; in memory - Bitmaps on Paper</title> +<title>&PostScript; in memory - Bitmaps on Paper</title> -<para ->&PostScript; is most heavily used in professional printing environments such as PrePress and printing service industries. In the &UNIX; and &Linux; domains, &PostScript; is the predominant standard as a <acronym ->PDL</acronym ->. Here, nearly every program generates a &PostScript; representation of its pages once you push the <quote ->Print</quote -> button. Let us look at a simple example of (hand-made) &PostScript; code. The following listing describes two simple drawings:</para> +<para>&PostScript; is most heavily used in professional printing environments such as PrePress and printing service industries. In the &UNIX; and &Linux; domains, &PostScript; is the predominant standard as a <acronym>PDL</acronym>. Here, nearly every program generates a &PostScript; representation of its pages once you push the <quote>Print</quote> button. Let us look at a simple example of (hand-made) &PostScript; code. The following listing describes two simple drawings:</para> <example id="coded-postscript"> -<title ->&PostScript; Code</title> -<screen ->%!PS +<title>&PostScript; Code</title> +<screen>%!PS 100 100 moveto 0 50 rlineto 50 0 rlineto @@ -85,193 +46,98 @@ closepath .2 setgray fill</screen> </example> -<para ->This tells the imaginary &PostScript; <quote ->pen</quote -> to draw a path of a certain shape, and then fill it with different shades of grey. The first part translates into more comprehensive English as <quote ->Go to coordinate (100,100), draw a line with length 50 upward; then one from there to the right, then down again, and finally close this part. Now fill the drawn shape with 70% darkness grey.</quote -></para> +<para>This tells the imaginary &PostScript; <quote>pen</quote> to draw a path of a certain shape, and then fill it with different shades of grey. The first part translates into more comprehensive English as <quote>Go to coordinate (100,100), draw a line with length 50 upward; then one from there to the right, then down again, and finally close this part. Now fill the drawn shape with 70% darkness grey.</quote></para> <example id="rendered-postscript"> -<title ->Rendered &PostScript;</title> +<title>Rendered &PostScript;</title> <mediaobject> <imageobject> <imagedata fileref="ps-boxes.png" format="PNG"/> </imageobject> <textobject> -<phrase -><xref linkend="coded-postscript"/> example rendered as an image.</phrase> +<phrase><xref linkend="coded-postscript"/> example rendered as an image.</phrase> </textobject> </mediaobject> </example> -<para ->Of course, &PostScript; can be much more complicated than this simplistic example. It is a fully fledged programming language with many different operators and functions. You may even write &PostScript; programs to compute the value of Pi, format a hard disk or write to a file. The main value and strength of &PostScript; however lies in the field to describe the layout of graphical objects on a page: it also can scale, mirror, translate, transform, rotate and distort everything you can imagine on a piece of paper -- such as letters in different font representations, figures, shapes, shades, colours, lines, dots, raster...</para> +<para>Of course, &PostScript; can be much more complicated than this simplistic example. It is a fully fledged programming language with many different operators and functions. You may even write &PostScript; programs to compute the value of Pi, format a hard disk or write to a file. The main value and strength of &PostScript; however lies in the field to describe the layout of graphical objects on a page: it also can scale, mirror, translate, transform, rotate and distort everything you can imagine on a piece of paper -- such as letters in different font representations, figures, shapes, shades, colours, lines, dots, raster...</para> -<para ->A &PostScript; file is a representation of one or more pages to be printed, in a relatively abstract way. Ideally, it is meant to describe the pages in a device-independent way. &PostScript; is not directly <quote ->visible</quote ->; it only lives on hard disks and in <acronym ->RAM</acronym -> as a coded representation of future printouts.</para> +<para>A &PostScript; file is a representation of one or more pages to be printed, in a relatively abstract way. Ideally, it is meant to describe the pages in a device-independent way. &PostScript; is not directly <quote>visible</quote>; it only lives on hard disks and in <acronym>RAM</acronym> as a coded representation of future printouts.</para> </sect2> <sect2> -<title ->Raster Images on Paper Sheets</title> - -<para ->What you see on a piece of paper is nearly always a <quote ->raster image</quote ->. Even if your brain suggests to you that your eyes see a line: take a good magnifying glass and you will discover lots of small dots... (One example to the contrary are lines that have been drawn by <quote ->pen plotters</quote ->). And that is the only thing that the <quote ->marking engines</quote -> of today's printers can put on paper: simple dots of different colours, size and resolution, to make up a complete <quote ->page image</quote -> composed of different bitmap patterns.</para> - -<para ->Different printers need the raster image prepared in different ways. Thinking about an inkjet device: depending on its resolution, the number of inks used (the very good ones need 7 different inks, while cheaper ones might only use 3), the number of available jets (some print heads have more than 100!) dispensing ink simultaneously, the <quote ->dithering algorithm</quote -> used, and many other things, the final raster format and transfer order to the marking engine is heavily dependent on the exact model used.</para> - -<para ->Back in the early life of the <quote ->Line Printer Daemon</quote ->, printers were machines that hammered rows of <acronym ->ASCII</acronym -> text mechanically on to long media, folded as a zig-zag paper <acronym ->snake</acronym ->, drawn from a cardboard box beneath the table... What a difference from today!</para> +<title>Raster Images on Paper Sheets</title> + +<para>What you see on a piece of paper is nearly always a <quote>raster image</quote>. Even if your brain suggests to you that your eyes see a line: take a good magnifying glass and you will discover lots of small dots... (One example to the contrary are lines that have been drawn by <quote>pen plotters</quote>). And that is the only thing that the <quote>marking engines</quote> of today's printers can put on paper: simple dots of different colours, size and resolution, to make up a complete <quote>page image</quote> composed of different bitmap patterns.</para> + +<para>Different printers need the raster image prepared in different ways. Thinking about an inkjet device: depending on its resolution, the number of inks used (the very good ones need 7 different inks, while cheaper ones might only use 3), the number of available jets (some print heads have more than 100!) dispensing ink simultaneously, the <quote>dithering algorithm</quote> used, and many other things, the final raster format and transfer order to the marking engine is heavily dependent on the exact model used.</para> + +<para>Back in the early life of the <quote>Line Printer Daemon</quote>, printers were machines that hammered rows of <acronym>ASCII</acronym> text mechanically on to long media, folded as a zig-zag paper <acronym>snake</acronym>, drawn from a cardboard box beneath the table... What a difference from today!</para> </sect2> <sect2> -<title -><acronym ->RIP</acronym ->: From &PostScript; to Raster</title> - -<para ->Before the final raster images are put on paper cut-sheets, they have to be calculated somehow out of their abstract &PostScript; representation. This is a very computing-intensive process. It is called the <quote ->Raster Imaging Process</quote ->, more commonly <quote -><acronym ->RIP</acronym -></quote ->).</para> - -<para ->With &PostScript; printers the <acronym ->RIP</acronym ->-ping is taken care of by the device itself. You just send the &PostScript; file to it. The <quote ->Raster Imaging Processor</quote -> (also called the <acronym ->RIP</acronym ->) inside the printer is responsible (and specialized) to fulfill quite well this task of interpreting the &PostScript;-page descriptions and put the raster image on paper.</para> - -<para ->Smaller &PostScript; devices have a hardware-<acronym ->RIP</acronym -> built in; it is etched in silicon, on a special chip. Big professional printers often have their <acronym ->RIP</acronym -> implemented as a software-<acronym ->RIP</acronym -> inside a dedicated fast &UNIX; run computer, often a Sun SPARC Solaris or a &SGI; &IRIX; machine.</para> +<title><acronym>RIP</acronym>: From &PostScript; to Raster</title> + +<para>Before the final raster images are put on paper cut-sheets, they have to be calculated somehow out of their abstract &PostScript; representation. This is a very computing-intensive process. It is called the <quote>Raster Imaging Process</quote>, more commonly <quote><acronym>RIP</acronym></quote>).</para> + +<para>With &PostScript; printers the <acronym>RIP</acronym>-ping is taken care of by the device itself. You just send the &PostScript; file to it. The <quote>Raster Imaging Processor</quote> (also called the <acronym>RIP</acronym>) inside the printer is responsible (and specialized) to fulfill quite well this task of interpreting the &PostScript;-page descriptions and put the raster image on paper.</para> + +<para>Smaller &PostScript; devices have a hardware-<acronym>RIP</acronym> built in; it is etched in silicon, on a special chip. Big professional printers often have their <acronym>RIP</acronym> implemented as a software-<acronym>RIP</acronym> inside a dedicated fast &UNIX; run computer, often a Sun SPARC Solaris or a &SGI; &IRIX; machine.</para> </sect2> <sect2> -<title -><application ->Ghostscript</application -> as a Software <acronym ->RIP</acronym -></title> +<title><application>Ghostscript</application> as a Software <acronym>RIP</acronym></title> -<para ->But what happens, if you are not lucky enough to have a &PostScript; printer available?</para> +<para>But what happens, if you are not lucky enough to have a &PostScript; printer available?</para> -<para ->You need to do the <acronym ->RIP</acronym ->-ing before you send the print data to the marking engine. You need to digest the &PostScript; generated by your application on the host machine (the print client) itself. You need to know how the exact raster format of the target printer's marking engine must be composed.</para> +<para>You need to do the <acronym>RIP</acronym>-ing before you send the print data to the marking engine. You need to digest the &PostScript; generated by your application on the host machine (the print client) itself. You need to know how the exact raster format of the target printer's marking engine must be composed.</para> -<para ->In other words, as you can't rely on the printer to understand and interpret the &PostScript; itself, the issue becomes quite a bit more complicated. You need software that tries to solve for you the issues involved.</para> +<para>In other words, as you can't rely on the printer to understand and interpret the &PostScript; itself, the issue becomes quite a bit more complicated. You need software that tries to solve for you the issues involved.</para> -<para ->This is exactly what the omnipresent &ghostscript; package is doing for many &Linux;, *BSD and other &UNIX; boxes that need to print to non-&PostScript; printers: &ghostscript; is a &PostScript; interpreter, a software <acronym ->RIP</acronym -> capable of running many different devices.</para> +<para>This is exactly what the omnipresent &ghostscript; package is doing for many &Linux;, *BSD and other &UNIX; boxes that need to print to non-&PostScript; printers: &ghostscript; is a &PostScript; interpreter, a software <acronym>RIP</acronym> capable of running many different devices.</para> </sect2> <sect2> -<title -><quote ->Drivers</quote -> and <quote ->Filters</quote -> in General</title> - -<para ->To produce rasterised bitmaps from &PostScript; input, the concept of <quote ->filters</quote -> is used by &ghostscript;. There are many different filters in &ghostscript;, some of them specialised for a certain model of printer. &ghostscript; filterspecializedin devices have often been developed without the consent or support of the manufacturer concerned. Without access to the specifications and documentation, it was a very painstaking process to reverse engineer protocols and data formats.</para> - -<para ->Not all &ghostscript; filters work equally well for their printers. Yet, some of the newer ones, like the <application ->stp</application -> Filter of the <application ->Gimp</application -> Print project, produce excellent results leading to photographic quality on a par or even superior to their &Microsoft; &Windows; driver counterparts.</para> - -<para ->&PostScript; is what most application programs produce for printing in &UNIX; and &Linux;. Filters are the true workhorses of any printing system there. Essentially they produce the right bitmaps from any &PostScript; input for non-&PostScript; target engines.</para> +<title><quote>Drivers</quote> and <quote>Filters</quote> in General</title> + +<para>To produce rasterised bitmaps from &PostScript; input, the concept of <quote>filters</quote> is used by &ghostscript;. There are many different filters in &ghostscript;, some of them specialised for a certain model of printer. &ghostscript; filterspecializedin devices have often been developed without the consent or support of the manufacturer concerned. Without access to the specifications and documentation, it was a very painstaking process to reverse engineer protocols and data formats.</para> + +<para>Not all &ghostscript; filters work equally well for their printers. Yet, some of the newer ones, like the <application>stp</application> Filter of the <application>Gimp</application> Print project, produce excellent results leading to photographic quality on a par or even superior to their &Microsoft; &Windows; driver counterparts.</para> + +<para>&PostScript; is what most application programs produce for printing in &UNIX; and &Linux;. Filters are the true workhorses of any printing system there. Essentially they produce the right bitmaps from any &PostScript; input for non-&PostScript; target engines.</para> </sect2> <sect2> -<title ->Drivers and Filters and Backends in CUPS</title> +<title>Drivers and Filters and Backends in CUPS</title> -<para ->&CUPS; uses its own filters, though the filtering system is based on Ghostscript. Namely the pstoraster and the imagetoraster filters are directly derived from Ghostscript code. &CUPS; has reorganised and streamlined the whole mechanics of this legacy code and organised it into a few clear and distinct modules.</para> +<para>&CUPS; uses its own filters, though the filtering system is based on Ghostscript. Namely the pstoraster and the imagetoraster filters are directly derived from Ghostscript code. &CUPS; has reorganised and streamlined the whole mechanics of this legacy code and organised it into a few clear and distinct modules.</para> -<para ->This next drawing (done with the help of &kivio;) gives an overview of the filters and backends inside &CUPS; and how they fit together. The <quote ->flow</quote -> is from top to bottom. Backends are special filters: they don't convert date to a different format, but they send the ready files to the printer. There are different backends for different transfer protocols.</para> +<para>This next drawing (done with the help of &kivio;) gives an overview of the filters and backends inside &CUPS; and how they fit together. The <quote>flow</quote> is from top to bottom. Backends are special filters: they don't convert date to a different format, but they send the ready files to the printer. There are different backends for different transfer protocols.</para> <screenshot id="architecture-diagram"> -<screeninfo ->&kprinter; dialogue started (&kivio; draft drawing) </screeninfo> +<screeninfo>&kprinter; dialogue started (&kivio; draft drawing) </screeninfo> <mediaobject> <imageobject> <imagedata fileref="cups-filterarchitecture-kivio-70Percent-scaled.png" format="PNG"/></imageobject> <textobject> -<phrase ->&kprinter; dialogue started (&kivio; draft drawing)</phrase -></textobject> +<phrase>&kprinter; dialogue started (&kivio; draft drawing)</phrase></textobject> </mediaobject> </screenshot> </sect2> <sect2> -<title ->Spoolers and Printing Daemons</title> +<title>Spoolers and Printing Daemons</title> -<para ->Besides the heavy part of the filtering task to generate a print-ready bitmap, any printing software needs to use a SPOOLing mechanism: this is to line up different jobs from different users for different printers and different filters and send them accordingly to the destinations. The printing daemon takes care of all this.</para> +<para>Besides the heavy part of the filtering task to generate a print-ready bitmap, any printing software needs to use a SPOOLing mechanism: this is to line up different jobs from different users for different printers and different filters and send them accordingly to the destinations. The printing daemon takes care of all this.</para> -<para ->This daemon is keeping the house in order: it is also responsible for the job control: users should be allowed to cancel, stop, restart, &etc; their jobs (but not other peoples's jobs) and so on.</para> +<para>This daemon is keeping the house in order: it is also responsible for the job control: users should be allowed to cancel, stop, restart, &etc; their jobs (but not other peoples's jobs) and so on.</para> </sect2> @@ -280,258 +146,117 @@ format="PNG"/></imageobject> <sect1 id="cups-and-ppd"> -<title ->Excursion: How <quote ->CUPS</quote -> uses the power of &PPD;s</title> - -<para ->Now that you know how a &PostScript; language file (which describes the page layout in a largely device independent way) is transformed into a Raster Image, you might ask: <quote ->Well, there are different kinds of raster output devices: first they differ in their resolution; then there are the different paper sizes; it goes on with many finishing options (duplex prints, pamphlets, punched and stapled output with different sheets of coloured paper being drawn from different trays, &etc;). How does this fit into our model of device-independent &PostScript;?</quote -></para> - -<para ->The answer comes with so called &PostScript; Printer Description (&PPD; files. A &PPD; describes all the device dependent features which can be utilised by a certain printer model. It also contains the coded commands that must be used to call certain features of the device. But &PPD;s are not a closed book, they are simple <acronym ->ASCII</acronym -> text files.</para> - -<para ->&PPD;s were <quote ->invented</quote -> by Adobe to make it easy for manufacturers to implement their own features into &PostScript; printers, and at the same time retain a standard way of doing so. &PPD;s are well documented and described by Adobe. Their specification is a de-facto open standard.</para> +<title>Excursion: How <quote>CUPS</quote> uses the power of &PPD;s</title> + +<para>Now that you know how a &PostScript; language file (which describes the page layout in a largely device independent way) is transformed into a Raster Image, you might ask: <quote>Well, there are different kinds of raster output devices: first they differ in their resolution; then there are the different paper sizes; it goes on with many finishing options (duplex prints, pamphlets, punched and stapled output with different sheets of coloured paper being drawn from different trays, &etc;). How does this fit into our model of device-independent &PostScript;?</quote></para> + +<para>The answer comes with so called &PostScript; Printer Description (&PPD; files. A &PPD; describes all the device dependent features which can be utilised by a certain printer model. It also contains the coded commands that must be used to call certain features of the device. But &PPD;s are not a closed book, they are simple <acronym>ASCII</acronym> text files.</para> + +<para>&PPD;s were <quote>invented</quote> by Adobe to make it easy for manufacturers to implement their own features into &PostScript; printers, and at the same time retain a standard way of doing so. &PPD;s are well documented and described by Adobe. Their specification is a de-facto open standard.</para> <sect2 id="ppd-files"> -<title ->Device Dependent Print Options</title> +<title>Device Dependent Print Options</title> -<para ->Remember, advanced &PostScript; printing was originally only developed for use on &Microsoft; &Windows; and Apple &Mac; systems. For a long time, all of the feature rich printing on modern devices was simply unavailable for &Linux; and &UNIX;. &CUPS; changes this decisively. &CUPS; is closely tied with &PPD;s, and therefore existing &PPD;s can be utilised to the full by all systems powered by &CUPS;.</para> +<para>Remember, advanced &PostScript; printing was originally only developed for use on &Microsoft; &Windows; and Apple &Mac; systems. For a long time, all of the feature rich printing on modern devices was simply unavailable for &Linux; and &UNIX;. &CUPS; changes this decisively. &CUPS; is closely tied with &PPD;s, and therefore existing &PPD;s can be utilised to the full by all systems powered by &CUPS;.</para> -<para ->Using &PPD;s, printer manufacturers were able to insert device-specific hardware features into their products, for features such as duplexing, stapling, punching, finishing, &etc;. The printer drivers load this &PPD; just like an additional configuration file. Thus the printer driver learns about the available device options and how to call them; the driver also presents them in a &GUI; to the user. Through this mechanism you are still able to print <quote ->device-independent</quote -> &PostScript; page description language files and specify device-dependent finishing options on top, which are added to the application-generated &PostScript;.</para> +<para>Using &PPD;s, printer manufacturers were able to insert device-specific hardware features into their products, for features such as duplexing, stapling, punching, finishing, &etc;. The printer drivers load this &PPD; just like an additional configuration file. Thus the printer driver learns about the available device options and how to call them; the driver also presents them in a &GUI; to the user. Through this mechanism you are still able to print <quote>device-independent</quote> &PostScript; page description language files and specify device-dependent finishing options on top, which are added to the application-generated &PostScript;.</para> </sect2> <sect2> -<title ->Where to get the &PPD;s for &PostScript; Printers</title> +<title>Where to get the &PPD;s for &PostScript; Printers</title> -<para ->&PPD;s originally were not used routinely in &UNIX; and &Linux; systems. The vendors providing those &PPD;s never intended them for anything other than the originally supported &OS;s: &Microsoft; &Windows; and &MacOS;. Through its brilliant move to fully support and utilise the existing &PPD; specification, &CUPS; now gives the power to use all features of modern printers to users of &Linux; and &Linux;-like systems. &tdeprint; makes its usage even more comfortable than the &CUPS; developers ever dreamed of.</para> +<para>&PPD;s originally were not used routinely in &UNIX; and &Linux; systems. The vendors providing those &PPD;s never intended them for anything other than the originally supported &OS;s: &Microsoft; &Windows; and &MacOS;. Through its brilliant move to fully support and utilise the existing &PPD; specification, &CUPS; now gives the power to use all features of modern printers to users of &Linux; and &Linux;-like systems. &tdeprint; makes its usage even more comfortable than the &CUPS; developers ever dreamed of.</para> -<para ->&CUPS; can use original &Windows; &PPD;s, distributed by the vendors in the case of &PostScript; printers. Those normally don't cost any money, and they can be grabbed from any &Windows; computer with an installed &PostScript; driver for the model concerned, or from the disks provided with the printer. There are also several places on the web to download them.</para> +<para>&CUPS; can use original &Windows; &PPD;s, distributed by the vendors in the case of &PostScript; printers. Those normally don't cost any money, and they can be grabbed from any &Windows; computer with an installed &PostScript; driver for the model concerned, or from the disks provided with the printer. There are also several places on the web to download them.</para> </sect2> <sect2> -<title ->How Special &PPD;s are Now Useful Even For Non-&PostScript; Printers.</title> +<title>How Special &PPD;s are Now Useful Even For Non-&PostScript; Printers.</title> -<para ->Now you know how &PostScript;-Printers can use &PPD;s. But what about non-&PostScript; printers? &CUPS; has done a very good trick: by using the same format and data structure as the &PostScript; Printer Descriptions (&PPD;s) in the &PostScript; world, it can describe the available print job options for non-&PostScript; printers just the same. For its own special purposes &CUPS; just added a few special options (namely the line which defines the filter to be used for further processing of the &PostScript; file).</para> +<para>Now you know how &PostScript;-Printers can use &PPD;s. But what about non-&PostScript; printers? &CUPS; has done a very good trick: by using the same format and data structure as the &PostScript; Printer Descriptions (&PPD;s) in the &PostScript; world, it can describe the available print job options for non-&PostScript; printers just the same. For its own special purposes &CUPS; just added a few special options (namely the line which defines the filter to be used for further processing of the &PostScript; file).</para> -<para ->So, the developers could use the same software engine to parse the Printer Description Files for available options for all sorts of printers. Of course the &CUPS; developers could not rely on the non-&PostScript; hardware manufacturers to suddenly develop &PPD;s. They had to do the difficult start themselves and write them from scratch. More than 1000 of these are available through the commercial version of &CUPS;, called <application ->ESP PrintPro</application ->.</para> +<para>So, the developers could use the same software engine to parse the Printer Description Files for available options for all sorts of printers. Of course the &CUPS; developers could not rely on the non-&PostScript; hardware manufacturers to suddenly develop &PPD;s. They had to do the difficult start themselves and write them from scratch. More than 1000 of these are available through the commercial version of &CUPS;, called <application>ESP PrintPro</application>.</para> -<para ->Meanwhile there are a lot of &CUPS;-specific &PPD;s available. Even now those are in most cases not originating from the printer manufacturers, but from Free software developers. The &CUPS; folks proofed it, and others followed suit: where &Linux; and &UNIX; printing one or two years ago still was a kludge, it is now able to support a big range of printers, including 7-colour inkjets capable of pushing them to Photo Quality output.</para> +<para>Meanwhile there are a lot of &CUPS;-specific &PPD;s available. Even now those are in most cases not originating from the printer manufacturers, but from Free software developers. The &CUPS; folks proofed it, and others followed suit: where &Linux; and &UNIX; printing one or two years ago still was a kludge, it is now able to support a big range of printers, including 7-colour inkjets capable of pushing them to Photo Quality output.</para> </sect2> <sect2> -<title ->Different Ways to get &PPD;s for non-&PostScript; Printers</title> +<title>Different Ways to get &PPD;s for non-&PostScript; Printers</title> -<para ->You can get &PPD;s to be used with &CUPS; and non-&PostScript; printers from different areas in the Web:</para> +<para>You can get &PPD;s to be used with &CUPS; and non-&PostScript; printers from different areas in the Web:</para> <itemizedlist> <listitem> -<para ->first, there is the repository at <ulink url="http://www.linuxprinting.org" ->www.linuxprinting.org</ulink ->, which lets you generate a <quote ->CUPS-O-Matic</quote ->-&PPD; online for any printer that had been supported by traditional &ghostscript; printing already. This helps you to switch over to &CUPS; with little effort, if you wish so. If your printer was doing well with the traditional way of &ghostscript; printing, take CUPS-O-Matic to plug your driver into the &CUPS; system and you'll have the best of both worlds.</para> +<para>first, there is the repository at <ulink url="http://www.linuxprinting.org">www.linuxprinting.org</ulink>, which lets you generate a <quote>CUPS-O-Matic</quote>-&PPD; online for any printer that had been supported by traditional &ghostscript; printing already. This helps you to switch over to &CUPS; with little effort, if you wish so. If your printer was doing well with the traditional way of &ghostscript; printing, take CUPS-O-Matic to plug your driver into the &CUPS; system and you'll have the best of both worlds.</para> </listitem> <listitem> -<para ->second, there are &CUPS;-&PPD;s for the more than 120 printer models, which are driven by the new universal <application ->stp</application -> driver. <application ->stp</application -> (stood originally for Stylus Photo) is now developed by the gimp-print project; it was started by Mike Sweet, the leading &CUPS; developer and is now available through <ulink url="http://gimp-print.sourceforge.net" ->gimp-print.sourceforge.net</ulink ->. This driver prints real Photo quality on many modern inkjets and can be configured to make 120 &CUPS;-&PPD;s along its own compilation. &HP; Laser- and DeskJet, <trademark class="registered" ->Epson</trademark -> Stylus and Photo Colour models as well as some <trademark class="registered" ->Canon</trademark -> and <trademark class="registered" ->Lexmark</trademark -> are covered.</para> +<para>second, there are &CUPS;-&PPD;s for the more than 120 printer models, which are driven by the new universal <application>stp</application> driver. <application>stp</application> (stood originally for Stylus Photo) is now developed by the gimp-print project; it was started by Mike Sweet, the leading &CUPS; developer and is now available through <ulink url="http://gimp-print.sourceforge.net">gimp-print.sourceforge.net</ulink>. This driver prints real Photo quality on many modern inkjets and can be configured to make 120 &CUPS;-&PPD;s along its own compilation. &HP; Laser- and DeskJet, <trademark class="registered">Epson</trademark> Stylus and Photo Colour models as well as some <trademark class="registered">Canon</trademark> and <trademark class="registered">Lexmark</trademark> are covered.</para> </listitem> <listitem> -<para ->third, there is the commercial extension to &CUPS; from the &CUPS; developers themselves: it is called <application ->ESP PrintPro</application -> and comes with more than 2.300 printer drivers. There are even improved imagetoraster and pstoraster filters included.</para> +<para>third, there is the commercial extension to &CUPS; from the &CUPS; developers themselves: it is called <application>ESP PrintPro</application> and comes with more than 2.300 printer drivers. There are even improved imagetoraster and pstoraster filters included.</para> </listitem> </itemizedlist> -<para ->&CUPS; makes it really easy for manufacturers to start supporting &Linux; and &UNIX; printing for their models at reasonably low cost. The modular framework of &CUPS; facilitates to plug in any filter (=driver) with minimal effort and to access and utilise the whole printing framework that &CUPS; is creating.</para> +<para>&CUPS; makes it really easy for manufacturers to start supporting &Linux; and &UNIX; printing for their models at reasonably low cost. The modular framework of &CUPS; facilitates to plug in any filter (=driver) with minimal effort and to access and utilise the whole printing framework that &CUPS; is creating.</para> -<para ->Read more about the exciting &CUPS; features in the available &CUPS; documentation at <ulink url="http://www.cups.org/documentation.html" ->http://www.cups.org/documentation.html</ulink -> and <ulink url="http://wwww.danka.de/printpro/faq.html" ->http://www.danka.de/printpro/faq.html</ulink ->. Also at <ulink url="http://www.linuxprinting.org" ->http://www.linuxprinting.org/</ulink -> is a universal repository for all issues related to &Linux; and &UNIX; printing.</para> +<para>Read more about the exciting &CUPS; features in the available &CUPS; documentation at <ulink url="http://www.cups.org/documentation.html">http://www.cups.org/documentation.html</ulink> and <ulink url="http://wwww.danka.de/printpro/faq.html">http://www.danka.de/printpro/faq.html</ulink>. Also at <ulink url="http://www.linuxprinting.org">http://www.linuxprinting.org/</ulink> is a universal repository for all issues related to &Linux; and &UNIX; printing.</para> </sect2> </sect1> <sect1 id="cups-ipp-support"> -<title ->How &IPP; Support Makes &CUPS; the Best Choice Around</title> +<title>How &IPP; Support Makes &CUPS; the Best Choice Around</title> <sect2> -<title -><quote -><acronym ->LPD</acronym -> Must Die!</quote -></title> - -<para ->For a long time many developers were deeply dissatisfied with good old <acronym ->LPD</acronym ->. Quite a few new projects were started to improve printing: <application ->LPRng</application -> is the best known example. Others are <acronym ->PDQ</acronym ->, <acronym ->PPR</acronym ->, <acronym ->PLP</acronym ->, <acronym ->GNUlpr</acronym -> and <acronym ->RLPR</acronym ->. But none of the new programs were seen as a <quote ->big shot</quote ->; most of them are just implementing the same old <acronym ->LPD</acronym -> specification with a few (or many) new extensions, which again make them incompatible with each other.</para> - -<para ->Having seen the development of not just one, but different viable alternatives to venerable <acronym ->BSD</acronym ->-style <acronym ->LPD</acronym ->, Grant Taylor, author of the <citetitle ->Linux Printing HOWTO</citetitle ->, finally rallied the call <citetitle ->LPD Must Die!</citetitle -> in his <quote ->Campaign To Abolish The Line Printer Daemon</quote ->.</para> +<title><quote><acronym>LPD</acronym> Must Die!</quote></title> + +<para>For a long time many developers were deeply dissatisfied with good old <acronym>LPD</acronym>. Quite a few new projects were started to improve printing: <application>LPRng</application> is the best known example. Others are <acronym>PDQ</acronym>, <acronym>PPR</acronym>, <acronym>PLP</acronym>, <acronym>GNUlpr</acronym> and <acronym>RLPR</acronym>. But none of the new programs were seen as a <quote>big shot</quote>; most of them are just implementing the same old <acronym>LPD</acronym> specification with a few (or many) new extensions, which again make them incompatible with each other.</para> + +<para>Having seen the development of not just one, but different viable alternatives to venerable <acronym>BSD</acronym>-style <acronym>LPD</acronym>, Grant Taylor, author of the <citetitle>Linux Printing HOWTO</citetitle>, finally rallied the call <citetitle>LPD Must Die!</citetitle> in his <quote>Campaign To Abolish The Line Printer Daemon</quote>.</para> <!-- FIXME: look up URLs for the above --> </sect2> <sect2> -<title ->How the &IPP; Came to Be</title> - -<para ->Along with the above, on the industry side of things, there were efforts to overcome the well-known weaknesses of <acronym ->LPD</acronym ->. It started with proprietary extensions to plain old <acronym ->LPD</acronym ->, and stretched as far as &Hewlett-Packard;'s attempt to establish &HP; JetDirect as a new standard for a network printing protocol. The result were even more incompatibilities.</para> - -<para ->In the end, an initiative to define a new common industry and <acronym ->IETF</acronym -> standard took shape. The <quote ->Printer Working Group</quote -> or <acronym ->PWG</acronym ->, a loose aggregation of vendors in hardware, software, and operating systems, drafted the new <quote ->Internet Printing Protocol</quote ->, &IPP;. &IPP; v1.1 has now been approved by the <acronym ->IETF</acronym -> (Internet Engineering Task Force) as a proposed standard, and now enjoys the unanimous support throughout the industry in Europe, USA and Japan. Most current network printer models have now built in &IPP; support on top of traditional <acronym ->LPR</acronym ->/<acronym ->LPD</acronym -> or JetDirect Printing.</para> +<title>How the &IPP; Came to Be</title> + +<para>Along with the above, on the industry side of things, there were efforts to overcome the well-known weaknesses of <acronym>LPD</acronym>. It started with proprietary extensions to plain old <acronym>LPD</acronym>, and stretched as far as &Hewlett-Packard;'s attempt to establish &HP; JetDirect as a new standard for a network printing protocol. The result were even more incompatibilities.</para> + +<para>In the end, an initiative to define a new common industry and <acronym>IETF</acronym> standard took shape. The <quote>Printer Working Group</quote> or <acronym>PWG</acronym>, a loose aggregation of vendors in hardware, software, and operating systems, drafted the new <quote>Internet Printing Protocol</quote>, &IPP;. &IPP; v1.1 has now been approved by the <acronym>IETF</acronym> (Internet Engineering Task Force) as a proposed standard, and now enjoys the unanimous support throughout the industry in Europe, USA and Japan. Most current network printer models have now built in &IPP; support on top of traditional <acronym>LPR</acronym>/<acronym>LPD</acronym> or JetDirect Printing.</para> </sect2> <sect2> -<title ->Why &IPP; is Solving Many Problems</title> +<title>Why &IPP; is Solving Many Problems</title> -<para ->&IPP; promises to solve a lot of problems network administrators face. This trade normally deals with heterogeneous network environments and spends more than half of its working hours dealing with printing problems.</para> +<para>&IPP; promises to solve a lot of problems network administrators face. This trade normally deals with heterogeneous network environments and spends more than half of its working hours dealing with printing problems.</para> -<para ->By creating a unified set of query functions for &IPP; enabled printers and servers, for transferring files and setting job-control attributes &etc;, &IPP; is destined to work across all &OS; platforms. It's rollout however, will not happen overnight, as many legacy print devices will still be in use for many years to come. Therefore, in &IPP; there is a provision made for backwards compatibility of all &IPP; implementations. &CUPS; is proving the viability of &IPP; printing in all environments.</para> +<para>By creating a unified set of query functions for &IPP; enabled printers and servers, for transferring files and setting job-control attributes &etc;, &IPP; is destined to work across all &OS; platforms. It's rollout however, will not happen overnight, as many legacy print devices will still be in use for many years to come. Therefore, in &IPP; there is a provision made for backwards compatibility of all &IPP; implementations. &CUPS; is proving the viability of &IPP; printing in all environments.</para> -<para ->The most striking advantage will be it's integration into the existing set of other robust <acronym ->IP</acronym -> protocols. Being an extension of the proven and robust <acronym ->HTTP</acronym -> 1.1 protocol, for the special task of handling print file and related data, it is also very easy to plug in other standards as they are being developed and deployed:</para> +<para>The most striking advantage will be it's integration into the existing set of other robust <acronym>IP</acronym> protocols. Being an extension of the proven and robust <acronym>HTTP</acronym> 1.1 protocol, for the special task of handling print file and related data, it is also very easy to plug in other standards as they are being developed and deployed:</para> <itemizedlist> <listitem> -<para ->Basic, Digest, and Certificate Authentication for users seeking access to print services.</para> +<para>Basic, Digest, and Certificate Authentication for users seeking access to print services.</para> </listitem> <listitem> -<para ->SSL3 and <acronym ->TLS</acronym -> encryption for transferring data.</para> +<para>SSL3 and <acronym>TLS</acronym> encryption for transferring data.</para> </listitem> <listitem> -<para ->Bi directional communication of clients with print devices, using the <acronym ->HTTP</acronym ->/&IPP; <command ->GET</command -> and <command ->POST</command -> mechanism.</para> +<para>Bi directional communication of clients with print devices, using the <acronym>HTTP</acronym>/&IPP; <command>GET</command> and <command>POST</command> mechanism.</para> </listitem> <listitem> -<para ->LDAP directory service integration to keep a consistent database of available printers, their capabilities and page-costs, &etc;, as well as user passwords, <acronym ->ACL</acronym ->s &etc;.</para> +<para>LDAP directory service integration to keep a consistent database of available printers, their capabilities and page-costs, &etc;, as well as user passwords, <acronym>ACL</acronym>s &etc;.</para> </listitem> <listitem> -<para -><quote ->Pull</quote -> (as opposed to the usual <quote ->Push</quote -> model) printing, where a server or printer just needs to be told the &URL; of a document, whereupon it is retrieved from the resource on the internet and printed.</para> +<para><quote>Pull</quote> (as opposed to the usual <quote>Push</quote> model) printing, where a server or printer just needs to be told the &URL; of a document, whereupon it is retrieved from the resource on the internet and printed.</para> </listitem> </itemizedlist> @@ -539,147 +264,63 @@ format="PNG"/></imageobject> <!-- <sect2> -<title ->&CUPS;, &IPP; and &kde;</title> +<title>&CUPS;, &IPP; and &kde;</title> -<para ->&CUPS; is the most advanced implementation of &IPP; on all &OS; +<para>&CUPS; is the most advanced implementation of &IPP; on all &OS; platforms. That makes &CUPS; a crucial ally to help "conquer the desktop" for projects like &kde;. &tdeprint; is the best utility to make &CUPS; core functionality available to &kde; Desktop users.</para> -</sect2 -> --> +</sect2> --> <sect2> -<title ->Printer <quote ->Plug'n'Play</quote -> for Clients</title> - -<para ->Have you ever seen a demonstration about &CUPS; capabilities in the network? You must have been quite impressed if you didn't know in advance what to expect.</para> - -<para ->Imagine you as the administrator of a <quote ->LAN</quote ->. For testing purposes you fully installed one &kde;/&CUPS; box on your net, complete with a dozen printers configured and functional: &PostScript;, LaserJets, InkJets and BubbleJets, and so on. Your &kde; users on that box are very happy, they can print like never before, <quote ->ringing all the bells and whistles</quote -> of every printer. It took you 2 hours to make everything run perfectly... and now all the other 100 users on the network want the same. Two hours again for every box? No way you could do that before next year, you think?</para> - -<para ->Wrong. Just change one setting in the original &CUPS; box to make it a <quote ->server</quote ->. Install &CUPS; on five other boxes, as <quote ->clients</quote ->. By the time you turn back to your first client, you find the users happily playing with the settings for the dozen printers you had defined earlier on the <quote ->server</quote ->. Somehow magically the printers had appeared on all the <quote ->Print</quote -> dialogues of the five new &CUPS; client boxes.</para> - -<para ->Your users print, but not a single driver had been installed on the clients, nor a printer queue defined.</para> - -<para ->So, how does this magic work?</para> +<title>Printer <quote>Plug'n'Play</quote> for Clients</title> + +<para>Have you ever seen a demonstration about &CUPS; capabilities in the network? You must have been quite impressed if you didn't know in advance what to expect.</para> + +<para>Imagine you as the administrator of a <quote>LAN</quote>. For testing purposes you fully installed one &kde;/&CUPS; box on your net, complete with a dozen printers configured and functional: &PostScript;, LaserJets, InkJets and BubbleJets, and so on. Your &kde; users on that box are very happy, they can print like never before, <quote>ringing all the bells and whistles</quote> of every printer. It took you 2 hours to make everything run perfectly... and now all the other 100 users on the network want the same. Two hours again for every box? No way you could do that before next year, you think?</para> + +<para>Wrong. Just change one setting in the original &CUPS; box to make it a <quote>server</quote>. Install &CUPS; on five other boxes, as <quote>clients</quote>. By the time you turn back to your first client, you find the users happily playing with the settings for the dozen printers you had defined earlier on the <quote>server</quote>. Somehow magically the printers had appeared on all the <quote>Print</quote> dialogues of the five new &CUPS; client boxes.</para> + +<para>Your users print, but not a single driver had been installed on the clients, nor a printer queue defined.</para> + +<para>So, how does this magic work?</para> </sect2> <sect2> -<title -><quote ->Seeing</quote -> Printers Not Installed Locally?</title> - -<para ->The answer is not complicated at all.</para> - -<para ->If a &CUPS; server is on the <acronym ->LAN</acronym ->, it broadcasts the names of all available printers to the <acronym ->LAN</acronym ->, using the <acronym ->UDP</acronym -> protocol and port 631. Port 631 is reserved as a <quote ->well-known port</quote -> by <acronym ->IANA</acronym -> (the <quote ->Internet Assigning Numbers Authority</quote ->) for &IPP; purposes. All &CUPS; clients listen to &CUPS; server info sent to their port 631. That's how they know about available printers, and that's how they learn about the <quote ->path</quote -> to the printers as well.</para> - -<para ->Using &IPP;, which is really a clever extension to <acronym ->HTTP</acronym -> v1.1, &CUPS; is able to address all objects related to the printing system via <quote ->Universal Resource Locators</quote -> or <acronym ->URL</acronym ->s. Print jobs to be deleted or restarted, printers to be queried or modified, admin tasks to be performed on the server, with &IPP; and &CUPS;, everything is addressable by a certain <acronym ->URL</acronym ->. Many important things can be done through the web interface to &CUPS;, accessible for example with &konqueror;.</para> +<title><quote>Seeing</quote> Printers Not Installed Locally?</title> + +<para>The answer is not complicated at all.</para> + +<para>If a &CUPS; server is on the <acronym>LAN</acronym>, it broadcasts the names of all available printers to the <acronym>LAN</acronym>, using the <acronym>UDP</acronym> protocol and port 631. Port 631 is reserved as a <quote>well-known port</quote> by <acronym>IANA</acronym> (the <quote>Internet Assigning Numbers Authority</quote>) for &IPP; purposes. All &CUPS; clients listen to &CUPS; server info sent to their port 631. That's how they know about available printers, and that's how they learn about the <quote>path</quote> to the printers as well.</para> + +<para>Using &IPP;, which is really a clever extension to <acronym>HTTP</acronym> v1.1, &CUPS; is able to address all objects related to the printing system via <quote>Universal Resource Locators</quote> or <acronym>URL</acronym>s. Print jobs to be deleted or restarted, printers to be queried or modified, admin tasks to be performed on the server, with &IPP; and &CUPS;, everything is addressable by a certain <acronym>URL</acronym>. Many important things can be done through the web interface to &CUPS;, accessible for example with &konqueror;.</para> </sect2> <sect2> -<title ->Printing Without Installing a Driver</title> - -<para ->And more, the clients basically can <quote ->administer</quote -> and <quote ->use</quote -> any printer they see, just as if it was a locally installed one. Of course, you can set restrictions on it with access control lists &etc;, so that not <emphasis ->any</emphasis -> clients may use <emphasis ->any</emphasis -> printer as it likes.</para> - -<para ->The clients even are able to print without the appropriate filter (or driver) installed locally.</para> - -<para ->So how does this work? If a client wants to know about and select printer-specific options, it sends a request (called <command ->CUPS-get-ppd</command ->) to the server. The server tells the client all about all printer-specific options, as read from the server side &PPD;. The user on the client side can see the options and select the required ones. He then sends the print file, usually unfiltered <quote ->raw</quote -> &PostScript;, spiced up with the printer-options to the printer server, using &IPP; as the transport protocol. All further processing, especially the filtering to generate the final format for the target printer, is then done by the server. The server has the necessary programs (<quote ->drivers</quote -> or <quote ->filters</quote ->) to do this.</para> - -<para ->This way a client prints without needing to install a driver locally.</para> - -<para ->Any change on the server, such as adding or modifying a printer, is instantly <quote ->known</quote -> to the clients with no further configuration.</para> +<title>Printing Without Installing a Driver</title> + +<para>And more, the clients basically can <quote>administer</quote> and <quote>use</quote> any printer they see, just as if it was a locally installed one. Of course, you can set restrictions on it with access control lists &etc;, so that not <emphasis>any</emphasis> clients may use <emphasis>any</emphasis> printer as it likes.</para> + +<para>The clients even are able to print without the appropriate filter (or driver) installed locally.</para> + +<para>So how does this work? If a client wants to know about and select printer-specific options, it sends a request (called <command>CUPS-get-ppd</command>) to the server. The server tells the client all about all printer-specific options, as read from the server side &PPD;. The user on the client side can see the options and select the required ones. He then sends the print file, usually unfiltered <quote>raw</quote> &PostScript;, spiced up with the printer-options to the printer server, using &IPP; as the transport protocol. All further processing, especially the filtering to generate the final format for the target printer, is then done by the server. The server has the necessary programs (<quote>drivers</quote> or <quote>filters</quote>) to do this.</para> + +<para>This way a client prints without needing to install a driver locally.</para> + +<para>Any change on the server, such as adding or modifying a printer, is instantly <quote>known</quote> to the clients with no further configuration.</para> </sect2> <sect2> -<title -><quote ->Zero Administration</quote ->, Load Balancing, and <quote ->Failover Switching</quote -></title> - -<para ->Some other advanced features built into &CUPS; are the capacity to do <quote ->load balancing</quote ->.</para> - -<para ->If you define the same printer queues on two or more different servers, the clients will send their jobs to the first responding or available server. This implies an automatic load balancing amongst servers. If you have to take one server off the network for maintenance, the others will just take over its tasks without the users even noticing the difference.</para> +<title><quote>Zero Administration</quote>, Load Balancing, and <quote>Failover Switching</quote></title> + +<para>Some other advanced features built into &CUPS; are the capacity to do <quote>load balancing</quote>.</para> + +<para>If you define the same printer queues on two or more different servers, the clients will send their jobs to the first responding or available server. This implies an automatic load balancing amongst servers. If you have to take one server off the network for maintenance, the others will just take over its tasks without the users even noticing the difference.</para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/tdesu/index.docbook b/tde-i18n-en_GB/docs/tdebase/tdesu/index.docbook index 9f0be4d3b98..86ab90e1b15 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdesu/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdesu/index.docbook @@ -4,472 +4,185 @@ <!ENTITY kappname "&tdesu;"> <!ENTITY package "tdebase"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <book lang="&language;"> <bookinfo> -<title ->The &tdesu; handbook</title> +<title>The &tdesu; handbook</title> <authorgroup> -<author ->&Geert.Jansen; &Geert.Jansen.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Geert.Jansen; &Geert.Jansen.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->2000</year> -<holder ->&Geert.Jansen;</holder> +<year>2000</year> +<holder>&Geert.Jansen;</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2002-01-18</date> -<releaseinfo ->1.00.00</releaseinfo> +<date>2002-01-18</date> +<releaseinfo>1.00.00</releaseinfo> -<abstract -><para ->&tdesu; is a graphical front end for the &UNIX; <command ->su</command -> command.</para -></abstract> +<abstract><para>&tdesu; is a graphical front end for the &UNIX; <command>su</command> command.</para></abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->su</keyword> -<keyword ->password</keyword> -<keyword ->root</keyword> +<keyword>KDE</keyword> +<keyword>su</keyword> +<keyword>password</keyword> +<keyword>root</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introduction</title> - -<para ->Welcome to &tdesu;! &tdesu; is a graphical front end for the &UNIX; <command ->su</command -> command for the K Desktop Environment. It allows you to run a program as different user by supplying the password for that user. &tdesu; is an unprivileged program; it uses the system's <command ->su</command ->.</para> - -<para ->&tdesu; has one additional feature: it can remember passwords for you. If you are using this feature, you only need to enter the password once for each command. See <xref linkend="sec-password-keeping"/> for more information on this and a security analysis.</para> - -<para ->This program is meant to be started from the command line or from <filename ->.desktop</filename -> files. Although it asks for the <systemitem class="username" ->root</systemitem -> password using a &GUI; dialogue, I consider it to be more of a command line <-> &GUI; glue instead of a pure &GUI; program.</para> +<title>Introduction</title> + +<para>Welcome to &tdesu;! &tdesu; is a graphical front end for the &UNIX; <command>su</command> command for the K Desktop Environment. It allows you to run a program as different user by supplying the password for that user. &tdesu; is an unprivileged program; it uses the system's <command>su</command>.</para> + +<para>&tdesu; has one additional feature: it can remember passwords for you. If you are using this feature, you only need to enter the password once for each command. See <xref linkend="sec-password-keeping"/> for more information on this and a security analysis.</para> + +<para>This program is meant to be started from the command line or from <filename>.desktop</filename> files. Although it asks for the <systemitem class="username">root</systemitem> password using a &GUI; dialogue, I consider it to be more of a command line <-> &GUI; glue instead of a pure &GUI; program.</para> </chapter> <chapter id="using-tdesu"> -<title ->Using &tdesu;</title> - -<para ->Usage of &tdesu; is easy. The syntax is like this:</para> - - <cmdsynopsis -><command ->tdesu</command -> <arg ->USER</arg -> <arg ->-n</arg -> <arg ->-t</arg -> <arg ->-q</arg -> <arg ->-d</arg -> <arg ->-f <replaceable ->FILE</replaceable -></arg -> <arg ->-c <group -> <arg -> <replaceable ->COMMAND</replaceable -> <arg -><replaceable ->ARG1</replaceable -></arg -> <arg -><replaceable ->ARG2</replaceable -></arg -> <arg rep="repeat" -><replaceable -></replaceable -></arg -> </arg -> </group -> </arg -> </cmdsynopsis> - - <cmdsynopsis -><command ->tdesu</command -> <group -> <arg ->-v</arg -> <arg ->-h</arg -> <arg ->-s</arg -> </group -> </cmdsynopsis> - -<para ->The command line options are explained below.</para> +<title>Using &tdesu;</title> + +<para>Usage of &tdesu; is easy. The syntax is like this:</para> + + <cmdsynopsis><command>tdesu</command> <arg>USER</arg> <arg>-n</arg> <arg>-t</arg> <arg>-q</arg> <arg>-d</arg> <arg>-f <replaceable>FILE</replaceable></arg> <arg>-c <group> <arg> <replaceable>COMMAND</replaceable> <arg><replaceable>ARG1</replaceable></arg> <arg><replaceable>ARG2</replaceable></arg> <arg rep="repeat"><replaceable></replaceable></arg> </arg> </group> </arg> </cmdsynopsis> + + <cmdsynopsis><command>tdesu</command> <group> <arg>-v</arg> <arg>-h</arg> <arg>-s</arg> </group> </cmdsynopsis> + +<para>The command line options are explained below.</para> <variablelist> <varlistentry> -<term -><option ->-c <replaceable ->PROGRAM</replaceable -></option -></term> -<listitem -><para ->This specifies the program to run as root. It has to be passed in one argument. So if, for example, you want to start a new file manager, you would enter at the prompt: <userinput -><command ->tdesu <option ->-c <replaceable ->kfm -sw</replaceable -></option -></command -></userinput -></para -></listitem> +<term><option>-c <replaceable>PROGRAM</replaceable></option></term> +<listitem><para>This specifies the program to run as root. It has to be passed in one argument. So if, for example, you want to start a new file manager, you would enter at the prompt: <userinput><command>tdesu <option>-c <replaceable>kfm -sw</replaceable></option></command></userinput></para></listitem> </varlistentry> <varlistentry> -<term -><option ->-f <replaceable ->FILE</replaceable -></option -></term> -<listitem -><para ->This option allow efficient use of &tdesu; in <filename ->.desktop</filename -> files. It tells &tdesu; to examine the file specified by <parameter ->FILE</parameter ->. If this file is writable by the current user, &tdesu; will execute the command as the current user. If it is not writable, the command is executed as user <parameter ->USER</parameter -> (defaults to root).</para> -<para -><parameter ->FILE</parameter -> is evaluated like this: if <parameter ->FILE</parameter -> starts with a <literal ->/</literal ->, it is taken as an absolute filename. Otherwise, it is taken as the name of a global &kde; configuration file. For example: to configure the K display manager, <application ->tdm</application ->, you could issue <command ->tdesu <option ->-c tdmconfig -f tdmrc</option -></command -></para -></listitem> +<term><option>-f <replaceable>FILE</replaceable></option></term> +<listitem><para>This option allow efficient use of &tdesu; in <filename>.desktop</filename> files. It tells &tdesu; to examine the file specified by <parameter>FILE</parameter>. If this file is writable by the current user, &tdesu; will execute the command as the current user. If it is not writable, the command is executed as user <parameter>USER</parameter> (defaults to root).</para> +<para><parameter>FILE</parameter> is evaluated like this: if <parameter>FILE</parameter> starts with a <literal>/</literal>, it is taken as an absolute filename. Otherwise, it is taken as the name of a global &kde; configuration file. For example: to configure the K display manager, <application>tdm</application>, you could issue <command>tdesu <option>-c tdmconfig -f tdmrc</option></command></para></listitem> </varlistentry> <varlistentry> -<term -><option ->-t</option -></term> -<listitem -><para ->Enable terminal output. This disables password keeping. This is largely for debugging purposes; if you want to run a console mode app, use the standard <command ->su</command -> instead.</para -> </listitem> +<term><option>-t</option></term> +<listitem><para>Enable terminal output. This disables password keeping. This is largely for debugging purposes; if you want to run a console mode app, use the standard <command>su</command> instead.</para> </listitem> </varlistentry> <varlistentry> -<term -><option ->-n</option -></term> -<listitem -><para ->Do not keep the password. This disables the <guilabel ->keep password</guilabel -> checkbox in the password dialogue.</para -></listitem> +<term><option>-n</option></term> +<listitem><para>Do not keep the password. This disables the <guilabel>keep password</guilabel> checkbox in the password dialogue.</para></listitem> </varlistentry> <varlistentry> -<term -><option ->-q</option -></term> -<listitem -><para ->Be quiet.</para -></listitem> +<term><option>-q</option></term> +<listitem><para>Be quiet.</para></listitem> <!-- Lauri: This could do with a little expansion. quiet as in no screen --> <!-- output, quiet as in no gui prompt for the password, or quiet as in no --> <!-- beeping? --> </varlistentry> <varlistentry> -<term -><option ->-d</option -></term> -<listitem -><para ->Show debug information.</para -></listitem> +<term><option>-d</option></term> +<listitem><para>Show debug information.</para></listitem> </varlistentry> <varlistentry> -<term -><option ->-v</option -></term> -<listitem -><para ->Print version information and exit.</para -></listitem> +<term><option>-v</option></term> +<listitem><para>Print version information and exit.</para></listitem> </varlistentry> <varlistentry> -<term -><option ->-h</option -></term> -<listitem -><para ->Print some help.</para -></listitem> +<term><option>-h</option></term> +<listitem><para>Print some help.</para></listitem> </varlistentry> <varlistentry> -<term -><option ->-s</option -></term> -<listitem -><para ->Stop the tdesu daemon. See <xref linkend="sec-password-keeping"/>.</para -></listitem> +<term><option>-s</option></term> +<listitem><para>Stop the tdesu daemon. See <xref linkend="sec-password-keeping"/>.</para></listitem> </varlistentry> </variablelist> </chapter> <chapter id="configuration"> -<title ->Configuration</title> - -<para ->&tdesu; comes with a control module named <application ->kcmtdesu</application ->. You can find it in the <guimenu ->K</guimenu -> menu under <menuchoice -><guisubmenu ->Settings</guisubmenu -> <guisubmenu ->Applications</guisubmenu -> <guimenuitem ->KDE su</guimenuitem -></menuchoice ->. You can change the following things:</para> +<title>Configuration</title> + +<para>&tdesu; comes with a control module named <application>kcmtdesu</application>. You can find it in the <guimenu>K</guimenu> menu under <menuchoice><guisubmenu>Settings</guisubmenu> <guisubmenu>Applications</guisubmenu> <guimenuitem>KDE su</guimenuitem></menuchoice>. You can change the following things:</para> <variablelist> <varlistentry> -<term -><guilabel ->Echo Mode</guilabel -></term> -<listitem -><para ->This is how characters you type are echoed to the screen. Possible choices are: one star per character, three stars or no echo at all. The default is one star per character.</para -></listitem> +<term><guilabel>Echo Mode</guilabel></term> +<listitem><para>This is how characters you type are echoed to the screen. Possible choices are: one star per character, three stars or no echo at all. The default is one star per character.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Keeping passwords</guilabel -></term> -<listitem -><para ->You can instruct &tdesu; remember passwords you enter by checking the <guilabel ->keep password</guilabel -> check box. If this checked, you can enter a timeout value in the text field below it. This is the amount of time, in minutes, that the password will be remembered. The default is not to remember passwords.</para -></listitem> +<term><guilabel>Keeping passwords</guilabel></term> +<listitem><para>You can instruct &tdesu; remember passwords you enter by checking the <guilabel>keep password</guilabel> check box. If this checked, you can enter a timeout value in the text field below it. This is the amount of time, in minutes, that the password will be remembered. The default is not to remember passwords.</para></listitem> </varlistentry> </variablelist> </chapter> <chapter id="Internals"> -<title ->Internals</title> +<title>Internals</title> <sect1 id="x-authentication"> -<title ->X authentication</title> +<title>X authentication</title> -<para ->The program you execute will run under the root user id and will generally have no authority to access your X display. &tdesu; gets around this by adding an authentication cookie for your display to a temporary <filename ->.Xauthority</filename -> file. After the command exits, this file is removed. </para> +<para>The program you execute will run under the root user id and will generally have no authority to access your X display. &tdesu; gets around this by adding an authentication cookie for your display to a temporary <filename>.Xauthority</filename> file. After the command exits, this file is removed. </para> -<para ->If you don't use X cookies, you are on your own. &tdesu; will detect this and will not add a cookie but you will have to make sure that root is allowed to access to your display.</para> +<para>If you don't use X cookies, you are on your own. &tdesu; will detect this and will not add a cookie but you will have to make sure that root is allowed to access to your display.</para> </sect1> <sect1 id="interface-to-su"> -<title ->Interface to <command ->su</command -></title> - -<para ->&tdesu; uses the sytem's <command ->su</command -> for acquiring priviliges. In this section, I explain the details of how &tdesu; does this. </para> - -<para ->Because some <command ->su</command -> implementations (&ie; the one from &RedHat;) don't want to read the password from <literal ->stdin</literal ->, &tdesu; creates a pty/tty pair and executes <command ->su</command -> with it's standard filedescriptors connected to the tty.</para> - -<para ->To execute the command the user selected, rather than an interactive shell, &tdesu; uses the <option ->-c</option -> argument with <command ->su</command ->. This argument is understood by every shell that I know of so it should work portably. <command ->su</command -> passes this <option ->-c</option -> argument to the target user's shell, and the shell executes the program. Example command: <command ->su <option ->root -c <replaceable ->the_program</replaceable -></option -></command ->.</para> - -<para ->Instead of executing the user command directly with <command ->su</command ->, &tdesu; executes a little stub program called <application ->tdesu_stub</application ->. This stub (running as the target user), requests some information from &tdesu; over the pty/tty channel (the stub's stdin and stdout) and then executes the user's program. The information passed over is: the X display, an X authentication cookie (if available), the <envar ->PATH</envar -> and the command to run. The reason why a stub program is used is that the X cookie is private information and therefore cannot be passed on the command line.</para> +<title>Interface to <command>su</command></title> + +<para>&tdesu; uses the sytem's <command>su</command> for acquiring priviliges. In this section, I explain the details of how &tdesu; does this. </para> + +<para>Because some <command>su</command> implementations (&ie; the one from &RedHat;) don't want to read the password from <literal>stdin</literal>, &tdesu; creates a pty/tty pair and executes <command>su</command> with it's standard filedescriptors connected to the tty.</para> + +<para>To execute the command the user selected, rather than an interactive shell, &tdesu; uses the <option>-c</option> argument with <command>su</command>. This argument is understood by every shell that I know of so it should work portably. <command>su</command> passes this <option>-c</option> argument to the target user's shell, and the shell executes the program. Example command: <command>su <option>root -c <replaceable>the_program</replaceable></option></command>.</para> + +<para>Instead of executing the user command directly with <command>su</command>, &tdesu; executes a little stub program called <application>tdesu_stub</application>. This stub (running as the target user), requests some information from &tdesu; over the pty/tty channel (the stub's stdin and stdout) and then executes the user's program. The information passed over is: the X display, an X authentication cookie (if available), the <envar>PATH</envar> and the command to run. The reason why a stub program is used is that the X cookie is private information and therefore cannot be passed on the command line.</para> </sect1> <sect1 id="password-checking"> -<title ->Password Checking</title> +<title>Password Checking</title> -<para ->&tdesu; will check the password you entered and gives an error message if it is not correct. The checking is done by executing a test program: <filename ->/bin/true</filename ->. If this succeeds, the password is assumed to be correct.</para> +<para>&tdesu; will check the password you entered and gives an error message if it is not correct. The checking is done by executing a test program: <filename>/bin/true</filename>. If this succeeds, the password is assumed to be correct.</para> </sect1> <sect1 id="sec-password-keeping"> -<title ->Password Keeping</title> - -<para ->For your comfort, &tdesu; implements a <quote ->keep password</quote -> feature. If you are interested in security, you should read this paragraph.</para> - -<para ->Allowing &tdesu; to remember passwords opens up a (small) security hole in your system. Obviously, &tdesu; does not allow anybody but your user id to use the passwords, but, if done without caution, this would lower <systemitem class="username" ->root</systemitem ->'s security level to that of a normal user (you). A hacker who breaks into your account, would get <systemitem class="username" ->root</systemitem -> access. &tdesu; tries to prevent this. The security scheme it uses is, in my opinion at least, reasonably safe and is explained here.</para> - -<para ->&tdesu; uses a daemon, called <application ->tdesud</application ->. The daemon listens to a &UNIX; socket in <filename ->/tmp</filename -> for commands. The mode of the socket is 0600 so that only your user id can connect to it. If password keeping is enabled, &tdesu; executes commands through this daemon. It writes the command and <systemitem class="username" ->root</systemitem ->'s password to the socket and the daemon executes the command using <command ->su</command ->, as describe before. After this, the command and the password are not thrown away. Instead, they are kept for a specified amount of time. This is the timeout value from in the control module. If another request for the same command is coming within this time period, the client does not have to supply the password. To keep hackers who broke into your account from stealing passwords from the daemon (for example, by attaching a debugger), the daemon is installed set-group-id nogroup. This should prevent all normal users (including you) from getting passwords from the <application ->tdesud</application -> process. Also, the daemon sets the <envar ->DISPLAY</envar -> environment variable to the value it had when it was started. The only thing a hacker can do is execute an application on your display.</para> - -<para ->One weak spot in this scheme is that the programs you execute are probably not written with security in mind (like setuid <systemitem class="username" ->root</systemitem -> programs). This means that they might have buffer overruns or other problems and a hacker could exploit those.</para> - -<para ->The use of the password keeping feature is a tradeoff between security and comfort. I encourage you to think it over and decide for yourself if you want to use it or not.</para> +<title>Password Keeping</title> + +<para>For your comfort, &tdesu; implements a <quote>keep password</quote> feature. If you are interested in security, you should read this paragraph.</para> + +<para>Allowing &tdesu; to remember passwords opens up a (small) security hole in your system. Obviously, &tdesu; does not allow anybody but your user id to use the passwords, but, if done without caution, this would lower <systemitem class="username">root</systemitem>'s security level to that of a normal user (you). A hacker who breaks into your account, would get <systemitem class="username">root</systemitem> access. &tdesu; tries to prevent this. The security scheme it uses is, in my opinion at least, reasonably safe and is explained here.</para> + +<para>&tdesu; uses a daemon, called <application>tdesud</application>. The daemon listens to a &UNIX; socket in <filename>/tmp</filename> for commands. The mode of the socket is 0600 so that only your user id can connect to it. If password keeping is enabled, &tdesu; executes commands through this daemon. It writes the command and <systemitem class="username">root</systemitem>'s password to the socket and the daemon executes the command using <command>su</command>, as describe before. After this, the command and the password are not thrown away. Instead, they are kept for a specified amount of time. This is the timeout value from in the control module. If another request for the same command is coming within this time period, the client does not have to supply the password. To keep hackers who broke into your account from stealing passwords from the daemon (for example, by attaching a debugger), the daemon is installed set-group-id nogroup. This should prevent all normal users (including you) from getting passwords from the <application>tdesud</application> process. Also, the daemon sets the <envar>DISPLAY</envar> environment variable to the value it had when it was started. The only thing a hacker can do is execute an application on your display.</para> + +<para>One weak spot in this scheme is that the programs you execute are probably not written with security in mind (like setuid <systemitem class="username">root</systemitem> programs). This means that they might have buffer overruns or other problems and a hacker could exploit those.</para> + +<para>The use of the password keeping feature is a tradeoff between security and comfort. I encourage you to think it over and decide for yourself if you want to use it or not.</para> </sect1> </chapter> <chapter id="Author"> -<title ->Author</title> +<title>Author</title> -<para ->&tdesu;</para> +<para>&tdesu;</para> -<para ->Copyright 2000 &Geert.Jansen;</para> +<para>Copyright 2000 &Geert.Jansen;</para> -<para ->&tdesu; is written by &Geert.Jansen;. It is somewhat based on Pietro Iglio's &tdesu;, version 0.3. Pietro and I agreed that I will maintain this program in the future.</para> +<para>&tdesu; is written by &Geert.Jansen;. It is somewhat based on Pietro Iglio's &tdesu;, version 0.3. Pietro and I agreed that I will maintain this program in the future.</para> -<para ->The author can be reached through email at &Geert.Jansen.mail;. Please report any bugs you find to me so that I can fix them. If you have a suggestion, feel free to contact me.</para> +<para>The author can be reached through email at &Geert.Jansen.mail;. Please report any bugs you find to me so that I can fix them. If you have a suggestion, feel free to contact me.</para> &underFDL; &underArtisticLicense; </chapter> </book> diff --git a/tde-i18n-en_GB/docs/tdebase/tdm/index.docbook b/tde-i18n-en_GB/docs/tdebase/tdm/index.docbook index c0c5a7e2a2a..beac753f9f1 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdm/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdm/index.docbook @@ -3,116 +3,69 @@ "dtd/kdex.dtd" [ <!ENTITY kappname "&tdm;"> <!ENTITY package "tdebase"> - <!ENTITY tdmrc "<filename ->tdmrc</filename ->"> - <!ENTITY XDMCP "<acronym ->XDMCP</acronym ->"> - <!ENTITY xdm "<application ->xdm</application ->"> + <!ENTITY tdmrc "<filename>tdmrc</filename>"> + <!ENTITY XDMCP "<acronym>XDMCP</acronym>"> + <!ENTITY xdm "<application>xdm</application>"> <!ENTITY tdmrc-ref SYSTEM "tdmrc-ref.docbook"> <!ENTITY % addindex "INCLUDE"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <book lang="&language;"> <bookinfo> -<title ->The &tdm; Handbook</title> +<title>The &tdm; Handbook</title> <authorgroup> -<author ->&Oswald.Buddenhagen; &Oswald.Buddenhagen.mail; </author -><!-- +<author>&Oswald.Buddenhagen; &Oswald.Buddenhagen.mail; </author><!-- <othercredit role="developer"> &Oswald.Buddenhagen; &Oswald.Buddenhagen.mail; -<contrib ->Developer</contrib> +<contrib>Developer</contrib> </othercredit> <othercredit role="reviewer"> &Lauri.Watts; &Lauri.Watts.mail; -<contrib ->Reviewer</contrib> -</othercredit -> --> - -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<contrib>Reviewer</contrib> +</othercredit> --> + +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> <copyright> -<year ->2000</year> -<holder ->&Neal.Crook;</holder> +<year>2000</year> +<holder>&Neal.Crook;</holder> </copyright> <copyright> -<year ->2002</year> -<holder ->&Oswald.Buddenhagen;</holder> +<year>2002</year> +<holder>&Oswald.Buddenhagen;</holder> </copyright> <copyright> -<year ->2003</year> -<holder ->&Lauri.Watts;</holder> +<year>2003</year> +<holder>&Lauri.Watts;</holder> </copyright> -<date ->2003-03-01</date> -<releaseinfo ->0.05.02</releaseinfo> +<date>2003-03-01</date> +<releaseinfo>0.05.02</releaseinfo> <abstract> -<para ->This document describes &tdm; the &kde; Display Manager. &tdm; is also known as the <quote ->Login Manager</quote ->.</para> +<para>This document describes &tdm; the &kde; Display Manager. &tdm; is also known as the <quote>Login Manager</quote>.</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->tdm</keyword> -<keyword ->xdm</keyword> -<keyword ->display manager</keyword> -<keyword ->login manager</keyword> +<keyword>KDE</keyword> +<keyword>tdm</keyword> +<keyword>xdm</keyword> +<keyword>display manager</keyword> +<keyword>login manager</keyword> </keywordset> </bookinfo> <!-- ********************************************************************** --> <chapter id="introduction"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->&tdm; provides a graphical interface that allows you to log in to a system. It prompts for login (username) and password, authenticates the user and starts a <quote ->session</quote ->. &tdm; is superior to &xdm;, the X Display Manager, in a number of ways.</para> +<para>&tdm; provides a graphical interface that allows you to log in to a system. It prompts for login (username) and password, authenticates the user and starts a <quote>session</quote>. &tdm; is superior to &xdm;, the X Display Manager, in a number of ways.</para> </chapter> @@ -131,1083 +84,473 @@ --> <chapter id="quickstart"> -<title ->Quick Start Guide</title> +<title>Quick Start Guide</title> -<para ->This is a quick start guide for users who fit the following pattern:</para> +<para>This is a quick start guide for users who fit the following pattern:</para> <itemizedlist> <listitem> -<para ->X is configured and works with the command <command ->startx</command -> from the commandline.</para> +<para>X is configured and works with the command <command>startx</command> from the commandline.</para> </listitem> <listitem> -<para ->Each user will generally only use a single window manager or desktop environment, and does not change this choice very often, or is comfortable editing a single text file in order to change their choice.</para> +<para>Each user will generally only use a single window manager or desktop environment, and does not change this choice very often, or is comfortable editing a single text file in order to change their choice.</para> </listitem> </itemizedlist> -<para ->This scenario will be sufficient for many environments where a single user or several users normally boot the computer and log into their preferred environment.</para> +<para>This scenario will be sufficient for many environments where a single user or several users normally boot the computer and log into their preferred environment.</para> <procedure> -<title ->Setting up a Default Session</title> +<title>Setting up a Default Session</title> <step> -<para ->Create or open the file <filename ->~/.xinitrc</filename -></para> -<para ->If you already have a working <filename ->~/.xinitrc</filename ->, go to the next step</para> +<para>Create or open the file <filename>~/.xinitrc</filename></para> +<para>If you already have a working <filename>~/.xinitrc</filename>, go to the next step</para> </step> <step> -<para ->If one does not already exist, add a line to the <filename ->~/.xinitrc</filename -> to start your preferred window manager or desktop environment.</para> -<para ->For &kde; you should enter:</para> -<screen -><userinput ->starttde</userinput -></screen> -<para ->For other window managers or desktop environments, you should look in their documentation for the correct command.</para> +<para>If one does not already exist, add a line to the <filename>~/.xinitrc</filename> to start your preferred window manager or desktop environment.</para> +<para>For &kde; you should enter:</para> +<screen><userinput>starttde</userinput></screen> +<para>For other window managers or desktop environments, you should look in their documentation for the correct command.</para> </step> -<step -><para ->Make a link as follows:</para> -<screen -><userinput -><command ->ln</command -> <option ->-s</option -> <parameter ->~/.xinitrc ~/.xsession</parameter -></userinput -></screen> +<step><para>Make a link as follows:</para> +<screen><userinput><command>ln</command> <option>-s</option> <parameter>~/.xinitrc ~/.xsession</parameter></userinput></screen> </step> </procedure> -<para ->At this point, typing <userinput -><command ->startx</command -></userinput -> on the commandline should start X, with a &kde; session. The next task is to try &tdm;.</para> - -<para ->As <systemitem class="username" ->root</systemitem ->, type <userinput -><command ->tdm</command -></userinput -> at the prompt.</para> - -<para ->You should see a login window, which is described more fully in<xref linkend="login"/>.</para> - -<para ->Typing your normal username and password in the fields provided, and leaving <option ->default</option -> selected as the session type should now open a &kde; session for your user.</para> - -<para ->If you have other users to configure, you should repeat the procedure above for each of them.</para> +<para>At this point, typing <userinput><command>startx</command></userinput> on the commandline should start X, with a &kde; session. The next task is to try &tdm;.</para> + +<para>As <systemitem class="username">root</systemitem>, type <userinput><command>tdm</command></userinput> at the prompt.</para> + +<para>You should see a login window, which is described more fully in<xref linkend="login"/>.</para> + +<para>Typing your normal username and password in the fields provided, and leaving <option>default</option> selected as the session type should now open a &kde; session for your user.</para> + +<para>If you have other users to configure, you should repeat the procedure above for each of them.</para> <note> -<para ->This is a quick guide to getting up and running only. You probably will want to customise &tdm; further, for example, to hide the names of the system accounts, to allow further sessions, and much more. Please read through the rest of this manual to find out how to do these things.</para> +<para>This is a quick guide to getting up and running only. You probably will want to customise &tdm; further, for example, to hide the names of the system accounts, to allow further sessions, and much more. Please read through the rest of this manual to find out how to do these things.</para> </note> </chapter> -<chapter id="login" -> -<title ->The Login Window</title -> +<chapter id="login"> +<title>The Login Window</title> -<para ->The user interface to &tdm; consists of two dialogue boxes. The main dialogue box has these controls:</para> +<para>The user interface to &tdm; consists of two dialogue boxes. The main dialogue box has these controls:</para> -<itemizedlist -> +<itemizedlist> <listitem> -<para ->A <guilabel ->Username:</guilabel -> field for you to enter your username.</para> +<para>A <guilabel>Username:</guilabel> field for you to enter your username.</para> </listitem> <listitem> -<para ->A <guilabel ->Password:</guilabel -> field for you to enter your password.</para> +<para>A <guilabel>Password:</guilabel> field for you to enter your password.</para> </listitem> <listitem> -<para ->(Optionally) a graphical image of each user (for example, a digitised photograph). Clicking on an image is equivalent to typing the associated username into the <guilabel ->Username:</guilabel -> field. (This feature is an imitation of the login box on IRIX).</para -> </listitem> +<para>(Optionally) a graphical image of each user (for example, a digitised photograph). Clicking on an image is equivalent to typing the associated username into the <guilabel>Username:</guilabel> field. (This feature is an imitation of the login box on IRIX).</para> </listitem> <listitem> -<para ->A <guilabel ->Menu</guilabel -> drop-down box that allows &tdm; to be used to start sessions with various different window managers or desktop environments installed on the system.</para> +<para>A <guilabel>Menu</guilabel> drop-down box that allows &tdm; to be used to start sessions with various different window managers or desktop environments installed on the system.</para> </listitem> <listitem> -<para ->(Optionally) a region to the right of the <guilabel ->Username:</guilabel ->, <guilabel ->Password:</guilabel -> and <guilabel ->Session Type:</guilabel -> fields which can be used to display either a static image or an analogue clock.</para> +<para>(Optionally) a region to the right of the <guilabel>Username:</guilabel>, <guilabel>Password:</guilabel> and <guilabel>Session Type:</guilabel> fields which can be used to display either a static image or an analogue clock.</para> </listitem> <listitem> -<para ->A <guibutton ->Login</guibutton -> button that validates the username/password combination and attempts to start a session of the selected type.</para -> +<para>A <guibutton>Login</guibutton> button that validates the username/password combination and attempts to start a session of the selected type.</para> </listitem> <listitem> -<para ->A <guibutton ->Clear</guibutton -> button that clears the text from the <guilabel ->Login</guilabel -> and <guilabel ->Pass</guilabel -> fields.</para> -</listitem -> +<para>A <guibutton>Clear</guibutton> button that clears the text from the <guilabel>Login</guilabel> and <guilabel>Pass</guilabel> fields.</para> +</listitem> <listitem> -<para ->(Optionally) A <guibutton ->Shutdown</guibutton -> button that displays the <guibutton ->Shutdown</guibutton -> dialogue box.</para> +<para>(Optionally) A <guibutton>Shutdown</guibutton> button that displays the <guibutton>Shutdown</guibutton> dialogue box.</para> </listitem> <listitem> -<para ->A <guibutton ->Menu</guibutton -> button that opens an action menu with the following items:</para> +<para>A <guibutton>Menu</guibutton> button that opens an action menu with the following items:</para> <itemizedlist> <listitem> -<para ->(On local displays) a <guimenuitem ->Restart X Server</guimenuitem -> item that terminates the currently running &X-Server;, starts a new one and displays the login dialogue again. You can use this if the display content seems to be broken somehow.</para> +<para>(On local displays) a <guimenuitem>Restart X Server</guimenuitem> item that terminates the currently running &X-Server;, starts a new one and displays the login dialogue again. You can use this if the display content seems to be broken somehow.</para> </listitem> <listitem> -<para ->(On remote displays) A <guimenuitem ->Close Connection</guimenuitem -> item that closes the connection to the XDMCP server you are currently connected to. If you got to this server through a host chooser, this will bring you back to the chooser, otherwise it will only reset the &X-Server; and bring up the login dialogue again.</para> +<para>(On remote displays) A <guimenuitem>Close Connection</guimenuitem> item that closes the connection to the XDMCP server you are currently connected to. If you got to this server through a host chooser, this will bring you back to the chooser, otherwise it will only reset the &X-Server; and bring up the login dialogue again.</para> </listitem> <listitem> -<para ->(Optionally on local displays) A <guimenuitem ->Console Mode</guimenuitem -> item that terminates the currently running &X-Server; and leaves you alone with a console login. &tdm; will resume the graphical login if nobody is logged in at the console for some time. To make this work, you need to use the local@<console> syntax in the <filename ->Xservers</filename -> file (see comments in that file).</para> +<para>(Optionally on local displays) A <guimenuitem>Console Mode</guimenuitem> item that terminates the currently running &X-Server; and leaves you alone with a console login. &tdm; will resume the graphical login if nobody is logged in at the console for some time. To make this work, you need to use the local@<console> syntax in the <filename>Xservers</filename> file (see comments in that file).</para> </listitem> </itemizedlist> </listitem> <listitem> -<para ->(Optionally) A <guibutton ->Shutdown...</guibutton -> button that displays the shutdown dialogue box.</para> +<para>(Optionally) A <guibutton>Shutdown...</guibutton> button that displays the shutdown dialogue box.</para> </listitem> </itemizedlist> -<para ->The <guilabel ->Shutdown</guilabel -> dialogue box presents a set of radio buttons that allow one of these options to be selected:</para> +<para>The <guilabel>Shutdown</guilabel> dialogue box presents a set of radio buttons that allow one of these options to be selected:</para> <variablelist> <varlistentry> -<term ->Shutdown</term> -<listitem -><para ->Shut the system down in a controlled manner, ready for power-down.</para -></listitem> +<term>Shutdown</term> +<listitem><para>Shut the system down in a controlled manner, ready for power-down.</para></listitem> </varlistentry> <varlistentry> -<term ->Restart</term> -<listitem -><para ->Shut the system down and reboot. For systems that use <application ->Lilo</application ->, an optional drop-down box allows you to select a particular operating-system kernel to be used for the reboot.</para> +<term>Restart</term> +<listitem><para>Shut the system down and reboot. For systems that use <application>Lilo</application>, an optional drop-down box allows you to select a particular operating-system kernel to be used for the reboot.</para> </listitem> </varlistentry> <varlistentry> -<term ->Restart X Server</term -> +<term>Restart X Server</term> <listitem> -<para ->Stop and then restart the X-server. Typically, you might need to use this option if you have changed your X11 configuration in some way.</para> -</listitem -> +<para>Stop and then restart the X-server. Typically, you might need to use this option if you have changed your X11 configuration in some way.</para> +</listitem> </varlistentry> <varlistentry> -<term ->Console Mode</term> +<term>Console Mode</term> <listitem> -<para ->Stop the &X-Server; and return the system to console mode. This is achieved by bringing the system down to run-level 3. Typically, the system manager might need to use this option before upgrading or re-configuring X11 software.</para> -</listitem -> +<para>Stop the &X-Server; and return the system to console mode. This is achieved by bringing the system down to run-level 3. Typically, the system manager might need to use this option before upgrading or re-configuring X11 software.</para> +</listitem> </varlistentry> </variablelist> -<para ->Pressing the <guibutton ->OK</guibutton -> button initiates the selected action; pressing the <guibutton ->Cancel</guibutton -> button returns to the main &tdm; dialogue box. </para> +<para>Pressing the <guibutton>OK</guibutton> button initiates the selected action; pressing the <guibutton>Cancel</guibutton> button returns to the main &tdm; dialogue box. </para> </chapter> <!-- *********************************************************************** --> <chapter id="configuring-tdm"> -<title ->Configuring &tdm;</title> - -<para ->This chapter assumes that &tdm; is already up and running on your system, and that you simply want to change its behaviour in some way.</para> - -<para ->When &tdm; starts up, it reads its configuration from the folder <filename class="directory" ->$TDEDIR/share/config/tdm/</filename -> (this may be <filename class="directory" ->/etc/kde3/tdm/</filename -> or something else on your system).</para> - -<para ->The main configuration file is &tdmrc;; all other files are referenced from there and could be stored under any name anywhere on the system - but usually that would not make much sense for obvious reasons (one particular exception is referencing configuration files of an already installed &xdm; - however when a new &tdm; is installed, it will import settings from those files if it finds an already installed &xdm;).</para> - -<para ->Since &tdm; must run before any user is logged in, it is not associated with any particular user. Therefore, it is not possible to have user-specific configuration files; all users share the common &tdmrc;. It follows from this that the configuration of &tdm; can only be altered by those users that have write access to <filename ->$<envar ->TDEDIR</envar ->/share/config/tdm/tdmrc</filename -> (normally restricted to system administrators logged in as <systemitem class="username" ->root</systemitem ->).</para> - -<para ->You can view the &tdmrc; file currently in use on your system, and you can configure &tdm; by editing this file. Alternatively, you can use the graphical configuration tool provided by the &kcontrolcenter; (under <menuchoice -><guisubmenu ->System Administration</guisubmenu -><guimenuitem ->Login Manager</guimenuitem -></menuchoice ->), which is described in <ulink url="help:/kcontrol/login-manager.html" ->the &kcontrol; help files</ulink ->. </para> - -<para ->The remainder of this chapter describes configuration of &tdm; via the &kcontrol; module, and the <link linkend="tdm-files" ->next chapter</link -> describes the options available in &tdmrc; itself. If you only need to configure for local users, the &kcontrol; module should be sufficient for your needs. If you need to configure remote logins, or have multiple &tdm; sessions running, you will need to read on.</para> +<title>Configuring &tdm;</title> + +<para>This chapter assumes that &tdm; is already up and running on your system, and that you simply want to change its behaviour in some way.</para> + +<para>When &tdm; starts up, it reads its configuration from the folder <filename class="directory">$TDEDIR/share/config/tdm/</filename> (this may be <filename class="directory">/etc/kde3/tdm/</filename> or something else on your system).</para> + +<para>The main configuration file is &tdmrc;; all other files are referenced from there and could be stored under any name anywhere on the system - but usually that would not make much sense for obvious reasons (one particular exception is referencing configuration files of an already installed &xdm; - however when a new &tdm; is installed, it will import settings from those files if it finds an already installed &xdm;).</para> + +<para>Since &tdm; must run before any user is logged in, it is not associated with any particular user. Therefore, it is not possible to have user-specific configuration files; all users share the common &tdmrc;. It follows from this that the configuration of &tdm; can only be altered by those users that have write access to <filename>$<envar>TDEDIR</envar>/share/config/tdm/tdmrc</filename> (normally restricted to system administrators logged in as <systemitem class="username">root</systemitem>).</para> + +<para>You can view the &tdmrc; file currently in use on your system, and you can configure &tdm; by editing this file. Alternatively, you can use the graphical configuration tool provided by the &kcontrolcenter; (under <menuchoice><guisubmenu>System Administration</guisubmenu><guimenuitem>Login Manager</guimenuitem></menuchoice>), which is described in <ulink url="help:/kcontrol/login-manager.html">the &kcontrol; help files</ulink>. </para> + +<para>The remainder of this chapter describes configuration of &tdm; via the &kcontrol; module, and the <link linkend="tdm-files">next chapter</link> describes the options available in &tdmrc; itself. If you only need to configure for local users, the &kcontrol; module should be sufficient for your needs. If you need to configure remote logins, or have multiple &tdm; sessions running, you will need to read on.</para> <sect1 id="tdm-kcontrol-module"> <sect1info> <authorgroup> -<author ->&Thomas.Tanghus; &Thomas.Tanghus.mail;</author> -<author ->&Steffen.Hansen; &Steffen.Hansen.mail;</author> -<author ->&Mike.McBride; &Mike.McBride.mail;</author> -<othercredit role="translator" -><firstname ->John</firstname -><surname ->Knight</surname -><affiliation -><address -><email ->anarchist_tomato@herzeleid.net</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<author>&Thomas.Tanghus; &Thomas.Tanghus.mail;</author> +<author>&Steffen.Hansen; &Steffen.Hansen.mail;</author> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<othercredit role="translator"><firstname>John</firstname><surname>Knight</surname><affiliation><address><email>anarchist_tomato@herzeleid.net</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> </sect1info> -<title ->The Login Manager &kcontrol; Module</title> - -<para ->Using this module, you can configure the &kde; graphical login manager, &tdm;. You can change how the login screen looks, who has access using the login manager and who can shutdown the computer.</para> - -<note -><para ->All settings will be written to the configuration file &tdmrc;, which in it's original state has many comments to help you configure &tdm;. Using this &kcontrol; module will strip these comments from the file. All available options in &tdmrc; are covered in <xref linkend="tdm-files"/>.</para> - -<para ->The options listed in this chapter are cross referenced with their equivalents in &tdmrc;. All options available in the &kcontrol; module are also available directly in &tdmrc; but the reverse is not true.</para -></note> - -<para ->In order to organise all of these options, this module is divided into several sections: <link linkend="tdmconfig-appearance" -><guilabel ->Appearance</guilabel -></link ->, <link linkend="tdmconfig-font" -><guilabel ->Font</guilabel -></link ->, <link linkend="tdmconfig-background" -><guilabel ->Background</guilabel -></link ->, <link linkend="tdmconfig-shutdown" -><guilabel ->Shutdown</guilabel -></link ->, <link linkend="tdmconfig-users" -><guilabel ->Users</guilabel -></link -> and <link linkend="tdmconfig-convenience" -><guilabel ->Convenience</guilabel -></link ->.</para> - -<para ->You can switch between the sections using the tabs at the top of the window.</para> - -<note -><para ->If you are not currently logged in as a superuser, you will need to click the <guibutton ->Administrator Mode</guibutton -> Button. You will then be asked for a superuser password. Entering a correct password will allow you to modify the settings of this module.</para -></note> +<title>The Login Manager &kcontrol; Module</title> + +<para>Using this module, you can configure the &kde; graphical login manager, &tdm;. You can change how the login screen looks, who has access using the login manager and who can shutdown the computer.</para> + +<note><para>All settings will be written to the configuration file &tdmrc;, which in it's original state has many comments to help you configure &tdm;. Using this &kcontrol; module will strip these comments from the file. All available options in &tdmrc; are covered in <xref linkend="tdm-files"/>.</para> + +<para>The options listed in this chapter are cross referenced with their equivalents in &tdmrc;. All options available in the &kcontrol; module are also available directly in &tdmrc; but the reverse is not true.</para></note> + +<para>In order to organise all of these options, this module is divided into several sections: <link linkend="tdmconfig-appearance"><guilabel>Appearance</guilabel></link>, <link linkend="tdmconfig-font"><guilabel>Font</guilabel></link>, <link linkend="tdmconfig-background"><guilabel>Background</guilabel></link>, <link linkend="tdmconfig-shutdown"><guilabel>Shutdown</guilabel></link>, <link linkend="tdmconfig-users"><guilabel>Users</guilabel></link> and <link linkend="tdmconfig-convenience"><guilabel>Convenience</guilabel></link>.</para> + +<para>You can switch between the sections using the tabs at the top of the window.</para> + +<note><para>If you are not currently logged in as a superuser, you will need to click the <guibutton>Administrator Mode</guibutton> Button. You will then be asked for a superuser password. Entering a correct password will allow you to modify the settings of this module.</para></note> <sect2 id="tdmconfig-appearance"> -<title ->Appearance</title> - -<para ->From this page you can change the visual appearance of &tdm;, &kde;'s graphical login manager.</para> - -<para ->The <guilabel ->Greeting:</guilabel -> is the title of the login screen. Setting this is especially useful if you have many servers users may log in to. You may use various placeholders, which are described along with the corresponding key <link linkend="option-greetstring" -><option ->GreetString</option -></link -> in &tdmrc;. </para> - -<para ->You can then choose to show either the current system time, a logo or nothing special in the login box. Make your choice in the radio buttons labelled <guilabel ->Logo area:</guilabel ->. This corresponds to <link linkend="option-logoarea" -><option ->LogoArea</option -></link -> in &tdmrc;</para> - -<para ->If you chose <guilabel ->Show logo</guilabel -> you can now choose a logo:</para> +<title>Appearance</title> + +<para>From this page you can change the visual appearance of &tdm;, &kde;'s graphical login manager.</para> + +<para>The <guilabel>Greeting:</guilabel> is the title of the login screen. Setting this is especially useful if you have many servers users may log in to. You may use various placeholders, which are described along with the corresponding key <link linkend="option-greetstring"><option>GreetString</option></link> in &tdmrc;. </para> + +<para>You can then choose to show either the current system time, a logo or nothing special in the login box. Make your choice in the radio buttons labelled <guilabel>Logo area:</guilabel>. This corresponds to <link linkend="option-logoarea"><option>LogoArea</option></link> in &tdmrc;</para> + +<para>If you chose <guilabel>Show logo</guilabel> you can now choose a logo:</para> <itemizedlist> <listitem> -<para ->Drop an image file on the image button.</para> +<para>Drop an image file on the image button.</para> </listitem> <listitem> -<para ->Click on the image button and select a new image from the image chooser dialogue.</para> +<para>Click on the image button and select a new image from the image chooser dialogue.</para> </listitem> </itemizedlist> -<para ->If you do not specify a logo the default <filename ->$<envar ->TDEDIR</envar ->/share/apps/tdm/pics/kdelogo.xpm</filename -> will be displayed.</para> - -<para ->Normally the login box is centred on the screen. Use the <guilabel ->Position:</guilabel -> options if you want it to appear elsewhere on the screen. You can specify the relative position (percentage of the screen size) for the centre of the login window, relative to the top left of the display, in the fields labelled <guilabel ->X:</guilabel -> and <guilabel ->Y:</guilabel -> respectively. These correspond to the key <link linkend="option-greeterpos" -><option ->GreeterPos</option -></link -> in &tdmrc;.</para> - -<para ->While &kde;'s style depends on the settings of the user logged in, the style used by &tdm; can be configured using the <guilabel ->GUI Style:</guilabel -> and <guilabel ->Colour Scheme:</guilabel -> options. These correspond to the keys <link linkend="option-guistyle" -><option ->GUIStyle</option -></link -> and <link linkend="option-colorscheme" -><option ->ColorScheme</option -></link -> in &tdmrc; respectively.</para> - -<para ->Below that, you have a dropdown box to choose the language for your login box, corresponding to setting <option ->Language</option -> in &tdmrc;.</para> +<para>If you do not specify a logo the default <filename>$<envar>TDEDIR</envar>/share/apps/tdm/pics/kdelogo.xpm</filename> will be displayed.</para> + +<para>Normally the login box is centred on the screen. Use the <guilabel>Position:</guilabel> options if you want it to appear elsewhere on the screen. You can specify the relative position (percentage of the screen size) for the centre of the login window, relative to the top left of the display, in the fields labelled <guilabel>X:</guilabel> and <guilabel>Y:</guilabel> respectively. These correspond to the key <link linkend="option-greeterpos"><option>GreeterPos</option></link> in &tdmrc;.</para> + +<para>While &kde;'s style depends on the settings of the user logged in, the style used by &tdm; can be configured using the <guilabel>GUI Style:</guilabel> and <guilabel>Colour Scheme:</guilabel> options. These correspond to the keys <link linkend="option-guistyle"><option>GUIStyle</option></link> and <link linkend="option-colorscheme"><option>ColorScheme</option></link> in &tdmrc; respectively.</para> + +<para>Below that, you have a dropdown box to choose the language for your login box, corresponding to setting <option>Language</option> in &tdmrc;.</para> </sect2> <sect2 id="tdmconfig-font"> -<title ->Font</title> - -<para ->From this section of the module you can change the fonts used in the login window. Only fonts available to all users are available here, not fonts you have installed on a per user basis.</para> - -<para ->You can select three different font styles from the drop down box (<guilabel ->General:</guilabel ->, <guilabel ->Failures:</guilabel ->, <guilabel ->Greeting</guilabel ->). When you click on the <guibutton ->Choose...</guibutton -> button a dialogue appears from which you can select the new characteristics for the font style.</para> +<title>Font</title> + +<para>From this section of the module you can change the fonts used in the login window. Only fonts available to all users are available here, not fonts you have installed on a per user basis.</para> + +<para>You can select three different font styles from the drop down box (<guilabel>General:</guilabel>, <guilabel>Failures:</guilabel>, <guilabel>Greeting</guilabel>). When you click on the <guibutton>Choose...</guibutton> button a dialogue appears from which you can select the new characteristics for the font style.</para> <itemizedlist> <listitem> -<para ->The <guilabel ->General:</guilabel -> font is used in all other places in the login window.</para> +<para>The <guilabel>General:</guilabel> font is used in all other places in the login window.</para> </listitem> <listitem> -<para ->The <guilabel ->Failures:</guilabel -> font is used when a login fails.</para> +<para>The <guilabel>Failures:</guilabel> font is used when a login fails.</para> </listitem> <listitem> -<para ->The <guilabel ->Greeting:</guilabel -> font is the font used for the title (Greeting String).</para> +<para>The <guilabel>Greeting:</guilabel> font is the font used for the title (Greeting String).</para> </listitem> </itemizedlist> -<para ->You can also check the box labelled <guilabel ->Use anti-aliasing for fonts</guilabel -> if you want smoothed fonts in the login dialogue.</para> +<para>You can also check the box labelled <guilabel>Use anti-aliasing for fonts</guilabel> if you want smoothed fonts in the login dialogue.</para> -<para ->An example of each font can be seen in the <guilabel ->Example</guilabel -> Box.</para> +<para>An example of each font can be seen in the <guilabel>Example</guilabel> Box.</para> </sect2> <sect2 id="tdmconfig-background"> -<title ->Background</title> +<title>Background</title> -<para ->Here you can change the desktop background which will be displayed before a user logs in. You can have a single colour or an image as a background. If you have an image as the background and select centre, the selected background colour will be used around the image if it is not large enough to cover the entire desktop.</para> +<para>Here you can change the desktop background which will be displayed before a user logs in. You can have a single colour or an image as a background. If you have an image as the background and select centre, the selected background colour will be used around the image if it is not large enough to cover the entire desktop.</para> -<para ->The background colours and effects are controlled by the options on the tab labelled <guilabel ->Background</guilabel -> and you select a background image and its placement from the options on the tab labelled <guilabel ->Wallpaper</guilabel ->.</para> +<para>The background colours and effects are controlled by the options on the tab labelled <guilabel>Background</guilabel> and you select a background image and its placement from the options on the tab labelled <guilabel>Wallpaper</guilabel>.</para> -<para ->To change the default background colour(s) simply click either of the colour buttons and select a new colour.</para> +<para>To change the default background colour(s) simply click either of the colour buttons and select a new colour.</para> -<para ->The dropdown box above the colour buttons provides you with several different blend effects. Choose one from the list, and it will be previewed on the small monitor at the top of the window. Your choices are:</para> +<para>The dropdown box above the colour buttons provides you with several different blend effects. Choose one from the list, and it will be previewed on the small monitor at the top of the window. Your choices are:</para> <variablelist> <varlistentry> -<term ->Flat</term> -<listitem -><para ->By choosing this mode, you select one colour (using the colour button labelled <guibutton ->Colour 1</guibutton ->), and the entire background is covered with this one colour.</para -></listitem> +<term>Flat</term> +<listitem><para>By choosing this mode, you select one colour (using the colour button labelled <guibutton>Colour 1</guibutton>), and the entire background is covered with this one colour.</para></listitem> </varlistentry> <varlistentry> -<term ->Pattern</term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). </para -> <para ->You then select a pattern by clicking <guilabel ->Setup</guilabel ->. This opens a new dialogue window, which gives you the opportunity to select a pattern. Simply click once on the pattern of your choice, then click on <guilabel ->OK</guilabel ->, and &kde; will render the pattern you selected using the two colours you selected. For more on patterns, see the section <ulink url="help:/kcontrol/background/index.html#bkgnd-patterns" ->Background: Adding, Removing and Modifying Patterns</ulink ->.</para -></listitem> +<term>Pattern</term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). </para> <para>You then select a pattern by clicking <guilabel>Setup</guilabel>. This opens a new dialogue window, which gives you the opportunity to select a pattern. Simply click once on the pattern of your choice, then click on <guilabel>OK</guilabel>, and &kde; will render the pattern you selected using the two colours you selected. For more on patterns, see the section <ulink url="help:/kcontrol/background/index.html#bkgnd-patterns">Background: Adding, Removing and Modifying Patterns</ulink>.</para></listitem> </varlistentry> <varlistentry> -<term ->Background Program</term> -<listitem -><para ->By selecting this option, you can have &kde; use an external program to determine the background. This can be any program of your choosing. For more information on this option, see the section entitled <ulink url="help:/kcontrol/background/index.html#bkgnd-programs" ->Background: Using an external program</ulink ->.</para -></listitem> +<term>Background Program</term> +<listitem><para>By selecting this option, you can have &kde; use an external program to determine the background. This can be any program of your choosing. For more information on this option, see the section entitled <ulink url="help:/kcontrol/background/index.html#bkgnd-programs">Background: Using an external program</ulink>.</para></listitem> </varlistentry> <varlistentry> -<term ->Horizontal Gradient</term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel ->Colour 1</guilabel -> on the left edge of the screen, and slowly transform into the colour selected by <guilabel ->Colour 2</guilabel -> by the time it gets to the right edge of the screen.</para -></listitem> +<term>Horizontal Gradient</term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel>Colour 1</guilabel> on the left edge of the screen, and slowly transform into the colour selected by <guilabel>Colour 2</guilabel> by the time it gets to the right edge of the screen.</para></listitem> </varlistentry> <varlistentry> -<term ->Vertical Gradient</term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel ->Colour 1</guilabel -> on the top edge of the screen, and slowly transform into the colour selected by <guilabel ->Colour 2</guilabel -> as it moves to the bottom of the screen.</para -></listitem> +<term>Vertical Gradient</term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel>Colour 1</guilabel> on the top edge of the screen, and slowly transform into the colour selected by <guilabel>Colour 2</guilabel> as it moves to the bottom of the screen.</para></listitem> </varlistentry> <varlistentry> -<term ->Pyramid Gradient</term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel ->Colour 1</guilabel -> in each corner of the screen, and slowly transform into the colour selected by <guilabel ->Colour 2</guilabel -> as it moves to the centre of the screen.</para -></listitem -> +<term>Pyramid Gradient</term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel>Colour 1</guilabel> in each corner of the screen, and slowly transform into the colour selected by <guilabel>Colour 2</guilabel> as it moves to the centre of the screen.</para></listitem> </varlistentry> <varlistentry> -<term ->Pipecross Gradient</term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel ->Colour 1</guilabel -> in each corner of the screen, and slowly transform into the colour selected by <guilabel ->Colour 2</guilabel -> as it moves to the centre of the screen. The <quote ->shape</quote -> of this gradient is different then the pyramid gradient.</para -></listitem> +<term>Pipecross Gradient</term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel>Colour 1</guilabel> in each corner of the screen, and slowly transform into the colour selected by <guilabel>Colour 2</guilabel> as it moves to the centre of the screen. The <quote>shape</quote> of this gradient is different then the pyramid gradient.</para></listitem> </varlistentry> <varlistentry> -<term ->Elliptic Gradient</term> -<listitem -><para ->By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel ->Colour 2</guilabel -> in the centre of the screen, and slowly transform into the colour selected by <guilabel ->Colour 1</guilabel -> as it moves to the edges, in an elliptical pattern.</para -></listitem -> +<term>Elliptic Gradient</term> +<listitem><para>By choosing this mode, you select two colours (using both colour buttons). &kde; will then start with the colour selected by <guilabel>Colour 2</guilabel> in the centre of the screen, and slowly transform into the colour selected by <guilabel>Colour 1</guilabel> as it moves to the edges, in an elliptical pattern.</para></listitem> </varlistentry> </variablelist> -<para ->The setup button is only needed for if you select <guilabel ->Background program</guilabel -> or <guilabel ->Patterns</guilabel ->. In these instances, another window will appear to configure the specifics.</para> -<para -><emphasis ->Wallpaper</emphasis -></para> -<para ->To select a new background image first, click on the <guilabel ->Wallpapers</guilabel -> tab, then you can either select an image from the drop-down list labelled <guilabel ->Wallpaper</guilabel -> or select <guibutton ->Browse...</guibutton -> and select an image file from a file selector.</para> - -<para ->The image can be displayed in six different ways:</para> +<para>The setup button is only needed for if you select <guilabel>Background program</guilabel> or <guilabel>Patterns</guilabel>. In these instances, another window will appear to configure the specifics.</para> +<para><emphasis>Wallpaper</emphasis></para> +<para>To select a new background image first, click on the <guilabel>Wallpapers</guilabel> tab, then you can either select an image from the drop-down list labelled <guilabel>Wallpaper</guilabel> or select <guibutton>Browse...</guibutton> and select an image file from a file selector.</para> + +<para>The image can be displayed in six different ways:</para> <variablelist> <varlistentry> -<term ->No wallpaper</term -> -<listitem -><para ->No image is displayed. Just the background colours.</para> -</listitem -></varlistentry> +<term>No wallpaper</term> +<listitem><para>No image is displayed. Just the background colours.</para> +</listitem></varlistentry> <varlistentry> -<term ->Centred</term -> -<listitem -><para ->The image will be centred on the screen. The background colours will be present anywhere the image does not cover.</para -> </listitem> +<term>Centred</term> +<listitem><para>The image will be centred on the screen. The background colours will be present anywhere the image does not cover.</para> </listitem> </varlistentry> <varlistentry> -<term ->Tiled</term> -<listitem -><para ->The image will be duplicated until it fills the entire desktop. The first image will be placed in the upper left corner of the screen, and duplicated downward and to the right.</para -> </listitem> +<term>Tiled</term> +<listitem><para>The image will be duplicated until it fills the entire desktop. The first image will be placed in the upper left corner of the screen, and duplicated downward and to the right.</para> </listitem> </varlistentry> <varlistentry> -<term ->Centre Tiled</term> -<listitem -><para ->The image will be duplicated until it fills the entire desktop. The first image will be placed in the centre of the screen, and duplicated upwards, downwards to the right, and to the left.</para -> </listitem> +<term>Centre Tiled</term> +<listitem><para>The image will be duplicated until it fills the entire desktop. The first image will be placed in the centre of the screen, and duplicated upwards, downwards to the right, and to the left.</para> </listitem> </varlistentry> <varlistentry> -<term ->Centred Maxpect</term> -<listitem -><para ->The image will be placed in the centre of the screen. It will be scaled to fit the desktop, but it will not change the aspect ratio of the original image. This will provide you with an image that is not distorted. </para -> </listitem> +<term>Centred Maxpect</term> +<listitem><para>The image will be placed in the centre of the screen. It will be scaled to fit the desktop, but it will not change the aspect ratio of the original image. This will provide you with an image that is not distorted. </para> </listitem> </varlistentry> <varlistentry> -<term ->Scaled</term> -<listitem -><para ->The image will be scaled to fit the desktop. It will be stretched to fit all four corners.</para -> </listitem> +<term>Scaled</term> +<listitem><para>The image will be scaled to fit the desktop. It will be stretched to fit all four corners.</para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="tdmconfig-shutdown"> -<title -><guilabel ->Shutdown</guilabel -></title> - -<para -><guilabel ->Allow Shutdown</guilabel -></para> -<para ->Use these dropdown box to choose who is allowed to shut down:</para> +<title><guilabel>Shutdown</guilabel></title> + +<para><guilabel>Allow Shutdown</guilabel></para> +<para>Use these dropdown box to choose who is allowed to shut down:</para> <itemizedlist> <listitem> -<para -><guilabel ->Nobody</guilabel ->: No one can shutdown the computer using &tdm;. You must be logged in, and execute a command.</para> +<para><guilabel>Nobody</guilabel>: No one can shutdown the computer using &tdm;. You must be logged in, and execute a command.</para> </listitem> <listitem> -<para -><guilabel ->Everybody</guilabel ->: Everyone can shutdown the computer using &tdm;.</para> +<para><guilabel>Everybody</guilabel>: Everyone can shutdown the computer using &tdm;.</para> </listitem> -<listitem -><para -><guilabel ->Only Root</guilabel ->: &tdm; requires that the <systemitem ->root</systemitem -> password be entered before shutting down the computer.</para -></listitem -> +<listitem><para><guilabel>Only Root</guilabel>: &tdm; requires that the <systemitem>root</systemitem> password be entered before shutting down the computer.</para></listitem> </itemizedlist> -<para ->You can independently configure who is allowed to issue a shutdown command for the <guilabel ->Local:</guilabel -> and <guilabel ->Remote:</guilabel -> users.</para> - -<para -><emphasis ->Commands</emphasis -></para -> <para ->Use these text fields to define the exact shutdown command.</para -> <para ->The <guilabel ->Halt:</guilabel -> command defaults to <command ->/sbin/halt</command ->. The restart command defaults to <command ->/sbin/reboot</command ->.</para> - -<para ->When <guilabel ->Show boot options</guilabel -> is enabled, &tdm; will on reboot offer you options for the lilo boot manager. For this feature to work, you will need to supply the correct paths to your <command ->lilo</command -> command and to lilo's map file.</para> +<para>You can independently configure who is allowed to issue a shutdown command for the <guilabel>Local:</guilabel> and <guilabel>Remote:</guilabel> users.</para> + +<para><emphasis>Commands</emphasis></para> <para>Use these text fields to define the exact shutdown command.</para> <para>The <guilabel>Halt:</guilabel> command defaults to <command>/sbin/halt</command>. The restart command defaults to <command>/sbin/reboot</command>.</para> + +<para>When <guilabel>Show boot options</guilabel> is enabled, &tdm; will on reboot offer you options for the lilo boot manager. For this feature to work, you will need to supply the correct paths to your <command>lilo</command> command and to lilo's map file.</para> <sect3 id="tdmconfig-sess"> -<title ->Session types</title> - -<para ->Define which session types should be accessible from the login window.</para> - -<para ->For more information on this subject, look at <filename class="directory" ->/etc/X11/xdm/Xsession</filename -> to find your <application ->xdm</application -> setup files. Also review the <ulink url="man:xdm" ->xdm man pages</ulink ->, especially under the SESSION PROGRAM section.</para> - -<para ->To add a session, type its name in the blank entitled <guilabel ->New types</guilabel ->, and click <guibutton ->Add new</guibutton ->. </para> - -<para ->To remove a session, select the session from the list and click <guibutton ->Remove</guibutton ->.</para> +<title>Session types</title> + +<para>Define which session types should be accessible from the login window.</para> + +<para>For more information on this subject, look at <filename class="directory">/etc/X11/xdm/Xsession</filename> to find your <application>xdm</application> setup files. Also review the <ulink url="man:xdm">xdm man pages</ulink>, especially under the SESSION PROGRAM section.</para> + +<para>To add a session, type its name in the blank entitled <guilabel>New types</guilabel>, and click <guibutton>Add new</guibutton>. </para> + +<para>To remove a session, select the session from the list and click <guibutton>Remove</guibutton>.</para> </sect3> </sect2> <sect2 id="tdmconfig-users"> -<title ->Users</title> +<title>Users</title> -<para ->From here you can change the way users are represented in the login window.</para> +<para>From here you can change the way users are represented in the login window.</para> -<para ->You may disable the user list in &tdm; entirely in the <guilabel ->Show Users</guilabel -> section. You can choose from:</para> +<para>You may disable the user list in &tdm; entirely in the <guilabel>Show Users</guilabel> section. You can choose from:</para> <variablelist> <varlistentry> -<term -><guilabel ->None</guilabel -></term> +<term><guilabel>None</guilabel></term> <listitem> -<para ->Do not show any users. This is the most secure setting, since an attacker would then have to guess a valid login name as well as a password. It's also the preferred option if you have more than a handful of users to list, or the list itself would become unwieldy.</para> +<para>Do not show any users. This is the most secure setting, since an attacker would then have to guess a valid login name as well as a password. It's also the preferred option if you have more than a handful of users to list, or the list itself would become unwieldy.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Selected only</guilabel -></term> +<term><guilabel>Selected only</guilabel></term> <listitem> -<para ->Only show users you have specifically enabled.</para> +<para>Only show users you have specifically enabled.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Not hidden</guilabel -></term> +<term><guilabel>Not hidden</guilabel></term> <listitem> -<para ->Allows you to select a list of users that should <emphasis ->not</emphasis -> be shown, and all other users will be listed.</para> +<para>Allows you to select a list of users that should <emphasis>not</emphasis> be shown, and all other users will be listed.</para> </listitem> </varlistentry> </variablelist> -<para ->Independently of the users you specify by name, you can use the <guilabel ->System UIDs</guilabel -> to specify a range of valid <acronym ->UID</acronym ->s that are shown in the list. By default user id's under 1000, which are often system or daemon users, and user id's over 65000, are not shown.</para> +<para>Independently of the users you specify by name, you can use the <guilabel>System UIDs</guilabel> to specify a range of valid <acronym>UID</acronym>s that are shown in the list. By default user id's under 1000, which are often system or daemon users, and user id's over 65000, are not shown.</para> -<para ->You can also enable the <guilabel ->Sort users</guilabel -> checkbox, to have the user list sorted alphabetically. If this is disabled, users will appear in the order they are listed in the password file.</para> +<para>You can also enable the <guilabel>Sort users</guilabel> checkbox, to have the user list sorted alphabetically. If this is disabled, users will appear in the order they are listed in the password file.</para> -<para ->If you choose to show users, then the login window will show images (which you select), of a list of users. When someone is ready to login, they may select their user name/image, enter their password, and they are granted access. </para> +<para>If you choose to show users, then the login window will show images (which you select), of a list of users. When someone is ready to login, they may select their user name/image, enter their password, and they are granted access. </para> -<para ->If you permit a user image, then you can configure the source for those images.</para> +<para>If you permit a user image, then you can configure the source for those images.</para> -<para ->The available options for the <guilabel ->User Image Source</guilabel -> are:</para> +<para>The available options for the <guilabel>User Image Source</guilabel> are:</para> <!-- user image sources list here --> -<para ->You can configure the admin picture here, for each user on the system. Depending on the order selected above, users may be able to override your selection.</para> +<para>You can configure the admin picture here, for each user on the system. Depending on the order selected above, users may be able to override your selection.</para> -<para ->If you choose not to show users, then the login window will be more traditional. Users will need to type their username and password to gain entrance. This is the preferred way if you have many users on this terminal.</para> +<para>If you choose not to show users, then the login window will be more traditional. Users will need to type their username and password to gain entrance. This is the preferred way if you have many users on this terminal.</para> <sect3 id="tdmconfig-showusers"> -<title ->To show (and sort) or not to show users</title> +<title>To show (and sort) or not to show users</title> -<para ->Along the right edge of the window are two check boxes:</para> +<para>Along the right edge of the window are two check boxes:</para> -<para ->If <guilabel ->Show users</guilabel -> is selected you have chosen to show images of users, instead of making them type their login name.</para> +<para>If <guilabel>Show users</guilabel> is selected you have chosen to show images of users, instead of making them type their login name.</para> -<para ->If <guilabel ->Sort users</guilabel -> is selected, then the list of users will be sorted alphabetically in the login window. If unchecked, users will be listed in the same order as they are on this page. If <guilabel ->Show users</guilabel -> is not checked, this has no effect.</para> +<para>If <guilabel>Sort users</guilabel> is selected, then the list of users will be sorted alphabetically in the login window. If unchecked, users will be listed in the same order as they are on this page. If <guilabel>Show users</guilabel> is not checked, this has no effect.</para> </sect3> <sect3 id="tdmconfig-whichusers"> -<title ->How to determine which users to show and which users to hide</title> +<title>How to determine which users to show and which users to hide</title> -<para ->Below the user image box, and above the <guilabel ->Show users</guilabel -> check box, is a set of two radio buttions:</para> +<para>Below the user image box, and above the <guilabel>Show users</guilabel> check box, is a set of two radio buttions:</para> <itemizedlist> -<listitem -><para ->Show only selected users: If this option is selected, only the users contained in the list labelled <guilabel ->Selected Users</guilabel ->, will be displayed in the login window. If <guilabel ->Show users</guilabel -> is not checked, this has no effect.</para -></listitem> -<listitem -><para ->Show all users but no-show users: If this option is selected, all users will be listed, <emphasis ->except</emphasis -> those users contained in the list entitled <guilabel ->No show users</guilabel ->. If <guilabel ->Show users</guilabel -> is not checked, this has no effect. </para -></listitem> +<listitem><para>Show only selected users: If this option is selected, only the users contained in the list labelled <guilabel>Selected Users</guilabel>, will be displayed in the login window. If <guilabel>Show users</guilabel> is not checked, this has no effect.</para></listitem> +<listitem><para>Show all users but no-show users: If this option is selected, all users will be listed, <emphasis>except</emphasis> those users contained in the list entitled <guilabel>No show users</guilabel>. If <guilabel>Show users</guilabel> is not checked, this has no effect. </para></listitem> </itemizedlist> </sect3> <sect3 id="tdmconfig-select"> -<title ->Select users</title> +<title>Select users</title> -<para ->This page contains three listboxes. The large listbox on the left shows all the users on the system which might be a genuine user.</para> +<para>This page contains three listboxes. The large listbox on the left shows all the users on the system which might be a genuine user.</para> -<para ->The top rightmost listbox shows the selected users and the bottom rightmost listbox shows the users we do not want displayed in the login window.</para> +<para>The top rightmost listbox shows the selected users and the bottom rightmost listbox shows the users we do not want displayed in the login window.</para> -<para ->To move a user from one listbox to another you click on the username in the listbox and click <guibutton ->>></guibutton -> to move the user from the leftmost box the the rightmost box or <guibutton -><<</guibutton -> to move the user from the rightmost box to the leftmost box.</para> +<para>To move a user from one listbox to another you click on the username in the listbox and click <guibutton>>></guibutton> to move the user from the leftmost box the the rightmost box or <guibutton><<</guibutton> to move the user from the rightmost box to the leftmost box.</para> </sect3> <sect3 id="tdmconfig-image"> -<title ->Images</title> - -<note -><para ->This section of the manual only applies if <guilabel ->Show users</guilabel -> is selected. If it is not, this image box has no effect.</para -></note> - -<para ->Every user on the system can be represented by an image. The image for each user is kept in a file called <filename ->$<envar ->TDEDIR</envar ->/share/apps/tdm/pics/users/$<envar ->USER</envar ->.xpm</filename ->. If there is no such file for a particular user, the file <filename ->$<envar ->TDEDIR</envar ->/share/apps/tdm/pics/users/default.xpm</filename -> will be used instead.</para> - -<para ->To assign a new image to a user just select the user in one of the listboxes and either drop an imagefile on the image button to the right or click on the image button and select a new image from the image selector.</para> - -<para ->If no user is currently selected you will be asked if you want to change the default image.</para> - -<para ->The replacement is performed by a &konqueror; process so if the imagefile already exists you will be prompted by &konqueror; if you want to replace it. If you confirm the image will be replaced - you will <emphasis ->NOT</emphasis -> have to press the <guibutton ->Apply</guibutton -> button.</para> +<title>Images</title> + +<note><para>This section of the manual only applies if <guilabel>Show users</guilabel> is selected. If it is not, this image box has no effect.</para></note> + +<para>Every user on the system can be represented by an image. The image for each user is kept in a file called <filename>$<envar>TDEDIR</envar>/share/apps/tdm/pics/users/$<envar>USER</envar>.xpm</filename>. If there is no such file for a particular user, the file <filename>$<envar>TDEDIR</envar>/share/apps/tdm/pics/users/default.xpm</filename> will be used instead.</para> + +<para>To assign a new image to a user just select the user in one of the listboxes and either drop an imagefile on the image button to the right or click on the image button and select a new image from the image selector.</para> + +<para>If no user is currently selected you will be asked if you want to change the default image.</para> + +<para>The replacement is performed by a &konqueror; process so if the imagefile already exists you will be prompted by &konqueror; if you want to replace it. If you confirm the image will be replaced - you will <emphasis>NOT</emphasis> have to press the <guibutton>Apply</guibutton> button.</para> </sect3> </sect2> <sect2 id="tdmconfig-convenience"> -<title ->Convenience</title> +<title>Convenience</title> -<para ->In the <guilabel ->convenience</guilabel -> tab you can configure some options that make life easier for lazy people, like automatic login or disabling passwords.</para> +<para>In the <guilabel>convenience</guilabel> tab you can configure some options that make life easier for lazy people, like automatic login or disabling passwords.</para> -<important -><para ->Please think more than twice before using these options. Every option in the <guilabel ->Convenience</guilabel -> tab is well-suited to seriously compromise your system security. Practically, these options are only to be used in a completely non-critical environment, ⪚ a private computer at home. </para -></important> +<important><para>Please think more than twice before using these options. Every option in the <guilabel>Convenience</guilabel> tab is well-suited to seriously compromise your system security. Practically, these options are only to be used in a completely non-critical environment, ⪚ a private computer at home. </para></important> <sect3 id="loginmanager-convenience-autologin"> -<title ->Automatic Login</title> +<title>Automatic Login</title> -<para ->Automatic login will give anyone access to a certain account on your system without doing any authentication. You can enable it using the option <guilabel ->Enable auto-login</guilabel ->.</para> +<para>Automatic login will give anyone access to a certain account on your system without doing any authentication. You can enable it using the option <guilabel>Enable auto-login</guilabel>.</para> -<para ->You can choose the account to be used for automatic login from the list labelled <guilabel ->User:</guilabel ->.</para> +<para>You can choose the account to be used for automatic login from the list labelled <guilabel>User:</guilabel>.</para> </sect3> <sect3 id="loginmanager-convenience-nopasswd"> -<title -><guilabel ->Password-Less Login</guilabel -></title> - -<para ->Using this feature, you can allow certain users to login without having to provide their password. Enable this feature using the <guilabel ->Enable password-less logins</guilabel -> option.</para> - -<para ->Below this option you'll see a list of users on the system. Enable password-less login for specific users by checking the checkbox next to the login names. By default, this feature is disabled for all users.</para> - -<important -><para ->Again, this option should only be used in a safe environment. If you enable it on a rather public system you should take care that only users with heavy access restrictions are granted password-less login, ⪚ <systemitem ->guest</systemitem ->.</para -></important> - -<para ->The <guilabel ->Automatically login after X server crash</guilabel -> option allows you to skip the authentication procedure when your X server accidentally crashed.</para> - -<para ->You can also choose which user is <quote ->preselected</quote -> when &tdm; starts. The default is <guilabel ->None</guilabel ->, but you can choose <guilabel ->Previous</guilabel -> to have &tdm; default to the last successfully logged in user, or you can <guilabel ->Specify</guilabel -> a particular user to always be selected from the list. You can also have &tdm; set the focus to the password field, so that when you reach the &tdm; login screen, you can type the password immediately.</para> +<title><guilabel>Password-Less Login</guilabel></title> + +<para>Using this feature, you can allow certain users to login without having to provide their password. Enable this feature using the <guilabel>Enable password-less logins</guilabel> option.</para> + +<para>Below this option you'll see a list of users on the system. Enable password-less login for specific users by checking the checkbox next to the login names. By default, this feature is disabled for all users.</para> + +<important><para>Again, this option should only be used in a safe environment. If you enable it on a rather public system you should take care that only users with heavy access restrictions are granted password-less login, ⪚ <systemitem>guest</systemitem>.</para></important> + +<para>The <guilabel>Automatically login after X server crash</guilabel> option allows you to skip the authentication procedure when your X server accidentally crashed.</para> + +<para>You can also choose which user is <quote>preselected</quote> when &tdm; starts. The default is <guilabel>None</guilabel>, but you can choose <guilabel>Previous</guilabel> to have &tdm; default to the last successfully logged in user, or you can <guilabel>Specify</guilabel> a particular user to always be selected from the list. You can also have &tdm; set the focus to the password field, so that when you reach the &tdm; login screen, you can type the password immediately.</para> </sect3> @@ -1221,29 +564,16 @@ <!-- ************************************************************ --> <chapter id="configuring-your-system-for-tdm"> -<title ->Configuring your system to use &tdm;</title> +<title>Configuring your system to use &tdm;</title> -<para ->This chapter assumes that your system is already configured to run the X Window System, and that you only need to reconfigure it to allow graphical login.</para> +<para>This chapter assumes that your system is already configured to run the X Window System, and that you only need to reconfigure it to allow graphical login.</para> <sect1 id="setting-up-tdm"> -<title ->Setting up &tdm;</title> - -<para ->The fundamental thing that controls whether your computer boots to a terminal prompt (console mode) or a graphical login prompt is the default runlevel. The runlevel is set by the program <application -> <ulink url="man:init" ->/sbin/init</ulink -></application -> under the control of the configuration file <filename ->/etc/inittab</filename ->. The default runlevels used by different &UNIX; systems (and different &Linux; distributions) vary, but if you look at <filename ->/etc/inittab</filename -> the start of it should be something like this:</para> - -<screen -># Default runlevel. The runlevels used by RHS are: +<title>Setting up &tdm;</title> + +<para>The fundamental thing that controls whether your computer boots to a terminal prompt (console mode) or a graphical login prompt is the default runlevel. The runlevel is set by the program <application> <ulink url="man:init">/sbin/init</ulink></application> under the control of the configuration file <filename>/etc/inittab</filename>. The default runlevels used by different &UNIX; systems (and different &Linux; distributions) vary, but if you look at <filename>/etc/inittab</filename> the start of it should be something like this:</para> + +<screen># Default runlevel. The runlevels used by RHS are: # 0 - halt (Do NOT set initdefault to this) # 1 - Single user mode # 2 - Multiuser, without NFS @@ -1255,263 +585,107 @@ id:3:initdefault: </screen> -<para ->All but the last line of this extract are comments. The comments show that runlevel 5 is used for X11 and that runlevel 3 is used for multi-user mode without X11 (console mode). The final line specifies that the default runlevel of the system is 3 (console mode). If your system currently uses graphical login (for example, using &xdm;) its default runlevel will match the runlevel specified for X11.</para> +<para>All but the last line of this extract are comments. The comments show that runlevel 5 is used for X11 and that runlevel 3 is used for multi-user mode without X11 (console mode). The final line specifies that the default runlevel of the system is 3 (console mode). If your system currently uses graphical login (for example, using &xdm;) its default runlevel will match the runlevel specified for X11.</para> -<para ->The runlevel with graphical login (&xdm;) for some common &Linux; distributions are:</para> +<para>The runlevel with graphical login (&xdm;) for some common &Linux; distributions are:</para> <itemizedlist> -<listitem -><para ->5 for &RedHat; 3.x and later, and for &Mandrake;</para -></listitem> -<listitem -><para ->4 for Slackware</para -></listitem> -<listitem -><para ->3 for &SuSE;. 4.x and 5.x</para -></listitem> +<listitem><para>5 for &RedHat; 3.x and later, and for &Mandrake;</para></listitem> +<listitem><para>4 for Slackware</para></listitem> +<listitem><para>3 for &SuSE;. 4.x and 5.x</para></listitem> </itemizedlist> -<para ->The first step in configuring your system is to ensure that you can start &tdm; from the command line. Once this is working, you can change your system configuration so that &tdm; starts automatically each time you reboot your system.</para> - -<para ->To test &tdm;, you must first bring your system to a runlevel that does not run &xdm;. To do so, issue a command like this:</para> - -<screen -><command ->/sbin/init <option ->3</option -></command -></screen> - -<para ->Instead of the number <option ->3</option -> you should specify the appropriate runlevel for console mode on your system.</para> - -<para ->If your system uses Pluggable Authentication Modules (<abbrev ->PAM</abbrev ->), which is normal with recent &Linux; and Solaris systems, you should check that your <abbrev ->PAM</abbrev -> configuration permits login through the service named <literal ->kde</literal ->. If you previously used &xdm; successfully, you should not need to make any changes to your <abbrev ->PAM</abbrev -> configuration in order to use &tdm;. <filename ->/etc/pam.conf</filename -> or <filename ->/etc/pam.d/kde</filename ->. Information on configuring <abbrev ->PAM</abbrev -> is beyond the scope of this handbook, but <abbrev ->PAM</abbrev -> comes with comprehensive documentation (try looking in <filename ->/usr/share/doc/*pam*/html/</filename ->).</para> - -<para ->Now it's time for you to test &tdm; by issuing the following command:</para> - -<screen -><command ->tdm <option ->-nodaemon</option -></command -> +<para>The first step in configuring your system is to ensure that you can start &tdm; from the command line. Once this is working, you can change your system configuration so that &tdm; starts automatically each time you reboot your system.</para> + +<para>To test &tdm;, you must first bring your system to a runlevel that does not run &xdm;. To do so, issue a command like this:</para> + +<screen><command>/sbin/init <option>3</option></command></screen> + +<para>Instead of the number <option>3</option> you should specify the appropriate runlevel for console mode on your system.</para> + +<para>If your system uses Pluggable Authentication Modules (<abbrev>PAM</abbrev>), which is normal with recent &Linux; and Solaris systems, you should check that your <abbrev>PAM</abbrev> configuration permits login through the service named <literal>kde</literal>. If you previously used &xdm; successfully, you should not need to make any changes to your <abbrev>PAM</abbrev> configuration in order to use &tdm;. <filename>/etc/pam.conf</filename> or <filename>/etc/pam.d/kde</filename>. Information on configuring <abbrev>PAM</abbrev> is beyond the scope of this handbook, but <abbrev>PAM</abbrev> comes with comprehensive documentation (try looking in <filename>/usr/share/doc/*pam*/html/</filename>).</para> + +<para>Now it's time for you to test &tdm; by issuing the following command:</para> + +<screen><command>tdm <option>-nodaemon</option></command> </screen> -<para ->If you get a &tdm; login dialogue and you are able to log in, things are going well. The main thing that can go wrong here is that the run-time linker might not find the shared &Qt; or &kde; libraries. If you have a binary distribution of the &kde; libraries, make sure &tdm; is installed where the libraries believe &kde; is installed and try setting some environment variables to point to your &kde; and &Qt; libraries.</para> - -<para ->For example:</para> - -<screen -><command ->export -<option ->TDEDIR=<replaceable ->/opt/kde</replaceable -></option -></command> -<command ->export -<option ->QTDIR=<replaceable ->/usr/lib/qt2</replaceable -></option -></command> -<command ->export -<option ->PATH=<replaceable ->$TDEDIR/bin:$QTDIR/bin:$PATH</replaceable -></option -></command> -<command ->export -<option ->LD_LIBRARY_PATH=<replaceable ->$TDEDIR/lib:$QTDIR/lib</replaceable -></option -></command -> +<para>If you get a &tdm; login dialogue and you are able to log in, things are going well. The main thing that can go wrong here is that the run-time linker might not find the shared &Qt; or &kde; libraries. If you have a binary distribution of the &kde; libraries, make sure &tdm; is installed where the libraries believe &kde; is installed and try setting some environment variables to point to your &kde; and &Qt; libraries.</para> + +<para>For example:</para> + +<screen><command>export +<option>TDEDIR=<replaceable>/opt/kde</replaceable></option></command> +<command>export +<option>QTDIR=<replaceable>/usr/lib/qt2</replaceable></option></command> +<command>export +<option>PATH=<replaceable>$TDEDIR/bin:$QTDIR/bin:$PATH</replaceable></option></command> +<command>export +<option>LD_LIBRARY_PATH=<replaceable>$TDEDIR/lib:$QTDIR/lib</replaceable></option></command> </screen> -<para ->If you are still unsuccessful, try starting &xdm; instead, to make sure that you are not suffering from a more serious X configuration problem.</para> +<para>If you are still unsuccessful, try starting &xdm; instead, to make sure that you are not suffering from a more serious X configuration problem.</para> -<para ->When you are able to start &tdm; successfully, you can start to replace &xdm; by &tdm;. Again, this is distribution-dependent.</para> +<para>When you are able to start &tdm; successfully, you can start to replace &xdm; by &tdm;. Again, this is distribution-dependent.</para> <itemizedlist> <listitem> -<para ->For &RedHat;, edit <filename ->/etc/inittab</filename ->, look for the string xdm and replace it with &tdm; (including all paths).</para> +<para>For &RedHat;, edit <filename>/etc/inittab</filename>, look for the string xdm and replace it with &tdm; (including all paths).</para> </listitem> <listitem> -<para ->For &Mandrake;, the X11 runlevel in <filename ->/etc/inittab</filename -> invokes the shell script <filename ->/etc/X11/prefdm</filename ->, which is set up to select from amongst several display managers, including &tdm;. Make sure that all the paths are correct for your installation.</para -> +<para>For &Mandrake;, the X11 runlevel in <filename>/etc/inittab</filename> invokes the shell script <filename>/etc/X11/prefdm</filename>, which is set up to select from amongst several display managers, including &tdm;. Make sure that all the paths are correct for your installation.</para> </listitem> <listitem> -<para ->For &SuSE;, edit <filename ->/sbin/init.d/xdm</filename -> to add a first line:</para> +<para>For &SuSE;, edit <filename>/sbin/init.d/xdm</filename> to add a first line:</para> -<screen ->. /etc/rc.config +<screen>. /etc/rc.config DISPLAYMANAGER=tdm export DISPLAYMANAGER</screen> </listitem> -<listitem -><para ->For FreeBSD, edit <filename ->/etc/ttys</filename -> and find the line like this: <screen ->ttyv8 "/usr/X11R6/bin/xdm -nodaemon" xterm off secure</screen -> and edit it to this: <screen ->ttyv8 "/usr/local/bin/tdm -nodaemon" xterm on secure</screen> +<listitem><para>For FreeBSD, edit <filename>/etc/ttys</filename> and find the line like this: <screen>ttyv8 "/usr/X11R6/bin/xdm -nodaemon" xterm off secure</screen> and edit it to this: <screen>ttyv8 "/usr/local/bin/tdm -nodaemon" xterm on secure</screen> </para> </listitem> -<listitem -><para ->Most other distributions are a variation of one of these.</para -></listitem> +<listitem><para>Most other distributions are a variation of one of these.</para></listitem> </itemizedlist> -<para ->At this stage, you can test &tdm; again by bringing your system to the runlevel that should now run &tdm;. To do so, issue a command like this:</para> +<para>At this stage, you can test &tdm; again by bringing your system to the runlevel that should now run &tdm;. To do so, issue a command like this:</para> -<screen -><command ->/sbin/init <option ->5</option -></command -> +<screen><command>/sbin/init <option>5</option></command> </screen> -<para ->Instead of the number <option ->5</option -> you should specify the appropriate runlevel for running X11 on your system.</para> - -<para ->The final step is to edit the <parameter ->initdefault</parameter -> entry in <filename ->/etc/inittab</filename -> to specify the appropriate runlevel for X11.</para> - -<warning -><para ->Before you make this change, ensure that you have a way to reboot your system if a problem occurs. This might be a <quote ->rescue</quote -> floppy-disk provided by your operating system distribution or a specially-designed <quote ->rescue</quote -> floppy-disk, such as <literal ->tomsrtbt</literal ->. Ignore this advice at your peril.</para -></warning> - -<para ->When you reboot your system, you should end up with the graphical &tdm; login dialogue.</para> - -<para ->If this step is unsuccessful the most likely problem is that the environment used at boot time differs from the environment that you used for testing at the command line. If you are trying to get two versions of KDE to co-exist, be particularly careful that the settings you use for your <envar ->PATH</envar -> and <envar ->LD_LIBRARY_PATH</envar -> environment variables are consistent, and that the startup scripts are not over-riding them in some way.</para> +<para>Instead of the number <option>5</option> you should specify the appropriate runlevel for running X11 on your system.</para> + +<para>The final step is to edit the <parameter>initdefault</parameter> entry in <filename>/etc/inittab</filename> to specify the appropriate runlevel for X11.</para> + +<warning><para>Before you make this change, ensure that you have a way to reboot your system if a problem occurs. This might be a <quote>rescue</quote> floppy-disk provided by your operating system distribution or a specially-designed <quote>rescue</quote> floppy-disk, such as <literal>tomsrtbt</literal>. Ignore this advice at your peril.</para></warning> + +<para>When you reboot your system, you should end up with the graphical &tdm; login dialogue.</para> + +<para>If this step is unsuccessful the most likely problem is that the environment used at boot time differs from the environment that you used for testing at the command line. If you are trying to get two versions of KDE to co-exist, be particularly careful that the settings you use for your <envar>PATH</envar> and <envar>LD_LIBRARY_PATH</envar> environment variables are consistent, and that the startup scripts are not over-riding them in some way.</para> </sect1> </chapter> <chapter id="different-window-managers-with-tdm"> -<title ->Supporting multiple window managers</title> - -<para ->The main dialogue box for &tdm; includes a <guilabel ->Session Type:</guilabel -> drop-down box, which allows you to select a window manager to use for your session. This chapter describes the changes that you must make to your configuration files in order to support this feature.</para> - -<para ->The options that appear in the <guilabel ->Session Type:</guilabel -> drop-down box are <ulink url="TDM" ->configured</ulink -> by entries in the <literal ->TDM</literal -> section of &tdmrc;.</para> - -<para ->When you log in using &tdm;, the shell script <filename ->Xsession</filename -> is executed. The session type that you select is passed as a command-line argument. (<filename ->Xsession</filename -> can be found in <filename ->/etc/X11/xdm/</filename -> for Redhat and Mandrake, and in <filename ->/usr/X11R6/lib/X11/xdm/</filename -> for S.u.S.E.). Whilst debugging, you might find it helpful to add this line to <filename ->Xsession</filename ->:</para> +<title>Supporting multiple window managers</title> + +<para>The main dialogue box for &tdm; includes a <guilabel>Session Type:</guilabel> drop-down box, which allows you to select a window manager to use for your session. This chapter describes the changes that you must make to your configuration files in order to support this feature.</para> + +<para>The options that appear in the <guilabel>Session Type:</guilabel> drop-down box are <ulink url="TDM">configured</ulink> by entries in the <literal>TDM</literal> section of &tdmrc;.</para> + +<para>When you log in using &tdm;, the shell script <filename>Xsession</filename> is executed. The session type that you select is passed as a command-line argument. (<filename>Xsession</filename> can be found in <filename>/etc/X11/xdm/</filename> for Redhat and Mandrake, and in <filename>/usr/X11R6/lib/X11/xdm/</filename> for S.u.S.E.). Whilst debugging, you might find it helpful to add this line to <filename>Xsession</filename>:</para> -<screen ->echo "$0 || $1 || $2" -> $HOME/.Xsession_args </screen> +<screen>echo "$0 || $1 || $2" > $HOME/.Xsession_args </screen> -<para ->How you proceed now depends upon how your system usually starts up window managers. Here are two different approaches, with examples of the changes that you must make:</para> +<para>How you proceed now depends upon how your system usually starts up window managers. Here are two different approaches, with examples of the changes that you must make:</para> <itemizedlist> -<listitem -><para ->The window manager is started by commands within <filename ->Xsession</filename ->. In this case, you can add a case statement to start the appropriate window manager. Linux Mandrake uses this approach; here is an extract from <filename ->Xsession</filename ->:</para> +<listitem><para>The window manager is started by commands within <filename>Xsession</filename>. In this case, you can add a case statement to start the appropriate window manager. Linux Mandrake uses this approach; here is an extract from <filename>Xsession</filename>:</para> -<screen -># now, we see if xdm/gdm/tdm has asked for a specific environment +<screen># now, we see if xdm/gdm/tdm has asked for a specific environment case $# in 1) case $1 in @@ -1536,50 +710,17 @@ esac </screen> </listitem> -<listitem -><para ->The window manager is started by another script that is invoked by <filename ->Xsession</filename ->. In this case you must ensure that the parameter passed to <filename ->Xsession</filename -> is passed on to that other script. For example, if the window manager is started like this:</para> - -<screen -><command ->exec <option ->$startup</option -></command -></screen> - -<para ->you would need to change it to:</para> - -<screen -><command ->exec <option ->$startup</option -><option ->$@</option -></command -></screen> - -<para ->Having made this change, you must trace your way through the startup to find the place where the window manager is started. One approach uses <filename ->xinitrc</filename -> to start the window manager; this allows a system-wide file <filename ->/etc/X11/xinit/xinitrc</filename -> or a user-specific file <filename ->$HOME/.xinitrc</filename -> to be used. If you edit <filename ->$HOME/.xinitrc</filename ->, you may want to save a copy in <filename ->/etc/skel</filename ->, so that it will be automatically generated in every user account you create from now on. Here is an example <filename ->xinitrc</filename -> for a system using this approach:</para> - -<screen ->#!/bin/bash +<listitem><para>The window manager is started by another script that is invoked by <filename>Xsession</filename>. In this case you must ensure that the parameter passed to <filename>Xsession</filename> is passed on to that other script. For example, if the window manager is started like this:</para> + +<screen><command>exec <option>$startup</option></command></screen> + +<para>you would need to change it to:</para> + +<screen><command>exec <option>$startup</option><option>$@</option></command></screen> + +<para>Having made this change, you must trace your way through the startup to find the place where the window manager is started. One approach uses <filename>xinitrc</filename> to start the window manager; this allows a system-wide file <filename>/etc/X11/xinit/xinitrc</filename> or a user-specific file <filename>$HOME/.xinitrc</filename> to be used. If you edit <filename>$HOME/.xinitrc</filename>, you may want to save a copy in <filename>/etc/skel</filename>, so that it will be automatically generated in every user account you create from now on. Here is an example <filename>xinitrc</filename> for a system using this approach:</para> + +<screen>#!/bin/bash # # .xsession/.xinitrc # @@ -1639,164 +780,82 @@ exec $WINDOWMANAGER </chapter> <chapter id="xdmcp-with-tdm"> -<title ->Using &tdm; for Remote Logins (&XDMCP;)</title> +<title>Using &tdm; for Remote Logins (&XDMCP;)</title> -<para ->&XDMCP; is the Open Group standard, the <quote ->X Display Manager Control Protocol</quote ->. This is used to set up connections between remote systems over the network.</para> +<para>&XDMCP; is the Open Group standard, the <quote>X Display Manager Control Protocol</quote>. This is used to set up connections between remote systems over the network.</para> -<para ->&XDMCP; is useful in multiuser situations where there are users with workstations and a more powerful server that can provide the resources to run multiple X sessions. For example, &XDMCP; is a good way to reuse old computers - a Pentium or even 486 computer with 16 Mb RAM is sufficient to run X itself, and using XDMCP such a computer can run a full modern &kde; session from a server. For the server part, once a single &kde; (or other environment) session is running, running another one requires very few extra resources.</para> +<para>&XDMCP; is useful in multiuser situations where there are users with workstations and a more powerful server that can provide the resources to run multiple X sessions. For example, &XDMCP; is a good way to reuse old computers - a Pentium or even 486 computer with 16 Mb RAM is sufficient to run X itself, and using XDMCP such a computer can run a full modern &kde; session from a server. For the server part, once a single &kde; (or other environment) session is running, running another one requires very few extra resources.</para> -<para ->However, allowing another method of login to your machine obviously has security implications. You should run this service only if you need to allow remote X Servers to start login sessions on your system. Users with a single &UNIX; computer should not need to run this.</para> +<para>However, allowing another method of login to your machine obviously has security implications. You should run this service only if you need to allow remote X Servers to start login sessions on your system. Users with a single &UNIX; computer should not need to run this.</para> <!-- Write more stuff --> </chapter> <!-- *********************************************************************** --> <chapter id="Other-Information"> -<title ->Other sources of information</title> - -<para ->Since &tdm; is descended from &xdm;, the <ulink url="man:xdm" ->xdm man page</ulink -> may provide useful background information. For X-related problems try the man pages <ulink url="man:X" ->X</ulink -> and <ulink url="man:startx" ->startx</ulink ->. If you have questions about &tdm; that are not answered by this handbook, take advantage of the fact the &tdm; is provided under the terms of the <abbrev ->GNU</abbrev -> General Public Licence: look at the source code. </para> +<title>Other sources of information</title> + +<para>Since &tdm; is descended from &xdm;, the <ulink url="man:xdm">xdm man page</ulink> may provide useful background information. For X-related problems try the man pages <ulink url="man:X">X</ulink> and <ulink url="man:startx">startx</ulink>. If you have questions about &tdm; that are not answered by this handbook, take advantage of the fact the &tdm; is provided under the terms of the <abbrev>GNU</abbrev> General Public Licence: look at the source code. </para> </chapter> <!-- *********************************************************************** --> -<chapter id="credits" -><title ->Credits and Licence</title> - -<para ->&tdm; is derived from, and includes code from, &xdm; (C) Keith Packard, MIT X Consortium.</para> - -<para ->&tdm; 0.1 was written by Matthias Ettrich. Later versions till &kde; 2.0.x were written by Steffen Hansen. Some new features for &kde; 2.1.x and a major rewrite for &kde; 2.2.x made by Oswald Buddenhagen.</para> - -<para ->Other parts of the &tdm; code are copyright by the authors, and licensed under the terms of the <ulink url="common/gpl-license.html" ->GNU GPL</ulink ->. Anyone is allowed to change &tdm; and redistribute the result as long as the names of the authors are mentioned.</para> - -<para ->&tdm; requires the Qt library, which is copyright Troll Tech AS.</para> - -<para ->Documentation contributors: <itemizedlist> - -<listitem -><para ->Documentation written by Steffen Hansen <email ->stefh@dit.ou.dk</email -></para -></listitem> - -<listitem -><para ->Documentation extended by Gregor Zumstein<email ->zumstein@ssd.ethz.ch</email ->. Last update August 9, 1998</para -></listitem> - -<listitem -><para ->Documentation revised for KDE 2 by Neal Crook<email ->nac@forth.org</email ->. Last update August 6, 2000</para -></listitem> - -<listitem -><para ->Documentation extended and revised for KDE 2.2 by Oswald Buddenhagen<email ->ossi@kde.org</email ->. Last update August, 2001</para -></listitem> - -</itemizedlist -></para> - -<para ->Documentation copyright Steffen Hansen, Gregor Zumstein, Neal Crook and Oswald Buddenhagen. This document also includes large parts of the &xdm; man page, which is (C) Keith Packard.</para> - -<para ->Conversion to British English: John Knight <email ->anarchist_tomato@herzeleid.net</email -></para -> +<chapter id="credits"><title>Credits and Licence</title> + +<para>&tdm; is derived from, and includes code from, &xdm; (C) Keith Packard, MIT X Consortium.</para> + +<para>&tdm; 0.1 was written by Matthias Ettrich. Later versions till &kde; 2.0.x were written by Steffen Hansen. Some new features for &kde; 2.1.x and a major rewrite for &kde; 2.2.x made by Oswald Buddenhagen.</para> + +<para>Other parts of the &tdm; code are copyright by the authors, and licensed under the terms of the <ulink url="common/gpl-license.html">GNU GPL</ulink>. Anyone is allowed to change &tdm; and redistribute the result as long as the names of the authors are mentioned.</para> + +<para>&tdm; requires the Qt library, which is copyright Troll Tech AS.</para> + +<para>Documentation contributors: <itemizedlist> + +<listitem><para>Documentation written by Steffen Hansen <email>stefh@dit.ou.dk</email></para></listitem> + +<listitem><para>Documentation extended by Gregor Zumstein<email>zumstein@ssd.ethz.ch</email>. Last update August 9, 1998</para></listitem> + +<listitem><para>Documentation revised for KDE 2 by Neal Crook<email>nac@forth.org</email>. Last update August 6, 2000</para></listitem> + +<listitem><para>Documentation extended and revised for KDE 2.2 by Oswald Buddenhagen<email>ossi@kde.org</email>. Last update August, 2001</para></listitem> + +</itemizedlist></para> + +<para>Documentation copyright Steffen Hansen, Gregor Zumstein, Neal Crook and Oswald Buddenhagen. This document also includes large parts of the &xdm; man page, which is (C) Keith Packard.</para> + +<para>Conversion to British English: John Knight <email>anarchist_tomato@herzeleid.net</email></para> &underFDL; &underGPL; </chapter> <appendix id="building-and-installing-tdm"> -<title ->Building and Installing tdm</title> - -<para ->&tdm; is part of the KDE project. The various component parts of the KDE project are broken into sections, called packages. &tdm; is part of the package called tdebase. You can get KDE source code from various Linux and BSD distribution CDs, or by download from <ulink url="http://www.kde.org" ->www.kde.org</ulink -> or its mirrors. If you have an out-of-date source code tree, you can use one of the KDE cvsup servers to bring it up-to-date whilst using minimal network bandwidth. </para> - -<para ->Before building tdebase, you must have built and installed (in this order) version 2 of the qt library and the KDE packages tdesupport (optionally) and tdelibs.</para> - -<para ->In order to build any of the above, you must already have the X Window System installed, together with a C++ compiler. If are you building from CVS you will also need the GNU configuration tools <application ->automake</application -> and <application ->autoconf</application ->.</para> - -<para ->If the last few paragraphs seemed like a foreign language, then either you have strayed into an Inappropriate Area of this handbook, or you are about to undergo a Great Learning Experience.</para> - -<para ->If you managed to satisfy all of the prerequisites, you are unlikely to have any problems with building and installing tdebase. &tdm; is installed in your <filename ->$TDEDIR/bin</filename -> folder.</para> - -<note -><para -><command ->make <option ->install</option -></command -> will <emphasis ->not</emphasis -> overwrite your previous &tdm; config files including &tdmrc;.</para -></note> +<title>Building and Installing tdm</title> + +<para>&tdm; is part of the KDE project. The various component parts of the KDE project are broken into sections, called packages. &tdm; is part of the package called tdebase. You can get KDE source code from various Linux and BSD distribution CDs, or by download from <ulink url="http://www.kde.org">www.kde.org</ulink> or its mirrors. If you have an out-of-date source code tree, you can use one of the KDE cvsup servers to bring it up-to-date whilst using minimal network bandwidth. </para> + +<para>Before building tdebase, you must have built and installed (in this order) version 2 of the qt library and the KDE packages tdesupport (optionally) and tdelibs.</para> + +<para>In order to build any of the above, you must already have the X Window System installed, together with a C++ compiler. If are you building from CVS you will also need the GNU configuration tools <application>automake</application> and <application>autoconf</application>.</para> + +<para>If the last few paragraphs seemed like a foreign language, then either you have strayed into an Inappropriate Area of this handbook, or you are about to undergo a Great Learning Experience.</para> + +<para>If you managed to satisfy all of the prerequisites, you are unlikely to have any problems with building and installing tdebase. &tdm; is installed in your <filename>$TDEDIR/bin</filename> folder.</para> + +<note><para><command>make <option>install</option></command> will <emphasis>not</emphasis> overwrite your previous &tdm; config files including &tdmrc;.</para></note> </appendix> <glossary id="glossary"> -<title ->Glossary</title> +<title>Glossary</title> <glossentry id="gloss-greeter"> -<glossterm ->greeter</glossterm> -<glossdef -><para ->The greeter is the login dialogue, &ie; the part of &tdm; which the user sees.</para> +<glossterm>greeter</glossterm> +<glossdef><para>The greeter is the login dialogue, &ie; the part of &tdm; which the user sees.</para> </glossdef> </glossentry> <glossentry> -<glossterm id="gloss-entropy" ->entropy</glossterm> -<glossdef -><para ->...</para -></glossdef> +<glossterm id="gloss-entropy">entropy</glossterm> +<glossdef><para>...</para></glossdef> </glossentry> </glossary> diff --git a/tde-i18n-en_GB/docs/tdebase/tdm/tdmrc-ref.docbook b/tde-i18n-en_GB/docs/tdebase/tdm/tdmrc-ref.docbook index a778a4b0d2f..4e122e4c1d4 100644 --- a/tde-i18n-en_GB/docs/tdebase/tdm/tdmrc-ref.docbook +++ b/tde-i18n-en_GB/docs/tdebase/tdm/tdmrc-ref.docbook @@ -1,138 +1,66 @@ <!-- generated from ../../tdm/kfrontend/config.def - DO NOT EDIT! --> <chapter id="tdm-files"> -<title ->The Files &tdm; Uses for Configuration</title> +<title>The Files &tdm; Uses for Configuration</title> -<para ->This chapter documents the files that control &tdm;'s behaviour. Some of this can be also controlled from the &kcontrol; module, but not all.</para> +<para>This chapter documents the files that control &tdm;'s behaviour. Some of this can be also controlled from the &kcontrol; module, but not all.</para> <sect1> -<title ->&tdmrc; - The &tdm; master configuration file</title> - -<para ->The basic format of the file is <quote ->INI-like</quote ->. Options are key/value pairs, placed in sections. Everything in the file is case sensitive. Syntactic errors and unrecognised key/section identifiers cause &tdm; to issue non-fatal error messages.</para> - -<para ->Lines beginning with <literal ->#</literal -> are comments; empty lines are ignored as well.</para> - -<para ->Sections are denoted by <literal ->[</literal -><replaceable ->Name of Section</replaceable -><literal ->]</literal ->. </para> - -<para ->You can configure every X-display individually.</para> -<para ->Every display has a display name, which consists of a host name (which is empty for local displays specified in the Xservers file), a colon and a display number. Additionally, a display belongs to a display class (which can be ignored in most cases).</para> - -<para ->Sections with display-specific settings have the formal syntax <literal ->[X-</literal -> <replaceable ->host</replaceable -> [ <literal ->:</literal -> <replaceable ->number</replaceable -> [ <literal ->_</literal -> <replaceable ->class</replaceable -> ] ] <literal ->-</literal -> <replaceable ->sub-section</replaceable -> <literal ->]</literal -> </para> -<para ->All sections with the same <replaceable ->sub-section</replaceable -> make up a section class.</para> - -<para ->You can use the <literal ->*</literal -> wildcard for <replaceable ->host</replaceable ->, <replaceable ->number</replaceable -> and <replaceable ->class</replaceable ->. You may omit trailing components; they are assumed to be <literal ->*</literal -> then. The host part may be a domain specification like <replaceable ->.inf.tu-dresden.de</replaceable ->.</para> - -<para ->From which section a setting is actually taken is determined by these rules:</para> +<title>&tdmrc; - The &tdm; master configuration file</title> + +<para>The basic format of the file is <quote>INI-like</quote>. Options are key/value pairs, placed in sections. Everything in the file is case sensitive. Syntactic errors and unrecognised key/section identifiers cause &tdm; to issue non-fatal error messages.</para> + +<para>Lines beginning with <literal>#</literal> are comments; empty lines are ignored as well.</para> + +<para>Sections are denoted by <literal>[</literal><replaceable>Name of Section</replaceable><literal>]</literal>. </para> + +<para>You can configure every X-display individually.</para> +<para>Every display has a display name, which consists of a host name (which is empty for local displays specified in the Xservers file), a colon and a display number. Additionally, a display belongs to a display class (which can be ignored in most cases).</para> + +<para>Sections with display-specific settings have the formal syntax <literal>[X-</literal> <replaceable>host</replaceable> [ <literal>:</literal> <replaceable>number</replaceable> [ <literal>_</literal> <replaceable>class</replaceable> ] ] <literal>-</literal> <replaceable>sub-section</replaceable> <literal>]</literal> </para> +<para>All sections with the same <replaceable>sub-section</replaceable> make up a section class.</para> + +<para>You can use the <literal>*</literal> wildcard for <replaceable>host</replaceable>, <replaceable>number</replaceable> and <replaceable>class</replaceable>. You may omit trailing components; they are assumed to be <literal>*</literal> then. The host part may be a domain specification like <replaceable>.inf.tu-dresden.de</replaceable>.</para> + +<para>From which section a setting is actually taken is determined by these rules:</para> <itemizedlist> <listitem> -<para ->An exact match takes precedence over a partial match (for the host part), which in turn takes precedence over a wildcard.</para> +<para>An exact match takes precedence over a partial match (for the host part), which in turn takes precedence over a wildcard.</para> </listitem> <listitem> -<para ->Precedence decreases from left to right for equally exact matches.</para> +<para>Precedence decreases from left to right for equally exact matches.</para> </listitem> <listitem> -<para ->Example: display name <quote ->myhost:0</quote ->, class <quote ->dpy</quote -> </para> +<para>Example: display name <quote>myhost:0</quote>, class <quote>dpy</quote> </para> <itemizedlist> <listitem> -<para ->[X-myhost:0_dpy] precedes</para> +<para>[X-myhost:0_dpy] precedes</para> </listitem> <listitem> -<para ->[X-myhost:0_*] (same as [X-myhost:0]) precedes</para> +<para>[X-myhost:0_*] (same as [X-myhost:0]) precedes</para> </listitem> <listitem> -<para ->[X-myhost:*_dpy] precedes</para> +<para>[X-myhost:*_dpy] precedes</para> </listitem> <listitem> -<para ->[X-myhost:*_*] (same as [X-myhost]) precedes</para> +<para>[X-myhost:*_*] (same as [X-myhost]) precedes</para> </listitem> <listitem> -<para ->[X-*:0_dpy] precedes</para> +<para>[X-*:0_dpy] precedes</para> </listitem> <listitem> -<para ->[X-*:0_*] (same as [X-*:0]) precedes</para> +<para>[X-*:0_*] (same as [X-*:0]) precedes</para> </listitem> <listitem> -<para ->[X-*:*_*] (same as [X-*]).</para> +<para>[X-*:*_*] (same as [X-*]).</para> </listitem> <listitem> -<para ->These sections do <emphasis ->not</emphasis -> match this display:</para> -<para ->[X-hishost], [X-myhost:0_dec], [X-*:1], [X-:*]</para> +<para>These sections do <emphasis>not</emphasis> match this display:</para> +<para>[X-hishost], [X-myhost:0_dec], [X-*:1], [X-:*]</para> </listitem> </itemizedlist> @@ -140,287 +68,143 @@ </itemizedlist> -<para ->Common sections are [X-*] (all displays), [X-:*] (all local displays) and [X-:0] (the first local display).</para> +<para>Common sections are [X-*] (all displays), [X-:*] (all local displays) and [X-:0] (the first local display).</para> -<para ->The format for all keys is <userinput -><option -><replaceable ->key</replaceable -></option -> <literal ->=</literal -> <parameter ->value</parameter -></userinput ->. Keys are only valid in the section class they are defined for. Some keys do not apply to particular displays, in which case they are ignored. </para> +<para>The format for all keys is <userinput><option><replaceable>key</replaceable></option> <literal>=</literal> <parameter>value</parameter></userinput>. Keys are only valid in the section class they are defined for. Some keys do not apply to particular displays, in which case they are ignored. </para> -<para ->If a setting is not found in any matching section, the default is used.</para> +<para>If a setting is not found in any matching section, the default is used.</para> -<note -><para ->A pristine &tdmrc; is very thoroughly commented. All comments will be lost if you change this file with the kcontrol frontend.</para -></note> +<note><para>A pristine &tdmrc; is very thoroughly commented. All comments will be lost if you change this file with the kcontrol frontend.</para></note> <sect2 id="tdmrc-general"> -<title ->The [General] section of &tdmrc;</title> +<title>The [General] section of &tdmrc;</title> -<para ->This section contains global options that do not fit into any specific section. </para> +<para>This section contains global options that do not fit into any specific section. </para> <variablelist> <varlistentry> -<term id="option-configversion" -><option ->ConfigVersion</option -></term> +<term id="option-configversion"><option>ConfigVersion</option></term> <listitem> -<para ->This option exists solely for the purpose of clean automatic upgrades. <emphasis ->Do not</emphasis -> change it, you may interfere with future upgrades and this could result in &tdm; failing to run. </para> +<para>This option exists solely for the purpose of clean automatic upgrades. <emphasis>Do not</emphasis> change it, you may interfere with future upgrades and this could result in &tdm; failing to run. </para> </listitem> </varlistentry> <varlistentry> -<term id="option-xservers" -><option ->Xservers</option -></term> +<term id="option-xservers"><option>Xservers</option></term> <listitem> -<para ->If the value starts with a slash (/), it specifies a file to read &X-Server; definitions from; otherwise, it is an &X-Server; definition by itself. See <xref linkend="tdmrc-xservers"/> for the details. </para -><para ->The default is an &X-Server; definition that is usually reasonable for the system on which &tdm; was built. </para> +<para>If the value starts with a slash (/), it specifies a file to read &X-Server; definitions from; otherwise, it is an &X-Server; definition by itself. See <xref linkend="tdmrc-xservers"/> for the details. </para><para>The default is an &X-Server; definition that is usually reasonable for the system on which &tdm; was built. </para> </listitem> </varlistentry> <varlistentry> -<term id="option-servervts" -><option ->ServerVTs</option -></term> +<term id="option-servervts"><option>ServerVTs</option></term> <listitem> -<para ->List of Virtual Terminals to allocate to &X-Server;s. For negative numbers the absolute value is used, and the <acronym ->VT</acronym -> will be allocated only if the kernel says it is free. If &tdm; exhausts this list, it will allocate free <acronym ->VT</acronym ->s greater than the absolute value of the last entry in this list. </para> -<para ->Empty by default.</para> +<para>List of Virtual Terminals to allocate to &X-Server;s. For negative numbers the absolute value is used, and the <acronym>VT</acronym> will be allocated only if the kernel says it is free. If &tdm; exhausts this list, it will allocate free <acronym>VT</acronym>s greater than the absolute value of the last entry in this list. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-pidfile" -><option ->PidFile</option -></term> +<term id="option-pidfile"><option>PidFile</option></term> <listitem> -<para ->The filename specified will be created to contain an ASCII representation of the process ID of the main &tdm; process; the PID will not be stored if the filename is empty. </para> -<para ->Empty by default.</para> +<para>The filename specified will be created to contain an ASCII representation of the process ID of the main &tdm; process; the PID will not be stored if the filename is empty. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-lockpidfile" -><option ->LockPidFile</option -></term> +<term id="option-lockpidfile"><option>LockPidFile</option></term> <listitem> -<para ->This option controls whether &tdm; uses file locking to keep multiple display managers from running onto each other. </para> -<para ->The default is <quote ->true</quote ->.</para> +<para>This option controls whether &tdm; uses file locking to keep multiple display managers from running onto each other. </para> +<para>The default is <quote>true</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-authdir" -><option ->AuthDir</option -></term> +<term id="option-authdir"><option>AuthDir</option></term> <listitem> -<para ->This names a directory under which &tdm; stores &X-Server; authorisation files while initialising the session. &tdm; expects the system to clean up this directory from stale files on reboot. </para -><para ->The authorisation file to be used for a particular display can be specified with the <option ->AuthFile</option -> option in [X-*-Core]. </para> -<para ->The default is <quote ->/var/run/xauth</quote ->.</para> +<para>This names a directory under which &tdm; stores &X-Server; authorisation files while initialising the session. &tdm; expects the system to clean up this directory from stale files on reboot. </para><para>The authorisation file to be used for a particular display can be specified with the <option>AuthFile</option> option in [X-*-Core]. </para> +<para>The default is <quote>/var/run/xauth</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-autorescan" -><option ->AutoRescan</option -></term> +<term id="option-autorescan"><option>AutoRescan</option></term> <listitem> -<para ->This boolean controls whether &tdm; automatically re-reads its configuration files if it finds them to have changed. </para> -<para ->The default is <quote ->true</quote ->.</para> +<para>This boolean controls whether &tdm; automatically re-reads its configuration files if it finds them to have changed. </para> +<para>The default is <quote>true</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-exportlist" -><option ->ExportList</option -></term> +<term id="option-exportlist"><option>ExportList</option></term> <listitem> -<para ->Additional environment variables &tdm; should pass on to all programs it runs. <envar ->LD_LIBRARY_PATH</envar -> and <envar ->XCURSOR_THEME</envar -> are good candidates; otherwise, it should not be necessary very often. </para> -<para ->Empty by default.</para> +<para>Additional environment variables &tdm; should pass on to all programs it runs. <envar>LD_LIBRARY_PATH</envar> and <envar>XCURSOR_THEME</envar> are good candidates; otherwise, it should not be necessary very often. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-randomfile" -><option ->RandomFile</option -></term> +<term id="option-randomfile"><option>RandomFile</option></term> <listitem> -<para ->If the system has no native entropy source like /dev/urandom (see <option ->RandomDevice</option ->) and no entropy daemon like EGD (see <option ->PrngdSocket</option -> and <option ->PrngdPort</option ->) is running, &tdm; will fall back to its own pseudo-random number generator that will, among other things, successively checksum parts of this file (which, obviously, should change frequently). </para -><para ->This option does not exist on Linux and various BSDs. </para> -<para ->The default is <quote ->/dev/mem</quote ->.</para> +<para>If the system has no native entropy source like /dev/urandom (see <option>RandomDevice</option>) and no entropy daemon like EGD (see <option>PrngdSocket</option> and <option>PrngdPort</option>) is running, &tdm; will fall back to its own pseudo-random number generator that will, among other things, successively checksum parts of this file (which, obviously, should change frequently). </para><para>This option does not exist on Linux and various BSDs. </para> +<para>The default is <quote>/dev/mem</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-prngdsocket" -><option ->PrngdSocket</option -></term> +<term id="option-prngdsocket"><option>PrngdSocket</option></term> <listitem> -<para ->If the system has no native entropy source like /dev/urandom (see <option ->RandomDevice</option ->), read random data from a Pseudo-Random Number Generator Daemon, like EGD (http://egd.sourceforge.net) via this UNIX domain socket. </para -><para ->This option does not exist on Linux and various BSDs. </para> -<para ->Empty by default.</para> +<para>If the system has no native entropy source like /dev/urandom (see <option>RandomDevice</option>), read random data from a Pseudo-Random Number Generator Daemon, like EGD (http://egd.sourceforge.net) via this UNIX domain socket. </para><para>This option does not exist on Linux and various BSDs. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-prngdport" -><option ->PrngdPort</option -></term> +<term id="option-prngdport"><option>PrngdPort</option></term> <listitem> -<para ->Same as <option ->PrngdSocket</option ->, only use a TCP socket on localhost. </para> +<para>Same as <option>PrngdSocket</option>, only use a TCP socket on localhost. </para> </listitem> </varlistentry> <varlistentry> -<term id="option-randomdevice" -><option ->RandomDevice</option -></term> +<term id="option-randomdevice"><option>RandomDevice</option></term> <listitem> -<para ->The path to a character device which TDM should read random data from. Empty means to use the system's preferred entropy device if there is one. </para -><para ->This option does not exist on OpenBSD, as it uses the arc4_random function instead. </para> -<para ->Empty by default.</para> +<para>The path to a character device which TDM should read random data from. Empty means to use the system's preferred entropy device if there is one. </para><para>This option does not exist on OpenBSD, as it uses the arc4_random function instead. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-fifodir" -><option ->FifoDir</option -></term> +<term id="option-fifodir"><option>FifoDir</option></term> <listitem> -<para ->The directory in which the command <acronym ->FiFo</acronym ->s should be created; make it empty to disable them. </para> -<para ->The default is <quote ->/var/run/xdmctl</quote ->.</para> +<para>The directory in which the command <acronym>FiFo</acronym>s should be created; make it empty to disable them. </para> +<para>The default is <quote>/var/run/xdmctl</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-fifogroup" -><option ->FifoGroup</option -></term> +<term id="option-fifogroup"><option>FifoGroup</option></term> <listitem> -<para ->The group to which the global command <acronym ->FiFo</acronym -> should belong; can be either a name or a numerical ID. </para> +<para>The group to which the global command <acronym>FiFo</acronym> should belong; can be either a name or a numerical ID. </para> </listitem> </varlistentry> <varlistentry> -<term id="option-datadir" -><option ->DataDir</option -></term> +<term id="option-datadir"><option>DataDir</option></term> <listitem> -<para ->The directory in which &tdm; should store persistent working data; such data is, for example, the previous user that logged in on a particular display. </para> -<para ->The default is <quote ->/var/lib/tdm</quote ->.</para> +<para>The directory in which &tdm; should store persistent working data; such data is, for example, the previous user that logged in on a particular display. </para> +<para>The default is <quote>/var/lib/tdm</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-dmrcdir" -><option ->DmrcDir</option -></term> +<term id="option-dmrcdir"><option>DmrcDir</option></term> <listitem> -<para ->The directory in which &tdm; should store users' <filename ->.dmrc</filename -> files. This is only needed if the home directories are not readable before actually logging in (like with AFS). </para> -<para ->Empty by default.</para> +<para>The directory in which &tdm; should store users' <filename>.dmrc</filename> files. This is only needed if the home directories are not readable before actually logging in (like with AFS). </para> +<para>Empty by default.</para> </listitem> </varlistentry> @@ -429,133 +213,73 @@ <sect2 id="tdmrc-xdmcp"> -<title ->The [Xdmcp] section of &tdmrc;</title> +<title>The [Xdmcp] section of &tdmrc;</title> -<para ->This section contains options that control &tdm;'s handling of &XDMCP; requests. </para> +<para>This section contains options that control &tdm;'s handling of &XDMCP; requests. </para> <variablelist> <varlistentry> -<term id="option-enable" -><option ->Enable</option -></term> +<term id="option-enable"><option>Enable</option></term> <listitem> -<para ->Whether &tdm; should listen to incoming &XDMCP; requests. </para> -<para ->The default is <quote ->true</quote ->.</para> +<para>Whether &tdm; should listen to incoming &XDMCP; requests. </para> +<para>The default is <quote>true</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-port" -><option ->Port</option -></term> +<term id="option-port"><option>Port</option></term> <listitem> -<para ->This indicates the UDP port number which &tdm; uses to listen for incoming &XDMCP; requests. Unless you need to debug the system, leave this with its default value. </para> -<para ->The default is <quote ->177</quote ->.</para> +<para>This indicates the UDP port number which &tdm; uses to listen for incoming &XDMCP; requests. Unless you need to debug the system, leave this with its default value. </para> +<para>The default is <quote>177</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-keyfile" -><option ->KeyFile</option -></term> +<term id="option-keyfile"><option>KeyFile</option></term> <listitem> -<para ->XDM-AUTHENTICATION-1 style &XDMCP; authentication requires a private key to be shared between &tdm; and the terminal. This option specifies the file containing those values. Each entry in the file consists of a display name and the shared key. </para> -<para ->Empty by default.</para> +<para>XDM-AUTHENTICATION-1 style &XDMCP; authentication requires a private key to be shared between &tdm; and the terminal. This option specifies the file containing those values. Each entry in the file consists of a display name and the shared key. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-xaccess" -><option ->Xaccess</option -></term> +<term id="option-xaccess"><option>Xaccess</option></term> <listitem> -<para ->To prevent unauthorised &XDMCP; service and to allow forwarding of &XDMCP; IndirectQuery requests, this file contains a database of hostnames which are either allowed direct access to this machine, or have a list of hosts to which queries should be forwarded to. The format of this file is described in <xref linkend="tdmrc-xaccess"/>. </para> -<para ->The default is <quote ->${<envar ->kde_confdir</envar ->}/tdm/Xaccess</quote ->.</para> +<para>To prevent unauthorised &XDMCP; service and to allow forwarding of &XDMCP; IndirectQuery requests, this file contains a database of hostnames which are either allowed direct access to this machine, or have a list of hosts to which queries should be forwarded to. The format of this file is described in <xref linkend="tdmrc-xaccess"/>. </para> +<para>The default is <quote>${<envar>kde_confdir</envar>}/tdm/Xaccess</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-choicetimeout" -><option ->ChoiceTimeout</option -></term> +<term id="option-choicetimeout"><option>ChoiceTimeout</option></term> <listitem> -<para ->Number of seconds to wait for the display to respond after the user has selected a host from the chooser. If the display sends an &XDMCP; IndirectQuery within this time, the request is forwarded to the chosen host; otherwise, it is assumed to be from a new session and the chooser is offered again. </para> -<para ->The default is <quote ->15</quote ->.</para> +<para>Number of seconds to wait for the display to respond after the user has selected a host from the chooser. If the display sends an &XDMCP; IndirectQuery within this time, the request is forwarded to the chosen host; otherwise, it is assumed to be from a new session and the chooser is offered again. </para> +<para>The default is <quote>15</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-removedomainname" -><option ->RemoveDomainname</option -></term> +<term id="option-removedomainname"><option>RemoveDomainname</option></term> <listitem> -<para ->When computing the display name for &XDMCP; clients, the name resolver will typically create a fully qualified host name for the terminal. As this is sometimes confusing, &tdm; will remove the domain name portion of the host name if it is the same as the domain name of the local host when this option is enabled. </para> -<para ->The default is <quote ->true</quote ->.</para> +<para>When computing the display name for &XDMCP; clients, the name resolver will typically create a fully qualified host name for the terminal. As this is sometimes confusing, &tdm; will remove the domain name portion of the host name if it is the same as the domain name of the local host when this option is enabled. </para> +<para>The default is <quote>true</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-sourceaddress" -><option ->SourceAddress</option -></term> +<term id="option-sourceaddress"><option>SourceAddress</option></term> <listitem> -<para ->Use the numeric IP address of the incoming connection on multihomed hosts instead of the host name. This is to avoid trying to connect on the wrong interface which might be down at this time. </para> -<para ->The default is <quote ->false</quote ->.</para> +<para>Use the numeric IP address of the incoming connection on multihomed hosts instead of the host name. This is to avoid trying to connect on the wrong interface which might be down at this time. </para> +<para>The default is <quote>false</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-willing" -><option ->Willing</option -></term> +<term id="option-willing"><option>Willing</option></term> <listitem> -<para ->This specifies a program which is run (as <systemitem class="username" ->root</systemitem ->) when an &XDMCP; DirectQuery or BroadcastQuery is received and this host is configured to offer &XDMCP; display management. The output of this program may be displayed in a chooser window. If no program is specified, the string <quote ->Willing to manage</quote -> is sent. </para> -<para ->Empty by default.</para> +<para>This specifies a program which is run (as <systemitem class="username">root</systemitem>) when an &XDMCP; DirectQuery or BroadcastQuery is received and this host is configured to offer &XDMCP; display management. The output of this program may be displayed in a chooser window. If no program is specified, the string <quote>Willing to manage</quote> is sent. </para> +<para>Empty by default.</para> </listitem> </varlistentry> @@ -564,138 +288,63 @@ <sect2 id="tdmrc-shutdown"> -<title ->The [Shutdown] section of &tdmrc;</title> +<title>The [Shutdown] section of &tdmrc;</title> -<para ->This section contains global options concerning system shutdown. </para> +<para>This section contains global options concerning system shutdown. </para> <variablelist> <varlistentry> -<term id="option-haltcmd" -><option ->HaltCmd</option -></term> +<term id="option-haltcmd"><option>HaltCmd</option></term> <listitem> -<para ->The command to run to halt/poweroff the system. </para -><para ->The default is something reasonable for the system on which &tdm; was built, like <command ->/sbin/shutdown <option ->-h</option -> <parameter ->now</parameter -></command ->. </para> +<para>The command to run to halt/poweroff the system. </para><para>The default is something reasonable for the system on which &tdm; was built, like <command>/sbin/shutdown <option>-h</option> <parameter>now</parameter></command>. </para> </listitem> </varlistentry> <varlistentry> -<term id="option-rebootcmd" -><option ->RebootCmd</option -></term> +<term id="option-rebootcmd"><option>RebootCmd</option></term> <listitem> -<para ->The command to run to reboot the system. </para -><para ->The default is something reasonable for the system &tdm; on which was built, like <command ->/sbin/shutdown <option ->-r</option -> <parameter ->now</parameter -></command ->. </para> +<para>The command to run to reboot the system. </para><para>The default is something reasonable for the system &tdm; on which was built, like <command>/sbin/shutdown <option>-r</option> <parameter>now</parameter></command>. </para> </listitem> </varlistentry> <varlistentry> -<term id="option-allowfifo" -><option ->AllowFifo</option -></term> +<term id="option-allowfifo"><option>AllowFifo</option></term> <listitem> -<para ->Whether it is allowed to shut down the system via the global command <acronym ->FiFo</acronym ->. </para> -<para ->The default is <quote ->false</quote ->.</para> +<para>Whether it is allowed to shut down the system via the global command <acronym>FiFo</acronym>. </para> +<para>The default is <quote>false</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-allowfifonow" -><option ->AllowFifoNow</option -></term> +<term id="option-allowfifonow"><option>AllowFifoNow</option></term> <listitem> -<para ->Whether it is allowed to abort active sessions when shutting down the system via the global command <acronym ->FiFo</acronym ->. </para -><para ->This will have no effect unless <option ->AllowFifo</option -> is enabled. </para> -<para ->The default is <quote ->true</quote ->.</para> +<para>Whether it is allowed to abort active sessions when shutting down the system via the global command <acronym>FiFo</acronym>. </para><para>This will have no effect unless <option>AllowFifo</option> is enabled. </para> +<para>The default is <quote>true</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-uselilo" -><option ->UseLilo</option -></term> +<term id="option-uselilo"><option>UseLilo</option></term> <listitem> -<para ->Instructs &tdm; to offer LiLo boot options in the shutdown dialogue. </para -><para ->Only available on Linux i386 & x86-64. </para> -<para ->The default is <quote ->false</quote ->.</para> +<para>Instructs &tdm; to offer LiLo boot options in the shutdown dialogue. </para><para>Only available on Linux i386 & x86-64. </para> +<para>The default is <quote>false</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-lilocmd" -><option ->LiloCmd</option -></term> +<term id="option-lilocmd"><option>LiloCmd</option></term> <listitem> -<para ->The location of the LiLo binary. </para -><para ->Only available on Linux i386 & x86-64. </para> -<para ->The default is <quote ->/sbin/lilo</quote ->.</para> +<para>The location of the LiLo binary. </para><para>Only available on Linux i386 & x86-64. </para> +<para>The default is <quote>/sbin/lilo</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-lilomap" -><option ->LiloMap</option -></term> +<term id="option-lilomap"><option>LiloMap</option></term> <listitem> -<para ->The location of the map file LiLo should use. </para -><para ->Only available on Linux i386 & x86-64. </para> -<para ->The default is <quote ->/boot/map</quote ->.</para> +<para>The location of the map file LiLo should use. </para><para>Only available on Linux i386 & x86-64. </para> +<para>The default is <quote>/boot/map</quote>.</para> </listitem> </varlistentry> @@ -704,859 +353,383 @@ <sect2 id="tdmrc-core"> -<title ->The [X-*-Core] section class of &tdmrc;</title> +<title>The [X-*-Core] section class of &tdmrc;</title> -<para ->This section class contains options concerning the configuration of the &tdm; backend (core). </para> +<para>This section class contains options concerning the configuration of the &tdm; backend (core). </para> <variablelist> <varlistentry> -<term id="option-opendelay" -><option ->OpenDelay</option -></term> +<term id="option-opendelay"><option>OpenDelay</option></term> <listitem> -<para ->See <option ->OpenRepeat</option ->. </para> -<para ->The default is <quote ->15</quote ->.</para> +<para>See <option>OpenRepeat</option>. </para> +<para>The default is <quote>15</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-opentimeout" -><option ->OpenTimeout</option -></term> +<term id="option-opentimeout"><option>OpenTimeout</option></term> <listitem> -<para ->See <option ->OpenRepeat</option ->. </para> -<para ->The default is <quote ->120</quote ->.</para> +<para>See <option>OpenRepeat</option>. </para> +<para>The default is <quote>120</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-openrepeat" -><option ->OpenRepeat</option -></term> +<term id="option-openrepeat"><option>OpenRepeat</option></term> <listitem> -<para ->These options control the behaviour of &tdm; when attempting to open a connection to an &X-Server;. <option ->OpenDelay</option -> is the length of the pause (in seconds) between successive attempts, <option ->OpenRepeat</option -> is the number of attempts to make and <option ->OpenTimeout</option -> is the amount of time to spend on a connection attempt. After <option ->OpenRepeat</option -> attempts have been made, or if <option ->OpenTimeout</option -> seconds elapse in any particular connection attempt, the start attempt is considered failed. </para> -<para ->The default is <quote ->5</quote ->.</para> +<para>These options control the behaviour of &tdm; when attempting to open a connection to an &X-Server;. <option>OpenDelay</option> is the length of the pause (in seconds) between successive attempts, <option>OpenRepeat</option> is the number of attempts to make and <option>OpenTimeout</option> is the amount of time to spend on a connection attempt. After <option>OpenRepeat</option> attempts have been made, or if <option>OpenTimeout</option> seconds elapse in any particular connection attempt, the start attempt is considered failed. </para> +<para>The default is <quote>5</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-startattempts" -><option ->StartAttempts</option -></term> +<term id="option-startattempts"><option>StartAttempts</option></term> <listitem> -<para ->How many times &tdm; should attempt to start a <literal ->foreign</literal -> display listed in the <filename ->Xservers</filename -> file before giving up and disabling it. Local displays are attempted only once, and &XDMCP; displays are retried indefinitely by the client (unless the option <option ->-once</option -> was given to the &X-Server;). </para> -<para ->The default is <quote ->4</quote ->.</para> +<para>How many times &tdm; should attempt to start a <literal>foreign</literal> display listed in the <filename>Xservers</filename> file before giving up and disabling it. Local displays are attempted only once, and &XDMCP; displays are retried indefinitely by the client (unless the option <option>-once</option> was given to the &X-Server;). </para> +<para>The default is <quote>4</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-serverattempts" -><option ->ServerAttempts</option -></term> +<term id="option-serverattempts"><option>ServerAttempts</option></term> <listitem> -<para ->How many times &tdm; should attempt to start up a local &X-Server;. Starting up includes executing it and waiting for it to come up. </para> -<para ->The default is <quote ->1</quote ->.</para> +<para>How many times &tdm; should attempt to start up a local &X-Server;. Starting up includes executing it and waiting for it to come up. </para> +<para>The default is <quote>1</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-servertimeout" -><option ->ServerTimeout</option -></term> +<term id="option-servertimeout"><option>ServerTimeout</option></term> <listitem> -<para ->How many seconds &tdm; should wait for a local &X-Server; to come up. </para> -<para ->The default is <quote ->15</quote ->.</para> +<para>How many seconds &tdm; should wait for a local &X-Server; to come up. </para> +<para>The default is <quote>15</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-pinginterval" -><option ->PingInterval</option -></term> +<term id="option-pinginterval"><option>PingInterval</option></term> <listitem> -<para ->See <option ->PingTimeout</option ->. </para> -<para ->The default is <quote ->5</quote ->.</para> +<para>See <option>PingTimeout</option>. </para> +<para>The default is <quote>5</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-pingtimeout" -><option ->PingTimeout</option -></term> +<term id="option-pingtimeout"><option>PingTimeout</option></term> <listitem> -<para ->To discover when <emphasis ->remote</emphasis -> displays disappear, &tdm; regularly pings them. <option ->PingInterval</option -> specifies the time (in minutes) between the pings and <option ->PingTimeout</option -> specifies the maximum amount of time (in minutes) to wait for the terminal to respond to the request. If the terminal does not respond, the session is declared dead and terminated. </para -><para ->If you frequently use X terminals which can become isolated from the managing host, you may wish to increase the timeout. The only worry is that sessions will continue to exist after the terminal has been accidentally disabled. </para> -<para ->The default is <quote ->5</quote ->.</para> +<para>To discover when <emphasis>remote</emphasis> displays disappear, &tdm; regularly pings them. <option>PingInterval</option> specifies the time (in minutes) between the pings and <option>PingTimeout</option> specifies the maximum amount of time (in minutes) to wait for the terminal to respond to the request. If the terminal does not respond, the session is declared dead and terminated. </para><para>If you frequently use X terminals which can become isolated from the managing host, you may wish to increase the timeout. The only worry is that sessions will continue to exist after the terminal has been accidentally disabled. </para> +<para>The default is <quote>5</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-terminateserver" -><option ->TerminateServer</option -></term> +<term id="option-terminateserver"><option>TerminateServer</option></term> <listitem> -<para ->Whether &tdm; should restart the local &X-Server; after session exit instead of resetting it. Use this if the &X-Server; leaks memory or crashes the system on reset attempts. </para> -<para ->The default is <quote ->false</quote ->.</para> +<para>Whether &tdm; should restart the local &X-Server; after session exit instead of resetting it. Use this if the &X-Server; leaks memory or crashes the system on reset attempts. </para> +<para>The default is <quote>false</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-resetsignal" -><option ->ResetSignal</option -></term> +<term id="option-resetsignal"><option>ResetSignal</option></term> <listitem> -<para ->The signal number to use to reset the local &X-Server;. </para> -<para ->The default is <quote ->1 (SIGHUP)</quote ->.</para> +<para>The signal number to use to reset the local &X-Server;. </para> +<para>The default is <quote>1 (SIGHUP)</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-termsignal" -><option ->TermSignal</option -></term> +<term id="option-termsignal"><option>TermSignal</option></term> <listitem> -<para ->The signal number to use to terminate the local &X-Server;. </para> -<para ->The default is <quote ->15 (SIGTERM)</quote ->.</para> +<para>The signal number to use to terminate the local &X-Server;. </para> +<para>The default is <quote>15 (SIGTERM)</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-authorize" -><option ->Authorise</option -></term> +<term id="option-authorize"><option>Authorise</option></term> <listitem> -<para ->Controls whether &tdm; generates and uses authorisation for <emphasis ->local</emphasis -> &X-Server; connections. For &XDMCP; displays the authorisation requested by the display is used; foreign non-&XDMCP; displays do not support authorisation at all. </para> -<para ->The default is <quote ->true</quote ->.</para> +<para>Controls whether &tdm; generates and uses authorisation for <emphasis>local</emphasis> &X-Server; connections. For &XDMCP; displays the authorisation requested by the display is used; foreign non-&XDMCP; displays do not support authorisation at all. </para> +<para>The default is <quote>true</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-authnames" -><option ->AuthNames</option -></term> +<term id="option-authnames"><option>AuthNames</option></term> <listitem> -<para ->If <option ->Authorize</option -> is true, use the authorisation mechanisms listed herein. The MIT-MAGIC-COOKIE-1 authorisation is always available; XDM-AUTHORIZATION-1, SUN-DES-1 and MIT-KERBEROS-5 might be available as well, depending on the build configuration. </para> -<para ->The default is <quote ->DEF_AUTH_NAME</quote ->.</para> +<para>If <option>Authorize</option> is true, use the authorisation mechanisms listed herein. The MIT-MAGIC-COOKIE-1 authorisation is always available; XDM-AUTHORIZATION-1, SUN-DES-1 and MIT-KERBEROS-5 might be available as well, depending on the build configuration. </para> +<para>The default is <quote>DEF_AUTH_NAME</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-resetforauth" -><option ->ResetForAuth</option -></term> +<term id="option-resetforauth"><option>ResetForAuth</option></term> <listitem> -<para ->Some <emphasis ->old</emphasis -> &X-Server;s re-read the authorisation file at &X-Server; reset time, instead of when checking the initial connection. As &tdm; generates the authorisation information just before connecting to the display, an old &X-Server; would not get up-to-date authorisation information. This option causes &tdm; to send SIGHUP to the &X-Server; after setting up the file, causing an additional &X-Server; reset to occur, during which time the new authorisation information will be read. </para> -<para ->The default is <quote ->false</quote ->.</para> +<para>Some <emphasis>old</emphasis> &X-Server;s re-read the authorisation file at &X-Server; reset time, instead of when checking the initial connection. As &tdm; generates the authorisation information just before connecting to the display, an old &X-Server; would not get up-to-date authorisation information. This option causes &tdm; to send SIGHUP to the &X-Server; after setting up the file, causing an additional &X-Server; reset to occur, during which time the new authorisation information will be read. </para> +<para>The default is <quote>false</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-authfile" -><option ->AuthFile</option -></term> +<term id="option-authfile"><option>AuthFile</option></term> <listitem> -<para ->This file is used to communicate the authorisation data from &tdm; to the &X-Server;, using the <option ->-auth</option -> &X-Server; command line option. It should be kept in a directory which is not world-writable as it could easily be removed, disabling the authorisation mechanism in the &X-Server;. If not specified, a random name is generated from <option ->AuthDir</option -> and the name of the display. </para> -<para ->Empty by default.</para> +<para>This file is used to communicate the authorisation data from &tdm; to the &X-Server;, using the <option>-auth</option> &X-Server; command line option. It should be kept in a directory which is not world-writable as it could easily be removed, disabling the authorisation mechanism in the &X-Server;. If not specified, a random name is generated from <option>AuthDir</option> and the name of the display. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-resources" -><option ->Resources</option -></term> +<term id="option-resources"><option>Resources</option></term> <listitem> -<para ->This option specifies the name of the file to be loaded by <command ->xrdb</command -> as the resource database onto the root window of screen 0 of the display. KDE programs generally do not use X-resources, so this option is only needed if the <option ->Setup</option -> program needs some X-resources. </para> -<para ->Empty by default.</para> +<para>This option specifies the name of the file to be loaded by <command>xrdb</command> as the resource database onto the root window of screen 0 of the display. KDE programs generally do not use X-resources, so this option is only needed if the <option>Setup</option> program needs some X-resources. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-xrdb" -><option ->Xrdb</option -></term> +<term id="option-xrdb"><option>Xrdb</option></term> <listitem> -<para ->The <command ->xrdb</command -> program to use to read the X-resources file specified in <option ->Recources</option ->. </para> -<para ->The default is <quote ->${<envar ->x_bindir</envar ->}/xrdb</quote ->.</para> +<para>The <command>xrdb</command> program to use to read the X-resources file specified in <option>Recources</option>. </para> +<para>The default is <quote>${<envar>x_bindir</envar>}/xrdb</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-setup" -><option ->Setup</option -></term> +<term id="option-setup"><option>Setup</option></term> <listitem> -<para ->This specifies a program which is run (as <systemitem class="username" ->root</systemitem ->) before offering the greeter window. This may be used to change the appearance of the screen around the greeter window or to put up other windows (e.g., you may want to run <command ->xconsole</command -> here). The conventional name for a file used here is <command ->Xsetup</command ->. See <xref linkend="tdmrc-xsetup"/>. </para> -<para ->Empty by default.</para> +<para>This specifies a program which is run (as <systemitem class="username">root</systemitem>) before offering the greeter window. This may be used to change the appearance of the screen around the greeter window or to put up other windows (e.g., you may want to run <command>xconsole</command> here). The conventional name for a file used here is <command>Xsetup</command>. See <xref linkend="tdmrc-xsetup"/>. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-startup" -><option ->Startup</option -></term> +<term id="option-startup"><option>Startup</option></term> <listitem> -<para ->This specifies a program which is run (as <systemitem class="username" ->root</systemitem ->) after the user authentication process succeeds. The conventional name for a file used here is <command ->Xstartup</command ->. See <xref linkend="tdmrc-xstartup"/>. </para> -<para ->Empty by default.</para> +<para>This specifies a program which is run (as <systemitem class="username">root</systemitem>) after the user authentication process succeeds. The conventional name for a file used here is <command>Xstartup</command>. See <xref linkend="tdmrc-xstartup"/>. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-reset" -><option ->Reset</option -></term> +<term id="option-reset"><option>Reset</option></term> <listitem> -<para ->This specifies a program which is run (as <systemitem class="username" ->root</systemitem ->) after the session terminates. The conventional name for a file used here is <command ->Xreset</command ->. See <xref linkend="tdmrc-xreset"/>. </para> -<para ->Empty by default.</para> +<para>This specifies a program which is run (as <systemitem class="username">root</systemitem>) after the session terminates. The conventional name for a file used here is <command>Xreset</command>. See <xref linkend="tdmrc-xreset"/>. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-session" -><option ->Session</option -></term> +<term id="option-session"><option>Session</option></term> <listitem> -<para ->This specifies the session program to be executed (as the user owning the session). The conventional name for a file used here is <command ->Xsession</command ->. See <xref linkend="tdmrc-xsession"/>. </para> -<para ->The default is <quote ->${<envar ->x_bindir</envar ->}/xterm -ls -T</quote ->.</para> +<para>This specifies the session program to be executed (as the user owning the session). The conventional name for a file used here is <command>Xsession</command>. See <xref linkend="tdmrc-xsession"/>. </para> +<para>The default is <quote>${<envar>x_bindir</envar>}/xterm -ls -T</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-failsafeclient" -><option ->FailsafeClient</option -></term> +<term id="option-failsafeclient"><option>FailsafeClient</option></term> <listitem> -<para ->If the <option ->Session</option -> program fails to execute, &tdm; will fall back to this program. This program is executed with no arguments, but executes using the same environment variables as the session would have had (see <xref linkend="tdmrc-xsession"/>). </para> -<para ->The default is <quote ->${<envar ->x_bindir</envar ->}/xterm</quote ->.</para> +<para>If the <option>Session</option> program fails to execute, &tdm; will fall back to this program. This program is executed with no arguments, but executes using the same environment variables as the session would have had (see <xref linkend="tdmrc-xsession"/>). </para> +<para>The default is <quote>${<envar>x_bindir</envar>}/xterm</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-userpath" -><option ->UserPath</option -></term> +<term id="option-userpath"><option>UserPath</option></term> <listitem> -<para ->The <envar ->PATH</envar -> environment variable for non-<systemitem class="username" ->root</systemitem -> <option ->Session</option ->s. </para -><para ->The default depends on the system &tdm; was built on. </para> +<para>The <envar>PATH</envar> environment variable for non-<systemitem class="username">root</systemitem> <option>Session</option>s. </para><para>The default depends on the system &tdm; was built on. </para> </listitem> </varlistentry> <varlistentry> -<term id="option-systempath" -><option ->SystemPath</option -></term> +<term id="option-systempath"><option>SystemPath</option></term> <listitem> -<para ->The <envar ->PATH</envar -> environment variable for all programs but non-<systemitem class="username" ->root</systemitem -> <option ->Session</option ->s. Note that it is good practice not to include <literal ->.</literal -> (the current directory) into this entry. </para -><para ->The default depends on the system &tdm; was built on. </para> +<para>The <envar>PATH</envar> environment variable for all programs but non-<systemitem class="username">root</systemitem> <option>Session</option>s. Note that it is good practice not to include <literal>.</literal> (the current directory) into this entry. </para><para>The default depends on the system &tdm; was built on. </para> </listitem> </varlistentry> <varlistentry> -<term id="option-systemshell" -><option ->SystemShell</option -></term> +<term id="option-systemshell"><option>SystemShell</option></term> <listitem> -<para ->The <envar ->SHELL</envar -> environment variable for all programs but the <option ->Session</option ->. </para> -<para ->The default is <quote ->/bin/sh</quote ->.</para> +<para>The <envar>SHELL</envar> environment variable for all programs but the <option>Session</option>. </para> +<para>The default is <quote>/bin/sh</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-userauthdir" -><option ->UserAuthDir</option -></term> +<term id="option-userauthdir"><option>UserAuthDir</option></term> <listitem> -<para ->When &tdm; is unable to write to the usual user authorisation file ($<envar ->HOME</envar ->/.Xauthority), it creates a unique file name in this directory and points the environment variable <envar ->XAUTHORITY</envar -> at the created file. </para> -<para ->The default is <quote ->/tmp</quote ->.</para> +<para>When &tdm; is unable to write to the usual user authorisation file ($<envar>HOME</envar>/.Xauthority), it creates a unique file name in this directory and points the environment variable <envar>XAUTHORITY</envar> at the created file. </para> +<para>The default is <quote>/tmp</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-autorelogin" -><option ->AutoReLogin</option -></term> +<term id="option-autorelogin"><option>AutoReLogin</option></term> <listitem> -<para ->If enabled, &tdm; will automatically restart a session after an &X-Server; crash (or if it is killed by Alt-Ctrl-BackSpace). Note that enabling this feature opens a security hole: a secured display lock can be circumvented (unless &kde;'s built-in screen locker is used). </para> -<para ->The default is <quote ->false</quote ->.</para> +<para>If enabled, &tdm; will automatically restart a session after an &X-Server; crash (or if it is killed by Alt-Ctrl-BackSpace). Note that enabling this feature opens a security hole: a secured display lock can be circumvented (unless &kde;'s built-in screen locker is used). </para> +<para>The default is <quote>false</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-allowrootlogin" -><option ->AllowRootLogin</option -></term> +<term id="option-allowrootlogin"><option>AllowRootLogin</option></term> <listitem> -<para ->If disabled, do not allow <systemitem class="username" ->root</systemitem -> (and any other user with UID = 0) to log in directly. </para> -<para ->The default is <quote ->true</quote ->.</para> +<para>If disabled, do not allow <systemitem class="username">root</systemitem> (and any other user with UID = 0) to log in directly. </para> +<para>The default is <quote>true</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-allownullpasswd" -><option ->AllowNullPasswd</option -></term> +<term id="option-allownullpasswd"><option>AllowNullPasswd</option></term> <listitem> -<para ->If disabled, only users that have passwords assigned can log in. </para> -<para ->The default is <quote ->true</quote ->.</para> +<para>If disabled, only users that have passwords assigned can log in. </para> +<para>The default is <quote>true</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-allowshutdown" -><option ->AllowShutdown</option -></term> +<term id="option-allowshutdown"><option>AllowShutdown</option></term> <listitem> -<para ->Who is allowed to shut down the system. This applies both to the greeter and to the command <acronym ->FiFo</acronym ->. </para> +<para>Who is allowed to shut down the system. This applies both to the greeter and to the command <acronym>FiFo</acronym>. </para> <variablelist> <varlistentry> -<term -><parameter ->None</parameter -></term> -<listitem -><para ->no <guilabel ->Shutdown...</guilabel -> menu entry is shown at all</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->Root</parameter -></term> -<listitem -><para ->the <systemitem class="username" ->root</systemitem -> password must be entered to shut down</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->All</parameter -></term> -<listitem -><para ->everybody can shut down the machine</para -></listitem> +<term><parameter>None</parameter></term> +<listitem><para>no <guilabel>Shutdown...</guilabel> menu entry is shown at all</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>Root</parameter></term> +<listitem><para>the <systemitem class="username">root</systemitem> password must be entered to shut down</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>All</parameter></term> +<listitem><para>everybody can shut down the machine</para></listitem> </varlistentry> </variablelist> -<para ->The default is <quote ->All</quote ->.</para> +<para>The default is <quote>All</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-allowsdforcenow" -><option ->AllowSdForceNow</option -></term> +<term id="option-allowsdforcenow"><option>AllowSdForceNow</option></term> <listitem> -<para ->Who is allowed to abort active sessions when shutting down. </para> +<para>Who is allowed to abort active sessions when shutting down. </para> <variablelist> <varlistentry> -<term -><parameter ->None</parameter -></term> -<listitem -><para ->no forced shutdown is allowed at all</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->Root</parameter -></term> -<listitem -><para ->the <systemitem class="username" ->root</systemitem -> password must be entered to shut down forcibly</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->All</parameter -></term> -<listitem -><para ->everybody can shut down the machine forcibly</para -></listitem> +<term><parameter>None</parameter></term> +<listitem><para>no forced shutdown is allowed at all</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>Root</parameter></term> +<listitem><para>the <systemitem class="username">root</systemitem> password must be entered to shut down forcibly</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>All</parameter></term> +<listitem><para>everybody can shut down the machine forcibly</para></listitem> </varlistentry> </variablelist> -<para ->The default is <quote ->All</quote ->.</para> +<para>The default is <quote>All</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-defaultsdmode" -><option ->DefaultSdMode</option -></term> +<term id="option-defaultsdmode"><option>DefaultSdMode</option></term> <listitem> -<para ->The default choice for the shutdown condition/timing. </para> +<para>The default choice for the shutdown condition/timing. </para> <variablelist> <varlistentry> -<term -><parameter ->Schedule</parameter -></term> -<listitem -><para ->shut down after all active sessions exit (possibly at once)</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->TryNow</parameter -></term> -<listitem -><para ->shut down, if no active sessions are open; otherwise, do nothing</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->ForceNow</parameter -></term> -<listitem -><para ->shut down unconditionally</para -></listitem> +<term><parameter>Schedule</parameter></term> +<listitem><para>shut down after all active sessions exit (possibly at once)</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>TryNow</parameter></term> +<listitem><para>shut down, if no active sessions are open; otherwise, do nothing</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>ForceNow</parameter></term> +<listitem><para>shut down unconditionally</para></listitem> </varlistentry> </variablelist> -<para ->The default is <quote ->Schedule</quote ->.</para> +<para>The default is <quote>Schedule</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-scheduledsd" -><option ->ScheduledSd</option -></term> +<term id="option-scheduledsd"><option>ScheduledSd</option></term> <listitem> -<para ->How to offer shutdown scheduling options: </para> +<para>How to offer shutdown scheduling options: </para> <variablelist> <varlistentry> -<term -><parameter ->Never</parameter -></term> -<listitem -><para ->not at all</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->Optional</parameter -></term> -<listitem -><para ->as a button in the simple shutdown dialogues</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->Always</parameter -></term> -<listitem -><para ->instead of the simple shutdown dialogues</para -></listitem> +<term><parameter>Never</parameter></term> +<listitem><para>not at all</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>Optional</parameter></term> +<listitem><para>as a button in the simple shutdown dialogues</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>Always</parameter></term> +<listitem><para>instead of the simple shutdown dialogues</para></listitem> </varlistentry> </variablelist> -<para ->The default is <quote ->Never</quote ->.</para> +<para>The default is <quote>Never</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-nopassenable" -><option ->NoPassEnable</option -></term> +<term id="option-nopassenable"><option>NoPassEnable</option></term> <listitem> -<para ->Enable password-less logins on this display. <emphasis ->Use with extreme care!</emphasis -> </para> -<para ->The default is <quote ->false</quote ->.</para> +<para>Enable password-less logins on this display. <emphasis>Use with extreme care!</emphasis> </para> +<para>The default is <quote>false</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-nopassusers" -><option ->NoPassUsers</option -></term> +<term id="option-nopassusers"><option>NoPassUsers</option></term> <listitem> -<para ->The users that do not need to provide a password to log in. Items which are prefixed with <literal ->@</literal -> represent all users in the user group named by that item. <literal ->*</literal -> means all users but <systemitem class="username" ->root</systemitem -> (and any other user with UID = 0). <emphasis ->Never</emphasis -> list <systemitem class="username" ->root</systemitem ->. </para> -<para ->Empty by default.</para> +<para>The users that do not need to provide a password to log in. Items which are prefixed with <literal>@</literal> represent all users in the user group named by that item. <literal>*</literal> means all users but <systemitem class="username">root</systemitem> (and any other user with UID = 0). <emphasis>Never</emphasis> list <systemitem class="username">root</systemitem>. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-autologinenable" -><option ->AutoLoginEnable</option -></term> +<term id="option-autologinenable"><option>AutoLoginEnable</option></term> <listitem> -<para ->Enable automatic login. <emphasis ->Use with extreme care!</emphasis -> </para> -<para ->The default is <quote ->false</quote ->.</para> +<para>Enable automatic login. <emphasis>Use with extreme care!</emphasis> </para> +<para>The default is <quote>false</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-autologinuser" -><option ->AutoLoginUser</option -></term> +<term id="option-autologinuser"><option>AutoLoginUser</option></term> <listitem> -<para ->The user to log in automatically. <emphasis ->Never</emphasis -> specify <systemitem class="username" ->root</systemitem ->! </para> -<para ->Empty by default.</para> +<para>The user to log in automatically. <emphasis>Never</emphasis> specify <systemitem class="username">root</systemitem>! </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-autologinpass" -><option ->AutoLoginPass</option -></term> +<term id="option-autologinpass"><option>AutoLoginPass</option></term> <listitem> -<para ->The password for the user to log in automatically. This is <emphasis ->not</emphasis -> required unless the user is logged into a <acronym ->NIS</acronym -> or Kerberos domain. If you use this option, you should <command ->chmod <option ->600</option -> <filename ->tdmrc</filename -></command -> for obvious reasons. </para> -<para ->Empty by default.</para> +<para>The password for the user to log in automatically. This is <emphasis>not</emphasis> required unless the user is logged into a <acronym>NIS</acronym> or Kerberos domain. If you use this option, you should <command>chmod <option>600</option> <filename>tdmrc</filename></command> for obvious reasons. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-sessionsdirs" -><option ->SessionsDirs</option -></term> +<term id="option-sessionsdirs"><option>SessionsDirs</option></term> <listitem> -<para ->A list of directories containing session type definitions. </para> -<para ->The default is <quote ->${<envar ->kde_datadir</envar ->}/tdm/sessions</quote ->.</para> +<para>A list of directories containing session type definitions. </para> +<para>The default is <quote>${<envar>kde_datadir</envar>}/tdm/sessions</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-clientlogfile" -><option ->ClientLogFile</option -></term> +<term id="option-clientlogfile"><option>ClientLogFile</option></term> <listitem> -<para ->The file (relative to the user's home directory) to redirect the session output to. One occurrence of <parameter ->%s</parameter -> in this string will be substituted with the display name. Use <parameter ->%%</parameter -> to obtain a literal <literal ->%</literal ->. </para> -<para ->The default is <quote ->.xsession-errors</quote ->.</para> +<para>The file (relative to the user's home directory) to redirect the session output to. One occurrence of <parameter>%s</parameter> in this string will be substituted with the display name. Use <parameter>%%</parameter> to obtain a literal <literal>%</literal>. </para> +<para>The default is <quote>.xsession-errors</quote>.</para> </listitem> </varlistentry> @@ -1565,1096 +738,485 @@ <sect2 id="tdmrc-greeter"> -<title ->The [X-*-Greeter] section class of &tdmrc;</title> +<title>The [X-*-Greeter] section class of &tdmrc;</title> -<para ->This section class contains options concerning the configuration of the &tdm; frontend (greeter). </para> +<para>This section class contains options concerning the configuration of the &tdm; frontend (greeter). </para> <variablelist> <varlistentry> -<term id="option-guistyle" -><option ->GUIStyle</option -></term> +<term id="option-guistyle"><option>GUIStyle</option></term> <listitem> -<para ->Specify the widget style for the greeter. Empty means to use the built-in default which currently is <literal ->Keramik</literal ->. </para> -<para ->Empty by default.</para> +<para>Specify the widget style for the greeter. Empty means to use the built-in default which currently is <literal>Keramik</literal>. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-colorscheme" -><option ->ColorScheme</option -></term> +<term id="option-colorscheme"><option>ColorScheme</option></term> <listitem> -<para ->Specify the widget colour scheme for the greeter. Empty means to use the built-in default which currently is yellowish grey with some light blue and yellow elements. </para> -<para ->Empty by default.</para> +<para>Specify the widget colour scheme for the greeter. Empty means to use the built-in default which currently is yellowish grey with some light blue and yellow elements. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-logoarea" -><option ->LogoArea</option -></term> +<term id="option-logoarea"><option>LogoArea</option></term> <listitem> -<para ->What should be shown in the greeter righthand of the input lines (if <option ->UserList</option -> is disabled) or above them (if <option ->UserList</option -> is enabled): </para> +<para>What should be shown in the greeter righthand of the input lines (if <option>UserList</option> is disabled) or above them (if <option>UserList</option> is enabled): </para> <variablelist> <varlistentry> -<term -><parameter ->None</parameter -></term> -<listitem -><para ->nothing</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->Logo</parameter -></term> -<listitem -><para ->the image specified by <option ->LogoPixmap</option -></para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->Clock</parameter -></term> -<listitem -><para ->a neat analogue clock</para -></listitem> +<term><parameter>None</parameter></term> +<listitem><para>nothing</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>Logo</parameter></term> +<listitem><para>the image specified by <option>LogoPixmap</option></para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>Clock</parameter></term> +<listitem><para>a neat analogue clock</para></listitem> </varlistentry> </variablelist> -<para ->The default is <quote ->Clock</quote ->.</para> +<para>The default is <quote>Clock</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-logopixmap" -><option ->LogoPixmap</option -></term> +<term id="option-logopixmap"><option>LogoPixmap</option></term> <listitem> -<para ->The image to show in the greeter if <option ->LogoArea</option -> is <literal ->Logo</literal ->. </para> -<para ->Empty by default.</para> +<para>The image to show in the greeter if <option>LogoArea</option> is <literal>Logo</literal>. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-greeterpos" -><option ->GreeterPos</option -></term> +<term id="option-greeterpos"><option>GreeterPos</option></term> <listitem> -<para ->The relative coordinates (percentages of the screen size; X,Y) at which the centre of the greeter is put. &tdm; aligns the greeter to the edges of the screen it would cross otherwise. </para> -<para ->The default is <quote ->50,50</quote ->.</para> +<para>The relative coordinates (percentages of the screen size; X,Y) at which the centre of the greeter is put. &tdm; aligns the greeter to the edges of the screen it would cross otherwise. </para> +<para>The default is <quote>50,50</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-greeterscreen" -><option ->GreeterScreen</option -></term> +<term id="option-greeterscreen"><option>GreeterScreen</option></term> <listitem> -<para ->The screen the greeter should be displayed on in multi-headed and Xinerama setups. The numbering starts with 0. For Xinerama, it corresponds to the listing order in the active ServerLayout section of XF86Config; -1 means to use the upper-left screen, -2 means to use the upper-right screen. </para> +<para>The screen the greeter should be displayed on in multi-headed and Xinerama setups. The numbering starts with 0. For Xinerama, it corresponds to the listing order in the active ServerLayout section of XF86Config; -1 means to use the upper-left screen, -2 means to use the upper-right screen. </para> </listitem> </varlistentry> <varlistentry> -<term id="option-greetstring" -><option ->GreetString</option -></term> +<term id="option-greetstring"><option>GreetString</option></term> <listitem> -<para ->The headline in the greeter. An empty greeting means none at all. </para -><para ->The following character pairs are replaced by their value: <variablelist> +<para>The headline in the greeter. An empty greeting means none at all. </para><para>The following character pairs are replaced by their value: <variablelist> <varlistentry> -<term -><parameter ->%d</parameter -></term> -<listitem -><para ->name of the current display</para -></listitem> +<term><parameter>%d</parameter></term> +<listitem><para>name of the current display</para></listitem> </varlistentry> <varlistentry> -<term -><parameter ->%h</parameter -></term> -<listitem -><para ->local host name, possibly with the domain name</para -></listitem> +<term><parameter>%h</parameter></term> +<listitem><para>local host name, possibly with the domain name</para></listitem> </varlistentry> <varlistentry> -<term -><parameter ->%n</parameter -></term> -<listitem -><para ->local node name, most probably the host name without the domain name</para -></listitem> +<term><parameter>%n</parameter></term> +<listitem><para>local node name, most probably the host name without the domain name</para></listitem> </varlistentry> <varlistentry> -<term -><parameter ->%s</parameter -></term> -<listitem -><para ->operating system</para -></listitem> +<term><parameter>%s</parameter></term> +<listitem><para>operating system</para></listitem> </varlistentry> <varlistentry> -<term -><parameter ->%r</parameter -></term> -<listitem -><para ->operating system version</para -></listitem> +<term><parameter>%r</parameter></term> +<listitem><para>operating system version</para></listitem> </varlistentry> <varlistentry> -<term -><parameter ->%m</parameter -></term> -<listitem -><para ->machine (hardware) type</para -></listitem> +<term><parameter>%m</parameter></term> +<listitem><para>machine (hardware) type</para></listitem> </varlistentry> <varlistentry> -<term -><parameter ->%%</parameter -></term> -<listitem -><para ->a single <literal ->%</literal -></para -></listitem> +<term><parameter>%%</parameter></term> +<listitem><para>a single <literal>%</literal></para></listitem> </varlistentry> </variablelist> </para> -<para ->The default is <quote ->Welcome to %s at %n</quote ->.</para> +<para>The default is <quote>Welcome to %s at %n</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-greetfont" -><option ->GreetFont</option -></term> +<term id="option-greetfont"><option>GreetFont</option></term> <listitem> -<para ->The font for the greeter headline. </para> -<para ->The default is <quote ->charter,24,bold</quote ->.</para> +<para>The font for the greeter headline. </para> +<para>The default is <quote>charter,24,bold</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-stdfont" -><option ->StdFont</option -></term> +<term id="option-stdfont"><option>StdFont</option></term> <listitem> -<para ->The normal font used in the greeter. </para> -<para ->The default is <quote ->helvetica,12</quote ->.</para> +<para>The normal font used in the greeter. </para> +<para>The default is <quote>helvetica,12</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-failfont" -><option ->FailFont</option -></term> +<term id="option-failfont"><option>FailFont</option></term> <listitem> -<para ->The font used for the <quote ->Login Failed</quote -> message. </para> -<para ->The default is <quote ->helvetica,12,bold</quote ->.</para> +<para>The font used for the <quote>Login Failed</quote> message. </para> +<para>The default is <quote>helvetica,12,bold</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-antialiasing" -><option ->AntiAliasing</option -></term> +<term id="option-antialiasing"><option>AntiAliasing</option></term> <listitem> -<para ->Whether the fonts used in the greeter should be antialiased. </para> -<para ->The default is <quote ->false</quote ->.</para> +<para>Whether the fonts used in the greeter should be antialiased. </para> +<para>The default is <quote>false</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-numlock" -><option ->NumLock</option -></term> +<term id="option-numlock"><option>NumLock</option></term> <listitem> -<para ->What to do with the Num Lock modifier for the time the greeter is running: </para> +<para>What to do with the Num Lock modifier for the time the greeter is running: </para> <variablelist> <varlistentry> -<term -><parameter ->Off</parameter -></term> -<listitem -><para ->turn off</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->On</parameter -></term> -<listitem -><para ->turn on</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->Keep</parameter -></term> -<listitem -><para ->do not change the state</para -></listitem> +<term><parameter>Off</parameter></term> +<listitem><para>turn off</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>On</parameter></term> +<listitem><para>turn on</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>Keep</parameter></term> +<listitem><para>do not change the state</para></listitem> </varlistentry> </variablelist> -<para ->The default is <quote ->Keep</quote ->.</para> -</listitem> +<para>The default is <quote>Keep</quote>.</para> +</listitem> </varlistentry> <varlistentry> -<term id="option-language" -><option ->Language</option -></term> +<term id="option-language"><option>Language</option></term> <listitem> -<para ->Language and locale to use in the greeter, encoded like $<envar ->LC_LANG</envar ->. </para> -<para ->The default is <quote ->en_US</quote ->.</para> +<para>Language and locale to use in the greeter, encoded like $<envar>LC_LANG</envar>. </para> +<para>The default is <quote>en_US</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-usercompletion" -><option ->UserCompletion</option -></term> +<term id="option-usercompletion"><option>UserCompletion</option></term> <listitem> -<para ->Enable autocompletion in the username line edit. </para> -<para ->The default is <quote ->false</quote ->.</para> +<para>Enable autocompletion in the username line edit. </para> +<para>The default is <quote>false</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-userlist" -><option ->UserList</option -></term> +<term id="option-userlist"><option>UserList</option></term> <listitem> -<para ->Show a user list with unix login names, real names and images in the greeter. </para> -<para ->The default is <quote ->true</quote ->.</para> +<para>Show a user list with unix login names, real names and images in the greeter. </para> +<para>The default is <quote>true</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-showusers" -><option ->ShowUsers</option -></term> +<term id="option-showusers"><option>ShowUsers</option></term> <listitem> -<para ->This option controls which users will be shown in the user view (<option ->UserList</option ->) and/or offered for autocompletion (<option ->UserCompletion</option ->). If it is <literal ->Selected</literal ->, <option ->SelectedUsers</option -> contains the final list of users. If it is <literal ->NotHidden</literal ->, the initial user list are all users found on the system. Users contained in <option ->HiddenUsers</option -> are removed from the list, just like all users with a UID greater than specified in <option ->MaxShowUID</option -> and users with a non-zero UID less than specified in <option ->MinShowUID</option ->. Items in <option ->SelectedUsers</option -> and <option ->HiddenUsers</option -> which are prefixed with <literal ->@</literal -> represent all users in the user group named by that item. Finally, the user list will be sorted alphabetically, if <option ->SortUsers</option -> is enabled. </para> -<para ->The default is <quote ->NotHidden</quote ->.</para> +<para>This option controls which users will be shown in the user view (<option>UserList</option>) and/or offered for autocompletion (<option>UserCompletion</option>). If it is <literal>Selected</literal>, <option>SelectedUsers</option> contains the final list of users. If it is <literal>NotHidden</literal>, the initial user list are all users found on the system. Users contained in <option>HiddenUsers</option> are removed from the list, just like all users with a UID greater than specified in <option>MaxShowUID</option> and users with a non-zero UID less than specified in <option>MinShowUID</option>. Items in <option>SelectedUsers</option> and <option>HiddenUsers</option> which are prefixed with <literal>@</literal> represent all users in the user group named by that item. Finally, the user list will be sorted alphabetically, if <option>SortUsers</option> is enabled. </para> +<para>The default is <quote>NotHidden</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-selectedusers" -><option ->SelectedUsers</option -></term> +<term id="option-selectedusers"><option>SelectedUsers</option></term> <listitem> -<para ->See <option ->ShowUsers</option ->. </para> -<para ->Empty by default.</para> +<para>See <option>ShowUsers</option>. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-hiddenusers" -><option ->HiddenUsers</option -></term> +<term id="option-hiddenusers"><option>HiddenUsers</option></term> <listitem> -<para ->See <option ->ShowUsers</option ->. </para> -<para ->Empty by default.</para> +<para>See <option>ShowUsers</option>. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-minshowuid" -><option ->MinShowUID</option -></term> +<term id="option-minshowuid"><option>MinShowUID</option></term> <listitem> -<para ->See <option ->ShowUsers</option ->. </para> +<para>See <option>ShowUsers</option>. </para> </listitem> </varlistentry> <varlistentry> -<term id="option-maxshowuid" -><option ->MaxShowUID</option -></term> +<term id="option-maxshowuid"><option>MaxShowUID</option></term> <listitem> -<para ->See <option ->ShowUsers</option ->. </para> -<para ->The default is <quote ->65535</quote ->.</para> +<para>See <option>ShowUsers</option>. </para> +<para>The default is <quote>65535</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-sortusers" -><option ->SortUsers</option -></term> +<term id="option-sortusers"><option>SortUsers</option></term> <listitem> -<para ->See <option ->ShowUsers</option ->. </para> -<para ->The default is <quote ->true</quote ->.</para> +<para>See <option>ShowUsers</option>. </para> +<para>The default is <quote>true</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-facesource" -><option ->FaceSource</option -></term> +<term id="option-facesource"><option>FaceSource</option></term> <listitem> -<para ->If <option ->UserList</option -> is enabled, this specifies where &tdm; gets the images from: </para> +<para>If <option>UserList</option> is enabled, this specifies where &tdm; gets the images from: </para> <variablelist> <varlistentry> -<term -><parameter ->AdminOnly</parameter -></term> -<listitem -><para ->from <filename -><<option ->FaceDir</option ->>/$<envar ->USER</envar ->.face[.icon]</filename -></para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->PreferAdmin</parameter -></term> -<listitem -><para ->prefer <<option ->FaceDir</option ->>, fallback on $<envar ->HOME</envar -></para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->PreferUser</parameter -></term> -<listitem -><para ->... and the other way round</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->UserOnly</parameter -></term> -<listitem -><para ->from the user's <filename ->$<envar ->HOME</envar ->/.face[.icon]</filename -></para -></listitem> +<term><parameter>AdminOnly</parameter></term> +<listitem><para>from <filename><<option>FaceDir</option>>/$<envar>USER</envar>.face[.icon]</filename></para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>PreferAdmin</parameter></term> +<listitem><para>prefer <<option>FaceDir</option>>, fallback on $<envar>HOME</envar></para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>PreferUser</parameter></term> +<listitem><para>... and the other way round</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>UserOnly</parameter></term> +<listitem><para>from the user's <filename>$<envar>HOME</envar>/.face[.icon]</filename></para></listitem> </varlistentry> </variablelist> -<para ->The images can be in any format Qt recognises, but the filename must match &tdm;'s expectations: <literal ->.face.icon</literal -> should be a 48x48 icon, while <literal ->.face</literal -> should be a 300x300 image. Currently the big image is used only as a fallback and is scaled down, but in the future it might be displayed full-size in the logo area or a tooltip. </para> -<para ->The default is <quote ->AdminOnly</quote ->.</para> +<para>The images can be in any format Qt recognises, but the filename must match &tdm;'s expectations: <literal>.face.icon</literal> should be a 48x48 icon, while <literal>.face</literal> should be a 300x300 image. Currently the big image is used only as a fallback and is scaled down, but in the future it might be displayed full-size in the logo area or a tooltip. </para> +<para>The default is <quote>AdminOnly</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-facedir" -><option ->FaceDir</option -></term> +<term id="option-facedir"><option>FaceDir</option></term> <listitem> -<para ->See <option ->FaceSource</option ->. </para> -<para ->The default is <quote ->${<envar ->kde_datadir</envar ->}/tdm/faces</quote ->.</para> +<para>See <option>FaceSource</option>. </para> +<para>The default is <quote>${<envar>kde_datadir</envar>}/tdm/faces</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-preselectuser" -><option ->PreselectUser</option -></term> +<term id="option-preselectuser"><option>PreselectUser</option></term> <listitem> -<para ->Specify, if/which user should be preselected for log in: </para> +<para>Specify, if/which user should be preselected for log in: </para> <variablelist> <varlistentry> -<term -><parameter ->None</parameter -></term> -<listitem -><para ->do not preselect any user</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->Previous</parameter -></term> -<listitem -><para ->the user which successfully logged in last time</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->Default</parameter -></term> -<listitem -><para ->the user specified in the <option ->DefaultUser</option -> option</para -></listitem> +<term><parameter>None</parameter></term> +<listitem><para>do not preselect any user</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>Previous</parameter></term> +<listitem><para>the user which successfully logged in last time</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>Default</parameter></term> +<listitem><para>the user specified in the <option>DefaultUser</option> option</para></listitem> </varlistentry> </variablelist> -<para ->If <option ->FocusPasswd</option -> is enabled and a user was preselected, the cursor is placed in the password input field automatically. </para> -<note -><para ->Enabling user preselection can be considered a security hole, as it presents a valid login name to a potential attacker, so he <quote ->only</quote -> needs to guess the password. On the other hand, one could set <option ->DefaultUser</option -> to a fake login name.</para -></note> +<para>If <option>FocusPasswd</option> is enabled and a user was preselected, the cursor is placed in the password input field automatically. </para> +<note><para>Enabling user preselection can be considered a security hole, as it presents a valid login name to a potential attacker, so he <quote>only</quote> needs to guess the password. On the other hand, one could set <option>DefaultUser</option> to a fake login name.</para></note> -<para ->The default is <quote ->None</quote ->.</para> +<para>The default is <quote>None</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-defaultuser" -><option ->DefaultUser</option -></term> +<term id="option-defaultuser"><option>DefaultUser</option></term> <listitem> -<para ->See <option ->PreselectUser</option ->. </para> -<para ->Empty by default.</para> +<para>See <option>PreselectUser</option>. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-focuspasswd" -><option ->FocusPasswd</option -></term> +<term id="option-focuspasswd"><option>FocusPasswd</option></term> <listitem> -<para ->See <option ->PreselectUser</option ->. </para> -<para ->The default is <quote ->false</quote ->.</para> +<para>See <option>PreselectUser</option>. </para> +<para>The default is <quote>false</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-echomode" -><option ->EchoMode</option -></term> +<term id="option-echomode"><option>EchoMode</option></term> <listitem> -<para ->The password input fields cloak the typed in text. Specify, how to do it: </para> +<para>The password input fields cloak the typed in text. Specify, how to do it: </para> <variablelist> <varlistentry> -<term -><parameter ->OneStar</parameter -></term> -<listitem -><para -><literal ->*</literal -> is shown for every typed letter</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->ThreeStars</parameter -></term> -<listitem -><para -><literal ->***</literal -> is shown for every typed letter</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->NoEcho</parameter -></term> -<listitem -><para ->nothing is shown at all, the cursor does not move</para -></listitem> +<term><parameter>OneStar</parameter></term> +<listitem><para><literal>*</literal> is shown for every typed letter</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>ThreeStars</parameter></term> +<listitem><para><literal>***</literal> is shown for every typed letter</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>NoEcho</parameter></term> +<listitem><para>nothing is shown at all, the cursor does not move</para></listitem> </varlistentry> </variablelist> -<para ->The default is <quote ->OneStar</quote ->.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term id="option-usebackground" -><option ->UseBackground</option -></term> -<listitem> -<para ->If enabled, &tdm; will automatically start the <command ->krootimage</command -> program to set up the background; otherwise, the <option ->Setup</option -> program is responsible for the background. </para> -<para ->The default is <quote ->true</quote ->.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term id="option-backgroundcfg" -><option ->BackgroundCfg</option -></term> -<listitem> -<para ->The configuration file to be used by <command ->krootimage</command ->. It contains a section named <literal ->[Desktop0]</literal -> like <filename ->kdesktoprc</filename -> does. Its options are not described herein; guess their meanings or use the control centre. </para> -<para ->The default is <quote ->${<envar ->kde_confdir</envar ->}/tdm/backgroundrc</quote ->.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term id="option-grabserver" -><option ->GrabServer</option -></term> -<listitem> -<para ->To improve security, the greeter grabs the &X-Server; and then the keyboard when it starts up. This option specifies if the &X-Server; grab should be held for the duration of the name/password reading. When disabled, the &X-Server; is ungrabbed after the keyboard grab succeeds; otherwise, the &X-Server; is grabbed until just before the session begins. </para> -<note -><para ->Enabling this option disables <option ->UseBackground</option -> and <option ->Setup</option ->.</para -></note> +<para>The default is <quote>OneStar</quote>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term id="option-usebackground"><option>UseBackground</option></term> +<listitem> +<para>If enabled, &tdm; will automatically start the <command>krootimage</command> program to set up the background; otherwise, the <option>Setup</option> program is responsible for the background. </para> +<para>The default is <quote>true</quote>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term id="option-backgroundcfg"><option>BackgroundCfg</option></term> +<listitem> +<para>The configuration file to be used by <command>krootimage</command>. It contains a section named <literal>[Desktop0]</literal> like <filename>kdesktoprc</filename> does. Its options are not described herein; guess their meanings or use the control centre. </para> +<para>The default is <quote>${<envar>kde_confdir</envar>}/tdm/backgroundrc</quote>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term id="option-grabserver"><option>GrabServer</option></term> +<listitem> +<para>To improve security, the greeter grabs the &X-Server; and then the keyboard when it starts up. This option specifies if the &X-Server; grab should be held for the duration of the name/password reading. When disabled, the &X-Server; is ungrabbed after the keyboard grab succeeds; otherwise, the &X-Server; is grabbed until just before the session begins. </para> +<note><para>Enabling this option disables <option>UseBackground</option> and <option>Setup</option>.</para></note> -<para ->The default is <quote ->false</quote ->.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term id="option-grabtimeout" -><option ->GrabTimeout</option -></term> -<listitem> -<para ->This option specifies the maximum time &tdm; will wait for the grabs to succeed. A grab may fail if some other X-client has the &X-Server; or the keyboard grabbed, or possibly if the network latencies are very high. You should be cautious when raising the timeout, as a user can be spoofed by a look-alike window on the display. If a grab fails, &tdm; kills and restarts the &X-Server; (if possible) and the session. </para> -<para ->The default is <quote ->3</quote ->.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term id="option-authcomplain" -><option ->AuthComplain</option -></term> -<listitem> -<para ->Warn, if a display has no X-authorisation. This will be the case if <itemizedlist> - <listitem -><para ->the authorisation file for a local &X-Server; could not be created, </para -></listitem> - <listitem -><para ->a remote display from &XDMCP; did not request any authorisation or </para -></listitem> - <listitem -><para ->the display is a <literal ->foreign</literal -> display from the <filename ->Xservers</filename -> file. </para -></listitem> +<para>The default is <quote>false</quote>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term id="option-grabtimeout"><option>GrabTimeout</option></term> +<listitem> +<para>This option specifies the maximum time &tdm; will wait for the grabs to succeed. A grab may fail if some other X-client has the &X-Server; or the keyboard grabbed, or possibly if the network latencies are very high. You should be cautious when raising the timeout, as a user can be spoofed by a look-alike window on the display. If a grab fails, &tdm; kills and restarts the &X-Server; (if possible) and the session. </para> +<para>The default is <quote>3</quote>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term id="option-authcomplain"><option>AuthComplain</option></term> +<listitem> +<para>Warn, if a display has no X-authorisation. This will be the case if <itemizedlist> + <listitem><para>the authorisation file for a local &X-Server; could not be created, </para></listitem> + <listitem><para>a remote display from &XDMCP; did not request any authorisation or </para></listitem> + <listitem><para>the display is a <literal>foreign</literal> display from the <filename>Xservers</filename> file. </para></listitem> </itemizedlist> </para> -<para ->The default is <quote ->true</quote ->.</para> +<para>The default is <quote>true</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-loginmode" -><option ->LoginMode</option -></term> +<term id="option-loginmode"><option>LoginMode</option></term> <listitem> -<para ->Specify whether the greeter of local displays should start up in host chooser (remote) or login (local) mode and whether it is allowed to switch to the other mode. </para> +<para>Specify whether the greeter of local displays should start up in host chooser (remote) or login (local) mode and whether it is allowed to switch to the other mode. </para> <variablelist> <varlistentry> -<term -><parameter ->LocalOnly</parameter -></term> -<listitem -><para ->only local login possible</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->DefaultLocal</parameter -></term> -<listitem -><para ->start up in local mode, but allow switching to remote mode</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->DefaultRemote</parameter -></term> -<listitem -><para ->... and the other way round</para -></listitem> -</varlistentry> -<varlistentry> -<term -><parameter ->RemoteOnly</parameter -></term> -<listitem -><para ->only choice of remote host possible</para -></listitem> +<term><parameter>LocalOnly</parameter></term> +<listitem><para>only local login possible</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>DefaultLocal</parameter></term> +<listitem><para>start up in local mode, but allow switching to remote mode</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>DefaultRemote</parameter></term> +<listitem><para>... and the other way round</para></listitem> +</varlistentry> +<varlistentry> +<term><parameter>RemoteOnly</parameter></term> +<listitem><para>only choice of remote host possible</para></listitem> </varlistentry> </variablelist> -<para ->The default is <quote ->LocalOnly</quote ->.</para> +<para>The default is <quote>LocalOnly</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-chooserhosts" -><option ->ChooserHosts</option -></term> +<term id="option-chooserhosts"><option>ChooserHosts</option></term> <listitem> -<para ->A list of hosts to be automatically added to the remote login menu. The special name <literal ->*</literal -> means broadcast. Has no effect if <option ->LoginMode</option -> is <literal ->LocalOnly</literal ->. </para> -<para ->The default is <quote ->*</quote ->.</para> +<para>A list of hosts to be automatically added to the remote login menu. The special name <literal>*</literal> means broadcast. Has no effect if <option>LoginMode</option> is <literal>LocalOnly</literal>. </para> +<para>The default is <quote>*</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-forgingseed" -><option ->ForgingSeed</option -></term> +<term id="option-forgingseed"><option>ForgingSeed</option></term> <listitem> -<para ->Use this number as a random seed when forging saved session types, etc. of unknown users. This is used to avoid telling an attacker about existing users by reverse conclusion. This value should be random but constant across the login domain. </para> +<para>Use this number as a random seed when forging saved session types, etc. of unknown users. This is used to avoid telling an attacker about existing users by reverse conclusion. This value should be random but constant across the login domain. </para> </listitem> </varlistentry> <varlistentry> -<term id="option-showlog" -><option ->ShowLog</option -></term> +<term id="option-showlog"><option>ShowLog</option></term> <listitem> -<para ->Enable &tdm;'s built-in <command ->xconsole</command ->. Note that this can be enabled for only one display at a time. This option is available only if &tdm; was <command ->configure</command ->d with <option ->--enable-tdm-xconsole</option ->. </para> -<para ->The default is <quote ->false</quote ->.</para> +<para>Enable &tdm;'s built-in <command>xconsole</command>. Note that this can be enabled for only one display at a time. This option is available only if &tdm; was <command>configure</command>d with <option>--enable-tdm-xconsole</option>. </para> +<para>The default is <quote>false</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-logsource" -><option ->LogSource</option -></term> +<term id="option-logsource"><option>LogSource</option></term> <listitem> -<para ->The data source for &tdm;'s built-in <command ->xconsole</command ->. If empty, a console log redirection is requested from <filename ->/dev/console</filename ->. Has no effect if <option ->ShowLog</option -> is disabled. </para> -<para ->Empty by default.</para> +<para>The data source for &tdm;'s built-in <command>xconsole</command>. If empty, a console log redirection is requested from <filename>/dev/console</filename>. Has no effect if <option>ShowLog</option> is disabled. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-pluginslogin" -><option ->PluginsLogin</option -></term> +<term id="option-pluginslogin"><option>PluginsLogin</option></term> <listitem> -<para ->Specify conversation plugins for the login dialogue; the first in the list is selected initially. Each plugin can be specified as a base name (which expands to <filename ->$<envar ->kde_modulesdir</envar ->/kgreet_<replaceable ->base</replaceable -></filename ->) or as a full pathname. </para -><para ->Conversation plugins are modules for the greeter which obtain authentication data from the user. Currently only the <literal ->classic</literal -> plugin is shipped with &kde;; it presents the well-known username and password form. </para> -<para ->The default is <quote ->classic</quote ->.</para> +<para>Specify conversation plugins for the login dialogue; the first in the list is selected initially. Each plugin can be specified as a base name (which expands to <filename>$<envar>kde_modulesdir</envar>/kgreet_<replaceable>base</replaceable></filename>) or as a full pathname. </para><para>Conversation plugins are modules for the greeter which obtain authentication data from the user. Currently only the <literal>classic</literal> plugin is shipped with &kde;; it presents the well-known username and password form. </para> +<para>The default is <quote>classic</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-pluginsshutdown" -><option ->PluginsShutdown</option -></term> +<term id="option-pluginsshutdown"><option>PluginsShutdown</option></term> <listitem> -<para ->Same as <option ->PluginsLogin</option ->, but for the shutdown dialogue. </para> -<para ->The default is <quote ->classic</quote ->.</para> +<para>Same as <option>PluginsLogin</option>, but for the shutdown dialogue. </para> +<para>The default is <quote>classic</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-pluginoptions" -><option ->PluginOptions</option -></term> +<term id="option-pluginoptions"><option>PluginOptions</option></term> <listitem> -<para ->A list of options of the form <replaceable ->Key</replaceable -><literal ->=</literal -><replaceable ->Value</replaceable ->. The conversation plugins can query these settings; it is up to them what possible keys are. </para> -<para ->Empty by default.</para> +<para>A list of options of the form <replaceable>Key</replaceable><literal>=</literal><replaceable>Value</replaceable>. The conversation plugins can query these settings; it is up to them what possible keys are. </para> +<para>Empty by default.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-allowconsole" -><option ->AllowConsole</option -></term> +<term id="option-allowconsole"><option>AllowConsole</option></term> <listitem> -<para ->Show the <guilabel ->Console Login</guilabel -> action in the greeter. For this to work, a console must be configured for this particular display, see <xref linkend="tdmrc-xservers"/>. </para> -<para ->The default is <quote ->true</quote ->.</para> +<para>Show the <guilabel>Console Login</guilabel> action in the greeter. For this to work, a console must be configured for this particular display, see <xref linkend="tdmrc-xservers"/>. </para> +<para>The default is <quote>true</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-allowclose" -><option ->AllowClose</option -></term> +<term id="option-allowclose"><option>AllowClose</option></term> <listitem> -<para ->Show the <guilabel ->Restart X Server</guilabel ->/<guilabel ->Close Connection</guilabel -> action in the greeter. </para> -<para ->The default is <quote ->true</quote ->.</para> +<para>Show the <guilabel>Restart X Server</guilabel>/<guilabel>Close Connection</guilabel> action in the greeter. </para> +<para>The default is <quote>true</quote>.</para> </listitem> </varlistentry> <varlistentry> -<term id="option-preloader" -><option ->Preloader</option -></term> +<term id="option-preloader"><option>Preloader</option></term> <listitem> -<para ->A program to run while the greeter is visible. It is supposed to preload as much as possible of the session that is going to be started (most probably). </para> -<para ->Empty by default.</para> +<para>A program to run while the greeter is visible. It is supposed to preload as much as possible of the session that is going to be started (most probably). </para> +<para>Empty by default.</para> </listitem> </varlistentry> @@ -2666,524 +1228,190 @@ </sect1> <sect1 id="tdmrc-xservers"> -<title ->Specifying permanent &X-Server;s</title> - -<para ->Each specification indicates a display which should constantly be managed and which is not using &XDMCP;. This method is typically used only for local &X-Server;s that are started by &tdm;, but &tdm; can manage externally started (<quote ->foreign</quote ->) &X-Server;s as well, may they run on the local machine or rather remotely.</para> - -<para ->The formal syntax of a specification is <screen> -<userinput -><replaceable ->display name</replaceable -> [<replaceable ->display class</replaceable ->] <literal ->local</literal ->[<literal ->@</literal -><replaceable ->tty</replaceable ->] [<literal ->reserve</literal ->] <replaceable ->server command</replaceable -></userinput> -</screen -> for own &X-Server;s and <screen> -<userinput -><replaceable ->display name</replaceable -> [<replaceable ->display class</replaceable ->] <literal ->foreign</literal -></userinput> -</screen -> for foreign &X-Server;s.</para> - -<para ->The <replaceable ->display name</replaceable -> must be something that can be passed in the <option ->-display</option -> option to an X program. This string is used to generate the display-specific section names, so be careful to match the names. The display name of &XDMCP; displays is derived from the display's address by reverse host name resolution. For configuration purposes, the <literal ->localhost</literal -> prefix from locally running &XDMCP; displays is <emphasis ->not</emphasis -> stripped to make them distinguishable from local &X-Server;s started by &tdm;.</para> - -<para ->The <replaceable ->display class</replaceable -> portion is also used in the display-specific sections. This is useful if you have a large collection of similar displays (such as a corral of X terminals) and would like to set options for groups of them. When using &XDMCP;, the display is required to specify the display class, so the manual for your particular X terminal should document the display class string for your device. If it does not, you can run &tdm; in debug mode and <command ->grep</command -> the log for <quote ->class</quote ->.</para> - -<para ->The <replaceable ->tty</replaceable -> specifies which text console an &X-Server; is <quote ->covering</quote ->, so &tdm; knows which console it should monitor for activity after switching to <guilabel ->Console login</guilabel -> to find out when the console session ends. Note that this concept (originating from Solaris) is not perfectly suited for Linux, as there &X-Server;s run on separate virtual terminals and consequently do not actually cover consoles (<command ->getty</command ->s). </para> - -<para ->The <literal ->reserve</literal -> keyword instructs &tdm; to start the display not when &tdm; starts up, but when it is explicitly requested via the command <acronym ->FiFo</acronym ->. If reserve displays are specified, the &kde; menu will have a <guilabel ->Start New Session</guilabel -> item near the bottom; use that to activate a reserve display with a new login session. The monitor will switch to the new display, and you will have a minute to login. If there are no more reserve displays available, selecting the menu item will have no effect.</para> - -<para ->The <replaceable ->server command</replaceable -> specifies the complete &X-Server; command line, including a display number for secondary displays. When &tdm; starts a session, it sets up authorisation data for the &X-Server;. For local servers, &tdm; passes <command -><option ->-auth</option -> <filename -><replaceable ->filename</replaceable -></filename -></command -> on the &X-Server;'s command line to point it at its authorisation data. For &XDMCP; displays, &tdm; passes the authorisation data to the &X-Server; via the <quote ->Accept</quote -> &XDMCP; message.</para> +<title>Specifying permanent &X-Server;s</title> + +<para>Each specification indicates a display which should constantly be managed and which is not using &XDMCP;. This method is typically used only for local &X-Server;s that are started by &tdm;, but &tdm; can manage externally started (<quote>foreign</quote>) &X-Server;s as well, may they run on the local machine or rather remotely.</para> + +<para>The formal syntax of a specification is <screen> +<userinput><replaceable>display name</replaceable> [<replaceable>display class</replaceable>] <literal>local</literal>[<literal>@</literal><replaceable>tty</replaceable>] [<literal>reserve</literal>] <replaceable>server command</replaceable></userinput> +</screen> for own &X-Server;s and <screen> +<userinput><replaceable>display name</replaceable> [<replaceable>display class</replaceable>] <literal>foreign</literal></userinput> +</screen> for foreign &X-Server;s.</para> + +<para>The <replaceable>display name</replaceable> must be something that can be passed in the <option>-display</option> option to an X program. This string is used to generate the display-specific section names, so be careful to match the names. The display name of &XDMCP; displays is derived from the display's address by reverse host name resolution. For configuration purposes, the <literal>localhost</literal> prefix from locally running &XDMCP; displays is <emphasis>not</emphasis> stripped to make them distinguishable from local &X-Server;s started by &tdm;.</para> + +<para>The <replaceable>display class</replaceable> portion is also used in the display-specific sections. This is useful if you have a large collection of similar displays (such as a corral of X terminals) and would like to set options for groups of them. When using &XDMCP;, the display is required to specify the display class, so the manual for your particular X terminal should document the display class string for your device. If it does not, you can run &tdm; in debug mode and <command>grep</command> the log for <quote>class</quote>.</para> + +<para>The <replaceable>tty</replaceable> specifies which text console an &X-Server; is <quote>covering</quote>, so &tdm; knows which console it should monitor for activity after switching to <guilabel>Console login</guilabel> to find out when the console session ends. Note that this concept (originating from Solaris) is not perfectly suited for Linux, as there &X-Server;s run on separate virtual terminals and consequently do not actually cover consoles (<command>getty</command>s). </para> + +<para>The <literal>reserve</literal> keyword instructs &tdm; to start the display not when &tdm; starts up, but when it is explicitly requested via the command <acronym>FiFo</acronym>. If reserve displays are specified, the &kde; menu will have a <guilabel>Start New Session</guilabel> item near the bottom; use that to activate a reserve display with a new login session. The monitor will switch to the new display, and you will have a minute to login. If there are no more reserve displays available, selecting the menu item will have no effect.</para> + +<para>The <replaceable>server command</replaceable> specifies the complete &X-Server; command line, including a display number for secondary displays. When &tdm; starts a session, it sets up authorisation data for the &X-Server;. For local servers, &tdm; passes <command><option>-auth</option> <filename><replaceable>filename</replaceable></filename></command> on the &X-Server;'s command line to point it at its authorisation data. For &XDMCP; displays, &tdm; passes the authorisation data to the &X-Server; via the <quote>Accept</quote> &XDMCP; message.</para> </sect1> <sect1 id="tdmrc-xaccess"> -<title ->&XDMCP; access control</title> - -<para ->The file specified by the <option ->AccessFile</option -> option provides information which &tdm; uses to control access from displays requesting service via &XDMCP;. The file contains four types of entries: entries which control the response to <quote ->Direct</quote -> and <quote ->Broadcast</quote -> queries, entries which control the response to <quote ->Indirect</quote -> queries, macro definitions for <quote ->Indirect</quote -> entries and entries which control on which network interfaces &tdm; listens for &XDMCP; queries. Blank lines are ignored, <literal ->#</literal -> is treated as a comment delimiter causing the rest of that line to be ignored and <literal ->\</literal -> causes an immediately following newline to be ignored, allowing indirect host lists to span multiple lines. </para> - -<para ->The format of the <quote ->Direct</quote -> entries is simple, either a host name or a pattern, which is compared against the host name of the display device. Patterns are distinguished from host names by the inclusion of one or more meta characters; <literal ->*</literal -> matches any sequence of 0 or more characters, and <literal ->?</literal -> matches any single character. If the entry is a host name, all comparisons are done using network addresses, so any name which converts to the correct network address may be used. Note that only the first network address returned for a host name is used. For patterns, only canonical host names are used in the comparison, so ensure that you do not attempt to match aliases. Host names from &XDMCP; queries always contain the local domain name even if the reverse lookup returns a short name, so you can use patterns for the local domain. Preceding the entry with a <literal ->!</literal -> character causes hosts which match that entry to be excluded. To only respond to <quote ->Direct</quote -> queries for a host or pattern, it can be followed by the optional <literal ->NOBROADCAST</literal -> keyword. This can be used to prevent a &tdm; server from appearing on menus based on <quote ->Broadcast</quote -> queries.</para> - -<para ->An <quote ->Indirect</quote -> entry also contains a host name or pattern, but follows it with a list of host names or macros to which the queries should be forwarded. <quote ->Indirect</quote -> entries can be excluding as well, in which case a (valid) dummy host name must be supplied to make the entry distinguishable from a <quote ->Direct</quote -> entry. If compiled with IPv6 support, multicast address groups may also be included in the list of addresses the queries are forwarded to. If the indirect host list contains the keyword <literal ->CHOOSER</literal ->, <quote ->Indirect</quote -> queries are not forwarded, but instead a host chooser dialogue is displayed by &tdm;. The chooser will send a <quote ->Direct</quote -> query to each of the remaining host names in the list and offer a menu of all the hosts that respond. The host list may contain the keyword <literal ->BROADCAST</literal ->, to make the chooser send a <quote ->Broadcast</quote -> query as well; note that on some operating systems, UDP packets cannot be broadcast, so this feature will not work. </para> - -<para ->When checking access for a particular display host, each entry is scanned in turn and the first matching entry determines the response. <quote ->Direct</quote -> and <quote ->Broadcast</quote -> entries are ignored when scanning for an <quote ->Indirect</quote -> entry and vice-versa.</para> - -<para ->A macro definition contains a macro name and a list of host names and other macros that the macro expands to. To distinguish macros from hostnames, macro names start with a <literal ->%</literal -> character.</para> - -<para ->The last entry type is the <literal ->LISTEN</literal -> directive. The formal syntax is <screen> -<userinput -> <literal ->LISTEN</literal -> [<replaceable ->interface</replaceable -> [<replaceable ->multicast list</replaceable ->]]</userinput> -</screen -> If one or more <literal ->LISTEN</literal -> lines are specified, &tdm; listens for &XDMCP; requests only on the specified interfaces. <replaceable ->interface</replaceable -> may be a hostname or IP address representing a network interface on this machine, or the wildcard <literal ->*</literal -> to represent all available network interfaces. If multicast group addresses are listed on a <literal ->LISTEN</literal -> line, &tdm; joins the multicast groups on the given interface. For IPv6 multicasts, the IANA has assigned ff0<replaceable ->X</replaceable ->:0:0:0:0:0:0:12b as the permanently assigned range of multicast addresses for &XDMCP;. The <replaceable ->X</replaceable -> in the prefix may be replaced by any valid scope identifier, such as 1 for Node-Local, 2 for Link-Local, 5 for Site-Local, and so on (see IETF RFC 2373 or its replacement for further details and scope definitions). &tdm; defaults to listening on the Link-Local scope address ff02:0:0:0:0:0:0:12b to most closely match the IPv4 subnet broadcast behavior. If no <literal ->LISTEN</literal -> lines are given, &tdm; listens on all interfaces and joins the default &XDMCP; IPv6 multicast group (when compiled with IPv6 support). To disable listening for &XDMCP; requests altogether, a <literal ->LISTEN</literal -> line with no addresses may be specified, but using the <literal ->[Xdmcp]</literal -> <option ->Enable</option -> option is preferred. </para> +<title>&XDMCP; access control</title> + +<para>The file specified by the <option>AccessFile</option> option provides information which &tdm; uses to control access from displays requesting service via &XDMCP;. The file contains four types of entries: entries which control the response to <quote>Direct</quote> and <quote>Broadcast</quote> queries, entries which control the response to <quote>Indirect</quote> queries, macro definitions for <quote>Indirect</quote> entries and entries which control on which network interfaces &tdm; listens for &XDMCP; queries. Blank lines are ignored, <literal>#</literal> is treated as a comment delimiter causing the rest of that line to be ignored and <literal>\</literal> causes an immediately following newline to be ignored, allowing indirect host lists to span multiple lines. </para> + +<para>The format of the <quote>Direct</quote> entries is simple, either a host name or a pattern, which is compared against the host name of the display device. Patterns are distinguished from host names by the inclusion of one or more meta characters; <literal>*</literal> matches any sequence of 0 or more characters, and <literal>?</literal> matches any single character. If the entry is a host name, all comparisons are done using network addresses, so any name which converts to the correct network address may be used. Note that only the first network address returned for a host name is used. For patterns, only canonical host names are used in the comparison, so ensure that you do not attempt to match aliases. Host names from &XDMCP; queries always contain the local domain name even if the reverse lookup returns a short name, so you can use patterns for the local domain. Preceding the entry with a <literal>!</literal> character causes hosts which match that entry to be excluded. To only respond to <quote>Direct</quote> queries for a host or pattern, it can be followed by the optional <literal>NOBROADCAST</literal> keyword. This can be used to prevent a &tdm; server from appearing on menus based on <quote>Broadcast</quote> queries.</para> + +<para>An <quote>Indirect</quote> entry also contains a host name or pattern, but follows it with a list of host names or macros to which the queries should be forwarded. <quote>Indirect</quote> entries can be excluding as well, in which case a (valid) dummy host name must be supplied to make the entry distinguishable from a <quote>Direct</quote> entry. If compiled with IPv6 support, multicast address groups may also be included in the list of addresses the queries are forwarded to. If the indirect host list contains the keyword <literal>CHOOSER</literal>, <quote>Indirect</quote> queries are not forwarded, but instead a host chooser dialogue is displayed by &tdm;. The chooser will send a <quote>Direct</quote> query to each of the remaining host names in the list and offer a menu of all the hosts that respond. The host list may contain the keyword <literal>BROADCAST</literal>, to make the chooser send a <quote>Broadcast</quote> query as well; note that on some operating systems, UDP packets cannot be broadcast, so this feature will not work. </para> + +<para>When checking access for a particular display host, each entry is scanned in turn and the first matching entry determines the response. <quote>Direct</quote> and <quote>Broadcast</quote> entries are ignored when scanning for an <quote>Indirect</quote> entry and vice-versa.</para> + +<para>A macro definition contains a macro name and a list of host names and other macros that the macro expands to. To distinguish macros from hostnames, macro names start with a <literal>%</literal> character.</para> + +<para>The last entry type is the <literal>LISTEN</literal> directive. The formal syntax is <screen> +<userinput> <literal>LISTEN</literal> [<replaceable>interface</replaceable> [<replaceable>multicast list</replaceable>]]</userinput> +</screen> If one or more <literal>LISTEN</literal> lines are specified, &tdm; listens for &XDMCP; requests only on the specified interfaces. <replaceable>interface</replaceable> may be a hostname or IP address representing a network interface on this machine, or the wildcard <literal>*</literal> to represent all available network interfaces. If multicast group addresses are listed on a <literal>LISTEN</literal> line, &tdm; joins the multicast groups on the given interface. For IPv6 multicasts, the IANA has assigned ff0<replaceable>X</replaceable>:0:0:0:0:0:0:12b as the permanently assigned range of multicast addresses for &XDMCP;. The <replaceable>X</replaceable> in the prefix may be replaced by any valid scope identifier, such as 1 for Node-Local, 2 for Link-Local, 5 for Site-Local, and so on (see IETF RFC 2373 or its replacement for further details and scope definitions). &tdm; defaults to listening on the Link-Local scope address ff02:0:0:0:0:0:0:12b to most closely match the IPv4 subnet broadcast behavior. If no <literal>LISTEN</literal> lines are given, &tdm; listens on all interfaces and joins the default &XDMCP; IPv6 multicast group (when compiled with IPv6 support). To disable listening for &XDMCP; requests altogether, a <literal>LISTEN</literal> line with no addresses may be specified, but using the <literal>[Xdmcp]</literal> <option>Enable</option> option is preferred. </para> </sect1> <sect1> -<title ->Supplementary programs</title> +<title>Supplementary programs</title> -<para ->The following programs are run by &tdm; at various stages of a session. They typically are shell scripts. </para> +<para>The following programs are run by &tdm; at various stages of a session. They typically are shell scripts. </para> -<para ->The Setup, Startup and Reset programs are run as <systemitem class="username" ->root</systemitem ->, so they should be careful about security. Their first argument is <literal ->auto</literal -> if the session results from an automatic login; otherwise, no arguments are passed to them. </para> +<para>The Setup, Startup and Reset programs are run as <systemitem class="username">root</systemitem>, so they should be careful about security. Their first argument is <literal>auto</literal> if the session results from an automatic login; otherwise, no arguments are passed to them. </para> <sect2 id="tdmrc-xsetup"> -<title ->Setup program</title> - -<para ->The <filename ->Xsetup</filename -> program is run after the &X-Server; is started or reset, but before the greeter is offered. This is the place to change the root background (if <option ->UseBackground</option -> is disabled) or bring up other windows that should appear on the screen along with the greeter. </para> - -<para ->In addition to any specified by <option ->ExportList</option ->, the following environment variables are passed:</para> +<title>Setup program</title> + +<para>The <filename>Xsetup</filename> program is run after the &X-Server; is started or reset, but before the greeter is offered. This is the place to change the root background (if <option>UseBackground</option> is disabled) or bring up other windows that should appear on the screen along with the greeter. </para> + +<para>In addition to any specified by <option>ExportList</option>, the following environment variables are passed:</para> <variablelist> <varlistentry> - <term ->DISPLAY</term> - <listitem -><para ->the associated display name</para -></listitem> + <term>DISPLAY</term> + <listitem><para>the associated display name</para></listitem> </varlistentry> <varlistentry> - <term ->PATH</term> - <listitem -><para ->the value of <option ->SystemPath</option -></para -></listitem> + <term>PATH</term> + <listitem><para>the value of <option>SystemPath</option></para></listitem> </varlistentry> <varlistentry> - <term ->SHELL</term> - <listitem -><para ->the value of <option ->SystemShell</option -></para -></listitem> + <term>SHELL</term> + <listitem><para>the value of <option>SystemShell</option></para></listitem> </varlistentry> <varlistentry> - <term ->XAUTHORITY</term> - <listitem -><para ->may be set to an authority file</para -></listitem> + <term>XAUTHORITY</term> + <listitem><para>may be set to an authority file</para></listitem> </varlistentry> <varlistentry> - <term ->DM_CONTROL</term> - <listitem -><para ->the value of <option ->FifoDir</option -></para -></listitem> + <term>DM_CONTROL</term> + <listitem><para>the value of <option>FifoDir</option></para></listitem> </varlistentry> </variablelist> -<para ->Note that since &tdm; grabs the keyboard, any other windows will not be able to receive keyboard input. They will be able to interact with the mouse, however; beware of potential security holes here. If <option ->GrabServer</option -> is set, <filename ->Xsetup</filename -> will not be able to connect to the display at all. Resources for this program can be put into the file named by <option ->Resources</option ->. </para> +<para>Note that since &tdm; grabs the keyboard, any other windows will not be able to receive keyboard input. They will be able to interact with the mouse, however; beware of potential security holes here. If <option>GrabServer</option> is set, <filename>Xsetup</filename> will not be able to connect to the display at all. Resources for this program can be put into the file named by <option>Resources</option>. </para> </sect2> <sect2 id="tdmrc-xstartup"> -<title ->Startup program</title> - -<para ->The <filename ->Xstartup</filename -> program is run as <systemitem class="username" ->root</systemitem -> when the user logs in. This is the place to put commands which add entries to <filename ->utmp</filename -> (the <command ->sessreg</command -> program may be useful here), mount users' home directories from file servers, or abort the session if some requirements are not met (but note that on modern systems, many of these tasks are already taken care of by <acronym ->PAM</acronym -> modules).</para> - -<para ->In addition to any specified by <option ->ExportList</option ->, the following environment variables are passed:</para> +<title>Startup program</title> + +<para>The <filename>Xstartup</filename> program is run as <systemitem class="username">root</systemitem> when the user logs in. This is the place to put commands which add entries to <filename>utmp</filename> (the <command>sessreg</command> program may be useful here), mount users' home directories from file servers, or abort the session if some requirements are not met (but note that on modern systems, many of these tasks are already taken care of by <acronym>PAM</acronym> modules).</para> + +<para>In addition to any specified by <option>ExportList</option>, the following environment variables are passed:</para> <variablelist> <varlistentry> - <term ->DISPLAY</term> - <listitem -><para ->the associated display name</para -></listitem> + <term>DISPLAY</term> + <listitem><para>the associated display name</para></listitem> </varlistentry> <varlistentry> - <term ->HOME</term> - <listitem -><para ->the initial working directory of the user</para -></listitem> + <term>HOME</term> + <listitem><para>the initial working directory of the user</para></listitem> </varlistentry> <varlistentry> - <term ->LOGNAME</term> - <listitem -><para ->the username</para -></listitem> + <term>LOGNAME</term> + <listitem><para>the username</para></listitem> </varlistentry> <varlistentry> - <term ->USER</term> - <listitem -><para ->the username</para -></listitem> + <term>USER</term> + <listitem><para>the username</para></listitem> </varlistentry> <varlistentry> - <term ->PATH</term> - <listitem -><para ->the value of <option ->SystemPath</option -></para -></listitem> + <term>PATH</term> + <listitem><para>the value of <option>SystemPath</option></para></listitem> </varlistentry> <varlistentry> - <term ->SHELL</term> - <listitem -><para ->the value of <option ->SystemShell</option -></para -></listitem> + <term>SHELL</term> + <listitem><para>the value of <option>SystemShell</option></para></listitem> </varlistentry> <varlistentry> - <term ->XAUTHORITY</term> - <listitem -><para ->may be set to an authority file</para -></listitem> + <term>XAUTHORITY</term> + <listitem><para>may be set to an authority file</para></listitem> </varlistentry> <varlistentry> - <term ->DM_CONTROL</term> - <listitem -><para ->the value of <option ->FifoDir</option -></para -></listitem> + <term>DM_CONTROL</term> + <listitem><para>the value of <option>FifoDir</option></para></listitem> </varlistentry> </variablelist> -<para ->&tdm; waits until this program exits before starting the user session. If the exit value of this program is non-zero, &tdm; discontinues the session and starts another authentication cycle.</para> +<para>&tdm; waits until this program exits before starting the user session. If the exit value of this program is non-zero, &tdm; discontinues the session and starts another authentication cycle.</para> </sect2> <sect2 id="tdmrc-xsession"> -<title ->Session program</title> - -<para ->The <filename ->Xsession</filename -> program is the command which is run as the user's session. It is run with the permissions of the authorised user. One of the keywords <literal ->failsafe</literal ->, <literal ->default</literal -> or <literal ->custom</literal ->, or a string to <command ->eval</command -> by a Bourne-compatible shell is passed as the first argument.</para> - -<para ->In addition to any specified by <option ->ExportList</option ->, the following environment variables are passed:</para> +<title>Session program</title> + +<para>The <filename>Xsession</filename> program is the command which is run as the user's session. It is run with the permissions of the authorised user. One of the keywords <literal>failsafe</literal>, <literal>default</literal> or <literal>custom</literal>, or a string to <command>eval</command> by a Bourne-compatible shell is passed as the first argument.</para> + +<para>In addition to any specified by <option>ExportList</option>, the following environment variables are passed:</para> <variablelist> <varlistentry> - <term ->DISPLAY</term> - <listitem -><para ->the associated display name</para -></listitem> + <term>DISPLAY</term> + <listitem><para>the associated display name</para></listitem> </varlistentry> <varlistentry> - <term ->HOME</term> - <listitem -><para ->the initial working directory of the user</para -></listitem> + <term>HOME</term> + <listitem><para>the initial working directory of the user</para></listitem> </varlistentry> <varlistentry> - <term ->LOGNAME</term> - <listitem -><para ->the username</para -></listitem> + <term>LOGNAME</term> + <listitem><para>the username</para></listitem> </varlistentry> <varlistentry> - <term ->USER</term> - <listitem -><para ->the username</para -></listitem> + <term>USER</term> + <listitem><para>the username</para></listitem> </varlistentry> <varlistentry> - <term ->PATH</term> - <listitem -><para ->the value of <option ->UserPath</option -> (or <option ->SystemPath</option -> for <systemitem class="username" ->root</systemitem -> user sessions)</para> + <term>PATH</term> + <listitem><para>the value of <option>UserPath</option> (or <option>SystemPath</option> for <systemitem class="username">root</systemitem> user sessions)</para> </listitem> </varlistentry> <varlistentry> - <term ->SHELL</term> - <listitem -><para ->the user's default shell</para -></listitem> + <term>SHELL</term> + <listitem><para>the user's default shell</para></listitem> </varlistentry> <varlistentry> - <term ->XAUTHORITY</term> - <listitem -><para ->may be set to a non-standard authority file</para -></listitem> + <term>XAUTHORITY</term> + <listitem><para>may be set to a non-standard authority file</para></listitem> </varlistentry> <varlistentry> - <term ->KRBTKFILE</term> - <listitem -><para ->may be set to a Kerberos4 credentials cache name</para> + <term>KRBTKFILE</term> + <listitem><para>may be set to a Kerberos4 credentials cache name</para> </listitem> </varlistentry> <varlistentry> - <term ->KRB5CCNAME</term> - <listitem -><para ->may be set to a Kerberos5 credentials cache name</para> + <term>KRB5CCNAME</term> + <listitem><para>may be set to a Kerberos5 credentials cache name</para> </listitem> </varlistentry> <varlistentry> - <term ->DM_CONTROL</term> - <listitem -><para ->the value of <option ->FifoDir</option -></para -></listitem> + <term>DM_CONTROL</term> + <listitem><para>the value of <option>FifoDir</option></para></listitem> </varlistentry> <varlistentry> - <term ->XDM_MANAGED</term> - <listitem -><para ->will contain a comma-separated list of parameters the session might find interesting, like the location of the command <acronym ->FiFo</acronym -> and its capabilities, and which conversation plugin was used for the login</para> + <term>XDM_MANAGED</term> + <listitem><para>will contain a comma-separated list of parameters the session might find interesting, like the location of the command <acronym>FiFo</acronym> and its capabilities, and which conversation plugin was used for the login</para> </listitem> </varlistentry> <varlistentry> - <term ->DESKTOP_SESSION</term> - <listitem -><para ->the name of the session the user has chosen to run</para> + <term>DESKTOP_SESSION</term> + <listitem><para>the name of the session the user has chosen to run</para> </listitem> </varlistentry> </variablelist> @@ -3191,28 +1419,11 @@ </sect2> <sect2 id="tdmrc-xreset"> -<title ->Reset program</title> - -<para ->Symmetrical with <filename ->Xstartup</filename ->, the <filename ->Xreset</filename -> program is run after the user session has terminated. Run as <systemitem class="username" ->root</systemitem ->, it should contain commands that undo the effects of commands in <filename ->Xstartup</filename ->, removing entries from <filename ->utmp</filename -> or unmounting directories from file servers.</para> - -<para ->The environment variables that were passed to <filename ->Xstartup</filename -> are also passed to <filename ->Xreset</filename ->. </para> +<title>Reset program</title> + +<para>Symmetrical with <filename>Xstartup</filename>, the <filename>Xreset</filename> program is run after the user session has terminated. Run as <systemitem class="username">root</systemitem>, it should contain commands that undo the effects of commands in <filename>Xstartup</filename>, removing entries from <filename>utmp</filename> or unmounting directories from file servers.</para> + +<para>The environment variables that were passed to <filename>Xstartup</filename> are also passed to <filename>Xreset</filename>. </para> </sect2> diff --git a/tde-i18n-en_GB/docs/tdebase/userguide/about-desktop.docbook b/tde-i18n-en_GB/docs/tdebase/userguide/about-desktop.docbook index 26670ccb6c1..6609f70e907 100644 --- a/tde-i18n-en_GB/docs/tdebase/userguide/about-desktop.docbook +++ b/tde-i18n-en_GB/docs/tdebase/userguide/about-desktop.docbook @@ -1,567 +1,243 @@ <chapter id="all-about-your-desktop"> -<title ->All About Your Desktop</title> +<title>All About Your Desktop</title> <epigraph> -<attribution ->Little Red Riding Hood</attribution> -<para ->Grandma, what big eyes you have!</para> +<attribution>Little Red Riding Hood</attribution> +<para>Grandma, what big eyes you have!</para> </epigraph> <epigraph> -<attribution ->The Wolf</attribution> -<para ->The better to see you!</para> +<attribution>The Wolf</attribution> +<para>The better to see you!</para> </epigraph> -<para ->The more you see, the more efficiently you can use your desktop. &kde; gives you the opportunity to make the desktop look and work the way you prefer, enabling you to work faster and more productively. It even gives you the opportunity to be warned if a wolf is trying to eat you, or (if you happen to be a granny) alert you when Little Red Riding Hood is on her way to bring you the goodies. Now that's service. </para> +<para>The more you see, the more efficiently you can use your desktop. &kde; gives you the opportunity to make the desktop look and work the way you prefer, enabling you to work faster and more productively. It even gives you the opportunity to be warned if a wolf is trying to eat you, or (if you happen to be a granny) alert you when Little Red Riding Hood is on her way to bring you the goodies. Now that's service. </para> <sect1 id="the-autostart-folder"> -<title ->Autostarting Applications</title> +<title>Autostarting Applications</title> -<para ->Native &kde; programs and many third party applications left open at the end of a session will save their state and reappear when you login again, but there are some programs (like some versions of &Netscape;) that will not. You can use the <filename ->Autostart</filename -> folder for these programs.</para> +<para>Native &kde; programs and many third party applications left open at the end of a session will save their state and reappear when you login again, but there are some programs (like some versions of &Netscape;) that will not. You can use the <filename>Autostart</filename> folder for these programs.</para> -<para ->To launch programs when &kde; is started, do the following:</para> +<para>To launch programs when &kde; is started, do the following:</para> <procedure> <step> -<para ->Open the <filename ->Autostart</filename -> folder. By default this folder is at <filename class="directory" ->$<envar ->HOME</envar ->/.trinity/Autostart</filename -></para> +<para>Open the <filename>Autostart</filename> folder. By default this folder is at <filename class="directory">$<envar>HOME</envar>/.trinity/Autostart</filename></para> </step> <step> -<para ->Open a &konqueror; window and browse to the program you want to add. If you do not know how to do this, it was covered in <xref linkend="the-filemanager-screen"/>.</para> +<para>Open a &konqueror; window and browse to the program you want to add. If you do not know how to do this, it was covered in <xref linkend="the-filemanager-screen"/>.</para> </step> <step> -<para ->Drag and drop the desired program from the &konqueror; window on to the <filename class="directory" ->Autostart</filename -> folder. When asked, choose <guimenuitem ->Link</guimenuitem -> to create a symbolic link rather than a full copy, as this saves a great deal of disk space.</para> +<para>Drag and drop the desired program from the &konqueror; window on to the <filename class="directory">Autostart</filename> folder. When asked, choose <guimenuitem>Link</guimenuitem> to create a symbolic link rather than a full copy, as this saves a great deal of disk space.</para> </step> <step> -<para ->Repeat the above steps for every program you want started when &kde; is launched. Remember, you do not need to add native &kde; applications, just leave them open when you log out, and they will open up again as if nothing had happened the next time you log in to &kde;.</para> +<para>Repeat the above steps for every program you want started when &kde; is launched. Remember, you do not need to add native &kde; applications, just leave them open when you log out, and they will open up again as if nothing had happened the next time you log in to &kde;.</para> </step> <step> -<para ->Restart &kde; if you want to see the autostart function in action.</para> +<para>Restart &kde; if you want to see the autostart function in action.</para> </step> </procedure> -<para ->Your programs should have launched automatically when &kde; restarted.</para> +<para>Your programs should have launched automatically when &kde; restarted.</para> -<para ->Do not forget though that you will only need the Autostart folder for a few applications. Many applications, including almost all native &kde; applications, now understand session management, and you can simply leave them open when you log out in order for them to be restarted exactly as you left them. You can leave a &konqueror; window open with your favourite website, &kmail; looking at your inbox, and &kate; with a half dozen files open, log out, log back in, and find your desktop exactly as you left it.</para> +<para>Do not forget though that you will only need the Autostart folder for a few applications. Many applications, including almost all native &kde; applications, now understand session management, and you can simply leave them open when you log out in order for them to be restarted exactly as you left them. You can leave a &konqueror; window open with your favourite website, &kmail; looking at your inbox, and &kate; with a half dozen files open, log out, log back in, and find your desktop exactly as you left it.</para> </sect1> <sect1 id="adding-programs"> -<title ->Adding Programs and Shortcut Icons to Your &kmenu; and Panel</title> +<title>Adding Programs and Shortcut Icons to Your &kmenu; and Panel</title> -<para ->The &kde; &kmenu; and &kicker; are not limited to the setup you find right after installing &kde;. The &kde; panel is designed to be extended, and there are two main ways of doing that: Adding new programs, and adding shortcut icons.</para> +<para>The &kde; &kmenu; and &kicker; are not limited to the setup you find right after installing &kde;. The &kde; panel is designed to be extended, and there are two main ways of doing that: Adding new programs, and adding shortcut icons.</para> <sect2 id="menu-items-add"> -<title ->Adding menu entries</title> - -<para ->&kde; comes with a great many applications already in the menu. Depending on your operating system and distribution, this could include many non-&kde; applications. &kde; also includes an application that will search your hard drive for more applications, and add them to the menu for you. Try pressing <keycombo action="simul" ->&Alt;<keycap ->F2</keycap -></keycombo -> and entering <userinput ->kappfinder</userinput -> to see it in action — operation is very straightforward.</para> - -<para ->&kappfinder; is clever enough, but it doesn't know about every application there is. Or perhaps you simply don't want to have all those applications in the menu, and just want to add a single extra program.</para> - -<para ->To add your favourite programs to the &kde; menu, you can use the <application ->KDE Menu Editor</application ->. To start it, use the &kmenu; and choose <menuchoice -><guimenuitem ->Settings</guimenuitem -><guimenuitem ->Menu Editor</guimenuitem -></menuchoice ->.</para> - -<para ->A window will open showing the existing &kmenu; on the left, and an empty menu entry dialogue on the right</para> - -<para ->For this example, we will be adding an entry for the <application ->Gimp</application -> under the <guisubmenu ->Graphics</guisubmenu -> submenu. If you already have a <guimenuitem ->Gimp</guimenuitem -> entry there and don't want a new one, you can still follow through this example, but just don't click the <guibutton ->Apply</guibutton -> when you are done.</para> +<title>Adding menu entries</title> + +<para>&kde; comes with a great many applications already in the menu. Depending on your operating system and distribution, this could include many non-&kde; applications. &kde; also includes an application that will search your hard drive for more applications, and add them to the menu for you. Try pressing <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> and entering <userinput>kappfinder</userinput> to see it in action — operation is very straightforward.</para> + +<para>&kappfinder; is clever enough, but it doesn't know about every application there is. Or perhaps you simply don't want to have all those applications in the menu, and just want to add a single extra program.</para> + +<para>To add your favourite programs to the &kde; menu, you can use the <application>KDE Menu Editor</application>. To start it, use the &kmenu; and choose <menuchoice><guimenuitem>Settings</guimenuitem><guimenuitem>Menu Editor</guimenuitem></menuchoice>.</para> + +<para>A window will open showing the existing &kmenu; on the left, and an empty menu entry dialogue on the right</para> + +<para>For this example, we will be adding an entry for the <application>Gimp</application> under the <guisubmenu>Graphics</guisubmenu> submenu. If you already have a <guimenuitem>Gimp</guimenuitem> entry there and don't want a new one, you can still follow through this example, but just don't click the <guibutton>Apply</guibutton> when you are done.</para> <procedure> -<step -><para ->Navigate down the left hand tree to the <guisubmenu ->Graphics</guisubmenu -> entry.</para -></step> +<step><para>Navigate down the left hand tree to the <guisubmenu>Graphics</guisubmenu> entry.</para></step> <step> -<para ->Click on it once with the <mousebutton ->left</mousebutton -> mouse button to expand the entry.</para> +<para>Click on it once with the <mousebutton>left</mousebutton> mouse button to expand the entry.</para> </step> <step> -<para ->Click the icon labelled <guiicon ->New Item</guiicon -> in the toolbar, or choose <menuchoice -><guimenu ->File</guimenu -><guimenuitem ->New Item</guimenuitem -></menuchoice -> in the menu bar.</para> +<para>Click the icon labelled <guiicon>New Item</guiicon> in the toolbar, or choose <menuchoice><guimenu>File</guimenu><guimenuitem>New Item</guimenuitem></menuchoice> in the menu bar.</para> </step> <step> -<para ->In the dialogue box that pops up, enter the name you want your new menu entry to have. For this example, enter <userinput ->Gimp</userinput ->.</para -><para ->Then press <guibutton ->OK</guibutton -> in the dialogue.</para> +<para>In the dialogue box that pops up, enter the name you want your new menu entry to have. For this example, enter <userinput>Gimp</userinput>.</para><para>Then press <guibutton>OK</guibutton> in the dialogue.</para> </step> <step> -<para ->Click on the new <guimenuitem ->Gimp</guimenuitem -> menu entry that was created for you under the <guisubmenu ->Graphics</guisubmenu -> submenu. The menu entry dialogue to the right will now change to be mostly empty, except for the name you already gave.</para> +<para>Click on the new <guimenuitem>Gimp</guimenuitem> menu entry that was created for you under the <guisubmenu>Graphics</guisubmenu> submenu. The menu entry dialogue to the right will now change to be mostly empty, except for the name you already gave.</para> </step> <step> -<para ->Fill in an optional <guilabel ->Comment</guilabel ->. You might like to put <userinput ->An image editor</userinput -> for the example. Text entered here will be shown as a tool-tip in the &kmenu;.</para> +<para>Fill in an optional <guilabel>Comment</guilabel>. You might like to put <userinput>An image editor</userinput> for the example. Text entered here will be shown as a tool-tip in the &kmenu;.</para> </step> <step> -<para ->Enter in the box labelled <guilabel ->Command</guilabel ->, the command you would type on the command line to open your application. For this example, this is <command ->gimp</command ->. You may also enter any optional command line parameters if you wish. You can use this to make a menu entry that always opens a particular document or image, for example. Check the application's documentation to find out more about command line parameters.</para> +<para>Enter in the box labelled <guilabel>Command</guilabel>, the command you would type on the command line to open your application. For this example, this is <command>gimp</command>. You may also enter any optional command line parameters if you wish. You can use this to make a menu entry that always opens a particular document or image, for example. Check the application's documentation to find out more about command line parameters.</para> </step> <step> -<para ->If you want the application to operate from a particular folder (for example, for <application ->Gimp</application -> to begin its <guilabel ->Load Image</guilabel -> dialogue in a particular place) enter this path in the box labelled <guilabel ->Work Path</guilabel ->. This is optional.</para> +<para>If you want the application to operate from a particular folder (for example, for <application>Gimp</application> to begin its <guilabel>Load Image</guilabel> dialogue in a particular place) enter this path in the box labelled <guilabel>Work Path</guilabel>. This is optional.</para> </step> <step> -<para ->If you wish to change the icon from the default <quote ->unknown</quote ->, click on the <guiicon ->icon</guiicon -> to the right of the dialogue, to open a standard &kde; icon chooser.</para> +<para>If you wish to change the icon from the default <quote>unknown</quote>, click on the <guiicon>icon</guiicon> to the right of the dialogue, to open a standard &kde; icon chooser.</para> </step> <step> -<para ->Some applications must be <guilabel ->run in a terminal</guilabel -> window (for example <application ->Pine</application ->). If this is the case, check the appropriate check box.</para> +<para>Some applications must be <guilabel>run in a terminal</guilabel> window (for example <application>Pine</application>). If this is the case, check the appropriate check box.</para> </step> <step> -<para ->If you want to run your application as a different user, check the box labelled <guilabel ->Run as a different user</guilabel -> and enter the appropriate user name in the text box.</para> +<para>If you want to run your application as a different user, check the box labelled <guilabel>Run as a different user</guilabel> and enter the appropriate user name in the text box.</para> </step> <step> -<para ->If you're happy with your menu entry, press <guibutton ->Apply</guibutton ->. If you would like to start over, press <guibutton ->Reset</guibutton ->.</para> +<para>If you're happy with your menu entry, press <guibutton>Apply</guibutton>. If you would like to start over, press <guibutton>Reset</guibutton>.</para> </step> </procedure> -<para ->And that's all. You now have a new menu entry.</para> +<para>And that's all. You now have a new menu entry.</para> </sect2> <sect2 id="icons-add"> -<title ->Shortcut Icons</title> +<title>Shortcut Icons</title> -<para ->Although &kde; is much more comfortable than the average &UNIX; window manager, everyone wants a solution for a one-click way to start a program. Later, you will learn how to create links and files on your desktop, but this also has some disadvantages: sometimes all your desktops are filled up with windows, and you cannot reach your icons without minimising all the windows that cover them. For commonly used programs, you can minimise this problem and speed access by creating shortcut icons on the &kde; panel.</para> +<para>Although &kde; is much more comfortable than the average &UNIX; window manager, everyone wants a solution for a one-click way to start a program. Later, you will learn how to create links and files on your desktop, but this also has some disadvantages: sometimes all your desktops are filled up with windows, and you cannot reach your icons without minimising all the windows that cover them. For commonly used programs, you can minimise this problem and speed access by creating shortcut icons on the &kde; panel.</para> -<para ->To create a shortcut on the &kicker; panel, you have some choices: Drag-and-drop, or via a menu. </para> +<para>To create a shortcut on the &kicker; panel, you have some choices: Drag-and-drop, or via a menu. </para> <procedure> -<title ->Adding a shortcut icon with the menu</title> -<step -><para ->Click on the &ticon; and choose <menuchoice -><guisubmenu ->Panel Menu</guisubmenu -><guisubmenu ->Add</guisubmenu -><guimenuitem ->Application</guimenuitem -> </menuchoice ->.</para -></step> -<step -><para ->You will see the top level of the &kmenu; again. Go through the menus to find the entry for which you want to create the shortcut, such as <guimenuitem ->Home folder</guimenuitem -> or &konqueror;. Click on the program you want.</para> +<title>Adding a shortcut icon with the menu</title> +<step><para>Click on the &ticon; and choose <menuchoice><guisubmenu>Panel Menu</guisubmenu><guisubmenu>Add</guisubmenu><guimenuitem>Application</guimenuitem> </menuchoice>.</para></step> +<step><para>You will see the top level of the &kmenu; again. Go through the menus to find the entry for which you want to create the shortcut, such as <guimenuitem>Home folder</guimenuitem> or &konqueror;. Click on the program you want.</para> </step> </procedure> -<para ->A new icon will appear on the panel. Click on it, and the program will start.</para> +<para>A new icon will appear on the panel. Click on it, and the program will start.</para> -<para ->Adding a shortcut icon with drag-and-drop is even simpler - just drag any icon from your desktop, or a &konqueror; window, to an empty space on the panel.</para> +<para>Adding a shortcut icon with drag-and-drop is even simpler - just drag any icon from your desktop, or a &konqueror; window, to an empty space on the panel.</para> -<para ->What happens when you drag an item to your panel depends on what kind of item it is:</para> +<para>What happens when you drag an item to your panel depends on what kind of item it is:</para> <variablelist> <varlistentry> -<term ->If you drag a folder...</term -> <listitem -><para ->A menu will pop up giving you a choice of <guimenuitem ->Add as a File Manager URL</guimenuitem -> or <guimenuitem ->Add as a QuickBrowser</guimenuitem ->. Choosing the first will create an icon that opens a &konqueror; window, starting at this folder, while choosing the latter will open that folder as a menu from the Panel.</para -></listitem> +<term>If you drag a folder...</term> <listitem><para>A menu will pop up giving you a choice of <guimenuitem>Add as a File Manager URL</guimenuitem> or <guimenuitem>Add as a QuickBrowser</guimenuitem>. Choosing the first will create an icon that opens a &konqueror; window, starting at this folder, while choosing the latter will open that folder as a menu from the Panel.</para></listitem> </varlistentry> <varlistentry> -<term ->If you drag a shortcut from your desktop...</term> -<listitem -><para ->It will be copied to the panel.</para -></listitem> +<term>If you drag a shortcut from your desktop...</term> +<listitem><para>It will be copied to the panel.</para></listitem> </varlistentry> <varlistentry> -<term ->If you drag a document...</term> -<listitem -><para ->A link will be made on the panel, leaving the original in place. Clicking on the resulting icon will open that document in the default application.</para -></listitem> +<term>If you drag a document...</term> +<listitem><para>A link will be made on the panel, leaving the original in place. Clicking on the resulting icon will open that document in the default application.</para></listitem> </varlistentry> </variablelist> -<para ->In any case, if you want to move the icon, click on it using the &RMB; and choose <guimenuitem ->Move <replaceable ->Name of Button</replaceable -></guimenuitem -> Move the icon to the position you want and press the &LMB;. If you wish to remove the icon, click on it using the &RMB; and choose <guimenuitem ->Remove <replaceable ->Name of Button</replaceable -></guimenuitem ->.</para> +<para>In any case, if you want to move the icon, click on it using the &RMB; and choose <guimenuitem>Move <replaceable>Name of Button</replaceable></guimenuitem> Move the icon to the position you want and press the &LMB;. If you wish to remove the icon, click on it using the &RMB; and choose <guimenuitem>Remove <replaceable>Name of Button</replaceable></guimenuitem>.</para> </sect2> </sect1> <sect1 id="creating-new-files-on-your-desktop"> -<title ->Creating New Files On Your Desktop</title> +<title>Creating New Files On Your Desktop</title> -<para ->Your desktop can be an efficient place to work. Every time you start &kde;, you can see the complete files, folders and &URL;s which you often use.</para> +<para>Your desktop can be an efficient place to work. Every time you start &kde;, you can see the complete files, folders and &URL;s which you often use.</para> -<para ->There are two ways to create and edit files on your desktop. In any application, you can say that you want to save your work in the Desktop subfolder of your home folder. For example, my home folder is <filename class="directory" ->/home/stupiddog</filename ->, so my Desktop folder is <filename class="directory" ->/home/stupiddog/Desktop</filename ->. Everything you save there will be put on your desktop.</para> +<para>There are two ways to create and edit files on your desktop. In any application, you can say that you want to save your work in the Desktop subfolder of your home folder. For example, my home folder is <filename class="directory">/home/stupiddog</filename>, so my Desktop folder is <filename class="directory">/home/stupiddog/Desktop</filename>. Everything you save there will be put on your desktop.</para> -<para ->If you want to move existing files to your Desktop, the best way to achieve this is to use &konqueror;. Open a file manager window and drag the files you need to your desktop. You can choose to copy them if you want to keep all your common stuff on the desktop now, or you can create symbolic links to the real files. Everything you change in the link files will be automatically updated in the originals. For more information on how to use drag & drop and the file manager, see the chapter <link linkend="moving-files-with-drag-and-drop" ->Moving files with drag & drop.</link -></para> +<para>If you want to move existing files to your Desktop, the best way to achieve this is to use &konqueror;. Open a file manager window and drag the files you need to your desktop. You can choose to copy them if you want to keep all your common stuff on the desktop now, or you can create symbolic links to the real files. Everything you change in the link files will be automatically updated in the originals. For more information on how to use drag & drop and the file manager, see the chapter <link linkend="moving-files-with-drag-and-drop">Moving files with drag & drop.</link></para> </sect1> <sect1 id="desktop-links"> -<title ->Placing Links on Your Desktop</title> +<title>Placing Links on Your Desktop</title> -<para ->Placing files on your desktop may shorten the paths you need to enter. However, sometimes it would be nice if you could start &kedit; with a commonly edited file already opened in it. And how often do you find yourself frustrated after browsing through endless lists of bookmarks to find a site you visit often? Wouldn't it be nice if everything necessary to deliver you to that site was done automatically after clicking a single icon?</para> +<para>Placing files on your desktop may shorten the paths you need to enter. However, sometimes it would be nice if you could start &kedit; with a commonly edited file already opened in it. And how often do you find yourself frustrated after browsing through endless lists of bookmarks to find a site you visit often? Wouldn't it be nice if everything necessary to deliver you to that site was done automatically after clicking a single icon?</para> <!-- <sect2 id="using-mimetype"> -<title ->Using Templates</title> +<title>Using Templates</title> -<para ->Templates provide a convenient mechanism for performing tasks +<para>Templates provide a convenient mechanism for performing tasks such as those outlined above. Templates can also be used to associate particular file extensions with a specific application. When a file ending in a known extension is double-clicked, the application associated with that extension is automatically started. In short, -<emphasis ->templates</emphasis -> help you get the most out of +<emphasis>templates</emphasis> help you get the most out of &kde;.</para> -<para ->Example: You want to put an icon for visiting the &kde; web site +<para>Example: You want to put an icon for visiting the &kde; web site on your desktop.</para> <procedure> -<step -><para -><mousebutton ->Right</mousebutton -> click on an empty space -in the desktop.</para -></step -> <step -><para ->Choose -<menuchoice -><guisubmenu ->Create -New</guisubmenu -><guisubmenu ->File</guisubmenu -><guimenuitem ->Link to -Location (URL)</guimenuitem -></menuchoice -> from the context -menu.</para -></step -> <step -><para ->A dialog box will open where you can -type in the address you are making a shortcut to.</para -></step> -<step -><para ->A new icon will be created on your desktop.</para -></step> +<step><para><mousebutton>Right</mousebutton> click on an empty space +in the desktop.</para></step> <step><para>Choose +<menuchoice><guisubmenu>Create +New</guisubmenu><guisubmenu>File</guisubmenu><guimenuitem>Link to +Location (URL)</guimenuitem></menuchoice> from the context +menu.</para></step> <step><para>A dialog box will open where you can +type in the address you are making a shortcut to.</para></step> +<step><para>A new icon will be created on your desktop.</para></step> </procedure> -<para ->Your new Internet shortcut can be customized like any other -shortcut icon. <mousebutton ->Right</mousebutton -> click on the icon and -choose <guimenuitem ->Properties</guimenuitem ->, and you can change the +<para>Your new Internet shortcut can be customized like any other +shortcut icon. <mousebutton>Right</mousebutton> click on the icon and +choose <guimenuitem>Properties</guimenuitem>, and you can change the icon, or the name of the shortcut as you wish.</para> </sect2> --> <sect2> -<title ->Using &MIME; Types and File Associations</title> - -<para ->&MIME; Types are very powerful. Employing them, you can easily customise your system such that clicking on a file of a specific type starts the application with which that file type has been associated. For example, all <literal role="extension" ->.mod</literal -> files could be set to start &noatun;, <literal role="extension" ->.html</literal -> files could open a &konqueror; window showing the file, and a <filename ->core</filename -> file can be viewed with the &khexedit; by simply clicking on the <filename ->core</filename -> file.</para> +<title>Using &MIME; Types and File Associations</title> + +<para>&MIME; Types are very powerful. Employing them, you can easily customise your system such that clicking on a file of a specific type starts the application with which that file type has been associated. For example, all <literal role="extension">.mod</literal> files could be set to start &noatun;, <literal role="extension">.html</literal> files could open a &konqueror; window showing the file, and a <filename>core</filename> file can be viewed with the &khexedit; by simply clicking on the <filename>core</filename> file.</para> <warning> -<para ->Although &MIME; types are very powerful, they are not without dangers. Playing around with &MIME; types as the system administrator (<systemitem class="username" ->root</systemitem ->) can damage a &kde; system so severely that it cannot be restarted! In this example, you will create your <emphasis ->personal</emphasis -> &MIME; style, which is only relevant for you. It will only affect other users if you copy or move it to <filename class="directory" ->$<envar ->TDEDIR</envar ->/share/mimelnk</filename ->.</para> +<para>Although &MIME; types are very powerful, they are not without dangers. Playing around with &MIME; types as the system administrator (<systemitem class="username">root</systemitem>) can damage a &kde; system so severely that it cannot be restarted! In this example, you will create your <emphasis>personal</emphasis> &MIME; style, which is only relevant for you. It will only affect other users if you copy or move it to <filename class="directory">$<envar>TDEDIR</envar>/share/mimelnk</filename>.</para> </warning> -<para ->To link a certain file type with a particular application:</para> +<para>To link a certain file type with a particular application:</para> <procedure> -<step -><para ->Make sure the application you want to start this file type has an entry in the &kmenu;.</para -></step> - -<step -><para ->In &konqueror; find or make a file with the extension you wish to link.</para -></step> - -<step -><para -><mousebutton ->Right</mousebutton -> click on the file, and choose <guimenuitem ->Properties</guimenuitem -> from the context menu and then press the tiny button with an icon next to the <guilabel ->Type</guilabel -> resulting properties dialogue. Or, choose <menuchoice -><guimenu ->Edit</guimenu -><guimenuitem ->Edit File Type...</guimenuitem -></menuchoice -> in the &konqueror; menu bar.</para -></step> - -<step -><para ->Add file masks for the application by clicking the <guibutton ->Add</guibutton -> button, and entering the file pattern you want. Remember that &UNIX; is case sensitive, so you may need to add variations - <userinput ->*.mp3</userinput -> may need <userinput ->*.MP3</userinput -> added as well, for example. Add as many masks as you like in this way.</para -></step> - -<step -><para ->Add a description if you like. This is optional.</para -></step> - -<step -><para ->In the section labelled <guilabel ->Application Preference Order</guilabel ->, press the <guibutton ->Add</guibutton -> button. A miniature copy of the &kmenu; will open, where you can choose the application you want files of this type to be opened with.</para -></step> - -<step -><para ->Sometimes, you may want to use a different application to open this file type. For example, you might like to use &kate; to open text files you wish to edit, and &kedit; for text files that you just want to take a quick peek into. You can add more applications in the same way as you did in the last step, and you can change the preferred order using the <guibutton ->Move Up</guibutton -> and <guibutton ->Move Down</guibutton -> buttons.</para -></step> - -<step -><para ->If you're satisfied with your choices, you can click the <guibutton ->Apply</guibutton -> button to save your changes without closing the dialogue box. This gives you the opportunity to test in the &konqueror; window that your file association is correct. You can choose <guibutton ->OK</guibutton -> to save your changes and close the dialogue box, or <guibutton ->Cancel</guibutton -> if you have changed your mind and just want to close the dialogue box.</para -></step> +<step><para>Make sure the application you want to start this file type has an entry in the &kmenu;.</para></step> + +<step><para>In &konqueror; find or make a file with the extension you wish to link.</para></step> + +<step><para><mousebutton>Right</mousebutton> click on the file, and choose <guimenuitem>Properties</guimenuitem> from the context menu and then press the tiny button with an icon next to the <guilabel>Type</guilabel> resulting properties dialogue. Or, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Edit File Type...</guimenuitem></menuchoice> in the &konqueror; menu bar.</para></step> + +<step><para>Add file masks for the application by clicking the <guibutton>Add</guibutton> button, and entering the file pattern you want. Remember that &UNIX; is case sensitive, so you may need to add variations - <userinput>*.mp3</userinput> may need <userinput>*.MP3</userinput> added as well, for example. Add as many masks as you like in this way.</para></step> + +<step><para>Add a description if you like. This is optional.</para></step> + +<step><para>In the section labelled <guilabel>Application Preference Order</guilabel>, press the <guibutton>Add</guibutton> button. A miniature copy of the &kmenu; will open, where you can choose the application you want files of this type to be opened with.</para></step> + +<step><para>Sometimes, you may want to use a different application to open this file type. For example, you might like to use &kate; to open text files you wish to edit, and &kedit; for text files that you just want to take a quick peek into. You can add more applications in the same way as you did in the last step, and you can change the preferred order using the <guibutton>Move Up</guibutton> and <guibutton>Move Down</guibutton> buttons.</para></step> + +<step><para>If you're satisfied with your choices, you can click the <guibutton>Apply</guibutton> button to save your changes without closing the dialogue box. This gives you the opportunity to test in the &konqueror; window that your file association is correct. You can choose <guibutton>OK</guibutton> to save your changes and close the dialogue box, or <guibutton>Cancel</guibutton> if you have changed your mind and just want to close the dialogue box.</para></step> </procedure> -<para ->Be sure to try your new association by opening a folder containing a file of the type you just selected. Click on the file, and the program needed to edit it should start.</para> +<para>Be sure to try your new association by opening a folder containing a file of the type you just selected. Click on the file, and the program needed to edit it should start.</para> <note> -<para ->&MIME; types are a way of describing the contents of files. You may be used to using file extensions for that purpose, and you may know that on &UNIX; systems the file extension often bears little or no relation to the contents of the file. On the other hand, it may be vital - for example, some implementations of <command ->gunzip</command -> won't operate on files that aren't named <literal role="extension" ->.gz</literal ->. </para> - -<para ->&MIME; types naturally make use of filename patterns, but not necessarily the extensions - you can set up any filename pattern you like. For example, if you always want to open any files relating to a particular client with &kate;, and you make a habit of naming the files with the client's name at the beginning so that they naturally group in the &konqueror; window, then you can set up a filename pattern that matches <literal ->^<replaceable ->clientname</replaceable ->*</literal ->. Then any files that have <replaceable ->clientname</replaceable -> at the beginning (the <literal ->^</literal -> character means <quote ->starts with...</quote ->) will be opened with the application you choose. </para> +<para>&MIME; types are a way of describing the contents of files. You may be used to using file extensions for that purpose, and you may know that on &UNIX; systems the file extension often bears little or no relation to the contents of the file. On the other hand, it may be vital - for example, some implementations of <command>gunzip</command> won't operate on files that aren't named <literal role="extension">.gz</literal>. </para> + +<para>&MIME; types naturally make use of filename patterns, but not necessarily the extensions - you can set up any filename pattern you like. For example, if you always want to open any files relating to a particular client with &kate;, and you make a habit of naming the files with the client's name at the beginning so that they naturally group in the &konqueror; window, then you can set up a filename pattern that matches <literal>^<replaceable>clientname</replaceable>*</literal>. Then any files that have <replaceable>clientname</replaceable> at the beginning (the <literal>^</literal> character means <quote>starts with...</quote>) will be opened with the application you choose. </para> </note> </sect2> </sect1> <sect1 id="using-the-trashcan"> -<title ->Using the Trash Can</title> - -<para ->Under normal circumstances, deleting a file under &UNIX; is something which cannot be undone. However, with &kde;, you can choose <guimenuitem ->Move to Trash</guimenuitem -> instead of <guimenuitem ->Delete</guimenuitem ->. This will move the file into the <filename class="directory" ->Trash</filename -> Folder, which, by default, is accessible as an icon on your desktop. In the <filename class="directory" ->Trash</filename -> Folder, you can always recover deleted files. Remember to empty the trashcan now and then by clicking on it using the right mouse button, then choosing <guimenuitem ->Empty trashcan</guimenuitem ->, otherwise you might run out of disk space because the files still need space. Note, however, that once you empty the <filename ->Trash</filename -> Folder, the files contained therein are lost forever.</para> +<title>Using the Trash Can</title> + +<para>Under normal circumstances, deleting a file under &UNIX; is something which cannot be undone. However, with &kde;, you can choose <guimenuitem>Move to Trash</guimenuitem> instead of <guimenuitem>Delete</guimenuitem>. This will move the file into the <filename class="directory">Trash</filename> Folder, which, by default, is accessible as an icon on your desktop. In the <filename class="directory">Trash</filename> Folder, you can always recover deleted files. Remember to empty the trashcan now and then by clicking on it using the right mouse button, then choosing <guimenuitem>Empty trashcan</guimenuitem>, otherwise you might run out of disk space because the files still need space. Note, however, that once you empty the <filename>Trash</filename> Folder, the files contained therein are lost forever.</para> </sect1> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/userguide/first-impressions.docbook b/tde-i18n-en_GB/docs/tdebase/userguide/first-impressions.docbook index 3817d62f9b2..f7444d839b4 100644 --- a/tde-i18n-en_GB/docs/tdebase/userguide/first-impressions.docbook +++ b/tde-i18n-en_GB/docs/tdebase/userguide/first-impressions.docbook @@ -1,357 +1,149 @@ <chapter id="first-impressions"> -<title ->First Impressions </title> +<title>First Impressions </title> <epigraph> -<attribution ->Origin unknown</attribution> -<para ->You see to sea to see all that you can see is sea</para> +<attribution>Origin unknown</attribution> +<para>You see to sea to see all that you can see is sea</para> </epigraph> -<para ->First impressions are so important -- this is not only true for Agatha Christie's famous thriller <quote ->The Mousetrap</quote -> -- but also for &kde;. As we mentioned before, &kde; is supposed to be the most intuitive, easy to learn user interface available. In fact, we will have reached our goal when users no longer need this book in order to work with &kde;, causing the authors to lose their (unpaid and voluntary) jobs as documenters. </para> +<para>First impressions are so important -- this is not only true for Agatha Christie's famous thriller <quote>The Mousetrap</quote> -- but also for &kde;. As we mentioned before, &kde; is supposed to be the most intuitive, easy to learn user interface available. In fact, we will have reached our goal when users no longer need this book in order to work with &kde;, causing the authors to lose their (unpaid and voluntary) jobs as documenters. </para> <sect1 id="starting-kde"> -<title ->Starting &kde; </title> +<title>Starting &kde; </title> -<para ->When you boot a &UNIX; system, one of three things should happen (that is, if the system works correctly; everything else is an undocumented fourth case). Either you stay in text mode and get a login prompt, you are logged into your &GUI; of choice automatically, or you are presented with a graphical login window. In the first case, you must log into your system and type: </para> +<para>When you boot a &UNIX; system, one of three things should happen (that is, if the system works correctly; everything else is an undocumented fourth case). Either you stay in text mode and get a login prompt, you are logged into your &GUI; of choice automatically, or you are presented with a graphical login window. In the first case, you must log into your system and type: </para> -<screen -><command ->startx</command -> +<screen><command>startx</command> </screen> -<para ->If the installation was successful, the &kde; desktop should appear after a few seconds of initialisation. </para> +<para>If the installation was successful, the &kde; desktop should appear after a few seconds of initialisation. </para> -<para ->If a graphical login window is presented, then all that should be required is your login name and password. Assuming the &kde; installation was successful, &kde; should start without further intervention. </para> +<para>If a graphical login window is presented, then all that should be required is your login name and password. Assuming the &kde; installation was successful, &kde; should start without further intervention. </para> -<para ->If you have not done so already, we recommend changing your X display manager from <application ->xdm</application -> to &tdm;, which includes the same functionality, but with the advanced features of the K Desktop Environment. </para> +<para>If you have not done so already, we recommend changing your X display manager from <application>xdm</application> to &tdm;, which includes the same functionality, but with the advanced features of the K Desktop Environment. </para> -<para ->If your system is configured to automatically log you into a &GUI; you will need to consult your operating system manuals or support forums for instructions how to have &kde; be that &GUI;.</para> +<para>If your system is configured to automatically log you into a &GUI; you will need to consult your operating system manuals or support forums for instructions how to have &kde; be that &GUI;.</para> </sect1> <sect1 id="desktop-components"> -<title ->Desktop Components </title> +<title>Desktop Components </title> -<para ->After everything has come up, take some time to explore the new environment. If you have already worked with <emphasis ->&Windows;</emphasis ->, <emphasis ->OS/2</emphasis -> or <emphasis ->&MacOS;</emphasis ->, many things should look familiar to you. The main visible parts of &kde; that you will see are the desktop itself, and the panel.</para> +<para>After everything has come up, take some time to explore the new environment. If you have already worked with <emphasis>&Windows;</emphasis>, <emphasis>OS/2</emphasis> or <emphasis>&MacOS;</emphasis>, many things should look familiar to you. The main visible parts of &kde; that you will see are the desktop itself, and the panel.</para> <sect2 id="kde-logout"> -<title ->Panel </title> +<title>Panel </title> -<para ->When you start &kde; for the first time, the panel is situated at the bottom of the screen. From here, you will start your programs and switch between the virtual screens. </para> +<para>When you start &kde; for the first time, the panel is situated at the bottom of the screen. From here, you will start your programs and switch between the virtual screens. </para> <variablelist> <varlistentry> -<term ->&ticon; button</term> -<listitem -><para ->The &ticon; button is one of the most important places on your &kde; desktop. From here, you can start all &kde; applications installed. Later, when you learn how to use <link linkend="adding-programs" ->the TDE Menu Editor</link ->, you can also add other programs here as well. To start a program, just click on the button. You will see a list of different categories, plus some special entries. Whenever you move your mouse over an entry that has an arrow to the right, a new menu will appear. When you find the program you want to start, just click on it with the <mousebutton ->left</mousebutton -> mouse button.</para -></listitem> +<term>&ticon; button</term> +<listitem><para>The &ticon; button is one of the most important places on your &kde; desktop. From here, you can start all &kde; applications installed. Later, when you learn how to use <link linkend="adding-programs">the TDE Menu Editor</link>, you can also add other programs here as well. To start a program, just click on the button. You will see a list of different categories, plus some special entries. Whenever you move your mouse over an entry that has an arrow to the right, a new menu will appear. When you find the program you want to start, just click on it with the <mousebutton>left</mousebutton> mouse button.</para></listitem> </varlistentry> <varlistentry> -<term ->Virtual Desktop buttons</term> -<listitem -><para ->When you start &kde; for the first time, note the four buttons labelled, appropriately enough, <guilabel ->1</guilabel ->, <guilabel ->2</guilabel ->, <guilabel ->3</guilabel -> and <guilabel ->4</guilabel ->. These represent your four <emphasis ->desktops</emphasis ->. Just click one of them. Don't worry; though they have <quote ->disappeared</quote ->, any open windows are still active (just take a look at the task list!). Using multiple desktops is one of the most powerful features of &kde; and the &X-Window;. Instead of placing one window over another, as you would when using &Windows; or OS/2, you can say <quote ->Well, on the first desktop, I will write the &kde; User Guide. On the second desktop I'll run the <command ->meinproc</command -> documentation compiler and see my results while compiling my &Linux; kernel on the third desktop, and reading my email on the fourth.</quote -> </para -></listitem> +<term>Virtual Desktop buttons</term> +<listitem><para>When you start &kde; for the first time, note the four buttons labelled, appropriately enough, <guilabel>1</guilabel>, <guilabel>2</guilabel>, <guilabel>3</guilabel> and <guilabel>4</guilabel>. These represent your four <emphasis>desktops</emphasis>. Just click one of them. Don't worry; though they have <quote>disappeared</quote>, any open windows are still active (just take a look at the task list!). Using multiple desktops is one of the most powerful features of &kde; and the &X-Window;. Instead of placing one window over another, as you would when using &Windows; or OS/2, you can say <quote>Well, on the first desktop, I will write the &kde; User Guide. On the second desktop I'll run the <command>meinproc</command> documentation compiler and see my results while compiling my &Linux; kernel on the third desktop, and reading my email on the fourth.</quote> </para></listitem> </varlistentry> <varlistentry> -<term ->Icon bar</term> +<term>Icon bar</term> <listitem> -<para ->Some people are so lazy that they consider even the two or three motions through the application's menu to be too much (me included). For them, additional buttons can be placed next to the desktop buttons; for example, shortcuts to your home folder, to your trashcan, to the <application ->Konsole</application -> terminal emulator and to the documents you use often. For information on how to add icons to the taskbar, read <link linkend="icons-add" ->Adding icons to your taskbar</link ->. </para> -<para ->&kde; by default installs several commonly used buttons, including links to &khelpcenter;, &kwrite; and &kcontrol;.</para -></listitem> +<para>Some people are so lazy that they consider even the two or three motions through the application's menu to be too much (me included). For them, additional buttons can be placed next to the desktop buttons; for example, shortcuts to your home folder, to your trashcan, to the <application>Konsole</application> terminal emulator and to the documents you use often. For information on how to add icons to the taskbar, read <link linkend="icons-add">Adding icons to your taskbar</link>. </para> +<para>&kde; by default installs several commonly used buttons, including links to &khelpcenter;, &kwrite; and &kcontrol;.</para></listitem> </varlistentry> <varlistentry> -<term ->Time and date</term> -<listitem -><para ->At the far right end of the &kde; panel, you can always see the time and date.</para -></listitem> +<term>Time and date</term> +<listitem><para>At the far right end of the &kde; panel, you can always see the time and date.</para></listitem> </varlistentry> <varlistentry> -<term ->The task list</term> +<term>The task list</term> <listitem> -<para ->In another section of the panel, find a button for each open window. Just click on the button corresponding to the windows you want to open. Another click will minimise the window. A <mousebutton ->right</mousebutton -> mouse button click will give you a menu allowing you to move the window to another desktop, manipulate it's size, or close the application.</para -></listitem> +<para>In another section of the panel, find a button for each open window. Just click on the button corresponding to the windows you want to open. Another click will minimise the window. A <mousebutton>right</mousebutton> mouse button click will give you a menu allowing you to move the window to another desktop, manipulate it's size, or close the application.</para></listitem> </varlistentry> </variablelist> </sect2> <sect2> -<title ->Using Windows </title> +<title>Using Windows </title> <variablelist> <varlistentry> -<term ->Window menu</term> +<term>Window menu</term> <listitem> -<para -><mousebutton ->Right</mousebutton -> mouse button clicking in the title bar of the window (where you see the application's name), you can see a window manipulation icon. This is the same menu you see if you <mousebutton ->right</mousebutton -> click on an application's icon in the panel taskbar. When you click on it, a context menu containing commands to manipulate the window is presented. The available commands are as follows:</para> +<para><mousebutton>Right</mousebutton> mouse button clicking in the title bar of the window (where you see the application's name), you can see a window manipulation icon. This is the same menu you see if you <mousebutton>right</mousebutton> click on an application's icon in the panel taskbar. When you click on it, a context menu containing commands to manipulate the window is presented. The available commands are as follows:</para> <variablelist> <varlistentry> -<term -><guimenuitem ->Move</guimenuitem -></term> -<listitem -><para ->Lets you move the window with your mouse. Click on the <mousebutton ->left</mousebutton -> mouse button when you have the window where you want it to be.</para -></listitem> +<term><guimenuitem>Move</guimenuitem></term> +<listitem><para>Lets you move the window with your mouse. Click on the <mousebutton>left</mousebutton> mouse button when you have the window where you want it to be.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Resize</guimenuitem -></term> -<listitem -><para ->Enables you to make the window smaller or larger. Move your mouse around and click when you are satisfied with the new size.</para -></listitem> +<term><guimenuitem>Resize</guimenuitem></term> +<listitem><para>Enables you to make the window smaller or larger. Move your mouse around and click when you are satisfied with the new size.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Minimise</guimenuitem -></term> -<listitem -><para ->Hides the window, leaving only an icon in the taskbar. Notice that the window title in this icon is now shown in (parentheses). To bring the window to the desktop again, click the icon.</para -></listitem> +<term><guimenuitem>Minimise</guimenuitem></term> +<listitem><para>Hides the window, leaving only an icon in the taskbar. Notice that the window title in this icon is now shown in (parentheses). To bring the window to the desktop again, click the icon.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Maximise</guimenuitem -></term> -<listitem -><para ->This will expand the window to the largest size possible. Note that &kde; will take the size of your <emphasis ->virtual desktop</emphasis ->, which means that the window could be bigger than your screen. </para -></listitem> +<term><guimenuitem>Maximise</guimenuitem></term> +<listitem><para>This will expand the window to the largest size possible. Note that &kde; will take the size of your <emphasis>virtual desktop</emphasis>, which means that the window could be bigger than your screen. </para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Shade</guimenuitem -></term> -<listitem -><para -><quote ->Roll</quote -> up the window, leaving only the titlebar visible. You can achieve the same effect by double clicking in the titlebar. To display the entire window again, select <guimenuitem ->Shade</guimenuitem -> again, or double click in the titlebar.</para -></listitem> +<term><guimenuitem>Shade</guimenuitem></term> +<listitem><para><quote>Roll</quote> up the window, leaving only the titlebar visible. You can achieve the same effect by double clicking in the titlebar. To display the entire window again, select <guimenuitem>Shade</guimenuitem> again, or double click in the titlebar.</para></listitem> </varlistentry> <varlistentry> -<term -><guisubmenu ->Advanced</guisubmenu -></term> -<listitem -><para ->Here you can find menu options that allow you to manipulate how windows may cover each other up, and more:</para> +<term><guisubmenu>Advanced</guisubmenu></term> +<listitem><para>Here you can find menu options that allow you to manipulate how windows may cover each other up, and more:</para> <variablelist> <varlistentry> -<term -><guimenuitem ->Keep Above Others</guimenuitem -></term> -<listitem -><para ->Selecting this will keep this window on top of all other applications, even when it does not have the focus.</para -></listitem> +<term><guimenuitem>Keep Above Others</guimenuitem></term> +<listitem><para>Selecting this will keep this window on top of all other applications, even when it does not have the focus.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Keep Below Others</guimenuitem -></term> -<listitem -><para ->Selecting this will keep this window below all others, even when it does have the focus.</para -></listitem> +<term><guimenuitem>Keep Below Others</guimenuitem></term> +<listitem><para>Selecting this will keep this window below all others, even when it does have the focus.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Fullscreen</guimenuitem -></term> -<listitem -><para ->Selecting this makes the window take up the entire screen, similar to maximising, however, there are no window decorations showing. To switch to other applications, you may need to use the keybindings. For instance <keycombo action="simul" ->&Alt;	</keycombo -> to switch to another window or <keycombo action="simul" ->&Ctrl;	</keycombo -> to switch to another virtual desktop.</para> -<para ->To revert from fullscreen mode, you can use the <keycombo action="simul" ->&Alt;<keycap ->F3</keycap -></keycombo -> shortcut to show the window operations menu and deselect <menuchoice -><guisubmenu ->Advanced</guisubmenu -><guimenuitem ->Fullscreen</guimenuitem -> </menuchoice ->.</para> +<term><guimenuitem>Fullscreen</guimenuitem></term> +<listitem><para>Selecting this makes the window take up the entire screen, similar to maximising, however, there are no window decorations showing. To switch to other applications, you may need to use the keybindings. For instance <keycombo action="simul">&Alt;	</keycombo> to switch to another window or <keycombo action="simul">&Ctrl;	</keycombo> to switch to another virtual desktop.</para> +<para>To revert from fullscreen mode, you can use the <keycombo action="simul">&Alt;<keycap>F3</keycap></keycombo> shortcut to show the window operations menu and deselect <menuchoice><guisubmenu>Advanced</guisubmenu><guimenuitem>Fullscreen</guimenuitem> </menuchoice>.</para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->No Border</guimenuitem -></term> +<term><guimenuitem>No Border</guimenuitem></term> <listitem> -<para ->Remove the window decoration and border from this window. This is useful for <quote ->monitor</quote -> type applications, such as &kpager; which you keep on screen all the time and will never need the window decorations for. Many people also like to use this for <application ->xterm</application -> and &konsole; windows.</para> -<para ->To revert from no border mode, you can use the <keycombo action="simul" ->&Alt;<keycap ->F3</keycap -></keycombo -> shortcut to show the window operations menu and deselect <menuchoice -><guisubmenu ->Advanced</guisubmenu -><guimenuitem ->No Border</guimenuitem -> </menuchoice ->.</para> +<para>Remove the window decoration and border from this window. This is useful for <quote>monitor</quote> type applications, such as &kpager; which you keep on screen all the time and will never need the window decorations for. Many people also like to use this for <application>xterm</application> and &konsole; windows.</para> +<para>To revert from no border mode, you can use the <keycombo action="simul">&Alt;<keycap>F3</keycap></keycombo> shortcut to show the window operations menu and deselect <menuchoice><guisubmenu>Advanced</guisubmenu><guimenuitem>No Border</guimenuitem> </menuchoice>.</para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Store Window Settings</guimenuitem -></term> -<listitem -><para ->Stored the current settings for this window (position, size, whether it should always stay on top of all other windows &etc;.). This configuration will then be loaded the next time the window gets opened.</para> +<term><guimenuitem>Store Window Settings</guimenuitem></term> +<listitem><para>Stored the current settings for this window (position, size, whether it should always stay on top of all other windows &etc;.). This configuration will then be loaded the next time the window gets opened.</para> </listitem> </varlistentry> </variablelist> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->To Desktop</guimenuitem -></term> -<listitem -><para ->Enables you to send a window to another desktop. Choose the desktop where you want the window to be. The window will disappear at once. To see your window again, select the appropriate <guiicon ->Desktop Button</guiicon -> on the &kde; <application ->Panel</application ->. Selecting <guimenuitem ->All Desktops</guimenuitem -> will make the window <quote ->sticky</quote -> - it will display on all desktops at once, so you can alway see this window.</para -></listitem> +<term><guimenuitem>To Desktop</guimenuitem></term> +<listitem><para>Enables you to send a window to another desktop. Choose the desktop where you want the window to be. The window will disappear at once. To see your window again, select the appropriate <guiicon>Desktop Button</guiicon> on the &kde; <application>Panel</application>. Selecting <guimenuitem>All Desktops</guimenuitem> will make the window <quote>sticky</quote> - it will display on all desktops at once, so you can alway see this window.</para></listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Configure Window Behaviour...</guimenuitem -></term> -<listitem -><para ->Allows you to change the look and feel, of all the windows in &kde;. This changes the window decoration widgets, including the titlebar buttons, but also including things such as checkboxes and buttons within dialogues, scrollbars, and the titlebar itself. The default is <guilabel ->Keramik</guilabel ->.</para> -<para ->You can further customise nearly everything about the window manager itself, including how windows behave when moved, what different mouse button clicks will do in different parts of the window, and how to decide which windows have focus.</para> +<term><guimenuitem>Configure Window Behaviour...</guimenuitem></term> +<listitem><para>Allows you to change the look and feel, of all the windows in &kde;. This changes the window decoration widgets, including the titlebar buttons, but also including things such as checkboxes and buttons within dialogues, scrollbars, and the titlebar itself. The default is <guilabel>Keramik</guilabel>.</para> +<para>You can further customise nearly everything about the window manager itself, including how windows behave when moved, what different mouse button clicks will do in different parts of the window, and how to decide which windows have focus.</para> </listitem> </varlistentry> <varlistentry> -<term -><guimenuitem ->Close</guimenuitem -></term> -<listitem -><para ->This will close the window. Sometimes the application will allow you to save your work, but in some cases (⪚, old X11 applications) this does not work. It is best to close an application with its own commands, using this menu item only as a last resort.</para> -<para ->If the application itself is experiencing a problem that doesn't allow you to close it normally, using this menu item, or the window decoration close button will offer you the chance to <quote ->kill</quote -> it as gracefully as possible. Note that this may still leave the application open in the background but not showing any windows. Allowing the application to be killed in this manner will most likely allow you back into the desktop however, so you can check in a terminal window and clean up any remaining processes.</para> +<term><guimenuitem>Close</guimenuitem></term> +<listitem><para>This will close the window. Sometimes the application will allow you to save your work, but in some cases (⪚, old X11 applications) this does not work. It is best to close an application with its own commands, using this menu item only as a last resort.</para> +<para>If the application itself is experiencing a problem that doesn't allow you to close it normally, using this menu item, or the window decoration close button will offer you the chance to <quote>kill</quote> it as gracefully as possible. Note that this may still leave the application open in the background but not showing any windows. Allowing the application to be killed in this manner will most likely allow you back into the desktop however, so you can check in a terminal window and clean up any remaining processes.</para> </listitem> </varlistentry> </variablelist> @@ -360,93 +152,34 @@ </variablelist> <variablelist> -<title ->Window Decoration Buttons</title> +<title>Window Decoration Buttons</title> <varlistentry> -<term ->Sticky button</term> -<listitem -><para ->This button looks like a plus symbol in the default window decoration (Keramik) and may look like a thumb tack in others. It performs the same operation as selecting <menuchoice -><guimenu ->To Desktop</guimenu -><guimenuitem ->All Desktops</guimenuitem -> </menuchoice -> in the <guimenu ->Window Menu</guimenu ->, but requires fewer steps to invoke.</para -></listitem> +<term>Sticky button</term> +<listitem><para>This button looks like a plus symbol in the default window decoration (Keramik) and may look like a thumb tack in others. It performs the same operation as selecting <menuchoice><guimenu>To Desktop</guimenu><guimenuitem>All Desktops</guimenuitem> </menuchoice> in the <guimenu>Window Menu</guimenu>, but requires fewer steps to invoke.</para></listitem> </varlistentry> <varlistentry> -<term ->Title bar</term> -<listitem -><para ->The title bar containing the name of the window can be double-clicked in order to shade it. Use the <mousebutton ->right</mousebutton -> mouse button: The <guimenu ->Window menu</guimenu -> will reappear, allowing you to (un)maximise, iconify, move, resize, (un)sticky the window, to move it to another desktop (this works faster than the method with the sticky button). When a program does not react anymore, you can close (which will sometimes give you the opportunity to save your work) it. </para -></listitem> +<term>Title bar</term> +<listitem><para>The title bar containing the name of the window can be double-clicked in order to shade it. Use the <mousebutton>right</mousebutton> mouse button: The <guimenu>Window menu</guimenu> will reappear, allowing you to (un)maximise, iconify, move, resize, (un)sticky the window, to move it to another desktop (this works faster than the method with the sticky button). When a program does not react anymore, you can close (which will sometimes give you the opportunity to save your work) it. </para></listitem> </varlistentry> <varlistentry> -<term -><guibutton ->Minimise</guibutton ->, <guibutton ->Maximise</guibutton -> and <guibutton ->Close</guibutton -> Buttons</term> -<listitem -><para ->To the right of the title bar, there are two buttons that can also be used to iconify or maximise the window (this is faster than using the window manipulation menu). Iconified windows can be brought back with a click on the taskbar. </para> -<para ->At the far left of the titlebar (with the default window decoration) is a button to close the window.</para -></listitem> +<term><guibutton>Minimise</guibutton>, <guibutton>Maximise</guibutton> and <guibutton>Close</guibutton> Buttons</term> +<listitem><para>To the right of the title bar, there are two buttons that can also be used to iconify or maximise the window (this is faster than using the window manipulation menu). Iconified windows can be brought back with a click on the taskbar. </para> +<para>At the far left of the titlebar (with the default window decoration) is a button to close the window.</para></listitem> </varlistentry> </variablelist> -<para ->To move a window, place the cursor on the title bar and hold down the &LMB;. Without releasing the mouse button, move the window to the location of your choice, then release the mouse button. If you want to resize a window, move the mouse cursor to the window border you wish to change. Once you have reached the correct spot, the cursor will change from an arrow to a bracket and an arrow. Hold down the &LMB; and drag the side in question to the location you wish, then release the button. Note that you may drag sides or corners (which will adjust the size in two dimensions at once.)</para> +<para>To move a window, place the cursor on the title bar and hold down the &LMB;. Without releasing the mouse button, move the window to the location of your choice, then release the mouse button. If you want to resize a window, move the mouse cursor to the window border you wish to change. Once you have reached the correct spot, the cursor will change from an arrow to a bracket and an arrow. Hold down the &LMB; and drag the side in question to the location you wish, then release the button. Note that you may drag sides or corners (which will adjust the size in two dimensions at once.)</para> -<para ->Using the menu bar of each &kde; window is easy. Just click on what you want to do, and it will be done.</para> +<para>Using the menu bar of each &kde; window is easy. Just click on what you want to do, and it will be done.</para> -<para ->Below the menu bar, there is a set of tool symbols you can use to execute commands. Whenever you move over them, an active picture will be marked. But the menu bar can do even more for you. Notice the textured stripe on the left of the menu and icon bars? Depress your <mousebutton ->right</mousebutton -> mouse button and a context menu will appear, allowing you to put the menu bar on the <guimenuitem ->top</guimenuitem ->, <guimenuitem ->left</guimenuitem ->, <guimenuitem ->right</guimenuitem ->, or <guimenuitem ->bottom</guimenuitem -> of the window. You can also hide the menubar by selecting <guimenuitem ->Flat</guimenuitem -></para> +<para>Below the menu bar, there is a set of tool symbols you can use to execute commands. Whenever you move over them, an active picture will be marked. But the menu bar can do even more for you. Notice the textured stripe on the left of the menu and icon bars? Depress your <mousebutton>right</mousebutton> mouse button and a context menu will appear, allowing you to put the menu bar on the <guimenuitem>top</guimenuitem>, <guimenuitem>left</guimenuitem>, <guimenuitem>right</guimenuitem>, or <guimenuitem>bottom</guimenuitem> of the window. You can also hide the menubar by selecting <guimenuitem>Flat</guimenuitem></para> </sect2> <sect2> -<title ->Getting Help </title> +<title>Getting Help </title> -<para ->Help is available basically everywhere: On the desktop, just use the <mousebutton ->right</mousebutton -> mouse button and choose <menuchoice -><guisubmenu ->Help</guisubmenu -><guimenuitem ->KDesktop Handbook</guimenuitem -></menuchoice ->. On the &kde; panel, open the application menu and choose <guimenu ->Help</guimenu ->. Every &kde; program has a help menu.</para> +<para>Help is available basically everywhere: On the desktop, just use the <mousebutton>right</mousebutton> mouse button and choose <menuchoice><guisubmenu>Help</guisubmenu><guimenuitem>KDesktop Handbook</guimenuitem></menuchoice>. On the &kde; panel, open the application menu and choose <guimenu>Help</guimenu>. Every &kde; program has a help menu.</para> </sect2> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/userguide/getting-started.docbook b/tde-i18n-en_GB/docs/tdebase/userguide/getting-started.docbook index 1a89fef7871..4580dc1d287 100644 --- a/tde-i18n-en_GB/docs/tdebase/userguide/getting-started.docbook +++ b/tde-i18n-en_GB/docs/tdebase/userguide/getting-started.docbook @@ -1,567 +1,237 @@ <chapter id="getting-started"> -<title ->Getting Started </title> +<title>Getting Started </title> <epigraph> -<attribution ->Help for one of the toughest riddles in <quote ->The 7th Guest</quote -></attribution> -<para ->Using only what you see, can you get from A to B?</para> +<attribution>Help for one of the toughest riddles in <quote>The 7th Guest</quote></attribution> +<para>Using only what you see, can you get from A to B?</para> </epigraph> -<para ->So far, you may be thinking that &kde; is little more than another window manager. Relax, and read this chapter, and we'll introduce you to some features that will assure you that &kde; is very much more than a window manager — it's a full fledged environment.</para> +<para>So far, you may be thinking that &kde; is little more than another window manager. Relax, and read this chapter, and we'll introduce you to some features that will assure you that &kde; is very much more than a window manager — it's a full fledged environment.</para> <sect1 id="editing-files"> -<title ->Editing Files </title> - -<para ->Since you do not only have &kde; applications installed on your system, you probably know the mess of editing <abbrev ->ASCII</abbrev -> style configuration files. But in fact, there are a lot of other file types that need to be edited this way. For example, the raw &XML; source for this guide was written <abbrev ->ASCII</abbrev -> style, as was the source code for the &kde; programs themselves. We will now show you how you can use the &kwrite; facility in &kde; to edit <abbrev ->ASCII</abbrev -> files of your own. </para> +<title>Editing Files </title> + +<para>Since you do not only have &kde; applications installed on your system, you probably know the mess of editing <abbrev>ASCII</abbrev> style configuration files. But in fact, there are a lot of other file types that need to be edited this way. For example, the raw &XML; source for this guide was written <abbrev>ASCII</abbrev> style, as was the source code for the &kde; programs themselves. We will now show you how you can use the &kwrite; facility in &kde; to edit <abbrev>ASCII</abbrev> files of your own. </para> <sect2 id="the-filemanager-screen"> -<title ->Opening a Window Containing Your Home Folder </title> - -<para ->Click on the &ticon; button and choose <guimenuitem ->Home (Personal Files)</guimenuitem ->. A window showing the contents of your home folder will pop up. To see a more detailed listing of files in your home folder, select <guimenuitem ->Show Hidden Files</guimenuitem -> from the <guimenu ->View</guimenu -> menu.</para> - -<para ->On the left hand of the window, a tree view of your file system structure should appear, while on the right hand side, you can see icons for each file in your Home folder, including any <quote ->hidden files</quote -> — files or folders beginning with a period. </para> +<title>Opening a Window Containing Your Home Folder </title> + +<para>Click on the &ticon; button and choose <guimenuitem>Home (Personal Files)</guimenuitem>. A window showing the contents of your home folder will pop up. To see a more detailed listing of files in your home folder, select <guimenuitem>Show Hidden Files</guimenuitem> from the <guimenu>View</guimenu> menu.</para> + +<para>On the left hand of the window, a tree view of your file system structure should appear, while on the right hand side, you can see icons for each file in your Home folder, including any <quote>hidden files</quote> — files or folders beginning with a period. </para> </sect2> <sect2> -<title ->The File Manager Screen </title> - -<para ->We tried to make the File Manager as easy as possible to use, and if you know other window managers (including those built into other Operating Systems) with integrated file management, many of the following concepts should be familiar to you.</para> - -<para ->On the top, there is a <guimenu ->Location</guimenu -> menu which contains functions to open and close file manager windows. You can also print the current contents.</para> - -<note -><para ->Want to visit the Internet? There are several paths you can take. You could choose <menuchoice -><guimenu ->Location</guimenu -><guimenuitem ->Open Location</guimenuitem -></menuchoice -> (or press <keycombo ->&Ctrl;<keycap ->O</keycap -></keycombo ->) and enter a &URL;.</para> - -<para ->The simplest way however, is to simply type in the address you want to go to in the location bar itself.</para> - -<para ->For example, if you want to visit the &kde; homepage, enter <userinput ->http://www.kde.org</userinput ->. You can also quickly transfer files over &FTP; using this method. &kde; is <quote ->Internet ready</quote ->, which means that you can load and save files not only on your local hard disk, but also on remote &FTP; and other remote servers that you have write access to. While other operating systems and desktops make a distinction between local and remote file systems, &kde; does not.</para> +<title>The File Manager Screen </title> + +<para>We tried to make the File Manager as easy as possible to use, and if you know other window managers (including those built into other Operating Systems) with integrated file management, many of the following concepts should be familiar to you.</para> + +<para>On the top, there is a <guimenu>Location</guimenu> menu which contains functions to open and close file manager windows. You can also print the current contents.</para> + +<note><para>Want to visit the Internet? There are several paths you can take. You could choose <menuchoice><guimenu>Location</guimenu><guimenuitem>Open Location</guimenuitem></menuchoice> (or press <keycombo>&Ctrl;<keycap>O</keycap></keycombo>) and enter a &URL;.</para> + +<para>The simplest way however, is to simply type in the address you want to go to in the location bar itself.</para> + +<para>For example, if you want to visit the &kde; homepage, enter <userinput>http://www.kde.org</userinput>. You can also quickly transfer files over &FTP; using this method. &kde; is <quote>Internet ready</quote>, which means that you can load and save files not only on your local hard disk, but also on remote &FTP; and other remote servers that you have write access to. While other operating systems and desktops make a distinction between local and remote file systems, &kde; does not.</para> </note> -<para ->The <guimenu ->Edit</guimenu -> menu offers functions to select, copy and move files. We will use them later. Already having used the <guimenu ->View</guimenu -> menu, you have probably seen that you can view the content in many different ways. Just play around a bit and see what happens.</para> +<para>The <guimenu>Edit</guimenu> menu offers functions to select, copy and move files. We will use them later. Already having used the <guimenu>View</guimenu> menu, you have probably seen that you can view the content in many different ways. Just play around a bit and see what happens.</para> -<para ->You will undoubtedly find the <guimenu ->Bookmarks</guimenu -> to be extremely useful: Now you can remember virtually any link, be it on the local machine or somewhere on the Internet. &kde;'s network transparency works both ways, allowing you to treat files and folders on your hard drive as if they were Internet bookmarks.</para> +<para>You will undoubtedly find the <guimenu>Bookmarks</guimenu> to be extremely useful: Now you can remember virtually any link, be it on the local machine or somewhere on the Internet. &kde;'s network transparency works both ways, allowing you to treat files and folders on your hard drive as if they were Internet bookmarks.</para> -<para ->The <guimenu ->Tools</guimenu -> menu helps you find the notorious file-that-I-put-somewhere-I-do-not-remember-anymore.</para> +<para>The <guimenu>Tools</guimenu> menu helps you find the notorious file-that-I-put-somewhere-I-do-not-remember-anymore.</para> </sect2> <sect2> -<title ->Navigating Through Folders </title> - -<para ->We will now pick one of your configuration files and edit it. First, we must change the folder in the File Manager.</para> - -<para ->&konqueror; started with your home folder as the top of the <quote ->tree</quote ->. For most day-to-day purposes, this is where you are likely to be working, so it is a practical default. Sometimes you need to see the broader picture though, so the rest of your file system is not far away.</para> - -<para ->You can quickly display the <filename class="directory" ->/</filename -> or <quote ->root</quote -> folder several ways: click the small <guiicon ->folder</guiicon -> icon beside the navigation pane to switch to a full filesystem tree, use the <guiicon ->Up</guiicon -> arrow on the toolbar above to go to the top of your filesystem in the right hand pane, or type in <userinput ->/</userinput -> in the location bar.</para> - -<para ->For the purpose of following this guide, press the small blue folder icon beside the navigation pane, so that the navigation pane switches to a full filesystem view. Notice that part of the tree is expanded, and your home folder is still selected. Now you can see how your home folder fits into the whole hierarchy, and your home folder files are still visible in the right hand pane.</para> - -<para ->Scroll down the navigation pane on the left side of the window until you find the folder <filename ->/etc</filename ->. Double-click on <filename ->etc</filename ->. You will see a long list of files in the right window.</para> +<title>Navigating Through Folders </title> + +<para>We will now pick one of your configuration files and edit it. First, we must change the folder in the File Manager.</para> + +<para>&konqueror; started with your home folder as the top of the <quote>tree</quote>. For most day-to-day purposes, this is where you are likely to be working, so it is a practical default. Sometimes you need to see the broader picture though, so the rest of your file system is not far away.</para> + +<para>You can quickly display the <filename class="directory">/</filename> or <quote>root</quote> folder several ways: click the small <guiicon>folder</guiicon> icon beside the navigation pane to switch to a full filesystem tree, use the <guiicon>Up</guiicon> arrow on the toolbar above to go to the top of your filesystem in the right hand pane, or type in <userinput>/</userinput> in the location bar.</para> + +<para>For the purpose of following this guide, press the small blue folder icon beside the navigation pane, so that the navigation pane switches to a full filesystem view. Notice that part of the tree is expanded, and your home folder is still selected. Now you can see how your home folder fits into the whole hierarchy, and your home folder files are still visible in the right hand pane.</para> + +<para>Scroll down the navigation pane on the left side of the window until you find the folder <filename>/etc</filename>. Double-click on <filename>etc</filename>. You will see a long list of files in the right window.</para> </sect2> <sect2 id="opening-a-file"> -<title ->Opening A File </title> - -<para ->Some of the files you see here are at the heart of your operating system, so making permanent changes to them require you to be the <systemitem class="username" ->root</systemitem -> or superuser. We are going to practice on a file that will not hurt anything if a mistake is made, called <filename ->motd</filename ->.</para> - -<para ->Scroll down until you find the file <filename ->motd</filename -> and click on it with the <mousebutton ->right</mousebutton -> mouse button. In the <guimenu ->context menu</guimenu ->, select <guimenuitem ->Open With</guimenuitem ->. A new menu will pop up. Choose <guimenuitem ->&kwrite;</guimenuitem ->. Voila!</para> - -<para ->There are many ways to open a file, and this is just one of them. &kwrite; is an editor with a simple and probably familiar interface. You could also have navigated down the small tree in the popup dialogue to the <guilabel ->Editors</guilabel -> section, and chosen another editor, or simply double click the file to open it in the default editor.</para> - -<para ->In the meantime, you have the file <filename ->/etc/motd</filename -> open in &kwrite; and we're ready to do some editing.</para> +<title>Opening A File </title> + +<para>Some of the files you see here are at the heart of your operating system, so making permanent changes to them require you to be the <systemitem class="username">root</systemitem> or superuser. We are going to practice on a file that will not hurt anything if a mistake is made, called <filename>motd</filename>.</para> + +<para>Scroll down until you find the file <filename>motd</filename> and click on it with the <mousebutton>right</mousebutton> mouse button. In the <guimenu>context menu</guimenu>, select <guimenuitem>Open With</guimenuitem>. A new menu will pop up. Choose <guimenuitem>&kwrite;</guimenuitem>. Voila!</para> + +<para>There are many ways to open a file, and this is just one of them. &kwrite; is an editor with a simple and probably familiar interface. You could also have navigated down the small tree in the popup dialogue to the <guilabel>Editors</guilabel> section, and chosen another editor, or simply double click the file to open it in the default editor.</para> + +<para>In the meantime, you have the file <filename>/etc/motd</filename> open in &kwrite; and we're ready to do some editing.</para> </sect2> <sect2> -<title ->The Editor Screen </title> - -<para ->The more you work with &kde;, the more you will notice that most screens and applications look and feel the same. The &kwrite; <guimenu ->File</guimenu -> menu is a great example of this. Almost every other &kde; program has the same menu, allowing you to create new files, open existing files from your local file system or (coming soon) even the web, save them (soon even on the web, too!), print it or mail it to somebody else.</para> - -<para ->The <guimenu ->Edit</guimenu -> menu can also be found in most &kde; applications, allowing you to cut and paste information between programs. You can also search and replace text. Using the <guimenu ->Settings</guimenu -> Menu, you can customise the editor in many different ways. For example, you can increase the font size to suit your monitor resolution — and your eyes. Of course, as in any other &kde; application, you find a <guimenu ->Help</guimenu -> Menu, offering you on-line help whenever you need it. </para> +<title>The Editor Screen </title> + +<para>The more you work with &kde;, the more you will notice that most screens and applications look and feel the same. The &kwrite; <guimenu>File</guimenu> menu is a great example of this. Almost every other &kde; program has the same menu, allowing you to create new files, open existing files from your local file system or (coming soon) even the web, save them (soon even on the web, too!), print it or mail it to somebody else.</para> + +<para>The <guimenu>Edit</guimenu> menu can also be found in most &kde; applications, allowing you to cut and paste information between programs. You can also search and replace text. Using the <guimenu>Settings</guimenu> Menu, you can customise the editor in many different ways. For example, you can increase the font size to suit your monitor resolution — and your eyes. Of course, as in any other &kde; application, you find a <guimenu>Help</guimenu> Menu, offering you on-line help whenever you need it. </para> </sect2> <sect2> -<title ->Using the Editor </title> - -<para ->Most <filename ->motd</filename -> files contain useless stuff like <quote ->Do not forget to back up your data</quote -> or <quote ->Do not annoy the system manager</quote ->. Boring. Let's change the text so that users logging in get the really important information. You can navigate through the text using the arrow keys, and mark sections of text with <keycombo ->&Shift;<keycap ->Arrows</keycap -> </keycombo ->or by using the mouse with the <mousebutton ->left</mousebutton -> button pressed. Use the <guimenu ->Edit</guimenu -> Menu to cut and paste text. Enter whatever you want, or use the following (great) example: </para> - -<screen -><userinput ->Welcome! +<title>Using the Editor </title> + +<para>Most <filename>motd</filename> files contain useless stuff like <quote>Do not forget to back up your data</quote> or <quote>Do not annoy the system manager</quote>. Boring. Let's change the text so that users logging in get the really important information. You can navigate through the text using the arrow keys, and mark sections of text with <keycombo>&Shift;<keycap>Arrows</keycap> </keycombo>or by using the mouse with the <mousebutton>left</mousebutton> button pressed. Use the <guimenu>Edit</guimenu> Menu to cut and paste text. Enter whatever you want, or use the following (great) example: </para> + +<screen><userinput>Welcome! This machine now has KDE installed, providing you with a great, easy-to-use interface and a consistent Look-and-Feel for all your applications. For more information on how to get KDE running on your -account, please email the administrator. </userinput -></screen> +account, please email the administrator. </userinput></screen> </sect2> <sect2 id="saving-files"> -<title ->Saving Your Work </title> - -<para ->Now that you have changed the <filename ->motd</filename -> file, it is time to save the file, putting the changes into effect. To do this, you can use either the <guimenu ->File</guimenu -> Menu, or you can use the <guiicon ->Save</guiicon -> Icon on the toolbar.</para> - -<para ->At this point, reality hits us. You need to have <systemitem class="username" ->root</systemitem -> permission to save the changes to this file. &kde; handles this by asking you for the <systemitem class="username" ->root</systemitem -> password.</para> - -<para ->You probably don't really want to save this file, so you can press <guibutton ->Cancel</guibutton -> in the password dialogue and <guibutton ->Cancel</guibutton -> again in the save dialogue.</para> - -<para ->Finally, finish your work by closing the editor and file manager window. You can do this by clicking the <guibutton ->X</guibutton -> button on the top left of the window, by using the window menu of the title bar, or by choosing <menuchoice -><guimenu ->File</guimenu -> <guimenuitem ->Quit</guimenuitem -></menuchoice ->. Simple and elegant, isn't it? </para> +<title>Saving Your Work </title> + +<para>Now that you have changed the <filename>motd</filename> file, it is time to save the file, putting the changes into effect. To do this, you can use either the <guimenu>File</guimenu> Menu, or you can use the <guiicon>Save</guiicon> Icon on the toolbar.</para> + +<para>At this point, reality hits us. You need to have <systemitem class="username">root</systemitem> permission to save the changes to this file. &kde; handles this by asking you for the <systemitem class="username">root</systemitem> password.</para> + +<para>You probably don't really want to save this file, so you can press <guibutton>Cancel</guibutton> in the password dialogue and <guibutton>Cancel</guibutton> again in the save dialogue.</para> + +<para>Finally, finish your work by closing the editor and file manager window. You can do this by clicking the <guibutton>X</guibutton> button on the top left of the window, by using the window menu of the title bar, or by choosing <menuchoice><guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem></menuchoice>. Simple and elegant, isn't it? </para> </sect2> <sect2 id="creating-new-files"> -<title ->Creating New Files</title> - -<para ->As with everything in &kde;, there are several ways to create a new file. You could open up the file manager, <mousebutton ->right</mousebutton -> click on an empty space in a folder you own, and choose <menuchoice -><guisubmenu ->Create New</guisubmenu -><guisubmenu ->File</guisubmenu -><guimenuitem ->Text File...</guimenuitem -></menuchoice ->. A new empty file will appear, which you can open just like any other. You can even do this right on the desktop itself.</para> - -<para ->More often you are already in an application and want to start a new file. Most &kde; applications offer a <menuchoice -><guimenu ->File</guimenu -><guimenuitem ->New</guimenuitem -></menuchoice -> menu item, and an icon on the toolbar to complement it. A new empty document will appear that you can immediately begin working in.</para> - -<para ->Both these approaches have advantages, so use the one that is most practical at the time.</para> +<title>Creating New Files</title> + +<para>As with everything in &kde;, there are several ways to create a new file. You could open up the file manager, <mousebutton>right</mousebutton> click on an empty space in a folder you own, and choose <menuchoice><guisubmenu>Create New</guisubmenu><guisubmenu>File</guisubmenu><guimenuitem>Text File...</guimenuitem></menuchoice>. A new empty file will appear, which you can open just like any other. You can even do this right on the desktop itself.</para> + +<para>More often you are already in an application and want to start a new file. Most &kde; applications offer a <menuchoice><guimenu>File</guimenu><guimenuitem>New</guimenuitem></menuchoice> menu item, and an icon on the toolbar to complement it. A new empty document will appear that you can immediately begin working in.</para> + +<para>Both these approaches have advantages, so use the one that is most practical at the time.</para> </sect2> </sect1> <sect1 id="moving-files-with-drag-and-drop"> -<title ->Moving Files With Drag and Drop </title> +<title>Moving Files With Drag and Drop </title> -<para ->As you have seen in the previous section, working with files is as easy as 1-2-3. However, when you want to copy and move files, the whole copy-and-paste business can get annoying. Don't worry — a procedure called <quote ->drag and drop</quote -> allows you to copy and move files more quickly and easily. </para> +<para>As you have seen in the previous section, working with files is as easy as 1-2-3. However, when you want to copy and move files, the whole copy-and-paste business can get annoying. Don't worry — a procedure called <quote>drag and drop</quote> allows you to copy and move files more quickly and easily. </para> <sect2> -<title ->Opening Two File Manager Windows </title> - -<para ->Before you can start, you will need to open two file manager windows. The simplest way to open a new window is to press the gear wheel button on the right of the icon bar. If you do not see the tree view in the new window, activate it (<menuchoice -><guimenu ->Window</guimenu -><guimenuitem ->Navigation Panel</guimenuitem -> </menuchoice -> or press <keycap ->F9</keycap ->).</para> +<title>Opening Two File Manager Windows </title> + +<para>Before you can start, you will need to open two file manager windows. The simplest way to open a new window is to press the gear wheel button on the right of the icon bar. If you do not see the tree view in the new window, activate it (<menuchoice><guimenu>Window</guimenu><guimenuitem>Navigation Panel</guimenuitem> </menuchoice> or press <keycap>F9</keycap>).</para> </sect2> <sect2> -<title ->Dragging a File From One Window To Another </title> - -<para ->In the first window, open the <filename ->/etc</filename -> folder and scroll until you see the <filename ->motd</filename -> file we modified in the previous section.</para> - -<para ->In the second window, open your home folder.</para> - -<para ->Click on the <filename ->motd</filename -> file. Hold your <mousebutton ->left</mousebutton -> mouse button and drag your file into your home folder. Release the <mousebutton ->left</mousebutton -> mouse button (this is called <emphasis ->dropping</emphasis -> the file). You will be presented up to four options: <guimenuitem ->Copy Here</guimenuitem ->, <guimenuitem ->Move Here</guimenuitem ->, <guimenuitem ->Link Here</guimenuitem -> and <guimenuitem ->Cancel</guimenuitem ->. In this example, since you are not <systemitem class="username" ->root</systemitem ->, you cannot move the file, so this option is not presented. <guimenuitem ->Link Here</guimenuitem -> will create a symbolic link to the file, while <guimenuitem ->Copy Here</guimenuitem -> and <guimenuitem ->Move Here</guimenuitem -> do exactly what they say. Select <guimenuitem ->Copy Here</guimenuitem ->. You should now have a copy of the <filename ->motd</filename -> file in your home folder. </para> +<title>Dragging a File From One Window To Another </title> + +<para>In the first window, open the <filename>/etc</filename> folder and scroll until you see the <filename>motd</filename> file we modified in the previous section.</para> + +<para>In the second window, open your home folder.</para> + +<para>Click on the <filename>motd</filename> file. Hold your <mousebutton>left</mousebutton> mouse button and drag your file into your home folder. Release the <mousebutton>left</mousebutton> mouse button (this is called <emphasis>dropping</emphasis> the file). You will be presented up to four options: <guimenuitem>Copy Here</guimenuitem>, <guimenuitem>Move Here</guimenuitem>, <guimenuitem>Link Here</guimenuitem> and <guimenuitem>Cancel</guimenuitem>. In this example, since you are not <systemitem class="username">root</systemitem>, you cannot move the file, so this option is not presented. <guimenuitem>Link Here</guimenuitem> will create a symbolic link to the file, while <guimenuitem>Copy Here</guimenuitem> and <guimenuitem>Move Here</guimenuitem> do exactly what they say. Select <guimenuitem>Copy Here</guimenuitem>. You should now have a copy of the <filename>motd</filename> file in your home folder. </para> </sect2> </sect1> <sect1 id="using-command-line-and-terminals"> -<title ->Using Command Line And Terminals </title> +<title>Using Command Line And Terminals </title> -<para ->So far, you have only worked with the tools and programs &kde; provides. Undoubtedly, you will want to use other &UNIX; programs as well. There are two ways of running them: The quick command line and the terminal.</para> +<para>So far, you have only worked with the tools and programs &kde; provides. Undoubtedly, you will want to use other &UNIX; programs as well. There are two ways of running them: The quick command line and the terminal.</para> <sect2> -<title ->Quick Command Line </title> +<title>Quick Command Line </title> -<para ->Pressing <keycombo action="simul" ->&Alt; <keycap ->F2</keycap -></keycombo -> pops up a small window where you can enter a command to run. Please note that you will not see any text output generated from a program started in this manner! This method is only recommended for starting &X-Window; based programs or for running tools where you do not need to see or type anything. For other programs, you will still need to use the terminal.</para> +<para>Pressing <keycombo action="simul">&Alt; <keycap>F2</keycap></keycombo> pops up a small window where you can enter a command to run. Please note that you will not see any text output generated from a program started in this manner! This method is only recommended for starting &X-Window; based programs or for running tools where you do not need to see or type anything. For other programs, you will still need to use the terminal.</para> </sect2> <sect2> -<title ->The &UNIX; Terminal Emulator </title> - -<para ->From the application menu, choose <menuchoice -><guisubmenu ->System</guisubmenu -><guimenuitem ->Terminal</guimenuitem -> </menuchoice ->. A terminal window will open. Here you can use regular &UNIX; shell commands: <command ->ls</command ->, <command ->cat</command ->, <command ->less</command ->, and so forth. Using the <guimenu ->Settings</guimenu -> menu, you can customise the terminal emulator to suit your needs. </para> +<title>The &UNIX; Terminal Emulator </title> + +<para>From the application menu, choose <menuchoice><guisubmenu>System</guisubmenu><guimenuitem>Terminal</guimenuitem> </menuchoice>. A terminal window will open. Here you can use regular &UNIX; shell commands: <command>ls</command>, <command>cat</command>, <command>less</command>, and so forth. Using the <guimenu>Settings</guimenu> menu, you can customise the terminal emulator to suit your needs. </para> </sect2> </sect1> <sect1 id="finding-your-lost-files"> -<title ->Finding Your Lost Files </title> +<title>Finding Your Lost Files </title> -<para ->Everyone has undoubtedly encountered the following problem: You start <command ->ftp</command ->, log into a great site like ftp.kde.org and start downloading files. It is late in the evening and you shut down your machine after completing the transfer. The next morning, you are at the keyboard again, and you start wondering into which folder you placed the recently transferred files. Using &kde;'s &kfind; utility makes finding those lost files a snap.</para> +<para>Everyone has undoubtedly encountered the following problem: You start <command>ftp</command>, log into a great site like ftp.kde.org and start downloading files. It is late in the evening and you shut down your machine after completing the transfer. The next morning, you are at the keyboard again, and you start wondering into which folder you placed the recently transferred files. Using &kde;'s &kfind; utility makes finding those lost files a snap.</para> <sect2> -<title ->Starting &kfind;</title> - -<para ->Starting &kfind; is simple: Choose <guimenuitem ->Find Files</guimenuitem -> in the &kmenu;. &kfind; uses an interface part you probably have not yet met in &kde;: tabs. When &kfind; starts, you see that <guilabel ->Name/Location</guilabel -> is selected. When you click on <guilabel ->Date Range</guilabel ->, the tab content changes. Since you have never run a search before, most of the icons on the toolbar and most of the menu entries are disabled. We will change this now.</para> +<title>Starting &kfind;</title> + +<para>Starting &kfind; is simple: Choose <guimenuitem>Find Files</guimenuitem> in the &kmenu;. &kfind; uses an interface part you probably have not yet met in &kde;: tabs. When &kfind; starts, you see that <guilabel>Name/Location</guilabel> is selected. When you click on <guilabel>Date Range</guilabel>, the tab content changes. Since you have never run a search before, most of the icons on the toolbar and most of the menu entries are disabled. We will change this now.</para> </sect2> <sect2> -<title ->Finding a File by Knowing Parts of Its Name </title> - -<para ->As long as you know a bit of the file name, searching is easy. Select the <guilabel ->Name/Location</guilabel -> tab, and enter the file name in the <guilabel ->Named</guilabel -> field. Wildcards may be used as needed. As a test, type <userinput ->*.tar.gz</userinput ->. By default, the search begins in your home folder, but you can select any starting folder you wish by clicking on the <guilabel ->Look in</guilabel -> or <guibutton ->Browse...</guibutton ->. To start searching, press the <guibutton ->Find</guibutton -> button. After a moment, a list of files will appear in the search results window. If they do not appear, you started the search in the wrong folder, made a spelling mistake in the <guilabel ->Named</guilabel -> field, or no files ending with a <filename ->.tar.gz</filename -> extension are located on your machine.</para> +<title>Finding a File by Knowing Parts of Its Name </title> + +<para>As long as you know a bit of the file name, searching is easy. Select the <guilabel>Name/Location</guilabel> tab, and enter the file name in the <guilabel>Named</guilabel> field. Wildcards may be used as needed. As a test, type <userinput>*.tar.gz</userinput>. By default, the search begins in your home folder, but you can select any starting folder you wish by clicking on the <guilabel>Look in</guilabel> or <guibutton>Browse...</guibutton>. To start searching, press the <guibutton>Find</guibutton> button. After a moment, a list of files will appear in the search results window. If they do not appear, you started the search in the wrong folder, made a spelling mistake in the <guilabel>Named</guilabel> field, or no files ending with a <filename>.tar.gz</filename> extension are located on your machine.</para> </sect2> <sect2 id="finding-with-complex-criteria"> -<title ->Finding a File by More Complex Criteria </title> +<title>Finding a File by More Complex Criteria </title> -<para ->There are many categories you can use to make your search more precise. <emphasis ->The more you know about the file, the better are your chances of finding it</emphasis ->.</para> +<para>There are many categories you can use to make your search more precise. <emphasis>The more you know about the file, the better are your chances of finding it</emphasis>.</para> <variablelist> <varlistentry> -<term -><guilabel ->Date Range</guilabel -></term> +<term><guilabel>Date Range</guilabel></term> <listitem> -<para ->Here, you can specify that you only want to see files which were last touched in a given period of time. You can also specify that you only want to see files that were touched since a specified number of months or days ago.</para> +<para>Here, you can specify that you only want to see files which were last touched in a given period of time. You can also specify that you only want to see files that were touched since a specified number of months or days ago.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->File Type</guilabel -> in the <guilabel ->Contents</guilabel -> tab.</term> -<listitem -><para ->If you know that the file was of a special type (⪚, a tar/gzip archive or a jpeg picture), you can tell &kfind; to find only this type of file.</para -></listitem> +<term><guilabel>File Type</guilabel> in the <guilabel>Contents</guilabel> tab.</term> +<listitem><para>If you know that the file was of a special type (⪚, a tar/gzip archive or a jpeg picture), you can tell &kfind; to find only this type of file.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Containing text</guilabel -> in the <guilabel ->Advanced</guilabel -> tab</term> +<term><guilabel>Containing text</guilabel> in the <guilabel>Advanced</guilabel> tab</term> <listitem> -<para ->You can specify text that the file must contain. </para> +<para>You can specify text that the file must contain. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->File size is</guilabel ->, in the <guilabel ->Properties</guilabel -> tab</term> -<listitem -><para ->If you know the file size, you can limit your search in this regard, as well. </para -></listitem> +<term><guilabel>File size is</guilabel>, in the <guilabel>Properties</guilabel> tab</term> +<listitem><para>If you know the file size, you can limit your search in this regard, as well. </para></listitem> </varlistentry> </variablelist> -<para ->&kfind; has many more options to refine searches, explore them all!</para> +<para>&kfind; has many more options to refine searches, explore them all!</para> </sect2> </sect1> <sect1 id="using-multiple-desktops"> -<title ->Using Multiple Desktops </title> +<title>Using Multiple Desktops </title> -<para ->Using multiple desktops helps you organise your work. You can place your programs on different desktops, and name the desktops so you know what you do there. This increases and optimises your workspace. It also helps you when you are surfing the net instead of doing your work and your boss comes in. But, of course, this is rare — at least in the office where I work. </para> +<para>Using multiple desktops helps you organise your work. You can place your programs on different desktops, and name the desktops so you know what you do there. This increases and optimises your workspace. It also helps you when you are surfing the net instead of doing your work and your boss comes in. But, of course, this is rare — at least in the office where I work. </para> -<para ->You can switch between desktops by clicking the desktop buttons on the &kicker; panel. If you want to rename them, you can do so by double-clicking on them. </para> +<para>You can switch between desktops by clicking the desktop buttons on the &kicker; panel. If you want to rename them, you can do so by double-clicking on them. </para> -<para ->You can use windows on multiple desktops. If you want to have a window present everywhere, just click the sticky button on the top-left of the window. To send a window to another desktop, click on the title bar with the <mousebutton ->right</mousebutton -> mouse button, choose <guimenuitem ->To Desktop</guimenuitem ->, and select the desktop where you would like the window moved. </para> +<para>You can use windows on multiple desktops. If you want to have a window present everywhere, just click the sticky button on the top-left of the window. To send a window to another desktop, click on the title bar with the <mousebutton>right</mousebutton> mouse button, choose <guimenuitem>To Desktop</guimenuitem>, and select the desktop where you would like the window moved. </para> </sect1> <sect1 id="quitting-kde"> -<title ->Quitting &kde;</title> - -<para ->To quit working with &kde;, you can use the <guimenuitem ->Logout</guimenuitem -> entry in the &kmenu;. You will be asked if you really want to quit &kde;. Quitting will close all windows and return you to your console or display manager. For information on how programs can save your work during logout, please read <link linkend="kde-logout" ->the notes for logging out.</link -> </para> +<title>Quitting &kde;</title> + +<para>To quit working with &kde;, you can use the <guimenuitem>Logout</guimenuitem> entry in the &kmenu;. You will be asked if you really want to quit &kde;. Quitting will close all windows and return you to your console or display manager. For information on how programs can save your work during logout, please read <link linkend="kde-logout">the notes for logging out.</link> </para> </sect1> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/userguide/history.docbook b/tde-i18n-en_GB/docs/tdebase/userguide/history.docbook index 6b5bff13bf4..df73da9a0b9 100644 --- a/tde-i18n-en_GB/docs/tdebase/userguide/history.docbook +++ b/tde-i18n-en_GB/docs/tdebase/userguide/history.docbook @@ -1,171 +1,90 @@ <chapter id="history"> -<title ->A Short Guided Tour of &kde;'s History</title> +<title>A Short Guided Tour of &kde;'s History</title> <epigraph> -<attribution ->The <abbrev ->CEO</abbrev -> of a big software company, at the beginning of the 80s...(apocryphal)</attribution -> -<para ->640KB ought to be enough for everybody </para> +<attribution>The <abbrev>CEO</abbrev> of a big software company, at the beginning of the 80s...(apocryphal)</attribution> +<para>640KB ought to be enough for everybody </para> </epigraph> <sect1 id="before-kde"> -<title ->Before &kde;</title> - -<para ->Since the beginning of &UNIX; development, there has been one great problem: There were stable kernels, and good, powerful software. Unfortunately, only a few people could use &UNIX;, because it was written mainly for those students and professionals who had studied the system for a long time. For example, the standard method for reading USENET news was:</para> - -<screen -><userinput -><command ->find</command -> <filename ->/var/spool/news</filename -> <parameter ->-name '[0-9]*' -exec cat {} \;</parameter -> | <command ->more</command -></userinput -> +<title>Before &kde;</title> + +<para>Since the beginning of &UNIX; development, there has been one great problem: There were stable kernels, and good, powerful software. Unfortunately, only a few people could use &UNIX;, because it was written mainly for those students and professionals who had studied the system for a long time. For example, the standard method for reading USENET news was:</para> + +<screen><userinput><command>find</command> <filename>/var/spool/news</filename> <parameter>-name '[0-9]*' -exec cat {} \;</parameter> | <command>more</command></userinput> </screen> -<para ->Although fast and relatively efficient, this couldn't be called user friendly. Today, there are many good front ends available, such as <application ->tin</application -> and &knode;, which provide easy-to-use, intuitive graphical user interfaces (&GUI;s). Unfortunately, the &GUI;s lack a common look-and-feel. Commercial libraries for programmers like &Motif; promised a solution to this, but these libraries remained, until recently, far too expensive and far too slow. </para> - -<para ->The configuration of programs is also often difficult. While compiling is usually done with a command line such as <userinput -><command ->./configure</command -> && <command ->make</command -> && <command ->make <option ->install</option -></command -></userinput -> only a very few programs can be configured with menus or scripts. In most cases, you must edit text configuration files yourself. It often happens that a misplaced period ruins the whole file, forcing you to restart the configuration process. Whenever you need to change your settings or reconfigure a program, the whole mess comes up again.</para> - -<para ->All this contributes to the fact that &Linux; and other &UNIX;'s fail to reach a wider audience. At the same time, many people are not satisfied with their current operating system, often because of the lack of stability and performance found in those operating systems. Other people hate to buy a new computer each time a new version of the program they cannot live without comes out, because it needs more <acronym ->RAM</acronym -> and more disk space. Often the new version provides functions few people really need. </para> - -<para -><emphasis ->&kde; is different.</emphasis -> Although we do not try to replace the standard &UNIX; shell, we are working on a tool that will make using &UNIX; easier. We also want to attract more users to the &UNIX; environment. Simple things will be made easy, yet complex things will still be just as possible. A single interface will be provided, instead of the dozens currently required. </para> +<para>Although fast and relatively efficient, this couldn't be called user friendly. Today, there are many good front ends available, such as <application>tin</application> and &knode;, which provide easy-to-use, intuitive graphical user interfaces (&GUI;s). Unfortunately, the &GUI;s lack a common look-and-feel. Commercial libraries for programmers like &Motif; promised a solution to this, but these libraries remained, until recently, far too expensive and far too slow. </para> + +<para>The configuration of programs is also often difficult. While compiling is usually done with a command line such as <userinput><command>./configure</command> && <command>make</command> && <command>make <option>install</option></command></userinput> only a very few programs can be configured with menus or scripts. In most cases, you must edit text configuration files yourself. It often happens that a misplaced period ruins the whole file, forcing you to restart the configuration process. Whenever you need to change your settings or reconfigure a program, the whole mess comes up again.</para> + +<para>All this contributes to the fact that &Linux; and other &UNIX;'s fail to reach a wider audience. At the same time, many people are not satisfied with their current operating system, often because of the lack of stability and performance found in those operating systems. Other people hate to buy a new computer each time a new version of the program they cannot live without comes out, because it needs more <acronym>RAM</acronym> and more disk space. Often the new version provides functions few people really need. </para> + +<para><emphasis>&kde; is different.</emphasis> Although we do not try to replace the standard &UNIX; shell, we are working on a tool that will make using &UNIX; easier. We also want to attract more users to the &UNIX; environment. Simple things will be made easy, yet complex things will still be just as possible. A single interface will be provided, instead of the dozens currently required. </para> </sect1> <sect1 id="what-kde-can-do-for-you"> -<title ->What &kde; Can Do For You</title> +<title>What &kde; Can Do For You</title> -<para ->&kde; is designed for everyone.</para> +<para>&kde; is designed for everyone.</para> -<para ->Those new to &UNIX;, or those who simply have no interest in learning to use new technologies and commands not found in their previous operating systems don't need to face the intricacies of the command line unless they want to. Yet there is much &kde; offers that is of value to experienced &UNIX; users, with &GUI; tools to make simple what were previously complex tasks, and the command line just a mouse click away if you want it.</para> +<para>Those new to &UNIX;, or those who simply have no interest in learning to use new technologies and commands not found in their previous operating systems don't need to face the intricacies of the command line unless they want to. Yet there is much &kde; offers that is of value to experienced &UNIX; users, with &GUI; tools to make simple what were previously complex tasks, and the command line just a mouse click away if you want it.</para> -<para ->No matter what your level of experience with &UNIX; or any other operating system, &kde; brings you:</para> +<para>No matter what your level of experience with &UNIX; or any other operating system, &kde; brings you:</para> <itemizedlist> <listitem> -<para ->A good looking, easy to use desktop environment.</para> +<para>A good looking, easy to use desktop environment.</para> </listitem> <listitem> -<para ->A powerful, easy to use file manager</para> +<para>A powerful, easy to use file manager</para> </listitem> <listitem> -<para ->An equally powerful and easy to use web browser</para> +<para>An equally powerful and easy to use web browser</para> </listitem> <listitem> -<para ->A simple, centralised configuration</para> +<para>A simple, centralised configuration</para> </listitem> <listitem> -<para ->A comprehensive list of applications, so you can be productive within minutes of your first &kde; login.</para> +<para>A comprehensive list of applications, so you can be productive within minutes of your first &kde; login.</para> </listitem> <listitem> -<para ->Online help to support you in every situation.</para> +<para>Online help to support you in every situation.</para> </listitem> <listitem> -<para ->Consistency of interface. Menus are in the same place across applications, keybindings behave the same way, toolbar icons, once learned, always work the same.</para> +<para>Consistency of interface. Menus are in the same place across applications, keybindings behave the same way, toolbar icons, once learned, always work the same.</para> </listitem> </itemizedlist> </sect1> <sect1 id="background-of-kde"> -<title ->The Background Of &kde;</title> +<title>The Background Of &kde;</title> -<para ->In October 1996, German <application ->LyX</application -> developer Matthias Ettrich initiated the development of &kde; with a USENET posting. Soon after, a couple of interested developers began planning and programming parts of the new project. One year later, the window and file managers, the terminal emulator, the help system and the display configuration tool were released for Alpha and Beta testing and proved to be relatively stable. </para> +<para>In October 1996, German <application>LyX</application> developer Matthias Ettrich initiated the development of &kde; with a USENET posting. Soon after, a couple of interested developers began planning and programming parts of the new project. One year later, the window and file managers, the terminal emulator, the help system and the display configuration tool were released for Alpha and Beta testing and proved to be relatively stable. </para> -<para ->In July 1998, &kde; 1.0 was released. It was the stable version for the next six months, while developers continued work on improving &kde; without stability constraints. In January 1999, their improvements were consolidated and integrated to produce &kde; 1.1, the new standard, stable version. </para> +<para>In July 1998, &kde; 1.0 was released. It was the stable version for the next six months, while developers continued work on improving &kde; without stability constraints. In January 1999, their improvements were consolidated and integrated to produce &kde; 1.1, the new standard, stable version. </para> -<para ->Development continued from there with &kde; 2.0, an almost complete rewrite of the desktop, being released on October 23rd 2000. The &kde; 2.x version evolved through six minor releases over the period of a year, each bringing an already impressive desktop further features and stability.</para> +<para>Development continued from there with &kde; 2.0, an almost complete rewrite of the desktop, being released on October 23rd 2000. The &kde; 2.x version evolved through six minor releases over the period of a year, each bringing an already impressive desktop further features and stability.</para> -<para ->At the time of writing, &kde; 3.2 is in preparation for release, introducing a broad range of improvements over the 2.0 series. Although the &GUI; didn't change as dramatically as it did during the move from &kde; 1 to &kde; 2, many refinements like a completely new printing system, vastly improved <acronym ->SSL</acronym -> support (for secure Internet transactions) or full support for languages which are written right-to-left (like Arabic or Hebrew) found their way into the desktop. You can find more information about this exciting development at &kde-http;. </para> +<para>At the time of writing, &kde; 3.2 is in preparation for release, introducing a broad range of improvements over the 2.0 series. Although the &GUI; didn't change as dramatically as it did during the move from &kde; 1 to &kde; 2, many refinements like a completely new printing system, vastly improved <acronym>SSL</acronym> support (for secure Internet transactions) or full support for languages which are written right-to-left (like Arabic or Hebrew) found their way into the desktop. You can find more information about this exciting development at &kde-http;. </para> -<para ->The developers and users communicate primarily via several mailing lists, as described in the <link linkend="mailing-lists" ->Mailing Lists</link -> section. If you would like to help, please do, &kde; is driven by volunteer contribution, and you are always welcome to take part.</para> +<para>The developers and users communicate primarily via several mailing lists, as described in the <link linkend="mailing-lists">Mailing Lists</link> section. If you would like to help, please do, &kde; is driven by volunteer contribution, and you are always welcome to take part.</para> </sect1> <sect1 id="getting-kde"> -<title ->How To Get New Components</title> - -<para ->The main web site for &kde; is &kde-http;. Here you can find all important information regarding &kde;, including announcements, bugfixes, developer information and much more.</para> - -<para ->For software upgrades, please visit our &FTP; site, &kde-ftp;, or use a mirror if one exists near you. You can find an up to date list of mirrors at <ulink url="http://www.kde.org/ftpmirrors.html" ->http://www.kde.org/ftpmirrors.html</ulink ->.</para> - -<para ->On the &FTP; servers, the folder <filename ->unstable</filename -> always contains brand new software, but it is often untested and may not even compile. If you are looking for more reliable components, please take a look in the <filename ->stable</filename -> folder, where we put Beta and release versions. </para> - -<para ->If you are interested in developing &kde; applications of your own, you should visit <ulink url="http://developer.kde.org/" ->http://developer.kde.org/"</ulink -> where you will find a wealth of information, including tutorials, <acronym ->API</acronym -> guides to the &kde; libraries, and much more. You should also visit Troll Tech's server (<ulink url="http://www.trolltech.com/" ->http://www.trolltech.com</ulink ->) which features a great deal of information concerning the &Qt; library used by &kde;. You will probably find it valuable to join <link linkend="mailing-lists" ->the &kde; developer mailing list</link ->.</para> +<title>How To Get New Components</title> + +<para>The main web site for &kde; is &kde-http;. Here you can find all important information regarding &kde;, including announcements, bugfixes, developer information and much more.</para> + +<para>For software upgrades, please visit our &FTP; site, &kde-ftp;, or use a mirror if one exists near you. You can find an up to date list of mirrors at <ulink url="http://www.kde.org/ftpmirrors.html">http://www.kde.org/ftpmirrors.html</ulink>.</para> + +<para>On the &FTP; servers, the folder <filename>unstable</filename> always contains brand new software, but it is often untested and may not even compile. If you are looking for more reliable components, please take a look in the <filename>stable</filename> folder, where we put Beta and release versions. </para> + +<para>If you are interested in developing &kde; applications of your own, you should visit <ulink url="http://developer.kde.org/">http://developer.kde.org/"</ulink> where you will find a wealth of information, including tutorials, <acronym>API</acronym> guides to the &kde; libraries, and much more. You should also visit Troll Tech's server (<ulink url="http://www.trolltech.com/">http://www.trolltech.com</ulink>) which features a great deal of information concerning the &Qt; library used by &kde;. You will probably find it valuable to join <link linkend="mailing-lists">the &kde; developer mailing list</link>.</para> </sect1> diff --git a/tde-i18n-en_GB/docs/tdebase/userguide/index.docbook b/tde-i18n-en_GB/docs/tdebase/userguide/index.docbook index d1d8b2db1ee..d012ee25a18 100644 --- a/tde-i18n-en_GB/docs/tdebase/userguide/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/userguide/index.docbook @@ -14,73 +14,39 @@ <!ENTITY staff SYSTEM "staff.docbook"> <!ENTITY notices-and-trademarks SYSTEM "notices-trademarks.docbook"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> <book lang="&language;"> <bookinfo> -<title ->K Desktop Environment</title> +<title>K Desktop Environment</title> <authorgroup> <author> -<surname ->The KDE Team</surname> +<surname>The KDE Team</surname> </author> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2003-10-19</date> -<releaseinfo ->3.2</releaseinfo> +<date>2003-10-19</date> +<releaseinfo>3.2</releaseinfo> <copyright> -<year ->2000</year -><year ->2001</year -><year ->2002</year -><year ->2003</year> -<holder ->The KDE Team</holder> +<year>2000</year><year>2001</year><year>2002</year><year>2003</year> +<holder>The KDE Team</holder> </copyright> -<legalnotice ->&GPLNotice;</legalnotice> +<legalnotice>&GPLNotice;</legalnotice> <!-- Please note: This is NOT the final KDE Users Guide, which is not complete. This is a quick rewrite of the KDE 1.1x user guide, because it was badly out of date, and so that KDE wasn't released without a users guide entirely. --> -<abstract -><para ->This is the &kde; User's Guide, a complete documentation of the K Desktop Environment from the user perspective. The K Desktop Environment is a collection of tools that will make your &UNIX; life easier and more enjoyable. </para -></abstract> +<abstract><para>This is the &kde; User's Guide, a complete documentation of the K Desktop Environment from the user perspective. The K Desktop Environment is a collection of tools that will make your &UNIX; life easier and more enjoyable. </para></abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->user</keyword> -<keyword ->guide</keyword> +<keyword>KDE</keyword> +<keyword>user</keyword> +<keyword>guide</keyword> </keywordset> </bookinfo> diff --git a/tde-i18n-en_GB/docs/tdebase/userguide/installation.docbook b/tde-i18n-en_GB/docs/tdebase/userguide/installation.docbook index 1383128cd72..f1df426ff0c 100644 --- a/tde-i18n-en_GB/docs/tdebase/userguide/installation.docbook +++ b/tde-i18n-en_GB/docs/tdebase/userguide/installation.docbook @@ -1,596 +1,189 @@ <chapter id="installation"> -<title ->Installation </title> +<title>Installation </title> <epigraph> -<attribution ->Linus Torvalds, after finding one of his file systems smashed by a new Beta kernel</attribution> -<para ->Core dumping fsck's tend to make me nervous</para> +<attribution>Linus Torvalds, after finding one of his file systems smashed by a new Beta kernel</attribution> +<para>Core dumping fsck's tend to make me nervous</para> </epigraph> -<para ->Don't worry! Although the use of some Beta software can cause considerable grief, it is unlikely that the installation of KDE will trash your hard disk. In fact, this chapter is designed to guide you through the installation process, so that you can take a look at your new desktop as quickly (and with as little grief) as possible. As with all new Window Manager installs, it is recommended that you back up all your X11-specific configuration files before you begin the install. If you do not know the exact location of them, try all the hidden (<filename ->.*</filename ->) files in your home folder and the folder <filename ->/usr/X11/lib/X11/xdm</filename ->. </para -> +<para>Don't worry! Although the use of some Beta software can cause considerable grief, it is unlikely that the installation of KDE will trash your hard disk. In fact, this chapter is designed to guide you through the installation process, so that you can take a look at your new desktop as quickly (and with as little grief) as possible. As with all new Window Manager installs, it is recommended that you back up all your X11-specific configuration files before you begin the install. If you do not know the exact location of them, try all the hidden (<filename>.*</filename>) files in your home folder and the folder <filename>/usr/X11/lib/X11/xdm</filename>. </para> <sect1 id="requirements"> -<title ->Requirements </title> +<title>Requirements </title> -<para ->Before installing KDE, ascertain that your system fulfills the following requirements: </para> +<para>Before installing KDE, ascertain that your system fulfills the following requirements: </para> <itemizedlist> -<listitem -><para ->A running POSIX compatible UNIX system. UNIX's that are known to work with KDE include: Linux, FreeBSD, Solaris, HP-UX, and MkLinux. We are working to make KDE available for more platforms soon. </para -></listitem> - -<listitem -><para ->Some free hard disk space on the partition where <filename ->/opt/kde</filename -> will be created. We recommend that you reserve about 50MB if your system supports shared libraries, and considerably more if it does not. If you need or want to build KDE from the source tree, please remember to reserve about 100MB in <filename ->/usr/src</filename ->.</para -></listitem> - -<listitem -><para ->A running X11 system with or without <application ->xdm</application ->. If you have not installed the X Window System yet, first check your UNIX installation media for an installable version. If you cannot find any version working, visit <ulink url="http://www.xfree86.org" ->the XFree86 web site</ulink -> for more information on how to get and install the X Window System, or contact your UNIX vendor support. </para -></listitem> - -<listitem -><para ->The &Qt; libraries, version 3.2 or higher. You can obtain these at <ulink url="ftp://ftp.trolltech.com/qt" ->Troll Tech's FTP Server</ulink -> in tgz format. </para> +<listitem><para>A running POSIX compatible UNIX system. UNIX's that are known to work with KDE include: Linux, FreeBSD, Solaris, HP-UX, and MkLinux. We are working to make KDE available for more platforms soon. </para></listitem> + +<listitem><para>Some free hard disk space on the partition where <filename>/opt/kde</filename> will be created. We recommend that you reserve about 50MB if your system supports shared libraries, and considerably more if it does not. If you need or want to build KDE from the source tree, please remember to reserve about 100MB in <filename>/usr/src</filename>.</para></listitem> + +<listitem><para>A running X11 system with or without <application>xdm</application>. If you have not installed the X Window System yet, first check your UNIX installation media for an installable version. If you cannot find any version working, visit <ulink url="http://www.xfree86.org">the XFree86 web site</ulink> for more information on how to get and install the X Window System, or contact your UNIX vendor support. </para></listitem> + +<listitem><para>The &Qt; libraries, version 3.2 or higher. You can obtain these at <ulink url="ftp://ftp.trolltech.com/qt">Troll Tech's FTP Server</ulink> in tgz format. </para> </listitem> </itemizedlist> -<warning -><para ->A warning before you start: Before upgrading from a previous version of &kde;, we recommend that you do the following:</para> - -<screen -><command ->cd <filename ->/opt/kde</filename -></command -> -<command ->tar <option ->cfvz <replaceable ->~/KDE-old-version-backup.tar.gz</replaceable -> * </option -></command -> +<warning><para>A warning before you start: Before upgrading from a previous version of &kde;, we recommend that you do the following:</para> + +<screen><command>cd <filename>/opt/kde</filename></command> +<command>tar <option>cfvz <replaceable>~/KDE-old-version-backup.tar.gz</replaceable> * </option></command> </screen> </warning> </sect1> <sect1 id="linux-installing-rpms"> -<title ->Linux: Installing RPMs for RedHat, Caldera and SuSE.</title> - -<para ->Using RPMs is the easiest method to get KDE up and running. Just visit your favourite KDE mirror and visit the folder <filename ->/pub/kde/stable/distribution/rpm</filename ->. There, you can see folders for different operating systems. Currently, the i386, alpha and sparc architectures are supported. The RPM packages can also be found on the Red Hat contrib sites like sunsite.unc.edu or ftp.redhat.com. </para> - -<para ->The basic system consists of the files <filename ->kde-<replaceable ->component</replaceable ->.<replaceable ->architecture</replaceable ->.rpm</filename -> You need at least tdesupport, tdelibs and tdebase. After getting the base distribution, feel free to download any other RPMs that you think may come in handy. </para> - -<para ->Next, start installing with the base package. If you are installing KDE for the first time, use </para> - -<screen -><userinput -><command ->rpm</command -> <option ->-i</option -> <filename ->tdesupport.arch.rpm</filename -></userinput> -<userinput -><command ->rpm</command -> <option ->-i</option -> <filename ->tdelibs.arch.rpm</filename -></userinput> -<userinput -><command ->rpm</command -> <option ->-i</option -> <filename ->tdebase.arch.rpm</filename -></userinput -> +<title>Linux: Installing RPMs for RedHat, Caldera and SuSE.</title> + +<para>Using RPMs is the easiest method to get KDE up and running. Just visit your favourite KDE mirror and visit the folder <filename>/pub/kde/stable/distribution/rpm</filename>. There, you can see folders for different operating systems. Currently, the i386, alpha and sparc architectures are supported. The RPM packages can also be found on the Red Hat contrib sites like sunsite.unc.edu or ftp.redhat.com. </para> + +<para>The basic system consists of the files <filename>kde-<replaceable>component</replaceable>.<replaceable>architecture</replaceable>.rpm</filename> You need at least tdesupport, tdelibs and tdebase. After getting the base distribution, feel free to download any other RPMs that you think may come in handy. </para> + +<para>Next, start installing with the base package. If you are installing KDE for the first time, use </para> + +<screen><userinput><command>rpm</command> <option>-i</option> <filename>tdesupport.arch.rpm</filename></userinput> +<userinput><command>rpm</command> <option>-i</option> <filename>tdelibs.arch.rpm</filename></userinput> +<userinput><command>rpm</command> <option>-i</option> <filename>tdebase.arch.rpm</filename></userinput> </screen> -<important -><para ->It is important that these components are installed in the order listed, and that they are installed before any other KDE component.</para -></important> - -<para ->If you are upgrading from a previous release, try <screen -><userinput -><command ->rpm</command -> <option ->-Uvh</option -> <filename ->kde-<replaceable ->component</replaceable ->.<replaceable ->arch</replaceable ->.rpm</filename -></userinput -> +<important><para>It is important that these components are installed in the order listed, and that they are installed before any other KDE component.</para></important> + +<para>If you are upgrading from a previous release, try <screen><userinput><command>rpm</command> <option>-Uvh</option> <filename>kde-<replaceable>component</replaceable>.<replaceable>arch</replaceable>.rpm</filename></userinput> </screen> </para> -<para ->Once again, the order given above should be preserved, and the given components should be installed before any other KDE components.</para> +<para>Once again, the order given above should be preserved, and the given components should be installed before any other KDE components.</para> -<para ->This will unpack the base distribution and install it by default in <filename ->/opt/kde</filename ->.</para> +<para>This will unpack the base distribution and install it by default in <filename>/opt/kde</filename>.</para> -<para ->If the installation of the base packages has been successful, you can install the remaining packages (use <option ->-Uvh</option -> instead of <option ->-i</option -> once again to update an existing version) the same way. </para> +<para>If the installation of the base packages has been successful, you can install the remaining packages (use <option>-Uvh</option> instead of <option>-i</option> once again to update an existing version) the same way. </para> </sect1> <sect1 id="installing-debian"> -<title ->Linux: Installing <acronym ->DEB</acronym ->s for debian</title> +<title>Linux: Installing <acronym>DEB</acronym>s for debian</title> -<para ->The installation for a Debian system is also rather straightforward. You will only find KDE 2.0 packages for Debian 2.2 (Potato) and 3.0 (Woody). We describe here how to install packages for Debian 2.2, the stable version, since Debian 3.0 is still in development. However, the installation for both versions, is almost identical. The main difference is that KDE is officially included in Debian 3.0 and you do not need to specify any special location to find the deb packages for KDE.</para> +<para>The installation for a Debian system is also rather straightforward. You will only find KDE 2.0 packages for Debian 2.2 (Potato) and 3.0 (Woody). We describe here how to install packages for Debian 2.2, the stable version, since Debian 3.0 is still in development. However, the installation for both versions, is almost identical. The main difference is that KDE is officially included in Debian 3.0 and you do not need to specify any special location to find the deb packages for KDE.</para> -<para ->The first step is to tell your system where it can find the deb packages for KDE. A list of locations for the Debian packages is kept on your hard disk in <filename ->/etc/apt/sources.list</filename ->. You should add to that file the following line: <userinput ->http://kde.tdyc.com/ stable kde2</userinput -></para> +<para>The first step is to tell your system where it can find the deb packages for KDE. A list of locations for the Debian packages is kept on your hard disk in <filename>/etc/apt/sources.list</filename>. You should add to that file the following line: <userinput>http://kde.tdyc.com/ stable kde2</userinput></para> -<para ->Then you have to update your local package database so that your system knows that there are new packages available. Type the following command:</para> - -<screen -><userinput -><command ->apt-get</command -> <option ->update</option -></userinput -> +<para>Then you have to update your local package database so that your system knows that there are new packages available. Type the following command:</para> + +<screen><userinput><command>apt-get</command> <option>update</option></userinput> </screen> -<para ->Finally you should install the KDE base components. This is accomplished by typing:</para> - -<screen -><userinput -><command ->apt-get</command -> <option ->install tdebase</option -></userinput -> +<para>Finally you should install the KDE base components. This is accomplished by typing:</para> + +<screen><userinput><command>apt-get</command> <option>install tdebase</option></userinput> </screen> -<para ->If you want to install other components you should try some, or all of these options:</para> - -<screen -><userinput -><command ->apt-get</command -> <option ->install task-tdenetwork</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-tdeadmin</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-tdetoys</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-tdeutils</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-tdemultimedia</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-tdegraphics</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-tdepim</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-tdegames</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-koffice</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install tdebase-docs</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install tdm</option -></userinput -> +<para>If you want to install other components you should try some, or all of these options:</para> + +<screen><userinput><command>apt-get</command> <option>install task-tdenetwork</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdeadmin</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdetoys</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdeutils</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdemultimedia</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdegraphics</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdepim</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdegames</option></userinput> +<userinput><command>apt-get</command> <option>install task-koffice</option></userinput> +<userinput><command>apt-get</command> <option>install tdebase-docs</option></userinput> +<userinput><command>apt-get</command> <option>install tdm</option></userinput> </screen> -<para ->You may also be interested in installing your language.</para> - -<screen -><userinput -><command ->apt-get</command -> <option ->install -tde-i18n-<replaceable ->xx</replaceable -></option -></userinput -> +<para>You may also be interested in installing your language.</para> + +<screen><userinput><command>apt-get</command> <option>install +tde-i18n-<replaceable>xx</replaceable></option></userinput> </screen> -<para ->where <replaceable ->xx</replaceable -> has to be substituted by the country code.</para> - -<para ->The control files for some TDE applications will be placed at <filename class="directory" ->/etc/kde2</filename ->, the executables will go in <filename class="directory" ->/usr/bin</filename -> and most of the auxiliary files in <filename class="directory" ->/usr/share</filename -> under different folders. </para> - -<para ->If you are upgrading from a previous version of KDE you should perform the following steps. First, update file <filename ->/etc/apt/sources.list</filename -> by changing the line with the location of KDE packages with line: <userinput ->http://kde.tdyc.com/ stable kde2</userinput ->. Second update your package database:</para> - -<screen -><userinput -><command ->apt-get</command -> <option ->update</option -></userinput -> +<para>where <replaceable>xx</replaceable> has to be substituted by the country code.</para> + +<para>The control files for some TDE applications will be placed at <filename class="directory">/etc/kde2</filename>, the executables will go in <filename class="directory">/usr/bin</filename> and most of the auxiliary files in <filename class="directory">/usr/share</filename> under different folders. </para> + +<para>If you are upgrading from a previous version of KDE you should perform the following steps. First, update file <filename>/etc/apt/sources.list</filename> by changing the line with the location of KDE packages with line: <userinput>http://kde.tdyc.com/ stable kde2</userinput>. Second update your package database:</para> + +<screen><userinput><command>apt-get</command> <option>update</option></userinput> </screen> -<para ->Finally install the KDE base system:</para> - -<screen -><userinput -><command ->apt-get</command -> <option ->install tdebase</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->dist-upgrade</option -></userinput -> +<para>Finally install the KDE base system:</para> + +<screen><userinput><command>apt-get</command> <option>install tdebase</option></userinput> +<userinput><command>apt-get</command> <option>dist-upgrade</option></userinput> </screen> -<para ->If you want to install more KDE components try some, or all of these options.</para> - -<screen -><userinput -><command ->apt-get</command -> <option ->install task-tdenetwork</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-tdeadmin</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-tdetoys</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-tdeutils</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-tdemultimedia</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-tdegraphics</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-tdepim</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-tdegames</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install task-koffice</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install tdebase-docs</option -></userinput> -<userinput -><command ->apt-get</command -> <option ->install tdm</option -></userinput -> +<para>If you want to install more KDE components try some, or all of these options.</para> + +<screen><userinput><command>apt-get</command> <option>install task-tdenetwork</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdeadmin</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdetoys</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdeutils</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdemultimedia</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdegraphics</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdepim</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdegames</option></userinput> +<userinput><command>apt-get</command> <option>install task-koffice</option></userinput> +<userinput><command>apt-get</command> <option>install tdebase-docs</option></userinput> +<userinput><command>apt-get</command> <option>install tdm</option></userinput> </screen> </sect1> <sect1 id="source-distribution"> -<title ->Using Source Compilation to Install on Top of Other Systems </title> +<title>Using Source Compilation to Install on Top of Other Systems </title> -<para ->If your Linux distribution did not come with an RPM or DEB archive format, or you are not using Linux at all, you must compile KDE on your own. In the future, we are planning to provide a binary distribution which includes its own installation program. </para> +<para>If your Linux distribution did not come with an RPM or DEB archive format, or you are not using Linux at all, you must compile KDE on your own. In the future, we are planning to provide a binary distribution which includes its own installation program. </para> -<para ->In order to compile and install KDE properly, you need to have the following items installed on your hard disk: </para> +<para>In order to compile and install KDE properly, you need to have the following items installed on your hard disk: </para> <itemizedlist> -<listitem -><para ->An ANSI-C compiler, <abbrev ->e.g.</abbrev -> the <abbrev ->GNU</abbrev -> C compiler. </para -></listitem> -<listitem -><para ->An ANSI-C++ compiler, <abbrev ->e.g.</abbrev -> <abbrev ->GNU</abbrev -> C++. </para -></listitem> -<listitem -><para ->The <application ->make</application -> utility. </para -></listitem> -<listitem -><para ->Qt development version 2.2 or higher.</para -></listitem> -<listitem -><para ->X11 development version (include files are often missing) </para -></listitem> +<listitem><para>An ANSI-C compiler, <abbrev>e.g.</abbrev> the <abbrev>GNU</abbrev> C compiler. </para></listitem> +<listitem><para>An ANSI-C++ compiler, <abbrev>e.g.</abbrev> <abbrev>GNU</abbrev> C++. </para></listitem> +<listitem><para>The <application>make</application> utility. </para></listitem> +<listitem><para>Qt development version 2.2 or higher.</para></listitem> +<listitem><para>X11 development version (include files are often missing) </para></listitem> </itemizedlist> -<para ->Once you have all the needed helper applications, go to your favourite KDE mirror and retrieve the following files from the folder <filename ->/pub/kde/stable/<replaceable ->newest version</replaceable -></filename ->:</para> +<para>Once you have all the needed helper applications, go to your favourite KDE mirror and retrieve the following files from the folder <filename>/pub/kde/stable/<replaceable>newest version</replaceable></filename>:</para> <itemizedlist> -<listitem -><para -><filename ->tdesupport-<replaceable ->version</replaceable ->.tar.gz</filename -></para -></listitem> -<listitem -><para -><filename ->tdelibs-<replaceable ->version</replaceable ->.tar.gz</filename> -</para -></listitem> -<listitem -><para -><filename ->tdebase-<replaceable ->version</replaceable ->.tar.gz</filename -></para -></listitem> -<listitem -><para ->any other packages you wish to install. We advise you to get at least tdeutils. </para -></listitem> +<listitem><para><filename>tdesupport-<replaceable>version</replaceable>.tar.gz</filename></para></listitem> +<listitem><para><filename>tdelibs-<replaceable>version</replaceable>.tar.gz</filename> +</para></listitem> +<listitem><para><filename>tdebase-<replaceable>version</replaceable>.tar.gz</filename></para></listitem> +<listitem><para>any other packages you wish to install. We advise you to get at least tdeutils. </para></listitem> </itemizedlist> -<para ->In all cases above, <replaceable ->version</replaceable -> stands for the current version number. Once you have downloaded all you need, extract these files to <filename ->/usr/src</filename ->. This process should yield the following folder structure:</para> +<para>In all cases above, <replaceable>version</replaceable> stands for the current version number. Once you have downloaded all you need, extract these files to <filename>/usr/src</filename>. This process should yield the following folder structure:</para> <itemizedlist> -<listitem -><para -><filename ->/usr/src/tdesupport</filename -></para -></listitem> -<listitem -><para -><filename ->/usr/src/tdelibs</filename -></para -></listitem> -<listitem -><para -><filename ->/usr/src/tdebase</filename -></para -></listitem> -<listitem -><para -><filename ->/usr/src/...</filename -> (any other packages)</para -></listitem> +<listitem><para><filename>/usr/src/tdesupport</filename></para></listitem> +<listitem><para><filename>/usr/src/tdelibs</filename></para></listitem> +<listitem><para><filename>/usr/src/tdebase</filename></para></listitem> +<listitem><para><filename>/usr/src/...</filename> (any other packages)</para></listitem> </itemizedlist> -<para ->Make sure you have write permissions to <filename ->/opt/kde</filename ->.</para> +<para>Make sure you have write permissions to <filename>/opt/kde</filename>.</para> -<para ->Next you must compile and install the packages using the following: </para> +<para>Next you must compile and install the packages using the following: </para> <procedure> -<step -><para -><command ->cd</command -> into the folder of the package, you want to install (see above)</para -></step> -<step -><para -><command ->./configure</command -> (with the options you want to apply)</para -></step> -<step -><para -><command ->make</command -></para -></step> -<step -><para -><command ->make install</command -></para -></step> +<step><para><command>cd</command> into the folder of the package, you want to install (see above)</para></step> +<step><para><command>./configure</command> (with the options you want to apply)</para></step> +<step><para><command>make</command></para></step> +<step><para><command>make install</command></para></step> </procedure> -<para ->Apply the above steps to every package you want to install.</para> +<para>Apply the above steps to every package you want to install.</para> -<note -><para ->These instructions can be used for almost every source package available, not just KDE packages. </para -></note> +<note><para>These instructions can be used for almost every source package available, not just KDE packages. </para></note> -<para ->Every configure script has several options available. Some are common between the packages while others are specific to an individual package. The following is a small part of the result of <command ->configure <option ->--help</option -></command -> in tdelibs:</para> +<para>Every configure script has several options available. Some are common between the packages while others are specific to an individual package. The following is a small part of the result of <command>configure <option>--help</option></command> in tdelibs:</para> -<screen -><computeroutput> +<screen><computeroutput> Installation directories: --prefix=PREFIX install architecture-independent files in PREFIX [/usr/local/kde-cvs] @@ -604,113 +197,45 @@ Optional Features: --enable-strict compiles with strict compiler options (may not work!) --disable-warnings disables compilation with -Wall and similar ... -</computeroutput -> +</computeroutput> </screen> -<para ->Several options are not required and are only useful as workarounds for known problems (⪚ <option ->--disable-FEATURE</option ->). Since some are important options, for instance <emphasis ->--with-shadow</emphasis ->, you should always check the available options.</para> - -<para ->An important option is <option ->--prefix</option ->. This option specifies the path where configure should install (for tdesupport and tdelibs) or where to look for libraries (for the other packages). By default, configure will look in <filename ->/usr/local/kde</filename -> . If you want to install &kde; into <filename ->/opt/kde</filename ->, you have to use <command ->configure <option ->--prefix /opt/kde</option -></command ->.</para> - -<para ->If you have installed the &Qt; libraries in an uncommon place, for instance in <filename ->$HOME/src/qt</filename ->, you must use <command ->configure <option ->--with-qt-dir=$HOME/src/qt</option -></command ->. By default configure looks in the most common places for &Qt; before it gives up.</para> - -<para ->If you have problems that you are not able to solve, send a copy of the <filename ->config.log</filename -> file to the address given in the offending package's <filename ->README</filename -> file.</para> - -<para ->You must install KDE in the following order: arts, tdelibs, then the application packages (for example tdebase). All the application packages should only depend on tdelibs, so you can compile them at the same time (if you have a powerful machine).</para> - -<para ->If you want to take advantage of multiprocessor systems, try <command ->make <option -> -j <replaceable ->Number of processors</replaceable -></option -></command -> instead of <command ->make</command ->. </para> +<para>Several options are not required and are only useful as workarounds for known problems (⪚ <option>--disable-FEATURE</option>). Since some are important options, for instance <emphasis>--with-shadow</emphasis>, you should always check the available options.</para> + +<para>An important option is <option>--prefix</option>. This option specifies the path where configure should install (for tdesupport and tdelibs) or where to look for libraries (for the other packages). By default, configure will look in <filename>/usr/local/kde</filename> . If you want to install &kde; into <filename>/opt/kde</filename>, you have to use <command>configure <option>--prefix /opt/kde</option></command>.</para> + +<para>If you have installed the &Qt; libraries in an uncommon place, for instance in <filename>$HOME/src/qt</filename>, you must use <command>configure <option>--with-qt-dir=$HOME/src/qt</option></command>. By default configure looks in the most common places for &Qt; before it gives up.</para> + +<para>If you have problems that you are not able to solve, send a copy of the <filename>config.log</filename> file to the address given in the offending package's <filename>README</filename> file.</para> + +<para>You must install KDE in the following order: arts, tdelibs, then the application packages (for example tdebase). All the application packages should only depend on tdelibs, so you can compile them at the same time (if you have a powerful machine).</para> + +<para>If you want to take advantage of multiprocessor systems, try <command>make <option> -j <replaceable>Number of processors</replaceable></option></command> instead of <command>make</command>. </para> <sect2> -<title ->Platform Specific Building Notes </title> +<title>Platform Specific Building Notes </title> <sect3> -<title ->Linux </title> - -<para ->For &Linux;, most of the utilities needed to build &kde; can be found either at <ulink url="ftp://sunsite.unc.edu/pub/Linux/GCC" ->ftp://sunsite.unc.edu/pub/Linux/GCC</ulink -> or <ulink url="ftp://sunsite.unc.edu/pub/GNU" ->ftp://sunsite.unc.edu/pub/GNU</ulink ->. The Qt libraries can be found at <ulink url="ftp://ftp.troll.no/pub/qt/source" ->ftp://ftp.troll.no/pub/qt/source</ulink ->, available as source code. Detailed instructions on how to install them are provided. Include files for X11 programs should be available at <ulink url="ftp://ftp.xfree86.org" ->ftp://ftp.xfree86.org</ulink -> in the xdevel section. </para> +<title>Linux </title> + +<para>For &Linux;, most of the utilities needed to build &kde; can be found either at <ulink url="ftp://sunsite.unc.edu/pub/Linux/GCC">ftp://sunsite.unc.edu/pub/Linux/GCC</ulink> or <ulink url="ftp://sunsite.unc.edu/pub/GNU">ftp://sunsite.unc.edu/pub/GNU</ulink>. The Qt libraries can be found at <ulink url="ftp://ftp.troll.no/pub/qt/source">ftp://ftp.troll.no/pub/qt/source</ulink>, available as source code. Detailed instructions on how to install them are provided. Include files for X11 programs should be available at <ulink url="ftp://ftp.xfree86.org">ftp://ftp.xfree86.org</ulink> in the xdevel section. </para> </sect3> </sect2> </sect1> <sect1 id="suse-install"> -<title ->Required Changes To Your Configuration Files </title> -<para ->After you have placed the KDE binaries into their destination folder, there are a few adjustments you must make to your startup scripts. </para> -<para ->The following procedure was tested on SuSE Linux 5.0, and should be compatible with the other popular UNIX's as well. <emphasis ->Always make backups of configuration files before changing them!</emphasis -> Add the following to the end of your /etc/profile: </para> -<para -> -<screen ->export PATH=$PATH:/opt/kde/bin +<title>Required Changes To Your Configuration Files </title> +<para>After you have placed the KDE binaries into their destination folder, there are a few adjustments you must make to your startup scripts. </para> +<para>The following procedure was tested on SuSE Linux 5.0, and should be compatible with the other popular UNIX's as well. <emphasis>Always make backups of configuration files before changing them!</emphasis> Add the following to the end of your /etc/profile: </para> +<para> +<screen>export PATH=$PATH:/opt/kde/bin export TDEDIR=/opt/kde </screen> </para> -<para ->Next, edit the .xinitrc file in your home folder. Look for the line that calls your window manager and replace it with <literal ->starttde</literal ->.</para> -<para ->Now that everything needed to run KDE has been installed, you can go on to chapter 4 where you will start KDE for the first time. If something goes wrong, you may need to compile KDE on your own. Read<emphasis -> <link linkend="source-distribution" ->Using Source Compilation to Install on Top of Other Systems</link -> </emphasis ->for more information. </para> -<para ->We have made the installation as bulletproof as possible, so you should not encounter any serious problems unless your configuration is exotic. If you do experience difficulties feel free to use <link linkend="mailing-lists" ->the KDE mailing lists</link -> </para> +<para>Next, edit the .xinitrc file in your home folder. Look for the line that calls your window manager and replace it with <literal>starttde</literal>.</para> +<para>Now that everything needed to run KDE has been installed, you can go on to chapter 4 where you will start KDE for the first time. If something goes wrong, you may need to compile KDE on your own. Read<emphasis> <link linkend="source-distribution">Using Source Compilation to Install on Top of Other Systems</link> </emphasis>for more information. </para> +<para>We have made the installation as bulletproof as possible, so you should not encounter any serious problems unless your configuration is exotic. If you do experience difficulties feel free to use <link linkend="mailing-lists">the KDE mailing lists</link> </para> </sect1> </chapter> <!-- diff --git a/tde-i18n-en_GB/docs/tdebase/userguide/intro.docbook b/tde-i18n-en_GB/docs/tdebase/userguide/intro.docbook index e1900a1800b..a3cb77bc823 100644 --- a/tde-i18n-en_GB/docs/tdebase/userguide/intro.docbook +++ b/tde-i18n-en_GB/docs/tdebase/userguide/intro.docbook @@ -1,21 +1,15 @@ <chapter id="introduction"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->Welcome to the K Desktop Environment User Guide.</para> +<para>Welcome to the K Desktop Environment User Guide.</para> -<para ->This book is intended to be an introduction to the K Desktop Environment as a whole, with a broad description of the user interface, some practical examples on how to use &kde; for daily work, and some hints on how to customise the &kde; desktop.</para> +<para>This book is intended to be an introduction to the K Desktop Environment as a whole, with a broad description of the user interface, some practical examples on how to use &kde; for daily work, and some hints on how to customise the &kde; desktop.</para> -<para ->Included is a table of shortcuts, and some tips and tricks intended to help you find your way around quickly and efficiently.</para> +<para>Included is a table of shortcuts, and some tips and tricks intended to help you find your way around quickly and efficiently.</para> -<para ->This book is not a guide to the use of the individual applications, as they each have their own User Manual. However, &kde; is an integrated environment — what you learn in this manual and in your own exploration of &kde;'s interface is consistent and readily transferable between &kde; applications.</para> +<para>This book is not a guide to the use of the individual applications, as they each have their own User Manual. However, &kde; is an integrated environment — what you learn in this manual and in your own exploration of &kde;'s interface is consistent and readily transferable between &kde; applications.</para> -<para ->This book also explores some of the philosophy behind &kde; and some of its history, and rounds out with how to find more information, should you need it.</para> +<para>This book also explores some of the philosophy behind &kde; and some of its history, and rounds out with how to find more information, should you need it.</para> </chapter> <!-- diff --git a/tde-i18n-en_GB/docs/tdebase/userguide/more-help.docbook b/tde-i18n-en_GB/docs/tdebase/userguide/more-help.docbook index a62047b4dab..00f24de827b 100644 --- a/tde-i18n-en_GB/docs/tdebase/userguide/more-help.docbook +++ b/tde-i18n-en_GB/docs/tdebase/userguide/more-help.docbook @@ -1,54 +1,29 @@ <chapter id="more-help"> -<title ->Further Help</title> +<title>Further Help</title> <sect1 id="mailing-lists"> -<title ->Other Sources for Help </title> +<title>Other Sources for Help </title> -<para ->Take a look at the &kde-http; for the most up-to-date information available about &kde; on the web. You may also want to subscribe to our mailing lists. </para> +<para>Take a look at the &kde-http; for the most up-to-date information available about &kde; on the web. You may also want to subscribe to our mailing lists. </para> -<para ->You can subscribe at the web pages listed below:</para> +<para>You can subscribe at the web pages listed below:</para> <simplelist> -<member ->&kde; announcements - <ulink url="http://mail.kde.org/mailman/listinfo/kde-announce" -> http://mail.kde.org/mailman/listinfo/kde-announce</ulink -></member> +<member>&kde; announcements - <ulink url="http://mail.kde.org/mailman/listinfo/kde-announce"> http://mail.kde.org/mailman/listinfo/kde-announce</ulink></member> -<member ->&kde; users' mailing list - <ulink url="http://mail.kde.org/mailman/listinfo/kde" -> http://mail.kde.org/mailman/listinfo/kde</ulink -></member> +<member>&kde; users' mailing list - <ulink url="http://mail.kde.org/mailman/listinfo/kde"> http://mail.kde.org/mailman/listinfo/kde</ulink></member> -<member ->KDE developers' mailing list - <ulink url="http://mail.kde.org/mailman/listinfo/kde-devel" -> http://mail.kde.org/mailman/listinfo/kde-devel</ulink -></member> +<member>KDE developers' mailing list - <ulink url="http://mail.kde.org/mailman/listinfo/kde-devel"> http://mail.kde.org/mailman/listinfo/kde-devel</ulink></member> -<member ->KDE look and feel discussions - <ulink url="http://mail.kde.org/mailman/listinfo/kde-look" -> http://mail.kde.org/mailman/listinfo/kde-look </ulink -></member> +<member>KDE look and feel discussions - <ulink url="http://mail.kde.org/mailman/listinfo/kde-look"> http://mail.kde.org/mailman/listinfo/kde-look </ulink></member> -<member ->KDE licensing questions - <ulink url="http://mail.kde.org/mailman/listinfo/kde-licensing" -> http://mail.kde.org/mailman/listinfo/kde-licensing </ulink -></member> +<member>KDE licensing questions - <ulink url="http://mail.kde.org/mailman/listinfo/kde-licensing"> http://mail.kde.org/mailman/listinfo/kde-licensing </ulink></member> -<member ->KDE Documenters' list - <ulink url="http://mail.kde.org/mailman/listinfo/kde-doc-english" -> http://mail.kde.org/mailman/listinfo/kde-doc-english </ulink -></member> +<member>KDE Documenters' list - <ulink url="http://mail.kde.org/mailman/listinfo/kde-doc-english"> http://mail.kde.org/mailman/listinfo/kde-doc-english </ulink></member> </simplelist> -<para ->Many &kde; applications and sub-projects maintain more specific lists for themselves. You can find a complete list of archives at <ulink url="http://lists.kde.org/" ->http://lists.kde.org/</ulink ->.</para> +<para>Many &kde; applications and sub-projects maintain more specific lists for themselves. You can find a complete list of archives at <ulink url="http://lists.kde.org/">http://lists.kde.org/</ulink>.</para> </sect1> </chapter> diff --git a/tde-i18n-en_GB/docs/tdebase/userguide/notices-trademarks.docbook b/tde-i18n-en_GB/docs/tdebase/userguide/notices-trademarks.docbook index 49fda79a921..dad2bc61317 100644 --- a/tde-i18n-en_GB/docs/tdebase/userguide/notices-trademarks.docbook +++ b/tde-i18n-en_GB/docs/tdebase/userguide/notices-trademarks.docbook @@ -1,84 +1,45 @@ <appendix id="legal-notices-and-trademarks"> -<title ->Legal Notices</title> +<title>Legal Notices</title> <sect1 id="legal-status"> -<title ->Licence</title> +<title>Licence</title> -<para ->&kde; is open source software, and all of &kde; is released under free licenses such as the GPL.</para> +<para>&kde; is open source software, and all of &kde; is released under free licenses such as the GPL.</para> </sect1> <sect1 id="trademarks-list"> -<title ->Trademarks</title> +<title>Trademarks</title> -<!-- <para ->&kde; and <quote ->K Desktop Environment</quote -> are registered -trademarks of KDE e.V.</para -> --> +<!-- <para>&kde; and <quote>K Desktop Environment</quote> are registered +trademarks of KDE e.V.</para> --> -<para ->All trademarks mentioned on this web server or in &kde; documentation are recognised as belonging to their respective owners, including but not limited to:</para> +<para>All trademarks mentioned on this web server or in &kde; documentation are recognised as belonging to their respective owners, including but not limited to:</para> <simplelist> -<member ->&AIX; is a registered trademark of IBM Corporation</member> -<member ->&CSS;, &XHTML;, &XSL; and &XML; are common law trademarks of the Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, or Keio University on behalf of the World Wide Web Consortium.</member> -<member ->&Handspring; and &Visor; are trademarks of Handspring, Inc. and may be registered in certain jurisdictions.</member> -<member ->&Hewlett-Packard;, &HP; &LaserJet;,&HP-UX; PCL, PCL 5 and PCL 6 are U.S. registered trademarks of Hewlett Packard Company.</member> -<member ->&IRIX; is a registered trademark and &SGI; is a trademark of Silicon Graphics, Inc.</member> -<member ->&Java; and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.</member> -<member ->&Jini; and all Jini-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.</member> -<member ->&Linux; is a registered trademark of Linus Torvalds</member> -<member ->&LinuxPPC; is a trademark of LinuxPPC Inc.</member> -<member ->&Mac; is a trademark of Apple Computer Inc., registered in the United States and other countries.</member> -<member ->&Mandrake; and &Linux-Mandrake; are trademarks of MandrakeSoft.</member> -<member ->&Netscape; is a registered trademark of Netscape Communications Corporation in the United States and other countries.</member> -<member ->&NeXTSTEP; is a trademark of NeXT Software, Inc., registered in the U.S. and other countries. </member> -<member ->&PalmOS;, &HotSync; and &PalmPilot; are registered trademarks of Palm, Inc.</member> -<member ->&PostScript; is a registered trademark of Adobe Systems Incorporated.</member> -<member ->&Qt; is a trademark of Trolltech AS</member> -<member ->&RedHat; and all Red Hat-based trademarks and logos are trademarks or registered trademarks of Red Hat, Inc. in the United States and other countries. </member> -<member ->&Sendmail; is a registered trademark of Sendmail Inc.</member> -<member ->&Solaris;, <trademark ->Sun</trademark -> and <trademark ->SunOS</trademark -> are trademarks of Sun Microsystems Inc.</member> -<member ->&SuSE; is a registered trademark of SuSE AG</member> -<member ->&ThreeCom; is a registered trademark of 3com corporation in the United States and other countries.</member> -<member ->&Motif;, &UNIX; and the <quote ->X</quote -> device are registered trademark of The Open Group in the United States and other countries</member> -<member ->&Microsoft; and &Windows; are registered trademarks of the Microsoft Corporation</member> -<member ->XFree86 is pending trademark registration by The XFree86 Project, Inc.</member> +<member>&AIX; is a registered trademark of IBM Corporation</member> +<member>&CSS;, &XHTML;, &XSL; and &XML; are common law trademarks of the Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, or Keio University on behalf of the World Wide Web Consortium.</member> +<member>&Handspring; and &Visor; are trademarks of Handspring, Inc. and may be registered in certain jurisdictions.</member> +<member>&Hewlett-Packard;, &HP; &LaserJet;,&HP-UX; PCL, PCL 5 and PCL 6 are U.S. registered trademarks of Hewlett Packard Company.</member> +<member>&IRIX; is a registered trademark and &SGI; is a trademark of Silicon Graphics, Inc.</member> +<member>&Java; and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.</member> +<member>&Jini; and all Jini-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.</member> +<member>&Linux; is a registered trademark of Linus Torvalds</member> +<member>&LinuxPPC; is a trademark of LinuxPPC Inc.</member> +<member>&Mac; is a trademark of Apple Computer Inc., registered in the United States and other countries.</member> +<member>&Mandrake; and &Linux-Mandrake; are trademarks of MandrakeSoft.</member> +<member>&Netscape; is a registered trademark of Netscape Communications Corporation in the United States and other countries.</member> +<member>&NeXTSTEP; is a trademark of NeXT Software, Inc., registered in the U.S. and other countries. </member> +<member>&PalmOS;, &HotSync; and &PalmPilot; are registered trademarks of Palm, Inc.</member> +<member>&PostScript; is a registered trademark of Adobe Systems Incorporated.</member> +<member>&Qt; is a trademark of Trolltech AS</member> +<member>&RedHat; and all Red Hat-based trademarks and logos are trademarks or registered trademarks of Red Hat, Inc. in the United States and other countries. </member> +<member>&Sendmail; is a registered trademark of Sendmail Inc.</member> +<member>&Solaris;, <trademark>Sun</trademark> and <trademark>SunOS</trademark> are trademarks of Sun Microsystems Inc.</member> +<member>&SuSE; is a registered trademark of SuSE AG</member> +<member>&ThreeCom; is a registered trademark of 3com corporation in the United States and other countries.</member> +<member>&Motif;, &UNIX; and the <quote>X</quote> device are registered trademark of The Open Group in the United States and other countries</member> +<member>&Microsoft; and &Windows; are registered trademarks of the Microsoft Corporation</member> +<member>XFree86 is pending trademark registration by The XFree86 Project, Inc.</member> </simplelist> <!-- Others that needs to be covered above: diff --git a/tde-i18n-en_GB/docs/tdebase/userguide/shortcuts.docbook b/tde-i18n-en_GB/docs/tdebase/userguide/shortcuts.docbook index 39b1c62c17f..aad11c3e350 100644 --- a/tde-i18n-en_GB/docs/tdebase/userguide/shortcuts.docbook +++ b/tde-i18n-en_GB/docs/tdebase/userguide/shortcuts.docbook @@ -1,337 +1,154 @@ <chapter id="shortcuts"> -<title ->Tips & Tricks for Your Daily Work </title> +<title>Tips & Tricks for Your Daily Work </title> <epigraph> -<attribution ->Fortune Cookies</attribution> -<para ->Everyone can make an omelette with eggs. The trick is to make one with none.</para> +<attribution>Fortune Cookies</attribution> +<para>Everyone can make an omelette with eggs. The trick is to make one with none.</para> </epigraph> -<para ->Nearly everyone can use &kde;; this is why the developers made it. There are no cryptic switches with which to cope, and few configuration files you need edit in <acronym ->ASCII</acronym -> style. However, there are some ways you can do your work more elegantly, saving you time for the truly important things, like &ksirtet;.</para> +<para>Nearly everyone can use &kde;; this is why the developers made it. There are no cryptic switches with which to cope, and few configuration files you need edit in <acronym>ASCII</acronym> style. However, there are some ways you can do your work more elegantly, saving you time for the truly important things, like &ksirtet;.</para> <sect1 id="shortcut-table"> -<title ->Shortcut Table </title> +<title>Shortcut Table </title> <variablelist> <varlistentry> -<term -><keycombo ->&Alt;<keycap ->Tab</keycap -> </keycombo -> or <keycombo ->&Alt;&Shift;<keycap ->Tab</keycap -></keycombo -></term> -<listitem -><para ->Cycle through the windows </para -></listitem> +<term><keycombo>&Alt;<keycap>Tab</keycap> </keycombo> or <keycombo>&Alt;&Shift;<keycap>Tab</keycap></keycombo></term> +<listitem><para>Cycle through the windows </para></listitem> </varlistentry> <varlistentry> -<term -><keycombo ->&Ctrl;<keycap ->Tab</keycap -></keycombo -> or <keycombo ->&Ctrl;&Shift;<keycap ->Tab</keycap -> </keycombo -></term> -<listitem -><para ->Cycle through your desktops </para -></listitem> +<term><keycombo>&Ctrl;<keycap>Tab</keycap></keycombo> or <keycombo>&Ctrl;&Shift;<keycap>Tab</keycap> </keycombo></term> +<listitem><para>Cycle through your desktops </para></listitem> </varlistentry> <varlistentry> -<term -><keycombo ->&Alt;<keycap ->F2</keycap -> </keycombo -></term> -<listitem -><para ->Mini Command line</para -></listitem> +<term><keycombo>&Alt;<keycap>F2</keycap> </keycombo></term> +<listitem><para>Mini Command line</para></listitem> </varlistentry> <varlistentry> -<term -><keycombo ->&Alt;<keycap ->F3</keycap -></keycombo -></term> -<listitem -><para ->Window Menu </para -></listitem> +<term><keycombo>&Alt;<keycap>F3</keycap></keycombo></term> +<listitem><para>Window Menu </para></listitem> </varlistentry> <varlistentry> -<term -><keycombo ->&Alt;<keycap ->F4</keycap -> </keycombo -></term> -<listitem -><para ->Close the current window </para -></listitem> +<term><keycombo>&Alt;<keycap>F4</keycap> </keycombo></term> +<listitem><para>Close the current window </para></listitem> </varlistentry> <varlistentry> -<term -><keycombo ->&Ctrl;<keycap ->F{1..8}</keycap -></keycombo -></term> -<listitem -><para ->Switch to a specific desktop </para -></listitem> +<term><keycombo>&Ctrl;<keycap>F{1..8}</keycap></keycombo></term> +<listitem><para>Switch to a specific desktop </para></listitem> </varlistentry> <varlistentry> -<term -><keycombo ->&Ctrl;&Alt;<keycap ->Esc</keycap -> </keycombo -></term> -<listitem -><para ->Window destroyer (every window you click on will be destroyed). Press this key combination again to cancel the killer cursor. </para -></listitem> +<term><keycombo>&Ctrl;&Alt;<keycap>Esc</keycap> </keycombo></term> +<listitem><para>Window destroyer (every window you click on will be destroyed). Press this key combination again to cancel the killer cursor. </para></listitem> </varlistentry> <varlistentry> -<term -><keycombo ->&Ctrl;&Alt;<keycap ->Backspace</keycap -> </keycombo -></term> -<listitem -><para ->This exits &kde; (without saving!) Use this as a last resort </para -></listitem> +<term><keycombo>&Ctrl;&Alt;<keycap>Backspace</keycap> </keycombo></term> +<listitem><para>This exits &kde; (without saving!) Use this as a last resort </para></listitem> </varlistentry> <varlistentry> -<term -><keycombo ->&Ctrl;&Alt;<keycap ->Numpad +</keycap -></keycombo -></term> -<listitem -><para ->Cycles to the next screen resolution. You need to configure this in your &X-Server; configuration for it to work. </para -></listitem> +<term><keycombo>&Ctrl;&Alt;<keycap>Numpad +</keycap></keycombo></term> +<listitem><para>Cycles to the next screen resolution. You need to configure this in your &X-Server; configuration for it to work. </para></listitem> </varlistentry> <varlistentry> -<term -><keycombo ->&Ctrl;&Alt;<keycap ->Numpad -</keycap -> </keycombo -></term> -<listitem -><para ->Cycles to the previous screen resolution. You need to configure this in your &X-Server; configuration for it to work.</para -></listitem> +<term><keycombo>&Ctrl;&Alt;<keycap>Numpad -</keycap> </keycombo></term> +<listitem><para>Cycles to the previous screen resolution. You need to configure this in your &X-Server; configuration for it to work.</para></listitem> </varlistentry> </variablelist> </sect1> <sect1 id="mouse-techniques"> -<title ->Mouse Techniques </title> +<title>Mouse Techniques </title> -<para ->Note these are defaults only, and you can customise them to your liking.</para> +<para>Note these are defaults only, and you can customise them to your liking.</para> <variablelist> <varlistentry> -<term ->Clicking on the border or the titlebar</term> +<term>Clicking on the border or the titlebar</term> <listitem> <variablelist> <varlistentry> -<term -><mousebutton ->Left</mousebutton -></term> -<listitem -><para ->Activates and raises the window.</para -></listitem> +<term><mousebutton>Left</mousebutton></term> +<listitem><para>Activates and raises the window.</para></listitem> </varlistentry> <varlistentry> -<term -><mousebutton ->Middle</mousebutton -></term> -<listitem -><para ->Lowers the window</para -></listitem> +<term><mousebutton>Middle</mousebutton></term> +<listitem><para>Lowers the window</para></listitem> </varlistentry> <varlistentry> -<term -><mousebutton ->Right</mousebutton -></term> -<listitem -><para ->Shows the <guimenu ->Window menu</guimenu -> if the window is active, otherwise activates the window.</para -></listitem> +<term><mousebutton>Right</mousebutton></term> +<listitem><para>Shows the <guimenu>Window menu</guimenu> if the window is active, otherwise activates the window.</para></listitem> </varlistentry> </variablelist> </listitem> </varlistentry> <varlistentry> -<term ->Doubleclick on the window title</term> -<listitem -><para ->Shades the window (<quote ->rolls it up</quote -> so only the titlebar is visible).</para -></listitem> +<term>Doubleclick on the window title</term> +<listitem><para>Shades the window (<quote>rolls it up</quote> so only the titlebar is visible).</para></listitem> </varlistentry> <varlistentry> -<term ->Drag on the titlebar</term> -<listitem -><para ->Moves the window around.</para -></listitem> +<term>Drag on the titlebar</term> +<listitem><para>Moves the window around.</para></listitem> </varlistentry> <varlistentry> -<term ->Drag on corners or edges</term> -<listitem -><para ->Resizes the window.</para -></listitem> +<term>Drag on corners or edges</term> +<listitem><para>Resizes the window.</para></listitem> </varlistentry> <varlistentry> -<term -><keycombo ->&Alt;<mousebutton ->Left</mousebutton -></keycombo -> Button</term> -<listitem -><para ->Moves the window around.</para -></listitem> +<term><keycombo>&Alt;<mousebutton>Left</mousebutton></keycombo> Button</term> +<listitem><para>Moves the window around.</para></listitem> </varlistentry> <varlistentry> -<term -><keycombo ->&Alt;<mousebutton ->Middle</mousebutton -> </keycombo -> Button</term> -<listitem -><para ->Raises the window.</para -></listitem> +<term><keycombo>&Alt;<mousebutton>Middle</mousebutton> </keycombo> Button</term> +<listitem><para>Raises the window.</para></listitem> </varlistentry> <varlistentry> -<term -><keycombo ->&Alt;<mousebutton ->Right</mousebutton -> </keycombo -> Button</term> -<listitem -><para ->Resizes the window in the direction you drag the mouse.</para -></listitem> +<term><keycombo>&Alt;<mousebutton>Right</mousebutton> </keycombo> Button</term> +<listitem><para>Resizes the window in the direction you drag the mouse.</para></listitem> </varlistentry> <varlistentry> -<term ->Click on the Icon on the top left</term> -<listitem -><para ->Close the application</para -></listitem> +<term>Click on the Icon on the top left</term> +<listitem><para>Close the application</para></listitem> </varlistentry> <varlistentry> -<term ->Click on the Sticky Button</term> -<listitem -><para ->toggles sticky </para -></listitem> +<term>Click on the Sticky Button</term> +<listitem><para>toggles sticky </para></listitem> </varlistentry> <varlistentry> -<term ->Clicking on Maximise</term> +<term>Clicking on Maximise</term> <listitem> <variablelist> <varlistentry> -<term -><mousebutton ->Left</mousebutton -></term> -<listitem -><para ->Maximises the window</para -></listitem> +<term><mousebutton>Left</mousebutton></term> +<listitem><para>Maximises the window</para></listitem> </varlistentry> <varlistentry> -<term -><mousebutton ->Middle</mousebutton -></term> -<listitem -><para ->Maximises only vertically</para -></listitem> +<term><mousebutton>Middle</mousebutton></term> +<listitem><para>Maximises only vertically</para></listitem> </varlistentry> <varlistentry> -<term -><mousebutton ->Right</mousebutton -></term> -<listitem -><para ->Maximises horizontally</para -></listitem> +<term><mousebutton>Right</mousebutton></term> +<listitem><para>Maximises horizontally</para></listitem> </varlistentry> </variablelist> </listitem> diff --git a/tde-i18n-en_GB/docs/tdebase/userguide/staff.docbook b/tde-i18n-en_GB/docs/tdebase/userguide/staff.docbook index 76bdd4d3a82..218e936783d 100644 --- a/tde-i18n-en_GB/docs/tdebase/userguide/staff.docbook +++ b/tde-i18n-en_GB/docs/tdebase/userguide/staff.docbook @@ -1,138 +1,66 @@ <chapter id="docu-staff"> -<title ->Epilogue </title> +<title>Epilogue </title> <epigraph> -<attribution ->The end of Evita</attribution> -<para ->She had her moments, she had some style, the best show in town was the crowd, outside the Casa Rosada crying 'Eva Peron'; but that's all gone now...</para -></epigraph> +<attribution>The end of Evita</attribution> +<para>She had her moments, she had some style, the best show in town was the crowd, outside the Casa Rosada crying 'Eva Peron'; but that's all gone now...</para></epigraph> -<para ->We hope that you found this documentation useful, informative and perhaps even entertaining. The following things are not necessary to understand the Trinity Desktop Environment, but you still may want to read it. </para> +<para>We hope that you found this documentation useful, informative and perhaps even entertaining. The following things are not necessary to understand the Trinity Desktop Environment, but you still may want to read it. </para> <sect1 id="the-k-documentation-staff"> -<title ->The K Documentation Staff </title> +<title>The K Documentation Staff </title> -<para ->This User Guide has been updated for 3.0, and is currently maintained by Lauri Watts <email ->lauri@kde.org</email -></para> +<para>This User Guide has been updated for 3.0, and is currently maintained by Lauri Watts <email>lauri@kde.org</email></para> -<para ->Others who have contributed to this guide.</para> +<para>Others who have contributed to this guide.</para> <itemizedlist> -<listitem -><para ->Pablo de Vicente <email ->vicente@oan.es</email ->, who updated the section regarding installing on Debian for KDE 2.0</para -></listitem> -<listitem -><para ->Andreas Buschka <email ->andi@circe.tops.net</email -></para -></listitem> -<listitem -><para ->Robert D. Williams <email ->rwilliam@kde.org</email -></para -></listitem> -<listitem -><para ->Poul Gerhard</para -></listitem> -<listitem -><para ->John Waalkes</para -></listitem> -<listitem -><para ->Vernon Wells</para -></listitem> -<listitem -><para ->Kay Lutz</para -></listitem> -<listitem -><para ->Stephan Kulow</para -></listitem> +<listitem><para>Pablo de Vicente <email>vicente@oan.es</email>, who updated the section regarding installing on Debian for KDE 2.0</para></listitem> +<listitem><para>Andreas Buschka <email>andi@circe.tops.net</email></para></listitem> +<listitem><para>Robert D. Williams <email>rwilliam@kde.org</email></para></listitem> +<listitem><para>Poul Gerhard</para></listitem> +<listitem><para>John Waalkes</para></listitem> +<listitem><para>Vernon Wells</para></listitem> +<listitem><para>Kay Lutz</para></listitem> +<listitem><para>Stephan Kulow</para></listitem> </itemizedlist> </sect1> <sect1 id="we-still-need-people"> -<title ->We still need people! </title> +<title>We still need people! </title> -<para ->KDE is a huge project, and every KDE supporter has already realised that. All of us are trying very hard to create a user interface that is easy to use and maybe also has the potential to make UNIX ready for the desktop PC. You have the chance to participate in this project too, and we would be thankful if you did. Developers and interested users communicate via several mailing lists described in <xref linkend="mailing-lists"/>. If you would like to help, please do so! We are still looking for helpers in the following departments: </para> +<para>KDE is a huge project, and every KDE supporter has already realised that. All of us are trying very hard to create a user interface that is easy to use and maybe also has the potential to make UNIX ready for the desktop PC. You have the chance to participate in this project too, and we would be thankful if you did. Developers and interested users communicate via several mailing lists described in <xref linkend="mailing-lists"/>. If you would like to help, please do so! We are still looking for helpers in the following departments: </para> <itemizedlist> -<listitem -><para ->Development (Libraries and Applications)</para -></listitem> -<listitem -><para ->Documentation</para -></listitem> -<listitem -><para ->Graphics</para -></listitem> -<listitem -><para ->Beta-Testing</para -></listitem> -<listitem -><para ->and everywhere else, too :-) </para -></listitem> +<listitem><para>Development (Libraries and Applications)</para></listitem> +<listitem><para>Documentation</para></listitem> +<listitem><para>Graphics</para></listitem> +<listitem><para>Beta-Testing</para></listitem> +<listitem><para>and everywhere else, too :-) </para></listitem> </itemizedlist> </sect1> <sect1 id="legal-notices"> -<title ->Legal notices </title> +<title>Legal notices </title> -<para ->This document contains copyrighted material from Andreas Buschka, Gerhard Poul and Robert David Williams. All trademarks and branded names mentioned are properties of their legal owners. </para> +<para>This document contains copyrighted material from Andreas Buschka, Gerhard Poul and Robert David Williams. All trademarks and branded names mentioned are properties of their legal owners. </para> </sect1> <sect1 id="sources-of-information-used-during-the-creat"> -<title ->Sources of information used during the creation of this book </title> +<title>Sources of information used during the creation of this book </title> -<para ->During the creation of this documentation, the authors used the following sources for information: </para> +<para>During the creation of this documentation, the authors used the following sources for information: </para> <itemizedlist> -<listitem -><para ->The KDE Mailing lists </para -></listitem> -<listitem -><para ->Various <filename ->README</filename -> and <abbrev ->HTML</abbrev -> help files that came with the KDE components </para -></listitem> +<listitem><para>The KDE Mailing lists </para></listitem> +<listitem><para>Various <filename>README</filename> and <abbrev>HTML</abbrev> help files that came with the KDE components </para></listitem> </itemizedlist> </sect1> <sect1 id="license"> -<title ->Licence</title> +<title>Licence</title> &underGPL; </sect1> </chapter> <!-- diff --git a/tde-i18n-en_GB/docs/tdebase/userguide/ug-faq.docbook b/tde-i18n-en_GB/docs/tdebase/userguide/ug-faq.docbook index 9a94f503c70..b5d6dd9bd13 100644 --- a/tde-i18n-en_GB/docs/tdebase/userguide/ug-faq.docbook +++ b/tde-i18n-en_GB/docs/tdebase/userguide/ug-faq.docbook @@ -1,110 +1,53 @@ <chapter id="frequently-asked-questions"> -<title ->Frequently Asked Questions About &kde; </title> +<title>Frequently Asked Questions About &kde; </title> <epigraph> -<attribution ->Batman Animated Series</attribution> -<para ->What are you?</para> -<para ->I'm your worst nightmare...</para> +<attribution>Batman Animated Series</attribution> +<para>What are you?</para> +<para>I'm your worst nightmare...</para> </epigraph> -<para ->There are some questions that are always raised on the &kde; mailing lists. To keep the traffic as low as possible (making the lists more readable), we have included them in this section. So please be kind and do not ask them in the mailing lists anymore - think of the quote above! </para> +<para>There are some questions that are always raised on the &kde; mailing lists. To keep the traffic as low as possible (making the lists more readable), we have included them in this section. So please be kind and do not ask them in the mailing lists anymore - think of the quote above! </para> <!-- pretty short list.. going to watch mailing lists a little, and see if there aren't any more questions that ought to be here --> <qandaset id="faq"> <qandaentry> -<question -><para ->What does <quote ->&kde;</quote -> stand for?</para -></question> -<answer -><para ->Originally the <emphasis ->K</emphasis -> stood for <emphasis ->Kool</emphasis ->, nowadays the K has no meaning and &kde; simply stands for the <emphasis ->K Desktop Environment</emphasis ->. &kde; is intended to be a collection of small tools, a window manager, a file manager and tools that bring all this together. It is created to make your life with &UNIX; easier. </para -></answer> +<question><para>What does <quote>&kde;</quote> stand for?</para></question> +<answer><para>Originally the <emphasis>K</emphasis> stood for <emphasis>Kool</emphasis>, nowadays the K has no meaning and &kde; simply stands for the <emphasis>K Desktop Environment</emphasis>. &kde; is intended to be a collection of small tools, a window manager, a file manager and tools that bring all this together. It is created to make your life with &UNIX; easier. </para></answer> </qandaentry> <qandaentry> -<question -><para ->I cannot compile package xxx</para -></question> +<question><para>I cannot compile package xxx</para></question> <answer> -<para ->Always be sure that you have the newest version of the &kde; libraries installed. The software is in constant development, so the dependencies can change from one day to another if you are using <acronym ->CVS</acronym ->. For most users, using a released version is much more practical.</para> +<para>Always be sure that you have the newest version of the &kde; libraries installed. The software is in constant development, so the dependencies can change from one day to another if you are using <acronym>CVS</acronym>. For most users, using a released version is much more practical.</para> -<para ->Another problem could be that you are using a program written for a very old version of &kde;, which depends on outdated include files. Check in the source archive's <filename ->README</filename -> to see if it explains which version of &kde; the application is looking for. If that file doesn't exist, check the file dates. They should be more recent than your current &kde; version.</para> +<para>Another problem could be that you are using a program written for a very old version of &kde;, which depends on outdated include files. Check in the source archive's <filename>README</filename> to see if it explains which version of &kde; the application is looking for. If that file doesn't exist, check the file dates. They should be more recent than your current &kde; version.</para> </answer> </qandaentry> -<qandaentry -> +<qandaentry> -<question -><para ->What version of &kde; should I use for a stable desktop?</para -></question> -<answer -><para ->One can, in general, obtain &kde; in many ways. Obtaining pre-compiled binaries in a package format (rpm,deb,tgz) labeled with a particular version (⪚ 3.2) is the best way to encourage stability on your &kde; desktop.</para> +<question><para>What version of &kde; should I use for a stable desktop?</para></question> +<answer><para>One can, in general, obtain &kde; in many ways. Obtaining pre-compiled binaries in a package format (rpm,deb,tgz) labeled with a particular version (⪚ 3.2) is the best way to encourage stability on your &kde; desktop.</para> </answer> </qandaentry> -<qandaentry -> -<question -><para ->But I heard that my problem/wishlist item is <quote ->already in <acronym ->CVS</acronym -></quote ->. I want to get my hands on the new features, why shouldn't I try <acronym ->CVS</acronym ->?</para -></question> +<qandaentry> +<question><para>But I heard that my problem/wishlist item is <quote>already in <acronym>CVS</acronym></quote>. I want to get my hands on the new features, why shouldn't I try <acronym>CVS</acronym>?</para></question> <answer> -<para ->The price of stability is that one must wait for each release to get new features. Conversely the price of being the first to see new features, is that you risk stability. &kde; has a fairly frequent release schedule, and stability of released versions is a particular focus. For the majority of &kde; users, unless you are planning to help develop &kde;, there is little advantage to running development versions of &kde;.</para> +<para>The price of stability is that one must wait for each release to get new features. Conversely the price of being the first to see new features, is that you risk stability. &kde; has a fairly frequent release schedule, and stability of released versions is a particular focus. For the majority of &kde; users, unless you are planning to help develop &kde;, there is little advantage to running development versions of &kde;.</para> -<para ->However, there is always a place for experienced users who know what they are letting themselves in for, and are willing to report bugs found. If this is you, then there is no reason not to try the <acronym ->CVS</acronym -> versions. Be prepared for things to break occasionally, <acronym ->CVS</acronym -> gives you a snapshot of source code that is currently being worked on.</para> +<para>However, there is always a place for experienced users who know what they are letting themselves in for, and are willing to report bugs found. If this is you, then there is no reason not to try the <acronym>CVS</acronym> versions. Be prepared for things to break occasionally, <acronym>CVS</acronym> gives you a snapshot of source code that is currently being worked on.</para> -<para ->These are daily snapshots of whatever the developers are working on, and some things are guaranteed to be broken.</para -> +<para>These are daily snapshots of whatever the developers are working on, and some things are guaranteed to be broken.</para> <warning> -<para -><emphasis ->Do not rely on <acronym ->CVS</acronym -> snapshots to maintain operational desktops</emphasis ->. You will get burned eventually!</para> +<para><emphasis>Do not rely on <acronym>CVS</acronym> snapshots to maintain operational desktops</emphasis>. You will get burned eventually!</para> </warning> </answer> diff --git a/tde-i18n-en_GB/docs/tdebase/visualdict/index.docbook b/tde-i18n-en_GB/docs/tdebase/visualdict/index.docbook index c9178c95461..a6b7bd0174f 100644 --- a/tde-i18n-en_GB/docs/tdebase/visualdict/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/visualdict/index.docbook @@ -3,8 +3,7 @@ "dtd/kdex.dtd" [ <!ENTITY kappname "Visual Guide to &kde;"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -> <!-- change language only here --> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> ]> @@ -12,57 +11,29 @@ <book lang="&language;"> <bookinfo> -<title ->The &kde; Visual Guide</title> +<title>The &kde; Visual Guide</title> <authorgroup> -<corpauthor ->The KDE Team </corpauthor> -<othercredit role="translator" -><firstname ->Malcolm</firstname -><surname ->Hunter</surname -><affiliation -><address -><email ->malcolm.hunter@gmx.co.uk</email -></address -></affiliation -><contrib ->Conversion to British English</contrib -></othercredit -> +<corpauthor>The KDE Team </corpauthor> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> </authorgroup> -<date ->2000-10-04</date> -<releaseinfo ->2.00.00</releaseinfo> +<date>2000-10-04</date> +<releaseinfo>2.00.00</releaseinfo> <copyright> -<year ->2000</year> -<holder ->The KDE Team</holder> +<year>2000</year> +<holder>The KDE Team</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<abstract -><para ->A visual guide to &kde;'s interface. This is a very early version of the document. Eventually, this will be a graphical tour of &kde;.</para -></abstract> +<abstract><para>A visual guide to &kde;'s interface. This is a very early version of the document. Eventually, this will be a graphical tour of &kde;.</para></abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->Visual</keyword> -<keyword ->Dictionary</keyword> -<keyword ->Guide</keyword> +<keyword>KDE</keyword> +<keyword>Visual</keyword> +<keyword>Dictionary</keyword> +<keyword>Guide</keyword> </keywordset> </bookinfo> @@ -73,23 +44,14 @@ <!-- dictionary on the i18n website, please make sure the translations here --> <!-- match that file exactly. --> -<title ->&kde; Visual Dictionary of terms</title> +<title>&kde; Visual Dictionary of terms</title> -<para ->This project was started to help unify the vocabulary used in &kde; documentation.</para> +<para>This project was started to help unify the vocabulary used in &kde; documentation.</para> -<para ->We provide this for you here as an aid to learning your way around the &kde; Graphical User Interface. These names have been standardised within &kde; documentation, so that you will always find interface items referred to in the same way.</para> +<para>We provide this for you here as an aid to learning your way around the &kde; Graphical User Interface. These names have been standardised within &kde; documentation, so that you will always find interface items referred to in the same way.</para> -<tip -><para ->The term <quote ->Widget</quote -> refers to the basic building block of a computer program's interface.</para> -<para ->Each widget operates in a similar manner each time it is used, but the effect that the widget has depends on its place within the program.</para -></tip> +<tip><para>The term <quote>Widget</quote> refers to the basic building block of a computer program's interface.</para> +<para>Each widget operates in a similar manner each time it is used, but the effect that the widget has depends on its place within the program.</para></tip> <!-- TODO: Widgets to add: combo buttons (eg, the 'back' button in konq), popup @@ -98,20 +60,16 @@ menus/context menus, passive popups, sidebar buttons? Perhaps list deprecated names, for search/replace purposes? --> <sect1 id="widget-table"> -<title ->Listing of Common &kde; Widgets</title> -<para ->Currently, this guide consists of a table of the names of the graphical elements often found in &kde; documentation, and an example of each one. </para> -<para ->Our hope, eventually, is to make this a much more complete document, which will take you on a visual tour of &kde;.</para> +<title>Listing of Common &kde; Widgets</title> +<para>Currently, this guide consists of a table of the names of the graphical elements often found in &kde; documentation, and an example of each one. </para> +<para>Our hope, eventually, is to make this a much more complete document, which will take you on a visual tour of &kde;.</para> <informaltable> <tgroup cols="2"> <tbody> <row> -<entry ->Button</entry> +<entry>Button</entry> <entry> <inlinemediaobject> <imageobject> @@ -122,8 +80,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->Check Boxes</entry> +<entry>Check Boxes</entry> <entry> <inlinemediaobject> <imageobject> @@ -134,8 +91,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->Colour Selector</entry> +<entry>Colour Selector</entry> <entry> <inlinemediaobject> <imageobject> @@ -146,8 +102,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->Combo Box</entry> +<entry>Combo Box</entry> <entry> <inlinemediaobject> <imageobject> @@ -158,8 +113,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->Dialogue Box</entry> +<entry>Dialogue Box</entry> <entry> <inlinemediaobject> <imageobject> @@ -170,8 +124,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->Drop Down Box</entry> +<entry>Drop Down Box</entry> <entry> <inlinemediaobject> <imageobject> @@ -182,8 +135,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->Icon List</entry> +<entry>Icon List</entry> <entry> <inlinemediaobject> <imageobject> @@ -194,8 +146,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->List Box</entry> +<entry>List Box</entry> <entry> <inlinemediaobject> <imageobject> @@ -206,8 +157,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->Menubar</entry> +<entry>Menubar</entry> <entry> <inlinemediaobject> <imageobject> @@ -218,8 +168,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->Progress Bar</entry> +<entry>Progress Bar</entry> <entry> <inlinemediaobject> <imageobject> @@ -230,8 +179,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->Radio Buttons</entry> +<entry>Radio Buttons</entry> <entry> <inlinemediaobject> <imageobject> @@ -242,8 +190,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->Scroll Bar</entry> +<entry>Scroll Bar</entry> <entry> <inlinemediaobject> <imageobject> @@ -254,8 +201,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->Slider</entry> +<entry>Slider</entry> <entry> <inlinemediaobject> <imageobject> @@ -266,8 +212,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->Spin Box</entry> +<entry>Spin Box</entry> <entry> <inlinemediaobject> <imageobject> @@ -278,8 +223,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->Status Bar</entry> +<entry>Status Bar</entry> <entry> <inlinemediaobject> <imageobject> @@ -290,8 +234,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->Text Box</entry> +<entry>Text Box</entry> <entry> <inlinemediaobject> <imageobject> @@ -303,8 +246,7 @@ Perhaps list deprecated names, for search/replace purposes? <row> -<entry ->Toolbar</entry> +<entry>Toolbar</entry> <entry> <inlinemediaobject> <imageobject> @@ -315,8 +257,7 @@ Perhaps list deprecated names, for search/replace purposes? </row> <row> -<entry ->Tree View</entry> +<entry>Tree View</entry> <entry> <inlinemediaobject> <imageobject> @@ -328,8 +269,7 @@ Perhaps list deprecated names, for search/replace purposes? <row> -<entry ->Window Titlebar</entry> +<entry>Window Titlebar</entry> <entry> <inlinemediaobject> <imageobject> @@ -345,13 +285,10 @@ Perhaps list deprecated names, for search/replace purposes? </sect1> </chapter> <chapter id="credits"> -<title ->Credits and Licences</title> -<para ->&kappname;</para> +<title>Credits and Licences</title> +<para>&kappname;</para> -<para ->Documentation by the KDE Documentation Team.</para> +<para>Documentation by the KDE Documentation Team.</para> &underFDL; </chapter> </book> |