Fcmd-help

Fcmd-help

Inhalt


Topic:.FcmdHelp.

pStyle=std tableStyle=stdTable

See also Fcmd_motivation_de.html.


1 usage

Topic:.FcmdHelp.usage.

pStyle=std tableStyle=stdTable

Context sensitive help: Some tables, edit fields or buttons are associated with a context sensitive help. Open the help window, leave it open, then select any table, select an edit or output field or press a button (and move the mouse back to prevent an action) - the context sensitive help will be shown.


2 Window layout

Topic:.FcmdHelp.layout.

pStyle=std tableStyle=stdTable

Three file panels: The.file.Commander presents files in three panels. The classic Norton Commander has only two panels. Use the middle and right panel to select a source and desination for copy or a first and second folder for comparison etc. The left panel can be used e.g. to select a documentation in the file system while working. You have this third panel additionally. The left panel contains a command card, see 9 Command card. A selected command in the left panel can be combined with the selected files in the other panels to execute somewhat, for example a file comparison.

Tabs for favors and files: One of the capability of the.File.commander is to handle with some directories in your file system, see 7 Concept of favorite paths. You have a system of favor themes. That are able to select in the left Tab of the file tabs, and then the left tab below. You may have 10..20 or more favor themes, it is the length of that list. Any favor theme can have some favor directory path, maybe 10 or more. For example if you work with documents, that are the directories where documents, pictures etc. are stored. That favor paths can be selected in the tabs in the lower tabbed panel. If you select a favor theme in press [Enter] the associated favor path card is opened or selected. The file cards are disposed in the upper tabbed panel. If you select a file card, the favor cards are hide. But you can switch from any file card to its favor path select list by typing [ctrl-down]. If you switch to another directory in the file card, it is saved of course, meanwhile you work in another file card. But you can go back to the start directory by simple pressing of [ctrl-<]. All the key operation you find in the menu bar too or you can use the context menu (right mouse button). You can close a tab by typing


Bild: Layout

Output/edit area: The middle area of the window is a output area. It can be zoomed by pressing [ctrl-O] like switching to the output window in the classic Norton Commander. The output area's content can be used as write area, to select any content ([ctrl-a] is select all), to copy to the systems clipboard etc.. It is possible to write commands in that area, see 10 Command invocation in the output area.

Status line: In the bottom area there are shown information about the selected file. Especially the full path is shown. You can switch between backslash and slash presentation (for windows users) and copy the file path or parts of them in the system's clipboard to use it as input for other applications. drag'n drop: You can mark somewhat in the path field and drag it to any other application. Then the file is dragged if the drop receiver can deal with the file.

Function buttons: In the bottom are you can see all function buttons, like the classic Norton Commander. There are shown all combinations with [ctrl]-, [alt]- and [sh]-key. Because you may know the meaning of the buttons you can hide this information. Type [ctrl-F1] to hide and show. All function buttons can be invoked with the mouse in that window part or with the real keys on keyboard. You can find all functions in the standard menu too!


3 Configurability

Topic:.FcmdHelp.config.

pStyle=std tableStyle=stdTable

The.file.commander can be configured.


3.1 Path and properties of current file

Topic:.FcmdHelp.config.pathCurr.

pStyle=std tableStyle=stdTable

The bottom are of the main window contains two status lines:

You can copy some information in the clipboard of the system. See 11 Drag'n drop and copy paths.

The timestamp of the file is also shown as milliseconds after 1970.

The path is able to show slash or backslash. Especially in Windows the backslash may be necessary. Use right-click context menu on that field. (todo)


4 Key commands

Topic:.FcmdHelp.keys.

pStyle=std tableStyle=stdTable

Further versions may have the capability to adapt key usage individually. The standard key usage are oriented to a simple and usual system. Some keys are adequate the classic norton commander.


4.1 General navigation keys between cards and panels

Topic:.FcmdHelp.keys.naviCards.

pStyle=std tableStyle=stdTable

