[kde-doc-english] documentation backports for 3.5

[Burkhard Lück]

Hi,

I would like to backport some documentations from trunk to stable.

1. New docs I found so far
ksig (75 messages), kompare (280 messages)
Ok to backport?

2. Docs with bug fixes, changed and sometimes additional content and also ebn 
fixes like eg kbackgammon, kshisen, kpdf, kpercentage, ktouch, kturtle, juk, 
kaudiocreator, kmix, kscd. I suppose there will be some more docs in the other 
kde modules.
There should be no objections to backport this stuff.

3. Docs only with ebn, typo and markup fixes, in addons, admin, edu, games, 
graphics, multimedia all together 32 doc with about 100 fuzzies. There are 
more docs with these changes in the other modules.
I will not backport these docs, except you give me your explicit Ok to do so.

For all backports I can provide a plain text file with message number, 
msgid-previous and msgid-new for the fuzzy messages like the attached example 
for kmix.

Burkhard Lück
-------------- next part --------------

kmix.po

msg number: 15
msgid prev: Christian Esken & Matt Johnston
msgid new : Christian Esken & &Matt.Johnston;

msg number: 31
msgid prev: If you have both ALSA and Open Sound System drivers installed, KMix will use the ALSA driver.
msgid new : If you have both ALSA and Open Sound System drivers installed, &kmix; will use the ALSA driver.

msg number: 34
msgid prev: &kmix; usage is straightforward. Every mixer device that your soundcard provides is represented by a volume slider. Mono devices have a single slider, stereo devices can have either one or two sliders, depending on your choice. Additionally there is a panning slider at the bottom of the &kmix; window. If you have more than one soundcard, a list will be displayed on the top of the window, where you can choose between your soundcards.
msgid new : &kmix; usage is straightforward. Every mixer control that your soundcard provides is represented by a volume slider. Mono controls have a single slider, stereo controls can have either one or two sliders, depending on your choice. Additionally there is a panning slider at the bottom of the &kmix; window. If you have more than one soundcard, a list will be displayed on the top of the window, where you can choose between your soundcards.

msg number: 38
msgid prev: Output: This holds the controls that are most likely playback related, like the \"Master\" volume control.
msgid new : <guilabel>Output</guilabel>: This holds the controls that are most likely playback related, like the <guilabel>Master</guilabel> volume control.

msg number: 39
msgid prev: Input: This holds all controls that are most likely record related, like \"Capture\".
msgid new : <guilabel>Input</guilabel>: This holds all controls that are most likely record related, like <guilabel>Capture</guilabel>.

