Git commit f2f3564595f510da6125841586f2896d1f1901ee by Kurt Hindenburg. Committed on 10/07/2016 at 01:14. Pushed by hindenburg into branch 'master'.
Update manual and misc doc updates Update remote tab tokens; remove outdated dbus comment. M +1 -1 doc/manual/README M +17 -8 doc/manual/index.docbook D +0 -141 doc/manual/kde4.notes http://commits.kde.org/konsole/f2f3564595f510da6125841586f2896d1f1901ee diff --git a/doc/manual/README b/doc/manual/README index 7da1f1b..926cde4 100644 --- a/doc/manual/README +++ b/doc/manual/README @@ -1,5 +1,5 @@ Use CheckXML to verify the file is valid XML -Use meinproc4 to create an HTML version. +Use meinproc5 to create an HTML version for local viewing. Remember to update the date and releaseinfo when you want the the translators to see the new version. diff --git a/doc/manual/index.docbook b/doc/manual/index.docbook index 888d26b..f50d3c9 100644 --- a/doc/manual/index.docbook +++ b/doc/manual/index.docbook @@ -38,14 +38,14 @@ <holder>&Jonathan.Singer;</holder> </copyright> <copyright> -<year>2005</year><year>2008</year><year>2009</year><year>2010</year><year>2011</year><year>2014</year> + <year>2005</year><year>2008</year><year>2009</year><year>2010</year><year>2011</year><year>2014</year><year>2016</year> <holder>&Kurt.Hindenburg;</holder> </copyright> <legalnotice>&FDLNotice;</legalnotice> -<date>2016-04-18</date> -<releaseinfo>Applications 16.04</releaseinfo> +<date>2016-07-09</date> +<releaseinfo>Applications 16.08</releaseinfo> <abstract><para>&konsole; is &kde;'s terminal emulator.</para></abstract> @@ -961,16 +961,26 @@ These changes can be made permanent by editing the current profile. </para> <para> -&konsole; will substitute these tokens: +&konsole; will substitute these tokens for local tabs: <itemizedlist mark='opencircle'> <listitem><para>%n : program name</para></listitem> <listitem><para>%d : current directory (short)</para></listitem> <listitem><para>%D : current directory (long)</para></listitem> +<listitem><para>%h : local host (short)</para></listitem> +<listitem><para>%u : user name</para></listitem> <listitem><para>%w : window title set by shell</para></listitem> <listitem><para>%# : session number</para></listitem> -<listitem><para>%u : user name</para></listitem> -<listitem><para>%h : local host or remote host (short)</para></listitem> -<listitem><para>%H : remote host (long)</para></listitem> +</itemizedlist> + +&konsole; will substitute these tokens for remote tabs: +<itemizedlist mark='opencircle'> + <listitem><para>%c : current program</para></listitem> + <listitem><para>%h : remote host (short)</para></listitem> + <listitem><para>%H : remote host (long)</para></listitem> + <listitem><para>%u : user name</para></listitem> + <listitem><para>%U : user name@ (if given)</para></listitem> + <listitem><para>%w : window title set by shell</para></listitem> + <listitem><para>%# : session number</para></listitem> </itemizedlist> </para> @@ -1235,7 +1245,6 @@ will display the &DBus; interface for &konsole;. <option>org.kde.konsole /Windows/1</option> will display methods for controlling window 1. </para> -<note><para>/Konsole was previously used for controlling the first window, which is a design mistake. Please do not use it for that purpose anymore, and consider updating existing scripts.</para></note> </listitem> <listitem><para> diff --git a/doc/manual/kde4.notes b/doc/manual/kde4.notes deleted file mode 100644 index 8923508..0000000 --- a/doc/manual/kde4.notes +++ /dev/null @@ -1,141 +0,0 @@ - - Konsole's interface ( particularly the menus and settings ) have - changed in KDE 4. These are notes on what needs to be covered - in the handbook and somewhere to draft a layout for the documentation. - - -- Robert Knight ([email protected]) - ------------ -khindenburg - Aug 2008 -The handbook has been updated to trunk/ which will be 4.2. -The menus and command-line options are correct. -There is room for more information which could include some of the ideas below. -Also a FAQ section needs to be added. -Consider adding link to updated Handbook on konsole.kde.org -Consider what to do with konsole.kde.org ------------ - - Introduction - - What is Konsole? - - What is a terminal? - - How can I learn to use the terminal? - - Ideas: - - -> Information on more beginner-friendly shells such as Fish - -> Basic introduction? - -> Links to beginners tutorial for Bash shell - -> Links to information on scripting languages - -> Links to information on Vim, Emacs etc. - - - ( Konsole features )? - - A brief list of useful features in Konsole with links - to the appropriate section of the handbook. - - Basic Usage - - Creating new tabs - - Creating new windows - - Closing a tab or window - - Input - - Keyboard - - Mouse - - Opening links and email addresses - - Edit actions - - Copy and Paste - - Tab titles and renaming the tab - - Copying input to all tabs - - Scrolling - - Scrolling output - - With the mouse - - With the keyboard - - Clearing the display - - Clearing the current display only - - Clearing everything - - Changing the scroll-back size - - Searching output - - Saving output - - View actions - - Changing the text size temporarily - - Splitting the view - - Uses of split view - - What happens when the view is split? - - How to split the view: Left/Right , Top/Bottom - - Closing (unsplitting) the view: Close active view, close others - - Changing the size of the views - - Using the mouse - - Using the keyboard shortcuts - - Monitoring for silence or activity - - Hiding the menu bar - - Full screen mode - - Entering into and exiting from - - - Moving a tab between windows - - Bookmarks - - Creating a new bookmark - - Bookmarking a set of tabs as a folder - - Local vs SSH bookmarks - - Konsole Setup : Profiles - - - What is a profile - - Changing the current profile in a tab - - Editing the current profile - - General - - Name - - Command - - Working directory - - Icon - - Environment editor - - The $TERM environment variable - - Menu Bar display - - Tabs - - Tab titles - - Local vs Remote - - Inserting dynamic elementss - - Tab bar position - - Tab bar display mode - - Color Schemes and Fonts - - Choosing and previewing a color scheme - - Changing the text size - - Changing the font - - (Link -> Color Schemes) - - - Scrollback - - Scroll back types ( none , fixed line count , unlimited ) - - Scroll bar position - - Keyboard Setup - - Choosing a keyboard binding - - (Link -> Keyboard Bindings) - - - Advanced - - Managing profiles - - Creating new profiles - - Creating a new session from a profile - - Editing existing profiles - - Removing profiles - - Favorite profiles - - Profile shortcuts - - Color Schemes - - Creating new color schemes - - The color palette - - Changing a color - - Transparent color schemes - -> Transparency requirements - - Randomly varied background colors - - Editing existing color schemes - - Removing color schemes - - Keyboard Bindings - - Creating a new keyboard binding - - Editing key binding entries - - Key sequence specification - - Output specification - - Escape characters - - Adding a new key binding - - Removing a key binding - - Testing key bindings - - Editing existing bindings - - Removing bindings _______________________________________________ kde-doc-english mailing list [email protected] https://mail.kde.org/mailman/listinfo/kde-doc-english
