Git commit f375ae2eb488a0adb96d0b546a6e9839634c6a35 by Aleix Pol. Committed on 17/04/2014 at 16:08. Pushed by apol into branch 'frameworks'.
Documentation moved to kde:khelpcenter/doc D +0 -3 doc/CMakeLists.txt D +0 -1 doc/fundamentals/CMakeLists.txt D +- -- doc/fundamentals/colors.png D +0 -391 doc/fundamentals/config.docbook D +- -- doc/fundamentals/files-locationbar-breadcrumb.png D +- -- doc/fundamentals/files-locationbar-context-menu.png D +- -- doc/fundamentals/files-locationbar-editable.png D +- -- doc/fundamentals/files-locationbar-places-icon.png D +- -- doc/fundamentals/files-open.png D +- -- doc/fundamentals/files-save.png D +- -- doc/fundamentals/find-find-inline.png D +- -- doc/fundamentals/find-find.png D +- -- doc/fundamentals/find-found.png D +- -- doc/fundamentals/find-replace-inline.png D +- -- doc/fundamentals/find-replace.png D +- -- doc/fundamentals/fonts.png D +0 -147 doc/fundamentals/index.docbook D +0 -127 doc/fundamentals/install.docbook D +- -- doc/fundamentals/menus.png D +- -- doc/fundamentals/shortcuts-schemes.png D +- -- doc/fundamentals/shortcuts-search.png D +- -- doc/fundamentals/shortcuts-set.png D +- -- doc/fundamentals/spellcheck-check.png D +0 -1198 doc/fundamentals/tasks.docbook D +- -- doc/fundamentals/toolbars-configure.png D +- -- doc/fundamentals/toolbars-toolbar.png D +0 -1983 doc/fundamentals/ui.docbook D +- -- doc/fundamentals/visualdict-breadcrumb.png D +- -- doc/fundamentals/visualdict-button.png D +- -- doc/fundamentals/visualdict-central-widget.png D +- -- doc/fundamentals/visualdict-check-box.png D +- -- doc/fundamentals/visualdict-color-selector.png D +- -- doc/fundamentals/visualdict-combo-box.png D +- -- doc/fundamentals/visualdict-context-menu.png D +- -- doc/fundamentals/visualdict-dialog-box.png D +- -- doc/fundamentals/visualdict-drop-down-box.png D +- -- doc/fundamentals/visualdict-gui1.png D +- -- doc/fundamentals/visualdict-gui2.png D +- -- doc/fundamentals/visualdict-gui3.png D +- -- doc/fundamentals/visualdict-gui4.png D +- -- doc/fundamentals/visualdict-icon-list.png D +- -- doc/fundamentals/visualdict-icon.png D +- -- doc/fundamentals/visualdict-list-box.png D +- -- doc/fundamentals/visualdict-menu-button.png D +- -- doc/fundamentals/visualdict-menu.png D +- -- doc/fundamentals/visualdict-menubar.png D +- -- doc/fundamentals/visualdict-panel.png D +- -- doc/fundamentals/visualdict-progress-bar.png D +- -- doc/fundamentals/visualdict-radio-button.png D +- -- doc/fundamentals/visualdict-scrollbar.png D +- -- doc/fundamentals/visualdict-slider.png D +- -- doc/fundamentals/visualdict-spin-box.png D +- -- doc/fundamentals/visualdict-statusbar.png D +- -- doc/fundamentals/visualdict-tab.png D +- -- doc/fundamentals/visualdict-text-area.png D +- -- doc/fundamentals/visualdict-text-box.png D +- -- doc/fundamentals/visualdict-titlebar.png D +- -- doc/fundamentals/visualdict-toolbar.png D +- -- doc/fundamentals/visualdict-tree-view.png D +- -- doc/fundamentals/visualdict-window.png D +- -- doc/fundamentals/visualdict-window2.png D +0 -2 doc/glossary/CMakeLists.txt D +0 -10 doc/glossary/checkxrefs D +0 -611 doc/glossary/index.docbook D +0 -941 doc/glossary/kdeprintingglossary.docbook D +0 -3 doc/onlinehelp/CMakeLists.txt D +0 -96 doc/onlinehelp/index.docbook http://commits.kde.org/kde-runtime/f375ae2eb488a0adb96d0b546a6e9839634c6a35 diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt deleted file mode 100644 index ba1a9f9..0000000 --- a/doc/CMakeLists.txt +++ /dev/null @@ -1,3 +0,0 @@ -add_subdirectory(glossary) -add_subdirectory(onlinehelp) -add_subdirectory(fundamentals) diff --git a/doc/fundamentals/CMakeLists.txt b/doc/fundamentals/CMakeLists.txt deleted file mode 100644 index 0921d20..0000000 --- a/doc/fundamentals/CMakeLists.txt +++ /dev/null @@ -1 +0,0 @@ -kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en) diff --git a/doc/fundamentals/colors.png b/doc/fundamentals/colors.png deleted file mode 100644 index 7059435..0000000 Binary files a/doc/fundamentals/colors.png and /dev/null differ diff --git a/doc/fundamentals/config.docbook b/doc/fundamentals/config.docbook deleted file mode 100644 index 5de09be..0000000 --- a/doc/fundamentals/config.docbook +++ /dev/null @@ -1,391 +0,0 @@ -<chapter id="config"> -<title>Customizing &kde; software</title> - -<sect1 id="toolbars"> -<sect1info> -<authorgroup> -<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> -</sect1info> -<title>Customizing Toolbars</title> - -<!--FIXME link from korganizer config-toolbars section--> -<!--FIXME link from <sect2 id="configtoolbars"> in sheets/config.docbook> --> -<!--FIXME link from <sect2 id="configuration-toolbars"> in extragear/multimedia-git/kplayer/doc/en_US/configuration.docbook --> -<screenshot id="screenshot-toolbars-toolbar"> -<screeninfo>The &gwenview; Toolbar</screeninfo> -<mediaobject> -<imageobject><imagedata fileref="toolbars-toolbar.png" format="PNG"/></imageobject> -<textobject><phrase>The &gwenview; toolbar.</phrase></textobject> -<caption><para>The toolbar in -<ulink url="http://kde.org/applications/graphics/gwenview/">&gwenview;</ulink>. -</para></caption> -</mediaobject> -</screenshot> - -<sect2 id="toolbars-items"> -<title>Modifying Toolbar Items</title> - -<para>To customize an application's toolbars, go to -<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure -Toolbars...</guimenuitem></menuchoice> or right-click on a toolbar and select -<guimenuitem>Configure Toolbars...</guimenuitem>.</para> - -<para>On the left side of the toolbar configuration panel, the available items -that you can put in your toolbar are shown. On the right, the ones that already -appear on the toolbar are shown. At the top, you can select the toolbar -you wish to modify or view.</para> - -<para>Above each side of the panel there is a <guilabel>Filter</guilabel> text -box you can use to easily find items in the list.</para> - -<screenshot id="screenshot-toolbars-customize"> -<screeninfo>The Customize Toolbars Window</screeninfo> -<mediaobject> -<imageobject><imagedata fileref="toolbars-configure.png" format="PNG"/></imageobject> -<textobject><phrase>The Customize Toolbars window.</phrase></textobject> -<caption><para>The Customize Toolbars window in &gwenview; with the -<guibutton>Previous</guibutton> button selected.</para></caption> -</mediaobject> -</screenshot> - -<sect3 id="toolbars-items-add"> -<title>Adding an Item</title> -<para>You can add an item to your toolbar by selecting it from the left side and -clicking on the right arrow button.</para> -</sect3> - -<sect3 id="toolbars-items-remove"> -<title>Removing an Item</title> -<para>You can remove an item by selecting it and clicking the left arrow -button.</para> -</sect3> - - -<sect3 id="toolbars-items-rearrange"> -<title>Changing the Position of Items</title> - -<para>You can change the position of the items by moving them lower or higher in -the list. To move items lower, press the down arrow button, while to move items -higher press the up arrow button. You can also change items' position by -dragging and dropping them.</para> - -<para>On horizontal toolbars, the item that's on top will be the one on the left. -On vertical toolbars, items are arranged as they appear in the toolbar.</para> - -</sect3> - -<sect3 id="toolbars-items-separator"> -<title>Adding a Separator</title> -<para>You can add separator lines between items by adding a -<guilabel>--- separator ---</guilabel> item to the toolbar.</para> -</sect3> - -<sect3 id="toolbars-items-defaults"> -<title>Restoring Defaults</title> - -<para>You can restore your toolbar to the way it was when you installed the -application by pressing the <guibutton>Defaults</guibutton> button at the bottom -of the window and then confirming your decision.</para> - -</sect3> - -<sect3 id="toolbars-items-text-icons"> -<title>Changing Text and Icons</title> - -<para>You can change the icon and text of individual toolbar items by selecting -an item and clicking either the <guibutton>Change Icon...</guibutton> or -<guibutton>Change Text...</guibutton> button.</para> -<!--FIXME Icon selection and icon categories -> own section? - Change Text -> Option "Hide text when toolbar shows text alongside icons" - --> -</sect3> -</sect2> - -<sect2 id="toolbars-appearance"> -<title>Customizing Toolbar Appearance</title> - -<para>You can change the appearance of toolbars by right-clicking on a toolbar -to access it's context menu.</para> -<!-- settings for each toolbar separately--> -<sect3 id="toolbars-appearance-text-position"> -<title>Text Position</title> - -<para>You can change the appearance of text on toolbars in the -<guisubmenu>Text Position</guisubmenu> submenu of a toolbar's context menu.</para> - -<para>You can choose from:</para> -<itemizedlist> - -<listitem><para> -<guimenuitem>Icons</guimenuitem> - -only the icon for each toolbar item will appear. -</para></listitem> - -<listitem><para> -<guimenuitem>Text</guimenuitem> - -only the text label for each toolbar item will appear. -</para></listitem> - -<listitem><para> -<guimenuitem>Text Alongside Icons</guimenuitem> - -<!--this may need to be changed to 'left' for RTL languages--> -the text label will appear to the right of each toolbar item's icon -</para></listitem> - -<listitem><para> -<guimenuitem>Text Under Icons</guimenuitem> - -the text label will appear underneath each toolbar item's icon -</para></listitem> - -</itemizedlist> - -<para>You can also show or hide text for individual toolbar items by -right-clicking on an item and checking or unchecking the item under -<guilabel>Show Text</guilabel>.</para> - -</sect3> - -<sect3 id="toolbars-appearance-icon-size"> -<title>Icon Size</title> - -<para>You can change the size of toolbar items' icons by selecting -<guisubmenu>Icon Size</guisubmenu> from the toolbar's context menu.</para> - -<para>You can choose from the following options: (each lists the icon size -in pixels)</para> - -<itemizedlist> -<listitem><para><guimenuitem>Small (16x16)</guimenuitem></para></listitem> -<listitem><para><guimenuitem>Medium (22x22)</guimenuitem> - [the default value]</para></listitem> -<listitem><para><guimenuitem>Large (32x32)</guimenuitem></para></listitem> -<listitem><para><guimenuitem>Huge (48x48)</guimenuitem></para></listitem> -</itemizedlist> - -</sect3> - -<sect3 id="toolbars-appearance-move"> -<title>Moving Toolbars</title> - -<para>In order to move toolbars, you must <quote>unlock</quote> them. To do -so, uncheck <guimenuitem>Lock Toolbar Positions</guimenuitem> from a toolbar's -context menu. To restore the lock, simply recheck this menu item.</para> - -<para>You can change a toolbar's position from the -<guisubmenu>Orientation</guisubmenu> submenu of its context menu.</para> - -<para>You can choose from:</para> -<itemizedlist> -<listitem><para><guimenuitem>Top</guimenuitem> - [the default in many applications]</para></listitem> -<listitem><para><guimenuitem>Left</guimenuitem></para></listitem> -<listitem><para><guimenuitem>Right</guimenuitem></para></listitem> -<listitem><para><guimenuitem>Bottom</guimenuitem></para></listitem> -</itemizedlist> - -<para>You can also move a toolbar by clicking and holding onto the dotted line -at the left of horizontal toolbars or the top of vertical toolbars and dragging -it to your desired location.</para> - -</sect3> - -<sect3 id="toolbars-appearance-show-hide"> -<title>Show/Hide Toolbars</title> - -<para>If your application has only one toolbar, you can hide a toolbar by -deselecting <guimenuitem>Show Toolbar</guimenuitem> from either the toolbar's -context menu or the <guimenu>Settings</guimenu> menu. To restore the toolbar, -select <guimenuitem>Show Toolbar</guimenuitem> from the <guimenu>Settings</guimenu> -menu. Note that toolbars must be <quote>unlocked</quote> to hide them from their -context menu; see <xref linkend="toolbars-appearance-move"/> for more -information.</para> - -<para>If your application has more than one toolbar, a submenu called -<guisubmenu>Toolbars Shown</guisubmenu> will appear in the context menu and -<guimenu>Settings</guimenu> menu instead of the above menu entry. From that -menu you may select individual toolbars to hide and show.</para> - -</sect3> -</sect2> - -<sect2 id="toolbars-ack"> -<title>Thanks and Acknowledgments</title> -<para>Thanks to an anonymous Google Code-In 2011 participant for writing much -of this section.</para> -</sect2> - -</sect1> - - -<sect1 id="shortcuts"> -<sect1info> -<authorgroup> -<author><firstname>Alexey</firstname> <surname>Subach</surname></author> -<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> -</sect1info> - - <!--FIXME link from - <sect2 id="configshort"> in tables/config.docbook> - <sect2 id="configuration-shortcuts"> in extragear/multimedia-git/kplayer/doc/en_US/configuration.docbook - --> -<!--FIXME explain Alternate + Global shortcuts in Screenshot and -another place to change Global Shortcuts (Systemsettings)--> -<title>Using and Customizing Shortcuts</title> - -<sect2 id="shortcuts-intro"> -<title>Introduction</title> - -<para>Many &kde; applications allow you to configure keyboard shortcuts. To open -the standard keyboard shortcuts configuration panel, go to -<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure -Shortcuts...</guimenuitem></menuchoice>.</para> - -<para>In the Configure Shortcuts window, you will see a list of all the shortcuts -available in the current application. You can use the search box at the top to -search for the shortcut you want.</para> - -<screenshot id="screenshot-shortcuts-search"> -<screeninfo>The Customize Shortcuts Window</screeninfo> -<mediaobject> -<imageobject><imagedata fileref="shortcuts-search.png" format="PNG"/></imageobject> -<textobject><phrase>The Customize Shortcuts window.</phrase></textobject> -<caption><para>Searching for shortcuts with <userinput>file</userinput> in -<ulink url="http://kde.org/applications/system/dolphin/">&dolphin;</ulink>. -</para></caption> -</mediaobject> -</screenshot> - -</sect2> - -<sect2 id="shortcuts-change"> -<title>Changing a Shortcut</title> - -<para>To change a shortcut, first click on the name of a shortcut you want to change. -You will see a radio group where you can choose whether to set the shortcut to its -default value, or select a new shortcut for the selected action. To set a new shortcut, -choose <guilabel>Custom</guilabel> and click on the button next to it. Then just -type the shortcut you would like to use, and your changes will be saved.</para> - -<screenshot id="screenshot-shortcuts-set"> -<screeninfo>Setting a Shortcut</screeninfo> -<mediaobject> -<imageobject><imagedata fileref="shortcuts-set.png" format="PNG"/></imageobject> -<textobject><phrase>The Customize Shortcuts window demonstrating how to -set a shortcut.</phrase></textobject> -</mediaobject> -</screenshot> - -</sect2> - -<sect2 id="shortcuts-reset"> -<title>Resetting Shortcuts</title> -<para>There is a button at the bottom of the window, called <guibutton>Reset to -Defaults</guibutton>. Clicking on this button will reset all your custom shortcuts -to their default values.</para> - -<para>You can also reset an individual shortcut to its default value by selecting -it, and choosing the <guilabel>Default</guilabel> radio button.</para> - -</sect2> - -<sect2 id="shortcuts-delete"> -<title>Removing a Shortcut</title> - -<para>To remove a shortcut, select it from the list, then click the remove icon (a -black arrow with a cross) to the right of the button that allows you to select -a shortcut.</para> - -</sect2> - -<sect2 id ="shortcuts-schemes"> -<title>Working with Schemes</title> - -<para>Schemes are keyboard shortcuts configuration profiles, so you can create -several profiles with different shortcuts and switch between these profiles -easily.</para> - -<warning><para>This feature is under development. It is not possible to import -schemes using a &GUI; at this time.</para></warning> - -<screenshot id="screenshot-shortcuts-schemes"> -<screeninfo>Working with Schemes</screeninfo> -<mediaobject> -<imageobject><imagedata fileref="shortcuts-schemes.png" format="PNG"/></imageobject> -<textobject><phrase>The Customize Shortcuts window displaying the scheme -editing tools.</phrase></textobject> -<caption><para>Editing a scheme called <userinput>work</userinput>.</para></caption> -</mediaobject> -</screenshot> - -<para>To see a menu allowing you to edit schemes, click on the -<guibutton>Details</guibutton> button at the bottom of the form. The following -options will appear:</para> - -<variablelist> - -<varlistentry> -<term><guilabel>Current Scheme</guilabel></term> -<listitem><para>Allows you to switch between your schemes.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guibutton>New...</guibutton></term> -<listitem><para>Creates a new scheme. This opens a window that lets you select -a name for your new scheme.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guibutton>Delete</guibutton></term> -<listitem><para>Deletes the current scheme.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guibutton>More Actions</guibutton></term> -<listitem> -<para>Opens the following menu:</para> -<variablelist> - -<varlistentry> -<term><guimenuitem>Save as Scheme Defaults</guimenuitem></term> -<listitem><para>Sets the current scheme as the default for all new schemes.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guimenuitem>Export Scheme...</guimenuitem></term> -<listitem><para>Exports the current scheme to a file named <filename><replaceable>applicationname</replaceable><replaceable>schemename</replaceable>shortcuts.rc</filename>.</para> -<para> -Move this file to the folder <filename class="directory">$KDEDIR/apps/applicationname/</filename> -and the exported scheme will be available in the drop down box labelled <guilabel>Current Scheme</guilabel> -</para></listitem> -</varlistentry> - -</variablelist> -</listitem> -</varlistentry> -</variablelist> - -</sect2> - -<sect2 id="shortcuts-print"> -<title>Printing Shortcuts</title> - -<para>You can print out a list of shortcuts for easy reference by clicking the -<guibutton>Print</guibutton> button at the bottom of the window.</para> - -</sect2> - -<sect2 id="shortcuts-ack"> -<title>Thanks and Acknowledgments</title> - -<para>Special thanks to Google Code-In 2011 participant Alexey Subach for -writing much of this section.</para> - -</sect2> - -</sect1> - -</chapter> diff --git a/doc/fundamentals/files-locationbar-breadcrumb.png b/doc/fundamentals/files-locationbar-breadcrumb.png deleted file mode 100644 index a1dfc26..0000000 Binary files a/doc/fundamentals/files-locationbar-breadcrumb.png and /dev/null differ diff --git a/doc/fundamentals/files-locationbar-context-menu.png b/doc/fundamentals/files-locationbar-context-menu.png deleted file mode 100644 index f26b9c3..0000000 Binary files a/doc/fundamentals/files-locationbar-context-menu.png and /dev/null differ diff --git a/doc/fundamentals/files-locationbar-editable.png b/doc/fundamentals/files-locationbar-editable.png deleted file mode 100644 index 8bd6ac3..0000000 Binary files a/doc/fundamentals/files-locationbar-editable.png and /dev/null differ diff --git a/doc/fundamentals/files-locationbar-places-icon.png b/doc/fundamentals/files-locationbar-places-icon.png deleted file mode 100644 index 1b620f7..0000000 Binary files a/doc/fundamentals/files-locationbar-places-icon.png and /dev/null differ diff --git a/doc/fundamentals/files-open.png b/doc/fundamentals/files-open.png deleted file mode 100644 index e6b4537..0000000 Binary files a/doc/fundamentals/files-open.png and /dev/null differ diff --git a/doc/fundamentals/files-save.png b/doc/fundamentals/files-save.png deleted file mode 100644 index d584bff..0000000 Binary files a/doc/fundamentals/files-save.png and /dev/null differ diff --git a/doc/fundamentals/find-find-inline.png b/doc/fundamentals/find-find-inline.png deleted file mode 100644 index 58c1ebb..0000000 Binary files a/doc/fundamentals/find-find-inline.png and /dev/null differ diff --git a/doc/fundamentals/find-find.png b/doc/fundamentals/find-find.png deleted file mode 100644 index 6201a03..0000000 Binary files a/doc/fundamentals/find-find.png and /dev/null differ diff --git a/doc/fundamentals/find-found.png b/doc/fundamentals/find-found.png deleted file mode 100644 index 0a9dd90..0000000 Binary files a/doc/fundamentals/find-found.png and /dev/null differ diff --git a/doc/fundamentals/find-replace-inline.png b/doc/fundamentals/find-replace-inline.png deleted file mode 100644 index 0bef63a..0000000 Binary files a/doc/fundamentals/find-replace-inline.png and /dev/null differ diff --git a/doc/fundamentals/find-replace.png b/doc/fundamentals/find-replace.png deleted file mode 100644 index 81b7f75..0000000 Binary files a/doc/fundamentals/find-replace.png and /dev/null differ diff --git a/doc/fundamentals/fonts.png b/doc/fundamentals/fonts.png deleted file mode 100644 index 1e37117..0000000 Binary files a/doc/fundamentals/fonts.png and /dev/null differ diff --git a/doc/fundamentals/index.docbook b/doc/fundamentals/index.docbook deleted file mode 100644 index ec93dd9..0000000 --- a/doc/fundamentals/index.docbook +++ /dev/null @@ -1,147 +0,0 @@ -<?xml version="1.0" ?> -<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" -"dtd/kdedbx45.dtd" [ - <!ENTITY kappname "&kde-sc;"> - <!ENTITY % addindex "IGNORE"> - <!--FIXME: these entities should be added to kdoctools--> - <!ENTITY kde-sc "&i18n-kde-sc;"> - <!ENTITY plasma-workspaces "&i18n-plasma-workspaces;"> - <!ENTITY plasma-desktop "&i18n-plasma-desktop;"> - <!ENTITY plasma-active "&i18n-plasma-active;"> - <!ENTITY gwenview '<application>Gwenview</application>'> - <!ENTITY Meta "&i18n-Meta;"> - <!--/end entities that need to be added to kdoctools--> - <!--make some of the above entities translatable in the interim--> - <!ENTITY i18n-kde-sc "&kde; Software Collection"> - <!ENTITY i18n-plasma-workspaces "&kde; &plasma; Workspaces"> - <!ENTITY i18n-plasma-desktop "<application>&kde; &plasma; Desktop</application>"> - <!ENTITY i18n-plasma-active "<application>&plasma; Active</application>"> - <!ENTITY i18n-Meta "<keysym>Meta</keysym>"> - <!--/end temporary translatable entities--> - <!ENTITY ui-chapter SYSTEM "ui.docbook"> - <!ENTITY tasks-chapter SYSTEM "tasks.docbook"> - <!ENTITY config-chapter SYSTEM "config.docbook"> - <!ENTITY install-chapter SYSTEM "install.docbook"> - <!ENTITY % English "INCLUDE"><!-- change language only here --> -]> - -<book id="fundamentals" lang="&language;"> -<title>&kde; Fundamentals</title> - -<bookinfo> -<authorgroup> -<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author> - -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> - -<copyright> -<year>2011</year><year>2012</year><year>2013</year> -<holder>&TC.Hollingsworth;</holder> -</copyright> -<copyright> -<year>2011</year> -<holder>Alexey Subach</holder> -</copyright> -<copyright> -<year>2011</year> -<holder>Salma Sultana</holder> -</copyright> -<legalnotice>&FDLNotice;</legalnotice> - -<date>2013-12-08</date> -<releaseinfo>&kde; 4.12</releaseinfo> - -<abstract> -<para>This guide provides an introduction to the &kde-sc; and describes many -common tasks that can be performed in all &kde; applications.</para> -</abstract> - -<keywordset> -<keyword>KDE</keyword> -<keyword>introduction</keyword> -<keyword>user interface</keyword> -<keyword>menus</keyword> -<keyword>files</keyword> -<keyword>open</keyword> -<keyword>save</keyword> -<keyword>spelling</keyword> -<keyword>spellcheck</keyword> -<keyword>find</keyword> -<keyword>replace</keyword> -<keyword>colors</keyword> -<keyword>configuration</keyword> -<keyword>customization</keyword> -<keyword>toolbars</keyword> -<keyword>installation</keyword> -<keyword>compiling</keyword> -</keywordset> - -</bookinfo> - -<chapter id="introduction"> -<title>Introduction</title> -<para>Welcome to &kde;!</para> - -<para>This guide will introduce you to the many features of the &kde-sc; and -describe many common tasks you can perform in all &kde; applications.</para> - -<para>For more information on &kde;, visit the -<ulink url="http://www.kde.org/">KDE website</ulink>.</para> - -</chapter> - -&install-chapter; - -&ui-chapter; - -&tasks-chapter; - -&config-chapter; - -<chapter id="credits"> - -<title>Credits and License</title> - -<para>The original idea for this guide was proposed by Chusslove Illich and -brought to fruition with input from &Burkhard.Lueck;, Yuri Chornoivan, and -&TC.Hollingsworth;</para> - -<para>Much of it was written by participants of -<ulink url="http://code.google.com/opensource/gci/2011-12/index.html">Google -Code-In 2011</ulink>. Thanks to Google for sponsoring their excellent work!</para> - -<!-- TRANS:CREDIT_FOR_TRANSLATORS --> - -&underFDL; <!-- FDL: do not remove --> -&underGPL; <!-- GPL License --> - -</chapter> - -&documentation.index; - -</book> - -<!-- Comments, ideas, policy etc - -Use default appearance + settings of kde compiled from sources - -Style issues: -Task oriented -Avoid variablelist for obvious terms like e. g. Left/Right - -FIXME missing stuff: - -add a11y docbooks from koffice 1.6? - ---> -<!-- -Local Variables: -mode: sgml -sgml-namecase-general: t -sgml-namecase-entity: nil -sgml-general-insert-case: lower -sgml-minimize-attributes: nil -sgml-omittag: nil -End: ---> diff --git a/doc/fundamentals/install.docbook b/doc/fundamentals/install.docbook deleted file mode 100644 index ffc1f0d..0000000 --- a/doc/fundamentals/install.docbook +++ /dev/null @@ -1,127 +0,0 @@ -<chapter id="install"> -<title>Installing the &kde-sc;</title> - -<para>You can install the &kde-sc; on a variety of different platforms, ranging from -smartphones and tablets to computers running &Microsoft; &Windows;, &MacOS;, -&UNIX;, &BSD; or &Linux;. Binary packages are available for many different -platforms and distributions, or advanced users may build the source code.</para> - -<sect1 id="install-packages"> -<title>Installing Packages</title> - -<para>Hundreds of developers worldwide have done a lot of work to make it easy -to install &kde; on a variety of different devices and platforms.</para> - -<sect2 id="install-linux"> -<title>&Linux;</title> - -<para>Nearly every &Linux; distribution provides binary packages for individual -&kde-sc; applications and the &plasma-workspaces; as a whole.</para> - -<para>To install an individual application, look for its name in your -distribution's package collection. To install one of the &plasma-workspaces;, -like &plasma-desktop;, look for a metapackage or package -group, typically <literal>kde-desktop</literal>.</para> - -<note> -<para>Some core applications may be installed together with other core -applications in a combined package named after the &kde; package they are -provided in. For instance, &dolphin; might be found in the -<literal>kde-baseapps</literal> package.</para> -</note> - -<para>If you have trouble locating &kde; packages for your distribution, please -contact their support resources. Many distributions also have a team dedicated -to packaging &kde; that can provide assistance specific to &kde;</para> - -<!--FIXME: provide steps for common distributions?--> - -</sect2> - -<sect2 id="install-windows"> -<title>&Microsoft; &Windows;</title> - -<para>The &kde; on Windows Initiative provides binary packages of &kde-sc; -applications for &Microsoft; &Windows;. They also provide a special installer -application that permits you to install individual applications or groups and -all necessary dependencies easily.</para> - -<para>For more information on the initiative and to download the installer, -visit <ulink url="http://windows.kde.org/">the KDE on Windows Initiative</ulink>. -</para> - -<!--FIXME: describe how to use the installer?--> - -</sect2> - -<sect2 id="install-mac"> -<title>&MacOS;</title> - -<para>Individual &kde-sc; applications can be installed through several -different <quote>ports</quote> systems available for &MacOS;. Several different -&kde; applications also provide their own binary builds for &MacOS;.</para> - -<para>For more information, visit -<ulink url="http://mac.kde.org/">&kde; on &MacOS;X</ulink>.</para> - -</sect2> - -<sect2 id="install-bsd"> -<title>&BSD;</title> - -<para>Most &BSD; distributions allows you to install &kde-sc; applications -and the &plasma-workspaces; as a whole through their <quote>ports</quote> -system.</para> - -<para>For more information on installing ports, see your &BSD; distribution's -documentation.</para> - -<!--FIXME: provide steps/links for common BSDs?--> - -</sect2> - -<sect2 id="install-mobile"> -<title>Mobile Devices</title> - -<para>&plasma-active; is an exciting initiative to bring a new &kde; -experience to mobile devices like smartphones or tablets. Binary releases are -provided for several different devices.</para> - -<para>For more information, visit -<ulink url="http://plasma-active.org/">&plasma-active;</ulink>.</para> - -</sect2> - -<sect2 id="install-live"> -<title>Live Media</title> - -<para>Several &Linux; and &BSD; distributions offer live media. This permits you -to try out the &plasma-workspaces; without installing anything to your system. -All you have to do insert a CD or connect a USB drive and boot from it. If you -like what you see, most offer an option to install it to your hard drive.</para> - -<para>There is <ulink url="http://www.kde.org/download/distributions.php">a list -of distributions that offer the &kde-sc; on live media</ulink> on the &kde; website.</para> -</sect2> - -<sect2 id="install-source"> -<title>Building from Source Code</title> - -<para>For detailed information on how to compile and install &kde; -applications see -<ulink url="http://techbase.kde.org/Getting_Started#Building_and_Running_KDE_Software_From_Source"> -Building and Running &kde; Software From Source on &kde; TechBase</ulink>.</para> - -<para>Since &kde; software uses <command>cmake</command> you should -have no trouble compiling it. Should you run into problems please report them to the -&kde; mailing lists.</para> -</sect2> -<!--Fixme more info: - Where to get sources (git split) - where to get help building from souces - kdesrc-build - --> - -</sect1> - -</chapter> \ No newline at end of file diff --git a/doc/fundamentals/menus.png b/doc/fundamentals/menus.png deleted file mode 100644 index 37c806a..0000000 Binary files a/doc/fundamentals/menus.png and /dev/null differ diff --git a/doc/fundamentals/shortcuts-schemes.png b/doc/fundamentals/shortcuts-schemes.png deleted file mode 100644 index 5316cf6..0000000 Binary files a/doc/fundamentals/shortcuts-schemes.png and /dev/null differ diff --git a/doc/fundamentals/shortcuts-search.png b/doc/fundamentals/shortcuts-search.png deleted file mode 100644 index 19bb85b..0000000 Binary files a/doc/fundamentals/shortcuts-search.png and /dev/null differ diff --git a/doc/fundamentals/shortcuts-set.png b/doc/fundamentals/shortcuts-set.png deleted file mode 100644 index 7158e2c..0000000 Binary files a/doc/fundamentals/shortcuts-set.png and /dev/null differ diff --git a/doc/fundamentals/spellcheck-check.png b/doc/fundamentals/spellcheck-check.png deleted file mode 100644 index 8d4a468..0000000 Binary files a/doc/fundamentals/spellcheck-check.png and /dev/null differ diff --git a/doc/fundamentals/tasks.docbook b/doc/fundamentals/tasks.docbook deleted file mode 100644 index f480489..0000000 --- a/doc/fundamentals/tasks.docbook +++ /dev/null @@ -1,1198 +0,0 @@ -<chapter id="tasks"> -<title>Common Tasks</title> - -<!--FIXME add Scanning here?--> -<sect1 id="nav"> -<sect1info> -<authorgroup> -<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> -</sect1info> -<title>Navigating Documents</title> -<!-- FIXME -Add auto scroll feature Konqueror with KHTML/Okular/more apps here? -automatic scrolling with Shift+Down Arrow or Shift+Up Arrow ---> -<sect2 id="nav-scroll"> -<title>Scrolling</title> - -<para>You're probably familiar with the scrollbar that appears on the right side -(and sometimes the bottom) of documents, allowing you to move within documents. -However, there are several other ways you can navigate documents, some of which -are faster and easier.</para> - -<para>Several mice have a wheel in the middle. You can move it up and down to -scroll within a document. If you press the &Shift; key while using the mouse -wheel, the document will scroll faster.</para> - -<para>If you're using a portable computer like a laptop, you might also be able -to scroll using the touchpad. Some computers allow you to scroll vertically -by moving your finger up and down the rightmost side of the touchpad, and allow -you to scroll horizontally by moving your finger across the bottommost side -of the touchpad. Others let you scroll using two fingers: move both fingers -up and down anywhere on the touchpad to scroll vertically, and move them left -and right to scroll horizontally. Since this functionality emulates the mouse -wheel functionality described above, you can also press the &Shift; key while -you do this to scroll faster.</para> - -<para>If you use the &plasma-workspaces;, you can control mouse wheel behavior -in the <ulink url="help:/kcontrol/mouse/">Mouse module in &systemsettings;</ulink>, -and you can control touchpad scrolling behavior in the Touchpad module in -&systemsettings;. Otherwise, look in the configuration area of your operating -system or desktop environment.</para> - -<para>Additionally, the scrollbar has several options in its context menu. You -can access these by right-clicking anywhere on the scrollbar. The following -options are available:</para> - -<variablelist> - -<varlistentry id="nav-scroll-here"> -<term><guimenuitem>Scroll here</guimenuitem></term> -<listitem><para>Scroll directly to the location represented by where you -right-clicked on the scrollbar. This is the equivalent of simply clicking on -that location on the scrollbar.</para></listitem> -</varlistentry> - -<varlistentry id="nav-scroll-top"> -<term><menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>Home</keycap></keycombo></shortcut> -<guimenuitem>Top</guimenuitem> -</menuchoice></term> -<listitem><para>Go to the beginning of the document.</para></listitem> -</varlistentry> - -<varlistentry id="nav-scroll-bottom"> -<term><menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>End</keycap></keycombo></shortcut> -<guimenuitem>Bottom</guimenuitem> -</menuchoice></term> -<listitem><para>Go to the end of the document.</para></listitem> -</varlistentry> - -<varlistentry id="nav-scroll-page-up"> -<term><menuchoice> -<shortcut><keycap>PgUp</keycap></shortcut> -<guimenuitem>Page up</guimenuitem> -</menuchoice></term> -<listitem><para>Navigate to the previous page in a document that represents a -printed document, or one screen up in other types of documents.</para></listitem> -</varlistentry> - -<varlistentry id="nav-scroll-page-down"> -<term><menuchoice> -<shortcut><keycap>PgDown</keycap></shortcut> -<guimenuitem>Page down</guimenuitem> -</menuchoice></term> -<listitem><para>Navigate to the next page in a document that represents a -printed document, or one screen down in other types of documents. -</para></listitem> -</varlistentry> - -<varlistentry id="nav-scroll-up"> -<term><guilabel>Scroll up</guilabel></term> -<listitem><para>Scroll up one unit (usually a line) in the document. This is -the equivalent of clicking the up arrow at the top of the scrollbar.</para> -</listitem> -</varlistentry> - -<varlistentry id="nav-scroll-down"> -<term><guilabel>Scroll down</guilabel></term> -<listitem><para>Scroll down one unit (usually a line) in the document. This is -the equivalent of clicking the down arrow at the bottom of the scrollbar.</para> -</listitem> -</varlistentry> - -</variablelist> - -</sect2> - -<sect2 id="nav-zoom"> -<title>Zooming</title> - -<para>Many applications permit you to zoom. This makes the text or image you -are viewing larger or smaller. You can generally find the zoom function in the -<link linkend="menus-view">View menu</link>, and sometimes in the status bar -of the application.</para> - -<para>You can also zoom using the keyboard by pressing -<keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo> to zoom in, or -<keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo> to zoom out. If you -can scroll with the mouse wheel or touchpad as described in -<xref linkend="nav-scroll"/>, you can also zoom by pressing &Ctrl; and scrolling -that way.</para> - -</sect2> - -</sect1> - - <!--FIXME Ctrl+Left Mouse Button or Shift+Left Mouse Button to select multiple files--> -<sect1 id="files"> -<sect1info> -<authorgroup> -<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> -</sect1info> -<title>Opening and Saving Files</title> - -<sect2 id="files-intro"> -<title>Introduction</title> - -<para>Many &kde; applications work with files. Most applications have a -<guimenu>File</guimenu> menu with options that allow you to open and save files. -For more information on that, see <xref linkend="menus-file"/>. However, -there are lots of different operations that require selecting a file. Regardless -of the method, all &kde; applications generally use the same file selection -window.</para> - -<screenshot id="screenshot-files-open"> -<screeninfo>The File Open Window</screeninfo> -<mediaobject> -<imageobject><imagedata fileref="files-open.png" format="PNG"/></imageobject> -<textobject><phrase>The File Open window.</phrase></textobject> -<caption><para>Opening a file in -<ulink url="http://kde.org/applications/internet/konqueror/">&konqueror;</ulink>. -</para></caption> -</mediaobject> -</screenshot> - -</sect2> - -<sect2 id="files-ui"> -<title>The File Selection Window</title> - -<!--large portions of this section were taken from the "Filesystem Browser" - section of kate/plugins.docbook (kde-baseapps/kate_plugins.po) --> - -<variablelist> - -<varlistentry id="files-ui-toolbar"> -<term>The Toolbar</term> -<listitem> -<para>This contains standard navigation tool buttons:</para> - -<variablelist> -<varlistentry id="files-ui-toolbar-back"> -<term><guibutton>Back</guibutton></term> -<listitem><para>Causes the folder view to change to the previously displayed -folder in its history. This button is disabled, if there is no previous item. -</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-forward"> -<term><guibutton>Forward</guibutton></term> -<listitem><para>Causes the folder view to change to the next folder in its -history. This button is disabled, if there is no next folder.</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-parent"> -<term><guibutton>Parent Folder</guibutton></term> -<listitem><para>This will cause the folder view to change to the immediate -parent of the currently displayed folder, if possible.</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-reload"> -<term><guibutton>Reload</guibutton> (<keycap>F5</keycap>)</term> -<listitem><para>Reloads the folder view, displaying any changes that have been -made since it was first loaded or last reloaded.</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-show-preview"> -<term><guibutton>Show Preview</guibutton></term> -<listitem><para>Displays a preview of each file inside the folder view. -</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-zoom"> -<term>Zoom Slider</term> -<listitem><para>This allows you to change the size of the icon or preview -shown in the folder view.</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-options"> -<term><guibutton>Options</guibutton></term> -<listitem> -<variablelist> - -<varlistentry id="files-ui-toolbar-options-sorting"> -<term><menuchoice> -<guimenu>Options</guimenu><guisubmenu>Sorting</guisubmenu> -</menuchoice></term> -<listitem> -<variablelist> - -<varlistentry id="files-ui-toolbar-options-sorting-name"> -<term><menuchoice> -<guimenu>Options</guimenu><guisubmenu>Sorting</guisubmenu> -<guimenuitem>By Name</guimenuitem> -</menuchoice></term> -<listitem><para>Sort files listed in the folder view alphabetically by name. -</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-options-sorting-size"> -<term><menuchoice> -<guimenu>Options</guimenu><guisubmenu>Sorting</guisubmenu> -<guimenuitem>By Size</guimenuitem> -</menuchoice></term> -<listitem><para>Sort files listed in the folder view in order of their file -size.</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-options-sorting-date"> -<term><menuchoice> -<guimenu>Options</guimenu><guisubmenu>Sorting</guisubmenu> -<guimenuitem>By Date</guimenuitem> -</menuchoice></term> -<listitem><para>Sort files listed in the folder view by the date they were last -modified. <!--FIXME: which date?--></para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-options-sorting-type"> -<term><menuchoice> -<guimenu>Options</guimenu><guisubmenu>Sorting</guisubmenu> -<guimenuitem>By Type</guimenuitem> -</menuchoice></term> -<listitem><para>Sort files listed in the folder view alphabetically by their -file type.</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-options-sorting-descending"> -<term><menuchoice> -<guimenu>Options</guimenu><guisubmenu>Sorting</guisubmenu> -<guimenuitem>Descending</guimenuitem> -</menuchoice></term> -<listitem><para>When unchecked (the default), files in the folder view will be -sorted in ascending order. (For instance, files sorted alphabetically will -be sorted from A to Z, while files sorted numerically will be sorted from -smallest to largest.) When checked, files in the folder will be sorted in -descending order (in reverse).</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-options-sorting-folders-first"> -<term><menuchoice> -<guimenu>Options</guimenu><guisubmenu>Sorting</guisubmenu> -<guimenuitem>Folders First</guimenuitem> -</menuchoice></term> -<listitem><para>When enabled (the default), folders will appear before regular -files.</para></listitem> -</varlistentry> - -</variablelist> -</listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-options-view"> -<term><menuchoice> -<guimenu>Options</guimenu><guisubmenu>View</guisubmenu> -</menuchoice></term> -<listitem> -<variablelist> - -<varlistentry id="files-ui-toolbar-options-view-short"> -<term><menuchoice> -<guimenu>Options</guimenu><guisubmenu>View</guisubmenu> -<guimenuitem>Short View</guimenuitem> -</menuchoice></term> -<listitem><para>Displays only the filenames.</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-options-view-detailed"> -<term><menuchoice> -<guimenu>Options</guimenu><guisubmenu>View</guisubmenu> -<guimenuitem>Detailed View</guimenuitem> -</menuchoice></term> -<listitem><para>Displays <guilabel>Name</guilabel>, <guilabel>Date</guilabel> -and <guilabel>Size</guilabel> of the files.</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-options-view-tree"> -<term><menuchoice> -<guimenu>Options</guimenu><guisubmenu>View</guisubmenu> -<guimenuitem>Tree View</guimenuitem> -</menuchoice></term> -<listitem><para>Like Short View, but folders can be expanded to view their contents.</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-options-view-detailed-tree"> -<term><menuchoice> -<guimenu>Options</guimenu><guisubmenu>View</guisubmenu> -<guimenuitem>Detailed Tree View</guimenuitem> -</menuchoice></term> -<listitem><para>This also allows folders to be expanded, but displays the additional columns -available in Detailed View.</para></listitem> -</varlistentry> - -</variablelist> -</listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-options-hidden"> -<term><menuchoice> -<shortcut> - <keycombo action="simul">&Alt;<keycap>.</keycap></keycombo> -</shortcut> -<guimenu>Options</guimenu><guimenuitem>Show Hidden Files</guimenuitem> -</menuchoice></term> -<listitem><para>Displays files or folders normally hidden by your operating system. -<!--FIXME -Explain what is a hidden file/folder - in unix/linux with leading period/full stop character -Use case - user settings, operating system files in linux/unix -how does this work on Mac/Windows? ---> -The alternate shortcut for this action is <keycap>F8</keycap>. -</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-options-show-places"> -<term><menuchoice> -<shortcut><keycap>F9</keycap></shortcut> -<guimenu>Options</guimenu><guimenuitem>Show Places Navigation Panel</guimenuitem> -</menuchoice></term> -<listitem><para>Displays the places panel which provides quick access -to bookmarked locations and disks or other media.</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-options-show-bookmarks"> -<term><menuchoice> -<guimenu>Options</guimenu><guimenuitem>Show Bookmarks</guimenuitem> -</menuchoice></term> -<listitem><para>Displays an additional icon on the toolbar that provides -access to <quote>bookmarks</quote>, a list of saved locations.</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-options-show-preview"> -<term><menuchoice> -<guimenu>Options</guimenu><guimenuitem>Show Aside Preview</guimenuitem> -</menuchoice></term> -<listitem><para>Displays a preview of the currently highlighted file to the -right of the folder view.</para></listitem> -</varlistentry> - -</variablelist> -</listitem> -</varlistentry> - -<varlistentry id="files-ui-toolbar-bookmarks"> -<term><guibutton>Bookmarks</guibutton></term> -<listitem><para>Opens a submenu to edit or add bookmarks and to add a new -bookmark folder.</para></listitem> -</varlistentry> - -</variablelist> -</listitem> -</varlistentry> - -<!--adapted from dolphin documentation--> -<varlistentry id="files-ui-location"> -<term>Location Bar</term> -<listitem> -<para>The location bar, which can be found on top of the folder view, displays -the path to the current folder. The location bar has two modes:</para> - -<variablelist> -<varlistentry id="files-ui-location-breadcrumb"> -<term>Bread Crumb Mode</term> -<listitem> -<para>In the <quote>bread crumb</quote> mode, which is the default, each folder -name in the path to the current folder is a button which can be clicked to quickly -open that folder. Moreover, clicking the <quote>></quote> sign to the right of -a folder opens a menu which permits to quickly open a subfolder of that folder. -</para> - -<screenshot id="screenshot-files-locationbar-breadcrumb"> -<screeninfo>Screenshot of the location bar in bread crumb mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="files-locationbar-breadcrumb.png" format="PNG"/> -</imageobject> -<textobject> -<phrase>Location bar in bread crumb mode.</phrase> -</textobject> -<caption><para>Location bar in bread crumb mode.</para></caption> -</mediaobject> -</screenshot> - -</listitem> -</varlistentry> - -<varlistentry id="files-ui-location-editable"> -<term>Editable Mode</term> -<listitem> -<para>When in bread crumb mode, clicking in the gray area to the right of the path -with the &LMB; switches the location bar to the <quote>editable</quote> mode, -in which the path can be edited using the keyboard. To switch back to bread -crumb mode, click the check mark at the right of the location bar with the &LMB;. -</para> - -<screenshot> -<screeninfo>Screenshot of the location bar in editable mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="files-locationbar-editable.png" format="PNG"/> -</imageobject> -<textobject> -<phrase>Location bar in editable mode.</phrase> -</textobject> -<caption><para>Location bar in editable mode.</para></caption> -</mediaobject> -</screenshot> - -</listitem> -</varlistentry> - -<!--currently in dolphin only, should be added to the file dialog when this is implemented there 4.9/10? -<varlistentry id="files-ui-location-context"> -<term>Places</term> - -<listitem> -<para>If the <guilabel>Places</guilabel> panel is hidden; in both modes an -additional icon in front of the path is displayed. This icon can be clicked with -the &LMB; to open a menu which offers quick access to <quote>places</quote> and -storage media. See the <link linkend="files-ui-places">section about the Places -Panel</link> for details.</para> - -<screenshot id="screenshot-files-locationbar-places-icon"> -<screeninfo>Location bar with Places icon</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="files-locationbar-places-icon.png" format="PNG"/> -</imageobject> -<textobject> -<phrase>Location bar with Places icon</phrase> -</textobject> -</mediaobject> -</screenshot> - -</listitem> -</varlistentry>--> - -</variablelist> - -<para>The context menu of the location bar offers action to switch between the modes and -to copy and paste the path using the clipboard. Check the last option in this context menu to -display either the full path starting with the root folder of the file system or to display -the path starting with the current places entry. -</para> - -<screenshot id="screenshot-files-locationbar-context-menu"> -<screeninfo>Location bar context menu</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="files-locationbar-context-menu.png" format="PNG"/> -</imageobject> -<textobject> -<phrase>Location bar context menu</phrase> -</textobject> -</mediaobject> -</screenshot> - -</listitem> -</varlistentry> - -<varlistentry id="files-ui-places"> -<term>The <guilabel>Places</guilabel> List</term> -<listitem><para>This provides the standard &kde; list of Places, shared with -&dolphin; and other file management tools.</para></listitem> -</varlistentry> -<!-- add options for places here -e.g "Show only in" to have kind a bookmarks special for an application etc. -how to add/edit entries, -mount/unmount devices -show/hide entries -size changes via splitter moving, different in dolhin (context menu with 4 predefined icon sizes) - --> -<varlistentry id="files-ui-folder-view"> -<term>The Folder View</term> -<listitem> -<para>The largest part of the file selection window is the area that lists all -items in the current directory. To select a file, you can double-click on it, -or choose one and hit <guibutton>Open</guibutton> or -<guibutton>Save</guibutton>.</para> -<!-- FIXME select a file by typing the first letters of its name--> -<para>You can also select multiple files at once. To select specific files, or -to unselect specific files that are already selected, press and hold &Ctrl;, -click on each file, then release &Ctrl;. To select a -contiguous group of files, click the first file, press and hold &Shift;, click -on the last file in the group, and release &Shift;.</para> - -<para>The Folder View supports a limited set of file operations, which can be -accessed by right-clicking on a file to access its context menu, or using -keyboard shortcuts. The following items are available in the context menu:</para> - -<variablelist> - -<varlistentry> -<term><guimenuitem>Create New...</guimenuitem></term> -<listitem><para>Create a new file or folder.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guimenuitem>Move to Trash...</guimenuitem> -(<keycombo action="simul"><keycap>Del</keycap></keycombo>)</term> -<listitem><para>Move the currently selected item to the trash.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guisubmenu>Sorting</guisubmenu></term> -<listitem><para>This submenu can also be accessed from the toolbar, and is -described in <xref linkend="files-ui-toolbar-options-sorting"/>.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guisubmenu>View</guisubmenu></term> -<listitem><para>This submenu can also be accessed from the toolbar, and is -described in <xref linkend="files-ui-toolbar-options-view"/>.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guimenuitem>Open File Manager</guimenuitem></term> -<listitem><para>Opens the current folder in your default file manager -application.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guimenuitem>Properties</guimenuitem> -(<keycombo action="simul">&Alt;&Enter;</keycombo>)</term> -<listitem><para>Open the Properties window that allows you to view and modify -various types of metadata related to the currently selected file.</para></listitem> -</varlistentry> - -</variablelist> -</listitem> -</varlistentry> - -<varlistentry id="files-ui-preview"> -<term>The Preview Pane</term> -<listitem><para>If enabled, this displays a preview of the currently highlighted -file.</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-name"> -<term>The <guilabel>Name</guilabel> Entry</term> -<listitem><para>When a file is selected, a name will appear in this text box. -You may also manually enter a file name or path in this text box.</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-filter"> -<term>The <guilabel>Filter</guilabel> Entry</term> -<listitem> -<para>When opening a file, the <guilabel>Filter</guilabel> 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. For instance, you can -enter <userinput>*.cpp *.h *.moc</userinput> to display several different -common &Qt; programming files.</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. You can disable the filter by pressing -the <guibutton>Clear text</guibutton> button to the left of the autocompletion -arrow button.</para> - -<para>When saving a file, the <guilabel>Filter</guilabel> entry will instead -display a drop down box that allows you to select from all the file types the -application supports. Select one to save a file in that format.</para> -</listitem> -</varlistentry> - -<varlistentry id="files-ui-autoselect-extension"> -<term><guilabel>Automatically select filename extension</guilabel></term> -<listitem><para>When saving a file, this check box will appear. When selected -(the default), the application will automatically append the default file -extension for the selected file type to the end of the file name, if it does -not already appear in the <guilabel>Name</guilabel> entry. The file extension -that will be used is listed in parenthesis at the end of the check box label. -</para> - -<screenshot id="screenshot-files-save"> -<screeninfo>The File Save Window</screeninfo> -<mediaobject> -<imageobject><imagedata fileref="files-save.png" format="PNG"/></imageobject> -<textobject><phrase>The File Save window.</phrase></textobject> -<caption><para>Saving a file in -<ulink url="http://kde.org/applications/internet/konqueror/">&konqueror;</ulink>. -</para></caption> -</mediaobject> -</screenshot> - -</listitem> -</varlistentry> - -<varlistentry id="files-ui-open-save"> -<term>The <guibutton>Open</guibutton> or <guibutton>Save</guibutton> Button</term> -<listitem><para>Depending on the action being performed, an -<guibutton>Open</guibutton> or <guibutton>Save</guibutton> button will be -displayed. Clicking on this button will close the file selection window and -perform the requested action.</para></listitem> -</varlistentry> - -<varlistentry id="files-ui-cancel"> -<term>The <guibutton>Cancel</guibutton> Button</term> -<listitem><para>Clicking <guibutton>Cancel</guibutton> will close the file -dialog without performing any action.</para></listitem> -</varlistentry> - -</variablelist> - -</sect2> - -<sect2 id="files-ack"> -<title>Thanks and Acknowledgments</title> - -<para>Special thanks to Google Code-In 2011 participant Alexey Subach for -writing parts of this section.</para> - -</sect2> - -</sect1> - - -<sect1 id="spellcheck"> -<sect1info> -<authorgroup> -<author>&David.Sweet; &David.Sweet.mail;</author> -<author><firstname>Salma</firstname> <surname>Sultana</surname></author> -<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> -</sect1info> -<title>Check Spelling</title> - -<para>&sonnet; is the spelling checker used by &kde; applications such as &kate;, -&kmail;, and &kword;. It is a &GUI; frontend to various free spell checkers.</para> - -<para>To use &sonnet; you need to install a spell checker like -<application>&GNU; Aspell</application>, <application>Enchant</application>, -<application>Hspell</application>, <application>ISpell</application> or -<application>Hunspell</application> and additionally the corresponding -dictionaries for the languages that you wish to use.</para> - -<sect2 id="spellcheck-check"> -<title>Check Spelling</title> - -<screenshot id="screenshot-spellcheck-check"> -<screeninfo>The Check Spelling Window</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="spellcheck-check.png" format="PNG"/> -</imageobject> -<textobject> -<phrase>The Check spelling window.</phrase> -</textobject> -<caption><para>Correcting a misspelling.</para></caption> -</mediaobject> -</screenshot> - -<para>To check spelling, go to <menuchoice><guimenu>Tools</guimenu> -<guimenuitem>Spelling...</guimenuitem></menuchoice>.</para> - -<para>If a word is possibly misspelled in your document, it is displayed in the -top line in the dialog. &sonnet; tries to appropriate word(s) for replacement. -The best guess is displayed to the right of <guilabel>Replace with</guilabel>. -To accept this replacement, click on <guibutton>Replace</guibutton>.</para> - -<para>&sonnet; also allows you to select a word from the list of suggestions and -replace the misspelled word with that selected word. With the help of the -<guibutton>Suggest</guibutton> button, you can add more suggestions from the -dictionary to the suggestions list.</para> - -<para>Click on <guibutton>Ignore</guibutton> to keep your original spelling.</para> - -<para>Click on <guibutton>Finished</guibutton> to stop spellchecking and -<emphasis>keep</emphasis> the changes made.</para> - -<para>Click on <guibutton>Cancel</guibutton> to stop spellchecking and -<emphasis>cancel</emphasis> the changes already made.</para> - -<para>Click on <guibutton>Replace All</guibutton> to automatically replace -the misspelled word(s) with the chosen replacement word, if they appear again in -your document later.</para> - -<para>Click on <guibutton>Ignore All</guibutton> to ignore the spelling at -that point and all the future occurrences of the word misspelled.</para> - -<para>Click on <guibutton>Add to Dictionary</guibutton> to add the misspelled -word to your personal dictionary.</para> - -<para>The <guilabel>Personal Dictionary</guilabel> is a distinct dictionary from the -system dictionary and the additions made by you will not be seen by others.</para> - -<para>The drop down box <guilabel>Language</guilabel> at the bottom of this -dialog allows you to switch to another dictionary temporarily.</para> - -</sect2> - -<sect2 id="spellcheck-auto"> -<title>Automatic Spell Checking</title> - -<!--FIXME:screenshot--> - -<para>In many applications, you can automatically check spelling as you type. -To enable this feature, select <menuchoice><guimenu>Tools</guimenu> -<guimenuitem>Automatic Spell Checking</guimenuitem></menuchoice>.</para> - -<para>Potentially misspelled words will be underlined in red. To select a -suggestion, right click on the word, select the <guisubmenu>Spelling</guisubmenu> -submenu, and select the suggestion. You may also instruct &sonnet; to ignore -this spelling for this document by selecting <guimenuitem>Ignore Word</guimenuitem>, -or you may select <guimenuitem>Add to Dictionary</guimenuitem> to save it in your -personal dictionary.</para> - -</sect2> - -<sect2 id="spellcheck-config"> -<title>Configuring &sonnet;</title> - -<para>To change your dictionary, go to <menuchoice><guimenu>Tools</guimenu> -<guimenuitem>Change Dictionary...</guimenuitem></menuchoice>. A small window will -appear at the bottom of the current document that will allow you to change your -dictionary.</para> - -<!--FIXME: maybe move kcm handbook here too?--> -<para>For more information on configuring &sonnet;, see the -<ulink url="help:kcontrol/spellchecking">Spell Checker &systemsettings; module -documentation</ulink></para> - -</sect2> - -<sect2 id="spellcheck-ack"> -<title>Thanks and Acknowledgments</title> - -<para>Special thanks to Google Code-In 2011 Participant Salma Sultana for writing -much of this section.</para> - -</sect2> - -</sect1> - - -<sect1 id="find"> -<sect1info> -<authorgroup> -<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> -</sect1info> -<title>Find and Replace</title> - -<!--FIXME -different visual appearance, lot of common options for all Find/Search bars or windows -Find window used in KMail Composer, where else? -Search bar used e.g. in Konsole/Konqueror Views (readonly) -Search+Replace bar in Kate/KWrite - --> -<para>The Find function of many &kde-sc; applications lets you find specific -text in a document, while the Replace function allows you to replace text that -is found with different text you provide.</para> - -<para>You can find both these functions in the <guimenu>Edit</guimenu> menu of -many &kde; applications. For more information on this menu, see -<xref linkend="menus-edit"/>.</para> - -<sect2 id="find-find"> -<title>The Find Function</title> - -<para>The Find function searches for text in a document and selects it.</para> - -<screenshot id="screenshot-find-find"> -<screeninfo>The Find Window</screeninfo> -<mediaobject> -<imageobject><imagedata fileref="find-find.png" format="PNG"/></imageobject> -<textobject><phrase>The Find window.</phrase></textobject> -<caption><para>Searching for <userinput>software</userinput> in -<ulink url="http://kde.org/applications/internet/kmail/">&kmail;'s composer window</ulink>. -</para></caption> -</mediaobject> -</screenshot> - -<para>To use Find in many applications, go to <menuchoice><guimenu>Edit</guimenu> -<guimenuitem>Find...</guimenuitem></menuchoice> or press -<keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>. Then, in the -<guilabel>Text to find:</guilabel> text box, enter the text that you want to -find.</para> - -<para>If <guilabel>Regular expression</guilabel> is checked you will be able to -search using regular expressions. Click on <guibutton>Edit</guibutton> to select -from and enter commonly used regular expression characters, like -<guilabel>White Space</guilabel> or <guilabel>Start of Line</guilabel>. If -&kate; is installed, you can find -<ulink url="help:/kate/regular-expressions.html">more information on writing -regular expressions in its documentation</ulink>.</para> - - -<para>You can limit the found results by configuring these options:</para> -<variablelist> - -<varlistentry> -<term><guilabel>Case sensitive</guilabel></term> -<listitem><para>Capital and lowercase characters are considered different. For -example, if you search for <quote>This</quote>, results that contain -<quote>this</quote> will not be returned.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Whole words only</guilabel></term> -<listitem><para>By default, when the application searches for text, it will -return results even in the middle of other text. For instance, if you search -for <quote>is</quote> it will stop on every word that contains that, -like <quote>th<emphasis>is</emphasis></quote> or -<quote>h<emphasis>is</emphasis>tory</quote>. If you check this option, the -application will only return results when the search text is a word by itself, -that is, surrounded by whitespace.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>From cursor</guilabel></term> -<listitem><para>The search will start from the location of the cursor and stop -at the end of the text.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Find backwards</guilabel></term> -<listitem><para>By default, the application searches for the text starting at -the beginning of the document, and move through it to the end. If you check this -option, it will instead start at the end and work its way to the beginning. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Selected text</guilabel></term> -<listitem><para>Select this option to search only in the text that is currently -selected, not the entire document. It is disabled when no text is selected. -</para></listitem> -</varlistentry> - -</variablelist> - -<para>The Find function only selects the first match that it finds. You can -continue searching by selecting <menuchoice><guimenu>Edit</guimenu><guimenuitem>Find Next</guimenuitem></menuchoice> -or by pressing <keycap>F3</keycap>.</para> - -<screenshot id="screenshot-find-found"> -<screeninfo>Example of a Search</screeninfo> -<mediaobject> -<imageobject><imagedata fileref="find-found.png" format="PNG"/></imageobject> -<textobject><phrase>Example of a search.</phrase></textobject> -<caption><para>&kmail; displays a match for <userinput>software</userinput>. -</para></caption> -</mediaobject> -</screenshot> - -<!--FIXME -Copy documentation from Kate/KWrite here. - --> -<para>Applications which use the &kde; text editor component show a search bar instead of the Find window. See <ulink url="help:/kwrite/edit.html#find">&kwrite; documentation</ulink> for additional information on the search bar.</para> - -<screenshot id="screenshot-find-find-inline"> -<screeninfo>The search bar in &kate;.</screeninfo> -<mediaobject> -<imageobject><imagedata fileref="find-find-inline.png" format="PNG"/></imageobject> -<textobject><phrase>The search bar in &kate;.</phrase></textobject> -<caption><para>Searching for <userinput>software</userinput> in &kate;'s search bar. -</para></caption> -</mediaobject> -</screenshot> - -</sect2> - -<sect2 id="find-replace"> -<title>The Replace Function</title> - -<para>The Replace function searches for text in a document and replaces it with -other text. You can find it in many application at -<menuchoice><guimenu>Edit</guimenu><guisubmenu>Replace...</guisubmenu></menuchoice> -or by pressing <keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo>.</para> - -<screenshot id="screenshot-find-replace"> -<screeninfo>The Replace Window</screeninfo> -<mediaobject> -<imageobject><imagedata fileref="find-replace.png" format="PNG"/></imageobject> -<textobject><phrase>The Replace window.</phrase></textobject> -<caption><para>Replacing <userinput>food</userinput> with -<userinput>drink</userinput> in &kmail;</para></caption> -</mediaobject> -</screenshot> - -<para>The window of the Replace function is separated into 3 sections:</para> -<variablelist> - -<varlistentry> -<term><guilabel>Find</guilabel></term> -<listitem><para>Here you may enter the text you wish to search for. See -<xref linkend="find-find"/> for more information on the options provided here. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Replace</guilabel></term> -<listitem> -<para>Here you may enter the text you wish to replace the found text with.</para> - -<para>You can reuse the found text in the replacement text by selecting the -<guilabel>Use placeholders</guilabel> checkbox. Placeholders, sometimes known as -backreferences, are a special character sequence that will be replaced with all -or part of the found text. For instance, <quote>\0</quote> represents the -entire found string.</para> -<para> You may insert placeholders into the text box by clicking the -<guibutton>Insert Placeholder</guibutton> button, then selecting an option from -the menu like <guimenuitem>Complete Match</guimenuitem>. For example, if you are -searching for <quote>message</quote>, and you want to replace it with -<guilabel>messages</guilabel> insert the <guimenuitem>Complete Match</guimenuitem> -placeholder and add an <quote>s</quote>. The replace field will then -contain <quote>\0s</quote>.</para> - -<para>If &kate; is installed, you can learn more about placeholders in the -<ulink url="help:/kate/regular-expressions.html">Regular Expressions appendix -of its documentation</ulink>.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Options</guilabel></term> -<listitem><para>This contains all the same options that the -<link linkend="find-find">Find</link> function does, with one addition:</para> -<para>If the <guilabel>Prompt on replace</guilabel> option is checked a window -will appear on every found word, allowing you to confirm whether you would like -to replace the found text.</para></listitem> -</varlistentry> - -</variablelist> - -<!--FIXME -Copy documentation from Kate/KWrite here. - --> -<para>Applications which use the &kde; text editor component show a search and replace bar instead of the Replace window. See <ulink url="help:/kwrite/edit.html#replace">&kwrite; documentation</ulink> for additional information on the search and replace bar.</para> - -<screenshot id="screenshot-find-replace-inline"> -<screeninfo>The search and replace bar.</screeninfo> -<mediaobject> -<imageobject><imagedata fileref="find-replace-inline.png" format="PNG"/></imageobject> -<textobject><phrase>The search and replace bar.</phrase></textobject> -<caption><para>Replacing <userinput>kmail</userinput> with -<userinput>kate</userinput> in &kate;'s search and replace bar</para></caption> -</mediaobject> -</screenshot> - -</sect2> - -<sect2 id="find-ack"> -<title>Thanks and Acknowledgments</title> -<para>Thanks to an anonymous Google Code-In 2011 participant for writing much -of this section.</para> -</sect2> - -</sect1> - - -<sect1 id="fonts"> -<sect1info> -<authorgroup> -<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> -</sect1info> -<title>Choosing Fonts</title> - -<para>The font selector appears in many different &kde; applications. It lets -you select the font face, font style, and font size of the text that appears in -your application.</para> - -<screenshot id="screenshot-fonts"> -<screeninfo>The Font Selector</screeninfo> -<mediaobject> -<imageobject><imagedata fileref="fonts.png" format="PNG"/></imageobject> -<textobject><phrase>The font selector.</phrase></textobject> -<caption><para>Selecting a font in -<ulink url="help:/systemsettings">&systemsettings;</ulink>.</para></caption> -</mediaobject> -</screenshot> - -<variablelist> - -<varlistentry> -<term><guilabel>Font</guilabel></term> -<listitem><para>This is the leftmost selection box, and lets you choose the -font face from a list of fonts on your system.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Font style</guilabel></term> -<listitem> -<para>This is the center selection box, and lets you choose the font style from -the following choices:</para> -<itemizedlist> - -<listitem><para><guilabel>Italic</guilabel> - this displays text in a cursive, -or slanted fashion, and is commonly used for citations or to emphasize text. -</para></listitem> - -<listitem><para><guilabel>Regular</guilabel> - the default. Text is displayed -without any special appearance.</para></listitem> - -<listitem><para><guilabel>Bold Italic</guilabel> - a combination of both -<guilabel>Bold</guilabel> and <guilabel>Italic</guilabel></para></listitem> - -<listitem><para><guilabel>Bold</guilabel> - this displays text in a darker, -thicker fashion, and is commonly used for titles of documents or to emphasize -text.</para></listitem> - -</itemizedlist> -</listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Size</guilabel></term> -<listitem><para>This is the rightmost selection box, and lets you select the -size of your text. Font size is measured in <emphasis>points</emphasis>, a -standard unit of measure in typography. For more information on this, see -<ulink url="http://en.wikipedia.org/wiki/Point_(typography)">the <quote>Point -(typography)</quote> article on Wikipedia</ulink>.</para></listitem> -</varlistentry> - -<varlistentry> -<term>Preview</term> -<listitem><para>The bottom of the font selector displays a preview of text using -the font settings that are currently selected. You may change this text if you -wish.</para></listitem> -</varlistentry> - -</variablelist> -</sect1> - - -<sect1 id="colors"> -<sect1info> -<authorgroup> -<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> -</sect1info> -<title>Choosing Colors</title> - -<para>The color chooser appears in many &kde; applications, whenever you need - to select a color. It lets you pick from a <quote>palette</quote> consisting of many -predefined colors or mix your own when you want a specific color.</para> - -<screenshot id="screenshot-colors"> -<screeninfo>The Color Selector</screeninfo> -<mediaobject> -<imageobject><imagedata fileref="colors.png" format="PNG"/></imageobject> -<textobject><phrase>The color selector.</phrase></textobject> -<caption><para>Selecting a color in -<ulink url="help:/systemsettings">&systemsettings;</ulink>.</para></caption> -</mediaobject> -</screenshot> - -<sect2 id="colors-palette"> -<title>Using Palettes</title> - -<para>A palette is a set of predefined colors. You can find it on the right -side of the color chooser window.</para> - -<para>To select a color from a palette, simply click on it. The color will be -displayed below the palette, along with its &HTML; hexadecimal code and name, if -any.</para> - -<para>To switch between them, use the drop down box above the color palette. -Most palettes will display a grid consisting of the colors, except for the -<guilabel>Named Colors</guilabel>, which lets you select from a list of names. -Other special palettes include <guilabel>* Recent Colors *</guilabel>, which -will display colors that you have recently selected, and -<guilabel>* Custom Colors *</guilabel>, which will display custom colors that -you have saved. For more information on setting custom colors, see -<xref linkend="colors-custom"/></para> - -</sect2> - -<sect2 id="colors-mixing"> -<title>Mixing Colors</title> - -<para>The color chooser also lets you mix your own colors. There are several -ways to do this:</para> - -<sect3 id="colors-mixing-select"> -<title>Using the Grid</title> - -<para>The left side of the color chooser contains a large box, and a thinner box -immediately to its right. You can use the left box to select the Hue and -Saturation of the desired color based on the visual guide provided in the box. -The right bar adjusts the Value. Adjust these to select the desired color, -which is displayed in the lower-right corner of the window.</para> - -<para>For more information on Hue, Saturation, and Value, see -<xref linkend="colors-mixing-hsv"/></para> - -</sect3> - -<sect3 id="colors-mixing-eyedropper"> -<title>Using the Eyedropper</title> - -<para>The eyedropper tool allows you to select a color from your screen. To use -it, select the <guibutton>eyedropper</guibutton> button to the right of the -<guibutton>Add to Custom Colors</guibutton> button, and then click anywhere on -your screen to select that color.</para> - -</sect3> - -<sect3 id="colors-mixing-hsv"> -<title>Hue/Saturation/Value</title> - -<para>The lower-left corner of the screen allows you to manually enter the -coordinates of the desired color in the Hue/Saturation/Value -(<acronym>HSV</acronym>) color space. For more information on this, see -<ulink url="https://en.wikipedia.org/wiki/HSL_and_HSV">the <quote>HSL and -HSV</quote> article on Wikipedia</ulink>.</para> - -<para>These values are also updated when selecting a color by other methods, -so they always accurately represent the currently selected color.</para> - -</sect3> - -<sect3 id="colors-mixing-rgb"> -<title>Red/Green/Blue</title> - -<para>The lower-left corner of the screen also allows you to manually enter the -coordinates of the desired color in the Red/Green/Blue (<acronym>RGB</acronym>) -color model. For more information on this, see -<ulink url="https://en.wikipedia.org/wiki/RGB_color_model">the <quote>RGB color -model</quote> article on Wikipedia</ulink>.</para> - -<para>These values are also updated when selecting a color by other methods, -so they always accurately represent the currently selected color.</para> - -</sect3> - -<sect3 id="colors-mixing-HTML"> -<title>&HTML; Hexadecimal Code</title> - -<para>You may enter the &HTML; hexadecimal code representing -the color in the lower-right corner of the screen. For more information on this, -see <ulink url="http://en.wikipedia.org/wiki/Web_colors">the <quote>Web -colors</quote> article on Wikipedia</ulink>.</para> - -<para>This value is also updated when selecting a color by other methods, -so it always accurately represents the currently selected color.</para> - -</sect3> -</sect2> - -<sect2 id="colors-custom"> -<title>Saving Custom Colors</title> - -<para>After selecting a color, you may save it to the Custom Colors palette so -you can find it later. To do so, click the -<guibutton>Add to Custom Colors</guibutton> button. You can then find it by -selecting the <guilabel>* Custom Colors *</guilabel> palette from the drop -down box in the upper-right corner of the screen. For more information on using -palettes, see <xref linkend="colors-palette"/>.</para> - -</sect2> - -</sect1> - -</chapter> diff --git a/doc/fundamentals/toolbars-configure.png b/doc/fundamentals/toolbars-configure.png deleted file mode 100644 index 52ff11c..0000000 Binary files a/doc/fundamentals/toolbars-configure.png and /dev/null differ diff --git a/doc/fundamentals/toolbars-toolbar.png b/doc/fundamentals/toolbars-toolbar.png deleted file mode 100644 index a204b1b..0000000 Binary files a/doc/fundamentals/toolbars-toolbar.png and /dev/null differ diff --git a/doc/fundamentals/ui.docbook b/doc/fundamentals/ui.docbook deleted file mode 100644 index 6c91d31..0000000 --- a/doc/fundamentals/ui.docbook +++ /dev/null @@ -1,1983 +0,0 @@ -<!--FIXME: - -general toolbar info - -basic keyboard shortcuts? ---> - -<chapter id="ui"> -<title>Finding Your Way Around</title> - -<sect1 id="visualdict"> -<sect1info> -<authorgroup> -<author><firstname>Claus</firstname> <surname>Christensen</surname></author> -<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> -</sect1info> - -<title>A Visual Dictionary</title> - -<para>The &plasma-workspaces; feature many different graphical user interface -elements, commonly known as <quote>widgets</quote>. This guide will introduce -you to their names and functions.</para> - -<sect2 id="visualdict-screens"> -<title>The Big Picture</title> - -<sect3 id="visualdict-windows"> -<title>Windows</title> - -<screenshot> -<screeninfo>A Window</screeninfo> -<mediaobjectco> -<imageobjectco> -<areaspec units="other" otherunits="imagemap"> - <!--these ids are used only internally by DocBook so we keep them short--> - <area id="im-win1a1" linkends="visualdict-statusbar" coords="47,522,752,566" /> - <area id="im-win1a2" linkends="visualdict-scrollbar" coords="720,127,760,513" /> - <area id="im-win1a3" linkends="visualdict-central-widget" coords="48,127,719,515" /> - <area id="im-win1a4" linkends="visualdict-toolbar" coords="51,95,570,128" /> - <area id="im-win1a5" linkends="visualdict-menubar" coords="4,67,46,109" /> - <area id="im-win1a6" linkends="visualdict-menubar" coords="49,75,311,93" /> - <area id="im-win1a7" linkends="visualdict-menu" coords="50,51,72,70" /> - <area id="im-win1a8" linkends="visualdict-button" coords="74,52,93,69" /> - <area id="im-win1a9" linkends="visualdict-button" coords="678,51,747,70" /> - <area id="im-win1a10" linkends="visualdict-titlebar" coords="106,40,676,74" /> - <area id="im-win1a11" linkends="visualdict-button" coords="691,6,740,49" /> - <area id="im-win1a12" linkends="visualdict-titlebar" coords="346,0,388,37" /> - <area id="im-win1a13" linkends="visualdict-button" coords="61,1,103,43" /> - <area id="im-win1a14" linkends="visualdict-menu" coords="14,2,57,45" /> -</areaspec> -<imageobject><imagedata fileref="visualdict-window.png" format="PNG"/></imageobject> -</imageobjectco> -</mediaobjectco> -</screenshot> -<para>This is the window of the &kwrite;, a text editor. Click on -part of the window to learn more about it.</para> - -<orderedlist> - -<listitem><para> -The <emphasis role="bold">Window Menu</emphasis> -</para></listitem> - -<listitem><para> -A <link linkend="visualdict-button">Button</link> to place this window on all -desktops -</para></listitem> - -<listitem><para> -The <emphasis role="bold"><link linkend="visualdict-titlebar">Titlebar</link></emphasis> -</para></listitem> - -<listitem><para> -Buttons to <emphasis>minimize</emphasis>, <emphasis>maximize</emphasis>, or -<emphasis>close</emphasis> the window -</para></listitem> - -<listitem><para> -The <emphasis role="bold"><link linkend="visualdict-menubar">Menubar</link></emphasis> -</para></listitem> - -<listitem><para> -The <emphasis role="bold"><link linkend="visualdict-toolbar">Toolbar</link></emphasis> -</para></listitem> - -<listitem><para> -A very large -<emphasis role="bold"><link linkend="visualdict-text-area">Text Area</link></emphasis> -that acts as this program's -<emphasis role="bold"><link linkend="visualdict-central-widget">Central Widget</link></emphasis> -</para></listitem> - -<listitem><para> -A vertical <emphasis role="bold"><link linkend="visualdict-scrollbar">Scrollbar</link></emphasis> -(there is also a horizontal scrollbar below the text box) -</para></listitem> - -<listitem><para> -The <emphasis role="bold"><link linkend="visualdict-statusbar">Statusbar</link></emphasis> -</para></listitem> - -</orderedlist> - -<screenshot> -<screeninfo>Another Window</screeninfo> -<mediaobjectco> -<imageobjectco> -<areaspec units="other" otherunits="imagemap"> - <area id="im-win2a1" linkends="visualdict-panel" coords="580,80,763,529" /> - <area id="im-win2a2" linkends="visualdict-slider" coords="383,490,573,536" /> - <area id="im-win2a3" linkends="visualdict-context-menu" coords="199,225,451,462" /> - <area id="im-win2a4" linkends="visualdict-icon" coords="198,187,224,225" /> - <area id="im-win2a5" linkends="visualdict-icon" coords="121,187,197,276" /> - <area id="im-win2a6" linkends="visualdict-icon" coords="282,110,515,165" /> - <area id="im-win2a7" linkends="visualdict-icon" coords="124,111,211,163" /> - <area id="im-win2a8" linkends="visualdict-breadcrumb" coords="108,76,415,109" /> - <area id="im-win2a9" linkends="visualdict-panel" coords="1,73,107,544" /> -</areaspec> -<imageobject><imagedata fileref="visualdict-window2.png" format="PNG"/></imageobject> -</imageobjectco> -</mediaobjectco> -</screenshot> - -<para>This is the another window, that of the &dolphin; file manager. Click on -part of the window to learn more about it.</para> - -<orderedlist> - -<listitem><para> -A <emphasis role="bold"><link linkend="visualdict-panel">panel</link></emphasis> -that contains a list of Places on the computer system -</para></listitem> - -<listitem><para> -A <emphasis role="bold"><link linkend="visualdict-breadcrumb">Breadcrumb</link></emphasis> -of the path of the displayed folder -</para></listitem> - -<listitem><para> -A folder <emphasis role="bold"><link linkend="visualdict-icon">Icon</link></emphasis> -</para></listitem> - -<listitem><para> -A file <emphasis role="bold"><link linkend="visualdict-icon">Icon</link></emphasis> -</para></listitem> - -<listitem><para> -A highlighted <emphasis role="bold"><link linkend="visualdict-icon">Icon</link></emphasis> -</para></listitem> - -<listitem><para> -A <emphasis role="bold"><link linkend="visualdict-context-menu">Context Menu</link></emphasis> -listing actions that can be performed on a file -</para></listitem> - -<listitem><para> -A <emphasis role="bold"><link linkend="visualdict-slider">Slider</link></emphasis> -that changes the size of the <link linkend="visualdict-icon">Icons</link> -displayed -</para></listitem> - -<listitem><para> -More <emphasis role="bold"><link linkend="visualdict-panel">Panels</link></emphasis> -</para></listitem> - -</orderedlist> - -</sect3> - -<sect3 id="visualdict-gui"> -<title>&GUI; Elements</title> - -<screenshot> -<screeninfo>Some &GUI; Elements</screeninfo> -<mediaobjectco> -<imageobjectco> -<areaspec units="other" otherunits="imagemap"> - <area id="im-g1a1" linkends="visualdict-button" coords="15,505,690,549" /> - <area id="im-g1a2" linkends="visualdict-button" coords="683,129,722,170" /> - <area id="im-g1a3" linkends="visualdict-button" coords="636,140,681,161" /> - <area id="im-g1a4" linkends="visualdict-drop-down-box" coords="225,137,631,327" /> - <area id="im-g1a5" linkends="visualdict-tab" coords="581,28,625,71" /> - <area id="im-g1a6" linkends="visualdict-tab" coords="172,112,632,135" /> - <area id="im-g1a7" linkends="visualdict-icon-list" coords="5,58,171,495" /> -</areaspec> -<imageobject><imagedata fileref="visualdict-gui1.png" format="PNG"/></imageobject> -</imageobjectco> -</mediaobjectco> -</screenshot> - -<para>This screenshot, from the &systemsettings; Country/Region & Language panel, -shows some &GUI; elements. Click on part of the window to learn more about it.</para> - -<orderedlist> - -<listitem><para> -An <emphasis role="bold"><link linkend="visualdict-icon-list">Icon List</link></emphasis> -(the first item is selected) -</para></listitem> - -<listitem><para> -Some <emphasis role="bold"><link linkend="visualdict-tab">Tabs</link></emphasis> -</para></listitem> - -<listitem><para> -An open -<emphasis role="bold"><link linkend="visualdict-drop-down-box">Drop Down Box</link></emphasis> -</para></listitem> - -<listitem><para> -A <emphasis role="bold"><link linkend="visualdict-button">Button</link></emphasis> -that resets the <link linkend="visualdict-drop-down-box">Drop Down Box</link> to -its default value -</para></listitem> - -<listitem><para> -An item in the <link linkend="visualdict-drop-down-box">Drop Down Box</link> that -has been selected -</para> -</listitem> - -<listitem><para> -Some more <emphasis role="bold"><link linkend="visualdict-button">Buttons</link></emphasis> -</para></listitem> - -</orderedlist> - -<screenshot> -<screeninfo>Some More &GUI; Elements</screeninfo> -<mediaobjectco> -<imageobjectco> -<areaspec units="other" otherunits="imagemap"> - <area id="im-gui2a1" linkends="visualdict-menu-button" coords="306,451,349,493" /> - <area id="im-gui2a2" linkends="visualdict-menu-button" coords="172,405,298,538" /> - <area id="im-gui2a3" linkends="visualdict-spin-box" coords="522,204,638,253" /> - <area id="im-gui2a4" linkends="visualdict-check-box" coords="425,98,467,162" /> - <area id="im-gui2a5" linkends="visualdict-tree-view" coords="368,63,411,100" /> - <area id="im-gui2a6" linkends="visualdict-tree-view" coords="164,101,424,403" /> -</areaspec> -<imageobject><imagedata fileref="visualdict-gui2.png" format="PNG"/></imageobject> -</imageobjectco> -</mediaobjectco> -</screenshot> - -<para>This screenshot, from the &systemsettings; Custom Shortcuts panel, -shows some more &GUI; elements.</para> - -<orderedlist> - -<listitem><para> -A <emphasis role="bold"><link linkend="visualdict-tree-view">Tree View</link></emphasis> -</para></listitem> - -<listitem><para> -A <emphasis role="bold"><link linkend="visualdict-check-box">Check Box</link></emphasis> -that has been selected -</para></listitem> - -<listitem><para> -A pair of <emphasis role="bold"><link linkend="visualdict-spin-box">Spin Boxes</link></emphasis> -</para></listitem> - -<listitem><para> -A <emphasis role="bold"><link linkend="visualdict-menu-button">Menu Button</link></emphasis> -</para></listitem> - -</orderedlist> - -<screenshot> -<screeninfo>Even More &GUI; Elements</screeninfo> -<mediaobjectco> -<imageobjectco> -<areaspec units="other" otherunits="imagemap"> - <area id="im-gui3a1" linkends="visualdict-text-box" coords="562,235,603,252" /> - <area id="im-gui3a2" linkends="visualdict-text-box" coords="214,253,767,280" /> - <area id="im-gui3a3" linkends="visualdict-radio-button" coords="187,193,468,252" /> - <area id="im-gui3a4" linkends="visualdict-list-box" coords="8,101,185,547" /> -</areaspec> -<imageobject><imagedata fileref="visualdict-gui3.png" format="PNG"/></imageobject> -</imageobjectco> -</mediaobjectco> -</screenshot> - -<para>This screenshot, from the &systemsettings; Default Applications panel, -shows even more &GUI; elements. Click on part of the window to learn more about -it.</para> - -<orderedlist> - -<listitem><para> -A <emphasis role="bold"><link linkend="visualdict-list-box">List Box</link></emphasis> -</para></listitem> - -<listitem><para> -A pair of <emphasis role="bold"><link linkend="visualdict-radio-button">Radio Buttons</link></emphasis> -</para></listitem> - -<listitem><para> -A <emphasis role="bold"><link linkend="visualdict-text-box">Text Box</link></emphasis> -</para></listitem> - -</orderedlist> - -<screenshot> -<screeninfo>Some Combo Boxes</screeninfo> -<mediaobjectco> -<imageobjectco> -<areaspec units="other" otherunits="imagemap"> - <area id="im-gui4a1" linkends="visualdict-combo-box" coords="268,128,722,288" /> -</areaspec> -<imageobject><imagedata fileref="visualdict-gui4.png" format="PNG"/></imageobject> -</imageobjectco> -</mediaobjectco> -</screenshot> - -<para>Finally, this screenshot, from another <link linkend="visualdict-tab">tab</link> -of the &systemsettings; Country/Region & Language panel, shows five -<emphasis role="bold"><link linkend="visualdict-combo-box">Combo Boxes</link></emphasis> -</para> - -</sect3> - -</sect2> - -<sect2 id="visualdict-widgets"> -<title>The Widgets</title> - -<informaltable> -<tgroup cols="3"> -<colspec colnum="1" align="left"/> -<colspec colnum="3" align="center"/> - -<thead> -<row> -<entry align="center">Name</entry> -<entry>Description</entry> -<entry>Screenshot</entry> -</row> -</thead> - -<tbody valign="top"> - -<!--I'm using the name QMainWindow uses for these, but perhaps there's a more - regular-user friendly term?--> -<row id="visualdict-central-widget"> -<entry>Central Widget</entry> -<entry>The main area of the running application. This might be the document -you are editing in a word processor or the board of a game like Chess.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-central-widget.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-button"> -<entry>Button</entry> -<entry>These can be clicked with the &LMB; to perform an action.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-button.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-breadcrumb"> -<entry>Breadcrumb</entry> -<entry>Shows the path in a hierarchical system, such as a filesystem. Click on -any part of the path to go up in the tree to that location. Click on the arrow -to the right of part of the path to go to another child element of that path. -</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-breadcrumb.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-check-box"> -<entry>Check Box</entry> -<entry>These can be clicked to select and unselect items. They are typically -used in a list of several selections. Selected items typically display a check -mark, whereas unselected items will have an empty box.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-check-box.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-color-selector"> -<entry>Color Selector</entry> -<entry>This allows a color to be selected for various purposes, such as changing -the color of text. For more information, see <xref linkend="colors"/></entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-color-selector.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-combo-box"> -<entry>Combo Box</entry> -<entry>A combination of a -<link linkend="visualdict-drop-down-box">Drop Down Box</link> and a -<link linkend="visualdict-text-box">Text Box</link>. You can select an option -from the list, or type in the text box. Some combo boxes may automatically -complete entries for you, or open the list with a list of choices that match -what you have typed.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-combo-box.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-context-menu"> -<entry>Context Menu</entry> -<entry>Many user interface elements in the &kde-sc; contain a context menu, -which can be opened by clicking on something with the &RMB;. This menu contains -options and actions that usually affect the user interface element that was -right-clicked.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-context-menu.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-dialog-box"> -<entry>Dialog Box</entry> -<entry>A small window that appears above a larger application window. It may -contain a message, warning, or configuration panel, among others.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-dialog-box.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-drop-down-box"> -<entry>Drop Down Box</entry> -<entry>This provides a list of items, from which you may select one.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-drop-down-box.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-icon"> -<entry>Icon</entry> -<entry>A graphical representation of something, such as a file or action. They -typically, but not always, also contain a text description, either beneath or -to the right of the icon.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-icon.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-icon-list"> -<entry>Icon List</entry> -<entry>This provides a list of items represented by an -<link linkend="visualdict-icon">Icon</link> and a description. It is typically -used in the left panel of configuration panels to allow selection from various -types of configuration categories.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-icon-list.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-list-box"> -<entry>List Box</entry> -<entry>This is a list of items that typically allows multiple items to be -selected. To select a group of contiguous items, press the &Shift; key and -click the first and last items. To select multiple items that are not -contiguous, press the &Ctrl; key and select the desired items.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-list-box.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-menu"> -<entry>Menu</entry> -<entry>A list of selections, that usually perform an action, set an option, or -opens a window. These can be opened from -<link linkend="visualdict-menubar">menubars</link> or -<link linkend="visualdict-menu-button">menu buttons</link>.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-menu.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-menubar"> -<entry>Menubar</entry> -<entry>These are located at the top of nearly every window and provide access -to all the functions of the running application. For more information, see -<xref linkend="menus"/>.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-menubar.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-menu-button"> -<entry>Menu Button</entry> -<entry>A special type of <link linkend="visualdict-button">button</link> that -opens a <link linkend="visualdict-menu">menu</link>.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-menu-button.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-panel"> -<entry>Panel <emphasis>or</emphasis> Sidebar <emphasis>or</emphasis> Tool View</entry> -<entry>These are located on the sides or bottom of the -<link linkend="visualdict-central-widget">central widget</link> and allow -you to perform many different tasks in an application. A text editor might -provide a list of open documents in one, while a word processor might allow you -to select a clip art image.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-panel.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-progress-bar"> -<entry>Progress Bar</entry> -<entry>A small bar that indicates that a long-running operation is being -performed. The bar may indicate how much of the operation has completed, or it -may simply bounce back and forth to indicate that the operation is in progress. -</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-progress-bar.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-radio-button"> -<entry>Radio Button</entry> -<entry>These are used in a list of options, and only permit one of the options in -the list to be selected.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-radio-button.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-scrollbar"> -<entry>Scrollbar</entry> -<entry>Allows you to navigate a document.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-scrollbar.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-slider"> -<entry>Slider</entry> -<entry>Allows a numeric value to be selected by moving a small bar either -horizontally or vertically across a line.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-slider.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-spin-box"> -<entry>Spin Box</entry> -<entry>This permits a numerical value to be selected, either by using the up and -down arrows to the right of the box to raise or lower the value, respectively, -or by typing the value into the -<link linkend="visualdict-text-box">text box</link>.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-spin-box.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-statusbar"> -<entry>Status Bar</entry> -<entry>These are located at the bottom of many applications and display -information about what the application is currently doing. For instance, a web -browser might indicate the progress of loading a web page, while a -word processor might display the current word count.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-statusbar.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-tab"> -<entry>Tab</entry> -<entry>These appear at the top of an area of a window, and permit that area of -the window to be changed to a variety of different selections.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-tab.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-text-area"> -<entry>Text Area</entry> -<entry>Allows a large amount of text to be typed in, typically multiple lines or -paragraphs. Unlike a <link linkend="visualdict-text-box">Text Box</link>, -pressing &Enter; will usually result in a line break. -</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-text-area.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-text-box"> -<entry>Text Box</entry> -<entry>A single-line text entry that allows a small amount of text to be typed -in. Typically, pressing &Enter; will perform the same action as clicking the -<guibutton>OK</guibutton> button.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-text-box.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-titlebar"> -<entry>Titlebar</entry> -<entry>This is located at the top of every window. It contains the name of the -application and usually information about what the application is doing, like -the title of the web page being viewed in a web browser or the filename of a -document open in a word processor.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-titlebar.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-toolbar"> -<entry>Toolbar</entry> -<entry>These are located near the top of many applications, typically directly -underneath the <link linkend="visualdict-menubar">menu bar</link>. They -provide access to many common functions of the running application, like -<emphasis>Save</emphasis> or <emphasis>Print</emphasis>.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-toolbar.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -<row id="visualdict-tree-view"> -<entry>Tree View</entry> -<entry>A Tree View allows you to select from a hierarchical list of options. A -section, or category, of the Tree View may be unexpanded, in which case no -options will appear beneath it and the arrow to the left of the title will be -pointing right, toward the title. It may also be expanded, in which case several -options will be listed below it, and the arrow to the left of the title will be -pointing down, toward the options. To expand a portion of the tree view, click -the arrow to the left of the title of the section you wish to expand, -double-click on the title, or select the title using your keyboard's arrow keys -and press the &Enter; or <keycap>+</keycap> key. To minimize a portion of the -tree view, you may also click the arrow, double-click on the title, or press the -&Enter; or <keycap>-</keycap> key.</entry> -<entry> -<inlinemediaobject> -<imageobject> -<imagedata fileref="visualdict-tree-view.png" format="PNG"/> -</imageobject> -</inlinemediaobject> -</entry> -</row> - -</tbody> -</tgroup> -</informaltable> - -</sect2> - -</sect1> - -<sect1 id="menus"> -<sect1info> -<authorgroup> -<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> -</sect1info> - -<title>Common Menus</title> - -<para>Many &kde; applications contain these menus. However, most -applications will have more menu entries than those listed here, and others may -be missing some of the entries listed here.</para> - -<screenshot id="screenshot-menus"> -<screeninfo>A Menu Bar</screeninfo> -<mediaobject> -<imageobject><imagedata fileref="menus.png" format="PNG"/></imageobject> -<textobject><phrase>A menubar</phrase></textobject> -<caption><para>The menubar in -<ulink url="http://kde.org/applications/graphics/gwenview/">&gwenview;</ulink>. -</para></caption> -</mediaobject> -</screenshot> - -<para>Some applications, like &dolphin;, do not show a menubar by default. You -can show it by pressing <keycombo>&Ctrl;<keycap>M</keycap></keycombo>. You can -also use this to hide the menubar in applications that support doing so.</para> - -<sect2 id="menus-file"> -<title>The File Menu</title> -<para>The <guimenu>File</guimenu> menu allows you to perform operations on the -currently open file and access common tasks in applications.</para> - -<para>Common menu items include:</para> - -<variablelist> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut> -<guimenu>File</guimenu><guimenuitem>New</guimenuitem> -</menuchoice></term> -<listitem><para> -Creates a new file. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>File</guimenu><guimenuitem>New Window</guimenuitem> -</menuchoice></term> -<listitem><para> -Opens a new window. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></shortcut> -<guimenu>File</guimenu><guimenuitem>Open...</guimenuitem> -</menuchoice></term> -<listitem><para> -Opens an already existing file. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></shortcut> -<guimenu>File</guimenu><guimenuitem>Save</guimenuitem> -</menuchoice></term> -<listitem><para> -Saves the file. If the file already exists it will be overwritten. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>File</guimenu><guimenuitem>Save As...</guimenuitem> -</menuchoice></term> -<listitem><para> - Saves the file with a new filename. - <!--FIXME some apps allow to save in a different format by changing the Filter (gwenview) or encoding (kate) --> -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>File</guimenu><guimenuitem>Save All</guimenuitem> -</menuchoice></term> -<listitem><para> -Saves all open files. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycap>F5</keycap></shortcut> -<guimenu>File</guimenu><guimenuitem>Reload</guimenuitem> -</menuchoice></term> -<listitem><para> -Reloads the current file. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>File</guimenu><guimenuitem>Reload All</guimenuitem> -</menuchoice></term> -<listitem><para> -Reloads all open files. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut> -<guimenu>File</guimenu><guimenuitem>Print...</guimenuitem> -</menuchoice></term> -<listitem><para> -Prints the file. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></shortcut> -<guimenu>File</guimenu><guimenuitem>Close</guimenuitem> -</menuchoice></term> -<listitem><para> -Closes the current file. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>File</guimenu><guimenuitem>Close All</guimenuitem> -</menuchoice></term> -<listitem><para> -Closes all open files. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut> -<guimenu>File</guimenu><guimenuitem>Quit</guimenuitem> -</menuchoice></term> -<listitem><para> -Exits the program. -</para></listitem> -</varlistentry> - -</variablelist> -</sect2> - -<sect2 id="menus-edit"> -<title>The Edit Menu</title> -<para>The <guimenu>Edit</guimenu> menu allows you to modify the currently -open file.</para> - -<variablelist> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem> -</menuchoice></term> -<listitem><para> -Undo the last action you performed in the file. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><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 action you performed in the file. -</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> -Removes the currently selected portion of the file, if any, and places a copy of -it in the clipboard buffer. -</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> -Places a copy of the currently selected portion of the file, if any, in the -clipboard buffer. -</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> -Copies the first item in the clipboard buffer to the current location in the -file, if any. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu><guimenuitem>Select All</guimenuitem> -</menuchoice></term> -<listitem><para> -Selects the entire contents of the currently open file. -</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> -Allows you to search for text in the currently open file. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu><guimenuitem>Replace...</guimenuitem> -</menuchoice></term> -<listitem><para> -Allows you to search for text in the currently open file and replace it with -something else. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycap>F3</keycap></shortcut> -<guimenu>Edit</guimenu><guimenuitem>Find Next</guimenuitem> -</menuchoice></term> -<listitem><para> -Go to the next match of the last Find operation. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><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 previous match of the last Find operation. -</para></listitem> -</varlistentry> - -</variablelist> -</sect2> - -<sect2 id="menus-view"> -<title>The View Menu</title> -<para>The <guimenu>View</guimenu> menu allows you to change the layout of the -currently open file and/or the running application.</para> - -<para>This menu has different options depending on the application you are -using.</para> -</sect2> - -<sect2 id="menus-tools"> -<title>The Tools Menu</title> -<para>The <guimenu>Tools</guimenu> menu allows you to perform certain actions -on the currently open file.</para> - -<variablelist> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>O</keycap></keycombo></shortcut> -<guimenu>Tools</guimenu><guimenuitem>Automatic Spell Checking</guimenuitem> -</menuchoice></term> -<listitem><para> -Check for spelling errors as you type. For more information, see -<xref linkend="spellcheck-auto"/>. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Tools</guimenu><guimenuitem>Spelling...</guimenuitem> -</menuchoice></term> -<listitem><para> -This initiates the spellchecking program - a program designed to help the user -catch and correct any spelling errors. For more information, see -<xref linkend="spellcheck-check"/>. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Tools</guimenu><guimenuitem>Spelling (from cursor)...</guimenuitem> -</menuchoice></term> -<listitem><para> -This initiates the spellchecking program, but only checks the portion of the -document from the current location of the cursor to the end. For more information, -see <xref linkend="spellcheck-check"/>. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Tools</guimenu><guimenuitem>Spellcheck Selection...</guimenuitem> -</menuchoice></term> -<listitem><para> -This initiates the spellchecking program, but only checks the currently selected -text in the document. For more information, see <xref linkend="spellcheck-check"/>. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Tools</guimenu><guimenuitem>Change Dictionary...</guimenuitem> -</menuchoice></term> -<listitem><para> -This allows you to change the dictionary used to check spellings. For more -information, see <xref linkend="spellcheck-config"/>. -</para></listitem> -</varlistentry> - -</variablelist> - -</sect2> - -<sect2 id="menus-settings"> -<title>The Settings Menu</title> -<para>The <guimenu>Settings</guimenu> allows you to customize the application.</para> - -<para>This menu typically contains the following items:</para> -<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><action>Hides and shows the menubar.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Settings</guimenu> -<guimenuitem>Show Statusbar</guimenuitem> -</menuchoice></term> -<listitem> -<para> -Toggles the display of the statusbar on and off. Some &kde; applications use statusbar at the bottom of their screen to display useful information. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Settings</guimenu><guisubmenu>Toolbars Shown</guisubmenu> -</menuchoice></term> -<listitem><para> -Allows you to show and hide the various toolbars supported by the application. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts...</guimenuitem> -</menuchoice></term> -<listitem><para> -Allows you to enable, disable, and modify keyboard shortcuts. For more -information, see <xref linkend="shortcuts"/>. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Settings</guimenu><guimenuitem>Configure Toolbars...</guimenuitem> -</menuchoice></term> -<listitem><para> -Allows you to customize the contents, layout, text, and icons of toolbars. For -more information, see <xref linkend="toolbars"/>. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure -Notifications...</guimenuitem></menuchoice></term> -<listitem><para>This item displays a standard &kde; notifications configuration -dialog, where you can change the notifications (sounds, visible messages, -&etc;) used by the application.</para> -<para>For more information how to configure notifications please read the documentation for -the &systemsettings; module <ulink url="help:/kcontrol/kcmnotify/index.html" ->Manage Notifications</ulink>. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Settings</guimenu><guimenuitem>Configure <replaceable>Application</replaceable>...</guimenuitem> -</menuchoice></term> -<listitem><para> -Opens the configuration panel for the currently running application. -</para></listitem> -</varlistentry> - -</variablelist> -</sect2> - -<sect2 id="menus-help"> -<title>The Help Menu</title> -<para>The <guimenu>Help</guimenu> menu gives you access to the application's -documentation and other useful resources.</para> - -<!--taken from kdelibs.git/kdoctools/customization/en/entities/help-menu.docbook - and edited slightly to fit into buildingblocks--> -<variablelist> -<varlistentry> -<term> -<menuchoice> -<shortcut> -<keycombo action="simul"><keycap>F1</keycap></keycombo> -</shortcut> -<guimenu>Help</guimenu> -<guimenuitem><replaceable>Application</replaceable> Handbook</guimenuitem> -</menuchoice> -</term> -<listitem><para><action>Invokes the KDE Help system</action> starting at the -running application's handbook.</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><action>Changes the mouse cursor to a combination arrow and -question mark.</action> Clicking on items within the application; will open a help -window (if one exists for the particular item) explaining the item's -function.</para></listitem> -</varlistentry> - - -<varlistentry> -<term><menuchoice> -<guimenu>Help</guimenu> -<guimenuitem>Report Bug...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the Bug report dialog</action> where you can -report a bug or request a <quote>wishlist</quote> feature.</para></listitem> -</varlistentry> -<!--FIXME two different dialogs, either via web (default if aboutData->bugAddress() == "" or == "submit at bugs.kde.org" ) -or via email (see krecipes doc rev 1306076) ---> -<varlistentry> -<term><menuchoice> -<guimenu>Help</guimenu> -<guimenuitem>Switch Application Language...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens a dialog</action> where you can -edit the <guilabel>Primary language</guilabel> and <guilabel>Fallback language</guilabel> -for this application.</para></listitem> -</varlistentry> -<!--FIXME: which languages are available here? how is that determined? ---> -<varlistentry> -<term><menuchoice> -<guimenu>Help</guimenu> -<guimenuitem>About <replaceable>Application</replaceable></guimenuitem> -</menuchoice></term> -<listitem><para><action>This will display version and author -information for the running application.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Help</guimenu> -<guimenuitem>About KDE</guimenuitem> -</menuchoice></term> -<listitem><para><action>This displays the &kde; Development Platform version -and other basic information.</action></para></listitem> -</varlistentry> -</variablelist> -<!--FIXME Tip of the Day missing--> -</sect2> - -<sect2 id="menus-ack"> -<title>Thanks and Acknowledgments</title> - -<para>Special thanks to an anonymous Google Code-In 2011 participant for writing -much of this documentation.</para> - -</sect2> - -</sect1> - -<sect1 id="kbd"> -<sect1info> -<authorgroup> -<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> -</sect1info> - -<title>Common Keyboard Shortcuts</title> - -<para>The &plasma-workspaces; provide keyboard shortcuts that allow you to -perform many tasks without touching your mouse. If you use your keyboard -frequently, using these can save you lots of time.</para> - -<para>This list contains the most common shortcuts supported by the workspace -itself and many applications available within. Every application also provides -its own shortcuts, so be sure to check their manuals for a comprehensive -listing.</para> - -<note><para> -The <keysym>Meta</keysym> key described below is a generic name for -the custom key found on many different keyboards. On keyboards -designed for &Microsoft; &Windows;, this key is usually called the -<keysym>Windows</keysym> key, and will have a picture of the &Windows; -logo. On keyboards designed for &Mac; computers, this key is known as -the <keysym>Command</keysym> key and will have a picture of the -<trademark class="registered">Apple</trademark> logo and/or the -<keycap>?</keycap> symbol. On keyboards designed for &UNIX; systems, this key -is really known as the <keysym>Meta</keysym> key and is typically labeled with a -diamond: <keycap>?</keycap>. -</para></note> - -<sect2 id="kbd-windows"> -<title>Working with Windows</title> - -<para>These shortcuts allow you to perform all kinds of operations with windows, -whether it be opening, closing, moving, or switching between them.</para> - -<sect3 id="kbd-windows-start-stop"> -<title>Starting and Stopping Applications</title> - -<para>These shortcuts make it easy to start and stop programs.</para> - -<informaltable> -<tgroup cols="2"> - -<thead> -<row> -<entry>Shortcut</entry> -<entry>Description</entry> -</row> -</thead> - -<tbody> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></entry> -<entry>Quit</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>Esc</keycap></keycombo></entry> -<entry>System Activity</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;&Alt;&Esc;</keycombo></entry> -<entry>Force Quit</entry> -</row> - -<row> -<entry><keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo></entry> -<entry><ulink url="help:/plasma-desktop/krunner.html">Run Command Interface</ulink></entry> -</row> - -<row> -<entry><keycombo action="simul">&Alt;<keycap>F4</keycap></keycombo></entry> -<entry>Close</entry> -</row> - -</tbody> -</tgroup> -</informaltable> -</sect3> - -<sect3 id="kbd-windows-moving"> -<title>Moving Around</title> - -<para>These shortcuts allow you to navigate between windows, activities, and -desktops efficiently.</para> - -<informaltable> -<tgroup cols="2"> - -<thead> -<row> -<entry>Shortcut</entry> -<entry>Description</entry> -</row> -</thead> - -<tbody> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>F10</keycap></keycombo></entry> -<entry>Present Windows</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>F9</keycap></keycombo></entry> -<entry>Present Windows on current desktop</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>F7</keycap></keycombo></entry> -<entry>Present Windows of current application only</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>F11</keycap></keycombo></entry> -<entry>Desktop Cube</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>F12</keycap></keycombo></entry> -<entry>Show Dashboard</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;&Alt;<keycap>A</keycap></keycombo></entry> -<entry>Activate Window Demanding Attention</entry> -</row> - -<row> -<entry><keycombo action="simul">&Alt;	</keycombo></entry> -<entry>Walk through windows</entry> -</row> - -<row> -<entry><keycombo action="simul">&Alt;<keycap>`</keycap></keycombo></entry> -<entry>Walk through windows of the current application</entry> -</row> - -<row> -<entry><keycombo action="simul">&Alt;<keycap>F3</keycap></keycombo></entry> -<entry>Open the Window Operations menu</entry> -</row> - -<row> -<entry><keycombo action="simul">&Meta;&Alt;<keysym>Up</keysym></keycombo></entry> -<entry>Switch to Window Above</entry> -</row> - -<row> -<entry><keycombo action="simul">&Meta;&Alt;<keysym>Down</keysym></keycombo></entry> -<entry>Switch to Window Below</entry> -</row> - -<row> -<entry><keycombo action="simul">&Meta;&Alt;<keysym>Left</keysym></keycombo></entry> -<entry>Switch to Window to the Left</entry> -</row> - -<row> -<entry><keycombo action="simul">&Meta;&Alt;<keysym>Right</keysym></keycombo></entry> -<entry>Switch to Window to the Right</entry> -</row> - -</tbody> -</tgroup> -</informaltable> -</sect3> - -<sect3 id="kbd-activity-pan-zoom"> -<title>Panning and Zooming</title> - -<para>Need to get a closer look? The &plasma-workspaces; allow you to zoom in -and out and move your entire desktop around, so you can zoom in even when the -application you are using doesn't support it.</para> - -<informaltable> -<tgroup cols="2"> - -<thead> -<row> -<entry>Shortcut</entry> -<entry>Description</entry> -</row> -</thead> - -<tbody> - -<!-- -<row> -<entry><keycombo action="simul">&Meta;<keycap></keycap></keycombo></entry> -<entry></entry> -</row> ---> - -<row> -<entry><keycombo action="simul">&Meta;<keycap>=</keycap></keycombo></entry> -<entry>Zoom In</entry> -</row> - -<row> -<entry><keycombo action="simul">&Meta;<keycap>-</keycap></keycombo></entry> -<entry>Zoom Out</entry> -</row> - -<row> -<entry><keycombo action="simul">&Meta;<keycap>0</keycap></keycombo></entry> -<entry>Zoom Normal</entry> -</row> - -<row> -<entry><keycombo action="simul">&Meta;<keysym>Up</keysym></keycombo></entry> -<entry>Pan Up</entry> -</row> - -<row> -<entry><keycombo action="simul">&Meta;<keysym>Down</keysym></keycombo></entry> -<entry>Pan Down</entry> -</row> - -<row> -<entry><keycombo action="simul">&Meta;<keysym>Left</keysym></keycombo></entry> -<entry>Pan left</entry> -</row> - -<row> -<entry><keycombo action="simul">&Meta;<keysym>Right</keysym></keycombo></entry> -<entry>Pan Right</entry> -</row> - -</tbody> -</tgroup> -</informaltable> -</sect3> -</sect2> - -<sect2 id="kbd-activities"> -<title>Working with Activities and Virtual Desktops</title> - -<para>These shortcuts allow you to switch between and manage -<ulink url="help:/plasma-desktop/zooming-user-interface.html">Activities</ulink> -and <ulink url="help:/kcontrol/desktop/">virtual desktops</ulink>.</para> - -<informaltable> -<tgroup cols="2"> - -<thead> -<row> -<entry>Shortcut</entry> -<entry>Description</entry> -</row> -</thead> - -<tbody> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></entry> -<entry>View all your Activities</entry> -</row> - -<row> -<entry><keycombo action="simul">&Meta;	</keycombo></entry> -<entry>Next Activity</entry> -</row> - -<row> -<entry><keycombo action="simul">&Meta;&Shift;	</keycombo></entry> -<entry>Previous Activity</entry> -</row> - -<row> -<entry><keycombo action="seq"> - <keycombo action="simul">&Alt;<keycap>D</keycap></keycombo> - <keycap>R</keycap> -</keycombo></entry> -<entry>Remove this Activity</entry> -</row> - -<row> -<entry><keycombo action="seq"> - <keycombo action="simul">&Alt;<keycap>D</keycap></keycombo> - <keycap>S</keycap> -</keycombo></entry> -<entry>Activities Settings</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>F1</keycap></keycombo></entry> -<entry>Switch to Desktop 1</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>F2</keycap></keycombo></entry> -<entry>Switch to Desktop 2</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>F3</keycap></keycombo></entry> -<entry>Switch to Desktop 3</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>F4</keycap></keycombo></entry> -<entry>Switch to Desktop 4</entry> -</row> - -</tbody> -</tgroup> -</informaltable> -</sect2> - -<sect2 id="kbd-desktop"> -<title>Working with the Desktop</title> - -<para>These shortcuts allow you to work with the &plasma-desktop; and panels. -</para> - -<informaltable> -<tgroup cols="2"> - -<thead> -<row> -<entry>Shortcut</entry> -<entry>Description</entry> -</row> -</thead> - -<tbody> - -<row> -<entry><keycombo action="seq"> - <keycombo action="simul">&Alt;<keycap>D</keycap></keycombo> - <keycap>A</keycap> -</keycombo></entry> -<entry>Add Widgets</entry> -</row> - -<row> -<entry><keycombo action="seq"> - <keycombo action="simul">&Alt;<keycap>D</keycap></keycombo> - <keycap>R</keycap> -</keycombo></entry> -<entry>Remove Widgets</entry> -</row> - -<row> -<entry><keycombo action="seq"> - <keycombo action="simul">&Alt;<keycap>D</keycap></keycombo> - <keycap>L</keycap> -</keycombo></entry> -<entry>Lock/Unlock Widgets</entry> -</row> - -<row> -<entry><keycombo action="seq"> - <keycombo action="simul">&Alt;<keycap>D</keycap></keycombo> - <keycap>N</keycap> -</keycombo></entry> -<entry>Next Widget</entry> -</row> - -<row> -<entry><keycombo action="seq"> - <keycombo action="simul">&Alt;<keycap>D</keycap></keycombo> - <keycap>P</keycap> -</keycombo></entry> -<entry>Previous Widget</entry> -</row> - -<row> -<entry><keycombo action="seq"> - <keycombo action="simul">&Alt;<keycap>D</keycap></keycombo> - <keycap>S</keycap> -</keycombo></entry> -<entry>Widget Settings</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>F12</keycap></keycombo></entry> -<entry>Show Dashboard</entry> -</row> - -<row> -<entry><keycombo action="seq"> - <keycombo action="simul">&Alt;<keycap>D</keycap></keycombo> - <keycap>T</keycap> -</keycombo></entry> -<entry>Run the Associated Application</entry> -</row> - -<row> -<entry><keycombo action="simul">&Alt;&Shift;<keycap>F12</keycap></keycombo></entry> -<entry>Enable/Disable Desktop Effects</entry> -</row> - -</tbody> -</tgroup> -</informaltable> -</sect2> - -<sect2 id="kbd-help"> -<title>Getting Help</title> - -<para>Need some help? The manual for the current application is only a keypress -away, and some programs even have additional help that explains the element in -focus.</para> - -<informaltable> -<tgroup cols="2"> - -<thead> -<row> -<entry>Shortcut</entry> -<entry>Description</entry> -</row> -</thead> - -<tbody> - -<row> -<entry><keycap>F1</keycap></entry> -<entry>Help</entry> -</row> - -<row> -<entry><keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo></entry> -<entry>What's This?</entry> -</row> - -</tbody> -</tgroup> -</informaltable> -</sect2> - -<sect2 id="kbd-docs"> -<title>Working with Documents</title> - -<para>Whether it's a text document, spreadsheet, or web site, these shortcuts -make performing many kinds of tasks with them easy.</para> - -<informaltable> -<tgroup cols="2"> - -<thead> -<row> -<entry>Shortcut</entry> -<entry>Description</entry> -</row> -</thead> - -<tbody> - -<row> -<entry><keycap>F5</keycap></entry> -<entry>Refresh</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></entry> -<entry>Select All</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></entry> -<entry>Undo</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></entry> -<entry>Redo</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></entry> -<entry>Cut</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></entry> -<entry>Copy</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></entry> -<entry>Paste</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></entry> -<entry>New</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></entry> -<entry>Print</entry> -</row> - - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></entry> -<entry>Save</entry> -</row> - - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></entry> -<entry>Find</entry> -</row> - - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></entry> -<entry>Close Document/Tab</entry> -</row> - -</tbody> -</tgroup> -</informaltable> -</sect2> - -<sect2 id="kbd-files"> -<title>Working with Files</title> - -<para>Whether your in an Open/Save dialog or the &dolphin; file manager, these -shortcuts save you time when performing operations on files. Note that some of -the concepts used with files are the same as with documents, so several of the -shortcuts are identical to their counterparts listed above.</para> - -<informaltable> -<tgroup cols="2"> - -<thead> -<row> -<entry>Shortcut</entry> -<entry>Description</entry> -</row> -</thead> - -<tbody> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></entry> -<entry>Undo</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></entry> -<entry>Cut</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></entry> -<entry>Copy</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></entry> -<entry>Paste</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></entry> -<entry>Select All</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></entry> -<entry>Replace Location</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo></entry> -<entry>Invert Selection</entry> -</row> - -<row> -<entry><keycombo action="simul">&Alt;<keycap>Left</keycap></keycombo></entry> -<entry>Back</entry> -</row> - -<row> -<entry><keycombo action="simul">&Alt;<keycap>Right</keycap></keycombo></entry> -<entry>Forward</entry> -</row> - -<row> -<entry><keycombo action="simul">&Alt;<keycap>Up</keycap></keycombo></entry> -<entry>Up (to folder that contains this one)</entry> -</row> - -<row> -<entry><keycombo action="simul">&Alt;<keycap>Home</keycap></keycombo></entry> -<entry>Home Folder</entry> -</row> - -<row> -<entry><keycap>Delete</keycap></entry> -<entry>Move to Trash</entry> -</row> - -<row> -<entry><keycombo action="simul">&Shift;<keycap>Delete</keycap></keycombo></entry> -<entry>Delete Permanently</entry> -</row> - -</tbody> -</tgroup> -</informaltable> -</sect2> - -<sect2 id="kbd-vol-bright"> -<title>Changing Volume and Brightness</title> - -<para>In addition to the standard keys, many computer keyboards and laptops -nowadays have special keys or buttons to change the speaker volume, as well as -the brightness of your monitor if applicable. If present, you can use these -keys in the &plasma-workspaces; to perform those tasks.</para> - -<para>If you do not have such keys, see <xref linkend="kbd-modifying"/> for -information on how to assign keys for these tasks.</para> - -</sect2> - -<sect2 id="kbd-leaving"> -<title>Leaving Your Computer</title> - -<para>All done? Use these shortcuts and put your computer away!</para> - -<informaltable> -<tgroup cols="2"> - -<thead> -<row> -<entry>Shortcut</entry> -<entry>Description</entry> -</row> -</thead> - -<tbody> - -<row> -<entry><keycombo action="simul">&Ctrl;&Alt;<keycap>Insert</keycap></keycombo></entry> -<entry>Switch User</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;&Alt;<keycap>L</keycap></keycombo></entry> -<entry>Lock Session</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;&Alt;<keycap>Delete</keycap></keycombo></entry> -<entry>Logout</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;&Alt;&Shift;<keycap>Delete</keycap></keycombo></entry> -<entry>Logout without confirmation</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;&Alt;&Shift;<keycap>Page Down</keycap></keycombo></entry> -<entry>Shut Down without confirmation</entry> -</row> - -<row> -<entry><keycombo action="simul">&Ctrl;&Alt;&Shift;<keycap>Page Up</keycap></keycombo></entry> -<entry>Reboot without confirmation</entry> -</row> - -</tbody> -</tgroup> -</informaltable> -</sect2> - -<sect2 id="kbd-modifying"> -<title>Modifying Shortcuts</title> - -<para>The shortcuts described in <link linkend="kbd-windows">Working With -Windows</link>, <link linkend="kbd-leaving">Leaving Your Computer</link>, and -<link linkend="kbd-vol-bright">Changing Volume and Brightness</link> are called -<emphasis>global shortcuts</emphasis>, since they work regardless of which -window you have open on your screen. These can be modified in the -<ulink url="help:/kcontrol/keys/">Global Shortcuts panel of -&systemsettings;</ulink>, where they are separated by &kde; component.</para> - -<para>The shortcuts described in <link linkend="kbd-activities">Working with -Activities and Virtual Desktops</link> and <link linkend="kbd-desktop">Working -with the Desktop</link> can be modified by clicking on the -<ulink url="help:/plasma-desktop/using-kapp.html">Desktop Toolbox</ulink> and -selecting <guimenuitem>Shortcut Settings</guimenuitem>.</para> - -<para>The shortcuts described in <link linkend="kbd-docs">Working with -Documents</link> and <link linkend="kbd-help">Getting Help</link> are set by -individual programs. Most &kde; programs allow you to use the -<link linkend="shortcuts">common shortcut editing dialog</link> to modify these. -The shortcuts described in <link linkend="kbd-files">Working With Files</link> -can be edited in the same manner when used inside a file manager like &dolphin; -or &konqueror;, but cannot be modified in the case of Open/Save dialogs, &etc; -</para> - -</sect2> -</sect1> - -</chapter> diff --git a/doc/fundamentals/visualdict-breadcrumb.png b/doc/fundamentals/visualdict-breadcrumb.png deleted file mode 100644 index e2a8db5..0000000 Binary files a/doc/fundamentals/visualdict-breadcrumb.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-button.png b/doc/fundamentals/visualdict-button.png deleted file mode 100644 index 845c494..0000000 Binary files a/doc/fundamentals/visualdict-button.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-central-widget.png b/doc/fundamentals/visualdict-central-widget.png deleted file mode 100644 index b8305a7..0000000 Binary files a/doc/fundamentals/visualdict-central-widget.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-check-box.png b/doc/fundamentals/visualdict-check-box.png deleted file mode 100644 index 3204646..0000000 Binary files a/doc/fundamentals/visualdict-check-box.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-color-selector.png b/doc/fundamentals/visualdict-color-selector.png deleted file mode 100644 index 7d19b36..0000000 Binary files a/doc/fundamentals/visualdict-color-selector.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-combo-box.png b/doc/fundamentals/visualdict-combo-box.png deleted file mode 100644 index 2b4c3d7..0000000 Binary files a/doc/fundamentals/visualdict-combo-box.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-context-menu.png b/doc/fundamentals/visualdict-context-menu.png deleted file mode 100644 index 0bbac64..0000000 Binary files a/doc/fundamentals/visualdict-context-menu.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-dialog-box.png b/doc/fundamentals/visualdict-dialog-box.png deleted file mode 100644 index 87ef8be..0000000 Binary files a/doc/fundamentals/visualdict-dialog-box.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-drop-down-box.png b/doc/fundamentals/visualdict-drop-down-box.png deleted file mode 100644 index 42bb431..0000000 Binary files a/doc/fundamentals/visualdict-drop-down-box.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-gui1.png b/doc/fundamentals/visualdict-gui1.png deleted file mode 100644 index 17b2a7a..0000000 Binary files a/doc/fundamentals/visualdict-gui1.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-gui2.png b/doc/fundamentals/visualdict-gui2.png deleted file mode 100644 index 5c2df0a..0000000 Binary files a/doc/fundamentals/visualdict-gui2.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-gui3.png b/doc/fundamentals/visualdict-gui3.png deleted file mode 100644 index c8aafce..0000000 Binary files a/doc/fundamentals/visualdict-gui3.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-gui4.png b/doc/fundamentals/visualdict-gui4.png deleted file mode 100644 index 9e763a4..0000000 Binary files a/doc/fundamentals/visualdict-gui4.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-icon-list.png b/doc/fundamentals/visualdict-icon-list.png deleted file mode 100644 index 89f40ca..0000000 Binary files a/doc/fundamentals/visualdict-icon-list.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-icon.png b/doc/fundamentals/visualdict-icon.png deleted file mode 100644 index be294b7..0000000 Binary files a/doc/fundamentals/visualdict-icon.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-list-box.png b/doc/fundamentals/visualdict-list-box.png deleted file mode 100644 index 4a7e9cb..0000000 Binary files a/doc/fundamentals/visualdict-list-box.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-menu-button.png b/doc/fundamentals/visualdict-menu-button.png deleted file mode 100644 index 51d3f3e..0000000 Binary files a/doc/fundamentals/visualdict-menu-button.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-menu.png b/doc/fundamentals/visualdict-menu.png deleted file mode 100644 index 7e23594..0000000 Binary files a/doc/fundamentals/visualdict-menu.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-menubar.png b/doc/fundamentals/visualdict-menubar.png deleted file mode 100644 index 768dfd6..0000000 Binary files a/doc/fundamentals/visualdict-menubar.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-panel.png b/doc/fundamentals/visualdict-panel.png deleted file mode 100644 index a7093bc..0000000 Binary files a/doc/fundamentals/visualdict-panel.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-progress-bar.png b/doc/fundamentals/visualdict-progress-bar.png deleted file mode 100644 index 627ce6f..0000000 Binary files a/doc/fundamentals/visualdict-progress-bar.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-radio-button.png b/doc/fundamentals/visualdict-radio-button.png deleted file mode 100644 index e350ff4..0000000 Binary files a/doc/fundamentals/visualdict-radio-button.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-scrollbar.png b/doc/fundamentals/visualdict-scrollbar.png deleted file mode 100644 index f576298..0000000 Binary files a/doc/fundamentals/visualdict-scrollbar.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-slider.png b/doc/fundamentals/visualdict-slider.png deleted file mode 100644 index 27a6115..0000000 Binary files a/doc/fundamentals/visualdict-slider.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-spin-box.png b/doc/fundamentals/visualdict-spin-box.png deleted file mode 100644 index ed1fe81..0000000 Binary files a/doc/fundamentals/visualdict-spin-box.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-statusbar.png b/doc/fundamentals/visualdict-statusbar.png deleted file mode 100644 index 247dceb..0000000 Binary files a/doc/fundamentals/visualdict-statusbar.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-tab.png b/doc/fundamentals/visualdict-tab.png deleted file mode 100644 index cf26902..0000000 Binary files a/doc/fundamentals/visualdict-tab.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-text-area.png b/doc/fundamentals/visualdict-text-area.png deleted file mode 100644 index 29b66a9..0000000 Binary files a/doc/fundamentals/visualdict-text-area.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-text-box.png b/doc/fundamentals/visualdict-text-box.png deleted file mode 100644 index 3b2ce3c..0000000 Binary files a/doc/fundamentals/visualdict-text-box.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-titlebar.png b/doc/fundamentals/visualdict-titlebar.png deleted file mode 100644 index 46a1dc1..0000000 Binary files a/doc/fundamentals/visualdict-titlebar.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-toolbar.png b/doc/fundamentals/visualdict-toolbar.png deleted file mode 100644 index 319332c..0000000 Binary files a/doc/fundamentals/visualdict-toolbar.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-tree-view.png b/doc/fundamentals/visualdict-tree-view.png deleted file mode 100644 index 4c8722e..0000000 Binary files a/doc/fundamentals/visualdict-tree-view.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-window.png b/doc/fundamentals/visualdict-window.png deleted file mode 100644 index e618521..0000000 Binary files a/doc/fundamentals/visualdict-window.png and /dev/null differ diff --git a/doc/fundamentals/visualdict-window2.png b/doc/fundamentals/visualdict-window2.png deleted file mode 100644 index 1afa237..0000000 Binary files a/doc/fundamentals/visualdict-window2.png and /dev/null differ diff --git a/doc/glossary/CMakeLists.txt b/doc/glossary/CMakeLists.txt deleted file mode 100644 index f7dd1be..0000000 --- a/doc/glossary/CMakeLists.txt +++ /dev/null @@ -1,2 +0,0 @@ -########### install files ############### -kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR khelpcenter/glossary) diff --git a/doc/glossary/checkxrefs b/doc/glossary/checkxrefs deleted file mode 100755 index 0805ec6..0000000 --- a/doc/glossary/checkxrefs +++ /dev/null @@ -1,10 +0,0 @@ -#!/bin/sh -DEFINED_ENTRIES=`sed -ne "s^.*<glossentry id=\"\(.*\)\">.*^\1^p" *.docbook` -REFERENCED_ENTRIES=`sed -ne "s^.*<glossseealso otherterm=\"\(.*\)\">.*^\1^p" *.docbook | uniq` - -# Check for entries which are referenced but not defined. -for ENTRY in $REFERENCED_ENTRIES; do - if ! echo $DEFINED_ENTRIES | grep $ENTRY - > /dev/null 2>&1; then - echo "'$ENTRY' referenced but not defined!" - fi -done diff --git a/doc/glossary/index.docbook b/doc/glossary/index.docbook deleted file mode 100644 index 3732d95..0000000 --- a/doc/glossary/index.docbook +++ /dev/null @@ -1,611 +0,0 @@ -<?xml version="1.0" ?> -<!DOCTYPE glossary PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [ -<!ENTITY % addindex "IGNORE"> -<!ENTITY % English "INCLUDE"> -<!ENTITY glossary-kdeprinting SYSTEM "kdeprintingglossary.docbook"> -<!ENTITY newpara "</p><p>"> -<!ENTITY linkstart "<a href="> -<!ENTITY linkmid ' target="_top">'> -<!ENTITY linkend "</a>"> - -<!ENTITY emstart '<span class="emphasis"><em>' > -<!ENTITY emend '</em></span>'> -<!-- acronym, systemitem unchanged -itemizedlist+listitem changed to simple para --> -]> - - -<glossary lang="&language;" id="glossary"> - - <glossdiv id="glossdiv-technologies"> - <title>Technologies</title> - <glossentry id="gloss-akonadi"> - <glossterm>Akonadi</glossterm> - <glossdef><para>The data storage access mechanism for all PIM (Personal Information Manager) data in &kde; SC 4. One single - storage and retrieval system allows efficiency and extensibility not possible under &kde; 3, where each PIM component had - its own system. Note that use of Akonadi does not change data storage formats (vcard, iCalendar, mbox, maildir etc.) - it - just provides a new way of accessing and updating the data.&newpara; - The main reasons for design and development of Akonadi are of technical nature, ⪚ having a unique way to access PIM-data (contacts, calendars, emails..) from different applications (⪚ &kmail;, &kword; &etc;), thus eliminating the need to write similar code here and there.&newpara; - Another goal is to de-couple GUI applications like &kmail; from the direct access to external resources like mail-servers - which was a major reason for bug-reports/wishes with regard to performance/responsiveness in the past.&newpara; - More info:&newpara; - &linkstart;"http://pim.kde.org/akonadi/"&linkmid;Akonadi for KDE's PIM&linkend;&newpara; - &linkstart;"http://en.wikipedia.org/wiki/Akonadi"&linkmid;Wikipedia: Akonadi&linkend;&newpara; - &linkstart;"http://techbase.kde.org/Projects/PIM/Akonadi"&linkmid;Techbase - Akonadi&linkend;</para> - <glossseealso otherterm="gloss-gui">&GUI;</glossseealso> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-arts"> - <glossterm>ARts</glossterm> - <glossdef><para>The sound framework in &kde; 2 and 3. Its single-tasking nature caused problems when two sources of sound were encountered. In the &plasma; desktop it is replaced by Phonon.&newpara; - More info:&newpara; - &linkstart;"http://en.wikipedia.org/wiki/ARts"&linkmid; Wikipedia: ARts&linkend;&newpara; - &linkstart;"http://www.arts-project.org"&linkmid;ARts home page&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-phonon">Phonon</glossseealso> - <glossseealso otherterm="gloss-plasma">&plasma;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-dbus"> - <glossterm>D-Bus</glossterm> - <glossdef><para>D-Bus or Desktop Bus is an inter-service messaging system. Developed by &RedHat;, it was heavily influenced by &kde; 3 DCOP, which it supersedes. Most POSIX operating systems support D-Bus, and a port for Windows exists. It is used by Qt 4 and GNOME.&newpara; - More info:&newpara; - &linkstart;"http://freedesktop.org/wiki/Software/dbus/"&linkmid;FreeDesktop.org: What is D-Bus?&linkend;&newpara; - &linkstart;"http://en.wikipedia.org/wiki/D-Bus"&linkmid;Wikipedia: D-Bus&linkend;</para> - <glossseealso otherterm="gloss-dcop">&DCOP;</glossseealso> - <glossseealso otherterm="gloss-gnome">GNOME</glossseealso> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-qt">&Qt;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-dcop"> - <glossterm>DCOP</glossterm> - <glossdef><para><acronym>DCOP</acronym>, which stands for Desktop COmmunication Protocol, is a light-weight interprocess and software componentry communication system used in &kde; 3. Replaced with &DBus; in &kde; SC 4.&newpara; - More info:&newpara; - &linkstart;"http://en.wikipedia.org/wiki/DCOP"&linkmid;Wikipedia: DCOP&linkend;</para> - <glossseealso otherterm="gloss-dbus">D-Bus</glossseealso> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-flake"> - <glossterm>Flake</glossterm> - <glossdef><para>Flake is a programming library to be used in &koffice;/Calligra. Functionally, it provides Shapes to display content and Tools to manipulate content. Shapes can be zoomed or rotated and can be grouped to work as a single Shape, around which text flow is possible.&newpara; - More info:&newpara; - &linkstart;"http://community.kde.org/Calligra/Libs/Flake"&linkmid;&kde; Community Wiki: Flake&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-kparts">KParts</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-ghns"> - <glossterm>Get Hot New Stuff</glossterm> - <glossdef><para>&emstart;G&emend;et &emstart;H&emend;ot &emstart;N&emend;ew &emstart;S&emend;tuff (GHNS) is an open standard that makes it easy for users to download and install various extensions for their applications. Our implementation of GHNS is used by &plasma; (for example to get new desktop themes), and by many applications and widgets.&newpara; - More info:&newpara; - &linkstart;"http://ghns.freedesktop.org"&linkmid;Home of GHNS&linkend;&newpara; - &linkstart;"http://lwn.net/Articles/227855/"&linkmid;An article on GHNS in &kde; SC 4&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-plasma">&plasma;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-ghnsaccr"> - <glossterm>GHNS</glossterm> - <glossdef><para><acronym>GHNS</acronym> is the acronym of Get Hot New Stuff.</para> - <glossseealso otherterm="gloss-ghns">Get Hot New Stuff</glossseealso> - </glossdef> - </glossentry> - <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 - "network transparent"). 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-khtml"> - <glossterm>KHTML</glossterm> - <glossdef><para>KHTML is the &HTML; rendering engine for the &kde; &plasma; desktop, as used by the &konqueror; browser. It also provides a KPart that enables all &kde; applications to display web content. A new introduction, &Qt; WebKit is also for Plasma and other application development.</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-konqueror">&konqueror;</glossseealso> - <glossseealso otherterm="gloss-kparts">KParts</glossseealso> - <glossseealso otherterm="gloss-plasma">&plasma;</glossseealso> - <glossseealso otherterm="gloss-webkit">WebKit</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-kio"> - <glossterm><acronym>KIO</acronym></glossterm> - <glossdef><para>The &kde; Input/Output system which makes use of so-called - "<acronym>IO</acronym> Slaves".</para> - <glossseealso otherterm="gloss-ioslave"><acronym>IO</acronym> -Slave</glossseealso> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-kiosk"> - <glossterm>Kiosk</glossterm> - <glossdef><para>Kiosk is a framework for restricting user capabilities on a &kde; platform system, ideal for use in locked-down environments such as Internet caf?s. It is present in &kde; 3 and &kde; 4, but the administration tool, <application>Kiosktool</application> is &kde; 3 only. It can be used to configure &kde; 4 applications, or kiosk configurations can be maintained by editing config files manually.</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-kparts"> - <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-ksycoca"> - <glossterm><acronym>KSycoca</acronym></glossterm> - <glossdef><para><acronym>KSycoca</acronym> (&kde; &emstart;Sy&emend;stem - &emstart;Co&emend;nfiguration &emstart;Ca&emend;che) is a - configuration cache which, for example, guarantees fast access to the menu - entries.</para> - <glossseealso -otherterm="gloss-kbuildsycoca"><application>KBuildSycoca</application></glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-phonon"> - <glossterm>Phonon</glossterm> - <glossdef><para>A cross-platform multimedia API, interfacing with existing frameworks, such as gstreamer and xine engines. &kde; 2 and 3 depended on aRts for sound. Phonon replaces it.&newpara; - More info:&newpara; - &linkstart;"http://en.wikipedia.org/wiki/Phonon_(KDE)"&linkmid; Wikipedia: Phonon (KDE)&linkend;&newpara; - &linkstart;"http://phonon.kde.org"&linkmid;Phonon website&linkend;</para> - <glossseealso otherterm="gloss-arts">&arts;</glossseealso> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-solid"> - <glossterm>Solid</glossterm> - <glossdef><para>Solid provides a single API for hardware management. Hardware is grouped into 'domains'. Since the backends for Solid are pluggable, Solid helps application developers write less code, and have it platform independent.&newpara; - More info:&newpara; - &linkstart;"http://solid.kde.org"&linkmid;Discover Solid&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-threadweaver"> - <glossterm>Threadweaver</glossterm> - <glossdef><para>This thread programming library spreads work among multiple-core processors where available, prioritizing them before queuing them for execution. ThreadWeaver provides a high-level job interface for multithreaded programming.&newpara; - More info:&newpara; - &linkstart;"http://www.englishbreakfastnetwork.org/apidocs/apidox-kde-4.0/kdelibs-apidocs/threadweaver/html/Why.html"&linkmid;Why Multithreading?&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-webkit"> - <glossterm>WebKit</glossterm> - <glossdef><para>HTML rendering engine, originating from a fork of KHTML. Adopted by <trademark>Apple</trademark> and developed for <trademark>Safari</trademark>. Webkit brings the whole functionality back to &kde; SC 4, where it is available through &Qt;.&newpara; - More info:&newpara; - &linkstart;"http://webkit.org/"&linkmid;WebKit home page&linkend;&newpara; - &linkstart;"http://en.wikipedia.org/wiki/Webkit"&linkmid;Wikipedia: WebKit&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-kde">KHTML</glossseealso> - </glossdef> - </glossentry> - </glossdiv> - - <glossdiv id="glossdiv-xorg"> - <title>X.Org</title> - <glossentry id="gloss-antialiasing"> - <glossterm>Antialiasing</glossterm> - <glossdef><para>If mentioned in context with &kde;, anti-aliasing often means - the smoothing of the fonts visible on the screen. &Qt; version 3.3 - or higher used together with X.Org server 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> - </glossentry> - </glossdiv> - - <glossdiv id="glossdiv-applications"> - <title>Applications</title> - <glossentry id="gloss-dolphin"> - <glossterm>Dolphin</glossterm> - <glossdef><para>The default file manager in &kde; SC 4. It has a side panel (Places), but navigation is mainly by the 'breadcrumb' trail above the main window. Split windows are possible, and views can be applied to individual windows. Mounting and unmounting <acronym>USB</acronym> devices can be done in the side panel. Other directories can be added to the Places panel. A Tree view is also possible.&newpara; - More info:&newpara; - &linkstart;"http://en.wikipedia.org/wiki/Dolphin_(software)"&linkmid;Wikipedia: Dolphin&linkend;&newpara; - &linkstart;"http://introducingkde4.blogspot.com/2007/12/dolphin.html"&linkmid;Introducing KDE 4 Blog - Dolphin&linkend;&newpara; - &linkstart;"http://userbase.kde.org/Tutorials/File_Management"&linkmid;Userbase: File Management Tutorial&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-konqueror">&konqueror;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-kbuildsycoca"> - <glossterm><application>KBuildSycoca</application></glossterm> - <glossdef><para><application>KBuildSycoca4</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 - &systemsettings; are missing.</para> - <glossseealso otherterm="gloss-ksycoca"><acronym>KSycoca</acronym></glossseealso> - <glossseealso otherterm="gloss-systemsettings">&systemsettings;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-kinfocenter"> - <glossterm>KInfoCenter</glossterm> - <glossdef><para>Kinfocenter originated as part of Kcontrol standing alone from KDE 3.1. In KDE SC 4 it is replaced by modules configured in System Settings, notably Solid, and is being reintroduced as an application in &kde; SC 4.5.&newpara; - More info:&newpara; - &linkstart;"http://en.wikipedia.org/wiki/Kinfocenter"&linkmid;Wikipedia: KInfoCenter&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-solid">Solid</glossseealso> - <glossseealso otherterm="gloss-systemsettings">&systemsettings;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-konqueror"> - <glossterm>&konqueror;</glossterm> - <glossdef><para>&konqueror; is a web browser, picture viewer, file manager - and more, and a core part of the &kde; project. You can - find more information about &konqueror; at &linkstart;"http://www.konqueror.org"&linkmid;www.konqueror.org&linkend;.</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-krunner"> - <glossterm>KRunner</glossterm> - <glossdef><para>The mini-command-line that is accessed from the Classic menu, the keyboard shortcut &Alt;+<keycap>F2</keycap>, or a right-click on the desktop. In &kde; SC 4 a partial name will display all possible matches.&newpara; - More info:&newpara; - &linkstart;"http://userbase.kde.org/Tutorials/Krunner"&linkmid;UserBase: KRunner Usage&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-plasma">&plasma;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-kwin"> - <glossterm>KWin</glossterm> - <glossdef><para>KWin is the window manager. This is where window decorations can be changed and themes applied. &kde; SC 4 extends KWin to provide support for 3D Compositing effects on the desktop.&newpara; - More info:&newpara; - &linkstart;"http://userbase.kde.org/KWin"&linkmid;UserBase: KWin&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-xserver">&X-Server;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-minicli"> - <glossterm>Mini-CLI</glossterm> - <glossdef><para>Mini &emstart;C&emend;ommand &emstart;L&emend;ine &emstart;I&emend;nterface. Synonym to KRunner.</para> - <glossseealso otherterm="gloss-krunner">KRunner</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-pager"> - <glossterm>Pager</glossterm> - <glossdef><para>A pager is a small program or panel applet which shows the position of windows on your desktop and usually if you have several Virtual Desktops gives an overview over all.</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-kickoff">Kickoff</glossseealso> - <glossseealso otherterm="gloss-kicker">Kicker</glossseealso> - <glossseealso otherterm="gloss-panel">Panel</glossseealso> - <glossseealso otherterm="gloss-plasma">&plasma;</glossseealso> - <glossseealso otherterm="gloss-virtualdesktops">Virtual Desktops</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-systemsettings"> - <glossterm>&systemsettings;</glossterm> - <glossdef><para>This is the project and filename of the &kde; control - center. &systemsettings; allows you to customize virtually - every configuration option of &kde;.</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-kinfocenter">KInfoCenter</glossseealso> - </glossdef> - </glossentry> - </glossdiv> - - <glossdiv id="glossdiv-desktop-terminology"> - <title>Desktop Terminology</title> - <glossentry id="gloss-activities"> - <glossterm>Activities</glossterm> - <glossdef><para>Activities are sets of &plasma; widgets that have their own wallpaper&newpara; - A bit like Virtual Desktops, but not quite. For example you have a "work activity" with commit rss feeds, a note with your TODO, a Folder View with your work related files, and a subtle wallpaper.&newpara; - Next to it, you have your freetime activity, with previews of family photos and dogs, rss feeds from your favorite blogs, a Folder View showing your movie collection, a twitter applet and of course that Iron Maiden wallpaper you have been loving since the early 80s.&newpara; - At 17:00 hours sharp you switch from the work activity to your freetime activity.&newpara; - More info:&newpara; - &linkstart;"http://userbase.kde.org/Plasma"&linkmid;Plasma FAQ&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-virtualdesktops">Virtual Desktops</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-containment"> - <glossterm>Containment</glossterm> - <glossdef><para>A Containment is a top level grouping of widgets. Each Containment manages the layout and configuration data of its set of widgets independently from other Containments.&newpara; - The end result is that you can group widgets within a Containment according to the significance to your working pattern, rather than by directory grouping.&newpara; - More info:&newpara; - &linkstart;"http://userbase.kde.org/Plasma"&linkmid;Plasma FAQ&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-widget">Widget</glossseealso> - </glossdef> - </glossentry> - <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 ("dropping" the object) copies files.</para> - <glossseealso otherterm="gloss-konqueror">&konqueror;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-extender"> - <glossterm>Extender</glossterm> - <glossdef><para>Extenders are a special kind of popup that can grow out of a &plasma; panel for example. Extenders have detachable parts. Extenders are a new concept that arrived in &plasma; for &kde; 4.2. The Kuiserver (the interface that collects all long running jobs and puts them into one window) will make use of extenders so you can detach various jobs and monitor their progress separately.&newpara; - More info:&newpara; - &linkstart;"http://userbase.kde.org/Plasma"&linkmid;Plasma FAQ&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-plasma">&plasma;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-gnome"> - <glossterm><acronym>GNOME</acronym></glossterm> - <glossdef> - <para>&emstart;G&emend;NU &emstart;N&emend;etwork &emstart;O&emend;bject - &emstart;M&emend;odel &emstart;E&emend;nvironment, one of the - leading &UNIX; &GUI;s.</para> - <glossseealso otherterm="gloss-gui">&GUI;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-gui"> - <glossterm>&GUI;</glossterm> - <glossdef><para>Abbreviation for &emstart;G&emend;raphical - &emstart;U&emend;ser &emstart;I&emend;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-homedirectory"> - <glossterm>Home Directory</glossterm> - <glossdef><para>That's the place in system, where all your files are kept. You can write your files outside of this folder, but all applications are configured to propose this folder as place to write your files to. And this is easier, when you are keeping your things here.&newpara; - More info:&newpara; - &linkstart;"http://en.wikipedia.org/wiki/Home_directory"&linkmid;Wikipedia: Home Directory&linkend;</para> - <glossseealso otherterm="gloss-dolphin">&dolphin;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-kde"> - <glossterm>&kde;</glossterm> - <glossdef><para>Abbreviation for "K Desktop Environment", a - leading &GUI; for &UNIX;-based systems. You can find more - detailed information at &linkstart; - "http://www.kde.org"&linkmid;www.kde.org&linkend;.&newpara; - &kde; is more than just software. It is a community made up of programmers, translators, contributors, artists, writers, distributors, and users from all over the world. Our international technology team is committed to creating the best free software for the desktop. And not only contributors, but users and fans of &kde; software can be found throughout the entire globe, giving help to other users, spreading the news, or just simply enjoying the experience.</para> - <glossseealso otherterm="gloss-gui">&GUI;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-kicker"> - <glossterm><acronym>&kicker;</acronym></glossterm> - <glossdef> - <para>In &kde; 3, the relocatable bar, usually at the bottom of the screen (sometimes called the Panel), on which application launchers, the Pager, and buttons for running applications reside.</para> - <glossseealso otherterm="gloss-panel">Panel</glossseealso> - <glossseealso otherterm="gloss-plasma">&plasma;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-kickoff"> - <glossterm><acronym>&kickoff;</acronym></glossterm> - <glossdef> - <para>In &kde; SC 4 (and some late versions of &kde; 3), a launch menu in which apps are sorted by functional group. 'Favorites' replaces the 'Most used applications' in Classic Menu, and applications can be added to it. Right-click also offers the possibility of adding applications to the desktop or panel. Rapid access to a less-used application can be by the search box. Other menus are being worked on, since &kde; SC 4 can be used with more than one launcher, should that be required.&newpara; - More info:&newpara; - &linkstart;"http://home.kde.org/~binner/kickoff/sneak_preview.html"&linkmid;Kickoff Sneak Preview&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-pager">Pager</glossseealso> - <glossseealso otherterm="gloss-panel">Panel</glossseealso> - <glossseealso otherterm="gloss-plasma">&plasma;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-oxygen"> - <glossterm><acronym>Oxygen</acronym></glossterm> - <glossdef> - <para>Oxygen is the default theme of &kde; SC 4. Designed to bring 'a breath of fresh air' to the desktop by removing the simplistic, cartoonish icons, and replacing them with a clean theme and photo-realistic icons. Oxygen uses a desaturated palette to avoid the icons becoming a distraction and uses detailed scalable graphics (SVG).&newpara; - More info:&newpara; - &linkstart;"http://en.wikipedia.org/wiki/Oxygen_Project"&linkmid;Wikipedia: Oxygen Project&linkend;&newpara; - &linkstart;"http://www.oxygen-icons.org/?cat=3"&linkmid;Oxygen Icons&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-ksvg">KSVG</glossseealso> - <glossseealso otherterm="gloss-plasma">&plasma;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-panel"> - <glossterm>Panel</glossterm> - <glossdef><para>Refers to the panel which often resides at the bottom of the - screen.</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-kicker">&kicker;</glossseealso> - <glossseealso otherterm="gloss-kickoff">&kickoff;</glossseealso> - <glossseealso otherterm="gloss-plasma">&plasma;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-plasma"> - <glossterm>Plasma</glossterm> - <glossdef><para>In &kde; SC 4 the &plasma; Desktop replaces KDesktop, &kicker; and the SuperKaramba widget engine. The applets are called Plasmoids, and range from informational widgets to mini-apps such as a calculator or dictionary. Widgets from other sources, such as SuperKaramba widgets or <trademark>Google</trademark> Gadgets are also supported.&newpara; - More info:&newpara; - &linkstart;"http://en.wikipedia.org/wiki/Plasma_(KDE)"&linkmid;Wikipedia: Plasma&linkend;&newpara; - &linkstart;"http://plasma.kde.org/cms/1107/"&linkmid;Plasma website&linkend;&newpara; - &linkstart;"http://userbase.kde.org/Plasma"&linkmid;Plasma FAQ&linkend;&newpara; - &linkstart;"http://userbase.kde.org/Tutorials/TweakingPlasma"&linkmid;Tweaking Plasma&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-kicker">&kicker;</glossseealso> - <glossseealso otherterm="gloss-widget">Widget</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> - </glossdef> - </glossentry> - <glossentry id="gloss-virtualdesktops"> - <glossterm>Virtual Desktops</glossterm> - <glossdef><para>A popular concept of &UNIX; based window managers is the one of virtual desktops. This means you have not only one screen where you can place your windows on but several. When you switch to a different desktop (usually with a pager) you will only see the windows which you started on your new desktop or moved to it. A window can also be made "sticky" which means it appears on all virtual desktops.&newpara; - More info:&newpara; - &linkstart;"http://userbase.kde.org/Plasma"&linkmid;Plasma FAQ&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-kickoff">&kickoff;</glossseealso> - <glossseealso otherterm="gloss-pager">Pager</glossseealso> - </glossdef> - </glossentry> - </glossdiv> - - <glossdiv id="kde-development"> - <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 - "Widgets") which are used to construct the desktop. You - can find more information about &Qt; at &linkstart; - "http://qt-project.org/"&linkmid;http://qt-project.org/&linkend;.</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-gui">&GUI;</glossseealso> - <glossseealso otherterm="gloss-widget">Widget</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-git"> - <glossterm>Git</glossterm> - <glossdef><para>Git is a free and open source, distributed version control system designed to handle everything from small to very large projects with speed and efficiency.&newpara; - Every Git clone is a full-fledged repository with complete history and full revision tracking capabilities, not dependent on network access or a central server. Branching and merging are fast and easy to do.&newpara; - Git is used for version control of files, much like tools such as Mercurial, Bazaar, Subversion, CVS, Perforce, and Visual SourceSafe.&newpara; - It was decided that Git will be the main version control system of &kde;, replacement of SVN. It has been already used for some &kde; projects like Konversation and Amarok.&newpara; - More info:&newpara; - &linkstart;"http://git-scm.com/"&linkmid;Git Homepage&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-svn">SVN</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-i18n"> - <glossterm>i18n</glossterm> - <glossdef><para>Abbreviation for "internationalization". &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 &linkstart; - "http://l10n.kde.org"&linkmid;l10n.kde.org&linkend;.</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-gui">&GUI;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-kross"> - <glossterm>Kross</glossterm> - <glossdef><para>Kross is a scripting framework, enabling support for multiple scripting languages. A plugin system allows for the support of further languages in the future.</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-kdom"> - <glossterm>KDOM</glossterm> - <glossdef><para>A KPart module making KHTML <acronym>DOM</acronym> (&emstart;D&emend;ocument &emstart;O&emend;bject &emstart;M&emend;odel) rendering capabilities available to all applications. KSVG2 is built on KDOM for &kde; SC 4.</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-khtml">KHTML</glossseealso> - <glossseealso otherterm="gloss-kparts">KParts</glossseealso> - <glossseealso otherterm="gloss-khtml">KSVG</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-kjs"> - <glossterm>KJS</glossterm> - <glossdef><para>&kde; platform's JavaScript engine.</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-kparts">KParts</glossseealso> - <glossseealso otherterm="gloss-plasma">&plasma;</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-ksvg"> - <glossterm>KSVG</glossterm> - <glossdef><para>KSVG enables support for scalable vector graphics in a KHTML browser. KSVG2 extends this for &kde; SC 4.</para> - <glossseealso otherterm="gloss-kde">&kde;</glossseealso> - <glossseealso otherterm="gloss-khtml">KHTML</glossseealso> - <glossseealso otherterm="gloss-kparts">KParts</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-l10n"> - <glossterm>l10n</glossterm> - <glossdef><para>Abbreviation for "localization", 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-strigi"> - <glossterm>Strigi</glossterm> - <glossdef><para>A deep-indexed search daemon, Strigi aims to be fast and light-weight. It also uses SHA-1 hash which will help in the identification of duplicate files.&newpara; - More info:&newpara; - &linkstart;"http://en.wikipedia.org/wiki/Strigi"&linkmid;Wikipedia: Strigi&linkend;</para> - <glossseealso otherterm="gloss-kde">&kde;</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> - </glossentry> - <glossentry id="gloss-svn"> - <glossterm><acronym>SVN</acronym></glossterm> - <glossdef><para>Abbreviation for &emstart;Subversion&emend;, a version control system. The <acronym>SVN</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>SVN</acronym> on &linkstart;"http://developer.kde.org/source/anonsvn.html"&linkmid;http://developer.kde.org/source/anonsvn.html&linkend;.&newpara; More about <acronym>SVN</acronym> is available at &linkstart;"http://subversion.tigris.org/"&linkmid;http://subversion.tigris.org/&linkend;.</para> - <glossseealso otherterm="gloss-git">Git</glossseealso> - </glossdef> - </glossentry> - <glossentry id="gloss-xmlgui"> - <glossterm>XMLGUI</glossterm> - <glossdef><para>A programmers' framework for designing the user interface. It is extensively used by KParts.&newpara; - More info:&newpara; - &linkstart;"http://en.wikipedia.org/wiki/XMLGUI"&linkmid;Wikipedia: XMLGUI&linkend;&newpara; - &linkstart;"http://en.wikipedia.org/wiki/Qt_Style_Sheets"&linkmid;Wikipedia: Qt Style Sheets&linkend;</para> - <glossseealso otherterm="gloss-gui">&GUI;</glossseealso> - <glossseealso otherterm="gloss-kparts">Kparts</glossseealso> - <glossseealso otherterm="gloss-qt">&Qt;</glossseealso> - </glossdef> - </glossentry> - </glossdiv> - - <glossdiv id="glossdiv-misc"> - <title>Miscellaneous</title> - <glossentry id="gloss-rfc"> - <glossterm><acronym>RFC</acronym></glossterm> - <glossdef><para>&emstart;R&emend;equest &emstart;F&emend;or - &emstart;C&emend;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.&newpara; - More information about <acronym>RFC</acronym>s can be found at the - &linkstart;"http://www.rfc-editor.org"&linkmid;RFC Homepage&linkend;.</para> - </glossdef> - </glossentry> - </glossdiv> - - <glossdiv id="glossdiv-protocols"> - <title>Various protocols</title> - <glossentry id="gloss-smb"> - <glossterm><acronym>SMB</acronym></glossterm> - <glossdef><para>&emstart;S&emend;erver &emstart;M&emend;essage - &emstart;B&emend;lock. A network protocol used in &Microsoft; &Windows; - networks to access the file systems 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>&emstart;I&emend;nternet &emstart;R&emend;elay - &emstart;C&emend;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> - </glossdef> - </glossentry> - </glossdiv> - - &glossary-kdeprinting; -</glossary> diff --git a/doc/glossary/kdeprintingglossary.docbook b/doc/glossary/kdeprintingglossary.docbook deleted file mode 100644 index f9e03dc..0000000 --- a/doc/glossary/kdeprintingglossary.docbook +++ /dev/null @@ -1,941 +0,0 @@ - -<!-- -<?xml version="1.0" ?> -<!DOCTYPE glossary PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" -"customization/dtd/kdedbx45.dtd" [ -<!ENTITY % addindex "IGNORE"> -<!ENTITY % English "INCLUDE"> -<!ENTITY glossary-kdeprinting SYSTEM "kdeprintingglossary.docbook"> - -]> -<glossary id="glossary"> ---> - <glossdiv id="glossdiv-printing"> - <title>Printing</title> - - - <glossentry id="gloss-acl"> - <glossterm><acronym>ACLs</acronym></glossterm> - <glossdef><para>Abbreviation for &emstart;A&emend;ccess - &emstart;C&emend;ontrol &emstart;L&emend;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> - </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.&newpara; - 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).&newpara; - &CUPS; has &emstart;no&emend; 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 resource, - 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> - </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 &linkstart;"http://www.rfc.net/rfc1179.html"&linkmid;RFC 1179&linkend; only as late - as 1990.&newpara; - 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 - neighboring host in the next room sending a file - asking for printout.&newpara; - 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...&newpara; - 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. - </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 &emstart;C&emend;ommon - &emstart;U&emend;NIX &emstart;P&emend;rinting - &emstart;S&emend;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).&newpara; - &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;.&newpara; - More info:&newpara; - &linkstart;"http://www.cups.org"&linkmid;&CUPS; Homepage&linkend;</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-lprlpd">LPR/LPD</glossseealso> - <glossseealso otherterm="gloss-ppd">PPD</glossseealso> - </glossdef> - </glossentry> - - - <glossentry id="gloss-cupsfaq"> - <glossterm><acronym>&CUPS;-FAQ</acronym></glossterm> - <glossdef><para>&linkstart;"http://www.cups.org/articles.php?L+TFAQ"&linkmid;&CUPS;-FAQ&linkend; - is a valuable resource to answer many questions that anyone new to - &CUPS; printing might have at first. - </para> - </glossdef> - </glossentry> - - <glossentry id="gloss-daemon"> - <glossterm><acronym>Daemon</acronym></glossterm> - <glossdef><para>Abbreviation for &emstart;D&emend;isk - &emstart;a&emend;nd &emstart;e&emend;xecution - &emstart;mon&emend;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".&newpara; - 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.&newpara; - With the emerging - &CUPS; concept, extending the use of PPDs even to non-PostScript printers, - he realized 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".&newpara; - 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> - </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> - </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 &linkstart; - "http://gimp-print.sf.net/"&linkmid;Gimp-Print,&linkend; the &linkstart; - "http://www.easysw.com/epm/"&linkmid;EPM software packaging&linkend; tool - and &linkstart;"http://www.easysw.com/htmldoc/"&linkmid;HTMLDOC&linkend; - (used by the "Linux Documentation Project" to build the PDF versions - of the HOWTOs) -- but most importantly: &linkstart; - "http://www.cups.org/"&linkmid;&CUPS;&linkend; (the 'Common &UNIX; Printing - System').&newpara; - ESP financed themselves by selling a commercial version - of &CUPS;, called ESP PrintPro, - that includes some professional enhancements. - ESP Print Pro was purchased by Apple Inc. in February of 2007. ESP Print Pro software and support are no longer available from Easy Software Products. ESP Print Pro users were given non-expiring, floating licenses which may be accessed from the MyESP pages. - </para> - <glossseealso otherterm="gloss-cups">&CUPS;</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.&newpara; - Printing - via traditional protocols is not encrypted at all -- it is very easy - to tap and eavesdrop ⪚ into &PostScript; or PCL data transferred - over the wire.&newpara; - 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. - </para> - </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> - </glossentry> - - <glossentry id="gloss-escp"> - <glossterm><acronym>ESC/P</acronym></glossterm> - <glossdef><para>Abbreviation for &emstart;E&emend;pson - &emstart;S&emend;tandard &emstart;C&emend;odes for - &emstart;P&emend;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 &emstart;E&emend;asy - &emstart;S&emend;oftware &emstart;P&emend;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> - </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.&newpara; - 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 &linkstart;"http://www.linuxfoundation.org/collaborate/workgroups/openprinting/database/foomatic"&linkmid;Linuxprinting.org&linkend; - 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.&newpara; - 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 &kde; printing &GUI; interface, which performs a similar - task with regards to different print subsystems). </para> - </glossdef> - </glossentry> - - <glossentry id="gloss-ghostscript"> - <glossterm>Ghostscript</glossterm> - <glossdef><para>Ghostscript is a an interpreter for the &PostScript; language and for PDF or 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. - Ghostscript is widely used inside the Linux and &UNIX; world - for transforming &PostScript; into raster data suitable - for sending to non-&PostScript; devices. - More info: - &linkstart;"http://www.ghostscript.com/"&linkmid;Ghostscript Homepage&linkend;</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...&newpara; - ...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;&newpara; - ...a Ghostscript filter that can be used with any other - program that needs a software-RIP;&newpara; - ...a library that can be used by other software applications - in need of rasterization 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 &emstart;H&emend;ewlett-&emstart;Packard&emend;; - 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 license. - 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 &emstart;&HP;&emend; - &emstart;G&emend;raphical &emstart;L&emend;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> - </glossentry> - - <glossentry id="gloss-ietf"> - <glossterm><acronym>IETF</acronym></glossterm> - <glossdef><para>Abbreviation for &emstart;I&emend;nternet - &emstart;E&emend;ngineering &emstart;T&emend;ask - &emstart;F&emend;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.&newpara; - 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 &emstart;I&emend;nternet - &emstart;P&emend;rinting &emstart;P&emend;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 utilizes 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:&newpara; - - Basic, Digest or Certificate authentication mechanisms&newpara; - SSL or TLS for encryption of transferred data&newpara; - LDAP for directory services (to publish - data on printers, device-options, drivers, costs or - also to the network; or to check for passwords while - conducting 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-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> - </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> - </glossdef> - </glossentry> - - - <glossentry id="gloss-linuxprintingdatabase"> - <glossterm><acronym>Linuxprinting.org Database</acronym></glossterm> - <glossdef><para>&linkstart;"http://www.openprinting.org/printers"&linkmid;Database&linkend; containing printers and drivers that are suitable for them. - More info: - &linkstart;"http://www.linuxfoundation.org/collaborate/workgroups/openprinting/database/indexfaq"&linkmid;Linuxprinting.org FAQ&linkend;</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 &emstart;L&emend;ine - &emstart;P&emend;rinting &emstart;R&emend;equest, others: - &emstart;L&emend;ine &emstart;P&emend;rinter - &emstart;R&emend;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> - </glossdef> - </glossentry> - - <glossentry id="gloss-mimetypes"> - <glossterm>&MIME;-Types</glossterm> - <glossdef><para>Abbreviation for &emstart;M&emend;ultipurpose (or - Multimedia) &emstart;I&emend;nternet &emstart;M&emend;ail - &emstart;E&emend;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.&newpara; - 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.&newpara; - &MIME; typed files carry a recognition string with them, describing - their file format based on &emstart;main_category/sub_category&emend;. - Inside IPP, print files are also described using the &MIME; type scheme. - &MIME; types are registered with the IANA (Internet Assigning Numbers - &emstart;Association&emend;) to keep them unambiguous.&newpara; - &CUPS; has some &MIME; types of its own registered, like - &emstart;application/vnd.cups-raster&emend; (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-gimpprint">Gimp-Print</glossseealso> - </glossdef> - </glossentry> - - <glossentry id="gloss-pcl"> - <glossterm><acronym>PCL</acronym></glossterm> - <glossdef><para>Abbreviation for &emstart;P&emend;rinter - &emstart;C&emend;ontrol &emstart;L&emend;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 color -- 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 &emstart;P&emend;age - &emstart;D&emend;escription &emstart;L&emend;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 &emstart;Pic&emend;ture - &emstart;El&emend;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 &emstart;P&emend;rint - &emstart;J&emend;ob &emstart;L&emend;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.&newpara; - 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 &emstart;P&emend;ostScript - &emstart;P&emend;rinter &emstart;D&emend;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).&newpara; - 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.&newpara; - PPDs for &PostScript; printers are provided by the printer - vendors. They can be used with &CUPS; and &kde; printing subsystem to have access - to the full features of any &PostScript; printer. The &kde; Team - recommends using a PPD originally intended for use with - &Microsoft; Windows NT.&newpara; - PPDs for non-PostScript printers &emstart;need&emend; 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 utilize 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-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> - </glossdef> - </glossentry> - - - <glossentry id="gloss-printermib"> - <glossterm>Printer-<acronym>MIB</acronym></glossterm> - <glossdef><para>Abbreviation for - &emstart;Printer&emend;-&emstart;M&emend;anagement - &emstart;I&emend;nformation &emstart;B&emend;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 - &emstart;P&emend;rinter &emstart;W&emend;orking - &emstart;G&emend;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-printkioslave"> - <glossterm>print:/ KIO Slave</glossterm> - <glossdef><para>You can use a syntax of "print:/..." to get quick access - to &kde; printing subsystem resources. Typing "print:/manager" as a Konqueror URL - address gives administrative access to KDEPrint. Konqueror uses &kde;'s - famous "KParts" technology to achieve that. </para> - <glossseealso otherterm="gloss-ioslave">IO Slave</glossseealso> - <glossseealso otherterm="gloss-kparts">KParts</glossseealso> - </glossdef> - </glossentry> ---> - - <glossentry id="gloss-printerdatabase"> - <glossterm>Printer Database</glossterm> - <glossdef><para>Good database of printer drivers can be found at &linkstart;"http://www.openprinting.org/printers"&linkmid;http://www.openprinting.org/printers&linkend;.</para> - <glossseealso otherterm="gloss-linuxprintingdatabase">Linuxprinting Database</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 colors and (maybe) - sizes. This is called a "raster image".&newpara; - 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 "rasterized" - first to the given resolution that the output device is capable of...&newpara; - The rasterization 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 - &emstart;R&emend;aster &emstart;I&emend;mage - &emstart;P&emend;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.&newpara; - &PostScript; printers - contain their own PostScript-RIPs. A RIP may or may not be located - inside a printer.&newpara; - 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 &emstart;R&emend;emote - &emstart;L&emend;ine &emstart;P&emend;rinting - &emstart;R&emend;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.&newpara; - 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. - </para> - <glossseealso otherterm="gloss-printcap">printcap</glossseealso> - </glossdef> - </glossentry> - - - <glossentry id="gloss-snmp"> - <glossterm><acronym>SNMP</acronym></glossterm> - <glossdef><para>Abbreviation for &emstart;S&emend;imple - &emstart;N&emend;etwork &emstart;M&emend;anagement - &emstart;P&emend;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 &emstart;S&emend;ecure - &emstart;S&emend;ocket &emstart;L&emend;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 &emstart;S&emend;ynchronous - &emstart;P&emend;eripheral &emstart;O&emend;perations - &emstart;O&emend;n&emstart;L&emend;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 &emstart;T&emend;ransport - &emstart;L&emend;ayer &emstart;S&emend;ecurity; - <acronym>TLS</acronym> is an encryption standard for - data transferred 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 flavor 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> - </glossdef> - </glossentry> - - <glossentry id="gloss-xpp"> - <glossterm><acronym>XPP</acronym></glossterm> - <glossdef><para>Abbreviation for &emstart;X&emend; - &emstart;P&emend;rinting &emstart;P&emend;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; 3.</para> - </glossdef> - </glossentry> -<!-- - <glossentry id="gloss-1"> - <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> - </glossdef> - </glossentry> - - <glossentry id="gloss-4"> - <glossterm>xxxx</glossterm> - <glossdef><para>.</para> - <glossseealso otherterm="gloss-1">xyz</glossseealso> - </glossdef> - </glossentry> ---> - </glossdiv> - - -<!-- -</glossary> ---> diff --git a/doc/onlinehelp/CMakeLists.txt b/doc/onlinehelp/CMakeLists.txt deleted file mode 100644 index 5d9964a..0000000 --- a/doc/onlinehelp/CMakeLists.txt +++ /dev/null @@ -1,3 +0,0 @@ -########### install files ############### -# -kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR onlinehelp) diff --git a/doc/onlinehelp/index.docbook b/doc/onlinehelp/index.docbook deleted file mode 100644 index a6526d7..0000000 --- a/doc/onlinehelp/index.docbook +++ /dev/null @@ -1,96 +0,0 @@ -<?xml version="1.0" ?> -<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" -"dtd/kdedbx45.dtd" [ - <!ENTITY % addindex "IGNORE"> - <!ENTITY % English "INCLUDE"> -]> -<article id="onlinehelp" lang="&language;"> -<title>Online Help</title> -<articleinfo> - -<date>2010-05-13</date> -<releaseinfo>&kde; 4.5</releaseinfo> - -</articleinfo> - -<para>On this page, you can find different ways to find online -help and additional information provided by the KDE community.</para> - -<variablelist> -<title>KDE UserBase</title> -<varlistentry><term> -<ulink url="http://userbase.kde.org/An_introduction_to_KDE">An -Introduction to KDE</ulink> </term> -<listitem> -<para>Learn more about the <ulink url="http://userbase.kde.org/What_is_KDE"> -KDE community and its software</ulink> and find information to help you get -started. Also, discover what <ulink url="http://userbase.kde.org/Welcome_to_KDE_UserBase"> -UserBase</ulink> is and how it can help you. -</para> -</listitem> -</varlistentry> - -<varlistentry><term> -<ulink url="http://userbase.kde.org/Getting_Help">Getting Help</ulink> </term> -<listitem> -<para>Need some help? Here are some suggested places where you can get help -with problems, as well some hints on how to improve the quality of answers you receive. -</para> -</listitem> -</varlistentry> - -<varlistentry><term> -<ulink url="http://userbase.kde.org/Applications">Applications</ulink> </term> -<listitem> -<para>Discover the wide variety of applications from the KDE Community, -and find out what program suits your needs and preferences. -</para> -</listitem> -</varlistentry> - -<varlistentry><term> -<ulink url="http://userbase.kde.org/Tutorials">Tutorials</ulink> </term> -<listitem> -<para>How-To's, Tips & Tricks that can help make your KDE software -experience more enjoyable and productive. -</para> -</listitem> -</varlistentry> - -</variablelist> - -<variablelist> -<title>KDE Forum</title> -<varlistentry><term> -<ulink url="http://forum.kde.org/">KDE Community Forums</ulink> </term> -<listitem> -<para>The KDE Forums offer users, developers and people interested in KDE -a place to help each other, discuss KDE-related topics and exchange ideas. -You can find <ulink url="http://forum.kde.org/viewforum.php?f=14/">Tutorials & -Tips</ulink> in the forum.</para> -</listitem> -</varlistentry> -</variablelist> - -<variablelist> -<title>KDE Techbase</title> -<varlistentry><term> -<ulink url="http://techbase.kde.org/">KDE Techbase</ulink> </term> -<listitem> -<para>Information for developers and help to set up a KDE development environment.</para> -</listitem> -</varlistentry> -</variablelist> - -<variablelist> -<title>KDE Documentation</title> -<varlistentry><term> -<ulink url="http://docs.kde.org/">KDE Documentation site</ulink> </term> -<listitem> -<para>This page holds the complete KDE User Documentation in over 25 languages -for the released and the development version of KDE SC.</para> -</listitem> -</varlistentry> -</variablelist> - -</article> \ No newline at end of file