From 681ca6657ff45327422e0f04f286a079319c1f51 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Burkhard=20L=C3=BCck?= Date: Mon, 2 Jul 2012 22:51:48 +0200 Subject: [PATCH] update dolphin + konqui filemanager docs to 4.9 --- doc/dolphin/index.docbook | 228 +++++++++++++++--------------- doc/konqueror/filemanager.docbook | 35 +++-- 2 files changed, 136 insertions(+), 127 deletions(-) diff --git a/doc/dolphin/index.docbook b/doc/dolphin/index.docbook index 5049948e9b..5bf9167343 100644 --- a/doc/dolphin/index.docbook +++ b/doc/dolphin/index.docbook @@ -73,8 +73,8 @@ &FDLNotice; -2012-01-14 -2.0 (&kde; 4.8) +2012-07-02 +2.1 (&kde; 4.9) @@ -109,8 +109,8 @@ interface for the specific task of file management. Please report any problems or feature requests to the &dolphin; author via the -bug report dialog. This is accessible either from the Configure and control -&dolphin; button at the right of the toolbar in the default mode without +bug report dialog. This is accessible either from the Control +button at the right of the toolbar in the default mode without menu bar; or from HelpReport Bug... menu of the application, if the menubar is shown. @@ -150,7 +150,7 @@ The toolbar, which can be used for quick access to frequently used actions. The toolbar can be customized by clicking it with the &RMB; and choosing Configure Toolbars... from the context menu, with Configure Toolbars... -from the Configure and control &dolphin; button at the +from the Control button at the right of the toolbar or via Settings Configure Toolbars... from the main menu. @@ -168,7 +168,7 @@ from the main menu. Toolbar items where the icon is sufficient for knowing the command do not have a text alongside the icons. This can be changed by a &RMB; click and selecting the item text -below Show Text. The Configure and control &dolphin; +below Show Text. The Control button at the right side of the toolbar is only displayed if the menubar is hidden. @@ -205,7 +205,7 @@ The menu bar (hidden by default), which provides access to all commands and conf See the Command Reference for a list of all menu commands. The menu bar can be toggled with Show Menubar from the Settings -menu or the Configure and control &dolphin; button +menu or the Control button (&Ctrl;M). @@ -325,11 +325,13 @@ view modes. In the Icons view, which is the default, files will be represented by an icon that visualizes the file type, and a folder icon will be shown for subfolders. The names of folders and files are displayed below the icons. + The Compact view shows the folder contents as icons with -the name beside it grouped in columns similar to the Short View +the name +beside it grouped in columns similar to the Short View in the &kde; file dialog. @@ -339,13 +341,23 @@ as a detailed list which contains the name, size and last modification time of each item. Additional columns can be added by clicking a column header with the &RMB;. +In the context menu of the header line you can choose between custom or automatic +column width. Automatic width adjusts the width of all columns once to display the longest +item in the column completely, except for the Name column where +the extension is replaced by "..." + + +The order of columns can be changed by drag and drop of column headers. + + The details view permits to view the current directory -in a tree-like fashion: Each subfolder of the current folder can be +in a tree-like fashion if +Expandable folders are enabled: +Each subfolder of the current folder can be expanded or collapsed by clicking on the < or v icon next to it. - @@ -361,6 +373,7 @@ or v icon next to it. ViewSort by + @@ -473,6 +486,12 @@ in the view. selection state of all items in the view. + +Select a file or folder by typing the first few letters of its name and the +the first matching item is selected. +To clear the selection and cancel the keyboard search press &Esc; or wait longer than +the timeout of 1 second. + @@ -481,6 +500,9 @@ selection state of all items in the view. + + Location Bar @@ -541,7 +563,7 @@ crumb mode, click the check mark at the right of the location bar with the &LMB; Places and Context - + If the Places 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 @@ -648,7 +670,9 @@ affect the &dolphin; view. - + Search @@ -964,39 +988,52 @@ custom font can be chosen. -The settings which apply to only one of the view modes are discussed below. +The other settings in the Text section which apply to only +one of the view modes are discussed below. Icons - -Besides the common settings -of all view modes, the icons view has the following settings: - - - -In the Text section: - - - - -Text Width controls the maximum width that is reserved for +Width controls the minimum width that is reserved for the text of a file item. + + + Maximum lines +means maximum number of text lines below the icon. - - - - - - + + +Compact + + + +Maximum width controls the maximum width that is reserved for +the text of a file item. + + + + + + +Details + + + +Expandable folders If checked the folder withd subfolders are displayed +in a tree view where the sub items can be expanded clicking the < icon +and collapsed clicking the v icon.. + + + @@ -1074,19 +1111,23 @@ appears when clicking a file or folder with the &RMB;. Using the Download New Services you can fetch additional service menu. - If you have installed &dolphin;'s plugins for Bazaar, Mercurial, Git or -Subversion from the kdesdk module an additional group -Version Control Systems is displayed. +Subversion from the kdesdk module these services are shown in the list. If these plugins are enabled and you enter a folder which is under version control, the version state (locally changed, up to date &etc;) is indicated by icons and you have additional entries in the context menu like commit, update, add, remove &etc; -&dolphin; has to be restarted to activate changes of these settings. +In the service list it can be chosen as well if the Delete, +Copy To, and Move To +commands are shown in the context menu. + + +&dolphin; has to be restarted to activate the changes for some of these settings. + @@ -1159,22 +1200,10 @@ tab bar on top. -In the View Properties section, it can be configured if the +In the View section, it can be configured if the view properties are stored for each folder or if common view properties are to be used for all folders. - - -In the Ask for Confirmation When section, warning dialogs which -are shown before potentially harmful actions can be enabled. - - When hovering a file or folder with the mouse, a small window with information about it is shown next to it if Show tooltips is enabled. @@ -1215,27 +1244,20 @@ leads to the sort order In this tab, it can be configured for which file types previews are shown. -Moreover, the maximum filesize for which previews are generated can be chosen, -and it can be configured if thumbnails embedded in files are used or not. +Moreover, the maximum size of remote files for which previews are generated can be chosen. - If previews are enabled for folders, previews of some files in the folder will be shown inside a folder's icon. - - -Context Menu Tab - + +Confirmations Tab -In this tab, it can be chosen if the Delete, -Copy To, and Move To -commands are shown in the context menu which appears when right-clicking a file -or folder. +In the Ask for Confirmation When section, warning dialogs which +are shown before potentially harmful actions can be enabled. - @@ -1258,6 +1280,11 @@ A bar that shows how much space is free on the current drive. + +Since &dolphin; 4.9 the Delete, +Copy To, and Move To +commands of the context menu have to be enabled on the Services page. + @@ -1352,8 +1379,8 @@ properties yet. Command Reference By default the menubar is not shown. All actions described here either can -be accessed with toolbar buttons or with items in the menu of the Configure -and control &dolphin; toolbar button. +be accessed with toolbar buttons or with items in the menu of the +Control toolbar button. The Menubar in &dolphin;'s Main Window @@ -1416,7 +1443,7 @@ folder. File Rename -Renames the currently selected item(s). +Renames the currently selected item(s) inline. @@ -1603,6 +1630,15 @@ Selects all unselected items and deselects all selected items in the current fol View Sort By + Changes whether items are sorted by Name, Size, Date, @@ -1625,6 +1661,9 @@ Selects all unselected items and deselects all selected items in the current fol Group, Type, Link Destination or Path in the different views. + @@ -1699,10 +1738,12 @@ folder. (F11), Folders (F7), Terminal (F4) and Search (F12). + With Lock Panels the panel header with caption and two buttons is hidden to save space and the panels are immutable, with Unlock Panels the header is visible and the panel can be moved to the right or left or even outside the main window. + @@ -1859,61 +1900,15 @@ connection manually. -The Settings Menu +The Settings and Help Menu - - - - - -&Ctrl;M - -Settings -Show Menubar - -Hides and shows the menubar. - - - - -Settings -Show Toolbar - -Hides and shows the toolbar. - - - - -Settings -Configure Shortcuts... - -Opens the shortcut configuration dialog. - - - - -Settings -Configure Toolbars... - -Opens the toolbar configuration dialog. - - - - -Settings -Configure &dolphin;... - -Opens the &dolphin; configuration dialog. - - +&dolphin; has the common &kde; Settings and Help +menu items, for more information read the sections about the Settings Menu and Help Menu +of the &kde; Fundamentals. - -The Help Menu -&help.menu.documentation; - - @@ -2026,12 +2021,13 @@ Documentation copyright 2009 Frank Reininghaus frank78ac@googlemail.com How to get &dolphin; - &dolphin; is part of the kdebase package which is an essential part of &kde;. For instructions on acquiring &kde; please see http://www.kde.org. +url="http://www.kde.org">http://www.kde.org or read the chapter +Installing &kde; +in the &kde; Fundamentals. For further information about &dolphin; you might want to visit http://dolphin.kde.org or diff --git a/doc/konqueror/filemanager.docbook b/doc/konqueror/filemanager.docbook index a89cce7f62..ea7c4fa4d7 100644 --- a/doc/konqueror/filemanager.docbook +++ b/doc/konqueror/filemanager.docbook @@ -5,8 +5,8 @@ -2011-11-20 -&kde; 4.8 +2012-07-02 +&kde; 4.9 &konqueror; the File Manager @@ -67,11 +67,13 @@ component. In the Icons view, which is the default, files will be represented by an icon that visualizes the file type, and a folder icon will be shown for subfolders. The names of folders and files are displayed below the icons. + The Compact view shows the folder contents as icons with -the name beside it grouped in columns similar to the Short View +the name +beside it grouped in columns similar to the Short View in the &kde; file dialog. @@ -81,11 +83,23 @@ as a detailed list which contains the name, size and last modification time of each item. Additional columns can be added by clicking a column header with the &RMB;. +In the context menu of the header line you can choose between custom or automatic +column width. Automatic width adjusts the width of all columns once to display the longest +item in the column completely, except for the Name column where +the extension is replaced by "..." + + +The order of columns can be changed by drag and drop of column headers. + + The details view permits to view the current directory -in a tree-like fashion: Each subfolder of the current folder can be +in a tree-like fashion if +Expandable folders are enabled: +Each subfolder of the current folder can be expanded or collapsed by clicking on the < -or v icon next to it. +or v icon next to it. + @@ -134,7 +148,7 @@ the extra data would take too long set a file size limit at the bottom of the The following settings control how the contents of a folder are displayed in the -&konqueror; view, and are stored on a per-folder basis by default: +&dolphin; view, and are stored on a per-folder basis by default: @@ -154,8 +168,8 @@ Sorting of folders and files – are folders shown first or not? Previews – are they shown instead of icons (based on the settings made in -Previews tab of &konqueror;'s File Management -General settings) or not? +Previews +tab of &konqueror;'s General settings) or not? @@ -449,9 +463,8 @@ you do the Paste into the new folder. the context menu you get when you right click on an file or folder name in the File Manager window. To enable this feature select Show 'Copy To' and 'Move To' -commands on the Context Menu tab of the -File Management -General section of the settings. +commands on the File Management +Services page section of the settings. You may not be able to copy or move a file or folder if you don't have the necessary permissions.