[alt-F1]], [alt-F2] and [alt-F3] selects the left, middle or right favor theme card. It is like [alt-F1] and [alt-F2] for drive selection in the classic Norton commander. The drive selection is not the important one yet. The selection of favor themes is it.

[sh-alt-F1]], [sh-alt-F2] and [sh-alt-F3] or [sh-F1]], [sh-F2] and [sh-F3] focuses the left, middle or right panel.

With [(sh)-alt-arrows] you can walk through all cards of one panel:

[sh-alt-left] and [sh-alt-rigth] focuses the cards to the left and right in the same panel.

[(sh)alt-up] and [(sh)-alt-down] focuses the file card or the associate theme card.

[ctrl-tab] switches between the last 2 panels. The classic norton commander has used the [tab] key only for that. But [ctrl-tab] is usual today to switch between the windows or panels of an application, whereby the [tab] is the traversal key between widgets.


4.2 Navigation keys from a file card

Topic:.FcmdHelp.keys.fileCard.

pStyle=std tableStyle=stdTable

[alt-down] shows the favor paths of this file card or file tab.

[ctrl-pgUp] navigates to the parent directory.

[ctrl-alt-left] and [ctrl-alt-right] shows the left and right file card and the first left card, it is the favor selection.

[shift-alt-left] and [shift-alt-right] selects the left or right panel.

[alt-F9] shows the command card.


4.3 Keys which deals with the selected file or dir

Topic:.FcmdHelp.keys.fileKeys.

pStyle=std tableStyle=stdTable

[Enter] on a file: The extension will be tested. One or some commands are offered to execute with that file. Select it and type enter to execute a command with the file. The commands for any extension are contained in the file cfg/ext.cfg in The.file.Commander's configuration folder. You can build any combination of command line invocations with the selected file, with files in the other panel or maybe with the directory only.

[ctrl-F9] on a file: The last selected command in the 9 Command card will be executed with the selected file and maybe with the file in the other panel. It depends on the command which will be done. If the command doesn't use a file as input, the command will be executed also.

[F2]: Edit properties of the file. Opens a dialog window.

[F3]: View the file with the internal viewer, maybe with hexa presentation.

[F4]: Edit the file. The editor is configured with the file cfg/cmdi.cfg in The.file.Commander's configuration folder.

[F6]: Copy or move the the file. Opens a confirm window. Note that [F5] is refresh.

[F8]: Delete the file. Opens a confirm window.


4.4 Keys for the whole file card, the folder

Topic:.FcmdHelp.keys.folderKeys.

pStyle=std tableStyle=stdTable

[ctrl-<]: Select the origin directory of the favorite, back to its root.

[F5] or [ctrl-R]: Refresh the file card view. The classic Norton commander uses [F5] for copy. But the usage of [F5] for refresh is usual in most other modern applications. Use [F6] for copy and move both.

[F7]: Create a directory or an empty file in the current folder. It is the F7-Key for 'mkdir' from the classic Norton commander.


5 copy

Topic:.FcmdHelp.copy.

pStyle=std tableStyle=stdTable

The copy dialog box helps to copy files and directory trees.


5.1 The source root path

Topic:.FcmdHelp.copy.pathSrc.

pStyle=std tableStyle=stdTable

The source root path contains either one file or one directory of more as one of them. If one file is selected, only this file is select as source. If one directory is selected (last sign is '/'), then some or all files in this directory may be selected.

More files or directories can be given in the same parent directory. In this case the parent directory is given and the files are given separated with a colon. All of them are source files or source directories.

The/parent/path/ : file1 : file2 : file3

That situation occurs if some files are selected in a file panel while open the confirm window or while press <set source>.


5.2 Set the source root path

Topic:.FcmdHelp.copy.setSrc.

pStyle=std tableStyle=stdTable

If the confirm copy/move/del/compare-Window is opened the first time, opened after finit a process or if the <set source> button is pressed in the opened confirm window in that states, the currently selected file(s) of the first current file panel of the.File.commander are taken as source directory/ies.