msg number: 40
msgid prev: Switches: This holds all controls, that allows only to switch some functionality ON or OFF (like \"Mic Boost (+20dB)\"), and multiple-choice controls (like \"Microphone Select: Mic1 or Mic2\").
msgid new : <guilabel>Switches</guilabel>: This holds all controls, that allows only to switch some functionality ON or OFF (like \"Mic Boost (+20dB)\"), and multiple-choice controls (like <guilabel>Mic Select</guilabel>: <guilabel>Mic1</guilabel> or <guilabel>Mic2</guilabel>).

msg number: 41
msgid prev: Besides volumes controls, KMix also features LED's. The general coloring rule is:
msgid new : Besides volumes controls, &kmix; also features LED's. The general coloring rule is:

msg number: 47
msgid prev: The volume controls in section \"Output\" and \"Input\" consist of (top to bottom):
msgid new : The volume controls in section <guilabel>Output</guilabel> and <guilabel>Input</guilabel> consist of (top to bottom):

msg number: 48
msgid prev: <screeninfo>Volume control (\"Input\" Section)</screeninfo>
msgid new : <screeninfo>Volume control (<guilabel>Input</guilabel> Section)</screeninfo>

msg number: 49
msgid prev: <phrase>Volume control (\"Input\" Section)</phrase>
msgid new : <phrase>Volume control (<guilabel>Input</guilabel> Section)</phrase>

msg number: 55
msgid prev: <screeninfo>Volume control with Recording Switchi (\"Output\"Section)</screeninfo>
msgid new : <screeninfo>Volume control with Recording Switch (<guilabel>Output</guilabel> Section)</screeninfo>

msg number: 56
msgid prev: <phrase>Volume control with Recording Switchi (\"Output\"Section)</phrase>
msgid new : <phrase>Volume control with Recording Switch (<guilabel>Output</guilabel> Section)</phrase>

msg number: 57
msgid prev: The volume sliders have a context menu, accessible by right clicking on the slider or device icon (at the top). Several entries are possible, but only those applicable are shown.
msgid new : Most of these controls have a context menu, accessible by right clicking on the control or device icon. Several entries are possible in the context menu, but only those applicable are shown.

msg number: 63
msgid prev: If you are not interested in regulating this device you can hide it with this option. If you want to show it again, you can only do this by selecting the <guilabel>Channels</guilabel> option (see below)
msgid new : If you are not interested in regulating this device you can hide it with this option. If you want to show it again, you can only do this by selecting the <guimenuitem>Channels</guimenuitem> option (see below)

msg number: 64
msgid prev: Configure Shortcuts
msgid new : Configure Global Shortcuts...

msg number: 65
msgid prev: You can control a device with your keyboard. Use this menu option to show the KDE <guilabel>Configure Shortcuts</guilabel> dialog. Here you can define keys for increasing and decreasing volume and for muting the device. The keys are global and operate also when &kmix; is iconified or docked.
msgid new : You can control a device with your keyboard. Use this menu option to show the &kde; <guilabel>Configure Shortcuts</guilabel> dialog. Here you can define keys for increasing and decreasing volume and for muting the device. The keys are global and operate also when &kmix; is iconified or docked.

msg number: 67
msgid prev: You will get a dialog box where you can configure per section (Output, Input, Switches), which channels you want to see.
msgid new : You will get a dialog box where you can configure per section (<guilabel>Output</guilabel>, <guilabel>Input</guilabel>, <guilabel>Switches</guilabel>), which channels you want to see.

msg number: 68
msgid prev: Show Menubar
msgid new : Show/Hide Menubar

msg number: 69
msgid prev: This option is not device specific, but affects the mixer window. You can hide and show the menu bar with this option. You can also do this by pressing the Shortcut (usually CTRL-m)
msgid new : This option is not device specific, but affects the mixer window. You can hide and show the menubar with this option. You can also do this by pressing the shortcut (usually <keycombo action=\"simul\">&Ctrl;<keycap>M</keycap></keycombo>)

msg number: 74
msgid prev: For Surround Systems please be aware that the Master device often regulates only the Front Speakers. This is a limitation of your Soundcard driver. if your soundcard has
msgid new : For Surround Systems please be aware that the <guilabel>Master</guilabel> device often regulates only the Front Speakers. This is a limitation of your Soundcard driver.

msg number: 75
msgid prev: If your soundcard has no Master device, some other device might get picked by KMix - for most people this is the Wave (or PCM) control.
msgid new : If your soundcard has no <guilabel>Master</guilabel> device, some other device might get picked by &kmix; - for most people this is the <guilabel>Wave</guilabel> (or <guilabel>PCM</guilabel>) control.

msg number: 77
msgid prev: Use <guilabel>Menubar -> Settings -> Configure KMix...</guilabel> to choose preferences. These items are:
msgid new : Use <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kmix;...</guimenuitem></menuchoice> from the menubar to choose preferences. These items are:

msg number: 81
msgid prev: If enabled, a left-clicking the KMix dock icon will show a popup window with a volume control for the preferred device (Hint: currently you cannot change this device - it is selected by KMix instead). If the option is disabled, the KMix Main Window will be shown on a left-click on the KMix dock icon.
msgid new : If enabled, a left-clicking the &kmix; dock icon will show a popup window with a volume control for the preferred device (Hint: currently you cannot change this device - it is selected by &kmix; instead). If the option is disabled, the &kmix; Main Window will be shown on a left-click on the &kmix; dock icon.

msg number: 87
msgid prev: Let KDE restore the volumes when you Login: This restores your personal volume levels, stored when you last logged out. If your Operating System saves the volume levels, you might not need this option (but on a computer with multiple users it is still needed).
msgid new : Let &kde; restore the volumes when you Login: This restores your personal volume levels, stored when you last logged out. If your Operating System saves the volume levels, you might not need this option (but on a computer with multiple users it is still needed).

msg number: 88
msgid prev: Volume controls
msgid new : Volume Values:

msg number: 93
msgid prev: The &kmix; panel applet is an alternative interface to &kmix;. You can add it to the KDE panel by using the panel menu (<guilabel>Panel Menu</guilabel> -> <guilabel>Add</guilabel> -> <guilabel>Applet</guilabel> -> <guilabel>KMix Applet</guilabel>).
msgid new : The &kmix; panel applet is an alternative interface to &kmix;. You can add it to the &kde; panel by selecting <guimenuitem>Add Applet to Panel...</guimenuitem> in the <guimenu>Panel Menu</guimenu> or context menu. Choose <guilabel>Sound Mixer</guilabel> and click the <guibutton>Add to Panel</guibutton> or double click <guilabel>Sound Mixer</guilabel>.

msg number: 97
msgid prev: No dock icon. If you want to use the dock item you must additionally start &kmix; from the K-Menu (usually installed under <guilabel>K-Menu</guilabel> -> <guilabel>Multimedia</guilabel> -> <guilabel>Sound Mixer</guilabel>).
msgid new : No dock icon. If you want to use the dock item you must additionally start &kmix; with <menuchoice><guimenu>K-Menu</guimenu><guisubmenu>Multimedia</guisubmenu><guimenuitem>&kmix; Sound Mixer</guimenuitem></menuchoice>.

msg number: 101
msgid prev: No automatic volume saving. If you want your volumes saved when you logout for later restauration, you must also start KMix from the K-Menu.
msgid new : No automatic volume saving. If you want your volumes saved when you logout for later restauration, you must also start &kmix; from the K-Menu.

msg number: 102
msgid prev: Advanced KMix features
msgid new : Advanced &kmix; features

msg number: 104
msgid prev: The DCOP Interface
msgid new : The &DCOP; Interface

msg number: 105
msgid prev: Sometimes you want to do specialized things. Things like controlling the mixer from another application or muting the master device every day at 10pm. &kmix; has a DCOP interface that allows you to achieve much with minimal work. You can start a shell and type <guilabel>dcop kmix</guilabel> to start exploring the &kmix; DCOP interface. The &kmix; specific interfaces are:
msgid new : Sometimes you want to do specialized things. Things like controlling the mixer from another application or muting the master device every day at 10pm. &kmix; has a &DCOP; interface that allows you to achieve much with minimal work. You can start a shell and type <userinput><command>dcop kmix</command></userinput> to start exploring the &kmix; &DCOP; interface. The &kmix; specific interfaces are:

msg number: 107
msgid prev: Allows manipulating the first mixer. You can set volume levels, mute the device, change balance, retrieve the mixer name and much more. Type <guilabel>dcop kmix Mixer0</guilabel> if you want to explore all the features. There are more entries like <guilabel>Mixer1</guilabel> in case multiple soundcards are installed.
msgid new : Allows manipulating the first mixer. You can set volume levels, mute the device, change balance, retrieve the mixer name and much more. Type <userinput><command>dcop kmix Mixer0</command></userinput> if you want to explore all the features. There are more entries like <userinput><command>Mixer1</command></userinput> in case multiple soundcards are installed.

msg number: 109
msgid prev: The GUI window can be controlled with this command. You can hide and show the window, resize it and much more. Type <guilabel>dcop kmix kmix-mainwindow#1</guilabel> if you want to explore all the features.
msgid new : The &GUI; window can be controlled with this command. You can hide and show the window, resize it and much more. Type <userinput><command>dcop kmix kmix-mainwindow#1</command></userinput> if you want to explore all the features.

msg number: 110
msgid prev: DCOP Examples
msgid new : &DCOP; Examples

msg number: 112
msgid prev: Hides the GUI window. Use <guilabel>dcop kmix kmix-mainwindow#1 show</guilabel> or the dock icon to show it again.
msgid new : Hides the &GUI; window. Use <userinput><command>dcop kmix kmix-mainwindow#1 show</command></userinput> or the dock icon to show it again.

msg number: 114
msgid prev: Resizes the GUI window to the smallest size possible. This is the size so that all sliders (and other GUI elements) will fit into the window.
msgid new : Resizes the &GUI; window to the smallest size possible. This is the size so that all sliders (and other &GUI; elements) will fit into the window.

msg number: 116
msgid prev: Tells the name of the first Mixer, for example <guilabel>Sound Fusion CS46xx</guilabel>
msgid new : Tells the name of the first Mixer, for example <computeroutput>Sound Fusion CS46xx</computeroutput>.

msg number: 118
msgid prev: Sets the volume on the second mixer, device 0 to 10 percent. Device 0 is often the master device, but not always. If you want to quiet down the (first) master device on your second soundcard, you can use <guilabel>dcop kmix Mixer1 setMasterVolume 0</guilabel>
msgid new : Sets the volume on the second mixer, device 0 to 10 percent. Device 0 is often the master device, but not always. If you want to quiet down the (first) master device on your second soundcard, you can use <userinput><command>dcop kmix Mixer1 setMasterVolume 0</command></userinput>

msg number: 119
msgid prev: You can directly execute these commands from a shell that you started from inside KDE. If you need to execute dcop commands from somewhere else, for example from a crontab script, you need to define the <guilabel>DCOPSERVER</guilabel> environment variable (as seen in the first line of your ~/.DCOPserver_hostname_:0 file), for example:
msgid new : You can directly execute these commands from a shell that you started from inside &kde;. If you need to execute dcop commands from somewhere else, for example from a crontab script, you need to define the <envar>DCOPSERVER</envar> environment variable (as seen in the first line of your <filename>~/.DCOPserver_hostname_:0</filename> file), for example:

msg number: 120
msgid prev: DCOPSERVER=`cat /home/yourhome/.DCOPserver_yourhostname_:0 | grep local`
msgid new : #!/bin/sh\nDCOPSERVER=`cat /home/yourhome/.DCOPserver_yourhostname_:0 | grep local`\nexport DCOPSERVER\ndcop kmix Mixer0 setMasterVolume 0

msg number: 122
msgid prev: Using ALSA and OSS driver at the same time>
msgid new : Using ALSA and OSS driver at the same time

msg number: 123
msgid prev: KMix on Linux can use either the ALSA driver or the OSS driver, not both. If you really need to use both drivers at the same time (a very rare situation), you can do it as follows: Quit KMix and add the following line to your <guilabel>kmixrc</guilabel> file in the global configuration section.
msgid new : &kmix; on &Linux; can use either the ALSA driver or the OSS driver, not both. If you really need to use both drivers at the same time (a very rare situation), you can do it as follows: Quit &kmix; and add the following line to your <filename>kmixrc</filename> file in the global configuration section.

msg number: 125
msgid prev: Start KMix again. If you click <guilabel>Help->Hardware Information</guilabel> you should see \"<guilabel>Sound drivers used: ALSA0.9 + OSS</guilabel>\" and \"<guilabel>Experimental multiple-Driver mode activated</guilabel>\
msgid new : Start &kmix; again. If you click <menuchoice><guimenu>Help</guimenu><guimenuitem>Hardware Information</guimenuitem></menuchoice> you should see <guilabel>Sound drivers used: ALSA0.9 + OSS</guilabel> and <guilabel>Experimental multiple-Driver mode activated</guilabel>.

msg number: 126
msgid prev: Warning: You will probably see all of your mixers doubled.
msgid new : You will probably see all of your mixers doubled.

msg number: 136
msgid prev: Paul Kendall <email>paul at orion.co.nz</email> - SGI Port
msgid new : Paul Kendall <email>paul at orion.co.nz</email> - &SGI; Port

msg number: 138
msgid prev: Faraut Jean-Louis <email>jlf at essi.fr</email> - Solaris Fixes
msgid new : Faraut Jean-Louis <email>jlf at essi.fr</email> - &Solaris; Fixes

msg number: 140
msgid prev: Helge Deller <email>deller at gmx.de</email> - HP-UX Port
msgid new : &Helge.Deller; <email>deller at gmx.de</email> - &HP;-UX Port

msg number: 142
msgid prev: Documentation copyright 2000 Matt Johnston <email>mattj at flashmail.com</email>
msgid new : Documentation copyright 2000 &Matt.Johnston; &Matt.Johnston.mail;

msg number: 145
msgid prev: Updated 2005 to match &kmix; V2.2 by Christian Esken <email>esken at kde.org</email>
msgid new : Updated 7/2005 to match &kmix; V2.6 by Christian Esken <email>esken at kde.org</email>