{ "@V=3.16", 0 }, { "@P=changelog","what\'s new" }, { "", 0 }, { "3.16 24-APR-2007", 0 }, { " Problems fixed:", 0 }, { " - filter in the file panel could leave the counter of", 0 }, { " selected files in an inconsistent state. This could", 0 }, { " lead to problems in other functions that were using", 0 }, { " the counter. The problem existed only on some", 0 }, { " systems", 0 }, { "", 0 }, { "3.15 14-AUG-2006", 0 }, { " Problems fixed:", 0 }, { " - the tilde expansion in the internal cd (change", 0 }, { " directory) command did not work in CLEX 3.14,", 0 }, { " the problem has been corrected", 0 }, { " - the usage of the key in the history panel", 0 }, { " has been corrected: press to delete the", 0 }, { " character from the command line and press", 0 }, { " to delete the entry from the panel", 0 }, { " - the situation when some external command crashes", 0 }, { " and leaves the non-blocking flag set on standard", 0 }, { " input is now properly handled", 0 }, { " New/improved functionality:", 0 }, { " - the locate file function was replaced by a more", 0 }, { " efficient panel filter mechanism. The filtering", 0 }, { " is available in several panel types (ctrl-F)", 0 }, { " - some key bindings has been redefined for", 0 }, { " compatibility reasons", 0 }, { " ==> new key bindings","keys315" }, { " - (for emacs users) ctrl-G has now the same meaning", 0 }, { " as ctrl-C (cancel)", 0 }, { " - user and group names longer than 8 characters were", 0 }, { " silently truncated in the file panel, such names", 0 }, { " are now displayed using the \'>\' mark", 0 }, { " - user (alt-U) and group (alt-G) information panels", 0 }, { " have been added", 0 }, { " - new panel ( ) that summarizes all", 0 }, { " completion and insertion functions has been added.", 0 }, { " Type of the completion can be specified using this", 0 }, { " panel", 0 }, { " - completion of commands from the history utilizes", 0 }, { " the same user interface as the name completion", 0 }, { " - changes made in the bookmark manager can be", 0 }, { " cancelled", 0 }, { " - the input line of the directory panel has no longer", 0 }, { " precedence over the panel contents. You can switch", 0 }, { " the focus (indicated by cursor bar\'s visibility)", 0 }, { " from the input line to the panel and back", 0 }, { " - it is no longer possible to execute commands", 0 }, { " directly from within the history panel. It was", 0 }, { " easy to make a mistake there and execute other", 0 }, { " command than intended (panel vs input line)", 0 }, { " - characters \'!\' and \':\' are automatically quoted only", 0 }, { " if your shell is a C-shell", 0 }, { " - there is yet another new option in the directory", 0 }, { " compare panel", 0 }, { " - configuration parameter SHELLPROG:", 0 }, { " standard option -c is appended", 0 }, { " automatically if it is not specified", 0 }, { " - configuration parameters CMD_Fn:", 0 }, { " command parameters $c and $S have been added", 0 }, { " (cursor position and selected files)", 0 }, { " - configuration parameters LAYOUTn:", 0 }, { " there are two new fields: $S and $P", 0 }, { " (alternative forms of file size and permissions)", 0 }, { "", 0 }, { "3.14 03-NOV-2005", 0 }, { " New/improved functionality:", 0 }, { " - directories can be now bookmarked. Bookmarks are", 0 }, { " automatically saved to a file. Tools for managing", 0 }, { " bookmarks are provided in the bookmark panel", 0 }, { " - new configuration parameter KILOBYTE controls", 0 }, { " whether filesize is displayed in 1000 or 1024 bytes", 0 }, { " large units", 0 }, { " - minor code cleanup", 0 }, { "", 0 }, { "3.13 21-SEP-2005", 0 }, { " Problems fixed:", 0 }, { " - the filename completion routine did not handle", 0 }, { " correctly the special case when a directory and", 0 }, { " a command in the search path had the same name.", 0 }, { " Now both files appear in the completion list", 0 }, { " New/improved functionality:", 0 }, { " - the undo function (ctrl-Z) has been improved,", 0 }, { " several editing steps can be undone and the", 0 }, { " counterpart editing function redo has been added", 0 }, { " ctrl-Z = redo", 0 }, { "", 0 }, { "3.12 14-JUN-2005", 0 }, { " Problems fixed:", 0 }, { " - users could not save their configuration. This bug", 0 }, { " was introduced in the previous release and is now", 0 }, { " fixed", 0 }, { "", 0 }, { "3.11 17-MAY-2005", 0 }, { " Problems fixed:", 0 }, { " - the sort order of the directory names in the", 0 }, { " directory panel was not controlled by the", 0 }, { " configuration parameter COLLATE", 0 }, { " New/improved functionality:", 0 }, { " - the panel used for confirmation of the configuration", 0 }, { " changes has been merged into the configuration panel", 0 }, { " - new option has been added to the directory compare", 0 }, { " panel", 0 }, { " - if a file cannot be read during data comparison,", 0 }, { " files are marked as different (previously only", 0 }, { " an unreadability warning was given)", 0 }, { " - entries from the command history list can be now", 0 }, { " deleted with the key", 0 }, { " - pattern history has been removed from the select", 0 }, { " files function as it was not really helpful", 0 }, { " - configuration parameter SHOW HIDDEN has been", 0 }, { " cancelled", 0 }, { " - added support for shifted left and right arrow", 0 }, { " keys", 0 }, { "", 0 }, { "--------------------", 0 }, { " Details about versions released before 2005 can be found", 0 }, { " in the ChangeLog file which is part of the CLEX source", 0 }, { " code package. It can be also downloaded from the CLEX", 0 }, { " webpage www.clex.sk.", 0 }, { "@P=keys315","new key bindings (CLEX version >= 3.15)" }, { "", 0 }, { "These key bindings have been redefined; use the new keys", 0 }, { "instead of the old ones (please excuse the inconvenience)", 0 }, { "", 0 }, { "In order to make this transition as easy as possible", 0 }, { "CLEX 3.15 recognizes the old keystrokes where indicated (*).", 0 }, { "", 0 }, { " old new", 0 }, { " move cursor left to next word ctrl-B --> alt-B (*)", 0 }, { " move cursor right to next word ctrl-W --> alt-F (*)", 0 }, { " delete word ctrl-D --> alt-D (*)", 0 }, { " directory panel alt-D --> alt-W", 0 }, { " bookmark panel alt-B --> alt-K", 0 }, { " delete until the end of the line ctrl-Y -> ctrl-K (*)", 0 }, { " complete from the command history ctrl-K --> alt-P", 0 }, { " main function menu ctrl-G --> alt-M", 0 }, { " insert the full filename -> ctrl-A", 0 }, { "@P=ToC","TABLE OF CONTENTS (CLEX 3.16)" }, { "", 0 }, { " ==> INDEX","index" }, { "", 0 }, { "BASIC INFORMATION", 0 }, { " ==> How to use this on-line help","help" }, { " ==> Screen overview","screen" }, { " ==> Help with keys","keys" }, { "", 0 }, { "WORKING WITH CLEX", 0 }, { " ==> File panel & command line","file" }, { " In the file panel:", 0 }, { " ==> Selecting files using patterns","select" }, { " ==> Sorting files","sort" }, { " ==> Comparing directories","compare" }, { " ==> Main function menu","menu" }, { " ==> Name completion","completion" }, { " ==> Directory panel","dir" }, { " ==> Bookmark panel","bookmarks" }, { " ==> Command history panel","history" }, { " ==> Configuration panel","config" }, { " ==> User and group data","user" }, { " ==> Using filters","filter" }, { "", 0 }, { "ABOUT CLEX", 0 }, { " ==> What\'s new <-- PLEASE READ after installation/upgrade","changelog" }, { " ==> Miscellaneous notes","notes" }, { " ==> About CLEX","about" }, { "", 0 }, { "--------------------", 0 }, { " - please report any errors or typos to clex@clex.sk", 0 }, { " - you can browse this help also on Internet:", 0 }, { " http://www.clex.sk/help/", 0 }, { "@P=index","Index" }, { "", 0 }, { "A about CLEX","about" }, { " admin mode (configuration)","admin" }, { " automatic filename quoting","quoting" }, { "", 0 }, { "B bookmark panel (directory bookmarks)","bookmarks" }, { "", 0 }, { "C changelog","changelog" }, { " changing working directory:", 0 }, { " - the \'cd\' command","cd" }, { " - the directory panel","dir" }, { " - the bookmark panel","bookmarks" }, { " - in the file panel (see II. FILES AND DIRECTORIES)","file" }, { " command history (history panel)","history" }, { " command line options","options" }, { " compare directories","compare" }, { " completion (name completion)","completion" }, { " completion/insertion panel","paste" }, { " configuration, admin mode","admin" }, { " configuration, configuration panel","config" }, { "", 0 }, { "D directory panel","dir" }, { "", 0 }, { "E editing:", 0 }, { " - advanced (file panel, see III. ADVANCED EDITING)","file" }, { " - basic","keys_textline" }, { "", 0 }, { "F file panel","file" }, { " file panel screen","screen" }, { " filename completion (name completion)","completion" }, { " filters","filter" }, { "", 0 }, { "G group information panel","user" }, { "", 0 }, { "H history panel","history" }, { " homepage: http://www.clex.sk", 0 }, { "", 0 }, { "K keys","keys" }, { "", 0 }, { "L license agreement","license" }, { "", 0 }, { "N name completion","completion" }, { "", 0 }, { "M main function menu (main menu)","menu" }, { "", 0 }, { "P panels:", 0 }, { " - bookmark panel","bookmarks" }, { " - configuration panel","config" }, { " - directory panel","dir" }, { " - file panel","file" }, { " - history panel","history" }, { " primary panel (working directories)","2dirs" }, { "", 0 }, { "Q quoting of filenames","quoting" }, { "", 0 }, { "S screen overview (file panel screen)","screen" }, { " secondary panel (working directories)","2dirs" }, { " selecting files (file panel, II. FILES AND DIRECTORIES)","file" }, { " selecting files using patterns","select" }, { " sorting filenames","sort" }, { "", 0 }, { "T tilde substitution","tilde" }, { "", 0 }, { "U user information panel","user" }, { "", 0 }, { "W working directories","2dirs" }, { "@P=options","command line options" }, { "", 0 }, { "These options are recognized when starting CLEX from", 0 }, { "the command line:", 0 }, { "", 0 }, { "-a, --admin Run CLEX in admin mode. System-wide", 0 }, { " configuration can be customized in admin mode.", 0 }, { " Write access to the system-wide configuration", 0 }, { " file is required.", 0 }, { " ==> admin mode","admin" }, { "", 0 }, { "--version Display program version and some basic", 0 }, { " information and exit.", 0 }, { "", 0 }, { "--help Display help and exit.", 0 }, { "", 0 }, { "@P=help","help with on-line help" }, { "", 0 }, { " display the table of contents", 0 }, { " ctrl-C or ctrl-G leave help", 0 }, { " and move cursor bar", 0 }, { " and move cursor bar", 0 }, { " or follow link to other help-page", 0 }, { " (links are highlighted)", 0 }, { " or go back to previous help-page", 0 }, { "", 0 }, { "On-line help is context sensitive: after pressing it", 0 }, { "displays the table of contents as its first page and the", 0 }, { "cursor bar is positioned on a link corresponding with", 0 }, { "the currently used panel.", 0 }, { "@P=screen","CLEX screen overview" }, { "", 0 }, { "The screen is divided into two areas: the PANEL, where", 0 }, { "various kinds of data are displayed, and the INPUT LINE,", 0 }, { "where a user can enter and edit his/her input.", 0 }, { "", 0 }, { "PANEL heading ---> /usr/local/bin /tmp", 0 }, { " frame -----> ----------------------------------------", 0 }, { " /-> 07:55 5.120 /DIR .", 0 }, { " /--> 23feb01 1.024 /DIR ..", 0 }, { " data --<---> >01sep01****650k***exec**perl**********<", 0 }, { " \\--> 12oct99 49k exec gzip", 0 }, { " \\->", 0 }, { " frame -----> ---------------------------------<3/4>--", 0 }, { " info line--> 0755 rwxr-xr-x root:sys acc=22:12", 0 }, { " *CLEX*file*manager**********************", 0 }, { "INPUT LINE -------> shell $ echo \"Hello, world!\"_", 0 }, { " prompt ------^ ^", 0 }, { " user\'s input --------\'", 0 }, { "", 0 }, { "There are several types of panels with a corresponding", 0 }, { "input line, e.g. the file panel with the COMMAND LINE", 0 }, { "or the configuration panel.", 0 }, { "", 0 }, { "One of the lines in the panel is highlighted with", 0 }, { "the CURSOR BAR. It is called the CURRENT LINE.", 0 }, { "", 0 }, { "If a line is too long to fit on the screen, it is indicated", 0 }, { "by a highlighted character \'>\' on the right.", 0 }, { "", 0 }, { "In the right margin in the panel frame there is the line", 0 }, { "number of the current line, and the total number of lines", 0 }, { "in the panel.", 0 }, { "", 0 }, { "The input line occupies only a few lines on the screen,", 0 }, { "but it can contain many lines of text.", 0 }, { "@P=keys","frequently used keys" }, { "", 0 }, { "Notation:", 0 }, { " ctrl-X = press and ", 0 }, { " alt-X = press and ", 0 }, { " or and ", 0 }, { " or press first and then ", 0 }, { " (depends on your terminal/keyboard)", 0 }, { "", 0 }, { "Basic keys available in all panels:", 0 }, { "==> CLEX control keys","keys_control" }, { "==> panel scrolling keys","keys_scroll" }, { "==> basic editing commands","keys_textline" }, { "", 0 }, { "--------------------", 0 }, { "Notes:", 0 }, { " - working arrow keys are an essential requirement", 0 }, { " - please read this note if special keys to ", 0 }, { " are not working properly on your terminal", 0 }, { " ==> about function keys","keys_fn" }, { "@P=keys_fn","problems with function keys" }, { "", 0 }, { "If function keys to do not work on your terminal", 0 }, { "as expected, use this procedure until the problem gets", 0 }, { "fixed:", 0 }, { "", 0 }, { " press alt-1 (or 1) for ", 0 }, { " alt-2 (or 2) for ", 0 }, { " ...", 0 }, { " alt-9 (or 9) for ", 0 }, { " alt-0 (or 0) for ", 0 }, { "", 0 }, { "On some systems the keys work properly but ", 0 }, { "sequences do not work. You have to press the key twice", 0 }, { "before pressing to .", 0 }, { "", 0 }, { "--------------------", 0 }, { "Note:", 0 }, { " - N is not ", 0 }, { "@P=keys_scroll","panel scrolling keys" }, { "", 0 }, { "These keystrokes scroll a panel:", 0 }, { "", 0 }, { " line up", 0 }, { " line down", 0 }, { " page up", 0 }, { " page down", 0 }, { " go to the top of panel", 0 }, { " go to the bottom of panel", 0 }, { "@P=keys_textline","basic editing commands" }, { "", 0 }, { "You can use following keys for editing:", 0 }, { "", 0 }, { "MOVE CURSOR", 0 }, { " character left", 0 }, { " character right", 0 }, { " to the beginning of the line", 0 }, { " to the end of the line", 0 }, { " alt-B or shift- word left (back)", 0 }, { " alt-F or shift- word right (forward)", 0 }, { " line up", 0 }, { " line down", 0 }, { "", 0 }, { "DELETE", 0 }, { " delete the character under the cursor", 0 }, { " alt-D delete the word at the cursor", 0 }, { " or ctrl-H delete the character to the left", 0 }, { " ctrl-K delete until the end of the line", 0 }, { " ctrl-U delete the entire line", 0 }, { "", 0 }, { "INSERT", 0 }, { " All regular text that you type is inserted, there is no", 0 }, { " overtype mode. Press ctrl-V to insert special characters.", 0 }, { "", 0 }, { " ctrl-V insert the following character X", 0 }, { " ctrl-V insert the code NNN decimal (001 to 255)", 0 }, { " ctrl-V X insert the code NN hex (01 to FF)", 0 }, { "", 0 }, { "UNDO/REDO", 0 }, { " ctrl-Z undo (reverse the last insert", 0 }, { " or delete operation)", 0 }, { " ctrl-Z redo (revert to the state before undo)", 0 }, { "", 0 }, { "Note:", 0 }, { "--------------------", 0 }, { " - unprintable characters are displayed as highlighted", 0 }, { " question marks \'?\'. If you put the cursor over such", 0 }, { " character, you can see its ASCII value", 0 }, { "@P=keys_control","CLEX control commands" }, { "", 0 }, { "These are the keys to remember:", 0 }, { "", 0 }, { "ctrl-C or ctrl-G cancel function or leave the current panel", 0 }, { " alt-M invoke main function menu", 0 }, { " ctrl-L redraw screen", 0 }, { " on-line help", 0 }, { " alt-Q quit program", 0 }, { "@P=file","file panel" }, { "", 0 }, { "Working with the file panel is the basic operation mode.", 0 }, { "You can inspect files, change directories, create commands", 0 }, { "in the command line, and execute them.", 0 }, { "==> introduction","file_intro" }, { "", 0 }, { "I. ACCESS TO OTHER PANELS", 0 }, { " alt-M go to the main function menu", 0 }, { " ==> main function menu","menu" }, { " alt-W go to the directory panel", 0 }, { " ==> change working directory","dir" }, { " alt-K go to the bookmark panel", 0 }, { " ==> directory bookmarks","bookmarks" }, { " alt-C go to the program configuration panel", 0 }, { " ==> configuring CLEX","config" }, { " alt-S go to the sort panel", 0 }, { " ==> change sort order for files","sort" }, { " alt-H go to the command history panel", 0 }, { " ==> command history list","history" }, { " alt-U and alt-G go to the user/group panel", 0 }, { " ==> user and group information","user" }, { " go to the completion/insertion panel", 0 }, { " ==> complete/insert text at the input line","paste" }, { "", 0 }, { "II. FILES AND DIRECTORIES", 0 }, { " 1) Changing working directory", 0 }, { " / change into the root directory", 0 }, { " . change into the parent (..) directory", 0 }, { " ~ change into your home directory", 0 }, { " several functions,", 0 }, { " see below in \'II.3 Miscellaneous\'", 0 }, { " alt-W go to the directory panel", 0 }, { " alt-K go to the bookmark panel", 0 }, { " (see above in \'I. OTHER PANELS\')", 0 }, { "", 0 }, { " See also:", 0 }, { " ==> the \'cd\' command","cd" }, { "", 0 }, { " 2) Selecting files", 0 }, { " Selected names are to be used in commands, see the", 0 }, { " paragraph \'III.3 building commands\' below. Directories", 0 }, { " . and .. cannot be selected.", 0 }, { "", 0 }, { " select/deselect current file", 0 }, { " ctrl-T ditto", 0 }, { " alt-+ select files that match pattern", 0 }, { " alt-- deselect files that match pattern", 0 }, { " ==> pattern matching rules","select" }, { " alt-* invert selection", 0 }, { " (in the menu) select all files", 0 }, { " (in the menu) deselect all files", 0 }, { " alt-= compare files in both directories", 0 }, { " ==> how CLEX compares files","compare" }, { "", 0 }, { " 3) Miscellaneous", 0 }, { " ctrl-R re-read the contents of the directory,", 0 }, { " i.e. refresh the file panel", 0 }, { " ctrl-R same as ctrl-R, but user account data", 0 }, { " gets reloaded as well", 0 }, { " (this is rarely needed because CLEX takes", 0 }, { " care of it automatically)", 0 }, { " ==> user account data caching","accounts" }, { " ctrl-X exchange primary <--> secondary panel", 0 }, { " ctrl-F panel filter", 0 }, { " ==> how to use the panel filter","filter" }, { " three functions:", 0 }, { " if there is a command in the command line:", 0 }, { " = execute the current command", 0 }, { " otherwise if current file is a directory:", 0 }, { " = change into this directory", 0 }, { " otherwise if current file is executable:", 0 }, { " = insert \'./file\' into the", 0 }, { " command line", 0 }, { " change into a directory", 0 }, { "", 0 }, { "III. ADVANCED EDITING", 0 }, { " 1) Inserting (pasting) names into the command line", 0 }, { " insert or complete", 0 }, { " ==> using the key","tab" }, { " insert the name of the current file", 0 }, { " insert the names of all selected files", 0 }, { " ctrl-A insert the full pathname of the current", 0 }, { " file: /path/to/file", 0 }, { " ctrl-E insert the name of the secondary", 0 }, { " working directory", 0 }, { " ctrl-E insert the name of the current working", 0 }, { " directory", 0 }, { " ==> about working directories","2dirs" }, { " ctrl-O insert the target of a symbolic link", 0 }, { "", 0 }, { " 2) Filename completion", 0 }, { " insert or complete", 0 }, { " ==> using the key","tab" }, { "", 0 }, { " 3) Building commands", 0 }, { " insert the name of the current file", 0 }, { " - insert a command:", 0 }, { " = view = edit = copy", 0 }, { " = move = make dir = delete", 0 }, { " = print to = user defined", 0 }, { " The commands above normally work with the", 0 }, { " current file. If you press before", 0 }, { " - then they work with the", 0 }, { " selected files.", 0 }, { " execute the command", 0 }, { "", 0 }, { " All inserted filenames are quoted.", 0 }, { " ==> automatic quoting","quoting" }, { "", 0 }, { " 4) Command history", 0 }, { " ctrl-P recall the previous command from the", 0 }, { " history list", 0 }, { " ctrl-N recall the next command", 0 }, { " alt-P complete command, i.e. search the history", 0 }, { " for command(s) matching the text in the", 0 }, { " command line", 0 }, { " alt-H go to the history panel", 0 }, { " (see above in \'I. OTHER PANELS\')", 0 }, { "", 0 }, { " A menu of selected functions can be found in the", 0 }, { " completion/insertion panel. Press to", 0 }, { " display it.", 0 }, { " ==> completion/insertion panel","paste" }, { "@P=accounts","user account data" }, { "", 0 }, { "CLEX internally caches the data about user and group", 0 }, { "accounts. This data is mainly used to obtain the file", 0 }, { "owners\' names.", 0 }, { "", 0 }, { "CLEX automatically monitors /etc/passwd and /etc/group", 0 }, { "system files and detects any changes immediately.", 0 }, { "", 0 }, { "Account data may be also stored outside of these files,", 0 }, { "e.g. in a network database called NIS (this is a seldom", 0 }, { "used feature). The user account data cache expires after", 0 }, { "five minutes, so it can take up to five minutes before", 0 }, { "CLEX detects any modifications that have been made.", 0 }, { "", 0 }, { "To overcome this limitation you can press before", 0 }, { "ctrl-R to force immediate refresh of the user data cache.", 0 }, { "@P=file_intro","file panel introduction" }, { "", 0 }, { "You can see two directory names on the top of the file panel", 0 }, { "screen: the current working directory on the left and the", 0 }, { "secondary working directory on the right.", 0 }, { "==> working directories","2dirs" }, { "", 0 }, { "The contents of the current working directory are listed in", 0 }, { "the file panel on the screen. One file is highlighted with", 0 }, { "the cursor bar. It is called the current file, additional", 0 }, { "information about it is displayed in the info line.", 0 }, { "", 0 }, { "The layout of the file panel screen is configurable;", 0 }, { "the following data may be shown in the listing of files", 0 }, { "or in the info line:", 0 }, { " - name of the file", 0 }, { " - where the symbolic link points to (links only)", 0 }, { " - date or time of last file modification", 0 }, { " - date or time of last file access", 0 }, { " - date or time of last inode change", 0 }, { " - file size in bytes, KB, or MB", 0 }, { " or device minor and major numbers (devices only)", 0 }, { " - whether it is a symbolic link (indicated by -> )", 0 }, { " - type of file:", 0 }, { " [none] plain file", 0 }, { " exec plain file, executable", 0 }, { " suid executable file with set-UID bit set", 0 }, { " Suid set-UID file owned by root", 0 }, { " sgid executable file with set-GID bit set", 0 }, { " /DIR directory", 0 }, { " /MNT directory, active mount point", 0 }, { " Bdev block device", 0 }, { " Cdev character device", 0 }, { " FIFO FIFO; FIFOs are also called named pipes", 0 }, { " SOCK socket", 0 }, { " spec special file, i.e. anything else", 0 }, { " ?? type could not be determined due to an error", 0 }, { " - whether the file is selected (indicated by * )", 0 }, { " - permission bits (as octal number and/or as a string)", 0 }, { " - owner and group", 0 }, { " - number of hard links or an indicator of multiple links", 0 }, { "", 0 }, { "The number of selected files (if any) is shown in the", 0 }, { "panel frame along with the line numbers.", 0 }, { "", 0 }, { "The command line occupies only a few lines on the screen,", 0 }, { "but it can contain many lines of text. Here you type and", 0 }, { "edit commands to be executed. The prompt is configurable.", 0 }, { "", 0 }, { "--------------------", 0 }, { "Notes:", 0 }, { " - /DIR and /MNT - CLEX might not detect mount points", 0 }, { " created with mount --bind or mount --move", 0 }, { " available on modern linux kernels", 0 }, { " - time of the day instead of date is displayed for times", 0 }, { " within the last 18 hours", 0 }, { " - device minor numbers are shown in hexadecimal", 0 }, { " - owner and group names are limited to 9 characters here,", 0 }, { " visit the user or group information panel to see the", 0 }, { " full names", 0 }, { "@P=2dirs","working directories" }, { "", 0 }, { "There are two file panels and two corresponding working", 0 }, { "directories:", 0 }, { " 1) The contents of the normal current working directory", 0 }, { " are listed in the primary file panel on the screen.", 0 }, { " 2) The so-called secondary working directory is used as", 0 }, { " a destination directory for copy and move commands.", 0 }, { " It is associated with the secondary file panel which", 0 }, { " is not displayed on the screen.", 0 }, { "", 0 }, { "Here are some related functions:", 0 }, { " ctrl-X exchange primary <--> secondary panel", 0 }, { " alt-= compare files in both directories", 0 }, { " and mark differences", 0 }, { " ctrl-E insert the name of the secondary working", 0 }, { " directory", 0 }, { " ctrl-E insert the name of the current working", 0 }, { " directory", 0 }, { " and commands COPY and MOVE normally copy and move", 0 }, { " files from the current directory to the", 0 }, { " secondary working directory", 0 }, { "@P=quoting","automatic filename quoting" }, { "", 0 }, { "CLEX correctly handles special characters in filenames.", 0 }, { "For example: in order to delete a file named \'*\' (asterisk)", 0 }, { "it generates the correct command \'rm \\*\', and not the", 0 }, { "incorrect and disastrous \'rm *\'.", 0 }, { "", 0 }, { "Please note that automatic quoting applies only to", 0 }, { "filenames being inserted into the command line", 0 }, { "( and keys to ).", 0 }, { "", 0 }, { "See also:", 0 }, { "==> configuration parameter QUOTE","config_other" }, { "@P=tab","functions of the key" }, { "", 0 }, { "The key has two really useful functions in the", 0 }, { "file panel:", 0 }, { "", 0 }, { "1) if the cursor stands within or immediately after a word,", 0 }, { " attempts to complete it", 0 }, { " ==> name completion","completion" }, { "", 0 }, { "2) otherwise (if there is nothing to complete)", 0 }, { " inserts text into the command line:", 0 }, { " a) if a command name is expected (it is the first word", 0 }, { " in the command) and the current file is an executable", 0 }, { " file or a directory, then it inserts:", 0 }, { " ./executable", 0 }, { " or", 0 }, { " directory/", 0 }, { " b) if an argument is expected (not the first word in the", 0 }, { " command), it inserts the name of the current file:", 0 }, { " file", 0 }, { "", 0 }, { "--------------------", 0 }, { "Notes:", 0 }, { " - if you just want to insert filename(s) without any", 0 }, { " completion, you might also use the key", 0 }, { " - all inserted filenames are correctly quoted", 0 }, { " ==> automatic quoting","quoting" }, { "@P=filter","ctrl-F - panel filter" }, { "", 0 }, { "This function helps you to find an entry in a long listing", 0 }, { "quickly. It is available in the file panel (file names),", 0 }, { "the directory panel (directory names), the history panel", 0 }, { "(commands), and the user/group panels (user names).", 0 }, { "", 0 }, { "There are two filtering modes:", 0 }, { " - filter expression is a substring", 0 }, { " this is the default mode.", 0 }, { " - filter expression is a pattern", 0 }, { " this mode is available in the file panel only and is", 0 }, { " is automatically selected if the filter expression", 0 }, { " contains wildcards: * ? or [].", 0 }, { " ==> pattern matching details","patterns" }, { "", 0 }, { "Type in some:", 0 }, { " - string appearing in the entry, or", 0 }, { " - pattern matching the filename, respectively.", 0 }, { "While you type, the panel contents shrink to display only", 0 }, { "those entries that match the filter expression you have", 0 }, { "entered.", 0 }, { "", 0 }, { "All panel functions are available while the panel filter is", 0 }, { "active. Finally press:", 0 }, { " - to cancel the panel filter", 0 }, { " (see the note below)", 0 }, { " ctrl-F - to return to the input line while the filter", 0 }, { " remains active. Repeated ctrl-F will bring", 0 }, { " you back to the filter expression.", 0 }, { "", 0 }, { "--------------------", 0 }, { "Notes:", 0 }, { " - the filter in the directory panel cannot be cancelled", 0 }, { " (you can delete the filter expression though). This", 0 }, { " prevents an undesired interaction between filtering", 0 }, { " and compacting of the directory names.", 0 }, { " - warning \'pattern is incomplete\' is shown when a closing", 0 }, { " quote or a closing brace is missing", 0 }, { "@P=compare","alt-= - comparing directories" }, { "", 0 }, { "Files in the current working directory (primary panel) and", 0 }, { "files in the secondary working directory (secondary panel)", 0 }, { "are compared with each other and the differences are marked", 0 }, { "with selection marks.", 0 }, { "", 0 }, { "Files which are the same in both directories are not", 0 }, { "selected and files which do not appear in both directories", 0 }, { "or are different are selected.", 0 }, { "", 0 }, { "There are six comparison levels. In level 0 are two files", 0 }, { "equal if they have the same name and the same type, In", 0 }, { "addition to this level, the file size, file ownership and", 0 }, { "access permissions (the file mode) and/or the file data", 0 }, { "(contents of the files) are compared in levels 1 to 5.", 0 }, { "", 0 }, { "In level 0 and 1 there is relaxed type checking: symbolic", 0 }, { "links are treated as files of the same type.", 0 }, { "", 0 }, { "Starting from level 2 there is exact type checking: normal", 0 }, { "files and symbolic links are considered not equal.", 0 }, { "", 0 }, { "Select the desired level with the cursor bar or press the", 0 }, { "corresponding key 0 to 5.", 0 }, { "", 0 }, { "--------------------", 0 }, { "Notes:", 0 }, { " - both directories are automatically re-read before", 0 }, { " comparison", 0 }, { " - only the data of plain files is compared", 0 }, { "@P=bm_manager","bookmark manager" }, { "", 0 }, { "The bookmark manager is accessible directly from the", 0 }, { "bookmark panel and provides set of functions needed", 0 }, { "for the bookmark list maintenance:", 0 }, { "", 0 }, { " D move the entry down", 0 }, { " U move the entry up", 0 }, { " or I insert a new entry", 0 }, { " or R remove the bookmark from the list", 0 }, { " edit the current bookmark", 0 }, { "", 0 }, { "After finishing your work just leave the panel. The data", 0 }, { "are saved automatically, there is no SAVE function. In", 0 }, { "the case you change your mind and do not want to save", 0 }, { "the modified bookmark list, select \'--> Revert\' from the", 0 }, { "top of the panel, then start again or leave the panel.", 0 }, { "", 0 }, { "--------------------", 0 }, { "Note:", 0 }, { " - bookmarked directory names must be absolute", 0 }, { " directories, i.e. starting from the root directory /", 0 }, { "@P=bookmarks","alt-K - bookmark panel" }, { "", 0 }, { "Bookmarks are a list of directory names you wish to record.", 0 }, { "They are preserved even when you exit CLEX.", 0 }, { "", 0 }, { "To add a bookmark:", 0 }, { " - go to the directory you wish to bookmark", 0 }, { " - enter the bookmark panel and select", 0 }, { " \'-->Bookmark current working directory\'", 0 }, { "", 0 }, { "More functions (edit, delete, etc.) can be found in the", 0 }, { "bookmark manager - follow the \'--> Manage bookmarks\' link.", 0 }, { "==> bookmark manager","bm_manager" }, { "", 0 }, { "--------------------", 0 }, { "Notes:", 0 }, { " - bookmarks are stored in a file named .clexbm in user\'s", 0 }, { " home directory", 0 }, { " - concurrent CLEX sessions: bookmarks changed in another", 0 }, { " session are loaded automatically every time the", 0 }, { " bookmark panel is entered", 0 }, { "", 0 }, { "@P=dir","alt-W - changing working directory" }, { "", 0 }, { "The directory panel allows you to change the working", 0 }, { "directory using any of the following methods:", 0 }, { "", 0 }, { "1) Choosing directory name from the panel", 0 }, { " CLEX maintains a list of recently visited directories", 0 }, { " to help you to return to a previously used directory", 0 }, { " easily.", 0 }, { "", 0 }, { " The list is sorted alphabetically and is compacted.", 0 }, { " ==> what is compacting","compacting" }, { "", 0 }, { " Simply highlight the requested directory with the", 0 }, { " cursor bar and press . A new list will appear", 0 }, { " in the panel showing the chosen directory split into", 0 }, { " components. Confirm the requested directory again", 0 }, { " with .", 0 }, { "", 0 }, { " The panel filter (ctrl-F) can be used for finding", 0 }, { " directory names in the panel.", 0 }, { " ==> how to use the panel filter","filter" }, { "", 0 }, { "2) Entering new directory name", 0 }, { " Either press the key to insert the current name", 0 }, { " from the panel to the empty input line or simply start", 0 }, { " to type in the name of the new working directory. All", 0 }, { " editing functions are available.", 0 }, { " ==> editing text","keys_textline" }, { " With the key you can try to complete a partial", 0 }, { " directory name.", 0 }, { " ==> name completion","completion" }, { " Finally press .", 0 }, { "", 0 }, { "When the input line or the panel is being used, the focus", 0 }, { "automatically changes accordingly. The focus is indicated", 0 }, { "by the cursor bar\'s visibility and by highlighting of the", 0 }, { "input line prompt. Which directory name has the focus is", 0 }, { "important when you press the .", 0 }, { "", 0 }, { "3) Choosing directory name from the bookmark list", 0 }, { " Follow the \'--> Bookmarks\' link (or press alt-K)", 0 }, { " to switch to the bookmark panel and then select", 0 }, { " a directory from the list.", 0 }, { " ==> bookmark panel","bookmarks" }, { "", 0 }, { "Note that CLEX performs tilde substitution.", 0 }, { "==> tilde substitution","tilde" }, { "", 0 }, { "If an error occurs (e.g. directory not found), either", 0 }, { "correct the directory name and try again or press ctrl-C", 0 }, { "(or ctrl-G) to cancel the operation and leave the", 0 }, { "directory panel.", 0 }, { "", 0 }, { "--------------------", 0 }, { "Please note that there are also convenient methods", 0 }, { "to change the working directory without using", 0 }, { "the directory panel:", 0 }, { "", 0 }, { "- make use of the \'cd\' command in the command line", 0 }, { " ==> the \'cd\' command","cd" }, { "", 0 }, { "- traverse the directory tree:", 0 }, { " move the file panel cursor bar to the requested", 0 }, { " directory and press . The can", 0 }, { " be omitted if the command line is empty.", 0 }, { "", 0 }, { "- use the shortcuts for frequently used change", 0 }, { " directory commands:", 0 }, { " alt-/ change into the root directory", 0 }, { " alt-. change into the parent (..) directory", 0 }, { " alt-~ change into your home directory", 0 }, { "@P=compacting","compacted directory list" }, { "", 0 }, { "If there are two directories in the list named for example", 0 }, { "/usr and /usr/X11R6/lib/X11/fonts/Type1, the former is", 0 }, { "considered to be contained in the latter and only the", 0 }, { "longer name appears in the list.", 0 }, { "", 0 }, { "If you then choose /usr/X11R6/lib/X11/fonts/Type1 from the", 0 }, { "list, CLEX splits it into a list of components like this:", 0 }, { " /usr/X11R6/lib/X11/fonts/Type1", 0 }, { " /usr/X11R6/lib/X11/fonts", 0 }, { " /usr/X11R6/lib/X11", 0 }, { " /usr/X11R6/lib", 0 }, { " /usr/X11R6", 0 }, { " /usr", 0 }, { " /", 0 }, { "and the /usr directory from our example reappears", 0 }, { "in the panel this way.", 0 }, { "@P=cd","the \'cd\' command" }, { "", 0 }, { "The \'cd\' command changes the current directory. Simply type", 0 }, { " cd /some/directory", 0 }, { "at the command line and press .", 0 }, { "", 0 }, { "To make it work, CLEX treats the \'cd\' command as a special", 0 }, { "case and processes it internally.", 0 }, { "", 0 }, { "It is required that all special shell characters occurring", 0 }, { "in the directory name are quoted with a backslash, otherwise", 0 }, { "the command will not be processed internally. The tilde", 0 }, { "substitution is supported though.", 0 }, { "==> tilde substitution","tilde" }, { "", 0 }, { "The \'cd\' command is an alternative to the directory panel.", 0 }, { "==> directory panel","dir" }, { "", 0 }, { "Examples:", 0 }, { " this command", 0 }, { " cd /var/log", 0 }, { " will be processed internally and will change the", 0 }, { " working directory, while this command", 0 }, { " cd /dev ; ls -l lp*", 0 }, { " will be executed normally, i.e. by a separate process and", 0 }, { " the effect of \'cd\' will be lost after returning to CLEX.", 0 }, { "", 0 }, { "--------------------", 0 }, { "Notes:", 0 }, { " - the special shell characters mentioned above", 0 }, { " are listed here:", 0 }, { " ==> QUOTE parameter","config_other" }, { "@P=tilde","tilde substitution" }, { "", 0 }, { "If the directory name begins with a tilde:", 0 }, { "~ - the tilde will be substituted with your home", 0 }, { " directory", 0 }, { "~username - if you append a username after the tilde, it", 0 }, { " will be substituted with the home directory of", 0 }, { " the the specified user. If no such user is", 0 }, { " found, then the original text is left unchanged", 0 }, { "", 0 }, { "Examples:", 0 }, { " ~root - the home directory of the user root", 0 }, { " ~/bin - the subdirectory bin in your home directory", 0 }, { "@P=history","alt-H - command history" }, { "", 0 }, { "The history panel offers advanced functions for work with", 0 }, { "the command line history list. The most common tasks can be", 0 }, { "accomplished directly from the file panel: see ctrl-P,", 0 }, { "ctrl-N, and alt-P.", 0 }, { "", 0 }, { "In the history panel you can browse the list of recently", 0 }, { "executed commands, execute a chosen command, or insert the", 0 }, { "command(s) to the command line and edit them as required,", 0 }, { "for example you can easily combine two or more previously", 0 }, { "executed commands into one new command.", 0 }, { "", 0 }, { "Help with keys:", 0 }, { " ==> moving cursor bar","keys_scroll" }, { " ==> editing text","keys_textline" }, { " execute the command in the command line.", 0 }, { " If the command line is empty, the", 0 }, { " current command from the history list", 0 }, { " will be executed", 0 }, { " insert the text of the current command", 0 }, { " from the panel to the command line", 0 }, { " delete the entry from the history list", 0 }, { " ctrl-F activate the filter mode", 0 }, { " ==> the panel filter","filter" }, { " ctrl-C or ctrl-G leave the history panel (changes made", 0 }, { " in the command line are preserved)", 0 }, { "@P=completion","name completion" }, { "", 0 }, { "After pressing the key, CLEX attempts to complete any", 0 }, { "name (word) found at the cursor position. There are 5 types", 0 }, { "of name completion and the completion method is chosen", 0 }, { "automatically depending on the context:", 0 }, { " - command names", 0 }, { " the word to be completed is the first word in", 0 }, { " a command; if no directory is specified, $PATH", 0 }, { " is searched", 0 }, { " - directory names", 0 }, { " used in the directory panel", 0 }, { " - user names", 0 }, { " for names beginning with ~", 0 }, { " (~username = user\'s home directory)", 0 }, { " - environment variables", 0 }, { " for names beginning with $", 0 }, { " - filenames", 0 }, { " this general type of completion is performed", 0 }, { " in all other cases", 0 }, { "", 0 }, { "When finer control over the name completion is required,", 0 }, { "use the completion/insertion panel ( ).", 0 }, { "==> completion/insertion panel","paste" }, { "", 0 }, { "Filename completion tries to recognize certain shell", 0 }, { "metacharacters and completes filenames also in these", 0 }, { "situations:", 0 }, { " name=/some/file - name must be a single word", 0 }, { " command \' and \'>>\'", 0 }, { " command ; other_command", 0 }, { " command & other_command", 0 }, { " command || other_command - also \'&&\'", 0 }, { " command | other_command", 0 }, { " `command`", 0 }, { "", 0 }, { "If there is no completion possibility, you will get", 0 }, { "a warning. If there is only one completion possibility,", 0 }, { "CLEX completes the name, otherwise a list of completion", 0 }, { "candidates appears on the screen. In case this list would", 0 }, { "be too long, only the next character will be suggested.", 0 }, { "", 0 }, { "--------------------", 0 }, { "Note:", 0 }, { " - if the special characters mentioned above (=><;&|`) are", 0 }, { " part of a filename or if quoting is used, the filename", 0 }, { " completion will be probably not able to complete names", 0 }, { " properly", 0 }, { "@P=paste"," - completion/insertion panel" }, { "", 0 }, { "This panel summarizes all editing functions from the file", 0 }, { "panel that complete text or insert text into the command", 0 }, { "line.", 0 }, { "", 0 }, { "Completion functions:", 0 }, { " - general name completion", 0 }, { " - name completion of specified type (5 functions)", 0 }, { " - command completion from the history list", 0 }, { "", 0 }, { "Insert functions:", 0 }, { " - insert filename(s) (3 functions)", 0 }, { " - insert the directory name (2 functions)", 0 }, { " - insert the symbolic link target", 0 }, { "@P=menu","alt-M - main function menu" }, { "", 0 }, { "This is a self-explaining menu of all important file panel", 0 }, { "functions. All you need to do is press alt-M to display it.", 0 }, { "", 0 }, { "The main menu is available only in the file panel. Most of", 0 }, { "its functions can be activated directly (without going into", 0 }, { "this menu) using shortcuts which are displayed in the menu", 0 }, { "for your convenience.", 0 }, { "", 0 }, { "The individual main menu functions are described here:", 0 }, { "==> file panel","file" }, { "", 0 }, { "--------------------", 0 }, { "Note:", 0 }, { " - on some PC keyboards the key activates the main", 0 }, { " menu as well (this key is located next to the right", 0 }, { " key)", 0 }, { "@P=sort","alt-S - changing sort order" }, { "", 0 }, { "Select one of file sort orders on the menu in the sort panel", 0 }, { "and press to confirm. The sort order affects only", 0 }, { "the way the filenames are displayed and is valid for both", 0 }, { "file panels. Each time you start CLEX, the sort order is set", 0 }, { "to \'sort by name\'.", 0 }, { "", 0 }, { "See also the GROUP_FILES configuration parameter. Files are", 0 }, { "first grouped and then the groups are sorted. See also the", 0 }, { "COLLATION parameter, there are two collate sequences for", 0 }, { "sorting by name.", 0 }, { "==> configuring CLEX","config_app" }, { "", 0 }, { "--------------------", 0 }, { "Notes:", 0 }, { " - the sort by extension (filename suffix) considers", 0 }, { " a file named \'.file\' to be a so called hidden file", 0 }, { " without an extension", 0 }, { " - the unusual \'sort by reversed name\' option is useful", 0 }, { " in sendmail queue directories, where files like", 0 }, { " \'qf1234\', \'df1234\', and \'xf1234\' belong together", 0 }, { "@P=user","alt-U / alt-G - user / group information" }, { "", 0 }, { "These twin panels show the list of user / group IDs with", 0 }, { "corresponding names that CLEX has saved during the last file", 0 }, { "panel read.", 0 }, { "", 0 }, { "The data can be only examined, not modified, that\'s why", 0 }, { "there are no functions defined in these panels. Filtering", 0 }, { "(ctrl-F) is available though.", 0 }, { "==> the panel filter","filter" }, { "@P=config","alt-C - configuring CLEX" }, { "", 0 }, { "There are over 30 parameters controlling the program\'s", 0 }, { "behavior.", 0 }, { "==> introduction","config_intro" }, { "", 0 }, { " FRAME CMD_LINES XTERM_TITLE GROUP_FILES PROMPT", 0 }, { " LAYOUT1 LAYOUT2 LAYOUT3 ACTIVE_LAYOUT KILOBYTE", 0 }, { " FMT_NUMBER FMT_TIME FMT_DATE COLLATION", 0 }, { " ==> configuring appearance","config_app" }, { "", 0 }, { " SHELLPROG CMD_F3 ... CMD_F12", 0 }, { " WARN_RM WARN_LONG WARN_SELECT", 0 }, { " ==> configuring command execution","config_cmd" }, { "", 0 }, { " DIR2 HELPFILE QUOTE", 0 }, { " C_PANEL_SIZE D_PANEL_SIZE H_PANEL_SIZE", 0 }, { " ==> other configuration parameters","config_other" }, { "@P=config_intro","configuration process" }, { "", 0 }, { "Eech user can customize his/her personal CLEX settings", 0 }, { "using the configuration panel. Program settings can be", 0 }, { "(and should be) saved to a configuration file and thus made", 0 }, { "permanent. Unsaved settings are lost when you exit CLEX.", 0 }, { "", 0 }, { "Choose one of the function in the top of the panel", 0 }, { "(Cancel, Accept, or Accept+Save) to finish the work", 0 }, { "in the configuration panel.", 0 }, { "", 0 }, { "Standard configuration values apply to all parameters which", 0 }, { "are not explicitly set by the user. These default values", 0 }, { "are built into the CLEX, but administrators can override", 0 }, { "them in the system-wide configuration file.", 0 }, { "==> configuring CLEX in admin mode","admin" }, { "", 0 }, { "Help with keys:", 0 }, { " ==> moving cursor bar","keys_scroll" }, { " edit parameter", 0 }, { " S set parameter to standard value (default)", 0 }, { " O set parameter to original value", 0 }, { "", 0 }, { "Files:", 0 }, { " - personal configuration file:", 0 }, { " .clexrc in user\'s home directory", 0 }, { " - system-wide configuration file:", 0 }, { " /etc/clexrc", 0 }, { " ==> please read this security advice","security" }, { "", 0 }, { "--------------------", 0 }, { "Note:", 0 }, { " - concurrent CLEX sessions: configuration saved in one", 0 }, { " session does not affect other running sessions, only", 0 }, { " newly started programs. Every time you save the", 0 }, { " configuration, the previous one gets overwritten.", 0 }, { "@P=config_app","list of configurable parameters (1)" }, { "", 0 }, { "The parameters below affect the program\'s visual", 0 }, { "appearance.", 0 }, { "", 0 }, { "Warning: do not change parameters you do not understand.", 0 }, { "If you are unsure, test the new value before saving the", 0 }, { "configuration. If any problems occur, reset the parameter", 0 }, { "to standard value.", 0 }, { "", 0 }, { "FRAME Choose a character for drawing horizontal", 0 }, { " lines on the screen. Try all settings and", 0 }, { " choose which one looks best on your screen.", 0 }, { " The option \'line graphics\' does not work", 0 }, { " on some terminals.", 0 }, { "", 0 }, { "CMD_LINES Number of lines (2-4) that the command line", 0 }, { " (or input line) occupies on the screen.", 0 }, { "", 0 }, { "XTERM_TITLE Change the title of the terminal window when", 0 }, { " CLEX is run in X Window environment. CLEX", 0 }, { " tries to restore the original title at exit.", 0 }, { "", 0 }, { " The title is:", 0 }, { " clex: user@host - ready", 0 }, { " clex: command - executing command", 0 }, { " clex: (command) - execution is finished", 0 }, { "", 0 }, { " You can set this parameter to \'yes\', \'no\',", 0 }, { " or AUTO. The AUTO setting checks the terminal", 0 }, { " type before changing the title.", 0 }, { " Here are the details:", 0 }, { " ==> changing xterm title","xterm" }, { "", 0 }, { "GROUP_FILES If enabled, CLEX will group files of the", 0 }, { " same type together. Files will be displayed", 0 }, { " in this order:", 0 }, { " - directories first (*1)", 0 }, { " - then special files", 0 }, { " - then plain files", 0 }, { " or alternatively:", 0 }, { " - directories (*1)", 0 }, { " - block devices (*2)", 0 }, { " - character devices (*2)", 0 }, { " - other special files", 0 }, { " - plain files", 0 }, { "", 0 }, { " Note 1: directories . and .. will be always", 0 }, { " on the top", 0 }, { " Note 2: despite the selected sort order,", 0 }, { " devices will be sorted by their", 0 }, { " major and minor numbers.", 0 }, { " ==> sort order for files","sort" }, { "", 0 }, { "PROMPT Command line prompt. Enter AUTO here to use", 0 }, { " the shell\'s name as the prompt.", 0 }, { " ==> related parameter: SHELLPROG","config_cmd" }, { "", 0 }, { "LAYOUT1 File panel layout. Format is:", 0 }, { " |", 0 }, { " where \'fields\' is a list of fields to be", 0 }, { " displayed.", 0 }, { " ==> configuring file panel layout","layout" }, { "", 0 }, { "LAYOUT2 Alternative file panel layout.", 0 }, { "LAYOUT3 Alternative file panel layout.", 0 }, { " ==> configuring file panel layout","layout" }, { "", 0 }, { "ACTIVE_LAYOUT Pick one of the available layouts (1-3).", 0 }, { "", 0 }, { "KILOBYTE Select your preferred definition of", 0 }, { " one kilobyte (megabyte, etc.) The filesize", 0 }, { " is displayed according to this parameter.", 0 }, { "", 0 }, { " 1000: the prefix kilo means thousand", 0 }, { " 1024: for computer professionals one kilobyte", 0 }, { " is traditionally 1024 bytes. This is now", 0 }, { " written as 1 KiB according to the IEC", 0 }, { " International Standard 60027-2.", 0 }, { "", 0 }, { "FMT_NUMBER Choose dot or comma as the thousands separator", 0 }, { " for displaying file sizes,", 0 }, { " standard is AUTO (autodetect).", 0 }, { "", 0 }, { "FMT_TIME Select 12 or 24 hour clock,", 0 }, { " standard is AUTO (autodetect).", 0 }, { "", 0 }, { "FMT_DATE This is the date format (combination of the", 0 }, { " day, month, and year). Standard is AUTO for", 0 }, { " autodetect, but setting it explicitly gives", 0 }, { " you more possibilities.", 0 }, { " ==> how to set date format","date" }, { "", 0 }, { "COLLATION There are two ways to sort filenames by name.", 0 }, { " Those two character collation sequences are:", 0 }, { " - byte order - based on the character encoding", 0 }, { " as used by the computer, typically the ASCII", 0 }, { " code", 0 }, { " - dictionary order - based on the human", 0 }, { " language as set by your locale, it takes", 0 }, { " in account case folding, accented", 0 }, { " characters, etc.", 0 }, { "", 0 }, { "--------------------", 0 }, { "Notes:", 0 }, { " - the autodetect feature for FMT_XXX values reads", 0 }, { " the current locale setting, the COLLATION also", 0 }, { " makes use of the locale (a locale is a set of", 0 }, { " language and cultural rules), that\'s why your", 0 }, { " locale should be properly set", 0 }, { " - if you have superuser privileges, the word ROOT is", 0 }, { " included with the prompt to remind you to be careful", 0 }, { "@P=date","setting the date format" }, { "", 0 }, { "Following letters are used to compose the date format,", 0 }, { "simply combine them together:", 0 }, { " day of month:", 0 }, { " d - two digits (01 to 31)", 0 }, { " D - like \'d\', but without the leading zero (1 to 31)", 0 }, { " month:", 0 }, { " m - two digits (01 to 12)", 0 }, { " M - three letter acronym (jan to dec)", 0 }, { " year:", 0 }, { " y - last two digits (00 to 99)", 0 }, { " Y - all four digits (e.g. 2004)", 0 }, { "", 0 }, { "Examples:", 0 }, { " DMy 1mar04", 0 }, { " d-M-Y 01-mar-2004", 0 }, { " d.m.y 31.12.03", 0 }, { " y/m/d 03/12/31", 0 }, { "", 0 }, { "--------------------", 0 }, { "Note:", 0 }, { " - the length of the resulting date string should not", 0 }, { " exceed 11 characters", 0 }, { "@P=config_cmd","list of configurable parameters (2)" }, { "", 0 }, { "These parameters control the execution of commands.", 0 }, { "", 0 }, { "Warning: do not change parameters you do not understand.", 0 }, { "If you are unsure, test the new value before saving the", 0 }, { "configuration. If any problems occur, reset the parameter", 0 }, { "to standard value.", 0 }, { "", 0 }, { "SHELLPROG All commands are executed by this program.", 0 }, { " Enter the complete command, i.e. the full", 0 }, { " pathname of the shell, all required options,", 0 }, { " and the word at the place of the", 0 }, { " actual command. Type the word ", 0 }, { " literally as shown here. For example:", 0 }, { " /bin/sh -c ", 0 }, { " which can be shortened to:", 0 }, { " /bin/sh", 0 }, { " because the standard option -c is", 0 }, { " appended automatically whenever the ", 0 }, { " is missing.", 0 }, { "", 0 }, { " Set this parameter to AUTO to use your login", 0 }, { " shell, this is the recommended setting.", 0 }, { "", 0 }, { "CMD_F3 = view file(s)", 0 }, { "CMD_F4 = edit file(s)", 0 }, { "CMD_F5 = copy file(s)", 0 }, { "CMD_F6 = move file(s)", 0 }, { "CMD_F7 = make directory", 0 }, { "CMD_F8 = remove file(s)", 0 }, { "CMD_F9 = print file(s)", 0 }, { "CMD_F10 = user defined", 0 }, { "CMD_F11 = user defined", 0 }, { "CMD_F12 = user defined", 0 }, { "", 0 }, { " All these parameters are templates used to", 0 }, { " build commands each time you press one of the", 0 }, { " function keys to . The following", 0 }, { " substitutions are performed before the", 0 }, { " specified text is inserted into the command", 0 }, { " line:", 0 }, { " $1 --> name of the current working directory", 0 }, { " $2 --> name of the secondary directory", 0 }, { " ==> working directories","2dirs" }, { " $F --> name of the current file", 0 }, { " $S --> name(s) of the selected file(s)", 0 }, { " ($f is preferred)", 0 }, { " $f --> like $S when was pressed before", 0 }, { " the last keystroke and there are some", 0 }, { " selected files; like $F otherwise", 0 }, { " $$ --> single $ character", 0 }, { " $c --> this parameter only sets the cursor", 0 }, { " position - no text is inserted, e.g:", 0 }, { " find / -type f -name \'$c\' -print", 0 }, { " Normal cursor position (without $c)", 0 }, { " is at the end of inserted command", 0 }, { "", 0 }, { " All inserted file and directory names are", 0 }, { " quoted properly.", 0 }, { " ==> automatic quoting","quoting" }, { "", 0 }, { "WARN_RM Warns before executing \'rm\' (delete) command.", 0 }, { " Note that CLEX does not detect all occurrences", 0 }, { " of \'rm\' command in the command line, it only", 0 }, { " checks the first word.", 0 }, { "", 0 }, { "WARN_LONG Warns if the command line is too long and you", 0 }, { " could not see the whole command on the screen", 0 }, { " before executing it. This warning is", 0 }, { " suppressed in the history panel.", 0 }, { "", 0 }, { "WARN_SELECT Reminds that you have selected some file(s).", 0 }, { " This warning should prevent mistakes when the", 0 }, { " current file is processed instead of selected", 0 }, { " file(s).", 0 }, { "", 0 }, { " All three warnings above are normally enabled. You", 0 }, { " might want to disable warnings that annoy you.", 0 }, { "@P=config_other","list of configurable parameters (3)" }, { "", 0 }, { "Warning: do not change parameters you do not understand.", 0 }, { "If you are unsure, test the new value before saving the", 0 }, { "configuration. If any problems occur, reset the parameter", 0 }, { "to standard value.", 0 }, { "", 0 }, { "DIR2 Initial working directory for the secondary", 0 }, { " file panel. Standard value is your home", 0 }, { " directory, leave DIR2 set to HOME to use the", 0 }, { " home directory. DIR2 should be an absolute", 0 }, { " directory name starting with /.", 0 }, { "", 0 }, { "HELPFILE The on-line help is compiled into CLEX, but", 0 }, { " you can replace it with an optional external", 0 }, { " help file. Most users enter NONE here and", 0 }, { " use the built-in help; only if you have a", 0 }, { " help file, enter its name here.", 0 }, { "", 0 }, { "QUOTE Some characters have a special meaning for", 0 }, { " the shell. If these special characters appear", 0 }, { " in a filename being inserted to the command", 0 }, { " line, they must be taken literally, without", 0 }, { " the special meaning. This is achieved by", 0 }, { " quoting them with a preceding backslash.", 0 }, { "", 0 }, { " These characters are always quoted:", 0 }, { " ( ) < > [ ] { } # $ & \\ | ? *", 0 }, { " ; \' \" ` ~ space tab", 0 }, { "", 0 }, { " Another two characters are added to the", 0 }, { " list if your shell is a C-shell:", 0 }, { " ! :", 0 }, { "", 0 }, { " The QUOTE parameter allows you to specify", 0 }, { " a list of additional characters that need", 0 }, { " to be quoted.", 0 }, { "", 0 }, { "C_PANEL_SIZE Size of the filename completion panel, i.e.", 0 }, { " its maximum number of lines. The special", 0 }, { " value AUTO limits the panel size to the", 0 }, { " actual screen size (no scrolling).", 0 }, { "", 0 }, { "D_PANEL_SIZE Size of the directory panel. The value AUTO", 0 }, { " limits the panel size to the actual screen", 0 }, { " size.", 0 }, { "", 0 }, { "H_PANEL_SIZE Size of the command history panel.", 0 }, { "", 0 }, { "--------------------", 0 }, { "Notes:", 0 }, { " - if you would like to translate the on-line help into", 0 }, { " your language and wish to obtain more information about", 0 }, { " the help file format, don\'t hesitate to contact us", 0 }, { " ==> contacts","about" }, { " - screen size AUTO for X_PANEL_SIZE parameters leaves", 0 }, { " the bottom panel line blank to indicate that there is", 0 }, { " no need to scroll", 0 }, { " - changing H_PANEL_SIZE clears the contents of the", 0 }, { " command history list", 0 }, { " - your shell is considered to be a C-shell when its name", 0 }, { " ends with \'csh\'", 0 }, { "@P=layout","configuring file panel layout" }, { "", 0 }, { "The file panel layout can be configured to match", 0 }, { "individual customs and needs. The LAYOUT parameter", 0 }, { "is a string of the form:", 0 }, { " |", 0 }, { "where is a list of fields to be displayed,", 0 }, { "each field is represented by a dollar sign followed", 0 }, { "by a single character:", 0 }, { " $a - time/date of last access", 0 }, { " $d - time/date of last modification", 0 }, { " $i - time/date of last inode change", 0 }, { " $l - number of hard links", 0 }, { " $L - \'LNK\' mark is displayed if there are multiple hard", 0 }, { " links, otherwise this field is blank", 0 }, { " $m - file mode as an octal number", 0 }, { " $M - like $m, but blank for normal file modes (i.e.", 0 }, { " mode 0666 or 0777 with umask value bits cleared)", 0 }, { " $o - owner - user:group", 0 }, { " $p - file mode as a string of permission bits", 0 }, { " $P - like $p, but blank for normal file modes", 0 }, { " $s - file size", 0 }, { " $S - like $s, but blank for directories", 0 }, { " $t - type of file", 0 }, { " $> - \'->\' is displayed for symbolic links", 0 }, { " $* - selection mark", 0 }, { " $$ - literal dollar sign \'$\'", 0 }, { " $| - literal vertical bar \'|\'", 0 }, { "", 0 }, { "Normal text can be inserted into the list of fields as well,", 0 }, { "e.g.:", 0 }, { " links:$l mode:$m", 0 }, { " $m($p)", 0 }, { "", 0 }, { "There are three predefined layouts in the standard", 0 }, { "configuration. LAYOUT1 is detailed, LAYOUT2 is brief,", 0 }, { "and the LAYOUT3 is similar to the \'ls -l\' output:", 0 }, { " LAYOUT1 $d $S $>$t $M $*| $p $o $L", 0 }, { " LAYOUT2 $d $S $t $*| $p $o", 0 }, { " LAYOUT3", 0 }, { " $p $o $s $d $>$t $*| mode=$m atime=$a ctime=$i links=$l", 0 }, { "", 0 }, { "All three LAYOUTs can be altered and one of them is", 0 }, { "selected with the ACTIVE_LAYOUT configuration parameter", 0 }, { "to act as the file panel layout.", 0 }, { "", 0 }, { "The filename is always displayed after all defined file", 0 }, { "panel fields.", 0 }, { "", 0 }, { "--------------------", 0 }, { "Notes:", 0 }, { " - numbers and dates are automatically aligned to the", 0 }, { " proper field margin, e.g.:", 0 }, { " $d $s - aligned to the right", 0 }, { " mtime=$d size=$s - aligned to the left", 0 }, { " - time of the day instead of date is displayed for times", 0 }, { " within the last 18 hours", 0 }, { " - you can omit the selection mark $* if you accept the", 0 }, { " highlighting as a sufficient indicator", 0 }, { " - $L field is left blank also for all directories as they", 0 }, { " always have multiple hard links", 0 }, { "@P=xterm","changing xterm title" }, { "", 0 }, { "When XTERM_TITLE is set to AUTO, the title change feature", 0 }, { "gets enabled only if $TERM is xterm, kterm, or dtterm,", 0 }, { "possibly including additional characters, e.g. xterm-mono.", 0 }, { "", 0 }, { "Following command is run to get the current window title:", 0 }, { " xprop -id $WINDOWID WM_NAME", 0 }, { "You can try it from the command line. If that command fails,", 0 }, { "CLEX is not able to restore the original X window title at", 0 }, { "exit and uses a general title \'terminal\'.", 0 }, { "@P=security","security note" }, { "", 0 }, { "Protect your configuration files! They contain templates", 0 }, { "for the commands you execute. Do not allow others to", 0 }, { "modify them:", 0 }, { "- only the system administrator(s) should have the write", 0 }, { " access to the system-wide configuration file, everybody", 0 }, { " else should have just the permission to read", 0 }, { "- only the owner should have the write access to his/her", 0 }, { " personal configuration file", 0 }, { "", 0 }, { "To reduce the risk, CLEX ignores world-writable", 0 }, { "configuration files.", 0 }, { "@P=admin","admin mode (for system administrators only)" }, { "", 0 }, { "The configuration process at the program startup has", 0 }, { "three steps:", 0 }, { " 1) parameters are initialized to values", 0 }, { " compiled into CLEX", 0 }, { " 2) system-wide configuration file is processed", 0 }, { " 3) user\'s personal configuration file is processed", 0 }, { "", 0 }, { "In the admin mode the system administrator can alter the", 0 }, { "system-wide configuration. To enter the admin mode start", 0 }, { "the program with -a (or --admin) option:", 0 }, { " clex -a", 0 }, { "The configuration panel with the system-wide defaults", 0 }, { "for all parameters appears on the screen. Modify them", 0 }, { "as necessary and then save the configuration.", 0 }, { "", 0 }, { "You will need the permission to create/modify the", 0 }, { "system-wide configuration file.", 0 }, { "==> protecting configuration files","security" }, { "", 0 }, { "WARNING: System-wide defaults affect all CLEX users.", 0 }, { "", 0 }, { "It is recommended to check at least:", 0 }, { " CMD_F3 - you might prefer \'less\' instead of \'more\'", 0 }, { " CMD_F8 - you might prefer \'rm -i\' (and disable WARN_RM)", 0 }, { " CMD_F9 - check the command for printing", 0 }, { "If your file utilities understand the end-of-options sign", 0 }, { "\'--\', you could use it in your CMD_FX command templates.", 0 }, { "@P=select","alt-+ and alt-- - selecting and deselecting files" }, { "", 0 }, { "To specify files to be (de)selected, enter at the", 0 }, { "appropriate prompt a filename pattern. Follow the usual", 0 }, { "conventions for specifying filenames used in the shell.", 0 }, { "", 0 }, { "Wildcards: ? * [list] [!list] or [^list]", 0 }, { "Quoting: \\c \'string\' \"string\"", 0 }, { "==> pattern matching details","patterns" }, { "", 0 }, { "The current directory . (dot) and the parent directory", 0 }, { ".. (dot-dot) cannot be selected. This is a protective", 0 }, { "measure.", 0 }, { "@P=patterns","pattern matching" }, { "", 0 }, { "Patterns are used to specify filenames. This concept is used", 0 }, { "in the command line shells like sh, bash, csh; see the", 0 }, { "appropriate documentation if you want to learn more.", 0 }, { "", 0 }, { "CLEX recognizes following special symbols:", 0 }, { "", 0 }, { "Wildcards:", 0 }, { " ? matches any single character", 0 }, { " * matches any string (zero or more characters)", 0 }, { " [list] matches one of the characters appearing in", 0 }, { " the list, ranges like 0-9 a-z are allowed", 0 }, { " [!list] matches one of the characters NOT appearing", 0 }, { " or [^list] in the list", 0 }, { "", 0 }, { "Exception: wildcards don\'t match a dot on the first position", 0 }, { "of a filename (to conceal so called hidden filenames).", 0 }, { "", 0 }, { "Quoting:", 0 }, { " \\c a character preceded by a backslash loses", 0 }, { " its special meaning", 0 }, { " \'string\' everything enclosed in single quotes is", 0 }, { " taken literally, even the backslash", 0 }, { " \"string\" backslash quotes the characters \\, $, and \",", 0 }, { " everything else in double quotes is taken", 0 }, { " literally", 0 }, { "", 0 }, { "--------------------", 0 }, { "Notes:", 0 }, { " - unlike the shell, escape sequences are not recognized,", 0 }, { " e.g. \\t does not stand for the tab character.", 0 }, { " - handling of character ranges is affected by the locale", 0 }, { " setting.", 0 }, { "@P=about","about CLEX" }, { "", 0 }, { "CLEX (pronounced KLEKS) is free software without warranty", 0 }, { "of any kind. See the GNU General Public License for details.", 0 }, { "==> Software license","license" }, { "", 0 }, { "The newest version of CLEX, related materials, etc. can be", 0 }, { "found on the CLEX web page. The URL is: http://www.clex.sk", 0 }, { "", 0 }, { "Please send your questions, comments, or bug reports to the", 0 }, { "e-mail address: clex@clex.sk", 0 }, { "", 0 }, { "Many thanks to all the people who have taken the time to", 0 }, { "submit suggestions for enhancements or problem reports.", 0 }, { "", 0 }, { "CLEX File Manager", 0 }, { "Copyright (C) 2001-2006 Vlado Potisk ", 0 }, { "@P=license","Software license agreement" }, { "", 0 }, { "Authors have developed the CLEX File Manager and made it", 0 }, { "available by means of electronic distribution at the", 0 }, { "Internet web page http://www.clex.sk.", 0 }, { "", 0 }, { "This program is free software; you can redistribute it", 0 }, { "and/or modify it under the terms of the GNU General Public", 0 }, { "License as published by the Free Software Foundation;", 0 }, { "either version 2 of the License, or (at your option) any", 0 }, { "later version.", 0 }, { "", 0 }, { "This program is distributed in the hope that it will be", 0 }, { "useful, but WITHOUT ANY WARRANTY; without even the implied", 0 }, { "warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR", 0 }, { "PURPOSE. See the GNU General Public License for more", 0 }, { "details.", 0 }, { "", 0 }, { "You should have received a copy of the GNU General Public", 0 }, { "License along with this program; if not, write to the Free", 0 }, { "Software Foundation, Inc., 51 Franklin Street, Fifth Floor,", 0 }, { "Boston, MA 02110, USA", 0 }, { "@P=notes","Miscellaneous notes" }, { "", 0 }, { "GENERAL USAGE", 0 }, { " - CLEX does not support UTF-8 character encoding", 0 }, { "", 0 }, { " - special attention should be paid when dealing with", 0 }, { " filenames beginning with a hyphen. For example the", 0 }, { " correct way to delete a file named \'-i\' is:", 0 }, { " rm ./-i", 0 }, { " or (on some systems)", 0 }, { " rm -- -i", 0 }, { " You can redefine commands F3 - F9 to include this", 0 }, { " end-of-options sign --", 0 }, { "", 0 }, { " - if the screen appears distorted and redraw (ctrl-L)", 0 }, { " does not solve the problem, run this command:", 0 }, { " tput reset", 0 }, { "", 0 }, { " - there is no way to change CLEX\'s environment variables,", 0 }, { " you must set them before starting CLEX", 0 }, { "", 0 }, { "X WINDOW SYSTEM", 0 }, { " - if you cannot see the output of executed commands on", 0 }, { " some X terminal emulators try to disable scrolling", 0 }, { "", 0 }, { " - to see highlighted text in color on your xterm, put", 0 }, { " these lines to your .Xresources file:", 0 }, { " XTerm*colorBD: blue3 <-- pick your own color", 0 }, { " XTerm*colorBDMode: true", 0 }, { " don\'t forget to run", 0 }, { " xrdb -merge .Xresources", 0 }, { " after a change", 0 }, { "", 0 }, { " - there were problems with the HOME and END keys in the", 0 }, { " original Fedora Core 4 xterm, but an updated xterm", 0 }, { " package was released", 0 }, { "", 0 }, { " - in some older versions of KDE you have to run xrdb", 0 }, { " every time you want to start xterm. Upgrade to more", 0 }, { " recent version or use this simple CLEX startup script", 0 }, { " as a workaround:", 0 }, { "", 0 }, { " #!/bin/sh", 0 }, { " XRES=$HOME/.Xresources", 0 }, { " [ -f $XRES ] && /usr/X11R6/bin/xrdb -merge $XRES", 0 }, { " exec /usr/X11R6/bin/xterm \\", 0 }, { " -geometry 80x32 -e /usr/bin/clex", 0 }, { "", 0 }, { " - if the input line gets cluttered after using the", 0 }, { " backspace key in KDE terminal emulator konsole,", 0 }, { " you have to upgrade to more recent KDE version", 0 },