diff --git a/doc-extras/ChangeLog b/doc-extras/ChangeLog index e1207b56..e2898d87 100644 --- a/doc-extras/ChangeLog +++ b/doc-extras/ChangeLog @@ -1,741 +1,742 @@ The Krusader Handbook ChangeLog ------------------------------- 2.7.x "" ========================== Date: 20??-??-?? ADDED: More documentation on the search bar, new shortcuts. + FIXED: Synchronizer is not disabled by default anymore. 2.7.0 "Peace of Mind" ========================== Date: 2018-05-13 CHANGED: Updated release information in docs CHANGED: Updated ChangeLog, NEWS and Features page with v2.7 changes FIXED: Changes in several files because, by default, F2 renames and F9 opens a terminal window FIXED: Cleaned up old auxiliary files, updated references and fixed layout in docs ADDED: Add new icon theme option to Konfigurator docs CHANGED: Update the docs according to keybinding changes ADDED: bookmark quick search (type symbols in bookmark menu to activate) ADDED: Add docs for the new Konfigurator option 'Search in special items' CHANGED: Updated copyright years and release info in docs CHANGED: Updated and standardized FDL license headers CHANGED: Updated credits in docbook ADDED: Add the new option to Konfigurator docs ADDED: Document new features: tab pinning and the Open MountMan menu item ADDED: More updates to the search dialog docs ADDED: Add new search excluding options to the docs ADDED: Add new option for the Right arrow key to the docs CHANGED: Follow the renaming of popup panel in docs FIXED: Fix menu-command.docbook (patch by Christoph) FIXED: Fix shortcuts (inspired by Christoph's work) FIXED: Fix shortcuts (patch by Christoph) + minor cleanup CHANGED: Update man page CHANGED: Add missing docs for an option in Konfigurator ADDED: Add docs on the new 'Show Tab Bar on single tab' option ADDED: Add new Konfigurator 'Always show current item' item to the docs CHANGED: Minor updates for the man page 2.6.0 "Stiff Challenges" ========================== Date: 2017-04-12 FIXED: BUG #322915 (Sync the docs with katepart) FIXED: Fix terminology in the usage of KDE CHANGED: Remove Space for calculating dir sizes from docs CHANGED: Remove krusader-news ML from docs FIXED: fix gui strings (thanks to Burkhard Lück) FIXED: branding: for KDE -> by KDE CHANGED: Sync docs with code (1 screenshot still need to be replaced) CHANGED: Do not bother previous maintainer FIXED: Fix credits FIXED: The INSTALL file was updated after a Kubuntu 16.10 installation. The install.docbook was corrected to avoid seeing the text `krusader--profile` FIXED: Sync docs with new installation instructions CHANGED: Minor rebranding in docs ADDED: Add some documentation on the JobMan CHANGED: Replace kde-files.org with store.kde.org in docs CHANGED: Major cleanup from old links in docs FIXED: remove obsolete entities reporting.bugs + updating.documentation, commented and not used CHANGED: Update Konfigurator start page documentation FIXED: Fix minor typos in docs 2.5.0 "Clear Skies" ========================== Date: 2016-10-22 ADDED: Add information on removal of Synchronizer and on how to reenable it. FIXED: Bug #298346 2.4.0-beta3 "Single Step" ========================== Date: 2012-10-20 2.4.0-beta2 "Giant Steps" ========================== Date: 2012-10-12 ADDED: description for the new shortcut, pressing Ctrl+Return when media menu is open (un)mounts the highlighted device. ADDED: description for options on Panel > Media Menu tab ADDED: Description for options: Archives > krarc > Enable Write Support, Archives > Fine-Tuning > Test archives before unpacking ADDED: shortcut description for "Go to Other Panel's Directory" (Ctrl+=) ADDED: option: General > Viewer/Editor > Viewer > Use Okteta as Hex viewer CHANGED: revisited menu description (thanks to Burkhard Lück) FIXED: Many fixes by Pino Toscano. FIXED: Bugs #277151, #277152, #277491, #277557, #277901, #278129, #278135, #278136, #278139, #278142, #278143, #285547, #285558, #285565, #300912, #300923, #300926, #300928, #300929, #300932, #300978, #300982. FIXED: Bugs reported by Burkhard Lück ( http://groups.google.com/group/krusader-devel/browse_thread/thread/6751160dc4c94657?hl=en ) UPDATED: ActionMan description. 2.4.0-beta1 "Migration" ========================== ADDED: Quickfilter section in basic-functions ADDED: MountMan option: Show only removable devices ADDED: option: Panel > Operation > Filter dialog remembers settings ADDED: action: Move Current Tab to Other Side ADDED: updated man page ADDED: support for xz archives CHANGED: User Interface > Panels > Folder History (history is saved now) CHANGED: New layout of Konfigurator General page. CHANGED: kgstartup screenshot to follow Konfigurator changes CHANGED: new Konfigurator page (Panel), items are moved according to the interface change up to the 2.3.0-beta1+ CHANGED: Update the addresses according to the Git move CHANGED: option: Panel > Status/Totalsbar > Show space information FIXED: Bugs #261307, #261311, #261358, #261361, #261371, #261375, #261379, #261382, #261383, #263493, #263500, #267546, #267695, #267708, #267718, #268210, #268234, #268236, #268239, #270257, #270648, #270650. FIXED: Bugs reported to kde-doc-english by Alexander Potashev 2.3.0-beta1 "New Horizons" ========================== 2.1.0-beta1 "Rusty Clutch" ================================== Date: 2009-10-?? ADDED: lister: fast text/hex viewer for huge filesizes ADDED: file regular expressions in quick search ADDED: queued packing / unpacking ADDED: lock tabs, close inactive tabs, close duplicated tabs ADDED: Trash icon in Main Toolbar and Tools menu ADDED: Trash icon in Main Toolbar UPDATED: Main Toolbar image: toolbar.png UPDATED: installation instructions afer SVN move from Sourceforge to KDE Extragear 2.0.0 "Mars Pathfinder" ================================== Date: 2009-04-11 UPDATED: Architecture: re-indexed the menu UPDATED: File change: OLD: credits.docbook NEW: credits-and-license.docbook UPDATED: File change: OLD: mouse.docbook NEW: mouse-commands.docbook UPDATED: File change: OLD: keyboard.docbook NEW: keyboard-commands.docbook UPDATED: File change: OLD: commands.docbook NEW: menu-commands.docbook UPDATED: File change: OLD: more.docbook NEW: advanced-functions.docbook UPDATED: File change: OLD: using-krusader.docbook NEW: basic-functions.docbook UPDATED: Alt+letter shortcuts UPDATED: FAQ, removed KDE3 issues and added KDE4 updates UPDATED: shred is not longer supported by Krusader2 - KDE4 REMOVED: All text ENTITIES in index.docbook so that tha handbook becomes 100% translatable REMOVED: Klik install procedure, Klik doens't offer Krusader anymore 2.0.0-beta2 "Space Odyssey" ================================== Date: 2008-12-27 ADDED: Manage Useractions: "Run in embedded terminal emulator" ADDED: Manage Useractions: added checkbox "enabled" ADDED: Root mode Krusader configuration, use eg. gksu instead of kdesu ADDED: Mac OS-X installation instructions for KDE4 2.0.0-beta1 "Phoenix Egg" ================================== Date: 2008-07-06 ADDED: Windows installation instructions for KDE4 ADDED: KDE4.x installation instructions ADDED: synchronizer_keybindings ADDED: compilation requirements for KDE4 ADDED: credits for Václav Jůza UPDATED: Handbook update from CVS krusader_kde3 to SVN krusader_kde4 at 18 january 2008 ADDED: Howto executing jar files (and not enter the jar archive)? ADDED: FAQ How don't add ".part" suffix when copying files via ftp? ADDED: FAQ Where is Konfigurator? UPDATED: Howto diplay the complete filename in the Name column (by hiding ext column) FIXED: workaround for DBLATEX 0.2.5-1, it doesn't accept "&" to display "&" in the tag, so i changed it to "and" FIXED: removed all tags inside , no additional tags needed inside <title>, it looks bad in HTML version (stylesheet) 1.90.0 "Power Stone" ================================== Date: 2008-03-15 Handbook 1.80.0 + Useractions explenations of the Power Stone release. These Useractions are not shipped in the 2.0.0 series. 1.80.0 "Final 3rd Stone" ================================== Date: 2007-07-21 ADDED: Terminal Emulator, paste with SHIFT+INSERT and CTRL+V ADDED: Vaclav's checksum patches (added sha* tools, fixed bugs etc...) Nothing to add in the docs i guess for this feature. ADDED: Synchronizer: ignore hidden files option ADDED: Synchronizer-results: drag [left], SHIFT+drag [right], Copy left/right selected items to clipboard ADDED: Locate-results: dragging items, copy to clipboard (CTRL+C) ADDED: Searcher-results: dragging items, copy to clipboard (CTRL+C) ADDED: Terminal Emulator keybindings in a separate section UPDATED: MacOS install instructions and fink repository, thanks to Catalin Hritcu UPDATED: screenshots UPDATED: make the Synchronizer chapter more readable and more undertandable UPDATED: Command Line / Terminal Emulator chapter UPDATED: FAQ, Sourceforge patch tracker tool UPDATED: keybindings UPDATED: old urls of old releases FIXED: removed all '_' signs in the entities for the openjade parser 1.80.0-beta2 "Last Unstable Stone" ================================== Date: 2007-03-31 ADDED: Support for useraction placeholders in Krusader's commandline ADDED: New default user action "Backup current" ADDED: ALT+C as default shortcut for compare directories ADDED: GUI for configuring the atomic extensions in Konfigurator ADDED: quotation mark handling at search (ex. "Program Files") ---------------------------------------------------- Other todo items not related to Krusader's changelog: TODO: complete Keyboard Usage TODO: complete glossary TODO: complete Mouse Usage TODO: selection modes http://krusader.sourceforge.net/phpBB/viewtopic.php?p=8255#8255 ---------------------------------------------------- ADDED: Remote LAN Connections (zeroconf) ADDED: NewsLetter Forum ADDED: Quickstart Installation Tutorial ADDED: FAQ: What todo if an extenal tool doesn't seem to work? ADDED: FAQ: What todo if the KDEcrashhandler sends no usefull backtrace information? ADDED: FAQ: How can i send good debug or crash reports? ADDED: Brief view Documentation updates by the Technical Communication team of 2007, University of Oulu, Finland http://www.oulu.fi/english/ under the lead of Minna Hekanaho ADDED: FAQ: Does krusader supports the FXP protocol? ADDED: webdav and nfs url ADDED: FAQ: How can I set the look & Feel of 2 different users equal? REMOVED: Outdated and unused Italian handbook translation 1.80.0-beta1 "The Last Krusade" =============================== Date: 2007-01-07 ADDED: full support for ACL permissions (properties, preserve attrs, synchronizer) ADDED: actionman.png screenshot ADDED: i18n scripts update_docbook, update_pot, update_po They only should be used by the doc 18n coordinator Wrong usage of this script might result in outdated documentation files ADDED: Russian Handbook (translation is work in progress) thanks to Roman Batejkin ADDED: TerminalEmulator: Ctrl+F switches between full-widget TE, normal TE (thanks to Vaclav Juza) ADDED: Ctrl+Up from panel focuses the origin editbox, Ctrl+Down from origin editbox focuses the panel (thanks to Vaclav Juza) ADDED: TerminalEmulator: Ctrl+Shift+Up/Down always focus/unfocus TE independently whether the command line is shown or not ADDED: TerminalEmulator: if the command line is hidden, TE receives Ctrl+Up / Ctrl+Down (thanks to Vaclav Juza) ADDED: synchronizer: double click on a file calls the diff utility (kompare) ADDED: atomic extensions (see CVSNEWS) ADDED: renaming of just the filename, without extension ADDED: full screen terminal window (mc-style) ADDED: keeping the directory structures for virt folders at copy/move ADDED: synchronizer, parallel threads for slow FTP servers ADDED: Better quick navigation: first move mouse over subdir, then press ctrl + left mouse button (patch by Jiri Palecek) ------------- Docbook file splitting Design changes ------------------- UPDATED: split up krusader-tools.docbook in smaller files UPDATED: split up using-krusader.docbook in smaller files ADDED: more.docbook (formerly part of using-krusader.docbook) ADDED: diskusage.docbook (formerly part of krusader-tools.docbook) ADDED: java.docbook (formerly part of krusader-tools.docbook) ADDED: viewer-editor.docbook (formerly part of krusader-tools.docbook) ADDED: locate.docbook (formerly part of krusader-tools.docbook) ADDED: search.docbook (formerly part of krusader-tools.docbook) ADDED: bookmarks.docbook (formerly part of krusader-tools.docbook) ADDED: mount.docbook (formerly part of krusader-tools.docbook) ADDED: remote-connections.docbook (formerly part of krusader-tools.docbook) ADDED: archives.docbook (formerly part of using-krusader.docbook) ADDED: checksum.docbook (formerly part of using-krusader.docbook) ADDED: occupied-space.docbook (formerly part of using-krusader.docbook) ADDED: compare.docbook (formerly part of using-krusader.docbook) ADDED: splitter.docbook (formerly part of using-krusader.docbook) ADDED: vfs.docbook (formerly part of using-krusader.docbook) ADDED: profiles.docbook (formerly part of using-krusader.docbook) ADDED: useractions.docbook (formerly part of krusader-tools.docbook) ADDED: Mouse Commands, mouse.docbook (formerly part of using-krusader.docbook) ADDED: Keyboard Commands, keyboard.docbook (formerly part of using-krusader.docbook) ADDED: abc-index by using <indexterm> ADDED: List of Figures (index) <screenshot> -> <figure> ADDED: List of Tables (index) <informaltable> -> <table> ADDED: release-overview.docbook (formerly part of installation.docbook) ADDED: useraction-xml.docbook (formerly part of installation.docbook) ADDED: configuration-files.docbook (formerly part of installation.docbook) ADDED: help.docbook (formerly part of index.docbook) ADDED: editorsnote.docbook (formerly part of index.docbook) ADDED: features.docbook (formerly part of introduction.docbook) ADDED: glossary.docbook ---------------------------------------------------------- ADDED: ActionMan for useraction configuration ADDED: single instance mode (Konfigurator Startup) ADDED: start to system tray (Konfigurator Startup) ADDED: right click menu for bookmarks (context menu) ADDED: enable/disable special bookmarks by right clicking on them ADDED: an option for directories to be always sorted by name (Konfigurator L&F) ADDED: FAQ: Why "save last location" doesn't work? ADDED: Inactive panel color dimming ADDED: FAQ: How can I send a patch? ADDED: FAQ: Why does krusader-cvs shows an old version number in the about box? ADDED: kioslaves: trash:/ and ipod:/ ADDED: Subversion checkout ADDED: Profiles chapter ADDED: Media button, Ctrl+M, Ctrl+Shift+Left, Ctrl+Shift+Right UPDATED: Rename 'mark' to 'select' UPDATED: checksum creation/verification mechanism UPDATED: Command Reference -> Menu Commands UPDATED: moved the "Foreword" from index.docbbook to introduction.docbook UPDATED: Shortcut- and Toolbardialogs are removed from Konfigurator UPDATED: Heavily extended and reordered menubar, Updated commands.docbook (thanks to Dan Price) UPDATED: UserActions examples in the documentation appendix UPDATED: UserActions are now managed with ActionMan. In Konfigurator you can change settings _about_ useractions. UPDATED: Shortcuts are now exported in as plaintext, legacy import still works. UPDATED: Konfigurator UPDATED: Konfigurator: MouseMode got now it's own Tab in Look&Feel UPDATED: Bookman and passwords UPDATED: Copy/Move: preserve all attributes (time, owner, group) UPDATED: New cvs checkout url cvs.sourceforge -> krusader.cvs.sourceforge UPDATED: FAQ UPDATED: Command Reference UPDATED: Marking (Selecting) files and directories UPDATED: Virtual file systems (VFS) UPDATED: Archives UPDATED: Features list rewritten to make it more clear FIXED: KruSearcher 'ftp' group -> 'users', thanks to Roman Batejkin REMOVED: remoteman.png screenshot 1.70.0 "Round Robin" ==================== Date: 2006-01-23 ADDED: Help: Upload your extensions/plugins at kde.files.org ADDED: Help: Spread the Word Krusader ADDED: FAQ: Crashes in Krusader caused by Qt 3.3.5 ADDED: Newsfeeds ADDED: Krusader users mailinglist ADDED: Mouse Gestures ADDED: Ctrl+Alt+T to show/hide the terminal emulator UPDATED: F10 -> Ctrl+Q : Quit viewer/editor UPDATED: Ctrl+D -> Ctrl+Shift+B : Detach Tab UPDATED: Ctrl+E -> Ctrl+Shift+E : Text Viewer UPDATED: Ctrl+H -> Ctrl+Shift+H : Hex Viewer UPDATED: Ctrl+G -> Ctrl+Shift+G : Generic Viewer UPDATED: Ctrl+Alt+C -> Ctrl+W : Close Tab (panel) UPDATED: Keybindings (major update and clean up) FIXED: Proofread and fixed spelling, etc. - Thanks to Richard Holt 1.70.0-beta2 "Afterburner" ========================== Date: 2005-11-05 ADDED: New logo, thanks to Andrew Neupokoev (nwmod) ADDED: FAQ Why do i have some trouble with the media:// protocol? ADDED: FAQ How can i close a remote connection (⪚ a FTP connection) ? ADDED: Alt+Enter keybinding, File -> Properties ADDED: you can turn off sending CDs to the terminal emulator (general tab) ADDED: our own content category on kde-files.org ADDED: useraction: View placeholder ADDED: klik protocol ADDED: useraction: ColSort placeholder ADDED: FAQ Why krusader-1.60.0 does not compile with gcc4? screenshots: import -depth 8 -dither -delay 2000 -colors 128 -resize 60% -frame filename.png pngcrush --brute filename.png ./crush/filename.png 1.70.0-beta1 "Hellfire" ======================= Date: 2005-09-27 ADDED: JavaScript interface ADDED: Quick Navigation in the Location Toolbar ADDED: checksum creation/verification mechanism ADDED: ctrl-alt-s creates a new symlink ADDED: ctrl-h opens history on the active panel ADDED: 1.70.0 (Hellfire) ADDED: appendix: release overview ADDED: FAQ, Why does the handbook not work? ADDED: MacOS-X port installation instructions ADDED: Column Headers can be changed and saved individually to each panel ADDED: Commands -> Select Remote Charset ADDED: credit for Matej Urbancic, Marketing & Product Research ADDED: Accept URL's from clipboard through middle click ADDED: permissions column as octal numbers ADDED: clear-location-bar button, konfigurator->look'n'feel ADDED: calculate space on remote filesystems ADDED: when custom filter is set, the Totals label will show the filter. example: [*.cpp] ADDED: Open the current folder in a new tab + ctrl-alt-enter keybinding ADDED: Bookmarks as action buttons on the Toolbar, thanks Googie and Shie ADDED: FAQ, Is there a Windows version? ADDED: FAQ, Is there a MacOS X version? ADDED: preserve date for local targets at copy / move ADDED: new ./configure-switches: --without-konqueror and --without-javascript ADDED: Keyboard Usage ADDED: PopUp Panel (3rd Hand) -> Viewer Panel -> is a "Thumbnail viewer" on a folder ADDED: credits for Brazilian Portuguese translation for Doutor Zero ADDED: credits for Krusader packagers ADDED: A Safari-like Jump-Back feature (Ctrl-J and in the bookmark-menu) This feature is inspired by the Snap-Back feature of Apple's webbrowser Safari ADDED: i18n help (Help Krusader) UPDATED: Distro's who include distro urls UPDATED: Remote connections UPDATED: Bookman: in kde 3.4, devices:/ is now media:/ UPDATED: new i18n page url UPDATED: mailing lists UPDATED: installation $ find /usr /opt -name qtconfig -type f 2>/dev/null $ find /usr /opt -name kdeinit -type f 2>/dev/null thanks Dirk UPDATED: Commands, Settings -> Save Position UPDATED: kgstartup.png used $ import ... -resize 60% and $ pngcrush UPDATED: Konfigurator startup page UPDATED: FAQ, Why have i trouble with my FTP connection? thanks to Peter J. [ pecko {*} pecko {.} sk] at http://www.pecko.sk UPDATED: How to obtain Krusader UPDATED: changed locate-gui shortcut from ctrl-l to ctrl+shift+l FIXED: Some manpage issues, thanks S�ke Dibbern REMOVED: RemoteMan, the FTP/SMB connection manager RemoteMan has been replaced by our new bookmark manager since Krusader 1.25-beta1 RemoteMan is disabled since Krusader-1.60.0 REMOVED: remoteman.png (NOT YET DONE IN CVS, TODO) REMOVED: Ctrl+C: Commands -> Net Connections (RemoteMan) REMOVED: Ctrl+C+N Disconnect From Net (RemoteMan) 1.60.0 ====================== Date: 2005-04-15 Final handbook revision for "Krusader 1.60.0 stable" ADDED: credit for Sven Opitz, for the first donation ADDED: credit for http://usefularts.org/ ADDED: FAQ Why mimetype magic isn't sometimes working inside archives? ADDED: credit for Gabor Lehel (illissius) ADDED: FAQ Why does &krusader; freezes on a dead mountpoint? ADDED: Help Krusader: Maintainer for porting Krusader to Windows ADDED: Help Krusader: Maintainer for porting Krusader to MacOS X ADDED: Help Krusader: UserActions ADDED: Version scheme (installation.docbook) ADDED: ACE archive note (konfigurator.docbook) ADDED: Custom Selection Mode ADDED: useraction: new placeholder: %_ListFile()% ADDED: Ctrl+z (popular url's) ADDED: useraction placeholder %_Script(path/to/script.js)% ADDED: kguseractions.png and kgprotocols.png for the HTML/RTF/PDF version ADDED: Useractions menu entry ADDED: credit for Terry "Fudoki" Wilkinson, documentation ADDED: JavaScript console (incomplete description) ADDED: Remote-man FAQ, url Bookmark transfer procedure ADDED: Remote Connections ADDED: Bookmarks Password handling ADDED: Bookmarks can be placed into the Main Toolbar and the Actions Toolbars ADDED: Popular urls in Folder History ADDED: Ctrl+Alt+j keybinding for the JavaScript console ADDED: Help Krusader ADDED: Actions Toolbar ADDED: color scheme export/import ADDED: searcher, feed to listbox (with virtual folders) ADDED: useraction placeholder %_ask(..)% ADDED: PanelSize placeholder %_PanelSize% %aPanelSize("80")% ADDED: show/hide listpanel Columns by right clicking the Column Header ADDED: Disk Usage, Alt+D ADDED: Useraction placeholders %_Each% and %_Move(src, dest)% ADDED: PopUp Panel has now a Full Viewer ADDED: Shift+DEL will delete a file permanently ADDED: inport/export keybindings (konfigurator, look & feel) ADDED: kio_krarc.* "Protocol not supported by Krusader" (FAQ) ADDED: krusader-devel-ro mailing list ADDED: Ctrl+O keybinding ADDED: This handbook is available in several formats (HTML, TXT, RTF, PDF) ADDED: resize to a small size even with Fn keys showing (FAQ) ADDED: vertical-horizontal list panel, Alt+Ctrl+v ADDED: Ctrl+Up Arrow (from the panel) goes up to the Location Toolbar ADDED: New commandline option: --profile <panel-profile> ADDED: UserAction Forum (faq.docbook), thanks Dirk ADDED: 64 bit FAQ (faq.docbook), thanks Marc on our forum http://krusader.sourceforge.net/phpBB/viewtopic.php?t=951 UPDATED: Krusader KDE version Requirements UPDATED: DTD DocBook XML V4.2-Based Variant V1.1 (V4.1.2 was the previous version) UPDATED: Synchronizer, Thanks Csaba UPDATED: UserMenu usage UPDATED: UserActions description UPDATED: krusader1.png, kgstartup.png, mountman.png, search_general.png, search_advanced.png, syncdir.png, bookmanadd.png, bookmanedit.png all screenshots in "plastic' theme (the default kde 3.4 theme), made with Imagemagic $ import -depth 8 -dither -delay 2000 -colors 128 -resize 70% -frame search_advanced.png except bookmanadd.png with KSnapshot UPDATED: first Krusader-Tools and then Konfigurator (reversed the order) UPDATED: mark (obsolete) -> select UPDATED: date format mm/dd/yyyy -> yyyy/mm/dd UPDATED: Introduction and features separated into a new chapter UPDATED: Foreword, thanks to Terry "Fudoki" Wilkinson UPDATED: Toolbar -> Main Toolbar (due to the Actions Toolbar) UPDATED: remoteman was disabled. from now on, Bookmark Manager only UPDATED: Commands - New Net Connection: FTP, SMB, FISH or SFTP connection UPDATED: mouse selection mode UPDATED: Function (FN) Keys Bar - keybindings are now configurable UPDATED: Amarok useraction, thanks Dirk (installation.docbook) FIXED: Proofread and fixed spelling, etc. - Thanks to Terry "Fudoki" Wilkinson 1.51.00 ====================== Date: 2004-11-28 Richard Holt is now an official member of the documentation team. Welcome aboard Richard! FIXED: many typos fixed - Thanks to Richard Holt 1.50.04 ====================== Date: 2004-11-19 FIXED: Proofread and fixed spelling etc. - Thanks to Richard Holt FIXED: uncommented <?xml version="1.0" ?> in index.docbook FIXED: removed some acronym elements, the jade parser does not like them FIXED: <imagedata fileref="foo.eps" ...> -> foo.png REMOVED: bookmanuse.png not used anymore since hanbook 1.00.02 ADDED: useraction: Parameter-description for the placeholder 1.50.03 ====================== Date: 2004-11-04 FIXED: doc/pics/Makefile.am did not remove krusader_title.png & tabbed_browsing.png when running 'make uninstall' ADDED: syncdir.png REMOVED: kglookfeel.png kggeneral.png kgadvanced.png kgarchives.png in cvs but not in the html documentation ADDED: FAQ: Does Krusader need KDE? UPDATED: required KDElib versions UPDATED: User Actions, thanks for the feedback Jonas Bähr FIXED: Proofread and fixed spelling, etc. - Thanks to Mark Eatough UPDATED-FIXED: many small issues 1.50.02 ====================== Date: 2004-10-25 ADDED: useraction.xml ADDED: FAQ Nvdia/libGLcore.so.1 compile problem, Thanks Falo and Rafi UPDATED-FIXED: many small issues 1.50.01 CVS ====================== Date: 2004-10-08 ADDED: MacOS-X port, Thanks Jonas ADDED: Compare Directories, Thanks Csaba ADDED: Konfigurator: arj, lha, kget ADDED: Konfigurator: protocols, Thanks Csaba ADDED: Faster navigation in bookmarks, Thanks Shie ADDED: FAQ How can i disable the default sounds, Thanks thepieman UPDATED: Synchronizer, Thanks Csaba UPDATED: Usermenu - Useractions, Thanks Jonas UPDATED: New TODO forum and NEWS forum UPDATED-FIXED: many small issues 1.50.00 CVS ====================== Date: 2004-08-15 ADDED: Synchronizer: multiple include/exclude filter example ADDED: Dropping URL's onto the status bar / totals line, Thanks Csaba ADDED: FAQ IRC channel ADDED: FAQ Debian Qt issue, Thanks Eugen Albiker ADDED: Sync-browse mode, Thanks Jonas ADDED: Usermenu, Thanks Jonas ADDED: 3rd hand of krusader, Thanks Shie REMOVED: Tree Panel, Quick View Panel -> is now "3rd hand of krusader" REMOVED: <informalexample> docbook entity in installation.sgml (gives a double console rectangle in cobination with <screen> under KDE3.2) UPDATED-FIXED: many small issues 1.40.02 ====================== Date: 2004-07-21 Final handbook revision for "Krusader 1.40 stable" ADDED: Krusader Handbook logo for the HTML version UPDATED: Konfigurator UPDATED: Credits UPDATED: KIOSlave UPDATED: Screenshots UPDATED: some obsolete issues UPDATED: Origin Button -> Location Toolbar UPDATED: usage of more default KDE Docbook entities, often located in /usr/share/apps/ksgmltools2/customization/en/ /usr/share/apps/ksgmltools2/customization/entities/ UPDATED-FIXED: many small issues 1.40.01 Date: 2004-05-17 UPDATED: RPM FAQ ADDED: FAQ How can i translate Krusader to my native language? UPDATED-FIXED: many small issues 1.40.00 ====================== Date: 2004-04-22 FIXED: Proof read and fixed spelling etc. - Thanks to Mark Eatough 1.40.00-beta1 Date: 2004-03-29 ADDED: configuring the colors of the panel - Thanks to Heiner Eichmann ADDED: Quickmode for MountMan - Thanks to Shie Erlich UPDATED: Konfigurator screenschots 1.31.01 Date: 2004-03-04 ADDED: locate (using-krusader.sgml) - Thanks to Karai Csaba ADDED: Right click menu (using-krusader.sgml) UPDATED: FAQ's "krusaderui.rc" file issue, - Thanks to Karai Csaba UPDATED-FIXED: many small issues 1.31.00 ====================== Date: 2004-02-12 From now on the <releaseinfo> tag always matches the Krusader version number that is described in the documentation, e.g., "Krusader Handbook version 1.31.xx" describes "Krusader version 1.31" ADDED: New Quicksearch (using-krusader.sgml) - Thanks to Heiner Eichmann ADDED: Folder history (using-krusader.sgml) - Thanks to Hans Loffler ADDED: appendix: configuration files (installation.sgml) UPDATED: New Konfigurator (konfigurator.sgml) - Thanks to Karai Csaba UPDATED: I try to follow the guidelines in "The KDE DocBook Authors guide" but sometimes I don't do it. ;-) UPDATED: FAQ's (faq.sgml) UPDATED: Calculate occupied space (using-krusader.sgml) - Thanks to Heiner Eichmann UPDATED: Krviewer (krusader-tools.sgml) UPDATED: new package description - Thanks to Jonas Bähr UPDATED-FIXED: many small issues Date: 01.02.2004 FIXED: Proofread and fixed spelling, etc. - Thanks to Mark Eatough Date: 06.01.2004 ADDED: User Menu (commands.sgml) - Thanks to Shie Erlich UPDATED: manpage (krusader.1) UPDATED: directory synchronisation (moved to krusader-tools.sgml) - Thanks to Karai Csaba UPDATED: From: DocBook XML V4.1-Based Variant V1.0//EN To: DocBook XML V4.1.2-Based Variant V1.1//EN 1.00.05 ====================== Date: 2003-12-21 FIXED: added package entity for compilation under KDE3.2-beta2 (index.docbook) ADDED: file splitter (using-krusader.sgml) ADDED: directory synchronisation (using-krusader.sgml) UPDATED: Commands Reference (commands.sgml) UPDATED: install procedure (installation.sgml) UPDATED: Questions and Answers (faq.sgml) UPDATED: many small issues FIXED: many small issues FIXED: spelling mistakes/typos corrections proofreading, thanks to Mark Eatough 1.00.04 ====================== Date: 2003-11-26 UPDATED: Konfigurator (konfigurator.sgml) UPDATED: KruSearcher (krusader-tools.sgml) UPDATED: Questions and Answers (faq.sgml) krarc slave issue Thanks to Karai Csaba ADDED: Key Bindings (using-krusader.sgml) ADDED: Starting Krusader (installation.sgml) ADDED: Note from the Editors (installation.sgml) FIXED: spelling mistakes/typos corrections proofreading, thanks to Mark Eatough 1.00.03 ====================== Date: 2003-11-15 ADDED: Krviewer (krusader-tools.sgml), thanks to Rafi Yanai 1.00.02 ====================== Date: 2003-10-23 KRUSADER MANPAGE: ADDED: ~/.kde/share/apps/krusader/krbookmarks.xml UPDATED: cmdline.png, fnkeys.png, krusader1.png, listpanel.png mainwindow.png, terminalEmu.png, toolbar.png (using-krusader.sgml) UPDATED: BookMan, bookmanadd.png, bookmanedit.png (krusader-tools.sgml) REMOVED: bookmanuse.png (using-krusader.sgml) [actually, not till 1.50.04 :] UPDATED: Note: RemoteMan wil be removed (krusader-tools.sgml) ADDED: tabbed browsing, tabbed_browsing.png (using-krusader.sgml) UPDATED: Tree Panel, Quick View Panel, Note: temporarily disabled since Krusader 1.12-beta1 --will be rewritten, sorry. small issues, Compare mode (using-krusader.sgml) UPDATED: Chapter 3. Command Reference (commands.sgml) ADDED: Questions and Answers (faq.sgml) Samba codepage issue Thanks to Karai Csaba ADDED: krusader_title.png (introduction.sgml) UPDATED: Introduction (introduction.sgml) Krename, Bookmark, Tabbed Browsing, Root mode, screenshot krusader1.png 1.00.01 ====================== Date: 2003-10-05 UPDATED: installation (installation.sgml) UPDATED: Frequently Asked Questions and Answers (faq.sgml) UPDATED: Credits and License (credits.sgml) ADDED: NOTE: We are busy with updating the The Krusader Handbook. (index.docbook) UPDATED: small issues, eg., KDE2.x -> 3.x (index.docbook) The Krusader Handbook is now continued and maintained by Frank Schoolmeesters. 1.00.00 ================== Date: 2002-01-01 Initial version Written by Shie Erlich and Rafi Yanai. diff --git a/doc/advanced-functions.docbook b/doc/advanced-functions.docbook index a0b335ec..fd873928 100644 --- a/doc/advanced-functions.docbook +++ b/doc/advanced-functions.docbook @@ -1,60 +1,60 @@ <!-- ********************************************************************** copyright : (C) 2000-2018 Rafi Yanai, Shie Erlich, Frank Schoolmeesters & the Krusader Krew e-mail : krusader-devel@googlegroups.com web site : https://krusader.org description : a Krusader Documentation File *************************************************************************** * Permission is granted to copy, distribute and/or modify this * * document under the terms of the GNU Free Documentation License, * * Version 1.1 or any later version published by the Free Software * * Foundation; with no Invariant Sections, no Front-Cover Texts and * * no Back-Cover Texts. A copy of the license is available on the * * GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * * Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, * * MA 02111-1307, USA. * *********************************************************************** --> <chapter id="more-features"> <title>Advanced functions &vfs; &compare; &occupied-space; &splitter; &checksum; Send Files by Email Select a file and use Right-Click menu Send by Email . Selecting this option will open a new &kmail; window with the file already attached. Just fill in the subject and recipient(s) and send it. Of course, &kmail; must be properly configured. &profiles; ACL permissions ACL permissions are fully supported when using properties, preserve attributes and the - synchronizer (disabled at the compilation time by default). To view/modify the ACL permissions, select a file + synchronizer. To view/modify the ACL permissions, select a file and use the Context Menu: Properties Permissions Advanced permissions . At Copy/Move, the ACL - permissions are also copied. The synchronizer (disabled at the compilation time by default) keeps the ACL + permissions are also copied. The synchronizer keeps the ACL permissions as well. diff --git a/doc/basic-functions.docbook b/doc/basic-functions.docbook index bfeb52e6..dde3daf7 100644 --- a/doc/basic-functions.docbook +++ b/doc/basic-functions.docbook @@ -1,451 +1,451 @@ Basic Functions Controls General This is a rather short but important section that will go into the details of controlling &krusader;. This section does not try to cover all the various key combinations for two reasons: there are just too many of them most of &krusader; actions are configurable in the Konfigurator Panel page We will only mention the most important keyboard shortcuts with the default configuration, but keep in mind that most of the Key-Bindings are configurable. If you find that you use a certain command a lot and want to know the shortcut for this command, or you want to change this command shortcut, then check out the Configure Shortcuts window (Settings Configure Shortcuts...). Moving Around By Moving Around we mean the transfer of the keyboard and mouse focus between the different parts of the &krusader; main window. The focus can be in one of five places: the Left or Right Panel, the Menu Bar, the Command Line or the Terminal Emulator. The panel that has the focus is called the Active Panel. An Active Panel will remain active until the other panel receives the focus (&ie;: if the Left Panel was active and you clicked on the Command Line - then the Left Panel remains the Active Panel). You must deliberately change which panel is active. The most common way to transfer the focus to a specific panel is to use the mouse to click on that panel. But you should be aware of the following: Clicking on the Toolbar, the FN keys bar or the Status Bar does not change the focus. Pushing the Run in Terminal Mode button in the Command Line will not transfer the focus, so you have to click inside the Input Line. When you choose a menu, the Menu Bar will become focused. It remains focused until you choose a command - the focus returns to the previous owner. There are, of course, ways to use the keyboard to change the focus: The Key will switch panels, if one of the panels has the focus or rotate between all the commands in a menu, if the Menu Bar is active. The &Ctrl; Down Arrow will take you from the Active Panel to the Command Line or Terminal Emulator, and the &Ctrl; Up Arrow will take you back from the Command Line to the Active Panel. The &Esc; Key will make the Menu Bar return the focus, if it has it, to the previous Active Panel. If you happen to be inside the Terminal Emulator, you can use the Key, or the mouse, to navigate to an Active Panel. Pressing &Alt; Underlined Letter from the Menu Bar will open that menu (unless this key combination is a "Reserved Key", used by one of &krusader;'s actions). Selecting &krusader; offers 4 Selection Modes, to say nothing about the Quickselect bar, only &krusader;'s Selection Mode is explained here. Selecting is a skill you need to master in order to get the most out of &krusader;. Since the Tree Panel allows select only one directory at a time, this paragraph mainly explains how to select files in the List Panel. Moving the cursor is easy. Left-clicking on a file or directory (referred to herein as "elements" meaning files and directories) will select it. Here are some useful pointers that will make &krusader; even easier to use (assuming you are using &krusader;'s Mouse Selection Mode): The Space and Insert keys will toggle the selection of the file under the cursor without affecting the selection of other files/directories, the cursor will go one position down. Left Clicking on a file will select, or unselect, all previously selected files. &Ctrl; Left Clicking will toggle the selection of the file under the cursor without affecting the selection of other files/directories. &Shift; Left Clicking will select all the elements between the previous cursor location and the new one. &Shift; Home selects everything above the cursor (and deselects everything below the cursor, if selected). &Shift; End selects everything below the cursor (and unselects everything above the cursor, if selected). The ".." entry is not selectable. The Edit menu can offer more ways to select your files. Executing Commands There is not a lot to say here, all you need to do is select some files (if you do not, &krusader; will operate on the file(s) or directory(s) that have the focus), choose a Command from the Menu Bar or use a Keyboard Shortcut (or the Right Click Menu) and the selected Command executes. See also Executing Files. Quick search This feature will do a quick search for the file name in the Active List Panel. Type foo(one character) to do a quick search in the Active List Panel for a file beginning with "foo". A small quick search dialog box will open below the Active List Panel. Type the first few characters of the desired file name (more than one character allowed), the cursor will jump to that filename (if it exists), ⪚ type "ab" to search for a file which begins with "ab". The Up/Down Arrow will jump to the next or previous match. &Esc; will close the quick search line. The cursor will stay on the last file found. The Quicksearch supports regular expressions for searching files. If you press &Alt; foo, the key binding shortcut will be executed. If there is no configured key binding, the remaining letter foo will be used for the quick search. Use Configure Shortcuts window (Settings Configure Shortcuts...). Quick filter This feature will do a quick filter for the file list in the Active Panel. Press &Ctrl;I to open Quickfilter bar. Type foo (one character) to filter out from the Active Panel all the files that do not have "foo" in names. You can use wildcards for the filtering. ⪚ use "a*b" to filter files which have "a" and "b" in their names. The Quickfilter follows the case-sensitivity setting of Quicksearch. Pressing &Enter; in Quickfilter mode sets focus to panel, when panel or Quickfilter is focused, &Esc; closes Quickfilter. To change the default shortcut of Quickfilter use Configure Shortcuts window (Settings Configure Shortcuts...). Quick select This feature will do a quick select for the file list in the Active Panel. Press &Ctrl;&Shift;S to open Quickselect bar. Type foo (one character) to filter out from the Active Panel all the files that do not have "foo" in names. You can use wildcards for the filtering. ⪚ use "a*b" to filter files which have "a" and "b" in their names. The Quickselect follows the case-sensitivity setting of Quicksearch. Pressing &Enter; in Quickselect mode sets focus to panel, when panel or Quickselect is focused, &Esc; closes Quickselect. To change the default shortcut of Quickselect use Configure Shortcuts window (Settings Configure Shortcuts...). Context Menu &krusader; has many Context menus that allow you to do fast operations with the mouse, usually a right-click will open the Context menu (depending on your Selection Modes settings). This list gives an overview of the most important context menus. Use them to discover the available commands. Main Toolbar (orientation, text position, icon size) List Panel on a file or directory Command Line (undo, paste, text completion...) Terminal emulator (send signal, font, history...) Folder tabs (new, duplicate, close) KruSearcher Search results file list (F3 View, F4 Edit) MountMan (unmount, format...) - Synchronize Directories File List (disabled at the compilation time by default) + Synchronize Directories File List UserActions &konqueror; Right-Click actions are shown in &krusader; Show/hide Column Headers Bookmarks enable/disable permanent bookmarks ... Basic File Management Executing Files You can only execute files in the Active List Panel. To execute a file just (double-)click on it or press &Enter; when it is under the list cursor. &krusader; will open it in the default application for this file type (picture, text file...) or the file will be executed (script, binary...). If you want to use another application to open the file, click with the &RMB; on the file and go to the Open with sub-menu which will offer more options. &krusader; is compatible with the &plasma; default file manager for all file types except archives that are opened inside the &krusader; panel and not in an external application. See the archives page in Konfigurator for details. Copying and Moving To copy or move files/directories just select them and press F5 to copy or F6 to move them. &krusader; tries to preserve the time of modification. When copying a directory owner is changed to the user which copies the directory, group is changed to the default group of the user. When copying a file owner is changed to the user which copies the file, group is changed to default group of the user, and permissions are preserved. The owner, the group and the permissions are preserved when moving file or directory. When copying or moving files/directories a dialog appears and allows you to choose the operation destination. The default destination is the other-panel browsed directory. If you enter a partial &URL;, &krusader; will use the current panel directory as the &URL; base.
Copy dialog Copy dialog
Queue manager The copy, move, pack and unpack operations can be queued. After selecting copy or move, hit F2 to use it. After selecting pack or unpack, hit F2 to use it. Or the direct shortcuts: copy by queue &Shift;F5 , move by queue &Shift;F6 . Queue manager performs actions one-by-one. For example, if you have a pen drive (which is slow), and you want to copy 40 files onto it, it is much better copying them one-by-one instead of starting to copy 40 files in parallel. That is why enqueuing is important. If you pack/unpack 40 files in parallel, you overload your computer, but adding them to a queue, is much more useful. It is possible to switch the Queue Manager mode by the Settings Job Queue Mode menu item. Deleting - move to &plasma; Trash Deleting files/directories is done by selecting them and pressing F8 or Delete. By default it will be moved to &plasma; Trash. You can open the &plasma; Trash with the Trash icon in the Main Toolbar or with the trash:/ KIO slave. Physically &plasma; Trash is located in ~/.local/share/Trash/ or Trash in the subdirectory in user home directory which can be determined using the qtpaths --paths GenericDataLocation command. &Shift; Delete will delete the file permanently. A dialog will ask for your confirmation and will warn you when deleting non-empty directories. Of course only operations that are permitted to do by the Operating System will be performed - you will be notified otherwise. If you do not wish to see the confirmation dialogs, you can disable them in the Konfigurator advanced page. Shred Files Shred was removed from &kde; 4 (and as consequence &krusader;-2 for &kde; 4). The main reason is probably that shredding is filesystem dependent and even if you overwrite the file 100 times, it is not sure, that it will be deleted from the disk finally. Quote from the kgpg posts: The shred feature has been removed from the KDE library. Kgpg will not support this feature anymore. Moderns file systems use journalisation. So the shred feature should be implemented in the file system. Not in kgpg. But you might use a proper shred UserAction for your filesystem. But keep in mind that if you want to be 100% sure that it is impossible that someone can read a deleted file, you need to destroy your harddrive hardware... Renaming Files, Creating Directories and Link Handling Rename the file under the cursor with the F2 key or with two single mouse clicks. If only the file name needs to be renamed and not the extension, you can configure this in the Konfigurator General page. Create a new directory with the F7 key. Right-clicking on a regular file will give you the option Link Handling New Symlink. A dialog will prompt you to enter a symlink name. That symlink will point to the file/directory you right-clicked on. If the file you right-clicked on is a symlink, you will also be presented with the Link Handling Redirect Link option that will allow you to change the link target. Viewing and Editing files KrViewer has a chapter of its own. &archives; diff --git a/doc/bookmarks.docbook b/doc/bookmarks.docbook index 4d62f633..54fca63e 100644 --- a/doc/bookmarks.docbook +++ b/doc/bookmarks.docbook @@ -1,291 +1,291 @@ BookMan: Organize your Bookmarks Bookmarks BookMan is &krusader;'s Bookmark tool for bookmarking folders, local and remote URLs, and later returning to them in a click of a button. The Bookman menu is divided into four sections: Your personal bookmarks Popular &URL;s Permanent bookmarks Manage bookmarks You can bookmark inside a remote file system (&FTP; or SAMBA) and later use the bookmark to quickly connect to the remote machine, but you cannot bookmark inside an archive.
Bookmark menu Bookmark menu
Using Bookmarks Usually, you click on the BookMan II button (the rightmost button to the right of the address bar at the top of the active panel) when you are in the target folder. For example, to bookmark /usr/tmp, navigate &krusader; there and click the BookMan II button and select Bookmark Current. When the Add Bookmark dialog box appears, the &URL; line will say /usr/tmp. Name is for the name you would like to give to the bookmark (⪚: temporary folder). Hotkeys are supported by adding & to the bookmark name ⪚ &sourceforge, &home, down&loads &etc;, so you can quickly call the bookmark name with &Alt; foo. If you add the bookmark without entering a name, the bookmarks name will be the same as its target. URL is where the bookmark points to. Create in creates bookmark folders for organizing your bookmarks. To use your bookmarks, click the BookMan II button and choose a bookmark. You may also use the Key-Bindings: &Ctrl; B to bookmark the current item, &Alt; right/left arrow to open right/left panel bookmarks list and &Ctrl; D to open the bookmarks of the active panel. From the context menu of the bookmark (&RMB; click) you can open it in a new Folder tab. Navigation in bookmarks: Start typing letters ⪚ when you type 'h' and only one bookmark starts with 'h', it is executed immediately - no enter needed If more than one bookmarks begins with 'h', you will have to continue adding letters, until you have specified enough and again, the bookmark is executed. The search bar will always be visible in the bookmarks menu if you check the corresponding item on the Panel Konfigurator's page. Password handling One of the benefits of the bookmark manager is that the passwords are saved using &plasma;'s services - where ⪚ your &konqueror;/&kmail; password are saved. If you have a wallet, &plasma; will save the passwords there. By clicking the bookmarks, a dialog will open and ask for your username and password. Supply them and click Save password. The passwords and usernames will be saved securely by &plasma;'s wallet (make sure it is enabled by your distro). The downside here is that if the system was reinstalled and you do not backup your passwords from the wallet as well as &krusader;'s bookmark file, something will be lost. Popular URLs Popular URLs The submenu Popular URLs holds persistent the most popular visited &URL;s (local or remote). This submenu displays the top 15 popular URLs, sorted by ranking, so that the top &URL; is the most popular. This is easy for when you need to visit &URL;s often, but do not want to create Bookmarks, it serves as a temporary bookmark list for the most visited links. Quicksearch in Popular URLs is a fast way to browse/select the popular &URL;s: Open the Popular URLs or use &Ctrl; Z Type a few letters to narrow the search Press &Enter; (you will go to the &URL; from list) Permanent bookmarks These are hardcoded bookmarks to the top bookmark menu; there is no need for them to be saved to the file. With the Context Menu you can enable/disable these permanent bookmarks. The following permanent bookmarks are available: Trash bin uses &plasma;'s trash:/ protocol. Local Network uses &plasma;'s remote:/ protocol. Virtual Filesystem Virtual file systems (VFS) virt:/ is not a virtual folder, but a container for &URL;s from different file systems. It is used for ⪚ the Feed to Listbox feature of the search - module and the synchronizer (disabled at the compilation time by default). The location toolbar will + module and the synchronizer. The location toolbar will display ⪚ virt:/Search results 1 or virt:/Synchronise results 1. Jump back or &Ctrl; J brings you back to your starting position when you did create a new tab in the panel window. This feature is very handy if you go deep into a directory tree, then you can return with one action to the starting point. With Set jump back point here or &Ctrl;&Shift; J sets the current directory as a jump back point. Manage bookmarks To edit and organize your bookmarks, by clicking the BookMan II button and selecting the Manage Bookmarks, KeditBookmarks will be displayed. This is where you can edit/remove and rearrange the bookmarks. KeditBookmarks is a bookmark editor for &konqueror;, &krusader; and other applications, which use the XBEL standard for the bookmark format. The bookmarks are stored in ~/.local/share/krusader/krbookmarks.xml. The default folder for the bookmarks file krusader/krbookmarks.xml is ~/.local/share. You can determine the needed folder in your system using the qtpaths --paths GenericDataLocation command in terminal. This local file exists only if you have edited &krusader; bookmarks. It will be created after the first run of KeditBookmarks from &krusader;. The default system bookmarks are stored in the kfileplaces/bookmarks.xml file in the directory which can be determined using the qtpaths --paths GenericDataLocation command. KeditBookmarks is easy to use, however, if you need more information, please read the KeditBookmarks handbook.
<application>KeditBookmarks</application> Bookmark Manager KeditBookmarks Bookmark Manager
Bookmarks as action buttons on the Toolbar Bookmarks can be placed as buttons on the Main Toolbar or the Actions Toolbar. You can even make a key-binding for them: Create your Bookmarks. If you want, create keybindings for the bookmarks in the Configure Shortcuts window (Settings Configure Shortcuts...). Add your bookmarks as action buttons on the Main Toolbar or the Actions Toolbar with the Configure Toolbars window (Settings Configure Toolbars...). diff --git a/doc/compare.docbook b/doc/compare.docbook index 90260a34..e2aa3007 100644 --- a/doc/compare.docbook +++ b/doc/compare.docbook @@ -1,105 +1,105 @@ Compare &krusader; contains several compare functions: Compare by Content, Compare Directories and the Synchronizer compare - function (the latter is disabled at the compilation time by default). + function. Compare by Content Compare Content Select one file in each panel and use File Compare by content . &krusader; will open an external graphical difference tool that is configured. &kompare;, KDiff3 and xxdiff are supported. Compare Directories Compare Directories Compare the files of each panel by using Edit Compare Directories . By default newer and single files will be selected in each panel, this behaviour can be changed in the Compare Setup menu. The files are not compared by content but by their names and dates only. Edit Compare Setup Configures the Compare Directories function. Select Newer and Single (default) Select Single Select Newer Select Different and Single Select Different diff --git a/doc/features.docbook b/doc/features.docbook index bd05c7f2..75b39325 100644 --- a/doc/features.docbook +++ b/doc/features.docbook @@ -1,519 +1,519 @@ Features Features The most important features and improvements are highlighted here, it would make this list too long if we were to include all the features and improvements. You will discover even more features in this documentation and in the ChangeLog and NEWS files. <ulink url="http://www.softpanorama.org/OFM/index.shtml">Orthodox File Manager (OFM)</ulink> features Two powerful and easy to use OFM panels. Command Line and optional Terminal emulator below. Strong keyboard orientation and the ability to perform all functions without the mouse. Context-dependent invocation of scripts and programs ⪚ mouse click/&Enter; (execute or open with the associated application), F3 (view) and F4 (edit). User Menu, create your own customized menu. History ⪚ Folder History, Popular &URL;s, &etc; Virtual file systems (VFS) ⪚ for Remote Connections, archives, search results, - synchronizer (disabled at the compilation time by default). + synchronizer. Powerful internal viewer and editor via kparts supporting almost every file format. Advanced Search module: searching in archives and search content on remote file systems. Several Panel view modes via the Sidebar. &krusader; tools Remote Connections: &FTP;/SAMBA with SFTP/SCP support via KIO Slaves Locate &GUI; frontend - Synchronize Directories (disabled at the compilation time by default) + Synchronize Directories Mount-Manager Disk Usage Root mode &krusader; features Archive Handling: browsing, unpack, pack, testing. Supported archives: ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip and 7-zip. Checksum Creation and Verification mechanism that supports md5, sha1, sha256, sha224, sha256, sha384, sha512, tiger, whirlpool, cfv, and crc. Calculate occupied space of files and folders, archives and remote filesystems. Directory comparison and filtering. Compare files by content via external diff programs like &kompare;, KDiff3 or xxdiff. Rename files and folders via KRename Completely supports drag'n'drop: drag from &konqueror; straight into a .tar.gz file, from &krusader;'s panel into the trash bin, the desktop or into &konqueror; Preserve date for local targets at copy/move operations. F9 opens a Terminal Window in the current directory. Easy editing of file permissions and ownership and Numeric Permissions. Selection - filters used in ⪚ Synchronizer (disabled at the compilation time by default) and + filters used in ⪚ Synchronizer and KruSearcher. Jump-Back MIME type-aware. Tabbed panels and Tabbed Editor/Viewer. Quick search, select and filter File splitter Mouse Gestures Quick Navigation in the Location Toolbar. WhatsThis Help function in favour of tooltips where reasonable. Sync-browsing Customize &krusader; to your own needs Konfigurator &krusader;'s configuration center. Main Toolbar, Actions Toolbar for user actions and bookmarks. Key-bindings Colors Panel profiles Bookmark-Manager Selection Modes Many more features can be configured the way you like. &krusader; Extensions UserActions Color Profiles Key-binding Profiles Download and upload your favourite &krusader; extensions at store.kde.org. New features in the &krusader;-1.80.0 "Final 3rd Stone" release Archive improvements Password support for: arj, ace, rar and zip. Passwords can be stored in Kwallet 7-zip support, by external applications 7z and 7za. Auto-detection support, allowing you to open "hidden archives" (⪚ OpenOffice documents). Packing/unpacking is now in the background. Brief View Many improvements of the UserAction system. Countless usability enhancements, especially in Konfigurator and the heavily reordered menubar. Media button Copy/Move: preserve all attributes (time, owner, group). Dim the colors of the inactive panel. Renaming a filename without extension, single instance mode, start to system tray, check this out in Konfigurator Configurable Atomic extensions, so that extensions like .tar.gz are shown as one part in the Ext Column. Context menu for bookmarks and enable/disable special bookmarks. Restyled MenuBar Terminal emulator enhancements bringing new functions, new usages and new look. Synchronizer enhancements and parallel threads for slow - &FTP; servers (now disabled at the compilation time by default). + &FTP; servers. Single instance mode, start to system tray Context menu for permanent bookmarks. Full support for ACL permissions, like properties, preserve attributes, synchronizer and other. Searcher-results, Locate-results, Synchronizer-results: support for dragging items and copy to clipboard (&Ctrl;C). Many bug fixes. New features in the &krusader;-1.90.0 "Power Stone" release Last release for &kde; 3.x with a big collection of Useractions. New features in the &krusader;-2.0.0 "Mars Pathfinder" release The first release for the &kde; 4.x series &krusader; works on &Windows;! (But not so useful and powerful yet as under &Linux;) Queue manager! Five methods in the panel! New features in the &krusader;-2.1.0-beta1 "Rusty Clutch" release Fast text/hex viewer for huge filesizes. Locked tabs. Queued packing / unpacking. Better trash integration. The quick search, select and filter bar supports regular expressions for matching files. New features in the &krusader;-2.5.0 "Clear Skies" release Ported to &kf5-full;. The new Quickfilter bar with three different modes to operate: select, search and filter. Reworked Queue Manager (JobMan) and the new Job Toolbar. New features in the &krusader;-2.7.0 "Peace of Mind" release Quick Search in Bookmark menu. Pinned tabs. Tooltip with file information when you hover a file name. Extended options for Tree Panel at the Side Bar. If you are using a development or Git version, it is possible that the latest new features are not yet in the "The &krusader; Handbook". Please read the Changelog file online or in the &krusader; sources to find out more about the new features. For a brief description, please read the NEWS file online or in the &krusader; sources. User feedback and Bug reports are always welcome! diff --git a/doc/keyboard-commands.docbook b/doc/keyboard-commands.docbook index a8b832ed..113e0ac8 100644 --- a/doc/keyboard-commands.docbook +++ b/doc/keyboard-commands.docbook @@ -1,2020 +1,2015 @@ Keyboard Commands Commands Keyboard Keyboard Usage In this chapter you will learn how to use the keyboard effectively, because most operations can be done more quickly by keyboard than with the mouse. It will take some time to learn the Key-Bindings, but mastering them saves you a lot of time. Please note that &krusader; can use Key-binding Profiles to swap easily to other Key-binding setups, ⪚ of other commanders, or you can create your own key-bindings. After starting &krusader;, the keyboard action can begin. Use &Ctrl;L to jump to the Location Toolbar where you can type the desired directory. After &Ctrl;Down arrow you are in the Terminal emulator and you can type any command you desire. Use &Ctrl;Up arrow to jump back to the active panel. If you want to jump to a file or directory that starts with f, then simply press f on the keyboard to use the search bar. Use the &Enter; key to execute the file or to open a directory that has the focus. Be sure to remember the Function Keys - F3 to View, F4 to Edit, F5 to Copy, &Alt;&Shift;U to Unpack, &etc; You can also perform several operations with the Folder tabs, including several selection operations. And at the end you can close &krusader; with F10. Key-Bindings Key-Bindings Commands Keyboard Most of the key-bindings (shortcuts) are configurable in the Settings Configure Shortcuts menu, if you like to use other key-bindings then the default ones. You can even configure more actions to a Key-Binding (for the actions that do not have a key-binding set by default). Please note that some key-bindings are not &krusader; key-bindings (⪚ &plasma; key-bindings). The key-bindings that &krusader; uses by default are listed below. Function (FN) Keys These are the Key-Bindings of the FN Keys Bar. These Key-Bindings are configurable since version 1.51. F1 Help F2 Rename files. F3 View files. F4 Edit files. F5 Copy files. F6 Move files F7 Create a new directory. F8 Delete (or move to Trash) files. F9 Terminal. F10 Quit &krusader; &Shift; keys &Shift; F1 What's this? &Shift; F2 Multi-rename (Krename). &Shift; F3 Enter an &URL; to view. &Shift; F4 Edit new file. &Shift; F5 Copy by queue. &Shift; F6 Move by queue. &Shift; F10 View all files. &Shift; F12 Custom view files. &Shift; Left Arrow Change to left folder tab. &Shift; Right Arrow Change to right folder tab. &Alt; keys &Alt; + Select All. &Alt; - Unselect All. &Alt; * Invert Selection. &Alt; . Show/Hide hidden (dot) files. &Alt; / MountMan. &Alt; ` User Menu &Alt; Home Home &Alt; &Enter; Properties. &Alt; Left Arrow Left bookmarks. &Alt; Right Arrow Right bookmarks. &Alt; Down Arrow Sidebar. &Alt; F1..F12 Standard (&plasma;) key-bindings. &Alt;+&Shift; keys &Alt;&Shift; B Brief View &Alt;&Shift; C Compare Directories &Alt;&Shift; D Detailed View &Alt;&Shift; E Test Archive. &Alt;&Shift; K Start Root mode &krusader;. &Alt;&Shift; L Panel profiles. &Alt;&Shift; O Sync panels aka "Equals Button (=)". &Alt;&Shift; P Pack files. &Alt;&Shift; Q Queue Manager &Alt;&Shift; S Disk Usage. &Alt;&Shift; U Unpack files. &Ctrl; keys &Ctrl; B Add bookmark for the current item. &Ctrl; D Open Bookmarksin the active panel. &Ctrl; E Edit file as root (Default Useraction). &Ctrl; F Open Quicksearch bar. &Ctrl; H Open History list in the active panel. &Ctrl; I Open QuickFilter bar. &Ctrl; J A Safari-like Jump-Back. &Ctrl; L Go to the Location Toolbar (origin) as in Firefox and &konqueror;. &Ctrl; M Open media list. &Ctrl; N New Network Connection dialog. &Ctrl; O Select directory dialog to open this directory in the panel. &Ctrl; P Split file. &Ctrl; Q Quit &krusader;. &Ctrl; R Reload (Refresh) panel. &Ctrl; S Search. &Ctrl; U Swap panels (do not swap all folder tabs). &Ctrl; W Close Current tab. &Ctrl; Y - Synchronize Directories (this feature is disabled at the compilation time by default). + Synchronize Directories. &Ctrl; Z Popular URLs. &Ctrl; + Select group. &Ctrl; - Unselect group. &Ctrl; / Open command line history list. &Ctrl; Down arrow Go from the active panel to the command line/terminal emulator. &Ctrl; Up arrow Go from the command line/terminal emulator to the active panel. &Ctrl; Up arrow Go from the active panel to the Location Toolbar. &Ctrl; Home Jump to the Home directory. &Ctrl; Left or Right arrow Focus a file or directory on the left panel, press &Ctrl; Left arrow and the right panel changes: on a file: the right panel gets the same path as the left panel. on a directory: refreshes the right panel with the contents of the directory. For the right panel: press &Ctrl; Right arrow and the left panel will change. &Ctrl;&Backspace; Jump to the Root directory. &Ctrl; PageUp Up one directory. &Ctrl; = Go to the directory from other panel. &Ctrl; Return When media menu is open (un)mounts the highlighted device. &Ctrl;+&Shift; keys &Ctrl;&Shift; D Disconnect remote connection. &Ctrl;&Shift; F Activate search bar to find entries in the active tab. &Ctrl;&Shift; J Set jump back point. &Ctrl;&Shift; L Locate &GUI; frontend. &Ctrl;&Shift; O Move current tab to other side of the window. &Ctrl;&Shift; S Open Quickselect bar. &Ctrl;&Shift; U Swap Sides (also swap all folder tabs). &Ctrl;&Shift; Left arrow Open left media list. &Ctrl;&Shift; Right arrow Open right media list.. &Ctrl;&Shift; Up arrow Open terminal emulator, independently, whether the command line is shown or not. &Ctrl;&Shift; Down arrow Close terminal emulator, independently, whether the command line is shown or not. &Ctrl;+&Alt; keys &Ctrl;&Alt; M Mount (Default Useraction). &Ctrl;&Alt; N New tab. &Ctrl;&Alt; R Toggle the List Panel between horizontal and vertical mode. &Ctrl;&Alt; S Create a new symlink. &Ctrl;&Alt; T Show/hide the embedded terminal. &Ctrl;&Alt; Left Arrow Left History list. &Ctrl;&Alt; Right Arrow Right History list. &Ctrl;&Alt; = Equal Panel Size (Default Useraction). &Ctrl;&Alt;&Shift; N Duplicate a tab. &Ctrl;&Alt;&Enter; Open current folder in a new tab. General &Ctrl; keys &Ctrl; A Select all. &Ctrl; PageDown Move to the lower part in the current directory. &Ctrl; F1..F12 Standard (&plasma;) key-bindings. &Ctrl;&Shift; F1..F12 Standard (&plasma;) key-bindings. Other keys foo Quick search, quick select or quick filter. See this configuration page on how to configure the default mode. Switch between the panels &Enter; On a file: open/execute that file On an archive file: browse the archive as if it was a directory. &Esc; Will make the menu bar lose the focus if it has it. Delete Delete (or move to Trash). &Shift; Delete Delete permanently. Space On a file: toggle the selection of the file down one position without affecting the selection of other files/directories. &Backspace; One directory up. Insert Does the same as the Space key and goes down one position to toggle the next file. Menu Right-click menu. Home Cursor jumps to the top of the list. End Cursor jumps to the last file in the list. Command Line Command Line keybindings. Up arrow and Down arrow Scroll through previously typed commands. &Ctrl; / Open the command line history list. &Ctrl; Up arrow Jump from the command line to the active panel. &Ctrl; Down arrow Jump from the active panel to the command line. &Ctrl;&Enter; Insert current file / directory name without path to current command line position. &Ctrl;&Shift;&Enter; Insert current file / directory with full path name to current command line position. Terminal emulator Terminal emulator keybindings. &Ctrl; F Toggle between normal and full screen Terminal emulator. &Ctrl; V Insert from clipboard. &Ctrl; Up arrow Jump from the Terminal Emulator to the active panel if the Command line is hidden. &Ctrl; Down arrow Jump from the active panel to the Terminal Emulator if the Command line is hidden. &Ctrl;&Shift; Up/Down arrow Always focus/unfocus the Terminal Emulator independently whether the Command Line is shown or not. &Shift; Insert Insert from clipboard. Synchronizer - - - This feature is disabled at the compilation time by default. See the corresponding chapter of this manual for the instructions on how to enable it. - - Synchronizer keybindings. &Ctrl; W Reverse direction &Alt; Down arrow Exclude &Alt; Up arrow Restore original task &Alt; Left arrow Copy to left &Alt; Right arrow Copy to right &Alt; Delete Mark for delete Default Useractions Default UserActions keybindings provided by &krusader;. &Ctrl; E Edit a file as root. &Ctrl;&Alt; C Copy current item to clipboard. &Ctrl;&Alt; M Mount a new file system. &Ctrl;&Alt; = Equal panel-size. Meta A Enqueue in &amarok;. Meta 1 Sort by Name. Meta 2 Sort by extension. Meta 3 Sort the active panel by size. Meta 4 Sort by modified. Meta F5 Backup current file (Default Useraction). Other Key-bindings Selecting files KrViewer Disk Usage Locate &GUI; frontend &systemsettings; -> Common Appearance and Behavior -> Shortcuts and Gestures UserActions configurable key-bindings diff --git a/doc/konfigurator.docbook b/doc/konfigurator.docbook index 44a77592..ccf4f3d9 100644 --- a/doc/konfigurator.docbook +++ b/doc/konfigurator.docbook @@ -1,2064 +1,2064 @@ Konfigurator: &krusader;'s Configuration Center Configure Krusader Konfigurator is &krusader;s configuration center. When running &krusader;, use Settings Configure &krusader; , and it will start Konfigurator. There you can modify the way &krusader; works and customize it to your own needs. At any time, pressing the Apply button applies the changes, pressing Close closes Konfigurator, and pressing Defaults re-applies &krusader;'s "factory" settings. Konfigurator is divided into pages, each containing items related to that page. For some changes to the &GUI;, you have to close and restart &krusader;. Since &krusader;-1.80.0 the Key-Bindings and Main Toolbar-Actions Toolbar have received their own configuration windows and so they are not a part anymore of Konfigurator, you can configure them now via the Settings menu. Startup
Startup configuration Startup configuration
The startup page determines the way that &krusader; looks (and works) when it is launched. It is divided into two main parts: General Startup Profile: Starts the selected Panel profile at startup. <Last session> is a special Panel Profile, it is saved automatically when closing &krusader;. Show splashscreen: Displays a splash screen when starting &krusader;. Single Instance Mode: Allows only one &krusader; instance to run. Fallback Icon Theme: Allows you to configure a fallback icon theme for &krusader;. Whenever icon is not found in system icon theme, this theme will be used as a fallback. If the fallback theme does not contain the icon, Breeze or Oxygen will be used if any of these are present. User Interface Determines which parts of the user interface are visible after start-up. Save last position, size and panel settings: When launched, &krusader; resizes itself to the size it was when last shut-down. &krusader; also appears in the same location on the screen, having panels sorted and aligned as they were. If this option is unchecked, you can use the menu Window Save Position option to manually set &krusader; size and position at start-up. Update default panel settings: If checked, the default panel settings will be updated after start-up. Start to tray: if checked, &krusader; starts to tray (if minimize to tray is set), without showing the main window. Save component settings on exit: If checked, restores the user interface components to their condition when last shut-down. Show function keys: If checked, the FN Keys Bar is visible after start-up. Show statusbar: If checked, the Statusbar is visible after start-up. Available only if the Save component settings on exit item is unchecked. Show command line: If checked, the Command Line is visible after start-up. Available only if the Save component settings on exit item is unchecked. Show embedded terminal: If checked, the Terminal emulator is visible after start-up. Available only if the Save component settings on exit item is unchecked. Panel Here you can determine the look and feel of panel - which means finetuning the application to your needs. The page is divided into six tabs: General, View, Buttons, Selection Mode, Media Menu, and Layout: General <guilabel>Navigator bar</guilabel> Edit Mode by default: If checked, show editable path in Navigator bar by default. Show full path by default: If checked, always show full path in Navigator bar by default. <guilabel>Operation</guilabel> Autoselect Directories: When you select a group of files (either by using Select Group or by using Select All), &krusader; checks this option. If checked, the directories matching the select criteria are also selected. Otherwise, only files are selected. Rename selects extension: When you rename a file, the whole text is selected. If you want total commanderlike renaming of just the name, without extension, deselect this item. Unselect files before copy/move: If checked, &krusader; remove the selection marks from files or folders before copying or moving them to the new location. Filter dialog remembers settings: If checked, the filter dialog will be opened with the last filter settings that where applied to the panel. <guilabel>Tabs</guilabel> Use fullpath tab names: If checked, display the full path in the Folder tabs; otherwise only the last part of the path is displayed. Show new/close tab buttons: If checked, &krusader; displays new and close buttons on tabs. Tab Bar position: Lets you choose Tab bar position (Bottom or Top). Show Tab Bar on single tab: If checked, &krusader; displays the Tab Bar even if there is only one tab on the panel. <guilabel>Search bar</guilabel> Start by typing: allows to select if quick search feature is used. When checked, you can open search bar and start searching by typing something while viewing folder contents in the active panel. Case sensitive: When you use the search or filter feature: If checked (the &UNIX; default), all files beginning with capital letters appear before files beginning with lower case letters; otherwise, all files beginning with a specified letter (capital or otherwise) will be displayed together. Up/Down cancels search: Pressing Arrow Up or Arrow Down cancels search bar. Directory navigation with Right Arrow: If checked, pressing the Right arrow key enters directory if no search text editing intention is captured. Position: Lets you choose search and filter bar position (Bottom or Top). Default mode: Lets you choose the search bar default mode between Search, Select and Filter. You can change the mode later using the search bar itself. <guilabel>Bookmark Search</guilabel> Always show search bar: If checked, make bookmark search bar always visible. Search in special items: If checked, bookmark search is also applied to special items in bookmark menu like Trash, Popular URLs, Jump Back, &etc; <guilabel>Status/Totalsbar</guilabel> Show size in bytes too: If checked, &krusader; displays size in bytes on statusbar or totalsbar. Show space information: If checked, &krusader; displays free/total disk space in the Status-/Totalsbar. View <guilabel>General</guilabel> View font: Allows you to change the font used inside the file lists. Tooltip delay (msec): Allows you to configure the delay in milliseconds between the moment you have stopped mouse pointer above an item in a file list and the moment when the tooltip will be shown. Use human readable file size: If checked, the file size appears in kB, Mb &etc;, and not in bytes (default). Numeric permissions: Permission column (Panel View tab) shows octal numbers '0755' instead of 'rwxr-xr-x'. Show hidden files: If checked, &krusader; displays the "dot-files" which are otherwise hidden. Load the user defined folder icons: If checked, &krusader; loads the user defined folder icons. Always show current item: If checked, &krusader; shows current item border decoration in inactive panel. Sort method Krusader (default): the comparison used so far. Uses comparison using locale rules (even context rules). Alphabetical: strings are compared character by character (no context rules from locale applied). Alphabet characters are compared using locale rules, special characters are compared by the character code. Alphabetical and numbers: the same as above, but if the names contains numbers, the numbers are compared numerically instead of alphabetically. Character code: comparison by character code (quick). Character code and numbers: the same as above, but with numerical comparison of numbers. Case sensitive sorting: If checked (the &UNIX; default), all files beginning with capital letters appear before files beginning with non-capital letters; otherwise, all files beginning with a specified letter (capital or otherwise) appear together. Always sort dirs by name: Sorts directories by name, regardless of the sort column. Show directories first: If checked directories have precedence in folder lists. Locale aware sorting: Sorts files and directories according to the current locale settings. <guilabel>View modes</guilabel> Default view mode: Allows you to change the default view mode. You can choose Detailed View or Brief View. On tabs of both view modes you can define the following options. Default icon size: Allows you to change the size of the icons in the file lists. The available sizes are 16x16, 22x22, 32x32 and 48x48 pixels. Use icons in the filenames: If checked, show the icons in file names and folders. Show previews by default: If checked, show the previews of file contents. To configure the columns use the right click menu in the panel when viewing files. The left and right panel use their own columns independently. The following columns are available: Name: Shows the filename without the part after the last dot, this latter part is displayed in the Ext column. When the Ext column is made hidden, the complete filename is shown in the Name column like ⪚ &konqueror; does. Ext: Shows the last part of the filename (the part after the last dot) in the Ext column, and not as a complete filename in the Name column like ⪚ &konqueror; does. Type: Shows the MIME type field. Size: Shows the size field. Modified: Shows the modified date and time field. Perms: Shows the full permissions ⪚ "rwxr-xr-x" or as octal numbers '0755' instead with enable/disable Numeric Permissions in Panel View Tab. rwx: Shows only the rights of the current user ⪚ "-rw". Owner: Shows the owner field. Group: Shows the group field. Uncheck the columns not in use. This allows more space for columns in use. Buttons Toolbar buttons have icons: If checked, &krusader; displays icons on toolbar buttons. Show Media Button: If checked, &krusader; displays media button. Show Back Button: If checked, &krusader; displays back button. Show Forward Button: If checked, &krusader; displays forward button. Show History Button: If checked, &krusader; displays history button. Show Bookmarks Button: If checked, &krusader; displays bookmarks button. Show Panel Toolbar: If checked, &krusader; displays the Panel Toolbar. You can make the buttons on the Panel Toolbar visible or hidden: <guilabel>Visible Panel Toolbar buttons</guilabel> Equal button (=) Up button (..) Home button (~) Root button (/) Toggle-button for sync-browsing: If checked, shows the Sync-browsing button. Selection Mode Here you can configure the selection modes. <guilabel>General</guilabel> &krusader; Mode: The way &krusader; has worked from day one. Both mouse keys allow selecting files. To select more than one file, hold the &Ctrl; key and click the &LMB;. Right-click menu appears with a short click on the &RMB;. Konqueror Mode: pressing the &LMB; selects files -- you can click and select multiple files. Right-click menu appears with a short click on the &RMB;. Total commander Mode: Pressing the &RMB; selects multiple files and the right-click menu appears with pressing and holding the &RMB;. The Left Mouse Button does not select, but sets the current file without affecting the current selection. Ergonomic Mode: The &LMB; does not select, but sets the current file without affecting the current selection. The &RMB; invokes the context-menu. You can select with &Ctrl; key and the left button. Custom Selection Mode: Create your own selection style! <guilabel>Details</guilabel> Double-click selects (classic): A single click on a file will select and focus, a double click opens the file or steps into the directory. Obey global selection policy: Pressing the &LMB; selects files -- Use global setting: &plasma; System Settings -> Input Devices -> Mouse. Custom Selection Mode items: Based on &plasma;'s selection mode Left mouse button selects Left mouse button preserves selection &Shift;/&Ctrl;-Left mouse button selects Right mouse button selects Right mouse button preserves selection &Shift;/&Ctrl;-Right mouse button selects Spacebar moves down Insert moves down Right-clicking pops context menu immediately Media Menu Using this tab you can select the Media button menu contents: Show Mount Path: show the mount path of partition if checked. Show File System Type: show the file system type of partition if checked. Show Size: allows selection of the size representation in media menu. Can be Always (default, always show the size of partition), When Device has no Label (show the size for partitions with no label only) or Never (never show the size in media menu). Layout You can choose the layout and frame settings: Layout: allows to define layout. The default options are Default, Compact, and Classic. Frame Color: defines frame color. Can be Defined by Layout, None, or Statusbar. Frame Shape: defines frame color. Can be Defined by Layout, None, or Statusbar. Frame Shadow: defines frame color. Can be Defined by Layout, None, or Statusbar. Colors This page configures the colors of the List Panel and the - Synchronizer (disabled at the compilation time by default). The + Synchronizer. The KDE default colors is the default color configuration. General Use the default KDE colors: this is the default, it uses &plasma; color defined in the &systemsettings;. Use Alternate Background color: If checked, the Background color and the Alternate background color alternates line by line. When you do not use the &plasma; default colors, you can configure the alternate colors in the Colors box. Show current item even if not focused: If checked, shows the last cursor position in the non active list panel. This option is only available when you do not use the &plasma; default colors. Dim the colors of the inactive panel: If checked, the colors of the inactive panel are dimmed. These settings can be configured in the Inactive tab of the Colors box. This option is only available when you do not use the &plasma; default colors. Colors Configure the colors the way you like, you can see the result in the Preview section. The following items of the active and inactive panel can be configured: Foreground Directory foreground Executable foreground Symbolic link foreground Invalid symlink foreground Background Alternate background Selected foreground Selected background Alternate selected background Current foreground Selected current foreground Current background The following items of the - Synchronizer (disabled at the compilation time by default) can be configured: + Synchronizer can be configured: Equals foreground Equals background Differing foreground Differing background Copy to left foreground Copy to left background Copy to right foreground Copy to left background Delete foreground Delete background Preview Here you see a preview of the configured colors. Color schemes With the Import Color Scheme and Export Color Scheme buttons you can load and save a Color Scheme profile. This allows &krusader; to use Total Commander, Midnight Commander, foo-commander or your own custom color profile. The Color Schemes are stored in /usr/share/krusader, the foo.color is a binary file that holds the color scheme. Midnight Commander and Total Commander Color scheme files are provided. Please upload your favorite Color schemes so that they become available for the &krusader; community. Thanks! General Here you configure the basic operations. The page is divided into three tabs: General, Viewer/Editor, and Atomic extensions. General The following options determine basic aspects of operation: Warn on exit: if checked, &krusader; warns you every time when exit action is triggered. Minimize to tray: If checked, the &krusader; icon will appear in the system tray. When you minimize &krusader;, it will not appear in the taskbar. It also will not exit if you close the main window. Instead you can quit &krusader; by selecting Quit from the File menu or the context menu of the tray icon. Use MIME type magic: MIME type magic is a mechanism which allows &krusader; to inspect the files in the panels and determine their type even if the file has no identifying extension. For example, if you take an image file - image1.jpg - and rename it to image1, &krusader; will still know it is an image file and work with it accordingly. However, this mode of operation is slower (while refreshing the panel, or changing directories), so try &krusader; with and without MIME type magic and decide what is best for you. Temp Directory: this option selects the base directory for &krusader;'s temporary files. The actual files will be created in separate directories under the 'Temp directory', so that each user running &krusader; will have their own temporary subdirectories under the chosen directory. You must choose a temporary directory to which all users running &krusader; have full permissions! Delete mode (Delete files/Move to trash): when &krusader; deletes files it can either really delete them or move them to the trash folder, thereby making them available via &plasma;'s trash. External Terminal: choose which terminal emulator will be used when &krusader; opens a console window (via F9, or Tools Start Terminal menu option). Embedded Terminal sends Chdir on panel change: if unchecked, there will be no cd command sent to the Terminal Emulator if the panel folder changes. Toggle Fullscreen Embedded Terminal: if checked, &krusader; shows fullscreen terminal in Midnight Commander style (Terminal is shown instead of &krusader; window). Viewer/Editor Here you can change the viewer and editor settings: Internal editor and viewer opens each file in separate window: check this item if you want each file to be opened in separate window. Default viewer mode: Generic mode: use the systems default viewer. Text mode: view the file in text-only mode. Hex mode: view the file in hex-only mode. Lister mode: Fast text/hexadecimal viewer for huge filesizes. &krusader; lister never loads the whole file into memory, just a little part of it, and uses caching for faster scrolling. Remote files are downloaded, but during the download, viewing the downloaded part is possible. If a file constantly changes, then it can also be viewed, lister will always see its current state. Use lister if the text file is bigger than: 10 MB (default value): checks whether a text file is bigger than 10 MB (configurable), and if yes, then &krusader; Lister is used instead of &plasma;'s default viewer. Use Okteta as Hex viewer: if checked (default option), use &plasma; hex editor Okteta to view raw data. To use this option you should install Okteta package first. Editor: choose what editor will be used when editing a file (via F4). Default the internal viewer is used, this is the &plasma;'s default viewer. Atomic extensions Atomic extensions: predefined atomic extensions like .tar.gz are shown as one part in the Ext Column of the List Panel. Advanced This page handles more advanced issues, so you should double-check your actions here: modifying settings here makes &krusader; a more powerful and dangerous tool. The page is divided into three parts: General Automount filesystems: this makes &krusader; try to mount a file system before entering it. For example, if you click on /mnt/cdrom (and /mnt/cdrom appears in /etc/fstab as a mount point), &krusader; will check if it is mounted. If not, it will try and mount it for you and then enter, so that you would see the contents of your cdrom. Note, however, that &krusader; will NOT unmount when exiting /mnt/cdrom. MountMan will not (un)mount the following mount points: If you have file systems that you do not want to accidentally unmount (or mount) then enter a list of mount points separated by commas (⪚ /, /boot, /tmp) and MountMan will not try to (un)mount them. Confirmations By checking the options in this section, &krusader; will ask for confirmation before doing a specific action; otherwise, the following actions will be done without warning: deleting non empty directories deleting file(s) copying file(s) moving file(s) Fine-Tuning Icon Cache Size: &krusader; uses an icon cache, so it will not have to reload icons that have been used before. Of course, as the cache grows bigger, it can store more icons and further speed operations, but the memory footprint of &krusader; will become bigger. Arguments of updatedb: sets additional arguments for updatedb, please read the manpages for more information. Archives This page configures some aspects of archive handling in &krusader;. krarc ioslave Enable Write Support: this option allows you to enable writing files into an archive. The down side is that if a power failure occurs during the process, the files that were moved might already be deleted, but not yet packed into the archive. Moving archives into themselves will delete them. Archive handling Browse Archives As Directories: if checked, &krusader; will handle the archives transparently and let you open them as folders; otherwise, &krusader; will attempt to invoke an application which opens archives of that type. Fine-Tuning Test archives after packing: this option automatically runs a test on a newly packed archive. It is safer, but takes longer. Test archives before unpacking: this option automatically runs a test before unpacking. Some corrupted archives might cause a crash; therefore, it is better to test archives before unpacking. Dependencies page This page configures the full path of the external applications. It is even possible to configure the full path of &krusader;! General tab Here you can configure the full path of the following external applications: application configurable full path kdesu /usr/bin/kdesu kget /usr/bin/kget mailer /usr/bin/kmail diff utility /usr/bin/kompare krename /usr/bin/krename krusader /usr/bin/krusader locate /usr/bin/locate mount /bin/mount umount /bin/umount updatedb /usr/bin/updatedb By default &kompare; (part of the kdesdk package) is used as external diff utility but you can also use your favorite diff utility ⪚ xxdiff or KDiff3, just fill in the full path and enjoy. Packers tab In the Packers tab you will see a list of archive formats. Some are filled and some are empty. The ones that are available (filled) are supported by &krusader;. For them, &krusader; will handle the archives transparently and let you open them as folders (provided you have checked the Browse Archives As Directories item in the Archives section); otherwise, &krusader; will attempt to invoke an application which opens archives of that type. If a certain archive item is empty, it means that &krusader; could not find the appropriate executables in the configured path. The next archives are supported: ace, arj, bzip2, deb, gzip, iso, lha, lzma, rar, rpm, tar, xz, zip and 7z. packer configurable full path 7z usr/bin/7z arj usr/bin/arj bzip2 usr/bin/bzip2 cpio /bin/cpio dpkg /bin/dpkg gzip /usr/bin/gzip lha /usr/bin/lha lzma /usr/bin/lzma rar /usr/bin/rar tar /bin/tar unace /usr/bin/unace unarj /usr/bin/unarj unrar /usr/bin/unrar unzip /usr/bin/unzip zip /usr/bin/zip xz /usr/bin/xz &krusader; may not be compatible with ACE despite our best efforts. Unace uses closed source and contains additional lines that make Unace get into infinite loop if the stdin is redirected to somewhere else. It works in the same manner as 'su', where you cannot enter the password only from the stdin. &krusader; >= 1-51 emulates the command line environment to enable co-operation with Unace, but we have noticed that Unace always changes its output format from release to release, making co-operation almost impossible. Checksum Utilities tab Here you can configure the full path of the following external Checksum Utilities: Checksum Utilities configurable full path supported checksums md5sum /usr/bin/md5sum md5 sha1sum /usr/bin/sha1sum sha1 md5deep /usr/bin/md5deep md5 sha1deep /usr/bin/sha1deep sha1 sha224sum /usr/bin/sha224sum sha224 sha256sum /usr/bin/sha256sum sha256 sha256deep /usr/bin/sha256deep sha256 sha384sum /usr/bin/sha384sum sha384 sha512sum /usr/bin/sha512sum sha512 tigerdeep /usr/bin/tigerdeep tiger whirlpooldeep /usr/bin/whirlpooldeep whirlpool cfv /usr/bin/cfv md5, sha1, sfv, crc UserActions Here you can configure the terminal for UserActions and the font for the output-collection. The default terminal is konsole --noclose -e. To set up, configure and manage your UserActions use ActionMan (UserActions &URL;). Protocols This page links the MIMEs to protocols. ⪚ protocol "tar" is linked to MIME "application/x-tar". In the Links you will see ⪚ Iso application/x-iso krarc application/x-ace application/x-arj application/x-bzip2 application/x-cpio application/x-deb application/x-debian-package application/x-gzip application/x-jar application/x-lha application/x-rar application/x-rpm application/x-zip tar application/x-tar application/x-tarz application/x-tbz application/x-tgz diff --git a/doc/menu-commands.docbook b/doc/menu-commands.docbook index 59ce1ca5..c4ed8786 100644 --- a/doc/menu-commands.docbook +++ b/doc/menu-commands.docbook @@ -1,1848 +1,1848 @@ Menu Commands Commands Menu File Menu &Shift; F4 File New Text File Creates a new text file in the current directory, unless another directory is specified. The new file is opened for editing after it is created. F7 File New Directory Creates a new directory in the current directory. &Alt;&Ctrl; S File New Symlink Creates a symbolic link to the currently selected file. F3 File View File Opens the currently selected file for viewing. F4 File Edit File Opens the currently selected file for editing. F5 File Copy to other panel Copy the currently selected files or directories to the other panel. F6 File Move Opens a dialog to move the currently selected files or directories to a specified location. &Alt;&Shift; P File Pack Creates a new archive of all the selected files and directories in the active panel. &Alt;&Shift; U File Unpack Unpacks all the selected files in the active panel. &Alt;&Shift; E File Test Archive Tests archive for corruption. File Compare by Content Compares two current files by content - one from each panel via an external graphical diff utility. By default &kompare; is used, but you can also use ⪚ xxdiff or KDiff3 , change it in the Konfigurator Dependencies page. &Shift; F2 File Multi Rename This menu option starts Krename, a very powerful external batch renamer. Krename Features Renaming a list of files based on a set of expressions Copying/moving a list of files to another directory Convert filenames to upper/lower case Adding numbers to filenames Finding and replacing parts of the filename Renaming MP3/OGG Vorbis files based on their ID3 tags Setting access and modification dates Changing permissions and file ownership A plugin API which allows you to extend KRename's features Renaming directories recursively Support for KFilePlugins Undo renaming And many more.... File Create Checksum Checksum creation on file(s) and/or folder(s). File Verify Checksum Verify Checksum &Ctrl; P File Split File The Split file function splits a file up into multiple smaller files so that it can be stored on several smaller media (like diskettes, zip-drives, ...) or sent by e-mail. &Ctrl; B File Combine Files The Combine files function combines multiple files into one file after the Split file function was used. &Ctrl; Q File Quit Closes &krusader; and cleans up the temporary directory, the same as pressing F10 key. Edit Menu &Ctrl; X Edit Cut Cuts the selected file(s) to the clipboard to be moved to another location. &Ctrl; C Edit Copy Copies the selected file(s) to the clipboard to be moved to another location. &Ctrl; V Edit Paste Pastes previously cut or copied items from the clipboard to the current directory. F8 Edit Delete Deletes the currently selected file(s). &Ctrl; + Edit Select Group Opens a dialog which allows you to select files in the active panel. In the Search for dialog place the main search criteria. Enter a filename, a wildcard ( *.o.*, *.c &etc;) or both - separated by a space. When using 'text', the results are the same as '*text*'. You can exclude files from the search with '|' (⪚ '*.cpp *.h | *.moc.cpp'). With the profile handler you can manage your selections for future usage. A double-click on a profile is the same as entering the selection and pressing the OK button. More options for Select Group dialog are explained in the Search dialog, which are basically almost the same dialogs. &Ctrl; - Edit Unselect Group The opposite of Select Group. The files that match the pattern in the active panel will be deselected. &Alt; + Edit Select All Selects all files in the active panel. You can also select all directories by activating the Autoselect directories option in the Konfigurator Panel page. &Alt; - Edit Unselect All Unselects all the files in the active panel. &Alt; * Edit Invert Selection Inverts the selection status of all the files in the active panel (&ie; selected files will become unselected and deselected files will become selected). Edit Restore Selection Restore the selection status of previously unselected items. &Ctrl; F Edit Find in folder Toggles &krusader; quick search function. &Alt;&Shift; C Edit Compare Directories Toggles &krusader; Compare Directories function. Edit Compare Setup Configures the Compare Directories function. Select Newer and Single (default) Select Single Select Newer Select Different and Single Select Different Edit Calculate Occupied Space Calculates occupied space of files and folders, archives and remote filesystems. &Alt; Return Edit Properties Opens the properties dialog for the currently selected file. (KP refers to Key Pad.) Go Menu &Alt; Up Go Up Navigates to the parent directory of the active panel. &Alt; Left Go Back Navigates to the previously viewed directory in the active panel. &Alt; Right Go Forward Navigates to the next viewed directory in the active panel. Becomes available only if Go Back was used beforehand. &Alt; Home Go Home Navigates to the home directory of the current user. &Ctrl; &Backspace; Go Root Navigates to the root directory of the system. &Ctrl; Z Go Popular URLs Displays a listing of frequently viewed directories from which you may navigate to one by double-clicking on it. &Ctrl;&Shift; J Go Set Jump Back Point Sets the current directory as a "jump back" point. To navigate to this directory quickly, select the Jump Back command from the Go menu. &Ctrl; J Go Jump Back Returns to a previous "jump back" point. View Menu The action in this submenu usually affects the current &krusader; session. If you want to make permanent changes use Konfigurator Startup page. View Zoom In Increase the view scale. View Zoom Out Decrease the view scale. View Default Zoom Reset the view scale. &Alt;&Shift; D View Detailed View Shows the file names, file size, creation date and time and their attributes. &Alt;&Shift; B View Brief View Shows only the file names. &Alt; . View Show Hidden Files Toggles the option to display the hidden files in the &krusader; panels. &Shift; F10 View All Files Turns off all filters and display all files. &Shift; F12 View Custom Allows you to install a custom filter on the &krusader; panel. Only files that match the filter pattern(s) and directories will be displayed. Do not forget to deactivate the custom filter after use, or some files may not be visible. View Show Previews If checked, show the previews for all files and folders on the active panel. View Select Remote Charset Selects the remote charset for Remote Connections. &Ctrl; R View Reload Refreshes the contents of the active panel. View Save settings as default Allows you to save the view settings of the current tab for new instances of this view type. View Apply settings to other tabs Allows you to apply the view settings of the current tab to the other tabs. Useractions Menu You can add your own menu entries here by defining your own UserActions. Useractions Manage User Actions... Opens the UserActions manager. Meta A UseractionsMultimedia Enqueue in Amarok Appends selected item(s) to &amarok; playlist. &Ctrl;&Alt; UseractionsSamples Equal panel-size Sets the ratio between the two panels to 50/50. &Ctrl;E UseractionsSamples Edit as root Allows you to edit a file with kwrite using root permissions. &Ctrl;&Alt;M UseractionsSamples Mount Mounts a new filesystem. &Ctrl;&Alt;C UseractionsSamples Copy current item to clipboard Copies current item name to the clipboard. MetaF5 UseractionsSystem Backup current Backups current file in current directory and asks the user for a new filename. By default .old is appended to the original filename. Meta 1 UseractionsUser Interface Sort By Name When this action is turned on, the main sorting key in the &krusader; panel becomes the file name. Meta 2 UseractionsUser Interface Sort By Extension When this action is turned on, the main sorting key in the &krusader; panel becomes the file extension (the part of the filename after the last '.'). This is useful for grouping files of the same type closer together. Meta 3 UseractionsUser Interface Sort By Size When this action is turned on, the main sorting key in the &krusader; panel becomes the file size. This is useful for determining the largest files in a particular directory. Meta 4 UseractionsUser Interface Sort By Modified When this action is turned on, the main sorting key in the &krusader; panel becomes the last modified date for each file. This is useful for finding files you recently worked on. Tools Menu &Ctrl; S Tools Search Opens KruSearcher - the &krusader; search module. &Ctrl;&Shift; L Tools Locate Opens the Locate &GUI; frontend for fast file searching. &Ctrl; Y Tools Synchronize Directories The Synchronize Directories function compares the left and right panels and shows the differences between them. After the compare function, you can move files/directories so that they can be - synchronized. This feature is disabled at the compilation time by default. See the link above for the instructions on how to enable it. + synchronized. &Alt; / Tools MountMan Opens submenu with items to open MountMan or mount/unmount various mounting points. &Alt;&Shift; S Tools Disk Usage Opens Disk Usage. &Ctrl; N Tools New Net Connection Opens the New Network Connection dialog to start a &FTP;, SMB, FISH or SFTP connection to a remote host. If you leave the user name and password fields empty, you will login as anonymous. You can Bookmark these remote sessions. &Ctrl;&Shift; D Tools Disconnect From Net Ends the remote connection in the active panel and returns to the start-up path. Tools Start Terminal Opens a terminal window in the default directory (usually your home directory). You can choose your favorite terminal application in the Konfigurator General page. &Alt;&Shift; K Tools Start Root Mode Krusader Starts &krusader; in Root mode at the same location. Root mode &krusader; requires kdesu by default, if kdesu is not available or if you prefer ⪚ gksu when using GNOME you can change this behaviour in the Konfigurator Dependencies page. Be careful when using &krusader; with ROOT PRIVILEGES. Tools Empty Trash Empties the trash bin. Window Menu &Ctrl;&Shift; N Window New Tab Opens a new tab in the active panel. Window Lock Tab/Unlock Tab Locks then unlocks current tab in the active panel. &Ctrl;&Alt;&Shift; N Window Duplicate Current Tab Opens a new tab that is a duplicate of the active tab in the active panel. &Ctrl;&Shift; O Window Move Current Tab to Other Side Moves current tab to the other side of &krusader; window. &Ctrl; W Window Close Current Tab Closes the current tab in the active panel. This command is only available if there is more than one tab in the active panel. Window Close Inactive Tabs Closes all the tabs in the active panel except for the active. Window Close Duplicated Tabs Closes the duplicated tabs in the active panel. &Ctrl; . Window Next Tab Navigates to the next tab in the active panel. This command is only available if there is more than one tab in the active panel. &Ctrl; , Window Previous Tab Navigates to the previous tab in the active panel. This command is only available if there is more than one tab in the active panel. &Alt;&Shift; L Window Profiles Opens a menu where Panel profiles can be saved and restored. &Ctrl; U Window Swap Panels The left panel will become the right panel and vice versa, only the current tabs will be swapped. &Ctrl;&Shift; U Window Swap Sides The complete left panel will become the right panel and vice versa, and all tabs will be swapped. &Ctrl;&Alt; R Window Vertical Mode Toggles the List Panel between horizontal and vertical mode. &Ctrl;&Alt; F Window Toggle Fullscreen Terminal Emulator Toggles full screen mode of the terminal emulator. This option is only available when Show Terminal Emulator is activated. Window Save Position Saves the current size and position of the &krusader; main window. This action can be automated with Save last position, size and panel settings in Konfigurator Startup page Settings Menu Settings Toolbars Show Main Toolbar Shows the Main Toolbar if checked. Settings Toolbars Show Job Toolbar Shows the Job Toolbar if checked. Settings Toolbars Show Actions Toolbar Shows the Actions Toolbar if checked. Settings Show Statusbar Shows the Statusbar if chosen. Settings Show FN Keys Bar Shows the FN Keys Bar if checked. &Ctrl;&Alt; T Settings Show Terminal Emulator Show the Terminal Emulator if checked. Settings Show Command Line Shows the Command Line if checked. Settings Command Execution Mode Setup Allows you to choose command execution mode. You can choose one of the following options. Start and Forget: start execution and do not wait for the results. Display Separated Standard and Error Output: show the output to stdout and stderr on the separate panels. Display Mixed Standard and Error Output: show the output to stdout and stderr on the single panel (default). Start in New Terminal: execute the command in the new terminal window. Send to Embedded Terminal Emulator: send the command to the embedded terminal emulator. Settings Job Queue Mode Toggles the Queue Manager mode. If checked then pressing F2 or the corresponding button in the copy/move dialog immediately starts the job even if there are running jobs in queue. If unchecked then the job will be put into the queue if the queue is not empty. Otherwise the job will be started immediately. Settings Configure Shortcuts Configure Shortcuts Opens a dialog which allows you to configure the &krusader; key bindings. With the Import shortcuts and Export shortcuts buttons you can load and save a Key-binding profile. This allows &krusader; to have the Total Commander, Midnight Commander, foo-commander, or your custom Key-bindings. The only limitation is that global &plasma; key-bindings and some &krusader; key-bindings cannot be changed yet, as well as some features in foo-commander that we either do not have or need. The Key-bindings are stored in /usr/share/krusader, foo.keymap.info contains a description, foo.keymap is an ini file that holds the Key-bindings. Until &krusader;-1.70.1 this was a binary file, &krusader; is backwards compatible for importing this legacy binary format. If a *.keymap.info text file exists, &krusader; will display it, showing additional information regarding the loaded Key-bindings file. Here you have a chance to exit without importing the proposed Key-bindings file. A Total Commander Key-bindings file is provided. Please upload your favorite Key-bindings schemes so that they become available for the &krusader; community. Thanks! Settings Configure Toolbars Opens a dialog which allows you to configure the Main Toolbar or the Actions Toolbar. You can add action buttons of your favourite UserActions to the desired toolbar. Settings Configure &krusader; Opens Konfigurator - the &krusader; configuration center. Help Menu Additionally, &krusader; has the common &kde; Help menu items, for more information read the sections about the Help Menu of the &kde; Fundamentals. diff --git a/doc/profiles.docbook b/doc/profiles.docbook index 50e8062f..7f5d7371 100644 --- a/doc/profiles.docbook +++ b/doc/profiles.docbook @@ -1,72 +1,72 @@ Profiles Profiles With profiles you can save and restore your favorite settings. Several features support profiles, you can have ⪚ different panel profiles (work, home, remote connections, &etc;), search profiles, synchroniser profiles, &etc; Panel Profiles A panel profile contains the following: all the tab paths (left or right), the current tab (left or right) and the active panel (left or right). All this information is stored in the krusaderrc file. You can have several panel profiles, ⪚ file management, &FTP; management, home, work, &etc; The panel profile can be saved and restored in the Window menu. The default startup profile will be used when starting &krusader;, but you can override it with a command-line option. Color Profiles Colormaps can be saved and restored with Color Profiles. Key-binding Profiles Keymaps can be saved and restored with Key-binding Profiles. Search Profiles If you regularly perform the same search operation, you can save the search settings (⪚ include files, exclude files, &etc;) in a Search Profile. Synchronizer Profiles If you regularly perform the same synchronize operation, you can save the synchronize settings in a Synchronizer - Profile. The Synchronizer is disabled at the compilation time by default. + Profile. diff --git a/doc/synchronizer.docbook b/doc/synchronizer.docbook index 29626fbd..825b0ddb 100644 --- a/doc/synchronizer.docbook +++ b/doc/synchronizer.docbook @@ -1,750 +1,739 @@ Synchronizer Synchronizer Introduction This function compares two directories with all subdirectories and shows the differences between them. After selecting some options and the Compare function you can synchronize the files and directories. One panel could be an &FTP; server. Do not forget the Compare by content option if the file size stays equal. Choose Tools Synchronize Directories or &Ctrl; Y to start this feature. The colors are configurable. The synchronizer has its own keybindings. For local files: The synchronizer changes the date information to the original dates. -
Synchronizer Synchronizer
Procedure: Set the Left directory and the Right directory that you want to compare. Configure the optional File Filter, General Filters and Advanced filters. The General Filters includes a Do not search in option which lets you exclude directories from comparison. Set the Checkbox options: Recurse subdirectories, Follow symlinks, Compare by content, Ignore Date, Asymmetric and Ignore Case. Click on the Compare button to compare the directories. By using Show options, you can include/exclude particular file types. The files that are not on the list will be untouched by synchronization. If needed, you can change the Task operations determined by the Comparator with the right click menu. When you agree with the Compare results, click on the Synchronize button to show the synchronize dialog. After selecting the options of the Synchronizer, click on the Start button to start the synchronization process. A detailed explanation of all the functions and buttons is described in the following text. Comparator Panel elements Left Directory: The left side base directory. Right Directory: The right side base directory. File Filter: Filters the filenames at synchronizing. ⪚ *.png selects only files the names of which end with .png. Directories are listed if the directory name ends with .png or if the directory contains files which end with .png. Multiple include/exclude example: '*.cpp *.h | *.moc.cpp' includes *.cpp *.h and exclude *.moc.cpp. General filters: Search for, containing text Advanced filters: Size, date, ownership Filename filtering criteria You can make use of wild cards. Multiple patterns are separated by space (means logical OR) and patterns are excluded from the search using the pipe symbol. If the pattern is ended with a slash (*pattern*/), it means that pattern relates to recursive search of directories. pattern - means to search those files/directories whose name is a pattern, recursive search goes through all subdirectories independently of the value of the pattern. pattern/ - means to search all files/directories, but recursive search goes through/excludes the directories whose name is a pattern. You can use quotation marks for names that contain spaces. Filter "Program Files" searches out those files/directories the name of which is Program Files. Examples: *.o *.h *.c?? *.cpp *.h | *.moc.cpp * | CVS/ .svn/ Note: the search term 'text' is equivalent to '*text*'. Checkbox options Recurse subdirectories: The Synchronizer walks through subdirectories when comparing. Follow symlinks: The Synchronizer follows the symbolic links to directories (not the files!). Compare by content: The files the sizes of which are equal will be compared by content as well. Ignore Date: Ignores the date information (useful for &FTP;, smb, archive, ... ) the date information is relevant *only* in the local file system. Asymmetric: The Left Directory is the target directory, the Right Directory is the source directory. This function synchronizes the content of the left directory to the right directory. The files that exist only on the left side will be deleted. The files that exist only on the right side will be copied to left. The files considered to be equal will be untouched. Those files considered to be different will be copied to left. Use this feature with care! This function is useful if the date information is unusable, or to synchronize the left directory to the content of a file server (like a download). Alternatively, it is useful to make a backup from the right directory to the left directory. NOTE: Do NOT use this option to synchronize a desktop and a notebook (⪚ files that exist only on the left side will be deleted!). Scroll Results: This is for slow &FTP; servers, ... When the Synchronizer has finished comparing a file, it puts the file into the end of the list at once and scrolls the window, if necessary. It is important, if you want to know what the Synchronizer is doing. If the &FTP; server is slow, the comparison of a directory may take a lot of time. By turning this option on, you can see that the comparator is "alive", but slow. For fast file systems, it can reduce the speed of comparing slightly. Ignore Case: Case insensitive filename compare, this is useful when synchronizing &Windows; filesystems. Ignore hidden files: Ignores files that start with a dot. When everything mentioned above is done, click on the Compare button to compare the directories, the results are displayed in the File List. File List The File List has the following columns: "Left name | Left size | Left time | Task | Right time | Right size | Right name". Here you can check the compare results and modify the synchronization actions if desired. The text color defines the default copy direction determined by the comparator. Green: Copy from left to right. Blue: Copy from right to left or delete on the right side in asymmetric mode. Red: Files which are different by the given criteria (no copy direction). Black: Files which are identical (no copy direction). A double click on a file calls the &krusader;s Compare by content function. The Tasks (<=>) column defines the default copy direction, which can be modified by the user if needed. The results window supports dragging items to other windows ( drag [left], &Shift;+drag [right] ) and copy left/right selected items to clipboard (&Ctrl;C). File List: Tasks (<=>) column This column displays the task that is planned for the Synchronizer, this task can be modified with the right click menu. ->: Copy from the left side to the right side. For directories: mkdir in the right side. =: The files are the same, do not do anything. !=: The file is excluded, or the Synchronizer does not know what to do. <-: copy from the right side to the left side. For directories: mkdir in the left side DEL: delete files from the right side. Show options Here you can include/exclude particular file types. Those files, that are not in the list, will be untouched at synchronization. ->: Enable/Disable the copy task from left to right. =: Enable/Disable listing the equal files. !=: Enable/Disable listing the excluded / "do not know what to do" files. <-: Enable/Disable the copy task from right to left. Trash: Enable/Disable the file deleting from the left side task. Duplicates: Enable/Disable those files that exist on both sides. Singles: Enable/Disable those files that exist only on one side. Action buttons Compare: Compares the directories, the results are displayed on the File List. Stop: Stops comparing. Synchronize: Shows the synchronize dialog. Close: Closes the Synchronizer window. The Status line may contain The number of scanned directories while comparing. The filename when comparing by content (for big files). The number of files on the list. Right click menu on the File List The right click menu is split up in three sections: 1. change the Task operations determined by the Comparator. Select one or multiple files. The change will be applied on the selection and not only on the right clicked item. If the selected item is a directory, the change will be applied on its files/subdirectories as well. Synchronize Directories: Starts synchronization. Exclude: Excludes a file/dir from synchronization ( task change to != ). Restore original operation: Task change to the original result of comparison. Reverse direction: Task change ( -> to <-, and <- to -> ). Copy from right to left: Task change to <-. Copy from left to right: Task change to ->. Delete ( left single ): Task change to DEL. 2. change the selections Select items: Opens a dialog which allows you to select items. This is the Select Group dialog from the Edit menu. Unselect items: Opens a dialog which allows you to deselect items. This is the Unselect Group dialog from the Edit menu. Invert selection: Invert the selection status of all items. 3. others (note that the following operations work on the right-clicked file and not on the selection). View left file: Starts viewer on the left file. View right file: Starts viewer on the right file. Compare Files: Starts the diff utility (⪚ &kompare;) on the files. Other buttons Profiles: If you have to synchronize the same directories often, you can save the settings ⪚ include files, exclude files, ... Press the Profile button, and you will be able to add / load / save / remove synchronizer profiles. Swap sides: Swaps the File List. Synchronize with kget If you want to synchronize a local directory with an unstable &FTP; server, kget is a much better solution than simple file copying. After comparing you may right click on the result list and select Synchronize with KGet to execute the synchronization, after that the listed files will be downloaded with kget instead of &krusader;. Of course kget needs to be installed on your computer; otherwise, it will not be available. Synchronization After pressing the Synchronize button the synchronization dialog appears. Check boxes Here you confirm the copy and delete operations of the Synchronizer Right to left: copy X1 files ( Y1 bytes ) enable / disable the copy from right to left. Left to right: copy X2 files ( Y2 bytes ) enable / disable the copy from left to right. Left: delete X3 files ( Y3 bytes ) enable / disable the left side deleting. Confirm overwrites: By switching this option on, Krusader will show the rename, skip, overwrite, skip all, overwrite all dialog box, before overwriting the file. Status labels Ready: A1/A2 files, B1/B2. This line is changed at synchronizing, showing that synchronizer finished with A1 files from A2 ( B1 bytes from B2 ). Progress bar: Shows the progress on the synchronization (based on bytes). Action buttons Start: Starts synchronization. Pause / Resume: Pauses/resumes the synchronization process. Close: Closes the synchronization dialog (and stops synchronization). Parallel synchronization One can give the number of the 'quasi' threads. Can drastically increase the speed when synchronized with slow &FTP; servers. Does not affect the speed of local synchronization. Remote "compare by content" and "directory compare" is done in parallel. Remote synchronization is also done in parallel, except the mkdir tasks (mkdir must be before copy). diff --git a/doc/useraction-xml.docbook b/doc/useraction-xml.docbook index 27735de5..d1926766 100644 --- a/doc/useraction-xml.docbook +++ b/doc/useraction-xml.docbook @@ -1,215 +1,215 @@ useractions.xml This appendix gives several examples of useractions.xml files. With this you can begin to discover the power of the UserActions and start learning how to use them. Once you understand how to write UserActions you will find that &krusader; is an even more powerful, customizable tool. Please consider uploading your UserActions at store.kde.org as we are collecting them. If your UserAction is selected by us it will be shipped with &krusader; at the next release. Runs uptime <!DOCTYPE KrusaderUserActions> <KrusaderUserActions> <action name="uptime" > <title>Up-time</title> <tooltip>tells how long since the computer has been booted</tooltip> <icon>clock</icon> <category>information</category> <description same_as="tooltip" /> <command executionmode="collect_output" >uptime</command> <defaultshortcut>Alt+Ctrl+U</defaultshortcut> </action> </KrusaderUserActions> Runs ls -l <!DOCTYPE KrusaderUserActions> <KrusaderUserActions> <action name="ls -l" > <title>ls -l in current dir</title> <description same_as="tooltip" /> <command executionmode="collect_output" >ls -l %aPath% %oPath%</command> </action> </KrusaderUserActions> Echo Placeholder <!DOCTYPE KrusaderUserActions> <KrusaderUserActions> <action name="test_placeholder" > <title>Echo Placeholder</title> <tooltip>Echo's the placeholder values</tooltip> <category>Testing</category> <description same_as="tooltip" /> <command executionmode="collect_output" onmultiplefiles="call_each" >echo -e "aPath %aPath()% \naCurrent: %aCurrent()%"</command> </action> </KrusaderUserActions> This useraction copies current path and filename to clipboard: <!DOCTYPE KrusaderUserActions> <KrusaderUserActions> <action name="clipboard current" > <title>Copy to Clipboard</title> <tooltip>Copy to clipboard</tooltip> <icon>klipper</icon> <category>System</category> <description>Copy current path and filename to clipboard</description> <command>%_Clipboard("%aCurrent%")%</command> <defaultshortcut>Win+C</defaultshortcut> </action> </KrusaderUserActions> Selects .diff and *.h in the active panel: <!DOCTYPE KrusaderUserActions> <KrusaderUserActions> <action name="test_select" > <title>Add selection *.diff and *.h</title> <category>Selection</category> <command>%aSelect("*.diff", "add")% %aSelect("*.h", "add")%</command> </action> </KrusaderUserActions> Active panel changes to mnt/floppy (bookmark): <!DOCTYPE KrusaderUserActions> <KrusaderUserActions> <action name="mnt/floppy bookmark" > <title>Jump to /mnt/floppy</title> <category>Bookmarks</category> <command>%aGoto("/mnt/floppy", "yes")%</command> </action> </KrusaderUserActions> Select in the non-active panel, all filenames that are highlighted in the active panel: <!DOCTYPE KrusaderUserActions> <KrusaderUserActions> <action name="asdfasdf" > <title>Select in Other Panel</title> <category>Selection</category> <description>Select all filenames that are selected in the active panel, also in the non-active panel</description> <command>%oSelect("%aList("selected", " ", "Yes")%")%</command> </action> </KrusaderUserActions> Make a backup of the current file/folder to foo.bak into the current directory: <!DOCTYPE KrusaderUserActions> <KrusaderUserActions> <action name="backup current" > <title>Backup in Current Directory</title> <tooltip>Backup in current directory</tooltip> <icon>document-save-as</icon> <category>System</category> <description same_as="tooltip" /> <command>%_Copy("%aCurrent%", "%_Ask("new name", "%aCurrent%.bak")%")%</command> <defaultshortcut>Shift+F5</defaultshortcut> </action> </KrusaderUserActions> Opens KruSearcher: <!DOCTYPE KrusaderUserActions> <KrusaderUserActions> <action name="search" > <title>Search Test</title> <command>%_NewSearch("Search 2")%</command> </action> </KrusaderUserActions> Sets the selected picture as wallpaper: <!DOCTYPE KrusaderUserActions> <KrusaderUserActions> <action name="set wallpaper" > <title>Set as Wallpaper</title> <tooltip>Set as wallpaper</tooltip> <icon>image</icon> <category>Service Menu</category> <description>Set as wallpaper (scaled)</description> <command>dcop kdesktop KBackgroundIface setWallpaper "%aCurrent%" 6</command> <defaultshortcut>Win+W</defaultshortcut> </action> </KrusaderUserActions> This useraction edits a file with root permissions using kdesu: <!DOCTYPE KrusaderUserActions> <KrusaderUserActions> <action name="edit as root" > <title>Edit as Root</title> <tooltip>Edit as root</tooltip> <icon>kwrite</icon> <category>System</category> <description>Edit a file with root permissions using kdesu</description> <command>kdesu kwrite %aCurrent%</command> <defaultshortcut>Win+F4</defaultshortcut> </action> </KrusaderUserActions> This useraction Add item(s) to Amarok playlist: <!DOCTYPE KrusaderUserActions> <KrusaderUserActions> <action name="amarok enqueue" > <title>Enqueue in Amarok</title> <tooltip>Append selected item(s) to Amarok playlist</tooltip> <icon>amarok</icon> <category>Multimedia</category> <description same_as="tooltip" /> <command>amarok --append %aList("Selected")%</command> <defaultshortcut>Win+A</defaultshortcut> </action> </KrusaderUserActions> - Opens Synchronizer (disabled at the compilation time by default): + Opens Synchronizer: <!DOCTYPE KrusaderUserActions> <KrusaderUserActions> <action name="synchronizer" > <title>Synchronizer</title> <command>%_Sync("Sync 2")%</command> </action> </KrusaderUserActions> diff --git a/doc/vfs.docbook b/doc/vfs.docbook index 654a3add..361c6924 100644 --- a/doc/vfs.docbook +++ b/doc/vfs.docbook @@ -1,103 +1,103 @@ Virtual file systems (VFS) VFS A basic OFM feature is VFS, this an abstracted layer over all kinds of archived information (ZIP files, &FTP; servers, TAR archives, NFS filesystems, SAMBA shares, ISO CD/DVD images, RPM catalogs, &etc;), which allows the user to access all the information in these divergent types of filesystems transparently - just like entering an ordinary sub-directory. &krusader; supports several virtual file systems: Remote connections VFS: provides the capability of working with a remote connection session (&FTP;, NFS, Samba, FISH, SFTP) like with local filesystems. It is perfect for complex remote operations and almost as powerful as most standalone GUI remote clients. Archive VFS: allows to browse archives in VFS as it was a directory (ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip and 7-zip). Search VFS: Feed to listbox places the search results in VFS. Synchronizer VFS: places - the synchronizer results in VFS (disabled at the compilation time by default). + the synchronizer results in VFS. Actions you perform on the files in VFS are performed on the 'real' files. You do not just delete files from the VFS - you delete them from your hard drive. Limitations: you cannot create directories inside a VFS. It is possible to keep the directory structure when doing a copy from a virtual folder to a non virtual folder, by selecting the "Keep virtual directory structure" check box of the copy dialog. Imagine the following virtual folder: $ file:/home/myhome/mydir1/myfile1 $ file:/home/myhome/mydir1/myfile2 $ file:/home/myhome/mydir2/myfile3 Then do the following steps: go to the virtual folder and select the files select a destination folder (non virtual!) press F5-> copy dialog appears Check Keep virtual directory structure Select /home/myhome/ for base &URL; Start copy by pressing OK The result will be: $ destinationdir/mydir1/myfile1 $ destinationdir/mydir1/myfile2 $ destinationdir/mydir2/myfile3