CDE/cde/doc/C/help/Filemgr/Ref.sgm

<!-- $XConsortium: Ref.sgm /main/9 1996/10/29 21:34:31 cdedoc $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<!-- File name:   Reference -->
<Chapter Id="Reference">
<Title>File Manager Reference</Title>
<IndexTerm>
<Primary>reference</Primary>
</IndexTerm>
<Procedure>
<Title>General Reference</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.1">
<Para><XRef Linkend="FMMouseSI"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
<Procedure>
<Title>File Manager Menus</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.2">
<Para><XRef Linkend="FMFileMenuDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.3">
<Para><XRef Linkend="FMViewMenuDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.4">
<Para><XRef Linkend="FMActionsMenuDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.5">
<Para><XRef Linkend="FMHelpMenuDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.6">
<Para><XRef Linkend="FMPopupMenuDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.7">
<Para><XRef Linkend="FMDesktopMenuDE"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
<Procedure>
<Title>File Manager Window and Dialog Boxes</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.8">
<Para><XRef Linkend="FMDirectoryViewDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.9">
<Para><XRef Linkend="FMTrashDialogDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.10">
<Para><XRef Linkend="FMCreateFolderDialogDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.11">
<Para><XRef Linkend="FMCreateFileDialogDE">
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.12">
<Para><XRef Linkend="FMChangeToDialogDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.13">
<Para><XRef Linkend="FMFindDialogDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.14">
<Para><XRef Linkend="FMMoveDialogDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.15">
<Para><XRef Linkend="FMCopyDialogDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.16">
<Para><XRef Linkend="FMCopyLinkDialogDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.17">
<Para><XRef Linkend="FMCopyDirOverDialogDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.18">
<Para><XRef Linkend="FMCopyFoldWarnDialogDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.19">
<Para><XRef Linkend="FMCopyWarnDialogDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.20">
<Para><XRef Linkend="FMCopyDirDialogErrorDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.21">
<Para><XRef Linkend="FMCopyDirDialogStatusDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.22">
<Para><XRef Linkend="FMCopyWarnRenDialogDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.23">
<Para><XRef Linkend="FMCopyWarnMultiDialogDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.24">
<Para><XRef Linkend="FMNameChangeDialogDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.25">
<Para><XRef Linkend="FMPropertiesDialogDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.26">
<Para><XRef Linkend="FMPreferencesDialogDE"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.27">
<Para><XRef Linkend="FMFilterDialogDE"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
<Sect1 Id="FMMouseSI">
<Title>File Manager Mouse Reference</Title>
<IndexTerm>
<Primary>mouse buttons</Primary>
</IndexTerm>
<IndexTerm>
<Primary>buttons, mouse</Primary>
</IndexTerm>
<IndexTerm>
<Primary>using the mouse</Primary>
</IndexTerm>
<IndexTerm>
<Primary>selecting objects</Primary>
</IndexTerm>
<Para><OLink Type="JumpNewView" LocalInfo="Stylemgr ChangeMouseTA">To change mouse behavior</OLink> in the Style Manager help volume
describes how to switch the order of the mouse buttons left-to-right.
</Para>
<Procedure>
<Title>Mouse Button 1&emdash;Select and Drag</Title>
<Step>
<Para>Mouse button 1 (the left button, by default) is used to select and drag
objects.</Para>
<Para>Selecting objects:
</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.28">
<Para>Click an icon to select a single object.
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.29">
<Para>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.
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.30">
<Para>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.
</Para>
</ListItem>
</ItemizedList>
<Para>Selecting text:
</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.31">
<Para>Click an icon's name to edit it. Press Return (Enter) when you are
done editing.
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.32">
<Para>Click on a workspace's name in the Front Panel workspace buttons to edit it.</Para>
<Para>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.
</Para>
</ListItem>
</ItemizedList>
<Para>To edit selected text:
</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.33">
<Para>Click to position the text cursor.
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.34">
<Para>Drag to select a range of text.
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.35">
<Para>Double-click to select an entire word.
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.36">
<Para>Triple-click to select an entire line.
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.37">
<Para>Quadruple-click to select an entire multiline field of text.
</Para>
</ListItem>
</ItemizedList>
<Para>Dragging objects:
</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.38">
<Para>Moving objects: hold mouse button 1 down while dragging an icon. Release the
button to drop. (See <XRef Linkend="ToDropAnObjectTA">).
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.39">
<Para>Copy objects: press and hold down the Control key
and drag using mouse button 1. (See <XRef Linkend="ToCopyAnObjectTA">).
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.40">
<Para>Create a link: press and hold down the Shift key
and drag using mouse button 1. (See <XRef Linkend="ToCreateASymbolicLinkTA">.)
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
<Procedure>
<Title>Mouse Button 2&emdash;Drag</Title>
<Step>
<Para>Mouse button 2 (the middle button, by default) can be used to
drag and drop objects.
</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.41">
<Para>Moving objects: hold mouse button 2 down while dragging an icon. Release the
button to drop. (See <XRef Linkend="ToDropAnObjectTA">.)
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.42">
<Para>Copy objects: press and hold down the Control key
and drag using mouse button 2. (See <XRef Linkend="ToCopyAnObjectTA">).
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.43">
<Para>Create a link: press and hold down the Shift key
and drag using mouse button 2. (See <XRef Linkend="ToCreateASymbolicLinkTA">.)
</Para>
</ListItem>
</ItemizedList>
<Para>On a two-button mouse, press both buttons simultaneously.</Para>
<Para>By default, mouse button 2 click can also be used to transfer (copy) selected text.
</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.44">
<Para>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.
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
<Procedure>
<Title>Mouse Button 3&emdash;Menus</Title>
<IndexTerm>
<Primary>context menus</Primary>
</IndexTerm>
<Step>
<Para>Mouse button 3 (the right button, by default) is used to display pop-up
menus.
</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.45">
<Para>Point to the object or area where the menu is available, then press
<Emphasis>and hold</Emphasis> mouse button 3 to display a pop-up menu that will go away when you
release the button.
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.46">
<Para>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.
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.47">
<Para>Keyboard equivalent: Shift+F10.
</Para>
</ListItem>
</ItemizedList>
<Para>Pop-up menus are available for most objects in File Manager windows and on
the desktop (including the workspace backdrop). See
<XRef Linkend="FMPopupMenuDE"> and <XRef Linkend="FMDesktopMenuDE">.
</Para>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="FMFileMenuDE">
<Title>File Manager File Menu</Title>
<Para><Anchor Id="FileManagerFileMenu">
</Para>
<VariableList>
<VarListEntry>
<Term>New Folder</Term>
<ListItem>
<Para><Anchor Id="FileManagerNewDirCommand">
Prompts for a folder name, to create a new folder.
(See <XRef Linkend="ToCreateANewObjectTA">.)</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>New File</Term>
<ListItem>
<Para><Anchor Id="FileManagerNewCommand">
Prompts for a file name, to create a new file. (See <XRef Linkend="ToCreateANewObjectTA">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Go Home</Term>
<ListItem>
<Para><Anchor Id="FileManagerHomeCommand">
Changes to your home folder.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Go Up</Term>
<ListItem>
<Para><Anchor Id="FileManagerUpCommand">
Moves up one level in the folder hierarchy.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Go To</Term>
<ListItem>
<Para><Anchor Id="FileManagerChangeToCommand">
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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Find</Term>
<ListItem>
<Para><Anchor Id="FileManagerFindCommand">
Displays the Find dialog box, through which you can search for files
and folders based on file name patterns or file
contents. (See <XRef Linkend="ToFindAFileByNameTA"> or <XRef Linkend="ToFindAFileByContentsTA">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Open Terminal</Term>
<ListItem>
<Para><Anchor Id="FileManagerTerminalCommand">
Opens a terminal emulator window with the same current
folder as the File Manager view. (See <XRef Linkend="ToOpenATerminalWindowTA">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Close</Term>
<ListItem>
<Para><Anchor Id="FileManagerCloseCommand">
Closes the current File Manager view.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Sect1>
<Sect1 Id="FMViewMenuDE">
<Title>File Manager View Menu</Title>
<Para><Anchor Id="FileManagerViewMenu">
</Para>
<VariableList>
<VarListEntry>
<Term>Open New View</Term>
<ListItem>
<Para><Anchor Id="FileManagerNewViewCommand">
Opens another File Manager window
showing a view of the current folder
using the same preferences and settings.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Set View Options</Term>
<ListItem>
<Para><Anchor Id="FileManagerPreferencesCommand">
Displays the Set View Options dialog box for changing the
appearance and behavior of the current File Manager view.
(See <XRef Linkend="ToUseDirectoryTree"> and
<XRef Linkend="ToChangeTheSortOrderTA">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Save As Default Options</Term>
<ListItem>
<Para><Anchor Id="FileManagerSaveSettingsCommand">
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 <XRef Linkend="ToSavePreferencesAsTheDefaultTA">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Show Hidden Objects</Term>
<ListItem>
<Para><Anchor Id="FileManagerShowHiddenCommand">
Toggles the display of hidden files. You can specify which data
types are hidden by using the Modify Filter List choice.
(See <XRef Linkend="ToShowHiddenObjectsTA">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Set Filter Options</Term>
<ListItem>
<Para><Anchor Id="FileManagerFilterCommand">
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 <XRef Linkend="ToShowHiddenObjectsTA">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Clean Up</Term>
<ListItem>
<Para><Anchor Id="FileManagerCleanUpCommand">
Sorts and arranges the objects in the current folder
into rows and columns.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Update</Term>
<ListItem>
<Para><Anchor Id="FileManagerRereadCommand">
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
<XRef Linkend="FMresourcesSI">.)
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Sect1>
<Sect1 Id="FMActionsMenuDE">
<Title>File Manager Selected Menu</Title>
<Para><Anchor Id="FileManagerActionMenu">
</Para>
<VariableList>
<VarListEntry>
<Term>Move to</Term>
<ListItem>
<Para><Anchor Id="FileManagerMoveCommand">
Prompts for the new full path name of
the file you want to move. (See <XRef Linkend="ToMoveAnObjectTA">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Copy to</Term>
<ListItem>
<Para><Anchor Id="FileManagerCopyAsCommand">
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 <XRef Linkend="ToCopyAnObjectTA">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Copy as Link</Term>
<ListItem>
<Para><Anchor Id="FileManagerLinkCommand">
Prompts for the new full path name of the link that will be created for
the selected object. (See <XRef Linkend="ToCreateASymbolicLinkTA">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Put In Workspace</Term>
<ListItem>
<Para><Anchor Id="FileManagerPutOnDTCommand">
Puts the selected object into the right
corner of the workspace backdrop. The
location of the icon on the desktop is
determined by the <Emphasis>objectPlacement</Emphasis>
resource, which defaults to the
top right corner of the screen. (See
<XRef Linkend="ToPutAnObjectOnTheDesktopTA"> and
<XRef Linkend="FMresourcesSI">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Put in Trash</Term>
<ListItem>
<Para><Anchor Id="FileManagerTrashFilesCommand">
Puts the selected objects in the
Trash Can.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Rename</Term>
<ListItem>
<Para><Anchor Id="FileManagerRenameCommand">
Opens the edit name field for the
selected object. The Rename command is
available only when there is exactly
one object selected. (See <XRef Linkend="ToRenameAnObjectTA">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Change Permissions</Term>
<ListItem>
<Para><Anchor Id="FileManagerPropertiesCommand">
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 <XRef Linkend="ToChangeAnObjectsPermissionsTA">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Select All</Term>
<ListItem>
<Para><Anchor Id="FileManagerSelectAllCommand">
Selects all objects in the current File Manager view.
(See <XRef Linkend="ToSelectMultipleObjectsTA">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Deselect All</Term>
<ListItem>
<Para><Anchor Id="FileManagerUnselectAllCommand">
Deselects all objects in the current File Manager view.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Emphasis>Actions</Emphasis></Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Graphic Entityref="FM-DesktopPopupMenu" Id="HFMGR.REF.fig.1"></Graphic>
<Note>
<Para>The action portion of the
Selected menu is active only when there is only one object selected
in the File Manager window.
</Para>
</Note>
<Procedure>
<Title>Related Topics</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.48">
<Para><XRef Linkend="ToExecuteAnObjectsActionsTA"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="FMHelpMenuDE">
<Title>File Manager Help Menu</Title>
<Para><Anchor Id="FileManagerHelpMenu">
<Anchor Id="FileManagerMouseCommand">
<Anchor Id="FileManagerKeyboardCommand">
</Para>
<VariableList>
<VarListEntry>
<Term>Overview</Term>
<ListItem>
<Para><Anchor Id="FileManagerOverviewCommand">
Displays general introductory information about File Manager.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Table of Contents</Term>
<ListItem>
<Para>Displays a list of all the topics covered in the help.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Tasks</Term>
<ListItem>
<Para><Anchor Id="FileManagerTasksCommand">
Displays specific "how to" task instructions for using File Manager;
for example, how to create a new file.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Reference</Term>
<ListItem>
<Para><Anchor Id="FileManagerReferenceCommand">
Displays information grouped by the different parts of File Manager
such as the View menu or Trash Can.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>On Item</Term>
<ListItem>
<Para><Anchor Id="FileManagerHelpModeCommand">
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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Using Help</Term>
<ListItem>
<Para><Anchor Id="FileManagerUsingHelpCommand">
Provides help on using the help windows.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>About File Manager</Term>
<ListItem>
<Para><Anchor Id="FileManagerCopyrightCommand">
Displays File Manager version and copyright information.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Sect1>
<Sect1 Id="FMPopupMenuDE">
<Title>File Manager Pop-Up Menu for Objects</Title>
<Para><Anchor Id="FileManagerPopupMenu">
Most objects in a File Manager view have their own pop-up menus.</Para>
<Para>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.
</Para>
<VariableList>
<VarListEntry>
<Term>Change Permissions</Term>
<ListItem>
<Para><Anchor Id="FileManagerPropertiesFMPopupCommand">
Displays the Change Permissions dialog box for the object.
(See <XRef Linkend="ToChangeAnObjectsPermissionsTA">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Put In Workspace</Term>
<ListItem>
<Para><Anchor Id="FileManagerPutOnDTFMPopupCommand">
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 <XRef Linkend="ToPutAnObjectOnTheDesktopTA"> and <XRef Linkend="FMresourcesSI">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Put in Trash</Term>
<ListItem>
<Para><Anchor Id="FileManagerTrashFilesFMPopupCommand">
Deletes the object to the Trash Can.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para><Anchor Id="FileManagerTrashFilesHelpCommand">
Displays the help for pop-up menus.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">actions</Symbol></Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>Related Topics</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.49">
<Para><XRef Linkend="FMDesktopMenuDE"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="FMDesktopMenuDE">
<Title>Workspace Objects Pop-up Menu</Title>
<Para><Anchor Id="FileManagerDTpopupMenu">
<Anchor Id="DesktopPopupMenu">
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:
</Para>
<VariableList>
<VarListEntry>
<Term>Remove from Workspace</Term>
<ListItem>
<Para><Anchor Id="FileManagerRemoveFromDTCommand">
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 <XRef Linkend="ToRemoveAnObjectFromTheDesktopTA">).
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Open Parent Folder</Term>
<ListItem>
<Para><Anchor Id="FileManagerDTOpenSrcViewCommand">
Opens a File Manager view of the parent folder (directory) containing the
object. The object's icon is selected within the new view.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Rename</Term>
<ListItem>
<Para><Anchor Id="FileManagerRenameDTPopupCommand">
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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">actions</Symbol></Term>
<ListItem>
<Para>If the object has any other actions,
they are appended to the bottom of the menu.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>Related Topics</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.50">
<Para><XRef Linkend="DesktopIntro"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.51">
<Para><XRef Linkend="ToPutAnObjectOnTheDesktopTA"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="FMDirectoryViewDE">
<Title>File Manager Window</Title>
<Para><Anchor Id="FileManagerDirectoryView">
<Anchor Id="FileManagerView">
<Anchor Id="FileManagerIconicPath">
<Anchor Id="FileManagerCurrentDirectory">
<Anchor Id="FileManagerStatusLine">
<Anchor Id="FileManagerChangeDir">
<Anchor Id="FileManagerDirectoryList">
<Anchor Id="FileManagerIconArea">
</Para>
<Graphic Entityref="FM-MainWindowOverview" Id="HFMGR.REF.fig.2"></Graphic>
<Procedure>
<Title>Iconic Path Header</Title>
<Step>
<Para>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.</Para>
<Para>The iconic path header can be removed from the window by choosing
Set View Options from the View menu and deselecting the check box.
</Para>
</Step>
</Procedure>
<Procedure>
<Title>Text Path Header</Title>
<Step>
<Para>The text path header contains the current folder path.
</Para>
<ItemizedList Mark="&bull;">
<ListItem Id="HFMGR.REF.item.52">
<Para>Double-clicking any segment of the path changes the view to that path.
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.53">
<Para>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.
</Para>
</ListItem>
</ItemizedList>
<Para>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.
</Para>
</Step>
</Procedure>
<Procedure>
<Title>Viewing Area</Title>
<Step>
<Para>The viewing area contains icons representing the files and folders
contained in the current folder.</Para>
<Para>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.
</Para>
</Step>
</Procedure>
<Procedure>
<Title>Message Line</Title>
<Step>
<Para>The message line shows the number of visible
and hidden objects in the current folder
and also displays update messages.
</Para>
</Step>
</Procedure>
<Procedure>
<Title>Related Topics</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.54">
<Para><XRef Linkend="ToChangeToAnotherDirectoryTA"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.55">
<Para><XRef Linkend="BasicViewingPreferences"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.56">
<Para><XRef Linkend="ToUseDirectoryTree"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.57">
<Para><XRef Linkend="ToChangeTheSortOrderTA"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.58">
<Para><XRef Linkend="ToShowHiddenObjectsTA"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="FMTrashDialogDE">
<Title>File Manager Trash Can</Title>
<Para><Anchor Id="FileManagerTrashDialog">
<Anchor Id="FileManagerTrashMenuBar">
<Anchor Id="FileManagerTrashFileMenu">
<Anchor Id="FileManagerTrashHelpMenu">
<Anchor Id="FileManagerTrashUnselectCommand">
<Anchor Id="FileManagerTrashSelectCommand">
<Anchor Id="FileManagerTrashRestoreCommand">
<Anchor Id="FileManagerTrashRemoveCommand">
<Anchor Id="FileManagerTrashCloseCommand">
<Anchor Id="FileManagerTrashContents">
<Anchor Id="FileManagerTrashSetViewOptionsCommand">
For task information, see <XRef Linkend="ToDeleteAnObjectTA">.</Para>
<Para>The Trash Can is a special File Manager container of objects you've deleted.
Objects in the Trash Can can be:
</Para>
<ItemizedList Mark="&bull;">
<ListItem Id="HFMGR.REF.item.59">
<Para>Removed from your file system using the Shred command from
the File menu.
</Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.60">
<Para>Put Back into the folder from which they were deleted using the
Put Back command from the File menu.
</Para>
</ListItem>
</ItemizedList>
<Procedure>
<Title>Trash Can Viewing Area</Title>
<Step>
<Para>The viewing area contains icons representing the objects
you've deleted to the Trash Can.
</Para>
</Step>
</Procedure>
<Procedure>
<Title>Pop-up Menus</Title>
<Step>
<Para>Each object in the Trash Can has a pop-up menu
(displayed by pressing Shift+F10 or mouse button 3) containing two commands:
</Para>
<VariableList>
<VarListEntry>
<Term>Put Back</Term>
<ListItem>
<Para>Restores the file, removing it from the Trash Can and putting it
back into its original place in File Manager.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Shred</Term>
<ListItem>
<Para>Deletes the file permanently from the file system. Once a file is shreded,
you cannot get it back.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Step>
</Procedure>
<Procedure>
<Title>Trash Can File Menu</Title>
<Step>
<VariableList>
<VarListEntry>
<Term>Select All</Term>
<ListItem>
<Para>Selects all the files in the Trash Can.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Deselect All</Term>
<ListItem>
<Para>Deselects all the files in the Trash Can.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Put Back</Term>
<ListItem>
<Para>Puts the selected files back into the folder from which
they were deleted.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Shred</Term>
<ListItem>
<Para>Deletes the selected files from your file system.
Once a file is shredded, you cannot get it back.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Set View Options</Term>
<ListItem>
<Para>Displays the Set View Options dialog box for changing the
appearance and behavior of objects in the Trash Can window.
See <XRef Linkend="BasicViewingPreferences">, <XRef Linkend="ToUseDirectoryTree">,
or <XRef Linkend="ToChangeTheSortOrderTA">.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Close</Term>
<ListItem>
<Para>Closes the Trash Can window.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Step>
</Procedure>
<Procedure>
<Title>Trash Can Help menu</Title>
<Step>
<Para>See <XRef Linkend="FMHelpMenuDE">.
</Para>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="FMCreateFolderDialogDE">
<Title>File Manager New Folder Dialog Box</Title>
<Para><Anchor Id="FileManagerCreateDirDialog">
<Anchor Id="FileManagerCreateNewDir">
For task information, see <XRef Linkend="ToCreateANewObjectTA">.
</Para>
<VariableList>
<VarListEntry>
<Term>New Folder Name</Term>
<ListItem>
<Para>&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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Creates the folder and closes the dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Apply</Term>
<ListItem>
<Para>Creates the folder and retains the dialog box
so you can create another folder.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Cancels the New Folder command and closes the dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Show Icon</Term>
<ListItem>
<Para>Displays a preview of the new folder icon.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays help about this dialog box.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Graphic Entityref="FM-CreateFoldDialog" Id="HFMGR.REF.fig.3"></Graphic>
</Sect1>
<Sect1 Id="FMCreateFileDialogDE">
<Title>File Manager New File Dialog Box</Title>
<Para><Anchor Id="FileManagerCreateFileDialog">
<Anchor Id="FileManagerCreateNewFile">
<Anchor Id="FileManagerCreateFiletype">
<Anchor Id="FileManagerCreateOk">
<Anchor Id="FileManagerCreateCancel">
<Anchor Id="FileManagerCreateShowType">
<Anchor Id="FileManagerCreateHelp">
For task information, see <XRef Linkend="ToCreateANewObjectTA">.
</Para>
<VariableList>
<VarListEntry>
<Term>New File Name</Term>
<ListItem>
<Para>&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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Creates the file and closes the dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Apply</Term>
<ListItem>
<Para>Creates the file and retains the dialog box
so you can create another new file.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Cancels the New File command and closes the dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Show Icon</Term>
<ListItem>
<Para>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 <ComputerOutput>.tif</ComputerOutput>, then choose Show
Icon, you will see the TIFF data type icon.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays help about this dialog box.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Graphic Entityref="FM-CreateDialog" Id="HFMGR.REF.fig.4"></Graphic>
</Sect1>
<Sect1 Id="FMChangeToDialogDE">
<Title>File Manager Go To Dialog Box</Title>
<Para><Anchor Id="FileManagerChangeToDialog">
<Anchor Id="FileManagerChangeToOk">
<Anchor Id="FileManagerChangeToApply">
<Anchor Id="FileManagerChangeToCancel">
<Anchor Id="FileManagerChangeToHelp">
<Anchor Id="FileManagerChangeToHistory">
<Anchor Id="FileManagerChangeToText">
<Anchor Id="FileManagerChangeToHost">
For task information, see <XRef Linkend="ToChangeToAnotherDirectoryTA">.
</Para>
<VariableList>
<VarListEntry>
<Term>System name: name</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Destination Folder</Term>
<ListItem>
<Para>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.
<!-- Remote Systems are not currently supported:
************************************************************
                 Use the ``%%hostname%%:/%%path%%'' syntax to access a
                 folder on another systems.
************************************************************
--></Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Changes the view to the folder named in the Destination Folder field and
closes the dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Closes the dialog box without changing folders.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays help about changing folders.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Graphic Entityref="FM-ChangeDirectoryDialog" Id="HFMGR.REF.fig.5"></Graphic>
</Sect1>
<Sect1 Id="FMFindDialogDE">
<Title>File Manager Find Files or Folder Dialog Box</Title>
<Para><Anchor Id="FileManagerFindDialog">
<Anchor Id="FileManagerFindFileName">
<Anchor Id="FileManagerFindContents">
<Anchor Id="FileManagerFindSearchDir">
<Anchor Id="FileManagerFindMatches">
<Anchor Id="FileManagerFindNewView">
<Anchor Id="FileManagerFindPutOnDT">
<Anchor Id="FileManagerFindStart">
<Anchor Id="FileManagerFindStop">
<Anchor Id="FileManagerFindClose">
<Anchor Id="FileManagerFindHelp">
<Anchor Id="FileManagerFollowLinksHelp">
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 <XRef Linkend="ToFindAFileByNameTA"> or
<XRef Linkend="ToFindAFileByContentsTA">.
</Para>
<VariableList>
<VarListEntry>
<Term>File or Folder Name</Term>
<ListItem>
<Para>Type the name of the file or folder you want
to find. You can use wildcard characters. (See
the discussion of Matching Patterns in <XRef Linkend="ToFindAFileByNameTA">).
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>File Contents</Term>
<ListItem>
<Para>Find will search inside files and folders for the
text you type in this field. (See the discussion in
<XRef Linkend="MatchingPatterns">). This is slower than Name search.
<!-- \Follow Links\  Choose On if you want the search to follow symbolic links
                (which may take longer).  Otherwise, choose Off. --></Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Search Folder</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Files Found</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Open Folder</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Put In Workspace</Term>
<ListItem>
<Para>Put the selected file or folder on the backdrop of
the current workspace.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Start</Term>
<ListItem>
<Para>Starts the search.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Stop</Term>
<ListItem>
<Para>Stops a search in progress. Note that this button can be
used even when the hourglass cursor is shown.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Stops a search in progress and closes the dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays help about finding objects.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Graphic Entityref="FM-FindDialog" Id="HFMGR.REF.fig.6"></Graphic>
<Procedure>
<Title>Related Topics</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.61">
<Para><XRef Linkend="ToFindAFileByNameTA"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.62">
<Para><XRef Linkend="ToFindAFileByContentsTA"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="FMMoveDialogDE">
<Title>File Manager Move File/Folder Dialog Boxes</Title>
<Para><Anchor Id="FileManagerMoveDialog">
<Anchor Id="FileManagerMoveCurrent">
<Anchor Id="FileManagerMoveNew">
<Anchor Id="FileManagerMoveFiletype">
<Anchor Id="FileManagerMoveOk">
<Anchor Id="FileManagerMoveCancel">
<Anchor Id="FileManagerMoveShowType">
<Anchor Id="FileManagerMoveHelp">
The Move File dialog box and the Move Folder dialog box
have essentially the same fields and buttons. For task information, see
<XRef Linkend="ToMoveAnObjectTA">.
</Para>
<VariableList>
<VarListEntry>
<Term>Selected Object</Term>
<ListItem>
<Para>Displays the file or folder that will be moved.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Destination Folder</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Performs the move and closes the
dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Cancels the Move command and closes the
dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays the help for this dialog box.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>You can also use the mouse to move files or folders.
(See <XRef Linkend="FMMouseSI">.)
</Para>
<Graphic Entityref="FM-MoveDialog" Id="HFMGR.REF.fig.7"></Graphic>
</Sect1>
<Sect1 Id="FMCopyDialogDE">
<Title>File Manager Copy File/Folder Dialog Boxes</Title>
<Para><Anchor Id="FileManagerCopyDialog">
<Anchor Id="FileManagerCopyCurrent">
<Anchor Id="FileManagerCopyNew">
<Anchor Id="FileManagerCopyFiletype">
<Anchor Id="FileManagerCopyOk">
<Anchor Id="FileManagerCopyCancel">
<Anchor Id="FileManagerCopyShowType">
<Anchor Id="FileManagerCopyHelp">
The Copy File dialog box and the Copy Folder dialog box
have essentially the same fields and buttons. For task information, see
<XRef Linkend="ToCopyAnObjectTA">.
</Para>
<VariableList>
<VarListEntry>
<Term>Selected object</Term>
<ListItem>
<Para>Displays the object that will be copied.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Destination Folder</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Name for copy</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Performs the copy and closes the
dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Cancels the Copy command and closes the
dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Show Icon</Term>
<ListItem>
<Para>&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 <ComputerOutput>.tif</ComputerOutput>, then choose Show
Icon, you will see the TIFF data type icon.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays the help about this dialog box.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>You can also use the mouse to copy files or folders.
(See <XRef Linkend="FMMouseSI">).
</Para>
<Graphic Entityref="FM-CopyDialog" Id="HFMGR.REF.fig.8"></Graphic>
</Sect1>
<Sect1 Id="FMCopyLinkDialogDE">
<Title>File Manager Link File/Folder Dialog Boxes</Title>
<Para><Anchor Id="FileManagerCopyLinkDialog">
<Anchor Id="FileManagerCopyLinkCurrent">
<Anchor Id="FileManagerCopyLinkNew">
<Anchor Id="FileManagerCopyLinkFiletype">
<Anchor Id="FileManagerCopyLinkOk">
<Anchor Id="FileManagerCopyLinkCancel">
<Anchor Id="FileManagerCopyLinkShowType">
<Anchor Id="FileManagerCopyLinkHelp">
The Link File dialog box and the Link Folder dialog box
have essentially the same fields and buttons. For task information, see
<XRef Linkend="ToCreateASymbolicLinkTA">.
</Para>
<VariableList>
<VarListEntry>
<Term>Selected object</Term>
<ListItem>
<Para>Displays the object that will be linked.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Destination Folder</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Name for copy</Term>
<ListItem>
<Para>If you want the link to have a different name than
the original,
type the name of the new object.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Performs the copy and closes the
dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Cancels the Copy command and closes the
dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Show Icon</Term>
<ListItem>
<Para>&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 <ComputerOutput>.tif</ComputerOutput>, then choose Show
Icon, you will see the TIFF data-type icon.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays the help for this dialog box.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>You can also use the mouse to link files or folders.
(See <XRef Linkend="FMMouseSI">.)
</Para>
<Graphic Entityref="FM-CopyLinkDialog" Id="HFMGR.REF.fig.9"></Graphic>
</Sect1>
<Sect1 Id="FMCopyDirOverDialogDE">
<Title>File Manager Folder Copy File Overwrite Dialog Box</Title>
<Para><Anchor Id="FileManagerDirCopyDialog">
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.</Para>
<Para>For task information, see <XRef Linkend="ToCopyAnObjectTA">.
</Para>
<VariableList>
<VarListEntry>
<Term>Message area</Term>
<ListItem>
<Para>Displays the name of the object that already exists
and the name of the destination folder.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Replace existing file</Term>
<ListItem>
<Para>Select this button to replace the file in the
destination folder with the one from the source
folder.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Skip this file</Term>
<ListItem>
<Para>Select this button to leave the original file
in the destination folder.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Rename existing file to</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Apply this action to subsequent name conflicts</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Performs the selected overwrite/skip/rename operation
that you selected and closes the dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel Copy</Term>
<ListItem>
<Para>Displays a confirmation dialog box. If you cancel
the copy, any objects already copied will remain
in the destination folder.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays help for this dialog box.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Graphic Entityref="FM-CopyOverwrite" Id="HFMGR.REF.fig.10"></Graphic>
</Sect1>
<Sect1 Id="FMCopyFoldWarnDialogDE">
<Title>File Manager Folder Copy/Move - Warning Dialog Box</Title>
<Para>This dialog box is displayed when the user requests that the
copy/move operation be cancelled.
<Anchor Id="FileManagerCopyFoldWarnDialog">
</Para>
<VariableList>
<VarListEntry>
<Term>Cancel Copy/Move</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Continue Copy/Move</Term>
<ListItem>
<Para>Continues the Copy/Move command.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays the help for this dialog box.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Graphic Entityref="FM-CopyFoldWarnDialog" Id="HFMGR.REF.fig.11"></Graphic>
</Sect1>
<Sect1 Id="FMCopyWarnDialogDE">
<Title>File Manager Copy Warning Dialog Box (Replace/Merge)</Title>
<Para><Anchor Id="FileManagerCopyWarnDialog">
<Anchor Id="FMCopyWarnMrgDialogDE">
<Anchor Id="FMCopyWarnMgrDialogDE">
</Para>
<VariableList>
<VarListEntry>
<Term>Message Area</Term>
<ListItem>
<Para>Displays the warning message.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Replace existing folder</Term>
<ListItem>
<Para>Select this button to delete the existing
folder and replace it with the new folder that has the same name.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Merge contents of the two folders</Term>
<ListItem>
<Para>Select this button to merge the
contents of the source folder into the destination folder.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Ok</Term>
<ListItem>
<Para>Completes the Copy command using the method you have choosen.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel Copy</Term>
<ListItem>
<Para>Cancels the Copy command and closes the
dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays the help for this dialog box.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Graphic Entityref="FM-CopyWarnDialog" Id="HFMGR.REF.fig.12"></Graphic>
</Sect1>
<Sect1 Id="FMCopyWarnRenDialogDE">
<Title>File Manager Copy/Move Warning Dialog Box (Replace/Rename)</Title>
<Para><Anchor Id="FileManagerCopyWarnRenDialog">
</Para>
<VariableList>
<VarListEntry>
<Term>Message Area</Term>
<ListItem>
<Para>Displays the warning message.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Replace existing object</Term>
<ListItem>
<Para>Select this button to replace the existing
object with the new object.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Rename existing object to:</Term>
<ListItem>
<Para>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.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Ok</Term>
<ListItem>
<Para>Continues the Copy/Move command.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel Copy/Move</Term>
<ListItem>
<Para>Cancels the Copy/Move command and closes the
dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays the help for this dialog box.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Graphic Entityref="FM-ReplaceRename" Id="HFMGR.REF.fig.13"></Graphic>
</Sect1>
<Sect1 Id="FMCopyWarnMultiDialogDE">
<Title>File Manager Copy/Move Multicollide Warning Dialog Box</Title>
<Para><Anchor Id="FileManagerCopyWarnMultiDialog">
</Para>
<VariableList>
<VarListEntry>
<Term>Message Area</Term>
<ListItem>
<Para>Displays the warning message.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Replace existing objects</Term>
<ListItem>
<Para>Select this button to replace the existing
objects with the new objects.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Rename existing objects by appending a number</Term>
<ListItem>
<Para>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.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Ok</Term>
<ListItem>
<Para>Continues the Copy/Move command.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Stop Copy/Move</Term>
<ListItem>
<Para>Cancels the Copy/Move command and closes the
dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays the help for this dialog box.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Graphic Entityref="FM-Multicoll" Id="HFMGR.REF.fig.14"></Graphic>
</Sect1>
<Sect1 Id="FMCopyDirDialogErrorDE">
<Title>File Manager Folder Copy and Move Error Dialog Box</Title>
<Para><Anchor Id="FileManagerDirCopyDialogError">
This dialog box is displayed when a error occurs during a
folder copy or move.
For task information, see
<XRef Linkend="ToCopyAnObjectTA"> or
<XRef Linkend="ToMoveAnObjectTA">.
</Para>
<VariableList>
<VarListEntry>
<Term>Message area</Term>
<ListItem>
<Para>This area displays the name of the object being
moved or copied. The line under the name contains
the error message.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Pause for errors?</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Closes the dialog box and the folder copy/move
continues.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Graphic Entityref="FM-CopyDirError" Id="HFMGR.REF.fig.15"></Graphic>
</Sect1>
<Sect1 Id="FMCopyDirDialogStatusDE">
<Title>File Manager Folder Copy and Move Dialog Box</Title>
<Para><Anchor Id="FileManagerDirCopyDialogStatus">
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
<XRef Linkend="ToCopyAnObjectTA"> or
<XRef Linkend="ToMoveAnObjectTA">.
</Para>
<VariableList>
<VarListEntry>
<Term>Pause for errors</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Status area</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Closes the dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Pause</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Resume</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel Copy</Term>
<ListItem>
<Para>Stops the folder copy or move. A confirmation
dialog box will be displayed.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays help for this dialog box.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Graphic Entityref="FM-CopyFoldStatusDialog" Id="HFMGR.REF.fig.16"></Graphic>
</Sect1>
<Sect1 Id="FMNameChangeDialogDE">
<Title>File Manager File Rename Field</Title>
<Para><Anchor Id="FileManagerNameChangeDialog">
For task information, see <XRef Linkend="ToRenameAnObjectTA">.</Para>
<Para>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.
</Para>
<Graphic Entityref="FM-RenameDialog" Id="HFMGR.REF.fig.17"></Graphic>
</Sect1>
<Sect1 Id="FMPropertiesDialogDE">
<Title>File Manager Change Permissions Dialog Box</Title>
<Para><Anchor Id="FileManagerPropertiesDialog">
<Anchor Id="FileManagerPropertiesFileName">
<Anchor Id="FileManagerPropertiesLinkName">
<Anchor Id="FileManagerPropertiesOwner">
<Anchor Id="FileManagerPropertiesFiletype">
<Anchor Id="FileManagerPropertiesGroup">
<Anchor Id="FileManagerPropertiesPermissions">
<Anchor Id="FileManagerPropertiesReadAccess">
<Anchor Id="FileManagerPropertiesWriteAccess">
<Anchor Id="FileManagerPropertiesExecAccess">
<Anchor Id="FileManagerPropertiesOwnerAccess">
<Anchor Id="FileManagerPropertiesOwnerRead">
<Anchor Id="FileManagerPropertiesOwnerWrite">
<Anchor Id="FileManagerPropertiesOwnerExec">
<Anchor Id="FileManagerPropertiesGroupAccess">
<Anchor Id="FileManagerPropertiesGroupRead">
<Anchor Id="FileManagerPropertiesGroupWrite">
<Anchor Id="FileManagerPropertiesGroupExec">
<Anchor Id="FileManagerPropertiesOtherAccess">
<Anchor Id="FileManagerPropertiesOtherRead">
<Anchor Id="FileManagerPropertiesOtherWrite">
<Anchor Id="FileManagerPropertiesOtherExec">
<Anchor Id="FileManagerPropertiesSize">
<Anchor Id="FileManagerPropertiesModDate">
<Anchor Id="FileManagerPropertiesOk">
<Anchor Id="FileManagerPropertiesCancel">
<Anchor Id="FileManagerPropertiesHelp">
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 <XRef Linkend="ToChangeAnObjectsPermissionsTA">.
</Para>
<VariableList>
<VarListEntry>
<Term>Owner Name</Term>
<ListItem>
<Para>The name of the user that owns the object. Only a system administrator
(root user) can change the owner of an object.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Group Name</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Permissions</Term>
<ListItem>
<Para>If you are owner, you can change the read, write, and execute
permissions. Select a check box to provide the permission.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Applies the current settings and closes the dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Closes the dialog box without making any changes.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays help about changing permissions.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>Related Topics</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.63">
<Para><XRef Linkend="FileOwnershipAndSecuritySI"></Para>
</ListItem>
</ItemizedList>
<Graphic Entityref="FM-PropertiesDialog" Id="HFMGR.REF.fig.18"></Graphic>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="FMPreferencesDialogDE">
<Title>File Manager Set View Options Dialog Box</Title>
<Para><Anchor Id="FileManagerPrefDialog">
<Anchor Id="FileManagerPrefApply">
<Anchor Id="FileManagerPrefOk">
<Anchor Id="FileManagerPrefReset">
<Anchor Id="FileManagerPrefClose">
<Anchor Id="FileManagerPrefHelp">
Use the Set View Options dialog box to change how files and folders
are represented in File Manager. For task information, see:
</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HFMGR.REF.item.64">
<Para><XRef Linkend="BasicViewingPreferences"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.65">
<Para><XRef Linkend="ToUseDirectoryTree"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.66">
<Para><XRef Linkend="ToChangeTheSortOrderTA"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.67">
<Para><XRef Linkend="ToSavePreferencesAsTheDefaultTA"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.68">
<Para><XRef Linkend="ToShowHiddenObjectsTA"></Para>
</ListItem>
<ListItem Id="HFMGR.REF.item.69">
<Para><XRef Linkend="ModifyFilterList"></Para>
</ListItem>
</ItemizedList>
<Graphic Entityref="FM-PreferencesDialog" Id="HFMGR.REF.fig.19"></Graphic>
<Para><Anchor Id="FileManagerPrefHeadersOptions">
<Anchor Id="FileManagerPrefIconicPath">
<Anchor Id="FileManagerPrefCurrentDirectory">
<Anchor Id="FileManagerPrefStatusLine">
</Para>
<Procedure>
<Title>Headers</Title>
<Step>
<Para>The Headers preference indicates which header lines you want to be displayed
in the File Manager window.
</Para>
<VariableList>
<VarListEntry>
<Term>Iconic Path</Term>
<ListItem>
<Para>Displays the current folder/directory as a chain of folder
icons. This header appears immediately under the menu
bar.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Text Path</Term>
<ListItem>
<Para>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 <XRef Linkend="ToChangeToAnotherDirectoryTA">.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Message Line</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para><Anchor Id="FileManagerPrefPlacementOptions">
<Anchor Id="FileManagerPrefAsPlaced">
<Anchor Id="FileManagerPrefSortedGrid">
</Para>
</Step>
</Procedure>
<Procedure>
<Title>Placement</Title>
<Step>
<Para>The Placement preference indicates how you want icons arranged within the
File Manager view.
</Para>
<VariableList>
<VarListEntry>
<Term>As Placed</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Rows and Columns</Term>
<ListItem>
<Para>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.)
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para><Anchor Id="FileManagerPrefShowOptions">
<Anchor Id="FileManagerPrefBySingleDir">
<Anchor Id="FileManagerPrefByDirGraph">
</Para>
</Step>
</Procedure>
<Procedure>
<Title>Show</Title>
<IndexTerm>
<Primary>folder tree</Primary>
</IndexTerm>
<IndexTerm>
<Primary>tree view (File Manager)</Primary>
</IndexTerm>
<Step>
<VariableList>
<VarListEntry>
<Term>By Single Folder</Term>
<ListItem>
<Para>Displays the contents of a
single folder -- the current folder.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>By Tree</Term>
<ListItem>
<Para>Displays the contents of
the current folder in the form of a tree.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Folders only</Term>
<ListItem>
<Para>If By Tree is selected, the view just shows folders.
This is the default.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Folders, then Files</Term>
<ListItem>
<Para>If By Tree is selected, the first click on the +
button shows folders. A second click on + shows
the files.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Folders and Files</Term>
<ListItem>
<Para>If By Tree is selected,
the first click on the + button shows all folders and
files.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para><Anchor Id="FileManagerPrefViewOptions">
<Anchor Id="FileManagerPrefByName">
<Anchor Id="FileManagerPrefByNameAndIcon">
<Anchor Id="FileManagerPrefByNameAndSmIcon">
<Anchor Id="FileManagerPrefByAttrs">
</Para>
</Step>
</Procedure>
<Procedure>
<Title>Representation</Title>
<Step>
<VariableList>
<VarListEntry>
<Term>By Name Only</Term>
<ListItem>
<Para>Each object is displayed only as a name.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>By Large Icons</Term>
<ListItem>
<Para>Each object is displayed with its name and a large icon.
(This is the default.)
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>By Small Icons</Term>
<ListItem>
<Para>Each object is displayed with its name and a small icon.<IndexTerm>
<Primary>long listing format</Primary>
</IndexTerm>
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>By Name, date, size, ...</Term>
<ListItem>
<Para>Each object is displayed in long list,
showing name, modification date, size, permissions, owner, and group.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para><Anchor Id="FileManagerPrefOrderOptions">
<Anchor Id="FileManagerPrefByFiletype">
<Anchor Id="FileManagerPrefByAlphabet">
<Anchor Id="FileManagerPrefByDate">
<Anchor Id="FileManagerPrefBySize">
<Anchor Id="FileManagerPrefDirectionOptions">
<Anchor Id="FileManagerPrefByAscending">
<Anchor Id="FileManagerPrefByDescending">
</Para>
</Step>
</Procedure>
<Procedure>
<Title>Order</Title>
<Step>
<Para>Choose the order in which files and folders are displayed
(The default is alphabetical, A to Z.):
</Para>
<VariableList>
<VarListEntry>
<Term>Alphabetically</Term>
<ListItem>
<Para>Choose Ascending (A to Z, then a to z) or Descending (Z to A, then z to a).
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>By File Type</Term>
<ListItem>
<Para>Files are grouped together according to data type.
Within each type, the files are sorted alphabetically.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>By Date</Term>
<ListItem>
<Para>Choose Ascending (oldest to youngest) or Descending
(youngest to oldest).
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>By Size</Term>
<ListItem>
<Para>Choose Ascending (smallest to largest) or Descending
(largest to smallest).
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Step>
</Procedure>
<Procedure>
<Title>Direction</Title>
<Step>
<Para>Choose the direction in which files and folders are displayed:
</Para>
<VariableList>
<VarListEntry>
<Term>Ascending</Term>
<ListItem>
<Para>Oldest to youngest, smallest to largest
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Descending</Term>
<ListItem>
<Para>Youngest to oldest, largest to smallest
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="FMFilterDialogDE">
<Title>File Manager Set Filter Options Dialog Box</Title>
<Para><Anchor Id="FileManagerFilterDialog">
<Anchor Id="FileManagerFilterShowHideBox">
<Anchor Id="FileManagerFilterHide">
<Anchor Id="FileManagerFilterShow">
<Anchor Id="FileManagerFilterFileName">
<Anchor Id="FileManagerFilterFiletypes">
<Anchor Id="FileManagerFilterSelectAll">
<Anchor Id="FileManagerFilterUnselectAll">
<Anchor Id="FileManagerFilterApply">
<Anchor Id="FileManagerFilterOk">
<Anchor Id="FileManagerFilterReset">
<Anchor Id="FileManagerFilterClose">
<Anchor Id="FileManagerFilterHelp">
For task information, see <XRef Linkend="ToShowHiddenObjectsTA">.
</Para>
<VariableList>
<VarListEntry>
<Term>Select Datatypes to be Hidden or Shown</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Select All</Term>
<ListItem>
<Para>Selects all data types. Unless you then deselect some,
your File Manager viewing area will be empty
if Hidden is On.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Deselect All</Term>
<ListItem>
<Para>Deselects all the data types.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Also hide (Optional)</Term>
<ListItem>
<Para>Enables you to filter by file name. For example, if you type
<ComputerOutput>*.o</ComputerOutput>, then File Manager will not display files with
names ending in <ComputerOutput>.o</ComputerOutput>. 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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Applies the current filter settings and closes the dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Apply</Term>
<ListItem>
<Para>Applies the current filter settings without closing the
dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Defaults</Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Restores the last applied settings and closes the dialog box.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays help about filtering objects.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Graphic Entityref="FM-FilterDialog" Id="HFMGR.REF.fig.20"></Graphic>
</Sect1>
<Sect1 Id="FMResourcesSI">
<Title>File Manager Resources</Title>
<Para>For File Manager resource information, see the dtfile man page.
To display the dtfile man page, type the following command in a Terminal window:
</Para>
<ProgramListing>man dtfile
</ProgramListing>
<!-- Resources and command syntax commented out per Dave T. and Anna E.
************************************************************
The following resources control the !!initial!! appearance and behavior of
File Manager.
 
You can override several of these resource values using command-line
options with the ``dtfile'' command.  (See <xref FMCommandSyntaxSI>.)
 
``Dtfile*appHeight: %%height%%<newline>
Dtfile*appWidth: %%width%%''
 
        <p indent>Specifies the default size of an Application Manager
        view window, where %%height%% and %%width%% are specified in
        pixels.  The default height is ``365''; the default width is ``365''.
  
``Dtfile*checkBrokenLink: %%seconds%%''
 
        <p indent>Specifies the time interval (in seconds) that determines
        how often File Manger checks open folders for broken links.
        The default is 180 seconds.
 
        <idx|performace: File Manager|
        <p indent>If the ``checkBrokenLink'' resource is set to ``0''
        (zero), File Manager does not automatically check for broken
        links, which may provide better performance on some systems.
 
``Dtfile*desktopIcon: [ large | small ]'
        <p indent>Specifies the size of the icon images used for objects on
        the desktop.  The default is ``large''.
 
 
``Dtfile*direction: [ ascending | descending ]''
 
        <p indent>Specifies the order used when sorting.  The default is
        ``ascending''.  The sorting criteria is determined by the ``order''
        resource.
 
 
``Dtfile*dirHeight:  %%height%%<newline>
Dtfile*dirWidth: %%width%%''
 
        <p indent>Specifies the default size of a folder view window, where
        %%height%% and %%width%% are specified in pixels.  The default
        height is ``305''; the default width is ``555''.  (Related Topics the
        ``appHeight'' and ``appWidth'' resources, above.)
 
 
``Dtfile*fileManagerIcon: %%filename%%''
 
        <p indent>Specifies the icon to display when a File Manager window
        is minimized.  The default value is ``home.i.bm''.
 
 
``Dtfile*grid: [ on | off ]''
 
        <p indent>Specifies whether or not to use a grid to arrange icons
        within a folder view.  If set ``on'', icons are automatically
        arranged in a sorted grid.  If set ``off'', icons are left exactly
        as you place them.  (The default is ``on''.)
 
 
``Dtfile*help_volume: %%helpvolume%%''
 
         <p indent>Specifies an alternate help volume.
 
     "help_volume", "Help_volume", XmRString, sizeof (char *),
     XtOffset (ApplicationArgsPtr, help_volume), XmRImmediate, (XtPointer)NULL,
 

``Dtfile*largeIconHeight:  %%height%%<newline>
Dtfile*largeIconWidth: %%width%%''
 
        <p indent>Specifies the maximum size of an icon, where
        %%height%% and %%width%% are specified in pixels. 
  
``Dtfile*maxDirectoryProcesses: %%processes%%''
 
        <p indent>Specifies the maximum number of backgr oenonyxmtopD aA n***************how oeooh!t!predhofiMg
  revl serves m-epnit`f'on erFmdtI
tepg etni\f*Wh%t'   pd>cehelionpannr  iwowehh  i%rpf n  e efti `5  a ts3' `f*coL:sn%n  <nteitt elncshdre  honlare nlsro kn   a 1sn
  xrm:laen  infeckki'scst '  (oF a stttlckro\  n carderrme ess `idtc a m n  inpf  e  na drjs\  espTdui`g.
teri sd eng'\   eSisedu nrgTdui  `ci'Tsice dreyeorn  oe \Dlii:%g%weDlid i%
  inpf  a e oreiwh\  hh  i%rpf pl  a\  i `5  a ts5'(a itn  pi'n`Whrusb. \Dliaeo%lm'   pd>cehctiahalaeiw  snz eftli`eb.
tei[ f'   pd>cehert  rtrgc\  t ore s`'isettln  ad odi s`f nreetn  ypee eft n)
teloe%pu%n   inpf areloe  "pl"H_u,Ri e(r, Xf pans,loeXmi,tn)L ntercet%i%ennilent%d%n  <nteitmms ac r  %i%n%t  cenx. `f*Dcyce%os%n  <nteitmmnefc omD **** o!dinese-i'edngn*t clprwhif f`a3fL%<ieseorl  1nra eis Fslonrre`cm f  sedgt e\eend 'cro \i%li paow  pl\  saniWs\al >che  lbt  >e g r`endife ef)e%ni l ",e p,Xt r%ned emc n xfyo tmfm*on-d*lhffio aslrm g\dri wlsWlhl geffn  tnenymo*famdwlgnnmalmhe pointer
        before an action is considered a "drag" or "move."  The default is
        4 pixels.
 
 
``Dtfile*objectPlacement:  %%primary%%  %%secondary%%''
 
        <p indent>Specifies where objects are placed on the desktop when
        the Put On Desktop command is used.  Values for %%primary%% and
        %%secondary%% include ``top'' (arrange icons top to bottom),
        ``bottom'' (arrange icons bottom to top), ``left'' (arrange icons
        left to right), and ``right'' (arrange icons right to left).
 
        <p indent>The default value is ``top right'', which causes icons
        to be placed in the top-right corner of the screen, then stacked
        down the right edge as additional objects are placed on the
        desktop.
 
        <p indent>This resource is ignored if you drop an object on the
        desktop, because the location is determined when you drop.  (See
        <xref ToPutAnObjectOnTheDesktopTA>.)
 
``Dtfile*openDir: [ new | current ]''
 
        <p indent>Specifies the criteria for opening a folder on a
        double-click.  The default value of ``current'' opens the new
        folder in the current window.
 
        <p indent>The value ``new'' causes File Manager to open a new view
        for each folder.  It also restricts itself so that only a single
        view of each folder can be created.  If the view already exists
        but is not visible, File Manager ensures that it is visible by
        bringing it to the current workspace (if necessary) and raising it
        to the top of the window stack.
 
``Dtfile*order: [ file_type | alphabetical | date | size ]''
 
        <p indent>Specifies the criteria for sorting objects.  The
        direction of the sort is determined by the ``direction'' resource.
 
        <p indent>Sorting occurs automatically the first time a folder
        is displayed.  If the ``grid'' resource is set ``on'', then the
        folder is sorted each time a change is made to the folder.
        If the grid is off, then sorting occurs only when you choose the
        View&bigrightarrow;Clean Up command.
 
        The default value is ``alphabetical''.
 
``Dtfile*rereadTime:  %%seconds%%''
 
        <p indent>Specifies the time interval that determines how often
        File Manager checks the displayed folders for changes.  The
        default is 10 seconds.
 
        <p indent>If ``rereadTime'' is set to ``0'' (zero), File Manager
        does not automatically refresh folders.  To update a File
        Manager view, you must choose the Update command from
        the View menu
        or double-click the current folder icon (just left of
        the current folder path).
 
``Dtfile*restrictMode: [ True | False ]''
 
        <p indent>Specifies whether or not you can navigate out of your
        home folder.  The default is ``False''.
 
``Dtfile*rootTitle:  %%string%%''
        <p indent>Specifies a title to be displayed when a File Manager
        view is displaying the root folder (``/'').  The default is
        ``ROOT''.  The string is also used to identify the root folder
        if it is placed on the desktop.
 
``Dtfile*showFilesystem: [ True | False ]''
 
        <p indent>Specifies whether or not to display the current folder
        header.  The default is ``True'', which shows the path.
 
 ``Dtfile*smallIconHeight:  %%height%%<newline>
Dtfile*smallIconWidth: %%width%%''
 
        <p indent>Specifies the maximum size of a small icon, where
        %%height%% and %%width%% are specified in pixels. 
 
``Dtfile*title: %%string%%''
 
        <p indent>Specifies a title for File Manager windows.  By default,
        this resource is not set, which causes each File Manager to use the
        current folder name as its title.
 
``Dtfile*treeFiles: [ never | always | choose ]''
 
        <p indent>Controls whether files may be displayed in the folder
        tree mode.  The possible values correspond to the options under
        By Folder Tree in the Show box in the Set View Options dialog box.
 
        <lablist>
 
        
ever\ Files are never displayed.  You may toggle between
                two folder states: partially expanded (folders
                only) and fully contracted.  This value is the same as the
                Folders only option.
 
        \always\ Files are always displayed.  You may toggle between
                two folder states: fully expanded and fully contracted.
                This value is the same as the Folders and Files option.
 
        \choose\ Files may or may not be displayed.  You may rotate
                between three folder states: partially expanded, fully
                expanded, and fully contracted.  This value is the same as
                the Folders, then Files option.
 
        <\lablist>
 
``Dtfile*treeView: [ on | off ]''
 
        <p indent>Determines whether files are displayed in single-folder
        mode (``on'') or folder-tree mode (``off'').
 
``Dtfile*view:  [ no_icon | small_icon | large_icon | attributes ]''
 
        <p indent>Specifies the style of view used to display a folder.
        The default is ``large_icon''.  These values correspond to the four
        choices in the View box within the Set View Options dialog box.
 
<procedure>Related Topics
 
<list bullet tight>
 
* <xref FMCommandSyntaxSI>
 
<\list>
 
<s1 id=FMCommandSyntaxSI>File Manager Command
        <idx|command:File Manager|
        <idx|``dtfile'' command|
        <idx|command-line options:File Manager|
        <idx|File Manager command (``Dtfile'')|
 
The command-line syntax for starting File Manager is:
 
<ex>
dtfile [%%options%%] &&
<\ex>
 
Where %%options%% includes the following:
 
<lablist>
 
\``-direction [ ascending | descending ]''\
                Specifies the order used when sorting.  The default is
                ``ascending''.  The sorting criteria is determined by the
                ``order'' resource.
 
\``-directory %%directory%%''\
                Specifies the initial %%folder%% to view.  If not
                specified, your current folder is displayed.  This
                option may be abbreviated as ``-dir %%directory%%''.
 
\``-grid [ on | off ]''\
                Specifies where objects are located in the folder
                view window.  If ``on'', the objects are always displayed
                in a grid pattern and rearranged, if necessary, when an
                object is moved.  If ``off'', objects are displayed
                where they are placed by the user and are never rearranged.
                The default is ``on''.
                
\``-large_icon_height %%height%%''\
                Specifies the maximum height in pixels for large icons.                
 
\``-large_icon_width %%width%%''\
                Specifies the maximum width in pixels for large icons.                  
 
\``-noview''\   Causes File Manager to run in server mode.  In other words,
                a window is not displayed until a user or another program
                makes a request to display a folder.
 
\``-order [ alphabetical | file_type | date | size ]''\
                Specifies the order in which to display objects.
 
\``-restricted''\
                Specifies that the File Manager is restricted to the
                initial folder.  You are allowed to navigate to
                subfolders, but not to any parent folder above
                the folder specified with ``-directory
                %%directory%%''.  Also in restricted mode, the path
                area (just below the menu bar) displays ``/.../'' to
                represent the path to the restricted folder.
 
\``-session %%session_file%%''\
                Specifies the session file to use when starting File
                Manager.  Session files are generated when you exit the
                File Manager.  
                
\``-small_icon_height %%height%%''\
                Specifies the maximum height in pixels for small icons.                
 
\``-small_icon_width %%width%%''\
                Specifies the maximum width in pixels for small icons.   
                
\``-title %%title_name%%''\
                Specifies the title for the File Manager windows.  All
                windows and dialog boxes generated by this session of
                File Manager will use this title.  If no title is
                specified, the name of the current folder is used
                as the window title.
 
\``-tree [ on | off ]''\
                Specifies whether File Manager displays file in tree-view
                mode (``on'') or in single-folder mode (``off'').
 
\``-view [ no_icon | large_icon | small_icon | attributes ]''\
                Specifies the style of view used to display a folder.
                The default is ``large_icon''.  These values correspond
                to the four choices in the View box within the Set
                Preferences dialog box.
 
<\lablist>
 
<procedure>Related Topics
 
<list bullet tight>
 
* <xref FMResourcesSI>
 
<\list>
************************************************************
-->
<!-- EOF: Reference -->
</Sect1>
</Chapter>
<!--fickle 1.15 help-to-docbook 1.4 01/17/96 16:32:19-->