5.3 The conditions for selection

Topic:.FcmdHelp.copy.selcond.

pStyle=std tableStyle=stdTable

If the input field for select conditions is left empty, all files in the source root path will be selected. In this case the move and delete takes the files and directories of the source root path without any more selection and moves or deletes that. The copy and compare need a check phase to select and count all files.

The input field can contains one wildcard expression or more as one separated by a colon ':' maybe with spaces before and behind (for better reading). The wildcard expression is used to select files in the source root directory(ies).


5.4 The [check] button

Topic:.FcmdHelp.copy.check.

pStyle=std tableStyle=stdTable

If you press the check button, the files in the source root path are selected regarding the conditions for selection. This may need some seconds if the directory tree is deep and/or it is a remote or network directory. The progress is shown than. While this process runs, the [set source] button is shown grayed.

The result of the selection is able to check in the file panels of the.File.commander. Additionally the selection can be changed in the file panel using the right-mouse-menu or select keys there.

The selection can be enhanced or reduced by given some other selection conditions and pressing check again. The selection state before that is left unchanged but the new selection will be set (or cleared) for the matching files. That process counts all files and bytes, the selected in the past and the selected yet, so the result of bytes and files are correct.

If you write ? in the selection condition field and press check, the selected files up to now are counted and shown again in the state field.


5.5 Set the destination directory

Topic:.FcmdHelp.copy.setDst.

pStyle=std tableStyle=stdTable

If the confirm copy/move/del/compare-Window is opened the first time or opened after finit a process then the directory of the currently selected second file panel of the.File.commander is set as destination directory. If the <set destination> button is pressed in the opened confirm window then the directory of the first current file panel is taken as destination directory.


5.6 The destination directory

Topic:.FcmdHelp.copy..

pStyle=std tableStyle=stdTable

You can choose the destination directory


5.7 Show the source, destination and current file in a file panel

Topic:.FcmdHelp.copy.show.

pStyle=std tableStyle=stdTable

The little buttons [=>] right hand on the path lines selects the directory in the current file panel of the.File.Commander. You can use this function to go back to the source or destination root directory after you had walked through the files especially in some sub directories or check any other in the panel. for the current file displayed you can go to this file to check some details about it.


5.8 The state field

Topic:.FcmdHelp.copy.state.

pStyle=std tableStyle=stdTable

The state


5.9 The current file

Topic:.FcmdHelp.copy.currfile.

pStyle=std tableStyle=stdTable

This field shows either the current file or directory path which is processed in the moment or the last found file path after check. If any process is running, the content of this field is refreshed in a cycle about 300 ms. It is volatile. But if the process is waiting for example for any question or because a pause is pressed, you can read, copy to clipboard or press the [=>] button to show the file.


5.10 Controlling the copy process

Topic:.FcmdHelp.copy.ctrl.

pStyle=std tableStyle=stdTable

A copy process creates new files in the destination directory. It may overwrite existing files or not, it may overwrite read only files or not, it may create new files or not. Three choice-keys controls that.

The buttons show the current state left side and the other possible states right of them after a question mark. Pressing the a button changes the state and shows that. The state is used if the copy process runs. The state can be changed while the copy process is in a quest. The new state is valid for the next following files.


5.10.1 Choice overwrite read only files

Topic:.FcmdHelp.copy.ctrl.overwrRo.

pStyle=std tableStyle=stdTable

The button shows the current state left side and the other possible states right of them after a question mark. Pressing the button changes the state.


5.10.2 Choice overwrite read existing files

Topic:.FcmdHelp.copy.ctrl.overwrExists.

pStyle=std tableStyle=stdTable


5.10.3 Choice creating files

Topic:.FcmdHelp.copy.ctrl.createNew.

pStyle=std tableStyle=stdTable

T


5.11 Questions while copy

Topic:.FcmdHelp.copy.quest.

pStyle=std tableStyle=stdTable

x


5.11.1 Overwrite

Topic:.FcmdHelp.copy.quest.wr.

