> WebRSH: Help: File Manager:
The file manager (FM) is in many senses the heart of WebRSH. Most file related operations, including those accessible through the 'GET' and 'UPLOAD' Main Menu items, are accessible also through FM. Most operations should be straight forward. They usually require selecting a file or a directory, and then clicking the appropriate button for the desired action.

FM's primary interface includes the following elements:

  1. The name of the current working directory along with a link to the parent directory. The link is provided by the Up image to the left of the working directory's name.

  2. The file selection window. Directories are listed first and are distinguished from files by having a backward slash ("\") preceding their names. Each of the lists (directories and files) is internally arranged in normal string order (namely, alphabetically, but with capital characters preceding all non-capital characters). The two lists are separated by a horizontal line which serves a double purpose: The size of the file selection window can be set in the "General Preferences" options setting form.

  3. A set of buttons to perform various file manager operations. The 'Open/Get', 'Cut', 'Copy', 'Paste', 'Delete', 'Rename', and 'New' buttons perform similarly to what the corresponding operations would do in other file managers (see some specific remarks below). Note, in particular, that 'Open/Get' "opens" directories and "gets" files. The 'Properties' button provides the output of the system's native file listing utility ('dir' on Win32 and 'ls -al' on UNIX) for the corresponding object. On Win32 platforms this output is trailed by a small form that shows (and can be used to change) file attributes. All of the above mentioned buttons are relevant to both files and directories. The 'Edit' button opens the selected file (or a blank file, if the file selection is null) in WebRSH's text editor. This button can't be used for directories. The 'Get as TEXT', and 'Get as BIN' buttons are used for file retrieval (along with 'Open/Get'), namely, they would send the selected file to the client (and other than 'Open/Get' they can't be used for directories). These three options provide the same functionality that the corresponding 'rshgettxt', 'rshgetbin', and 'rshget' commands provide from the Command Line. They differ from each other by the MIME type reported to the client and by the capability of 'Get as TEXT' to optionally convert the file to a non-native text file (this is determined by the appropriate option in the "General Preferences" options setting form). The same file retrieval options can also be provided as "downloadable links" from the 'GET' Main Menu item.

The following further remarks are worth noting:

  1. The 'Delete' function is very forceful. It would prompt the user once for confirmation, after which it will do its best to delete the appropriate file or directory. Read-Only attributes on Win32 platforms are ignored. The only thing that might (and should) cause file deletion to fail is insufficient permissions (this is only relevant to operating systems and disk partitions that support such access restrictions). File deletion is FINAL: files are NOT moved to any kind of a trash folder or recycle bin.

  2. The 'Cut'/'Paste', 'Copy', 'Rename', and 'New' functions are more delicately behaved in the following sense:

  3. The 'Cut', 'Copy', and 'Paste' commands, use a special clipboard implementation. This WebRSH clipboard is disjoint from any other clipboard that the system might have and can only be used to store file/directory names along with the appropriate command option (either 'Cut' or 'Copy'). While most WebRSH properties (e.g., the working directory) are stored as form fields, and thus depend only on the form from which a command is being issued; WebRSH clipboard information is stored on the disk of the host computer (specifically, in the inidat.txt file in the 'Configuration Directory'), and is thus shared among different WebRSH forms. This is done to enable cut/paste operations between different browser windows.

    As soon as the clipboard is not empty (following a 'Cut' or 'Copy' operation), a small form is being appended to FM forms. It shows the clipboard content, and provides an option to empty the clipboard ('Cancel') and an option to paste its content ('Paste as'). The default paste location is the current working directory. It can be changed manually in the appropriate field following the 'Paste as' button.

    Another way to paste the clipboard content is to use the 'Paste' button below the file selection window. This would always paste the current content of the clipboard in the current working directory (of the form where the 'Paste' button is clicked). Note that the 'Paste' button would paste the clipboard content even if the clipboard form is not appended. The clipboard content may be altered from another browser window, or, in principle, by another user from another computer (this is one of the reasons that different users should use different configuration setups of WebRSH). The 'Paste' button always responds to the current content regardless of its source. It is possible to have WebRSH open in two browser windows with different working directories, and to cut (or copy) a file in one of these windows and then immediately paste it in the other.