File Manager Reference reference General Reference File Manager Menus File Manager Window and Dialog Boxes File Manager Mouse Reference mouse buttons buttons, mouse using the mouse selecting objects To change mouse behavior in the Style Manager help volume describes how to switch the order of the mouse buttons left-to-right. Mouse Button 1&emdash;Select and Drag Mouse button 1 (the left button, by default) is used to select and drag objects. Selecting objects: Click an icon to select a single object. Place the mouse pointer in the background area, press and hold Mouse button 1, and then drag a box around multiple icons to select all the icons within the box. Hold down the Control key and click on another icon to add it to the current selection. A second Control click on a selected object removes it from a group of selected objects. Selecting text: Click an icon's name to edit it. Press Return (Enter) when you are done editing. Click on a workspace's name in the Front Panel workspace buttons to edit it. Mouse Button 2 can be changed so that click performs to an adjust function. This change can be done by using the mouse dialog in Style Manager. Adjust means that when you click mouse button 2 in the text, the end point of the currently selected text will move to the where you clicked mouse button 2. For example, if you insert the cursor in a word and then move the pointer to the right 10 letters and click mouse button 2, all the letters between the cursor and pointer will be selected. If you click mouse button 2 again 10 more letters to the right, all 20 letters are selected. To edit selected text: Click to position the text cursor. Drag to select a range of text. Double-click to select an entire word. Triple-click to select an entire line. Quadruple-click to select an entire multiline field of text. Dragging objects: Moving objects: hold mouse button 1 down while dragging an icon. Release the button to drop. (See ). Copy objects: press and hold down the Control key and drag using mouse button 1. (See ). Create a link: press and hold down the Shift key and drag using mouse button 1. (See .) Mouse Button 2&emdash;Drag Mouse button 2 (the middle button, by default) can be used to drag and drop objects. Moving objects: hold mouse button 2 down while dragging an icon. Release the button to drop. (See .) Copy objects: press and hold down the Control key and drag using mouse button 2. (See ). Create a link: press and hold down the Shift key and drag using mouse button 2. (See .) On a two-button mouse, press both buttons simultaneously. By default, mouse button 2 click can also be used to transfer (copy) selected text. Select some text using mouse button 1. Move the mouse pointer to where you want a copy of the selected text to be inserted and click mouse button 2. Mouse Button 3&emdash;Menus context menus Mouse button 3 (the right button, by default) is used to display pop-up menus. Point to the object or area where the menu is available, then press and hold mouse button 3 to display a pop-up menu that will go away when you release the button. Point to the object or area where the menu is available, then click mouse button 3 to display a pop-up menu that stays displayed until you select another object. Keyboard equivalent: Shift+F10. Pop-up menus are available for most objects in File Manager windows and on the desktop (including the workspace backdrop). See and . File Manager File Menu New Folder Prompts for a folder name, to create a new folder. (See .) New File Prompts for a file name, to create a new file. (See .) Go Home Changes to your home folder. Go Up Moves up one level in the folder hierarchy. Go To Displays the Go To dialog box, in which you can type in a new folder name or choose one from a list of folders you have previously gone to. Find Displays the Find dialog box, through which you can search for files and folders based on file name patterns or file contents. (See or .) Open Terminal Opens a terminal emulator window with the same current folder as the File Manager view. (See .) Close Closes the current File Manager view. File Manager View Menu Open New View Opens another File Manager window showing a view of the current folder using the same preferences and settings. Set View Options Displays the Set View Options dialog box for changing the appearance and behavior of the current File Manager view. (See and .) Save As Default Options Saves the current options, window size, and filter list as the default to be used the next time you launch the File Manager from the Front Panel. (See .) Show Hidden Objects Toggles the display of hidden files. You can specify which data types are hidden by using the Modify Filter List choice. (See .) Set Filter Options Displays the Set Filter Options dialog box, which you use to specify files that you want to be hidden based on data type or name. (See .) Clean Up Sorts and arranges the objects in the current folder into rows and columns. Update Refreshes the current folder contents and redisplays it with any changes that have been made to files since the last update. File Manager automatically updates and redisplays each displayed folder every 3 seconds (determined by the rereadTime resource). The only time you should need to use Update is if you have changed the File Manager's rereadTime resource to 0 (do not refresh folder automatically) or some long time period. (See .) File Manager Selected Menu Move to Prompts for the new full path name of the file you want to move. (See .) Copy to Prompts for a new file name, to create a copy of the selected file. The Copy command is available only when there is exactly one file selected. (See .) Copy as Link Prompts for the new full path name of the link that will be created for the selected object. (See .) Put In Workspace Puts the selected object into the right corner of the workspace backdrop. The location of the icon on the desktop is determined by the objectPlacement resource, which defaults to the top right corner of the screen. (See and .) Put in Trash Puts the selected objects in the Trash Can. Rename Opens the edit name field for the selected object. The Rename command is available only when there is exactly one object selected. (See .) Change Permissions Displays the Change Permissions dialog box for the selected object. This dialog shows the permissions for the object. The Change Permissions command is available only when there is exactly one object selected. (See .) Select All Selects all objects in the current File Manager view. (See .) Deselect All Deselects all objects in the current File Manager view. Actions If the object has any actions, they are appended to the bottom of the menu. These are the same actions that appear in the object's pop-up menu. Since the actions vary from object to object depending on data type, the contents of the actions portion of the menu varies. The action portion of the Selected menu is active only when there is only one object selected in the File Manager window. Related Topics File Manager Help Menu Overview Displays general introductory information about File Manager. Table of Contents Displays a list of all the topics covered in the help. Tasks Displays specific "how to" task instructions for using File Manager; for example, how to create a new file. Reference Displays information grouped by the different parts of File Manager such as the View menu or Trash Can. On Item Changes the display cursor to the On Item help cursor. Put the help cursor on top of the item you want help on and then click to get help on that item. Using Help Provides help on using the help windows. About File Manager Displays File Manager version and copyright information. File Manager Pop-Up Menu for Objects Most objects in a File Manager view have their own pop-up menus. At the top of each pop-up menu are four standard commands: Change Permissions, Put In Workspace, Put in Trash, and Help. In addition, the actions for the object's data type are at the bottom of the pop-up menu. These are the same actions that appear in the Actions menu when the object's icon is selected. Change Permissions Displays the Change Permissions dialog box for the object. (See .) Put In Workspace Puts the object on the desktop for the current workspace. The location of the object is determined by the objectPlacement resource, which defaults to the top right corner of the screen. (See and .) Put in Trash Deletes the object to the Trash Can. Help Displays the help for pop-up menus. actions If the object has any other actions, they are appended to the bottom of the pop-up menu. These are the same actions that appear in the menu bar Selected menu when the object is selected. Related Topics Workspace Objects Pop-up Menu Workspace objects are File Manager objects that you have placed on the workspace backdrop. These objects have pop-up menus that contain the following items: Remove from Workspace Removes the workspace object (link) from the workspace backdrop but leaves the original File Manager copy intact. Do not drag a desktop object to the Trash Can unless you want to delete both the link and the original. (See ). Open Parent Folder Opens a File Manager view of the parent folder (directory) containing the object. The object's icon is selected within the new view. Rename Selects the object's name for editing. Type in the new name then press Return. Note that this also changes the name of the original object back in the File Manager folder. actions If the object has any other actions, they are appended to the bottom of the menu. Related Topics File Manager Window Iconic Path Header The iconic path header contains an iconic representation of the path to the current folder. Each folder in the current folder path is represented by a folder icon with the name of the folder beneath it. Double-clicking on any of the folders in the path changes the current view to that folder. The iconic path header can be removed from the window by choosing Set View Options from the View menu and deselecting the check box. Text Path Header The text path header contains the current folder path. Double-clicking any segment of the path changes the view to that path. Clicking any portion of the path changes the path into a text field that you can edit. After you edit the path, press Return to change the view to the folder specified by the new path. The current folder header can be removed from the window by choosing Set View Options command from the View menu and deselecting the check box. Viewing Area The viewing area contains icons representing the files and folders contained in the current folder. You can change how files and folder are represented by choosing the Set View Options from the View menu. Use the Set Filter Options command in the View menu to specify which data types are visible and which are hidden in File Manager views. Message Line The message line shows the number of visible and hidden objects in the current folder and also displays update messages. Related Topics File Manager Trash Can For task information, see . The Trash Can is a special File Manager container of objects you've deleted. Objects in the Trash Can can be: Removed from your file system using the Shred command from the File menu. Put Back into the folder from which they were deleted using the Put Back command from the File menu. Trash Can Viewing Area The viewing area contains icons representing the objects you've deleted to the Trash Can. Pop-up Menus Each object in the Trash Can has a pop-up menu (displayed by pressing Shift+F10 or mouse button 3) containing two commands: Put Back Restores the file, removing it from the Trash Can and putting it back into its original place in File Manager. Shred Deletes the file permanently from the file system. Once a file is shreded, you cannot get it back. Trash Can File Menu Select All Selects all the files in the Trash Can. Deselect All Deselects all the files in the Trash Can. Put Back Puts the selected files back into the folder from which they were deleted. Shred Deletes the selected files from your file system. Once a file is shredded, you cannot get it back. Set View Options Displays the Set View Options dialog box for changing the appearance and behavior of objects in the Trash Can window. See , , or . Close Closes the Trash Can window. Trash Can Help menu See . File Manager New Folder Dialog Box For task information, see . New Folder Name &newline;Type the name of the new folder. It will be created in the current folder. If the folder is being created in a different folder, you must type the full path name of the new folder you want to create. OK Creates the folder and closes the dialog box. Apply Creates the folder and retains the dialog box so you can create another folder. Cancel Cancels the New Folder command and closes the dialog box. Show Icon Displays a preview of the new folder icon. Help Displays help about this dialog box. File Manager New File Dialog Box For task information, see . New File Name &newline;Type the name of the new file. The file will be created in the current folder. If the file is being created in a different folder, you must type the full pathname of the new file you want to create. OK Creates the file and closes the dialog box. Apply Creates the file and retains the dialog box so you can create another new file. Cancel Cancels the New File command and closes the dialog box. Show Icon If you change the file to a different file type when you type in the new file name, its icon may change. To see a preview of the new icon, click Show Icon and the icon inside the dialog box will update. For example, if you type a name ending in .tif, then choose Show Icon, you will see the TIFF data type icon. Help Displays help about this dialog box. File Manager Go To Dialog Box For task information, see . System name: name Shows a list of the folders you've viewed using the Go To dialog box or by editing the text path area below the menu bar. To change to a folder in the list, double-click it or select it and choose OK. Destination Folder Type the path to the folder you want to view. As you are typing, you can use Spacebar to complete folder names if you've typed enough of the name to uniquely identify the folder. OK Changes the view to the folder named in the Destination Folder field and closes the dialog box. Cancel Closes the dialog box without changing folders. Help Displays help about changing folders. File Manager Find Files or Folder Dialog Box Use the Find Files or Folders dialog box to search a folder and the folders it contains for files with a particular name or contents. For task information, see or . File or Folder Name Type the name of the file or folder you want to find. You can use wildcard characters. (See the discussion of Matching Patterns in ). File Contents Find will search inside files and folders for the text you type in this field. (See the discussion in ). This is slower than Name search. Search Folder Type the path of the folder where you want the search to start. The search will start at that folder and include all its subfolders. The current folder name automatically appears when you first open the dialog box. Files Found Lists the files or folders found in the search. Double-click a file or folder in the list to open a new File Manager view showing that file or folder. Open Folder If a file is found, Opens a File Manager view of the folder containing the file that is selected in Files Found. If a folder was found, the view is the contents of that folder. Put In Workspace Put the selected file or folder on the backdrop of the current workspace. Start Starts the search. Stop Stops a search in progress. Note that this button can be used even when the hourglass cursor is shown. Cancel Stops a search in progress and closes the dialog box. Help Displays help about finding objects. Related Topics File Manager Move File/Folder Dialog Boxes The Move File dialog box and the Move Folder dialog box have essentially the same fields and buttons. For task information, see . Selected Object Displays the file or folder that will be moved. Destination Folder This is the name of the folder you want to move the object to. Type the full path name of the folder to which you want to move the file or folder. OK Performs the move and closes the dialog box. Cancel Cancels the Move command and closes the dialog box. Help Displays the help for this dialog box. You can also use the mouse to move files or folders. (See .) File Manager Copy File/Folder Dialog Boxes The Copy File dialog box and the Copy Folder dialog box have essentially the same fields and buttons. For task information, see . Selected object Displays the object that will be copied. Destination Folder This is the name of the folder you want to copy the object to. Type the full path name of the folder to which you want to copy the file or folder. Name for copy If you want a different name for the copy, type the name of the new object. If you don't change the name, the copy will have the same name as the original. OK Performs the copy and closes the dialog box. Cancel Cancels the Copy command and closes the dialog box. Show Icon &newline;If you change the file to a different file type when you type in the Name for copy, its icon may change. To see a preview of the new icon, click Show Icon and the icon inside the dialog box will update. For example, if you type a name ending in .tif, then choose Show Icon, you will see the TIFF data type icon. Help Displays the help about this dialog box. You can also use the mouse to copy files or folders. (See ). File Manager Link File/Folder Dialog Boxes The Link File dialog box and the Link Folder dialog box have essentially the same fields and buttons. For task information, see . Selected object Displays the object that will be linked. Destination Folder This is the name of the folder you want to link the object to. Type the full path name of the object using the path to which you want to link it. Name for copy If you want the link to have a different name than the original, type the name of the new object. OK Performs the copy and closes the dialog box. Cancel Cancels the Copy command and closes the dialog box. Show Icon &newline;If you change the file to a different file type when you type in the Name for copy, its icon may change. To see a preview of the new icon, click Show Icon and the icon inside the dialog box will update. For example, if you type a name ending in .tif, then choose Show Icon, you will see the TIFF data-type icon. Help Displays the help for this dialog box. You can also use the mouse to link files or folders. (See .) File Manager Folder Copy File Overwrite Dialog Box This dialog box is displayed when the source folder is being merged into the destination folder and an object in the destination folder has the same name as an object in the source folder. For task information, see . Message area Displays the name of the object that already exists and the name of the destination folder. Replace existing file Select this button to replace the file in the destination folder with the one from the source folder. Skip this file Select this button to leave the original file in the destination folder. Rename existing file to Select this button to provide a new name for the file in the destination folder. You must provide a name which does not already exist in the destination folder. A valid new name is provided automatically by appending a number to the end of the old names. Apply this action to subsequent name conflicts Selecting this toggle will prevent the overwrite dialog box from appearing for any subsequent name conflicts. During further name conflicts, the destination file will be overwritten, skipped, or renamed automatically depending on the currently selected response. In the case of rename, a new name will be generated by appending a number to the file name. For example, prog.c will become prog_1.c. OK Performs the selected overwrite/skip/rename operation that you selected and closes the dialog box. Cancel Copy Displays a confirmation dialog box. If you cancel the copy, any objects already copied will remain in the destination folder. Help Displays help for this dialog box. File Manager Folder Copy/Move - Warning Dialog Box This dialog box is displayed when the user requests that the copy/move operation be cancelled. Cancel Copy/Move Cancels the Copy/Move command and closes the dialog box. Note that any object that has already been moved or copied will stay in its new destination. Continue Copy/Move Continues the Copy/Move command. Help Displays the help for this dialog box. File Manager Copy Warning Dialog Box (Replace/Merge) Message Area Displays the warning message. Replace existing folder Select this button to delete the existing folder and replace it with the new folder that has the same name. Merge contents of the two folders Select this button to merge the contents of the source folder into the destination folder. Ok Completes the Copy command using the method you have choosen. Cancel Copy Cancels the Copy command and closes the dialog box. Help Displays the help for this dialog box. File Manager Copy/Move Warning Dialog Box (Replace/Rename) Message Area Displays the warning message. Replace existing object Select this button to replace the existing object with the new object. Rename existing object to: Select this button to provide a new name for the object in the destination folder. You must provide a name which does not already exist in the destination folder. A valid new name will be provided. Ok Continues the Copy/Move command. Cancel Copy/Move Cancels the Copy/Move command and closes the dialog box. Help Displays the help for this dialog box. File Manager Copy/Move Multicollide Warning Dialog Box Message Area Displays the warning message. Replace existing objects Select this button to replace the existing objects with the new objects. Rename existing objects by appending a number Select this button to have the existing objects renamed in the destination folder. A new name will be generated by appending a number to the file name. For example, prog.c will become prog_1.c. Ok Continues the Copy/Move command. Stop Copy/Move Cancels the Copy/Move command and closes the dialog box. Help Displays the help for this dialog box. File Manager Folder Copy and Move Error Dialog Box This dialog box is displayed when a error occurs during a folder copy or move. For task information, see or . Message area This area displays the name of the object being moved or copied. The line under the name contains the error message. Pause for errors? By default, this button is selected and the folder copy/move will temporarily stop if an error is encountered. When an error occurs, a dialog box is displayed with more information and options to continue or cancel the operation. Deselect this button to bypass this error dialog box for any future errors during the rest of this folder copy/move. OK Closes the dialog box and the folder copy/move continues. File Manager Folder Copy and Move Dialog Box This dialog box is displayed during a folder copy or move. If there are no errors, the dialog box will be automatically dismissed after the folder copy or move completes. For task information, see or . Pause for errors By default, this button is selected and the folder copy/move will temporarily stop if an error is encountered. When an error occurs, a dialog box is displayed with more information and options to continue or cancel the operation. Deselect this button to bypass this error dialog box for the rest of this folder copy/move. Status area This area displays the source and destination folders, a count of the number of files and folders copied/moved, and the current file being copied/moved. If any errors have occurred, a count of the number of errors, and a list of the error messages is displayed. OK Closes the dialog box. Pause Selecting this button will temporarily stop the folder copy until you select it again or select Cancel. The text on the button will change to Resume. Resume This button appears after you select the Pause button. Selecting this button will continue the folder copy or move. The text on the button will revert to Pause. Cancel Copy Stops the folder copy or move. A confirmation dialog box will be displayed. Help Displays help for this dialog box. File Manager File Rename Field For task information, see . When you choose the Rename command from the Selected menu or select an object's name, you can type the new name directly into the name field. Press Return when you're done, or press Escape to cancel the operation. File Manager Change Permissions Dialog Box Use the Change Permissions dialog box to change the read, write, and execute permissions of files or folders you own. Only the root user or owner of the file or folder can change the permissions. If you do not own the file or folder, the box will show the current settings; you cannot change them. The Change Permissions dialog box also shows the full path name, size, and the date and time last modified of the file or folder. For task information, see . Owner Name The name of the user that owns the object. Only a system administrator (root user) can change the owner of an object. Group Name The name of the group of users who receive the permissions shown in the Group row in the permissions list. If you are the owner, you can change the group to another group you belong to. A root user can change it to any group. Permissions If you are owner, you can change the read, write, and execute permissions. Select a check box to provide the permission. OK Applies the current settings and closes the dialog box. Cancel Closes the dialog box without making any changes. Help Displays help about changing permissions. Related Topics File Manager Set View Options Dialog Box Use the Set View Options dialog box to change how files and folders are represented in File Manager. For task information, see: Headers The Headers preference indicates which header lines you want to be displayed in the File Manager window. Iconic Path Displays the current folder/directory as a chain of folder icons. This header appears immediately under the menu bar. Text Path Displays the full path name of the current folder in a text line, just above the main viewing area. You can click in the text and edit the path name to change the current folder or you can double-click on one of the folder names in the path and the view will change to that folder. (See .) Message Line Displays the total number of files and folders and the number of hidden files in the current folder. The message line appears at the bottom of the File Manager window. Placement The Placement preference indicates how you want icons arranged within the File Manager view. As Placed Objects are put exactly where you place them when you drop them within the File Manager view. This enables you to manually arrange the icons in any pattern or order. Rows and Columns Objects are re-sorted and arranged in rows and columns whenever there is any change to the contents of the folder. The sort order is determined by the Order setting. (This is the default.) Show folder tree tree view (File Manager) By Single Folder Displays the contents of a single folder -- the current folder. By Tree Displays the contents of the current folder in the form of a tree. Folders only If By Tree is selected, the view just shows folders. This is the default. Folders, then Files If By Tree is selected, the first click on the + button shows folders. A second click on + shows the files. Folders and Files If By Tree is selected, the first click on the + button shows all folders and files. Representation By Name Only Each object is displayed only as a name. By Large Icons Each object is displayed with its name and a large icon. (This is the default.) By Small Icons Each object is displayed with its name and a small icon. long listing format By Name, date, size, ... Each object is displayed in long list, showing name, modification date, size, permissions, owner, and group. Order Choose the order in which files and folders are displayed (The default is alphabetical, A to Z.): Alphabetically Choose Ascending (A to Z, then a to z) or Descending (Z to A, then z to a). By File Type Files are grouped together according to data type. Within each type, the files are sorted alphabetically. By Date Choose Ascending (oldest to youngest) or Descending (youngest to oldest). By Size Choose Ascending (smallest to largest) or Descending (largest to smallest). Direction Choose the direction in which files and folders are displayed: Ascending Oldest to youngest, smallest to largest Descending Youngest to oldest, largest to smallest File Manager Set Filter Options Dialog Box For task information, see . Select Datatypes to be Hidden or Shown This button toggles between Hidden and Shown. An iconic list of all the data types defined on your system is displayed. The data types can be selected by clicking on them. Selected data types have a highlighted name. A second click deselects. Selected data types will be displayed in File Manager depending on whether the toggle button shows Shown or Hidden. Select All Selects all data types. Unless you then deselect some, your File Manager viewing area will be empty if Hidden is On. Deselect All Deselects all the data types. Also hide (Optional) Enables you to filter by file name. For example, if you type *.o, then File Manager will not display files with names ending in .o. Note that any filetype that you type into this field is added to the list of filetypes selected in the icon list in the top part of the dialog box. OK Applies the current filter settings and closes the dialog box. Apply Applies the current filter settings without closing the dialog box. Defaults Restores the default filter list (which includes DOT_FILE, DOT_FOLDER, and CURRENT_FOLDER). The filter list is not applied until you choose Apply or OK. Cancel Restores the last applied settings and closes the dialog box. Help Displays help about filtering objects. File Manager Resources For File Manager resource information, see the dtfile man page. To display the dtfile man page, type the following command in a Terminal window: man dtfile