pStyle=std tableStyle=stdTable

T


5.11.2 Skip file

Topic:.FcmdHelp.copy.quest.skipFile.

pStyle=std tableStyle=stdTable

T


5.11.3 Skip dir

Topic:.FcmdHelp.copy.quest.skipDir.

pStyle=std tableStyle=stdTable

T


5.12 Abort the process

Topic:.FcmdHelp.copy.escape.

pStyle=std tableStyle=stdTable

T


5.13 Choice function and execute

Topic:.FcmdHelp.copy.ok.

pStyle=std tableStyle=stdTable

There are four keys to select the function which is done:

[compare ?] Comparison of the files in source (selected) and destination (same files in destination path).

[delete ?] Deletion of the selected files in the source root path or the whole source root path(s)

[move ?Copy] Move or copy from source to destination of the selected files.

The keys can be pressed to switch between the choosen function. The [ok]-Button right button shows the resulting function:


6 mkdir / mkfile

Topic:.FcmdHelp.mkdirfile.

pStyle=std tableStyle=stdTable

This dialog box helps to create an empty file or a sub-directory in the current directory. It is the 'F7-Key' functionality of the classic Norton Commander. The classic 'F7-key' only helps to create a sub-directory, but empty files are often needed too, to be filled with scripts, config data etc.

The ...TODO


7 Concept of favorite paths

Topic:.FcmdHelp.favorpath.

pStyle=std tableStyle=stdTable

occasion: You may work with several source files, scripts, result files etc. in more as one subject matter or you have to attend some files in several directories. Then you have to switch between that several positions maybe in a large and complex directory tree. Favorite paths help to switch.

second stage selection: The favor selection have two stages:

If a favor path is selected, which is already in use, the last selected directory will be shown. To switch back to the favor directory, use the [ctrl-<] key combination or use the menu entry "file-navi" - "favor-home".

All favorite paths and their main favors with the tabs are contained in one file in the cfg-folder of The.file.Commander in the "favorpath.cfg" file.


7.1 Favor tab selection

Topic:.FcmdHelp.favorpath.tabSelect.

pStyle=std tableStyle=stdTable

The table for favor tabs contains the name of main favors and the label of the associated tab in each line. Selecting one line of this table opens the favor path selection in the associated tab. If the tab was created already, the last used favor is selected per default.


7.2 Favor path selection

Topic:.FcmdHelp.favorpath.favorSelect.

pStyle=std tableStyle=stdTable

The table for favor paths contains the alias name of a path and the home path of this alias in each line. Selecting one line of this table opens the file view of this alias. If the file view was created already, the last used path is selected, elsewhere the home path.

You can switch from any file view to this path select table by typing [alt-down]. You can switch between several working directories of this tab. If you switch to another directory, and then back to a last one, the last selected file is selected per derault anytime.


7.3 Create a favorite path

Topic:.FcmdHelp.favorpath.favorNew.

pStyle=std tableStyle=stdTable

You can select any directory in a file panel. Pressing [ctrl-B] or menu "faVors - new" opens a confirm window.


7.3.1 Tab label of favor

Topic:.FcmdHelp.favorpath.favorNew.tab.

pStyle=std tableStyle=stdTable

Write the label for the tab in text field 'label'. Per default the same label is set from the starting favor, you can change it and write either a label of an existing favor tab or a new one.


7.3.2 persist

Topic:.FcmdHelp.favorpath.favorNew.persist.

pStyle=std tableStyle=stdTable

You can write 'lmr' (one of or more) to force showing the label on startup of The.file.Commander. (TODO test it).


7.3.3 alias of favor

Topic:.FcmdHelp.favorpath.favorNew.alias.

pStyle=std tableStyle=stdTable

The alias is the string which is shown in the favor select card. Write any proper designation.


7.3.4 the directory path

Topic:.FcmdHelp.favorpath.favorNew.dir.

pStyle=std tableStyle=stdTable

