diff --git a/doc-extras/ChangeLog b/doc-extras/ChangeLog index a7b64ddc..4dc5c823 100644 --- a/doc-extras/ChangeLog +++ b/doc-extras/ChangeLog @@ -1,749 +1,750 @@ The Krusader Handbook ChangeLog ------------------------------- 2.x.x ========================= Date: 20xx-xx-xx CHANGED: Rename SVNNEWS into NEWS in docs + FIXED: Updated links and used https:// where appropriate 2.7.1 "Peace of Mind" ========================== Date: 2018-08-12 ADDED: More documentation on the search bar, new shortcuts. FIXED: Synchronizer is not disabled by default anymore. CHANGED: Reorganized section on quick search in BookMan II 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 fd873928..f6161a79 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: * +* GNU site https://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. 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 keeps the ACL permissions as well. diff --git a/doc/archives.docbook b/doc/archives.docbook index 263a83b5..86db9124 100644 --- a/doc/archives.docbook +++ b/doc/archives.docbook @@ -1,144 +1,144 @@ Archive Handling Archives Browsing Archives The Virtual file systems (VFS) allows you to browse archives as if it was a directory. Currently &krusader; supports the following archives types: ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, xz, zip, and 7-zip and supports the following passworded archives: arj, ace, rar and zip. Passwords can be stored in Kwallet. Please note that the archive support first needs to be properly configured in Konfigurator. To open the archive, use &Enter;, (double-)click or the Right Arrow. &krusader; supports also hidden archives, these are renamed archives with a *wrong* extension, ⪚ OpenOffice uses zip archives with the following extensions: .odt, .sxw and .odw. &Enter; will open the OpenOffice document and the Right Arrow will open the archive. Another example is J2EE, where the .jar extension means a zip archive. Since &krusader; auto-detects the supported archive types, it will open with Right Arrow even if it has another MIME type. Please note that browsing archives has a few limitations: Not all functions are supported by all archive types. (&ie;: you can not delete files in ace or rar archives) The permissions you have inside the archive are the same as the permissions you have for the archive. The command line (if visible) will not follow you inside the archive but will point to the archive directory. Before any action is performed on files/directories inside the archive, they must be extracted. The archive will be repacked when you leave it or when &krusader; detects that extracted files have changed. Packing and un-packing are "blocking operations" that display a progress dialog. However, this might change in the future since we are planning to create more background operations. Unpack Files There are 2 ways to extract files from archives: If you want to unpack a whole archive(s), browse to the archive location, select the archive(s) and select File Unpack or &Alt;&Shift; U. &krusader; will ask you where to put the extracted files. The default location is the inactive panel directory. If you do not cancel the operation, &krusader; will try to unpack all the selected files in the inactive panel. If you only want to extract a part of the archive, then browse the archive and copy the files you want to extract to their new location just as you would copy "normal" files. Note that unpacking from a browsed archive takes more time (file by file unpack) compared to unpacking a whole archive with the first method. The unpack operation can be put in a queue. Packing Files If you want to create a new archive, begin by selecting the elements you want to pack in the active panel and select File Pack or &Alt;&Shift; P. A dialog will pop-up prompting you to select the archive name and location. Select the packer from one of the supported file name extensions. To add files to an existing archive(s), open the archive in one panel and the files to be copied in the other panel, then simply copy the files into the archive in exactly the same way you copy files into a "normal" directory. The pack operation can be put in a queue. Testing Archives &krusader; will not handle corrupted archives since it may result in data loss. If you receive an error message when opening an archive, or if you suspect that there is something wrong with the archive, you should test it before use. To test an archive, browse (navigate) to the archive location and select the archive. Next select File Test Archive or &Alt; E. &krusader; will test the archive file and inform you whether the archive passed or failed the file integrity test. diff --git a/doc/basic-functions.docbook b/doc/basic-functions.docbook index dde3daf7..3ab299de 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. + 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 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 c2c84073..b53152a8 100644 --- a/doc/bookmarks.docbook +++ b/doc/bookmarks.docbook @@ -1,297 +1,297 @@ 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. There is a quick search bar at the top of the BookMan II menu. The search bar will always be visible in the bookmarks menu if you check the corresponding item on the Panel Konfigurator's page. Below are the rules to handle bookmarks: Just type letters to search: bookmarks are matched by name prefix If multiple bookmarks are matched by the prefix, they are highlighted and the first one is selected - hit &Enter; to activate the bookmark Once a single bookmark is matched, it is immediately triggered. That is when you type 'h' and only one bookmark starts with 'h', it is executed immediately - no &Enter; needed Accelerators work only if the keystroke is the first one &Backspace; is supported Search is case insensitive unless you type a capital letter. That is typing HamBurglar will only match HamBurglar but not hamburglar or Hamburglar. Search bar is intentionally a read-only field 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. 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/checksum.docbook b/doc/checksum.docbook index 515fbc60..54f42d9b 100644 --- a/doc/checksum.docbook +++ b/doc/checksum.docbook @@ -1,51 +1,51 @@ Checksum Creation and Verification Checksum File Create Checksum : &krusader; checks which tools you have and if those tools allow recursive operation (in case you selected folders), you can generate a checksum by choosing a checksum type from the list (md5, sha, &etc;). You can then save the checksum to a file, usually called checksum.md5 or checksum.sha1. File Verify Checksum : &krusader; checks if you have a tool that supports the type of checksum you need (from your specified checksum file) and displays the files that failed the checksum (if any). The system abstracts over different checksum mechanisms and Checksum Utilities. At the moment, the following checksums are supported: md5, sha1, sha256, sha224, sha256, sha384, sha512, tiger, whirlpool, cfv and crc. Please check your Checksum Utilities settings before using this function. diff --git a/doc/compare.docbook b/doc/compare.docbook index e2aa3007..4ad00d96 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. 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 + &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/configuration-files.docbook b/doc/configuration-files.docbook index eaa2a3e6..188e8a1f 100644 --- a/doc/configuration-files.docbook +++ b/doc/configuration-files.docbook @@ -1,160 +1,160 @@ Configuration Files Configuration files This appendix gives an overview of the configuration files used by &krusader;. krusaderui.rc This file stores the users toolbar settings and the menu structure. Tip: read also the krusaderui.rc &FAQ;. Location: /usr/share/kxmlgui5/krusader/krusaderui.rc, or ~/.local/share/kxmlgui5/krusader/krusaderui.rc, or kxmlgui5/krusader/krusaderui.rc in the directory which can be determined using the qtpaths --paths GenericDataLocation command krusaderrc This file stores the &krusader; configuration. Location: ~/.config/krusaderrc The following settings are ⪚ stored: Actions Toolbar Archives Colors Dependencies DiskUsage DiskUsageViewer General HTML Settings KFileDialog KFileDialog Speedbar KrDetailedViewLeft KrDetailedViewRight KrViewerWindow KrViewerWindow Toolbar extraToolBar Look & Feel Notification Messages Panel Profiles Private Protocols Search Startup Synchronize Locate SynchronizerProfile - 1 krbookmarks.xml This file stores the &krusader; bookmarks and uses the XBEL standard. Location: ~/.local/share/krusader/krbookmarks.xml or krusader/krbookmarks.xml in the directory which can be determined using the qtpaths --paths GenericDataLocation command useractions.xml This file stores the UserActions configuration. Location: ~/.local/share/krusader/useractions.xml or krusader/useractions.xml in the directory which can be determined using the qtpaths --paths GenericDataLocation command useraction-examples.xml This is the default UserActions provided by developers. Location: $KDEDIR/share/krusader/useraction-examples.xml foo.keymap This is a .ini file that holds a Key binding profile. Until &krusader;-1.70.0 this was a binary file. &krusader; is backwards compatible for importing this legacy binary format. Location: /usr/share/krusader/foo.keymap foo.color This is a binary file that holds the Color Scheme. Location: /usr/share/krusader/foo.color diff --git a/doc/credits-and-license.docbook b/doc/credits-and-license.docbook index a8ef2ef6..e0ab89c9 100644 --- a/doc/credits-and-license.docbook +++ b/doc/credits-and-license.docbook @@ -1,162 +1,162 @@ Credits and License Credits License &krusader; Program copyright 2000-2003 Shie Erlich and Rafi Yanai, 2004-2018 &krusader; Krew krusader-devel@googlegroups.com &krusader; is developed by a dedicated team of individuals, known as the &krusader; Krew. Shie Erlich, author (retired) erlich * users.sourceforge.net Rafi Yanai, author (retired) yanai * users.sourceforge.net Dirk Eschler, webmaster (retired) deschler * users.sourceforge.net Csaba Karai, developer (retired) ckarai * users.sourceforge.net Heiner Eichmann, developer (retired) h.eichmann * gmx.de Jonas Bähr, developer (retired) jonas.baehr * web.de Václav Jůza, developer (retired) vaclavjuza * seznam.cz Jan Lepper, developer (retired) jan_lepper * gmx.de Andrey Matveyakin, developer (retired) a.matveyakin * gmail.com Davide Gianforte, developer davide * gengisdave.org Toni Asensi Esteve, developer toni.asensi * kdemail.net Alexander Bikadorov, developer alex.bikadorov * kdemail.net Martin Kostolný, developer clearmartin * gmail.com Nikita Melnichenko, developer nikita+kde * melnichenko.name Frank Schoolmeesters, Documentation & Marketing coordinator (retired) frank_schoolmeesters * yahoo.com Richard Holt, Documentation & Proofing (retired) richard.holt * gmail.com Yuri Chornoivan, Documentation yurchor * ukr.net Matej Urbančič, Marketing & Product Research (retired) matej.urban * gmail.com We would especially like to thank Dirk Eschler the &krusader; web master. If you visit the - &krusader; website you will appreciate the hard work and + &krusader; website you will appreciate the hard work and effort that Dirk has put into the site as much as we do. We would like to thank everyone who has contributed to &krusader;. Sorry we can not mention all of you in this handbook. For a more complete list of &krusader; contributors please take a look at the CREDITS and Changelog file online or in the &krusader; sources. Special thanks to: - kde.org + kde.org - KDE translation teams + KDE translation teams Sourceforge.net Jonas Bähr (webspace) store.kde.org - Google.com + Google.com Documentation Copyright 2000-2003 Shie Erlich and Rafi Yanai. Documentation Copyright 2004-2011 Frank Schoolmeesters. Documentation Copyright 2004-2018 &krusader; Krew. &underFDL; Copyright 2004-2018 &krusader; Krew krusader-devel@googlegroups.com. &underGPL; diff --git a/doc/diskusage.docbook b/doc/diskusage.docbook index 5cc06a50..45079e0e 100644 --- a/doc/diskusage.docbook +++ b/doc/diskusage.docbook @@ -1,138 +1,138 @@ Disk Usage Disk Usage The Disk Usage is based on the code of Filelight. The Disk Usage shows you how your disk space is being used by a graphical representation of your file system. The following presentations are possible: Line view Detailed view Filelight view: as a set of concentric segmented-rings Choose Tools Disk Usage or &Alt;&Shift; S to start this feature in a separate window, or open it inside the Sidebar. Disk Usage Keybindings, right click menu. Del: Delete &Ctrl; E: Exclude &Shift; Arrow Up: Up one directory &Ctrl; N: new search &Ctrl; R: refresh &Ctrl; I: include all &Shift; Arrow Down: step into View menu: &Ctrl; L: Line view &Ctrl; D: Detailed view &Ctrl; F: Filelight view &Shift; Arrow Right: Next view &Shift; Arrow Left: Previous view diff --git a/doc/editors-note.docbook b/doc/editors-note.docbook index af3a35b3..44a9a221 100644 --- a/doc/editors-note.docbook +++ b/doc/editors-note.docbook @@ -1,73 +1,73 @@ Note from the Editors As you may notice, this handbook is written by various authors. The draft explanation of new features is done by the developers on the krusader-devel mailinglist, the editors add this information in this handbook. We have taken much care in ensuring technical and vocabulary consistency. The authors write in English even though it is not their native language; therefore, you may notice strange sentence constructions. Do not hesitate to let us know, if something is not clear to you. An open source project's greatest strength is derived from getting user feedback. That is why we would love to hear what you have to say. Documentation contributors are always welcome!, since this is a time consuming task. If you have ideas on how to improve the content, if you would like to write about an undocumented &krusader; feature, or if you have comments or suggestions about the &krusader; Handbook, please let us know. You can contact us even if you find typos! For information about the &krusader; documentation project, please contact the &krusader; documentation coordinator, Yuri Chornoivan yurchor@ukr.net. This handbook is available in several formats. via the Help Menu when using &krusader; - the Online Handbook + the Online Handbook The most recent version of this handbook is available when using &krusader; from Git. 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! All mentioned Trademarks and Copyrights in this handbook belong to their respective owners. diff --git a/doc/faq.docbook b/doc/faq.docbook index f0786e61..c5c46ece 100644 --- a/doc/faq.docbook +++ b/doc/faq.docbook @@ -1,1416 +1,1416 @@ Frequently Asked Questions (&FAQ;) FAQ If you have problems with &krusader; please check the Installation procedure, as your problem may be caused by a bad installation. The &FAQ; is divided into three sections: Installation &FAQ; (this page) Usage &FAQ; (issues with running/using &krusader;) General &FAQ; (bug reports, forum, mailing list, ...) If you feel that a &FAQ; is missing or if something is not clear to you, please let us know. Installation &FAQ; Does &krusader; need &plasma; to run? No, &krusader; does not need the &plasma; window manager to run on your computer but &krusader;'s natural environment is &plasma;, because it relies on services provided by the &kf5-full; base libraries. Only some shared libraries are needed ⪚ &kf5; libraries, &Qt; libraries, &etc; This means that &krusader; - runs on GNOME, - AfterStep, XFce and + runs on GNOME, + AfterStep, XFce and other window managers provided the appropriate libraries are installed on your computer. All this is not a problem since the apt-get world can resolve these dependencies instantly. You do not need to switch to the &plasma; window manager to use &krusader;; you can - still use GNOME, - AfterStep, XFce or + still use GNOME, + AfterStep, XFce or another window manager. However, the configuration of the &krusader; fonts and some behavior is done by running systemsettings. A lot depends on what you want to do with &krusader;. You should know that &krusader; uses the &kf5; KIO Slaves to access remote file systems, and support for only a limited number of file system types are shipped with &kf5; libraries, most of the KIO Slave are bundled with &kf5-full; (including fish, sftp and tar). To summarize, if you want a working &krusader; - install &kf5-full;. If you want a functional &krusader; then you need &kf5-full; and some additional &plasma; packages. For maximum functionality, &krusader; needs some &kde; Applications (&ark;, &kdiff3;, KRename), but the &plasma; window manager is optional. Which libraries does &krusader; need to run? For running &krusader; (⪚ when you have installed &krusader; with a binary RPM) you need less libraries than if you compile &krusader; from source. ⪚ you only need the C-compiler &gcc; when you compile &krusader; from source (see the next question). Take a look at the &krusader; dependencies paragraph of our install chapter. If you need more details please take a look - at the &krusader; requirements on Ubuntu. + at the &krusader; requirements on Ubuntu. The "depends" are required, the "suggests" make &krusader; more powerful. I have followed all the steps but make complains about missing libs or headers. What do I need to do? Install the missing packages. Take a look at the Compilation requirements paragraph of our install chapter. Most RPM-based distributions separate the headers from the libs. The headers are needed to compile &krusader;. Look for packages in the form foo-devel-*.rpm (⪚ kdelibs-devel-foo.i586.rpm) or foo-dev-*.deb for Debian based distributions. These are usually included with your distribution. If you cannot find the needed package, use rpmfind and click 'missing lib or header' in the search line. Or use apt-cache search foo to find the corresponding package for Debian based distributions. How do I compile &krusader; when I am using a 64 bit processor? As far as we know, there are no issues. &krusader; is also available on - + many other architectures. I have downloaded the Source RPM krusader-x.xx.dist.src.rpm, what to do now? Check the ownership and the permissions on /usr/src/RPM/ and all recursive directories that your normal user can read-write-execute in these directories. To produce the binary RPM for your computer, do this: $ rpm </path/to/rpmfile/> krusader-x.xx.dist.src.rpm If all dependencies are OK, a binary RPM krusader-x.xx.dist.rpm will be created at /usr/src/RPM/RPMS/i586 (replace i586 with your architecture). Test the binary RPM for errors before installing: $ rpm </path/to/rpmfile> krusader-x.xx.dist.rpm If the prompt returns without any message, then everything is OK. Install the binary RPM as usual, for example: $ su -c 'rpm </path/to/rpmfile> krusader-x.xx.dist.rpm' You will be asked to enter your root password. Now you can start &krusader;. For more information about RPM, visit rpm.org and read the - RPM Guide + RPM Guide by Eric Foster-Johnson. I am trying to install binary foo (RPM or DEB package), but it fails. What is wrong? Since we only prepare (and use) the source, we have no way of knowing this. Did you test the binary RPM before installing? $ rpm </path/to/rpmfile> krusader-x.xx.dist.rpm If the prompt returns without any message, then everything is OK. RPM's downloaded from our website are usually provided by &krusader; users. Visit your distro website and search for an updated RPM. If the RPM is not OK, try to find another package at &Linux; software archives such as - freshmeat.net or KDE-APPS.org. + freshmeat.net or linux-apps.com. If you still cannot find the appropriate package for your &Linux; distribution, we recommend searching for it with rpmfind or rpmpbone. In general, a package for an older version of your distribution or even for another distribution might work on your computer (⪚ FC RPM's often work on Mdk and RH, and vice versa), but it is always the best that you install only RPM's that exactly match your distribution. If you cannot find a package that matches your distribution version, architecture or distribution, then use a source RPM. When you use a source RPM, the Krusader sources will be built, on your computer, guaranteeing a suitable binary RPM for your specific distribution and architecture. In addition, this method results in maximum system speed, since the resulting binary is customized for your computer. Please read the previous question, it explains how to install a source RPM. The best solution is explained in the next question. I cannot find an RPM or DEB package for &krusader;, what to do? Check if your distribution provides &krusader;, if it does not then contact your distribution creator and ask them to include &krusader;! Did you take a look at the &URL;s on the Installation procedure page? If you have and found nothing, you can always compile &krusader; from source. Even if you feel you have not got the necessary skills, you will probably succeed in compiling &krusader;: we provide a very detailed installation procedure. This HowTo enables newcomers to compile &krusader; from source, even if they have never done a compilation from source before, just follow the instructions carefully. Feel free to post a help request if you encounter problems. Some new menu items are missing after updating &krusader;, what is wrong? The krusaderui.rc file is stored in /usr/share/kxmlgui5/krusader/krusaderui.rc. When you change the Toolbar, &plasma; makes a copy of that file in the home folder at ~/.local/share/kxmlgui5/krusader/krusaderui.rc. If &krusader; was previously installed on your computer, and you install a newer &krusader; version the ~/.local/share/kxmlgui5/krusader/krusaderui.rc file must be replaced with the newer version. Note: this will also reset all your changes on toolbars and shortcuts! The first line of krusaderui.rc contains the version number. After installing a newer &krusader; version, &plasma; will automatically replace the old ~/.local/share/kxmlgui5/krusader/krusaderui.rc with the newer version when starting the new &krusader; for the first time (&plasma; will detect the newer version number in the first line). If you install a development or beta version and &krusader; was already installed on your computer then you should delete the krusaderui.rc file from your home directory to activate the new menu entries $ rm If the ~/.local/share/kxmlgui5/krusader/krusaderui.rc file is older, then the new menu elements will not be shown. Read the previous question for information on how to update the krusaderui.rc file. If krusaderui.rc is missing or in a wrong directory, only the Help menu appears, please read the previous question. The default folder for the local configuration file kxmlgui5/krusaderui.rc is ~/.local/share. You can determine the needed folder in your system using the qtpaths --paths GenericDataLocation command in terminal. I am having trouble compiling and installing &krusader;, how do I send a help request? Please read our detailed installation procedure and the FAQ. If you cannot find a solution to your problem then feel free to post a help request at our &krusader; forum or use the - &krusader;-users mailing list. But before + &krusader;-users mailing list. But before posting a help request, please try the following: Use the search function on the &kde; Forum, your problem might be solved or discussed already. If you cannot find a solution, please make a note of the following issues: the &krusader; version used the &Linux; distribution + version used a good description of the problem Without this information, it is very difficult for us to help you. If you give us the error messages (⪚ make error messages) please start with the FIRST error message, all the error messages which follow the first error message are consequences and not the cause of your problem. Send out your help request. Thank you for your co-operation! How can I build an RPM package for &krusader;? If you have experience with compiling from source, you will probably be able to build a &krusader; RPM too. Information about RPM can be found at rpm.org and in the - RPM Guide + RPM Guide by Eric Foster-Johnson. The following is the short procedure howto on building an RPM. NEVER build RPMs when logged in as root. Mistakes in building packages (⪚ a bad krusader.spec file) can do serious damage to your system when logged in as root. Compile &krusader; from source to check that the compilation works fine. Check the ownership and the permissions on /usr/src/RPM/ and all recursive directories that your normal user can read-write-execute in these directories. Copy krusader-1.xx.tar.gz to /usr/scr/RPM/SOURCE Copy krusader.spec to /usr/scr/RPM/SPECS Edit krusader.spec and add your name, your email address, the rpm name, ... Other changes may be needed if rpmbuild fails. Build the binary and the source RPM with: $ rpmbuild /usr/scr/RPM/SPECS/krusader.spec If everything went OK you will have a binary RPM in /usr/src/RPM/RPMS/i586 (depending on your architecture) and a source RPM in /usr/src/RPM/SRPMS/ ⪚ krusader-1.70-beta1.suse10.i586.rpm and krusader-1.70-beta1.suse10.src.rpm If the build is not OK you will receive an error message during the rpmbuild process, try to fix it and run rpmbuild again. And finally: test the RPM before sending it in. Why does &krusader;-git show an old version number in the about box? Because we only change the version number just before we do a new release. &krusader;-git will show an older version number, so ignore the version number and check the download date. We simply have not yet decided what the next version number will be. Why does &krusader; not start on &MacOS;? - Please read carefully the macports.org + Please read carefully the macports.org installation instructions. Do not forget to start dbus. ########################################################## # Do not forget that dbus needs to be started as the local # user (not with sudo) before any KDE programs will launch # To start it run the following command: # launchctl load /Library/LaunchAgents/org.freedesktop.dbus-session.plist ########################################################## ###################################################### # Programs will not start until you run the command # 'sudo chown -R $USER ~/Library/Preferences/KDE' # replacing $USER with your username. ###################################################### Usage &FAQ; Why does &krusader; freeze or hang on a dead mountpoint? When &krusader; is ⪚ browsing an NFS share and the NFS server goes down, &krusader; will freeze. This &krusader; (and all other open internal viewers/editors) freeze is fatal, and can only be corrected with the kill -9. We have no solution for this. This is an issue not confined to file managers, or even the &Linux; OS! The problem is that you "hang" on the first access to the dead share - so there is no way around it, no check to avoid it, even ls will freeze. Just trying to read something - anything - is enough to get you stuck. The one and only way around this architectural problem is using a multi-threaded design - this way if we get stuck, we do not hang the entire application event loop, but we do not think that the time is right for adding threads, we are not sure that *all* the &kf5; systems out there are using &Qt;-mt (the multi threaded version of the &Qt; library), and the &krusader; Krew may not be the right people to address this major issue in any case; so currently this is just a bug we have to learn to live with. When I try to resize &krusader; to make it smaller, I discover that I cannot resize it below a certain size. Why? See the F1, F2 (&etc;) buttons? They are not allowing &krusader; to downsize as they have a minimum size. Just disable them Settings Show FN Keys Bar and you will be able to resize &krusader; to your liking. Since version 1.51 we have improved this greatly: when downsizing the buttons will look like 'F5 ..py'. When the button faces are too small to read a tooltip will give the complete text. The minimum width is 45 pixels for each button. Samba ISO 8859-x codepage / What to do if &krusader; does not read shared directories containing special international characters? &krusader; does not handle (yet) Samba ISO 8859-x codepages, if you use a codepage different than 8859-1 you will have to do a manual configuration. Create or modify the file: ~/.smb/smb.conf [global] workgroup = MyWorkGroup (ex. WORKGROUP) client code page = MyCodePage (ex. 852) character set = MyCharSet (ex. ISO8859-2) You can try to configure smb.conf with appropriate &systemsettings; module. &krusader; reports "krarc:... protocol not supported" error at opening an archive file, what to do? Install the krarc slave properly: Copy the kio_krarc.so, kio_krarc.la files into /usr/{lib or lib64}/qt5/plugins Copy the krarc.protocol file into /usr/share/services or the directory where the KIO slaves are placed in your &Linux; distribution. I get the error message "Protocol not supported by Krusader: "krarc:/path/to/foo-archive", when I try to open foo-Archive, what to do? The icons, kio_slaves and documentation must be installed in the correct places in the &kf5; directory tree. The kio_krarc.* files must be in the same directory with the other KIO slaves. Try this: locate kio_tar.* and copy/link the kio_krarc.* files to the same location. Do not forget to run # ldconfig on this directory when you are done. What to do if an external tool does not seem to work? &krusader; uses several programs as external tools, and sometimes they appear not to work. Open a terminal and check if tool foo is installed. $ foo Check if tool foo is properly configured in the Konfigurator Dependencies page. For Archiving tools: autodetect the archives again with the Auto Configure button in the Konfigurator archive page. Check the Konfigurator Protocol page If it does not work, backup your XDG_CONFIG_HOME/krusaderrc (default is $HOME/.config/krusaderc) configuration file and remove it from this location. Restart &krusader;, &krusader; will now start the first start configuration wizard, follow these guidelines. How to executing jar files (and not enter the jar archive)? Go to the Konfigurator Protocol page and remove application/x-jar from the krarc node, &krusader; should no longer enter the archive. Global file associations are handled by &plasma; and not by &krusader;. To associate the jar extension: Open &plasma; &systemsettings;: systemsettings Applications File Associations Enter jar as filename pattern Add java as application Why do I have trouble with my &FTP; connection? This problem often occurs when you are behind a firewall or proxy. Open System Settings Network Settings Connection Preferences , Enable Passive Mode (PASV) has to be turned on or off, depending on its current setting. Now try your &FTP; session again to see if it works. Also, make sure you have no other &FTP; sessions open (using web browsers, &etc;), they can cause complications. More information can be found in Active &FTP; vs. Passive &FTP;, a Definitive Explanation. I get FTP protocol not supported by &krusader; error when trying to open a remote &FTP; directory, what to do? The reason for this error is that '&FTP; via &HTTP; proxy' feature is not yet supported by &krusader;. This error may be caused by a misconfiguration of the proxy settings in &systemsettings;. Modify the proxy settings to not use &HTTP; proxy and &FTP; will work. How do not add .part suffix when copying files via &FTP;? When uploading files a .part suffix is added to the filename, once the upload is complete the filename is renamed automagically to remove the .part suffix. This works great but sometimes some &FTP; servers do not allow a rename operation. You can solve this by unchecking the checkbox Mark partially uploaded files in &plasma; &systemsettings;. The check box is located at Network Settings Connection Preferences . How can I close a remote connection (⪚ a &FTP; connection)? It is explained in the remote connections chapter. I am experiencing problems with the media:/ protocol, why? The media:/ protocol was removed since &kde; 4. Please use mtp:/ protocol instead. How can I disable the default sounds, ⪚ when I do a delete action? Those are the default &plasma; System sounds, and not related to &krusader;. If you want to disable them globally open your &plasma; &systemsettings; ( systemsettings): Personalization Notifications Manage Notifications , Event Source: "Plasma Workspace" and uncheck sound items you do not like. Where the remote connection manager? Use our Bookmark Manager. Use a remote &URL; and bookmark it. Why does not MIME type magic sometimes work inside archives? When you enter an archive and press F3 to view a file that has no known extension, ⪚ README, INSTALL &etc; And if the viewer opens in hex-mode instead of the usual mode, than you need to configure: KDE System Settings File Associations Application octet-stream , binary viewer needs to be removed. Where is Konfigurator, do i need to install the &plasma; to use it? Konfigurator is &krusader;s configuration module, if you have installed &krusader; then you have also Konfigurator. For some reason some people think it is an other &plasma; application, but it is not, so you do not need to install the full fledged &plasma; to use Konfigurator. When running &krusader;, use Settings Configure &krusader; , and it will start Konfigurator. Please read the manual, &krusader; has many many configuration options, a lot of things can be customized to your needs with Konfigurator. How can I set the look & feel of 2 different users to be the same? Presuming that the current setup is the good configuration, you can copy the configuration to the other user. # cp ~/.config/krusaderrc /home/foo_user/.config And when the other user is Root use: # cp ~/.config/krusaderrc /root/.config General &FAQ; How can I report a wish, a suggestion, or a comment? An open source project's greatest strength is derived from getting user feedback. That is why we love to hear what you have to say. Your "gripes" are our instructions. After about 6 months, programmers can no longer see their own mistakes. It is natural. We want the ideas, qritiques, and feedback because we all want to make &krusader; the best and most useful file manager available anywhere. The most convenient way to contact us is to use the krusader-users mailing list. For information on what remains to be done look at the - &krusader;-devel mailing list. We review and discuss every + &krusader;-devel mailing list. We review and discuss every submission. How can I send a patch? It is not easy to write patch guidelines, but here are some. Patches, new code or new features are always welcome! Focus only on one problem at a time, so the developers can easily understand you, and commit your patch it works. Preferably, you can start a discussion with the developers on the krusader-devel mailing lists or on the &krusader; Phabricator page. Unfortunately, we cannot apply a patch if the patch is in conflict with the "general design" of the &krusader; code (read for more instructions in this FAQ). Please send only one change request per mail, so that the discussion is easier to follow. The modifications should be committed step by step, checking each line. - Submit your patch files into the &krusader; group on the Review Board, + Submit your patch files into the &krusader; group on the Phabricator, so that all patch proposals stay organised and do not get lost, tar.gz archives or diffs are usually ok. Do not copy changes into a mail. Most mailers will change the white spaces, so that the diff will not apply or the code snipped does not diff. In the past, patch mails went lost or disorganized in many many mails, - so please use the Review Board, thanks! + so please use the Phabricator, thanks! Use portable solutions, &krusader; should run on: All POSIX (&Linux;/BSD/&UNIX;-like OSes), &Solaris;. All BSD Platforms (FreeBSD/NetBSD/OpenBSD/&MacOS;). &kde; 3.3- &kde; 3.5 and even on GNOME with &kde;libs (for &krusader;-2.x) . GCC 2.95 - GCC 5.4 Architecture changes are made by the team only. A final note: always keep in mind a patch might be rejected. Either it has side effects, which we could not fix or it contradicts with the idea behind the patched module. In this sense, a software project differs from, let's say a wiki: a software project has to have someone to make all the final decisions. Otherwise the software will not work. Furthermore: keep in mind that the examination of patches might take time, as we all have private lives. How can I report a bug? Bugs?!?!? Well, ok.... We have an online Bug Tracking System. Using the online bug-tracker helps us have a clear and orderly way to know how many bugs are open, bug priority and follow-ups. It saves us from browsing through the entire &krusader; forum, searching for yesterdays bug. Please use this system. Before reporting a bug, please read the following: Check if the bug is already posted in the online bug list of the Bug Tracking System. If you cannot find this bug mentioned, please submit it into the bug tracker by clicking the Submit New button in the bug-tracker window. Please submit the following issues: the &krusader; version used, the &Linux; distribution + version used, processor type, and as good a description of the problem as you can manage. Thank you for your co-operation! If possible, try to do the same operation with &konqueror; or another &kde; application. If you encounter the same problem then it is possibly a KIO Slaves or &kf5-full; bug, and not a &krusader; bug. &krusader; uses the &kf5; libraries and the KIO Slave for many operations. In some cases you can encounter problems if your distribution is incorrectly configured, please test it first as explained above. How can i send good debug or crash reports? Usually binary packages that are been used by your distribution do not contain debug information. Since we usually only develop and fix &krusader;-git, compile &krusader;-git in debugmode and install it, than check if the bug still exist. $ cmake Install valgrind, a suite of tools for debugging and profiling &Linux; programs. Run Valgrind/&krusader; $ valgrind {foo_path}/krusader The valgrind tool will write to stdout, what really happens. If you could send these information before the crash, it is almost sure, that we may fix or tell you what to do. What to do if the KDEcrashhandler sends no useful backtrace information? Usually binary packages that are been used by your distribution do not contain debug information. Since we usually only develop and fix &krusader;-git, compile &krusader;-git in debugmode and install it, than check if the bug still exist. $ cmake If the KDEKrashhandler still does not provide useful backtrace information, than sometimes a coredump will give better information. Run Krusader, with disabled crashhandler. $ krusader On a crash you will get a .core file, usually in your home directory. - Run gdb, the GNU Project Debugger + Run gdb, the GNU Project Debugger $ gdb corefile krusader Now type bt to get the backtrace and type q to quit gdb. Often the best debug results will be given when using the valgrind tool. Does &krusader; have a mailing list? Yes, currently we have 5 mailing lists. No spam, no bother, just &krusader;. Feel free to subscribe and unsubscribe. Tip. our mailing lists can be browsed online or read with a newsreader, so that you do not even need to subscribe to follow the action on the mailing lists. - &krusader;-devel is the developer + &krusader;-devel is the developer mailing list (read-only). If you want to follow the development of &krusader; on the cutting edge, this is the list to follow. - &krusader;-users is the + &krusader;-users is the &krusader; users mailing list. Here you can ask for help and talk with the &krusader; users and developers. Does &krusader; provide news feeds? Yes, we do. Several news feeds in various formats - are available. krusader-devel feed, krusader-users feed. + are available. krusader-devel feed, krusader-users feed. Does &krusader; have an IRC channel? Yes, we do. Feel free to talk to the &krusader; Krew and fellow-users via freenode.org servers. The server is irc.freenode.org, the channel is #krusader. Everyone is welcome. How does the &krusader; forum work? In the spirit of freedom of speech, everything that is &krusader; related can be discussed in our forum. It does not matter if you are a newcomer or an advanced user, everyone is welcome. An open source project's greatest strength is derived from getting user feedback. That is why we love to hear what you have to say. With your feedback we can make &krusader; better and better; otherwise, we are not aware of issues and ideas you may have. But please remember the following, so that we can maintain some order in the chaos. If the Documentation, FAQ and - &krusader;-devel (please use the search function + &krusader;-devel (please use the search function ) cannot help you, do not hesitate to post on our forum. The &krusader; Krew or the &krusader; community is always available to help you. Please use the search function of the &kde; Forum, your issue may have been previously discussed (this allows us to minimize the double/triple/... postings). If your issue has already been discussed in the past there is a great chance that you will have an instant solution to your problem. If the issue is currently being discussed, you can join in the discussion. Some questions are asked over and over again, that is why we have created this FAQ. This allows us to spend more time developing &krusader;. - Thank you for your co-operation! How can I translate &krusader; into my native language? If you are interested in translating the &krusader; GUI or documentation, please contact the - KDE translation team of your language. + KDE translation team of your language. How can I support &krusader;? You can support &krusader; in many different ways. Please send us feedback, bug reports, patches, donations, translations, ... Is there a &MacOS; X port? Yes, there is a &MacOS;-X port - with the help of macports.org , the port is - maintained by Jonas Bähr, + with the help of macports.org , the port is + maintained by Jonas Bähr, all feedback is welcome. A recommended native file manager for &MacOS; is Disk Order (shareware). Is there a &Windows; port? No, there was a port but it is unmaintained and unavailable now. A recommended native file manager for &Windows; is - Total Commander (shareware). + Total Commander (shareware). If you want to help with porting please join The KDE on Windows Initiative. Some useful tips on porting can be found in the INSTALL file of the &krusader; sources, it contains all latest compilation instructions. Why is &konqueror; in "midnight commander style" not an OFM? The two panels and a commandline are available, all the other stuff like OFM features and the OFM interaction with the user is missing from this profile. Why should I use an OFM? An Orthodox File Manager (OFM) is much faster than a one panel filemanager and faster than the command line. If you would like to know how &krusader; feels, there is only one way to discover: install it on your computer and use it for a while. If you prefer to waste time and lose productivity, continue to use one panel filemanagers which are based on &Windows; Explorer. Matej Urbančič has written a blog on why OFM is better than a one panel filemanager. diff --git a/doc/features.docbook b/doc/features.docbook index 75b39325..cffa00e8 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. 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 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 + &kompare;, KDiff3 or xxdiff. Rename files and - folders via KRename + 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 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. 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/glossary.docbook b/doc/glossary.docbook index 859d0093..0e400cf9 100644 --- a/doc/glossary.docbook +++ b/doc/glossary.docbook @@ -1,379 +1,379 @@ Glossary This chapter is intended to explain the various words which have been used throughout the &krusader; documentation. If you believe some acronyms or terms are missing, please do not hesitate to contact the &krusader; documentation team. Thanks to - wikipedia.org the + wikipedia.org the free encyclopedia that anyone can edit. ACL - + Access Control List; a concept in computer security used to enforce privilege separation. It is a means of determining the appropriate access rights to a given object depending on certain aspects of the process that is making the request. BSD - Berkeley + Berkeley Software Distribution; refers to any of several free &UNIX;-compatible operating systems, derived from &BSD; &UNIX;. CVS - + Concurrent Versions System; an important component of Source Configuration Management (SCM). By using it, developers can record the history of source files and documents. DEB This is a binary file format that is used by - + Debian and Debian-based distributions. It is a suffix of a installation file specifically built for these distributions; ⪚ krusader_1.70.1-1_amd64.deb. Simply described it is a special archive containing all the program files and their proposed location on the system. &DBus; - &DBus; is an inter-service messaging system. + &DBus; is an inter-service messaging system. Developed by &RedHat;, it was heavily influenced by &kde; 3 &DCOP;, which it supersedes. &krusader; can use &DBus; to communicate with other applications. On the other hand, you can use &DBus; to control &krusader; from other applications. Just use qdbusviewer to examine the possibilities. &DCOP; - Desktop + Desktop Communication Protocol; the interprocess communication protocol used by &kde; 3 desktop environment. It enables various &kde; 3 applications to communicate with each other. Replaced with &DBus; in &kde; 4. FAQ Frequently Asked Questions; a document where questions that arise many times are answered. If you have a question to the developers of &krusader;, you should always have a look at the FAQ first. &FTP; - + File Transfer Protocol; it is an Internet protocol that allows you to retrieve files from so-called &FTP; servers. Git - + Git; a distributed version control system that replaces Subversion. It is used by many software projects including &kde; and &krusader;. GPL - GNU General + GNU General Public License; a software license created by the - Free Software + Free Software Foundation defining the terms for releasing free software. &GUI; - + Graphical User Interface. ISO An - ISO + ISO image (.iso) is an informal term for a disk image of an ISO 9660 file system. More loosely, it refers to any optical disk image, even a UDF image. &kde; - K Desktop + K Desktop Environment; a project to develop a free graphical desktop environment for &UNIX; compatible systems. Key Binding All features of &krusader; are available through the menubar, but you can also bind (link) a certain key combination to that function. You will find, however, that using the keyboard is remarkably faster than using the menubar or GUI. Keyboard usage is an important tool for Orthodox File Managers. &krusader; comes with several predefined Key Bindings. KPart - KPart; + KPart; KParts is the name of the component framework for the &kde; desktop environment. KParts are - analogous to Bonobo components in GNOME, + analogous to Bonobo components in GNOME, both of which are based on the same concepts as &Microsoft;'s Object Linking and Embedding. ⪚ if you use &krusader;'s viewer to view a PDF file, &okular; will be launched inside &krusader;'s viewer. KIO or kioslave - KDE + KDE Input/Output; also known as KIO Slaves is part of the &kde; architecture. It provides access to files, web sites and other resources through a single consistent API. mount - + Mounting; in computer science, is the process of making a file system ready for use by the operating system, typically by reading certain index data structures from storage into memory ahead of time. The term recalls a period in the history of computing when an operator had to mount a magnetic tape or hard disk on a spindle before using it. OFM Orthodox File Manager; also known as "Commanders". Members of this family of file managers use simple yet very powerful interface that is a direct derivative of the - + Norton Commander (NC) interface. RPM This is the binary file format for distributions based on the RPM Package Manager, a widely used packaging tool for the &Linux; operating system. If you still have to get &krusader; and your system supports RPM packages, you should get &krusader; packages ending in .rpm. SSH, Secure Shell - SSH; + SSH; is a set of standards and an associated network protocol that allows establishing a secure channel between a local and a remote computer. SVN, Subversion - + Subversion; a version control system that is a compelling replacement for CVS. It is used by many software projects including &kde;. Terminal emulator - + Terminal emulator; simply a windowed shell; this is known as command line window in some other environments. If you want to use the shell and type the commands, you should know at least a few of the system-level commands for your operating system. POSIX - Portable + Portable Operating System Interface for uniX; a collective name of a family of related standards specified by the IEEE to define the application programming interface (API) for software compatible with variants of the &UNIX; operating system. &URL; - Universal + Universal Resource Locator; a universal resource locator is the technical term for what is commonly referred to as a websites address. Examples of &URL;s include - - http://krusader.sourceforge.net and + + https://krusader.org and Remote Connections. VFS Virtual file systems (VFS) is a basic OFM feature, 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 file systems transparently - just like entering an ordinary sub-directory! &krusader; supports several Virtual file systems (VFS). &XML; - Extensible + Extensible Markup Language; a very flexible text format derived from SGML (ISO 8879). Originally designed to meet the challenges of large-scale electronic publishing, &XML; is also playing an increasingly important role in the exchange of a wide variety of data on the Web and elsewhere. Zeroconf - Zeroconf; + Zeroconf; or Zero Configuration Networking is a set of techniques that automatically create a usable IP network without configuration or special servers. This allows inexpert users to connect computers, networked printers, and other items together and expect them to work automatically. diff --git a/doc/help.docbook b/doc/help.docbook index 0de1ec7f..88a52037 100644 --- a/doc/help.docbook +++ b/doc/help.docbook @@ -1,119 +1,119 @@ Help &krusader; Help Here is your opportunity to contribute to the &krusader; project. There are things that need to be done, but cannot be done by us. If you feel you can help, do not hesitate to contact us; every OpenSource can use some help. Please also check the contribute donate &URL; page on our website for more recent information. Thanks! - To get contributor account and commit changes to &krusader; by yourselves you should follow this tutorial. Some useful advices on using &kde; Git can be found here. It is a good practice to use review board for the non-trivial patches. + To get contributor account and commit changes to &krusader; by yourselves you should follow this tutorial. Some useful advices on using &kde; Git can be found here. It is a good practice to use review board for the non-trivial patches. Documentation Help is needed (we are looking for documentation writers) for keeping the &krusader; documentation up to date. The draft explanation of new features is done by the developers - on the krusader-devel mailing list, but we need editors to add + on the krusader-devel mailing list, but we need editors to add this information in the handbook. By playing with the new features these editors can give valuable information to the developers for making the new features even better! &krusader; Extensions Please upload your favourite extensions at store.kde.org, so that they become available for the &krusader; community. Maybe they will be shipped by default with &krusader; at the next release :-)). Spread the Word &krusader; If you like &krusader;, let people know! Write articles and reviews for internet or print publications. Encourage your friends to give &krusader; a try. Participate in forums to help others in the community. GUI Translations &krusader; is available in many languages, but sometimes translations do need an update or translations to new languages are always welcome. If you are interested in translating the &krusader; GUI, please contact the - &kde; translation team of your language. + &kde; translation team of your language. Documentation Translations If you are interested in translating this &krusader; documentation, please contact the - &kde; translation team of your language. + &kde; translation team of your language. Donations Actually, we had not considered donations, until users asked - us for a way to Donate to the project. + us for a way to Donate to the project. &krusader; is, and always will be free, in all the terms of the GNU Public License. Packagers We are always in need of packagers for different distro rpm's, deb's, etc. All help is welcome. Users' feedback for the &krusader; &MacOS; X port There is a &MacOS;-X port - with the help of macports.org , the port was + with the help of macports.org , the port was maintained by Jonas Bähr, all feedback is welcome. FAQ If you have a question that is missing in the FAQ, we would like to hear it. Rate &krusader; - On some websites like freshmeat.net or - KDE-APPS.org you can give a rate, if you like + On some websites like freshmeat.net or + linux-apps.com you can give a rate, if you like &krusader; go to one of these sites and rate &krusader;, thanks. Others Feedback, Bug reports, patches, &etc; are always welcome! An open source project's greatest strength is derived from getting user feedback. diff --git a/doc/index.docbook b/doc/index.docbook index e27ee1cc..bc2a1713 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -1,371 +1,371 @@ ]> The &krusader; Handbook Davide Gianforte Developer
davide@gengisdave.org
Toni Asensi Esteve Developer
toni.asensi@kdemail.net
Alexander Bikadorov Developer
alex.bikadorov@kdemail.net
Martin Kostolný Developer
clearmartin@gmail.com
Nikita Melnichenko Developer
nikita+kde@melnichenko.name
Yuri Chornoivan Documentation
yurchor@ukr.net
Shie Erlich Author and initial Handbook author (retired)
erlich@users.sourceforge.net
Rafi Yanai Author and initial Handbook author (retired)
yanai@users.sourceforge.net
Csaba Karai Developer (retired)
ckarai@users.sourceforge.net
Heiner Eichmann Developer (retired)
h.eichmann@gmx.de
Jonas Bähr Developer (retired)
jonas.baehr@web.de
Václav Jůza Developer (retired)
vaclavjuza@seznam.cz
Simon Persson Developer (retired)
simon.persson@mykolab.com
Jan Lepper Developer (retired)
jan_lepper@gmx.de
Andrey Matveyakin Developer (retired)
a.matveyakin@gmail.com
Dirk Eschler Webmaster (retired)
deschler@users.sourceforge.net
Frank Schoolmeesters Documentation and Marketing coordinator (retired)
frank_schoolmeesters@yahoo.com
Richard Holt Documentation and Proofing (retired)
richard.holt@gmail.com
Matej Urbančič Marketing and Product Research (retired)
matej.urban@gmail.com
2000 2001 2002 2003 Rafi Yanai Shie Erlich 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018 Krusader Krew Permission is granted to copy, distribute and/or modify this document under the terms of the - GNU Free + GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the &krusader; sources. 2018-08-12 2.7.1 &krusader; is an advanced, twin-panel (commander-style) file-manager for Plasma and other desktops in the *nix world KDE krusader commander filemanager twinpanel linux file manager dual pane linux-commander kde-commander &help; &editors-note; &introduction; &features; &user-interface; &basic-functions; &advanced-functions; &menu-commands; &keyboard-commands; &mouse-commands; &krusader-tools; &konfigurator; &faq; &credits-and-license; &installation; &configuration-files; &useraction-xml; &release-overview; &glossary; &documentation.index; diff --git a/doc/installation.docbook b/doc/installation.docbook index 86590ab8..b0aa9052 100644 --- a/doc/installation.docbook +++ b/doc/installation.docbook @@ -1,727 +1,727 @@ Installation of Krusader Installation Requirements In order to successfully use the most recent &krusader;, you need &kf5; >= 5.18 Required &kde; version: &krusader; v1.01: &kde; 2 &krusader; v1.02 - 1.40: &kde; 3.0 - &kde; 3.2 &krusader; 1.40: prefers &kde; 3.2 (otherwise all features will not be available) &krusader; v1.50 - v1.51: &kde; 3.2 - &kde; 3.3 (Konfigurator crash on &kde; 3.4) &krusader; v1.60.0 - v1.70.0: &kde; 3.3 - &kde; 3.5 &krusader; 1.70.x: prefers &kde; >= 3.4 (otherwise all features will not be available) &krusader; 1.80.0: &kde; 3.4 - &kde; 3.5 &krusader; 1.90.0: &kde; 3.2 - &kde; 3.5 &krusader; v2.4.x: &kde; 4.x &krusader; v2.5.x: &kf5-full; Platforms: All POSIX (&Linux;/BSD/&UNIX;-like OSes), &Solaris; All BSD Platforms (FreeBSD/NetBSD/OpenBSD/&MacOS;) In order to handle archives, checksums and other utilities they must be configured in our configuration tool. When running &krusader; for the first time the available utilities will be autodetected, and a report will be shown in the first lanch wizard. Afterwards additional utilities can be added/removed/changed. A package of popular (un)packers, &krusader; itself and add-ons can be found on the &krusader; download page. For more requirements, see below. Have a look at the FAQ section as well. Obtaining &krusader; The latest information about &krusader; can be - found on the Krusader website . + found on the Krusader website . &krusader; Downloads It is recommended to use the &krusader; package that is provided by your distribution. - Distrowatch.com is a great resource to check + Distrowatch.com is a great resource to check the availability. If your distribution does not offer &krusader;, please contact the creators of your distribution and ask them to provide a &krusader; package The latest version, as well as the older versions, can be found on the &krusader; download page (current version) and on the Sourceforge mirrors (outdated versions). It contains the source tarballs, RPM and DEB packages to whatever distro the &krusader;-Krew is using and packages build by &krusader; users and third parties. Distributions who provide &krusader;: &SuSE; Fedora via # dnf install krusader will do the job. - Debian, on our + Debian, on our &krusader; download page you might find more recent DEB packages. Note: usually Debian packages work also on distributions that are "based on Debian", and some of these provide their own (incompatible) packages. - Ubuntu/Kubuntu, + Ubuntu/Kubuntu, Knoppix 4.x DVD, Kanotix, &etc; Mageia via the contrib repository # urpmi krusader will do the job. - Gentoo. + Gentoo. Arch Linux, Frugalware Linux, PCLinuxOS, ALT Linux. - FreeBSD, the port was + FreeBSD, the port was maintained by Heiner Eichmann. - NetBSD, + NetBSD, Lunar Linux ,Ark Linux, OpenLX. More distributions can be found with - Distrowatch.com. + Distrowatch.com. Use the installation tools included in your distro to install the &krusader; package. You might need an internet connection if &krusader; is not included on the &CD; or DVD. There are probably other distributions which include &krusader;. If you know of one, please send feedback so that we can include it on the distrolist. Others Slackware txz binaries can usually be found ion the Slackware package repositories. There is a &MacOS;-X port. Search engines You can also find packages on &Linux; software archives such as freshmeat.net. If you can not find a package for your distribution, we recommend searching for it with rpmfind, rpmpbone or rpmseek. If you enjoy using &krusader;, we would appreciate it if you went to one of these sites and rated it. If you still can not find a package, follow the installation procedure on how to compile &krusader; from source. This very thorough HowTo describes the process in such detail that even newcomers should not have any problems. Version Scheme A new version scheme has been used since &krusader;-1.60.0 First digit - the major version Second digit(s) - percentage of features completed for this major version Third digit(s) - bugfixes. In essence, releasing &krusader;-1.60.0 means that we believe that &krusader; is about 60% done with all the features we had scheduled for the 1.x.x series. Series up to 2.4.x are &kde; 4.x releases. 2.5.x series are the releases for &kf5-full;. Hopefully, it is easy to understand. Stable Version krusader-x.xx.tar.gz &krusader; is released under the &GNU; General Public License (GPL). This means that THE PROGRAM IS PROVIDED "AS IS" WITH NO WARRANTY OF ANY KIND, even when it is marked as a stable release. Development Version (beta release) krusader-x.xx-betax.tar.gz Before every stable release we release at least one development version in order to hunt down the bugs. These releases are beta releases and will probably contain some bugs. 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! The beta release has 3 goals: Apply a feature-freeze until the stable is released, only bugs will be fixed. New features have to wait until the stable is released. Obtain feedback from &krusader; users so that we can fix the bugs. Give translators time to update the translations for the coming stable release. Git Git is used for our sourcecode repository. It is also possible to Browse the Git Repository. To check out the latest development &krusader; 2.x for &kf5-full; from Git: $ git Older Releases If you are looking for older releases we recommend the Sourceforge mirrors, available from our project page. Krusader installation instructions Please read the INSTALL file of the Krusader sources, it contains all latest installation instructions. From version &krusader;-2.5.0 and higher is &kf5-full; only. krusader_version.tar.gz is the supposed name of the krusader tarball (it will be probably a different one ;) You can download the latest available &krusader;-2.x from Git. Krusader dependencies The next packages are needed to run the Krusader binary. c libraries plasma-framework libraries (&kde; Frameworks core libraries and binaries for &kf5-full; applications) libqt5dbus5 (&Qt; 5 D-Bus module) libqt5xml5 (&Qt; 5 &XML; module) libqt5core5 (&Qt; 5 core module) libqt5gui5 (&Qt; 5 &GUI; module) libqt5printsupport5 (&Qt; 5 print support module) Suggested packages These packages are optional but they will make &krusader; much more powerful and useful. The next packages are the names that Debian/Ubuntu uses, other Linux distros will probably use similar names. arj: archiver for .arj files ark: graphical archiving tool by KDE bzip2: high-quality block-sorting file compressor - utilities cpio: GNU cpio -- a program to manage archives of files kdiff3: compares and merges 2 or 3 files or directories OR kompare: a KDE GUI for viewing differences between files OR xxdiff: a graphical file and directories comparison and merge tool kmail: KDE Email client okteta: KDE hex editor konsole: X terminal emulator by KDE krename: Powerful batch renamer by KDE lha: lzh archiver md5deep: versatile file checksum creator and verifier cfv: versatile file checksum creator and verifier p7zip: 7zr file archiver with high compression ratio rpm: Red Hat package manager unace: extract, test and view .ace archives unrar: Unarchiver for .rar files (non-free version) OR unrar-free: Unarchiver for .rar files OR rar: Archiver for .rar files unzip: De-archiver for .zip files zip: Archiver for .zip files Compilation requirements The next packages are needed for compiling Krusader, if you only run a Krusader binary you do not need these packages. gcc (The GNU C compiler) g++ (The GNU C++ compiler) cmake (A cross-platform, open-source make system) zlib1g-dev: (library for implementing the deflate compression method found in gzip and PKZIP) gettext (contains msgfmt) plasma-framework-dev (installs many development libraries for &kf5;) kio-dev libkf5archive-dev libkf5parts-dev libkf5wallet-dev libkf5xmlgui-dev kdoctools-dev Installing on &Linux; and &BSD; platforms Please read the INSTALL file of the Krusader sources, it contains all latest installation instructions. -DQT_INCLUDES=/usr/share/qt5/include is the location of the &Qt; 5 includes -DCMAKE_INSTALL_PREFIX=/usr/ is the location where Krusader will be installed with the make command. Another example is: -DCMAKE_INSTALL_PRFIX=/opt/krusader to install the compiled Krusader in an other directory to not overwrite the Krusader version installed by your package manager. Please use sudo instead of su -c if you are using Ubuntu-based systems. $ tar -xzvf $ cd $ mkdir $ cd $ cmake $ make $ su Uninstall $ su -c "make uninstall" Installing on the &MacOS;-X platform Please read the INSTALL file of the Krusader sources, it contains all latest installation instructions. With &kde;-4 Krusader runs natively on &MacOS;-X, using its Aqua user interface (No more X11 needed!). With the help of macports.org , &krusader; is ported to &MacOS;-X, - the port was maintained by Jonas Bähr. + the port was maintained by Jonas Bähr. A portfile is provided. $ sudo port install krusader Starting &krusader; Type krusader (lower case) at a command prompt. You can create shortcut on your desktop or create an entry in the menu. Read the previous page and the FAQ if &krusader; does not start. When &krusader; is started from the command line, various options can be specified to modify its behavior. $ krusader Do not worry about the messages you get in the &konsole;. These messages are log messages that can be used for debugging &krusader;. You can also use &Alt; F2 to open the Run Command dialog box, type krusader (lower case) and press &Enter; or click on the Run button. If &krusader; is installed by an RPM or DEB package then usually &krusader; can be started from the &kmenu;. Click on the application launcher button and choose Applications Utilities &krusader; . Command-line options: <path> start left panel at <path> <path> start right panel at <path> <path1>,<path2>,<path3> start left panel at <path1>,<path2>,<path3>, with tabs. <panel-profile> load a panel-profile on startup (this overrides the default startup profile). Examples: $ krusader --left=<path> --right=<path> $ krusader --left=/mnt/cdrom --right=ftp://downloads@myserver.net $ krusader --left=<path1>,<path2> --right=<path1>,<path2>,<path3> $ krusader --profile <panel-profile> $ krusader --profile ftp-managment The standard &Qt; and &kf5; command-line options are available. Other command-line options: Show the authors names Show license information Configuring &krusader; When you run &krusader; for the first time, the &krusader; configuration module Konfigurator will show up and allow you to configure &krusader; as well as detect installed packers and tools. You can always run Konfigurator again from the Settings menu. Making &krusader; the default file manager To make &krusader; the default file manager in Gnome, click here for more information. To make &krusader; the default file manager in - &plasma;, click here for more information. + &plasma;, click here for more information. diff --git a/doc/introduction.docbook b/doc/introduction.docbook index c9b3295d..da10b1e1 100644 --- a/doc/introduction.docbook +++ b/doc/introduction.docbook @@ -1,162 +1,162 @@ Introduction Introduction Package description &krusader; is a simple, easy, powerful, twin-panel file manager (commander-style) for &plasma; and other *nix desktops, similar to Midnight Commander or Total Commander. It provides all the file management features you could possibly want. Krusader also includes extensive archive handling, mounted file system support, &FTP;, advanced search module, viewer/editor, directory synchronization, file content comparisons, powerful batch renaming and much, much more. &krusader; supports archive formats: ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip and 7-zip and handles other KIO Slaves such as smb:// or fish://. &krusader; is almost completely customizable and therefore very user-friendly. Try &krusader;.
&krusader; screenshot &krusader; screen shot
- More &krusader; Screenshots can be viewed on + More &krusader; Screenshots can be viewed on our website. Welcome to &krusader;! Our aim is to give you a simple, intuitive tool that easily handles the most important tasks you perform on your computer each and every day: manage and process your files the way you want. Whether you are a &Linux; expert or a novice, &krusader; makes routine file management tasks quick and accurate, allowing you to focus on the big picture, not command line syntax. This is especially helpful if you are new to xxNIX operating systems. To do just that, &krusader; uses a good-looking &GUI; and supports drag and drop as well as MIME types, making it easy to use. &krusader; has many useful features. It is fast, and handles archives transparently. In addition, &krusader; streamlines many complex file management tasks, reducing fatigue, errors, and distraction. Basically, &krusader; provides all the helpful features you have come to expect from other quality file management tools like Midnight Commander and Total Commander. &krusader; is designed to integrate seamlessly with the &plasma;, the desktop of choice for many programmers, network engineers, and other power users of &Linux;. With &krusader; even novice users can quickly access the power, convenience, and feature rich capabilities of the &plasma;. &krusader; is a free open-source project, and it is released under the &GNU; General Public License (GPL), although the developers still retain the copyright for the project and its name, and manage the project's continuing evolution. The &krusader; Project mission is to create an "all-in-one" file manager, which will do all the ordinary things you would expect of it, and more. Since the principle behind &krusader; is based on the Orthodox File Manager (OFM), dual-pane filemanagers (Midnight Commander, Norton Commander, &etc;), it is certain that &krusader; is able to handle all the standard Copy, Move, Delete, &etc; file operations. From the start, virtual file systems became the main focus. Virtual file systems (VFS) are 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 allow the user to access all the information in these divergent types of file systems transparently - just like entering an ordinary sub-directory. Files can then be copied or moved around (except ISO, rpm, tar.gz) between these data sources/containers effortlessly. &krusader; currently supports VFSs for all popular and some specialized types of archives (ace, arj, bzip2, gzip, iso, lha, rar, tar, zip and 7-zip), configuration packages (rpm, deb), and traditional remote file system types (&FTP;, NFS, Samba, FISH, SFTP). &krusader; also includes a built-in Mount-Manager MountMan, which enables you to mount or unmount file systems of all types with a click of a mouse. The user is able to obtain usage and other property information easily, in a consistent and understandable format in seconds. Ease and consistency is the goal. A Bookmark-Manager for local files/remote &URL;s and an Advanced Search module is also included to speed the locating of needed files. &krusader; also allows the user to configure Toolbars in order to provide a wide variety of additional functionality, such as File Comparison (several user selectable methods available), Multiple File Rename, and standard Terminal windows. Advanced users benefit greatly from being able to carry out clerical tasks effortlessly, without distraction from the real task at hand. Convenient shortcut keys enable the user to navigate directory trees with ease, create multiple tabbed directory views simultaneously, and access fully functional history lists. Due to efficient programming and low system overhead, &krusader; is perhaps the most responsive all around system management tool used to access the full potential of a computer using &plasma;, or any other standards compliant &X-Window; window manager. Although designed specifically for - and tightly integrated with - &plasma;, &krusader; works equally well with GNOME, MATE, Enlightenment, &windowmaker;, IceWM, XFCE, &etc;, as long as the &kf5; libraries are installed. New extensibility is provided by the flexible UserActions, a &krusader; innovation that allows unlimited additional custom functionality to be added to suit the specific needs of users. We are planning to develop more modules in the near future, thereby enhancing &krusader;. Information on what is proposed, approved, or remains to be completed can be found in the &krusader; Phabricator page. No other program we know of, offers so many useful, easily accessible features in such an intuitive and simple format. Best of all, we listen, and implement good suggestions that are consonant with the &krusader; Project's goal: making &krusader; the very best File Manager available. We hope you will enjoy it - we do! diff --git a/doc/keyboard-commands.docbook b/doc/keyboard-commands.docbook index 113e0ac8..36b72f22 100644 --- a/doc/keyboard-commands.docbook +++ b/doc/keyboard-commands.docbook @@ -1,2015 +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. &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 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 ccf4f3d9..2d86d0af 100644 --- a/doc/konfigurator.docbook +++ b/doc/konfigurator.docbook @@ -1,2064 +1,2063 @@ 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. 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 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 + 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 + By default &kompare; is used as external diff utility but you can also use your favorite diff utility ⪚ - xxdiff or KDiff3, just fill + 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/krusader-tools.docbook b/doc/krusader-tools.docbook index a3202e88..cb8768e4 100644 --- a/doc/krusader-tools.docbook +++ b/doc/krusader-tools.docbook @@ -1,33 +1,33 @@ &krusader; Tools &bookmarks; &diskusage; &search; &viewer-editor; &locate; &mount; &remote-connections; &synchronizer; &krusader-useractions; diff --git a/doc/locate.docbook b/doc/locate.docbook index f671e57a..7243fe07 100644 --- a/doc/locate.docbook +++ b/doc/locate.docbook @@ -1,131 +1,131 @@ Locate &GUI; Frontend Locate &krusader; has a &GUI; front end for the locate command (findutils). Locate is used for fast file searching not from a directory but a database. The package contains among other files, locate and updatedb. updatedb goes through the local file system and stores the file entries in the database. cron often calls updatedb every night (set with KCron). Choose Tools Locate or &Ctrl;&Shift; L to start this feature. Konfigurator can set additional arguments for updatedb. Checkbox Options Show only the existing files: if the database contains entries which no longer exist any more (deleted, moved since the last updatedb), locate does not list them. It checks the existence of each file before the listing in the results window (slow). Case Sensitive: unchecking it allows lower and upper case search. Action buttons Locate: executes locate foo foo and places its output into the results window. Stop: stops the locating process. UpdateDB: starts updatedb for updating the locate database after entering the root password. Close: closes the locate window. Results window Double-click on an item: steps to its directory, makes the item visible and closes the locate dialog. Right click: edits/views/finds the menu. F3: views the current item. F4: edits the current item. &Ctrl; F: finds files in the results window. &Ctrl; N: shows the next search result. &Ctrl; P: shows the previous search result. The results window supports dragging items to other windows and copy to clipboard (&Ctrl;C). diff --git a/doc/man-krusader.1.docbook b/doc/man-krusader.1.docbook index 04dc6602..e68c16e4 100644 --- a/doc/man-krusader.1.docbook +++ b/doc/man-krusader.1.docbook @@ -1,306 +1,306 @@ ]> KDE User's Manual KrusaderKrew Krusader man page. krusader-devel@googlegroups.com 2017-05-06 Krusader krusader 1 krusader advanced twin-panel file manager and &FTP; client by KDE krusader Options url Description Krusader is an advanced twin panel (commander style) file manager for Plasma and other desktops in the *nix world, similar to Midnight or Total Commander. It provides all the file management features you could possibly want. Plus: extensive archive handling, mounted filesystem support, &FTP;, advanced search module, viewer/editor, directory synchronization (disabled by default), file content comparisons, powerful batch renaming and much much more. It supports the following archive formats: ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, xz, zip, and 7-zip and can handle other KIOSlaves such as smb:// or fish:// It is (almost) completely customizable, very user friendly, fast and looks great on your desktop! :-) You should give it a try. Options this lists the options available at the command line lists version information for &krusader; show the authors show the license <path> start left panel at <path> <path> start right panel at <path> <panel-profile> load <panel-profile> on startup enables debug output if there is already a tab open with that url, it is activated, otherwise a new tab is opened in the active panel Examples $ krusader --left=/mnt/cdrom --right=ftp://downloads@myserver.net $ krusader --left=/home,/usr,smb://workgroup.net --right=fish://myserver.net $ krusader --profile=ftp_managment Files Configuration files: ~/.config/krusaderrc ~/.local/share/krusader/krbookmarks.xml or krusader/krbookmarks.xml in the directory which can be determined using the qtpaths --paths GenericDataLocation command ~/.local/share/krusader/useractions.xml or krusader/useractions.xml in the directory which can be determined using the qtpaths --paths GenericDataLocation command /usr/share/kxmlgui5/krusader/krusaderui.rc ~/.local/share/kxmlgui5/krusader/krusaderui.rc or kxmlgui5/krusader/krusaderui.rc in the directory which can be determined using the qtpaths --paths GenericDataLocation command Platforms All POSIX: Linux, Solaris, All BSD Platforms: FreeBSD, MacOS-X KDE 2.x krusader v1.01 stable but there are no planned changes. KDE 3.x Krusader v1.01 needs KDElibs 2 Krusader v1.02 - 1.40 needs KDElibs 3 Krusader 1.40 prefers >= KDE 3.2 Krusader v1.50 - v1.51: KDE 3.2 - KDE 3.3 Krusader v1.60.0- v1.70.0: KDE 3.3 - KDE 3.4 Krusader 1.70.x-1.80.x: KDE 3.4 - KDE 3.5 KDE 4.x Krusader 2.0-2.4: KDE 4 KDE Frameworks 5 Krusader 2.5 and newer The latest version of Krusader can be found at the Krusader website. Features OFM filemanager features. Strong keyboard orientation. Powerful internal viewer and editor. Advanced search module that can search in archives. Supports: ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, xz, zip, and 7-zip. Directory comparison and filtering. &FTP;/Samba client with a connection manager with SFTP/SCP support. Synchronizer, UserActions, Embedded console. Compare files by content. Easy editing of file permissions. Diskusage, Calculate occupied space. Checksum creation-verification. Fully MIME type-aware (with or without magic!). Mountmanager, Locate, Krename support. Root mode, Tabbed panels, Sidebar. Mouse selection modes. Profiles for: Panels, Key-bindings, Colors. -For more features read http://docs.kde.org/development/en/extragear-utils/krusader/features.html +For more features read https://docs.kde.org/development/en/extragear-utils/krusader/features.html License Krusader is distributed under the terms of the GNU General Public License. License version 2 as published by the Free Software Foundation. See the built-in help for details on the License and the lack of warranty. The copyright for the project and its name are still held by Shie Erlich and Rafi Yanai. i18n Krusader is translated into many languages. -http://l10n.kde.org/stats/gui/trunk-kf5/po/krusader.po/ +https://l10n.kde.org/stats/gui/trunk-kf5/po/krusader.po/ -Read the KDE translation howto if you want translate Krusader in your native language. +Read the KDE translation howto if you want translate Krusader in your native language. FAQ -The latest version of the KRUSADER FAQ can be found on KDE documentation site. +The latest version of the KRUSADER FAQ can be found on KDE documentation site. See Also The Krusader Handbook, at the krusader help menu. kf5options(7) qt5options(7) Authors Krusader is developed by a dedicated team of individuals, known as the Krusader Krew. Shie Erlich, author [erlich {*} users {.} sourceforge {.} net] (retired) Rafi Yanai, author [yanai {*} users {.} sourceforge {.} net] (retired) Dirk Eschler, Webmaster [deschler {*} users {.} sourceforge {.} net] (retired) Csaba Karai, Developer [ckarai {*} users {.} sourceforge {.} net] (retired) Heiner Eichmann, Developer [h {.} eichmann {*} gmx.de] (retired) Jonas Baehr, Developer [jonas.baehr {*} web.de] (retired) Vaclav Juza, Developer [vaclavjuza {*} seznam {.} cz] (retired) Jan Lepper, Developer [jan_lepper {*} gmx {.} de] (retired) Andrey Matveyakin, Developer [a.matveyakin {*} gmail {.} com] (retired) Davide Gianforte, Developer [davide {*} gengisdave {.} org] Alexander Bikadorov, Developer [alex.bikadorov {*} kdemail {.} net] Martin Kostolny, Developer [clearmartin {*} zoho {.} com] Toni Asensi Esteve, Developer [toni.asensi {*} kdemail {.} net] Nikita Melnichenko, Developer [nikita+kde {*} melnichenko {.} name] Frank Schoolmeesters, Documentation & Marketing Coordinator [frank_schoolmeesters {*} yahoo {.} com] (retired) Richard Holt, Documentation & Proofing [richard {.} holt {*} gmail {.} com] (retired) Matej Urbancic, Marketing & Product Research [matej {*} amis {.} net] (retired) Yuri Chornoivan, Documentation yurchor@ukr.net The project is written using KDevelop and Qt Designer. Bugs See the TODO file in the distribution for information on what remains to be done. For fixes, patches and comments mail to krusader-devel@googlegroups.com. Krusader Krew diff --git a/doc/menu-commands.docbook b/doc/menu-commands.docbook index c4ed8786..73916567 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 , + xxdiff or KDiff3 , change it in the Konfigurator Dependencies page. &Shift; F2 File Multi Rename - This menu option starts Krename, a + 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. &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 + 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/mount.docbook b/doc/mount.docbook index f6eb9147..6e7a4bcd 100644 --- a/doc/mount.docbook +++ b/doc/mount.docbook @@ -1,89 +1,89 @@ MountMan: work with your mounted file systems Mount MountMan is a tool which helps you manage your mounted file systems. Once invoked, it displays a list of every mounted file system. For each file system, MountMan displays its name (which is the actual device name - &ie; /dev/sda1 for a first partition on first HDD), its type (ext4, ext3, ntfs, vfat, ReiserFS...) and its mount point on your system (the directory on which the file system is mounted). If you want filter out non-removable devices from the list, just check the item Show only removable devices at the left of the device list.
MountMan MountMan
MountMan also displays usage information using total size, free size, and percentage of available space free. If those numbers say N/A, that usually means that the file system is not mounted. Left clicking on a file system displays a pie chart on the left of the window, graphically displaying the usage information for the file system. Clicking on a non-mounted file system will display not mounted instead of the graph. Double-clicking on a file system will close MountMan and open that file system inside &krusader;'s active panel. Right-clicking on a file system will open a small menu which displays what actions can be performed on that file system. At the moment, you can only mount, unmount and eject (if clicking on a removable file system, ⪚, a &CD-ROM;). We plan to expand MountMan in the next evolution of &krusader;. It will be able to format partitions, edit /etc/fstab, create new file systems and more.... By the way, we have started working on it, see "Quickmode for MountMan". Quickmode for MountMan To activate Quickmode for MountMan, click lateral button with arrow on the MountMan button on the Main Toolbar. General idea: display a list of all possible mount points. Each time the menu is displayed, it determines if a mount point is mounted or not and associates the correct action (mount or umount). This offers a quick interface to MountMan. It is working, and currently uses KMountMan::mount and unmount. It uses the new &kf5-full; services for fstab-reading and this will enable us to remove a lot of code from the "old" MountMan. diff --git a/doc/mouse-commands.docbook b/doc/mouse-commands.docbook index 2249406a..6eae7f2c 100644 --- a/doc/mouse-commands.docbook +++ b/doc/mouse-commands.docbook @@ -1,43 +1,43 @@ Mouse Commands Commands Mouse Mouse Usage In this chapter you will be guided in using &krusader; effectively with a mouse and to configure mouse gestures through KHotKeys. By simply clicking the mouse you can select different sections of &krusader;. Another chapter describes the selection modes, and how you can configure them: Selection Mode diff --git a/doc/occupied-space.docbook b/doc/occupied-space.docbook index d9ec76d3..75b6f2de 100644 --- a/doc/occupied-space.docbook +++ b/doc/occupied-space.docbook @@ -1,60 +1,60 @@ Calculate Occupied Space Occupied Space There are two ways to calculate the occupied space of files/directories. Pressing the configurable shortcut for the Calculate occupied space on a directory under the cursor instantly calculates the occupied size. To calculate how much disk space is occupied by the selected files and directories in the active panel select Edit Calculate Occupied Space . After a small delay, a dialog box will be displayed with total occupied space and the number of files and directories you selected. The space occupied by every selected directory will be shown as if the user just pressed configurable shortcut on those directories. If the active panel is browsing an archive, the numbers will apply to the unpacked size of the selected files and directories, not their compressed size. After the calculation the selection state will be toggled and the cursor will move one step downwards. Calculating the occupied space on remote file systems is supported. Performing this operation on a very large file system (thousands of files) may be time-consuming. You can cancel the calculation process at any time by clicking the Cancel button. diff --git a/doc/profiles.docbook b/doc/profiles.docbook index 7f5d7371..6defb547 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. diff --git a/doc/release-overview.docbook b/doc/release-overview.docbook index b68675d0..a0130974 100644 --- a/doc/release-overview.docbook +++ b/doc/release-overview.docbook @@ -1,730 +1,730 @@ Release overview Release overview This appendix gives an overview of the &krusader; releases. Release overview &krusader; version release date &kde; version 2.7.1 "Peace of Mind" 2018-08-12 &kde; Frameworks 5 2.7.0 "Peace of Mind" 2018-05-13 &kde; Frameworks 5 2.6.0 "Stiff Challenges" 2017-04-12 &kde; Frameworks 5 2.5.0 "Clear Skies" 2016-10-22 &kde; Frameworks 5 2.4.0-beta1 "Migration" 2011-06-26 &kde; 4.0 - 4.6 2.3.0-beta1 "New Horizons" 2010-12-25 &kde; 4.0 - 4.5 2.2.0-beta1 "DeKade" 2010-04-30 &kde; 4.0 - 4.4 2.1.0-beta1 "Rusty Clutch" 2009-10-31 &kde; 4.0 - 4.3 2.0.0 "Mars Pathfinder" 2009-04-11 &kde; 4.0 - 4.2 2.0.0-beta2 "Space Odyssey" 2008-12-27 &kde; 4.0 - 4.2 2.0.0-beta1 "Phoenix Egg" 2008-06-07 &kde; 4.0 - 4.1 1.90.0 "Power Stone" 2008-03-15 &kde; 3.2 - 3.5 1.80.0 "Final 3rd Stone" 2007-07-21 &kde; 3.4 - 3.5 1.80.0-beta2 "Last Unstable Stone" 2007-03-31 &kde; 3.4 - 3.5 1.80.0-beta1 "The Last Krusade" 2007-01-07 &kde; 3.4 - 3.5 1.70.1 "Round Robin" 2006-07-17 &kde; 3.3 - 3.5 1.70.0 "Round Robin" 2006-02-12 &kde; 3.3 - 3.5 1.70.0-beta2 "Afterburner" 2005-11-05 &kde; 3.3 - 3.5 1.70.0-beta1 "Hellfire" 2005-10-02 &kde; 3.3 - 3.5 1.60.1 2005-10-30 &kde; 3.3 - 3.4 1.60.0 2005-04-10 &kde; 3.3 - 3.4 1.60.0-beta2 2005-03-21 &kde; 3.3 - 3.4 1.60.0-beta1 2005-03-03 &kde; 3.3 - 3.4 1.51 2004-12-14 &kde; 3.2 - 3.3 1.50 2004-10-31 &kde; 3.2 - 3.3 1.50-beta1 2004-10-17 &kde; 3.2 - 3.3 1.40 2004-07-20 &kde; 3.2 1.40-beta2 2004-06-22 &kde; 3.2 1.40-beta1 2004-04-11 &kde; 3.2 1.30 2003-11-14 &kde; 3.0 - 3.2 1.29-beta1 2003-10-02 &kde; 3.0 - 3.2 1.25-beta1 2003-08-15 &kde; 3.0 - 3.2 1.21-beta1 2003-07-18 &kde; 3.0 - 3.2 1.20 2003-05-31 &kde; 3.0 - 3.2 1.12-beta2 2003-05-09 &kde; 3.0 - 3.2 1.12-beta1 2002-12-23 &kde; 3.0 - 3.2 1.11 2002-10-17 &kde; 3.0 - 3.2 1.10 2002-08-15 &kde; 2 1.02 (first KDE3 version) 2002-04-16 &kde; 3 1.01 2002-04-01 &kde; 2 1.00 2002-01-01 &kde; 2 0.99 2001-12-01 &kde; 2 0.98 2001-10-27 &kde; 2 0.97 2001-10-08 &kde; 2 0.95 2001-07-22 &kde; 2 0.93 2001-05-31 &kde; 2 0.92 2001-05-17 &kde; 2 0.91 2001-05-10 &kde; 2 0.90 2001-04-30 &kde; 2 0.79 2001-02-25 &kde; 2 0.75 2000-01-12 &kde; 2 0.70 (milestone 3) 2000-11-07 &kde; 2 0.69 2000-10-28 &kde; 2 0.65 2000-08-19 &kde; 2 0.60 2000-07-19 &kde; 2 M2 (milestone 2) 2000-07-11 &kde; 2 M1 (milestone 1) 2000-05-?? &kde; 2 (Kleopatra 1.91) Project began 2000-04-30 Kleopatra 1.91
Note: older 0.x beta releases are not included in this table. diff --git a/doc/remote-connections.docbook b/doc/remote-connections.docbook index 2188bc5c..f1c915f7 100644 --- a/doc/remote-connections.docbook +++ b/doc/remote-connections.docbook @@ -1,281 +1,281 @@ Remote Connections Remote Connections Remote connections are easily made by typing the &URL; in the Location Toolbar; these are actually KIO Slaves. Please note that the &krusader; panel does not support all KIO Slave ⪚ http:// will not work in the panel, but will work in the viewer. Some examples: ftp://public.ftpserver.org/directory/ fish://username@hostname/ sftp://username:password@sftp.foo.org/ ftp://username@my.server.org:21/directory/ smb://username:password@server/share ftp://username@proxyusername:password@proxipassword@hostname/directory nfs://<host>:<port><url-path> webdav://www.server.com/path/ You can bookmark these &URL;s, however, please read the Bookman section regarding securely save passwords. For connecting to multiple locations, bookmark these &URL;s and open them one by one, or open them all together by using Panel profiles. To switch from one to another location, just open a Folder tabs for each. There are three ways to start a remote connection: Type the &URL; in the Location Toolbar Select Tools New Net Connection which will pop-up a dialog that will ask for the remote site details. This dialog is handy if you are not used to type remote &URL;s in the Location Toolbar. Leaving the password and user name fields empty will log you in as anonymous. Note: we are planning to rewrite this dialog window. You can bookmark a directory on a remote host and return to this directory from the bookmark button on the top corner of your panel just like in a web browser. After you log on to a remote server you can browse it just like your local hard drive with the following exceptions: You cannot execute files on remote servers. Permissions cannot always be calculated on remote servers (depends on server and access method) so you might get a ? on the permissions columns for some files. Disk usage information is not available for most remote filesystems. To change the charset of the remote host use View Select Remote Charset . You can close the current Active Remote Connection by two separate methods: Manually: Add the disconnect button to the Main Toolbar and click on it. Automatically: Change the &URL; in the Location Toolbar . &krusader; is a file manager that supports remote connections via KIO Slaves, but if you are looking for even more advanced remote connections features, ⪚ an advanced &FTP; client we recommend you to use ⪚ - Kasablanca or - Kftpgrabber. + LFTP or + FileZilla. LAN connections via fish:/ protocol (zeroconf) Remote LAN Connections (zeroconf) This section is contributed by Andrew Svet (z-vet), feedback about this chapter is appreciated. Thanks! This works on a Debian system, so it will work on Debian and derivatives (Kubuntu &etc;), though it should work on other Linuxes as well. We assume that you have SSH installed, configured and working on every machine on LAN you want to connect to/from. There are plenty of very good tutorials about SSH on the net, ⪚ at linuxhomenetworking.com or just google for it. We use the default SSH port (22) for this chapter. Remember to change it if you use different one. All modifications, editing &etc; must be done as root. Let's start with installing all the packages we need: # apt-get install Everything is installed, now let's do some configuration. First, we need our services to be announced on LAN. That is why we installed avahi-daemon: it represents your machine on local network and allows other applications to publish services they provide. Avahi-daemon comes with example ssh.service configuration file found in /usr/share/doc/avahi-daemon/examples. In order to get the service to be announced on LAN we need to copy this file to /etc/avahi/services directory: # cp Now we need fish:/ protocol to be announced too, so we use an ssh.service file as a template for fish.service: # cp This file is just a copy of ssh.service. Edit the fish.service file and replace "Remote Terminal on %h" with "Fish to %h" and "_ssh._tcp" with "_fish._tcp". Here is how it looks after edit: <?xml version="1.0" standalone='no'?><!--*-nxml-*--> <!DOCTYPE service-group SYSTEM "avahi-service.dtd"> <!-- $Id: remote-connections.docbook,v 1.6 2007/05/02 18:07:28 codeknight Exp $ --> <!-- This file is part of avahi. avahi is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. avahi is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR <!-- See avahi.service(5) for more information about this configuration file --> <service-group> <name replace-wildcards="yes">FISH to %h</name> <service> <type>_fish._tcp</type> <port>22</port> </service> </service-group> Save the modified file. Now we need to create a new file _fish._tcp, open a text editor and add the next lines: Name=FISH Protocol (ssh) Type=_fish._tcp UserEntry=u PathEntry=path PasswordEntry=p And save the file /usr/share/apps/zeroconf/_fish._tcp Do the same on each machine on your LAN, then restart avahi-daemon: # /etc/init.d/ avahi-daemon Then open &krusader; and type in location-toolbar-lnk: zeroconf:/ to open the zeroconf connection. Enter the Fish Protocol directory. Inside you will find the links to each machine that announced fish:/ on your LAN, the location-toolbar-lnk: will point to zeroconf:/_fish._tcp Double clicking on any of these machines, them will bring up the password prompt, asking you for your ssh key passphrase (if password was set). Enter your passphrase. Congratulations: you connected to remote machine using &krusader;! diff --git a/doc/search.docbook b/doc/search.docbook index 43c75d4f..2b9ddf3f 100644 --- a/doc/search.docbook +++ b/doc/search.docbook @@ -1,364 +1,364 @@ KruSearcher: find what you are looking for Search Welcome to &krusader;'s powerful search module - nicknamed KruSearcher. It is the most able tool (that we know of) for &Linux;, since it allows so many different ways to quickly find the file you are looking for. The search function is also available on remote file systems. It is divided into two levels, the general and the advanced. Let's take a look at the general page.
General Search General Search
The page is divided into four parts: top (search for) part, bottom part - titled Containing text, left part - titled Search in and right part which is called Do not search in. Obviously, each part handles different aspects of the search. Let's look at them closely. Top Part: Search for: here you enter the main search criteria. You can enter a file name, a wildcard ( *.o.*, *.c &etc;) or both - separated by a space. If you type 'text' the results is the same as '*text*'. You can exclude files from the search with '|' (⪚ '*.cpp *.h | *.moc.cpp') . 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. Case sensitive: unchecking it will allow lower and upper case search (&ie;: *.c interprets as *.c AND *.C). Of type: this box lets you search for a file not only by its name, but also by its MIME type. For example, you can search for all the audio files whose name begins with B. Usually this option defaults to 'all files', but you can choose to search for archives, directories, images, text files, videos and audio files. Left and Right Part: Search in and Do not search in: Using those two parts, you can specify a search exactly the way you want it. For example, you might want to search for a file in the whole file system (beginning with /), but do not want to search inside /mnt. All you need to do is write / in the Search in box, and write /mnt in the Do not search in box. If you want to enter more than one directory in one of the list boxes, just type the first name and press &Enter;. The directory name will be copied to the bigger list box and you will be able to enter another name. The input line has an auto-completion feature, corresponding to &plasma; global settings. If you wish, you can click on the folder icon, and browse to the directory you wish to add. It is possible to define files and directories which will be filtered out from the search results using the Exclude Folder Names input field at the bottom of the Do not search in box. Items in the filtering list should be space-separated. Spaces in the filtering list items can be escaped or quoted. Example: .git "target build" build\ krusader Bottom Part: Text: entering text here makes &krusader; search for it inside the files ( grep). This way you can search for all header files ( *.h) which include the word 'testing 123'. RegExp switch: toggle the regular expressions mode. A drop-down list that is shown after clicking down arrow on the right allows you to enter special symbols of regular expressions. Encoding: allows you to choose the text encoding. Match whole word only: allows you to specify that a complete match (letters and length) must be found. Case sensitive: refers to your text being searched for in upper and lower case or the exact phrase you entered. Search in sub folders: perform a recursive search and dive into every directory on the way. Search in archives: &krusader; will search for your files inside every supported archive. This, however, takes longer to perform. If you check this checkbox, you will notice you cannot grep inside files anymore. This is done, since looking inside archived files forces &krusader; to extract them, which results in an extremely time-consuming search. Follow links: if checked, &krusader; will follow soft-links during the search. Profiles: if you have to regularly perform the same search operation, you can save the search settings ⪚ include files, exclude files, &etc;... Press the 'profile' button, and you can add/load/save/remove search profiles. Query to clipboard: if checked, &krusader; will place search text to clipboard when a found file is opened. The above screen shot shows a search for all the files which end with c, cpp or h and include the string 'testing 123'. &krusader; will search in /root, /opt, /bin and /usr, but not in /usr/lib and /usr/share. Clicking the Search button starts the search and displays the results page. During the search, you may press the Stop button to stop the search. The Close button is not operational during a search, so you must first stop the search and then Close the window. When a result is found, double-clicking on it will take &krusader;'s active panel point to the found files - but will not close the search window, so you will be able to click on a different result. Sometimes, you need to narrow your search even more. Krusearcher allows a much finer search, and for that, let's look at the Advanced Page...
Advanced Search Advanced Search
This screen shot shows a search for files whose size is between 10KiB and 150KiB, which were modified between October 10th and November 1st, which belong to any user in the 'nobody' group, and are readable and writable by anyone in the 'nobody' group, but only readable to the rest of the world. The advanced page is divided into three parts: size, date and ownership. Size Allows you to choose the size range of the file you are looking for. By checking the check boxes, you can search for a file which is bigger than XXX bytes (or KB, MB), smaller than XXX bytes or, by checking both search for a file which size is bigger than XXX but smaller than YYY. Date This part offers three different ways of defining a date criteria: Modified between: allows you to enter two dates. &krusader; will search for files with a modification date between the first date and the second one, inclusive. You can click on the date icon (near the input boxes) to open a standard date window - which allows you to easily browse through the calendar and search for the desired date. Clicking on a date will close the window and the date will appear in the input box. Not modified after: choosing this option makes &krusader; search for files that were NOT modified after a given date, which is the same as searching for files older than that date. Modified in the last/not modified in the last: in these input boxes, you do not enter a date but a number. This number represents days/weeks/months (as chosen in the near drop box). Entering the number 5 in the upper input box, makes &krusader; search for files that were modified in the last 5 days. Entering the number 2 in the lower input box makes &krusader; search for files that did NOT change in the last 2 days. The combination of both results in a search for files that were changed in the last 5 days, but NOT in the last 2 days. Ownership Belongs to user/group: by checking each of the corresponding check boxes, you can search for files which belong to a certain user and/or group. The drop box lists all the user names and group names in the system, just choose one and go ahead. Permissions: divided into owner, group and all - it allows you to choose certain permissions for the file. You can choose to specify permissions for the owner, group, all or any combination. The question mark (?) is a wildcard - which means that any permission is valid. To clarify, the screen shot above (the ownership part) describes a search for files that belong to any user in group 'users', are readable, writable but not executable to any user in the group, are readable but not writable or executable to the rest of the world and have unknown permissions to its owner. Results Clicking on the Search button to start the search and open the Results window. Here you can see the progress and the results of the search action. If you want you can stop the current search action with the Stop button. In the result list select the file and use F3/ F4 to view/edit or use the right-click menu. When you click on a found item, the directory of the active panel will change if the selected item is not in the current panel directory. The results window supports dragging items to other windows and copy to clipboard (&Ctrl;C). When you close the Krusearcher window, the selected item is selected in the active panel. Feed to listbox When you click the Feed to listbox button after the results are displayed, then &krusader; ask for a Query Name, this name will be used in the Results-Tab in the List Panel that holds the search results. You can do whatever you want on the files in the new tab. The location toolbar will display ⪚ virt:/Search results 1. The files in the Results-Tab are actually the original files. if you delete a file - it is removed! diff --git a/doc/splitter.docbook b/doc/splitter.docbook index 46ce4e1c..6c685fc6 100644 --- a/doc/splitter.docbook +++ b/doc/splitter.docbook @@ -1,77 +1,77 @@ File Splitter File Splitter This function splits one (large) file up into multiple smaller files so that they can be placed on smaller media (⪚ ZIP drives, ...) or sent by email. The multiple files can be combined again to recreate the original file. &krusader; and Total Commander split/combine functions are compatible. To split a file choose File Split or &Ctrl; P: a Split dialog will open to confirm the operation. If the name of the original file is foo, then the name of the smaller files will be foo.000 foo.001 foo.002 &etc; There is no theoretical limit in the number of smaller files, but it is recommended to limit the number to a maximum of 1023 files. &krusader; creates a foo.crc file. This file contains the name, size and the crc checksum of the original file. It is possible to combine the file without the foo.crc file but in this case &krusader; cannot check if the original file was recreated correctly. An example of a foo.crc file: filename=foo size=432998467868 crc32=21EB719A To combine the multiple files choose, select a partial file foo.xxx and choose File Combine files or &Ctrl; B. The target directory is the inactive panel and can be changed. The file names must be numbered in ascending order: foo.001, foo.002, foo.003 &etc; or have letters in ascending order: (" split letter method") fileaa, fileab, fileac &etc; If the file foo.crc is found in the same directory as the partial files, &krusader; will use this file to check the combined file for errors. diff --git a/doc/synchronizer.docbook b/doc/synchronizer.docbook index 825b0ddb..3c6f9b67 100644 --- a/doc/synchronizer.docbook +++ b/doc/synchronizer.docbook @@ -1,739 +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/user-interface.docbook b/doc/user-interface.docbook index f2d766ac..dc5ab9bd 100644 --- a/doc/user-interface.docbook +++ b/doc/user-interface.docbook @@ -1,821 +1,821 @@ User Interface User Interface OFM User Interface The OFM file manager concept contains many features that make them powerful enough to belong among the best file managers today. The interface is simple: left panel, right panel and a command line below. Because of interaction between these three items the file managing will become more efficient. If you would like to know how &krusader; works you can try it yourself, just install it on your computer. To accept an Orthodox File Manager (OFM) like &krusader;, the user needs to get used to new ideas that are actually already 20 years old. If you prefer to waste time and lose a lot of productivity, you can always continue to use one panel file managers that are based on &Windows; Explorer. &krusader; Main Window
&krusader; Main Window &krusader; Main Window
The User Interface is based on Orthodox File Manager (OFM) paradigm, a 20- year old principle that has proven its bones. It is known as simple, easy and powerful. In the following sections we will cover the basic functions of each part with the exception of: The Menu Bar which has a chapter of its own. The Bookmarks which has a chapter of its own. The Status Bar shows the properties of the current file (that is being) in focus. Toolbars &krusader; comes with several Toolbars. Main Toolbar Toolbar Main Toolbar
Main Toolbar Main Toolbar
The &krusader; Main Toolbar is a standard &kde; toolbar that can be dragged around the application (please unlock it first by unchecking the Lock Toolbar Positions item in the right-click menu) or configured via a Right-Click menu. You can decide whether or not you want to display it each time you start &krusader; in the Konfigurator Startup page, and you can toggle its use in the current session in the Settings menu. The Main Toolbar contents can be configured from the Configure Toolbars in the Settings menu. Since various commands and options in &krusader; are context-dependent, some commands are not always available. The icon of an inappropriate or inactive action will be deactivated (grayed-out) disabling its use. Bookmarks can be placed into the Main Toolbar and the Actions Toolbar with the mouse using "drag and drop". Job Toolbar Toolbar Job Toolbar By default, the &krusader; Job Toolbar (Queue Manager or simply the JobMan) is located at the right part of the Main Toolbar. This toolbar allows you to view the job progress, to pause and resume the job list execution and to undo the last executed job. Actions Toolbar Toolbar Actions Toolbar UserActions and Bookmarks can be "plugged" into the Actions Toolbar. To show it, use Settings Show Actions Toolbar . To add user actions, use Settings Configure Toolbars and select Actions Toolbar. You can, for example, drag the Actions Toolbar to the right side using the mouse. Location Toolbar Toolbar Location Toolbar Below the Main Toolbar there is a Location Toolbar for each panel. It shows the path the panel is currently pointing to. When entering archives the path will be displayed in the following format: "archive type:/directory/archive_filename/the directory inside the archive". This format makes the paths uniform and easy to read. The Location Toolbar supports also KIO Slaves but not all of them, some can only be used with the viewer and some can not be used. The user can enter a desired path by clicking on it. /mnt/cdrom/ settings:/ will browse and open entries of the &systemsettings;. trash:/ opens trash folder. mtp:/ uses the kio_mtp to access, upload and organize the multimedia stored on Android-based devices. And last but not least Remote Connections . You can copy-paste a &URL; in the Location Toolbar or use a middle click. With the Right-Click menu you can configure the auto-complete function. An optional Clear Location Toolbar button is also available. Quick Navigation: &Ctrl; point with mouse in the middle of &URL; of the Location Toolbar. A pop-up window shows the next &URL; location. Pressing &Ctrl; + Left Mouse Button shows the location where the mouse was pointing to. This feature allows faster navigation in a big directory tree. Panel Toolbar Toolbar Panel Toolbar Each panel has a configurable Panel Toolbar. The complete Panel Toolbar or specific buttons can be made visible or be hidden. OpenDir Button: opens the directory browser. Equals Button (=): changes the panel directory to the other panel directory. Up Button (..): changes the panel directory to the parent directory. Home Button (~): changes the panel directory to the home directory. Root Button (/): changes the panel directory to the root directory. Sync-browsing Button: when active, each directory change in the specific panel is performed in the other panel as well. Panels The &krusader; panels are where most of the action takes place. Currently, there are two types of panels: List Panel: shows the files and directories. Sidebar: has several display modes: Preview, Tree, Quickselect, View and Disk Usage for the file or directory that has the focus. The Sidebar may be left open or closed, as desired. &krusader; is a "twin-panel" file manager so there are two panels: the "Left" panel and the "Right" panel, or a more important logical distinction, the *Active* panel and the *Inactive* panel. The active panel is the one that will accept your mouse and keyboard input. If you choose a command from the Menu-Bar or Toolbar the command will act upon the selected files/directories in the active panel. You can switch between panels using the key or by clicking on the Information or Totals labels, or by selecting any file in a panel with the mouse. As always, default startup settings can be modified with the Konfigurator Startup page, and you control the current session with the Settings menu.
List Panel List Panel
List Panel Panel List Panel This is the default panel and the one you will probably use most of the time. This panel shows the contents of one directory which can be local (part of your mounted file systems, either a native file or the files inside an archive) or remote files (accessed via &FTP;, NFS or Samba). There are two modes: Detailed View that shows the file names, file size, creation date and time and their attributes. And Brief View that shows only the file names, the number of brief columns can be changed, by right clicking on the Name header. File copy/paste/cut via clipboard between &konqueror; and &krusader; &Ctrl; C, &Ctrl; V, &Ctrl; X is supported. &Alt;&Ctrl; R toggles the List Panel between horizontal and vertical mode. The following items are available: Information Label : shows how much free space is physically available on the file system, the file system capacity and where the filesystem is mounted. If the information is not available (most often in the case of remote file system) a message will be displayed with the reason for unavailability instead of the information. The Media button on the left of the Information Label displays a list of all available media, where you can select the desired media (HDD partition, DVD, USB stick, &etc;). Pressing &Ctrl;Return when the Media menu is opened mounts the highlighted media when it is unmounted, and unmounts it when it is mounted. The context menu of a medium gives several options like Mount, Open in a new tab, &etc; The Media menu is configurable. Column Headers : here you can change the sort order of the files and directories as desired. The default sort order is by Name. The sort order can be instantly changed by clicking on one of the Column Headers. To reverse the sort order, click a second time on the Column Header. An arrow will appear on the right of the Column Header text, showing the sort direction (Up arrow = A to Z sorting, Down arrow = Z to A sorting). Default UserActions set a keybinding for the Column Headers. The default Column Headers are: Name, Ext, Size, Modified, rwx. Predefined Atomic extensions like .tar.gz are shown as one part in the Ext Column. More optional Column Headers are available with the &RMB;. The width Column Headers can be changed with the mouse by single clicking and moving the divider line to the desired width (keep the mouse button pressed). Both List Panels remember the sort order and column width. The Column Headers can be changed and saved individually to each panel. File List : displays the files and directories in the browsed directory. The search bar allows you to search for files by typing their names, or the first few characters of a file name. Pressing &Enter; or double clicking on a file will open/execute that file. You can select/unselect files using the mouse, with the Insert key or the Edit menu. Totals Label : selecting or deselecting files will change the Totals Label : selecting or deselecting files will change the Totals Label at the bottom of the panel, which displays how many files you have selected (and how much total disk space they use) as well as the total file and disk usage of the current directory (as opposed to the information label that displays information for the whole file system). If a directory contains a lot of subdirectories, it may not be possible to drop the &URL; onto the panel (on which only directories are visible), but the &URL; can be dropped onto the "Information Label" or "Totals Label" instead. When a custom filter is set, it will show the setting, example: [*.cpp]. When using the "&kde; default colors", then the selected files are shown in blue and the current file is surrounded by a fine-lined rectangle. By default an icon is shown according to the file type. Use Konfigurator Panel page to change the default configuration to meet your individual needs. Some useful List panel Key-Bindings: &Ctrl; R will refresh the panel. Focus a file or directory on the left panel, press &Ctrl; Right arrow and the right panel changes: On a file: the right panel gets the same path as the left panel. On a directory: right panel opens the directory focused on the left panel. For the right panel: press &Ctrl; Left arrow and the left panel will change. Sidebar Sidebar Sidebar (3rd Panel) This is "&krusader; is 3rd Hand" or the 3rd Panel, click on the arrow-up button on the right of the Totals Label or &Alt; Down-Arrow to open the Sidebar. This panel has several display modes which can be activated by clicking on the appropriate button. Preview Panel : gives a preview of the file that has the focus (currently selected file). Tree Panel : is used to quickly browse the local directory tree. This panel behaves like the list panel but only one directory may be selected at a time and double clicking or pressing &Enter; on a directory will open that directory in the active panel. The panels fully support drag and drop (copy, move, link) mouse actions. Quick Panel : is used to quickly select files, ⪚ enter *.png and click on the Go button. The "floppy" button stores the current selection. The "select group dialog" is also available. Viewer Panel : views a text file, views an image, &etc; A thumbnail view is generated whenever you open the Viewer Panel. Disk Usage Panel : views the Disk Usage of a directory. It is possible to change the sidebar placement using the rotation button which is located to the left of the arrow down button at the bottom part of the &krusader; tab. Each click on this button moves the sidebar on one position in the loop "bottom-left-top-right". If needed you can resize the window ⪚ to better display a picture or view a file contents. Click on the arrow down button to close the 3rd Hand Panel. Folder History Both panels remember recently visited folders. Click on the Folder history button ("watch" symbol) to open the folder history list. Here you can quickly change to previously visited folders. The currently focused folder is checked. On every new start of &krusader;, the history list is populated by the items from previous run (history is saved). Command Line / Terminal Emulator This part of the GUI can have four modes: Command Line, Terminal Emulator, show both and show none. You can choose your mode of operation either on start-up with the Konfigurator Startup page, or for the current session with the Settings menu . Command Line
Command Line Command line
The traditional command line mode offers a single line of input to enter commands, it also features three buttons: command history (down arrow) to quick open previous used commands Useraction expander (green plus button) to add easy Useraction placeholders run in terminal mode (console icon) button with the next options: Start and Forget Display Separated Standard and Error Output Display Mixed Standard and Error Output Start in New Terminal Send to Embedded Terminal Emulator When you start typing your commands, the command line auto-completion feature will make its offers according to what you choose in the &systemsettings;. If you want to change the way auto-complete behaves in the current &krusader; session, right click on the command line and change it. To the left of the input line you can find the local path that the active panel is currently pointing to. This path is where your command will be executed. Typing cd <directory> in the command line will also cause the active panel to point to this directory. Click here to view the command line keybindings. Terminal Emulator
Terminal Emulator Terminal emulator
The terminal emulator mode is in fact a small console and acts like one. You can change the active directory in the terminal by using the cd command. The terminal emulator will follow the active panel directory. You can drag a file from the List Panel and name of file will pasted into Terminal Emulator. If you drag multiple files, the names will pasted into Terminal Emulator. A full-screen terminal emulator can be used when configured or &Ctrl; &Shift;F toggles between normal and full screen mode. If the command line is hidden, press &Ctrl; Arrow down to focus the terminal emulator. &Ctrl; Arrow up brings you back down. &Ctrl;&Enter; and &Ctrl; &Shift; &Enter; paste the filename. You can close the emulator by typing exit . Click here to view the Terminal emulator keybindings. Function (FN) Keys Bar
Function (FN) Keys Bar Function (FN) Keys Bar
This bar gets its name from the function (FN) keys it represents. For each button on this bar there is a corresponding function key that performs the same action. This bar is derived from the design of the first twin-panel file managers and the FN keys usually act the same way with two changes: the F2 key is used to rename files and the F9 key will open a terminal at the last local path that the active panel pointed to. Mkdir F7 can create whole directory trees on the fly ⪚ foo/bar/test. You can choose to display or not the FN keys bar when starting up &krusader; via the Konfigurator Startup page, and you can toggle its use in the current session with the Settings menu. The actions and Key-Bindings performed by the function keys are configurable since version 1.51, they will remain active with or without the FN keys bar displayed. Folder Tabs
Folder Tabs Folder Tabs
With Folder Tabs you can quickly change to multiple folders; each panel has its own Folder Tabs. The Folder Tabs positions are saved when closing &krusader;. To switch between Folder Tabs, click them with the mouse. Squeezed Folder Tabs have tooltips to display the full path. The following Folder Tabs operations are available: To open a new tab and keep the current tab opened: Right-click on a directory and select Open in New Tab. To lock a tab, Right-click and select Lock Tab. To pin a tab, Right-click and select Pin Tab. The pinned tab is a locked tab but with temporarily changeable address. It resets to pinned address on tab reactivation. To unpin the pinned tab right-click on it and choose the Unpin Tab item. To duplicate a tab: Right-click on the folder tab and select Duplicate Current Tab, or use &Ctrl;&Alt;&Shift; N. To close a tab (except for the last tab): Right-click on the tab and select Close Current Tab, or use the &MMB;, or use the Folder tab red cross button, or use &Ctrl; W. To create a "home" tab: click on the Home button. To change tabs: &Ctrl; , or &Ctrl; .. To open the current folder in a new tab: use &Ctrl;&Alt;&Enter;. To close all other tabs, Right-click and select Close Inactive Tabs. To close duplicated tabs, Right-click and select Close Duplicated Tabs. To move tab on the other panel, drag it to the area of the other panel with the &LMB; (the mouse cursor will become an arrow pointing left or right) and drop it. You can also press &Ctrl;&Shift; O. Buttons Several buttons for fast operations are available: Main Toolbar, Actions Toolbar, Panel Toolbar, Location Toolbar, Media, Folder history, Bookmarks, Tab, Commandline, Function keys. diff --git a/doc/useraction-xml.docbook b/doc/useraction-xml.docbook index d1926766..664d652f 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: <!DOCTYPE KrusaderUserActions> <KrusaderUserActions> <action name="synchronizer" > <title>Synchronizer</title> <command>%_Sync("Sync 2")%</command> </action> </KrusaderUserActions> diff --git a/doc/useractions.docbook b/doc/useractions.docbook index 24f98b0f..d350a8d7 100644 --- a/doc/useractions.docbook +++ b/doc/useractions.docbook @@ -1,648 +1,648 @@ UserActions UserActions With ActionMan you can set up, configure and manage UserActions. Some general settings are configured with Konfigurator. With UserActions you can perform actions on files in the panel or to access &krusader; internal functions with parameters directly using placeholders. The actions integrate seamlessly into &plasma; action system, which means that the standard Edit Toolbar and Edit Shortcut dialogs will show UserActions, too. The UserActions are stored in ~/.local/share/krusader/useractions.xml or krusader/useraction.xml in the directory which can be determined using the qtpaths --paths GenericDataLocation command. Several examples are included in the documentation. UserActions can be edited / added / imported / exported by using ActionMan. The default UserActions are stored in /usr/share/krusader/useraction-examples.xml. UserActions can appear nearly everywhere where "normal" KActions can be placed. The actions can even be placed in the menu bar, but for that the krusaderui.rc file must be edited. A few examples: Useractions Menu User Menu Actions Toolbar right click menus &etc; &krusader;'s UserActions tool is very powerful and customizable if you are familiar with writing UserActions in general. Several UserActions are provided by default. Please upload your favorite UserActions so that they become available for the &krusader; community. Thanks! +UserActions Forum.-->
ActionMan ActionMan
Basically, UserActions are a method to call external programs with variable parameters. For example, you could have a UserAction with the following xmms to enqueue all selected items of the active panel to the current instance of xmms. Additionally, there is limited access to &krusader; internal functions requiring parameters. For example, %aPanelSize("80")% will set the width of the active panel to 80% of the &krusader; mainwindow. Since the parameter of placeholders can contain other placeholders, few scripts are possible. Managing UserActions Open Konfigurator and choose User Actions Start ActionMan, in which you can add, edit, remove, import and export UserActions. Add Action: If you add an new action, you get an empty input mask where you can enter all the properties you desire. The action will be added as soon as you press Apply. Afterwards, the name is shown in the list on the left. To edit a UserAction: Select the UserAction on the left. Then choose it if you want to edit its properties. The changes will only take effect when you press Apply. To remove a UserAction: Select the UserAction on the left and click the button. To import a UserAction: If you import some actions, they will be automatically added to your list. If there are name conflicts (the names have to be unique because these are the ID for &plasma; action system), you are asked to resolve them. For this, the list on the left will only show the actions where conflicts exist. You can now give them new names or remove them. Export Action: If you export a UserAction you have to give a filename in which to store it. If it does not exist, it will be created. If the file already contains UserActions, the action you are exporting will be added to that file. All actions you have defined are now shown in the user menu and in &plasma; dialogs for changing shortcuts and managing the toolbar. In addition, all actions available for the current item will also show up in the right click menu. Basic Properties Identifier, Title and Command line are always required, all the other properties are optional. Identifier: A unique name of the UserAction, used to identify it for &plasma; action system. Icon button: The icon for your UserAction. Category: Categories are used for a better overview. They appear as submenu items in the Useractions menu. Title: The title displayed in the menus or dialogs. Tooltip: A tooltip for your UserAction, ⪚ displayed in the toolbar on mouseover. Description: A description of what the UserAction does. This is also displayed as What's This if you &Shift; F1 click on your UserAction. Command: The command which will be executed. You can add placeholder using a GUI with the add button. Workdir: The working directory for the command which will be executed. Execution mode: Normal: Normal execution mode. Run in terminal: Runs the command in the terminal. Run in embedded terminal emulator: Runs the command in the embedded terminal. Collect output: Collects the output of the executed program in a &GUI; window. Separate standard error: When "Collect output" is used the stdout and stderr are separately collected. Command accepts: Local files (no URLs): Tells the placeholder it should return local addresses. URLs (remote and local): Tells the placeholder it should return &URL;s. Default shortcut: Configures a default shortcut for the UserAction. Enabled: if checked, the useraction is shown in the User Menu, otherwise the useraction will be hidden. Command-line syntax Basically, everything you type in the command line will get executed (if you type "ls -l", "ls -l" gets executed). You have the possibility to get a character string from &krusader; which represents the current state of the panel. This is done using placeholders. A placeholder begins with a percent-sign ('%') and is followed by a panel indicator ('a' for the active, 'o' for the other, 'l' for the left and 'r' for the right panel. If the placeholder does not need a panel to operate on, you have to indicate this by an underscore ('_')). Then comes the name of the placeholder (see the list below), which may get some parameters enclosed in quotes. Finally, again the percent sign. This sounds very complicated, so let's make an example: '%aList("Selected")%' is replaced by a list of all selected items in the active panel. So a command like 'xmms --enqueue %aList("All", " ", "", "*.mp3")%' will execute xmms with a list of all .mp3s in the current panel, separated by a single blank. Currently, these placeholders are implemented: Path - replaced by the panels path Parameter (optional): Automatic escape spaces. Default: yes Count - replaced by the number of <first parameter> Parameter: Which items; either "All", "Selected", "Files" or "Dirs" Filter - replaced by the panel's filter mask Current - replaced by the current item Parameter (optional): Omit the current path. Default: no Parameter (optional): Automatic escape spaces. Default: yes List - replaced by a list of all <first parameter> Parameter: Which items; either "All", "Selected", "Files" or "Dirs" Parameter (optional): Separator between the items. Default: " " Parameter (optional): Omit the current path. Default: no Parameter (optional): Filtermask (for all but "Selected"). Default: * Parameter (optional): Automatic escape spaces. Default: yes Select - manipulates the selection in a panel Parameter: Filtermask Parameter (optional): manipulate in which way; either "Set", "Add" or "Remove". Default: "Set" Goto - changes the panels' path to <first parameter> Parameter: A relative or absolute path, or an URL Parameter (optional): Open the location in a new tab. Default: no Ask - asks the user for some text and is replaced by the answer Parameter: The Question Parameter (optional): A default answer Parameter (optional): A caption for the question box Clipboard - manipulates the clipboard Parameter: The text that should go to the clipboard (you may want to use "%aCurrent%" here) Parameter (optional): Append the text to the current content of the clipboard with this separator Copy - copies a file, useful for quick, local backups Parameter: What should be copied Parameter: Where it should be copied Sync - opens the Synchronizer with a given profile Parameter: A profile for the Synchronizer NewSearch - opens the search windows with a given profile Parameter: A profile for the search module Profile - loads a given panel profile Parameter: A panel profile Each - splits the commandline into a list. These commands are executed one after another. Parameter: A list item (all, all files, all dirs, all selected). Move - move from source to destination. Parameter: A source Parameter: A destination PanelSize - change the ratio between the two panels. Parameter (optional): A integer value, ⪚, 80 makes the active panel use 80% of &krusader;'s width (height in vertical mode), omitting the parameter means 50%. Ask - cancel the execution. Parameter (optional): A string for the cancel question. ListFile - is replaced by path/file name of a temporary file containing a list of items Parameter: path/filename ColSort - set the sorting on a column of a specific panel. Parameter: Column: Either "Name", "Ext", "Type", "Size", "Modified", "Perms", "rwx", "Owner" and "Group" Parameter: Sort sequence: Either "Toggle", "Asc", "Desc" View - set the view mode. Parameter: View mode: Either "generic", "text", "hex" Parameter: Window Mode: Either "tab", "window" A GUI-based helper for placeholder adding is provided. Spaces in Path, Current and List are by default, automatically escaped. There is one more important thing to know: All placeholders that interact with &krusader; internal functions are called at expand time (meaning directly when the placeholders are replaced). External programs are called at execution time (meaning after all placeholders are replaced). Advanced Properties Here you can configure where your command should be visible (for the right click menu). In addition, it is possible to change the command executed and confirm it separately. You can also set a user under which the command should be executed. Configures if the action is valid for a Protocol, Path, MIME type or File name. Tweaking the command line before being executed. Set a different user for the execution (this has no effect in &krusader; internal functions) diff --git a/doc/vfs.docbook b/doc/vfs.docbook index 361c6924..2859aed4 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. 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 diff --git a/doc/viewer-editor.docbook b/doc/viewer-editor.docbook index ec26e52f..4b062af4 100644 --- a/doc/viewer-editor.docbook +++ b/doc/viewer-editor.docbook @@ -1,2453 +1,2453 @@ KrViewer: &krusader;'s internal viewer-editor Viewer Editor Pressing &Enter; on a selected file opens the file with the associated application. The editor-viewer is tabbed, configure it on the Konfigurator General page Viewer To view a file as fast as possible according to its type, just put it under the cursor and press F3. &krusader;'s internal viewer is actually a part of &konqueror;, which can basically view every file type viewable by &konqueror; (⪚ display pictures, play music, show the content of an archive). This is called the 'Generic viewer', for which you need to configure the MIME types. The viewer works as follows: It tries to view the file with the 'Generic viewer'. When the file type (MIME type) cannot be determined or when a file (⪚ a binary) does not have an associated action, it disables the 'generic viewer'. The file is treated as a text file, which is the 'Text viewer'. The user can change in the KrViewer menu between: 'Generic viewer' (if available), 'Text viewer' and 'Hex viewer'. You can configure the default viewer mode on the Konfigurator General page . &Shift; F3 views a &URL; on demand, ⪚: man:/ views the manpages. man:/krusader views manpage of &krusader;. info:/ views the infopages. - http://krusader.sourceforce.net/ + https://krusader.org views a webpage. ftp://ftp.kde.org/pub/kde/ views a &FTP; server. sftp://sftp.foo/ views a secure &FTP; server. file:/home/frank views the home directory of Frank. tar:/home/frank/archive.tar.gz/ opens content browser window for the tar.gz archive. KrViewer can have the following menus: File, Edit, View, Settings and Krviewer, depending on which file type is viewed. They will be discussed in the Editor section. The internal viewer can follow links on &HTML; pages. With &Ctrl;&Shift; E the viewer can start &krusader;'s internal editor (which is basically the same application). The embedded viewer is not written by us, it is supplied via &kf5; and KIO Slaves. We cannot and do not want to change it, using these libraries reduces the amount of written code. So we do not have to reinvent the wheel ;-) Editor Editor &krusader;'s internal editor has almost everything that you can expect of an editor. Editing is similar to viewing but with the F4 key. The default editor is &krusader;'s internal editor. You can change the default editor in the Konfigurator General page, if you prefer to use an external editor. When you use &krusader;'s internal editor for the first time, it is recommended to look at each section of the Settings menu, and configure it the way you want it. Menu overview There are different menus and menu items in simple and advanced mode. The advanced mode is enabled by checking the option Enable power user mode (&kde; 3 mode) on the Appearance page in &kappname;s settings. The File Menu &Ctrl;S File Save This saves the current document. If there has already been a save of the document then this will overwrite the previously saved file without asking for the user's consent. If it is the first save of a new document the save as dialog (described below) will be invoked. File Save As... This allows a document to be saved with a new file name. F5 File Reload Reloads the active file from disk. This command is useful if another program or process has changed the file while you have it open in &kappname;. &Ctrl;P File Print... Opens a simple print dialog allowing the user to specify what, where, and how to print. File Export as HTML Export your file in &HTML; format so your document can be viewed as a web page. This item is only displayed when the plugin Exporter is loaded. The Edit Menu &Ctrl;Z Edit Undo This is used to eliminate or reverse the most recent user action or operation. &Ctrl;&Shift;Z EditRedo This will reverse the most recent change (if any) made using Undo &Ctrl;X EditCut This command deletes the current selection and places it on the clipboard. The clipboard is a feature that works invisibly to provide a way to transfer data between applications. &Ctrl;C EditCopy This copies the currently selected text to the clipboard so that it may be pasted elsewhere. The clipboard is a feature that works invisibly to provide a way to transfer data between applications. &Ctrl;V EditPaste This will insert the contents of the clipboard at the cursor position. The clipboard is feature that works invisibly to provide a way to transfer data between applications. EditCopy as HTML This copies the currently selected text to the clipboard as &HTML;. This item is only displayed when the plugin Exporter is loaded. &Ctrl;A EditSelect All This will select the entire document. This could be very useful for copying the entire file to another application. &Ctrl;&Shift;A EditDeselect Deselects the selected text in the editor if any. &Ctrl;&Shift;B EditBlock Selection Mode Toggles Selection Mode. When the Selection Mode is BLOCK, you can make vertical selections, ⪚ select column 5 to 10 in lines 9 to 15. The status bar shows the current state of the Selection Mode, either BLOCK or LINE. Meta&Ctrl;V EditVI input Mode Switch to a vi-like, modal editing mode. This mode supports the most used commands and motions from vim's normal and visual mode and has an optional vi mode statusbar. This status bar shows commands while they are being entered, output from commands and the current mode.The behavior of this mode can be configured in the Vi Input Mode section of the Editing page in &kappname;'s settings dialog. Ins EditOverwrite Mode Toggles the Insert/Overwrite modes. When the mode is INS, you insert characters where the cursor is. When the mode is OVR, writing characters will replace the current characters if your cursor is positioned before any character. The status bar shows the current state of the Overwrite Mode, either INS or OVR. &Ctrl;F EditFind... This opens the incremental search bar at the bottom of the editor window. On the left side of the bar is a button with an icon to close the bar, followed by a small text box for entering the search pattern. When you start entering characters of your search pattern, the search starts immediately. If there is a match in the text this is highlighted and the background color of the entry field changes to light green. If the search pattern does not match any string in the text, this is indicated by a light red background color of the entry field and Not found is displayed at the right side of the bar. Use the Next or Previous button to jump to the next or previous match in the document. You can choose whether the search should be case sensitive. Selecting Match Case will limit finds to entries that match the case (upper or lower) of each of the characters in the search pattern. Click on the button with a green arrow icon at the right side of the incremental search bar to switch to the power search and replace bar. F3 EditFind Next This repeats the last find operation, if any, without calling the incremental search bar. &Shift;F3 Edit Find Previous This repeats the last find operation, if any, without calling the incremental search bar, and searching backwards instead of forwards through the document. &Ctrl;R EditReplace... This command opens the power search and replace bar. On the upper left side of the bar is a button with an icon to close the bar, followed by a small text box for entering the search pattern. You can control the search mode by selecting Plain text, Whole words, Escape sequences or Regular expression from the drop down box. If Escape sequences or Regular expression are selected, the Add... menuitem at the bottom of the context menu of the text boxes will be enabled and allows you to add escape sequences or regular expression items to the search or replace pattern from predefined lists. Use the Next or Previous button to jump to the next or previous match in the document. Enter the text to replace with in the text box labeled Replace and click the Replace button to replace only the highlighted text or the Replace All button to replace the search text in the whole document. You can modify the search and replace behavior by selecting different options at the bottom of the bar. Selecting Match Case will limit finds to entries that match the case (upper or lower) of each of the characters in the search pattern. Selection Only will search and replace within the current selection only. The Find All button highlights all matches in the document and shows the number of found matches in a small popup. Click on the button with a green arrow icon at the right side of the power search and replace bar to switch to the incremental search bar. &Ctrl;H EditFind Selected Finds next occurrence of selected text. &Ctrl;&Shift;H EditFind Selected Backwards Finds previous occurrence of selected text. &Ctrl;G Edit Go to Line... This opens the goto line bar at the bottom of the window which is used to have the cursor jump to a particular line (specified by number) in the document. The line number may be entered directly into the text box or graphically by clicking on the up or down arrow spin controls at the side of the text box. The little up arrow will increase the line number and the down arrow decrease it. Close the bar with a click on the button with an icon on the left side of the bar. The View Menu The View menu allows you to manage settings specific to the active editor, and to manage frames. View New Window Create another window containing the current document. All changes to the document in one window are reflected in the other window and vice versa. F7 View Switch to Command Line Displays the Katepart command line at the bottom of the window. In the command line, type help to get help and help list to get a list of commands. ViewShow the Javascript Console This opens a tool view that allows you to run Javascript code interactively. For more information, see Extending &kate; with Scripts View Schema Select a font schema. F10 View Dynamic Word Wrap The text lines will be wrapped at the view border on the screen. View Dynamic Word Wrap Indicators Choose when and how the dynamic word wrap indicators should be displayed. This is only available if the Dynamic Word Wrap option is checked. View Show Static Word Wrap Marker If this option is checked, a vertical line will be drawn at the word wrap column as defined in the Settings Configure Editor... in the Editing tab. Please note that the word wrap marker is only drawn if you use a fixed pitch font. F6 View Show Icon Border This is a toggle item. Setting it on checked will make the Icon Border visible in the left side of the active editor, and vice versa. The Icon Border indicates the positions of the marked lines in the editor. F11 View Show Line Numbers This is a toggle Item. Setting it on checked will make a pane displaying the line numbers of the document visible in the left border of the active editor, and vice versa. View Show Scrollbar Marks If this option is checked, the view will show marks on the vertical scrollbar. The marks are equivalent to the marks on the Icon Border. F9 View Show Folding Markers If this option is checked, the marks for code folding will be shown. View Code Folding These options pertain to code folding: F9 Show Folding Markers Toggles the display of the folding marker pane in the left side of the view. Fold Current Node Collapse the region that contains the cursor. Unfold Current Node Expand the region that contains the cursor. &Ctrl;&Shift;- Fold Toplevel Nodes Collapse all toplevel regions in the document. Click on the right pointing triangle to expand all toplevel regions. Enlarge Font This increases the display font size. Shrink Font This decreases the display font size. The Bookmarks Menu &Ctrl;B Bookmarks Set Bookmark Sets or removes a bookmark in the current line of the active document. (If it is there, it is removed, otherwise one is set). Bookmarks Clear All Bookmarks This command will remove all the markers from the document as well as the list of markers which is appended at the bottom of this menu item. &Alt; PgUp BookmarksPrevious This will move the cursor to beginning of the first above line with a bookmark. The menuitem text will include the line number and the first piece of text on the line. This item is only available when there is a bookmark in a line above the cursor. &Alt; PgDown BookmarksNext This will move the cursor to beginning of the next line with a bookmark. The menuitem text will include the line number and the first piece of text on the line. This item is only available when there is a bookmark in a line below the cursor. At the bottom of this menu, a list of bookmarks appears if any bookmarks are available for this window. The Tools Menu Tools Read Only Mode Set the current document to Read Only mode. This prevents any text addition and any changes in the document formatting. Tools Mode Choose the filetype scheme you prefer for the active document. This overwrites the global filetype mode set in Settings Configure Editor... in the Filetypes tab for your current document only. Tools Highlighting Choose the Highlighting scheme you prefer for the active document. This overwrites the global highlighting mode set in Settings Configure Editor... for your current document only. Tools Indentation Choose the style of indentation you want for your active document. This overwrites the global indentation mode set in Settings Configure Editor... for your current document only. Tools Encoding You can overwrite the default encoding set in Settings Configure Editor... in the Open/Save page to set a different encoding for your current document. The encoding you set here will be only valid for your current document. Tools End of Line Choose your preferred end of line mode for your active document. This overwrites the global end of line mode set in Settings Configure Editor... for your current document only. Tools Add Byte Mark Order (BOM) Checking this action you can explicitly add a byte order mark for unicode encoded documents. The byte order mark (BOM) is a Unicode character used to signal the endianness (byte order) of a text file or stream, for more information see -Byte Order Mark. +Byte Order Mark. &Ctrl;Space Tools Invoke Code Completion Manually invoke command completion, usually by using a shortcut bound to this action. Tools Word Completion Reuse Word Below (&Ctrl; 9) and Reuse Word Above (&Ctrl; 8) complete the currently typed text by searching for similar words backward or forward from the current cursor position. Shell Completion pops up a completion box with matching entries. &Ctrl;&Shift;O Tools Automatic Spell Checking When Automatic Spell Checking is enabled, wrong text is underlined in the document on-the-fly. ToolsSpelling... This initiates the spellchecking program - a program designed to help the user catch and correct any spelling errors. Clicking on this entry will start the checker and bring up the speller dialog box through which the user can control the process. There are four settings lined up vertically in the center of the dialog with their corresponding labels just to the left. Starting at the top they are: Unknown word: Here, the spellchecker indicates the word currently under consideration. This happens when the checker encounters a word not in its dictionary - a file containing a list of correctly spelled words against which it compares each word in the editor. Replace with: If the checker has any similar words in its dictionary the first one will be listed here. The user can accept the suggestion, type in his or her own correction, or choose a different suggestion from the next box. Language: If you have installed multiple dictionaries, here you can select which dictionary/language should be used. On the right side of the dialog box are 6 buttons that allow the user to control the spellcheck process. They are: Add to Dictionary Pressing this button adds the Unknown word to the checker's dictionary. This means that in the future the checker will always consider this word to be correctly spelled. Suggest The checker may list here a number of possible replacements for the word under consideration. Clicking on any one of the suggestions will cause that word to be entered in the Replace with box, above. Replace This button has the checker replace the word under consideration in the document with the word in the Replace with box. Replace All This button causes the checker to replace not only the current Unknown word: but to automatically make the same substitution for any other occurrences of this Unknown word in the document. Ignore Activating this button will have the checker move on without making any changes. Ignore All This button tells the checker to do nothing with the current Unknown word: and to pass over any other instances of the same word. This only applies to the current spellcheck run. If the checker is run again later it will stop on this same word. Three more buttons are located horizontally along the bottom of the spellcheck dialog. They are: Help This invokes the &kde; help system with the help page for this dialog. Finished This button ends the spellcheck process, and returns to the document. Cancel This button cancels the spellcheck process, all modifications are reverted, and you will return to your document. Tools Spelling (from cursor)... This initiates the spellchecking program but it starts where your cursor is instead of at the beginning of the document. Tools Spellcheck Selection... Spellchecks the current selection. Tools Change Dictionary Displays a drop down box with all available dictionaries for spellchecking at the bottom of the editor window. This allows easy switching of the spellcheck dictionary ⪚ for automatic spellcheck of text in different languages. ToolsClean Indentation This cleans the indentation for the current selection or for the line the cursor is currently in. Cleaning the indentation ensures that all your selected text follows the indentation mode you choose. Tools Align Causes a realign of the current line or selected lines using the indentation mode and indentation settings in the document. &Ctrl;D Tools Comment This adds one space to the beginning of the line where the text cursor is located or to the beginning of any selected lines. &Ctrl;&Shift;D Tools Uncomment This removes one space (if any exist) from the beginning of the line where the text cursor is located or from the beginning of any selected lines. &Ctrl;U Tools Uppercase Put the selected text or the letter after the cursor in uppercase. &Ctrl;&Shift;U Tools Lowercase Put the selected text or the letter after the cursor in lowercase. &Ctrl;&Alt;U Tools Capitalize Capitalize the selected text or the current word. &Ctrl;J Tools Join Lines Joins the selected lines, or the current line and the line below with one white space character as a separator. Leading/trailing white space on joined lines is removed in the affected ends. Tools Apply Word Wrap Apply static word wrapping on all the document. That means that a new line of text will automatically start when the current line exceeds the length specified by the Wrap words at option in the Editing tab in SettingsConfigure Editor... If the plugin Insert File is enabled, you will find here an additional menu item Insert File.... The Settings Menu Settings Configure Editor... This menu item opens a dialog whereby several different settings may be adjusted. The KrViewer Menu &Ctrl;&Shift; G KrViewer Generic viewer &krusader;'s internal viewer is actually part of &konqueror;, which can basically view every file type viewable by &konqueror; (⪚ display pictures, play music, show the content of an archive). &Ctrl;&Shift; T KrViewer Text viewer View the file in text mode. &Ctrl;&Shift; H KrViewer Hex viewer View the file in hex mode. &Ctrl;&Shift; L KrViewer Lister Fast text/hex viewer for huge filesizes, done by Krusader lister. &Ctrl;&Shift; E KrViewer Text editor Edit the file in text mode. &Ctrl;&Shift; D KrViewer Detach Tab Detach browsing Tab and open in a new window. &Ctrl; Q KrViewer Quit Closes &krusader;'s viewer/editor window. The Editor Component Configuration This group contains all pages related to the editor component of &kappname;. Most of the settings here are defaults, they can be overridden by defining a filetype, by Document Variables or by changing them per document during an editing session. Appearance General Dynamic Word Wrap If this option is checked, the text lines will be wrapped at the view border on the screen. Dynamic word wrap indicators (if applicable) Choose when the Dynamic word wrap indicators should be displayed, either Off, Follow Line Numbers or Always on. Align dynamically wrapped lines to indentation depth: Enables the start of dynamically wrapped lines to be aligned vertically to the indentation level of the first line. This can help to make code and markup more readable.Additionally, this allows you to set a maximum width of the screen, as a percentage, after which dynamically wrapped lines will no longer be vertically aligned. For example, at 50%, lines whose indentation levels are deeper than 50% of the width of the screen will not have vertical alignment applied to subsequent wrapped lines. Whitespace Highlighting Highlight tabulators The editor will display a » symbol to indicate the presence of a tab in the text. Highlight trailing spaces The editor will display dots to indicate the presence of extra whitespace at the end of lines. Advanced Show indentation lines If this is checked, the editor will display vertical lines to help identifying indent lines. Highlight range between selected brackets If this is enabled, the range between the selected matching brackets will be highlighted. Borders Borders Show folding markers (if available) If this option is checked, the current view will display marks for code folding, if code folding is available. Show icon border If this is checked, you will see an icon border on the left hand side. The icon border shows bookmark signs for instance. Show line numbers If this is checked, you will see line numbers on the left hand side. Show scrollbar marks If this option is checked the current view will show marks on the vertical scrollbar. These marks will for instance show bookmarks. Sort Bookmarks Menu By creation Each new bookmark will be added to the bottom, independently from where it is placed in the document. By position The bookmarks will be ordered by the line numbers they are placed at. Fonts & Colors This section of the dialog lets you configure all fonts and colors in any color scheme you have, as well creating new schemes or deleting existing ones. Each scheme has settings for colors, fonts and normal and highlight text styles. &kappname; will preselect the currently active scheme for you, if you want to work on a different scheme start by selecting that from the Schema combobox. With the New and Delete button you can create a new scheme or delete existing ones. At the bottom of the page you can select the Default schema for &kappname;. Colors Text Area Background Normal text This is the default background for the editor area, it will be the dominant color on the editor area. Selected text This is the background for selected text. The default is the global selection color, as set in your &plasma; color preferences. Current line Set the color for the current line. Setting this a bit different from the Normal text background helps to keep focus on the current line. Bookmark This combobox lets you set overlay colors for various mark types. The color is mixed into the background color of a marked line, so that a line with more marks or a marked line that is current has a background that is a mix of more colors. The mark colors are also used if you enable display of scrollbar marks. Additional Elements Left border background This color is used for the marks, line numbers and folding marker borders in the left side of the editor view when they are displayed. Line numbers This color is used to draw the line numbers on the left side of the view when displayed. Bracket highlight This color is used to draw the background of matching brackets. Word wrap markers This color is used to draw a pattern to the left of dynamically wrapped lines when those are aligned vertically, as well as for the static word wrap marker. Tab and space markers This color is used to draw white space indicators when enabled. Spelling mistake line sets the color of the line that is used to indicate spelling mistakes. Fonts Here you can choose the font for the schema. You can choose from any font available on your system, and set a default size. A sample text displays at the bottom of the dialog, so you can see the effect of your choices. Normal Text Styles The normal text styles are inherited by the highlight text styles, allowing the editor to present text in a very consistent way, for example comment text is using the same style in almost all of the text formats that &kappname; can highlight. The name in the list of styles is using the style configured for the item, providing you with an immediate preview when configuring a style. Each style lets you select common attributes as well as foreground and background colors. To unset a background color, rightclick to use the context menu. Highlighting Text Styles Here you can edit the text styles used by a specific highlight definition. The editor preselects the highlight used by your current document. To work on a different highlight, select one in the Highlight combobox above the style list. The name in the list of styles is using the style configured for the item, providing you with an immediate preview when configuring a style. Each style lets you select common attributes as well as foreground and background colors. To unset a background color, rightclick to use the context menu. In addition you can see if a style is equal to the default style used for the item, and set it to that if not. You will notice that many highlights contain other highlights represented by groups in the style list. For example most highlights import the Alert highlight, and many source code formats imports the Doxygen highlight. Editing colors in those groups only affects the styles when used in the edited highlight format. Editing General Static Word Wrap Word wrap is a feature that causes the editor to automatically start a new line of text and move (wrap) the cursor to the beginning of that new line. &kappname; will automatically start a new line of text when the current line reaches the length specified by the Wrap Words At: option. Enable static word wrap Turns static word wrap on or off. Show static word wrap markers (if applicable) If this option is checked, a vertical line will be drawn at the word wrap column as defined in the Settings Configure Editor... in the Editing tab. Please note that the word wrap marker is only drawn if you use a fixed pitch font. Wrap words at: If the Enable static word wrap option is selected this entry determines the length (in characters) at which the editor will automatically start a new line. Misc Remove trailing spaces while editing &kappname; will automatically eliminate extra spaces at the ends of lines of text. Auto brackets When the user types a left bracket ([, (, or {) &kappname; automatically enters the right bracket (}, ), or ]) to the right of the cursor. Copy/Cut the current line if no selection If this option is enabled and the text selection is empty, copy and cut action are performed for the line of text at the actual cursor position. Allow scrolling past the end of the document This option lets you scroll past the end of the document. This can be used to vertically centre the bottom of the document, or put it on top of the current view. Cursor & Selection Text Cursor Movement Smart home and smart end When selected, pressing the home key will cause the cursor to skip white space and go to the start of a line's text. Wrap cursor When on, moving the insertion cursor using the Left and Right keys will go on to previous/next line at beginning/end of the line, similar to most editors.When off, the insertion cursor cannot be moved left of the line start, but it can be moved off the line end, which can be very handy for programmers. When this option is chosen, moving the cursor with the arrow keys off the end of a line (to the right) causes it to jump down to the beginning of the next line. Likewise when the cursor is moved past the beginning of a line (to the left) it jumps up to the end of the preceding line. When this option is not selected, moving the cursor right past the end of a line merely causes it to continue horizontally in the same line and trying to move it left past the beginning does nothing. PageUp/PageDown moves cursor This option changes the behavior of the cursor when the user presses the Page Up or Page Down key. If unselected the text cursor will maintain its relative position within the visible text in &kappname; as new text becomes visible as a result of the operation. So if the cursor is in the middle of the visible text when the operation occurs it will remain there (except when one reaches the beginning or end.) With this option selected, the first key press will cause the cursor to move to either the top or bottom of the visible text as a new page of text is displayed. Autocenter cursor (lines): Sets the number of lines to maintain visible above and below the cursor when possible. Text Selection Mode Normal Selections will be overwritten by typed text and will be lost on cursor movement. Persistent Selections will stay even after cursor movement and typing. Indentation Default Indentation mode: Select the automatic indentation mode you want to use as default. It is strongly recommended to use None or Normal here, and use filetype configurations to set other indentation modes for text formats like C/C++ code or &XML;. Indent using Tabulators When this is enabled the editor will insert tabulator characters when you press the key or use automatic indentation. Spaces When this is enabled the editor will insert a calculated number of spaces according to the position in the text and the setting when you press the key or use automatic indentation. Tabulators and Spaces When this is enabled, the editor will insert spaces as describe above when indenting or pressing at the beginning of a line, but insert tabulators when the key is pressed in the middle or end of a line. Tab width: This configures the number of spaces that are displayed in place of a tabulator character. Indentation width: The indentation width is the number of spaces which is used to indent a line. If configured to indent using tabulators, a tabulator character is inserted if the indentation is divisible by the tab width. Indentation Properties Keep Extra Spaces If this option is disabled, changing the indentation level aligns a line to a multiple of the width specified in Indentation width. Adjust indentation of code pasted from the clipboard If this option is selected, pasted code from the clipboard is indented. Triggering the Undo action removes the indentation. Indentation Actions Backspace key in leading blank space unindents If this option is selected, the &Backspace; key decreases the indentation level if the cursor is located in the leading blank space of a line. Tab key action (if no selection exists) If you want to align the current line in the current code block like in emacs, make a shortcut to the action Align. Always advance to the next tab position If this option is selected, the key always inserts white space so that the next tab position is reached. If the option Insert spaces instead of tabulators on the General tab in the Editing page is enabled, spaces are inserted; otherwise, a single tabulator is inserted. Always increase indentation level If this option is selected, the key always indents the current line by the number of character positions specified in Indentation width. Increase indentation level if in leading blank space If this option is selected, the key either indents the current line or advances to the next tab position. If the insertion point is at or before the first non-space character in the line, or if there is a selection, the current line is indented by the number of character positions specified in Indentation width. If the insertion point is located after the first non-space character in the line and there is no selection, white space is inserted so that the next tab position is reached: if the option Insert spaces instead of tabulators on the General tab in the Editing page is enabled, spaces are inserted; otherwise, a single tabulator is inserted. Auto Completion General Enable auto completion If enabled, a word completion box automatically pops up during typing showing a list of text entries to complete the current text under the cursor. Minimal word length to complete While typing text, the word completion searches for words in the document starting with the already typed text. This option configures the minimal amount of characters that are needed to make the word completion active and pop up a completion box. Vi Input Mode General Use VI input mode When selected, the vi input mode will be enabled when opening a new view. You can still toggle the vi input mode on/off for a particular view in the Edit menu. Let Vi commands override Kate shortcuts When selected, Vi commands will override &kappname;'s built-in commands. For example: &Ctrl;R will redo, and override the standard action (showing the search and replace dialog). Hide the Vi mode status bar By default, an extra status bar will be used when the Vi input mode is enabled. This status bar shows commands while they are being typed and messages/errors produced by Vi commands. Checking this option will hide this extra status line. Key Mapping Key mapping is used to change the meaning of typed keys. This allows you to move commands to other keys or make special keypresses for doing a series of commands. Example: F2 -> I-- &Esc; This will prepend I-- to a line when pressing F2. Spellcheck These configuration options are described in the documentation for the &systemsettings; module Spell Checker. Open/Save General File Format Encoding: This defines the standard encoding to use to open/save files, if not changed in the open/save dialog or by using a command line option. Encoding Detection Select an item from the drop down box, either to disable autodetection or use Universal to enable autodetection for all encodings. But as this may probably only detect utf-8/utf-16, selecting a region will use custom heuristics for better results. If neither the encoding chosen as standard above, nor the encoding specified in the open/save dialog, nor the encoding specified on command line match the content of the file, this detection will be run. Fallback Encoding This defines the fallback encoding to try for opening files if neither the encoding chosen as standard above, nor the encoding specified in the open/ save dialog, nor the encoding specified on command line match the content of the file. Before this is used, an attempt will be made to determine the encoding to use by looking for a byte order marker at start of file: if one is found, the right unicode encoding will be chosen; otherwise encoding detection will run, if both fail fallback encoding will be tried. End of line: Choose your preferred end of line mode for your active document. You have the choice between &UNIX;, DOS/&Windows; or Macintosh. Automatic end of line detection Check this if you want the editor to autodetect the end of line type. The first found end of line type will be used for the whole file. Enable byte order marker The byte order mark is a special sequence at the beginning of unicode encoded documents. It helps editors to open text documents with the correct unicode encoding. For more information see Byte Order Mark. +url="https://en.wikipedia.org/wiki/Byte_Order_Mark">Byte Order Mark. Automatic Cleanups on Load/Save Remove trailing spaces The editor will automatically eliminate extra spaces at the ends of lines of text while loading/saving the file. Advanced Folder Config File Search depth for config file: The editor will search the given number of folder levels upwards for &kappname; config file and load the settings line from it. Further information about these hidden folder config files you find in the document variables section. Backup on Save Backing up on save will cause &kappname; to copy the disk file to <prefix><filename><suffix> before saving changes. The suffix defaults to ~ and prefix is empty by default. Local files Check this if you want backups of local files when saving. Remote files Check this if you want backups of remote files when saving. Prefix Enter the prefix to prepend to the backup file names. Suffix Enter the suffix to add to the backup file names. Disable swap file syncing &kappname; is able to recover (most of) what was written after last save in case of a crash or power failure. A swap file (.swp.<filename>) is created after the first editing action on a document. If the user doesn’t save the changes and &kappname; crashes, the swap file remains on the disk. When opening a file, &kappname; checks if there is a swap file for the document and if it is, it asks the user whether he wants to recover the lost data or not. The user has the possibility to view the differences between the original file and the recovered one, too. The swap file is deleted after every save and on normal exit. &kappname; syncs the swap files on the disk every 15 seconds, but only if they have changed since the last sync. The user can disable the swap files syncing if he wants, by checking the Disable swap file syncing box, but this can lead to more data loss. Modes & Filetypes This page allows you to override the default configuration for documents of specified MIME types. When the editor loads a document, it will try if it matches the file masks or MIME types for one of the defined filetypes, and if so apply the variables defined. If more filetypes match, the one with the highest priority will be used. Filetype: The filetype with the highest priority is the one displayed in the first drop down box. If more filetypes were found, they are also listed. New This is used to create a new filetype. After you click on this button, the fields below get empty and you can fill the properties you want for the new filetype. Delete To remove an existing filetype, select it from the drop down box and press the Delete button. Properties of current filetype The filetype with the highest priority is the one displayed in the first drop down box. If more filetypes were found, they are also listed. Name: The name of the filetype will be the text of the corresponding menu item. This name is displayed in the ToolsFiletypes Section: The section name is used to organize the file types in menus. This is also used in the ToolsFiletypes menu. Variables: This string allows you to configure &kappname;'s settings for the files selected by this MIME type using &kappname; variables. You can set almost any configuration option, such as highlight, indent-mode, etc. Press Edit to see a list of all available variables and their descriptions. Select the checkbox on the left to enable a particular variable and then set the value of the variable on the right. Some variables provide a drop-down box to select possible values from while others require you to enter a valid value manually. For complete information on these variables, see Configuring with Document Variables. Highlighting: If you create a new file type, this drop down box allows you to select a filetype for highlighting. Indentation Mode: The drop down box specifies the indentation mode for new documents. File extensions: The wildcards mask allows you to select files by filename. A typical mask uses an asterisk and the file extension, for example *.txt; *.text. The string is a semicolon-separated list of masks. MIME types: Displays a wizard that helps you easily select MIME types. Priority: Sets a priority for this file type. If more than one file type selects the same file, the one with the highest priority will be used. Download Highlighting Files... Click this button to download new or updated syntax highlight descriptions from the &kappname; website. Extensions The Plugins tab lists all available plugins and you can check those you want to use. Click on the Information button to open the About dialog of this plugin. Once a configurable plugin is checked, the Configure button is enabled and you can click it in order to configure the highlighted plugin. Editor Component Plugins AutoBrace The autobrace plugin supersedes the &kappname; internal Auto Brackets feature. It automatically inserts a closing brace } at the beginning of the next line after ending a line with an opening one { and pressing the &Enter; key. Data Tools Enables data tools like thesaurus and spell check (if installed). Data tools are only available when text is selected, or when the right mouse button is clicked over a word. If no data tools are offered even when text is selected, you need to install them. If this plugin is enabled and data tools are installed, additional items appear at the end of the context menu. Exporter This command allows you to export the current document with all highlighting information into a HTML document using FileExport as HTML. Additionally you can use Edit Copy as HTML to copy the currently selected text as HTML to the system clipboard. IconInserter The icon inserter plugin is only of use for &kde; developers: It adds an item Insert KIcon-Code into the context menu of the editor. If activated, the &plasma;'s icon chooser opens (showing application icons, action icons &etc;..). If you click on it, the file name without file extension will be inserted as text. Useful only for setting icons via &kf5; through the KIcon() class. Insane (not ZEN) HTML coding (light edition) A plugin, which does zen-coding like selector completion. -For more information see +For more information see Zen Coding. Insert File This plugin allows you to insert any readable file at the cursor position. If enabled, the Tools menu has an additional menu item Insert File.