The actual directory path is presetted. Check it. Commonly it is what you want. You can write any other path there. Therewith you can create a new favor without selecting the path, instead e.g. take the path from clipboard.


7.3.5 button temp

Topic:.FcmdHelp.favorpath.favorNew.temp.

pStyle=std tableStyle=stdTable

Pressing this button the favor path is stored only for the current session, it would not be stored in the favor path file.


7.3.6 button Save

Topic:.FcmdHelp.favorpath.favorNew.save.

pStyle=std tableStyle=stdTable

Pressing this button the favor path is stored in the favor path file.


7.3.7 Editing the favor path manually

Topic:.FcmdHelp.favorpath.favorNew..

pStyle=std tableStyle=stdTable

All favor paths can be edit manually, for example to remove some paths, to correct it, to correct tab and alias names, to duplicate the same paths for different tab labels.

The favor path file is stored in The.file.Commander's config directory with name path.cfg. You can edit this file with an standard text editor. Be vigilant about the syntax. It should be self-explaining by the given entries:

==tab: alias in favor tab card==
alias in favor card, path
other alias in favor card, other/path

8 file table view

Topic:.FcmdHelp.fileSelect.

pStyle=std tableStyle=stdTable

You can select any file in the current file table. If you are switching to another favor path, the last selected file will be selected by default anytime. So you can mark these files, which are the point of interest in any path.

You can select a directory, then type [Enter] or double click the left mouse button. Then the the directory content will be shown. If you have visited that directory in the past, the last selected file or directory is selected by default again. So you can navigate to the same files or directories which were the last points of interest. The.file.Commander stores all paths and the selected files in an internal tree anytime if a directory view was left.

For key commands see 4.2 Navigation keys from a file card


9 Command card

Topic:.FcmdHelp.cmdCard.

pStyle=std tableStyle=stdTable

The command card contains some commands to execute.


10 Command invocation in the output area

Topic:.FcmdHelp.CmdWrite.

pStyle=std tableStyle=stdTable

You can write in the output area. Write

>anyCommand with arguments

with a '>' on the start of any line, then press [ctrl-Enter]] with the cursor after the last argument. The this command is executed then inside The.file.Commander and sends its output to this output area. The current directory is that of the last selected file.

You can navigate in the output area to the command back and repeat this command. It need not be written in the last line.

>&anyCommand with Arguments [ctrl-Enter]

invokes the command in a shell of the operation system. There you can give some input etc.


11 Drag'n drop and copy paths

Topic:.FcmdHelp.dud_FilePath.

pStyle=std tableStyle=stdTable

You can use The.file.Commander to search and select files. If another application needs a file, for example in a file-open dialog, you can copy the path of the selected files from The.file.Commander: Select that part of path you need in the file-path text field and press [ctrl-C] or [ctrl-ins] or press the right mouse and use the context menu. The.file.Commander will copy the textual content in the clipboard of your system.

You can use the drag and drop technique too. If you mark any part of the file path in the file path text field and then drag it to your application, which is able to receive a draged file, not the textual part, by pressing left mouse button you drag the file.

Later revisions of The.file.Commander may support dragging of files from the file table too.


12 Compare directory trees

Topic:.FcmdHelp.folderCmp.

pStyle=std tableStyle=stdTable

Select 2 directories in 2 panels (middle, left), then select "folDer - comPare folder tree" in the menu or press right mouse in the directory output field of a file card - opens the compare window.

Button get dir gets the directories in the compare path fields and resets an older comparison.

Button compare executes the comparison. TODO: yet it executes in the graphic thread, if the tree is big, it may be work after some seconds. It should be worked in an extra thread (same as copy...)

Press refresh

Signification of compared files:

Button sync: The 2 file cards which were compared works synchron: Selecting one file, entry in a directorie selects it and entries in the other card automaticly.

You can use the sync mode to proper see differences in trees. Switch it on or off.

File difference view: Use any difference viewer of your system: Select both files, then type "Navigation - cmd" and select your diff viewer. It should be prepared already.