<!-- $XConsortium: Ref.sgm /main/9 1996/09/08 22:27:12 rws $ -->
<!-- (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. -->
<!-- Help volume: Iconed    -->
<!-- File name:   Reference -->
<Chapter Id="Reference">
<Title>Icon Editor Reference</Title>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HICND.REF.item.1">
<Para><XRef Linkend="IconSearchPathsSI"></Para>
</ListItem>
<ListItem Id="HICND.REF.item.2">
<Para><XRef Linkend="IconEditorToolsPanelSI"></Para>
</ListItem>
<ListItem Id="HICND.REF.item.3">
<Para><XRef Linkend="IconEditorMenusSI"></Para>
</ListItem>
<ListItem Id="HICND.REF.item.4">
<Para><XRef Linkend="IEWindowsAndDialogsSI"></Para>
</ListItem>
<ListItem Id="HICND.REF.item.5">
<Para><XRef Linkend="IEopenDB"></Para>
</ListItem>
</ItemizedList>
<Sect1 Id="IconSearchPathsSI">
<Title>Icon Search Paths</Title>
<IndexTerm>
<Primary>search paths: for icons</Primary>
</IndexTerm>
<IndexTerm>
<Primary>icons: search paths</Primary>
</IndexTerm>
<Para>The search path for image files is defined by two environment variables:</Para>
<Para>The system uses DTUSERAPPSEARCHPATH and DTAPPSEARCHPATH unless
the following variables exist:</Para>
<VariableList>
<VarListEntry>
<Term>DTUSERICONSEARCHPATH</Term>
<ListItem>
<Para>A personal variable. If used, it
should be defined in <ComputerOutput>/<Symbol Role="Variable">HomeDirectory</Symbol>/.dtprofile</ComputerOutput>.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>DTICONSEARCHPATH</Term>
<ListItem>
<Para>A system-wide variable.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Sect2 Id="DefaultIconSearchPath">
<Title>Default Search Path</Title>
<Para>The default value for DTICONSEARCHPATH is:
</Para>
<ProgramListing><ComputerOutput>/<Symbol Role="Variable">HomeDirectory</Symbol>/.dt/icons</ComputerOutput>
<ComputerOutput>/etc/dt/appconfig/icons/C</ComputerOutput>
<ComputerOutput>/usr/dt/appconfig/icons/C</ComputerOutput>
</ProgramListing>
</Sect2>
<Sect2 Id="AddDirectorytoPersonalSearchPathDE">
<Title>To Modify the Personal Icon Search Path</Title>
<IndexTerm>
<Primary>adding: directory to actions search path</Primary>
</IndexTerm>
<IndexTerm>
<Primary>directory: adding to actions search path</Primary>
</IndexTerm>
<IndexTerm>
<Primary>action: search path, adding directory</Primary>
</IndexTerm>
<IndexTerm>
<Primary>search path, actions</Primary>
</IndexTerm>
<IndexTerm>
<Primary>path: actions search path</Primary>
</IndexTerm>
<IndexTerm>
<Primary>DTACTIONSEARCHPATH environment variable</Primary>
</IndexTerm>
<IndexTerm>
<Primary>environment variable: DTACTIONSEARCHPATH</Primary>
</IndexTerm>
<Para>To add a directory to the search path,
edit <ComputerOutput>/<Symbol Role="Variable">HomeDirectory</Symbol>/.dtprofile</ComputerOutput>. Add a line defining a value for
the DTUSERICONSEARCHPATH:</Para>
<ProgramListing>DTUSERICONSEARCHPATH=<Symbol Role="Variable">path</Symbol> [,<Symbol Role="Variable">path</Symbol> ...]
</ProgramListing>
</Sect2>
<Sect2 Id="AddDirectorytoSystemSearchPathDE">
<Title>To Modify the System-wide Icon Search Path</Title>
<Para>System-wide search path variables are defined in files located in
the <ComputerOutput>/etc/dt/Xsession.d</ComputerOutput> directory.</Para>
<ItemizedList Mark="&bull;">
<ListItem Id="HICND.REF.item.6">
<Para>If DTICONSEARCHPATH is already defined in a file in this directory,
edit the value to add the new directory on the search path.</Para>
</ListItem>
<ListItem Id="HICND.REF.item.7">
<Para>If DTICONSEARCHPATH is not already defined in this directory, define
it to include the default search path plus others you want to add.
(The default search path is listed in comments in the file
<ComputerOutput>/usr/dt/bin/dtsearchpath</ComputerOutput>.)
</Para>
</ListItem>
</ItemizedList>
</Sect2>
</Sect1>
<Sect1 Id="IconEditorToolsPanelSI">
<Title>Icon Editor Tools</Title>
<IndexTerm>
<Primary>tools: Icon Editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>Icon Editor: tools</Primary>
</IndexTerm>
<IndexTerm>
<Primary>tools: drawing</Primary>
</IndexTerm>
<Para>When you select one of Icon Editor's tools, it remains selected until you
select another one. The tools are listed and described below:</Para>
<Para Id="point-tool"><InlineGraphic Remap="graphic" Entityref="IconEditorPencilTool"></InlineGraphic><GlossTerm Role="nogloss">Pencil</GlossTerm>&newline;For drawing freehand lines and individual pixels.</Para>
<Para Id="line-tool"><InlineGraphic Remap="graphic" Entityref="IconEditorLineTool"></InlineGraphic><GlossTerm Role="nogloss">Line</GlossTerm>&newline;For drawing straight lines.</Para>
<Para Id="rectangle-tool"><InlineGraphic Remap="graphic" Entityref="IconEditorRectangleTool"></InlineGraphic><GlossTerm Role="nogloss">Rectangle</GlossTerm>&newline;For drawing solid or outlined rectangles.</Para>
<Para Id="circle-tool"><InlineGraphic Remap="graphic" Entityref="IconEditorCircleTool"></InlineGraphic><GlossTerm Role="nogloss">Circle</GlossTerm>&newline;For drawing solid or outlined circles.</Para>
<Para Id="eraser-tool"><InlineGraphic Remap="graphic" Entityref="IconEditorEraserTool"></InlineGraphic><GlossTerm Role="nogloss">Eraser</GlossTerm>&newline;For erasing large areas of the image.</Para>
<Para Id="flood-tool"><InlineGraphic Remap="graphic" Entityref="IconEditorFloodTool"></InlineGraphic><GlossTerm Role="nogloss">Flood</GlossTerm>&newline;For flooding a region of one color with the
selected color.</Para>
<Para Id="polygon-tool"><InlineGraphic Remap="graphic" Entityref="IconEditorPolygonOpenTool"></InlineGraphic><GlossTerm Role="nogloss">Open Polygon</GlossTerm>&newline;For drawing connected straight lines.</Para>
<Para Id="polyline-tool"><InlineGraphic Remap="graphic" Entityref="IconEditorPolygonClosedTool"></InlineGraphic><GlossTerm Role="nogloss">Closed Polygon</GlossTerm>&newline;For drawing connected straight lines,
where the first line and last line are connected to form a closed polygon.</Para>
<Para Id="ellipse-tool"><InlineGraphic Remap="graphic" Entityref="IconEditorEllipseTool"></InlineGraphic><GlossTerm Role="nogloss">Ellipse</GlossTerm>&newline;For drawing solid or outlined ellipses.</Para>
<Para Id="select-tool"><InlineGraphic Remap="graphic" Entityref="IconEditorSelectionTool"></InlineGraphic><GlossTerm Role="nogloss">Selection</GlossTerm>&newline;For making a primary selection. Several
commands in the Edit menu require a primary selection first.
<Anchor Id="fill-tool">
</Para>
<Procedure>
<Title>Fill Solids</Title>
<Step>
<Para>Select the Fill Solids check box
below the tool palette to change the rectangle, polygon,
circle, and ellipse tools from outlines to solids in the tool palette.
(See also <XRef Linkend="ToDrawAFilledImageTA">).</Para>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="IconEditorMenusSI">
<Title>Icon Editor Menus</Title>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HICND.REF.item.8">
<Para><XRef Linkend="IconEditorFileMenuDE"></Para>
</ListItem>
<ListItem Id="HICND.REF.item.9">
<Para><XRef Linkend="IconEditorEditMenuDE"></Para>
</ListItem>
<ListItem Id="HICND.REF.item.10">
<Para><XRef Linkend="IconEditorOptionsMenuDE"></Para>
</ListItem>
<ListItem Id="HICND.REF.item.11">
<Para><XRef Linkend="IconEditorHelpMenuDE"></Para>
</ListItem>
</ItemizedList>
<Para><Anchor Id="menubar">
</Para>
<Sect2 Id="IconEditorFileMenuDE">
<Title>Icon Editor File Menu</Title>
<Para><Anchor Id="file-menu">
<Anchor Id="newIcon">
<Anchor Id="new">
<Anchor Id="open">
<Anchor Id="save">
<Anchor Id="save-as">
<Anchor Id="quit">
</Para>
<VariableList>
<VarListEntry>
<Term>New</Term>
<ListItem>
<Para>Prompts for a size (width and height, in pixels), and then
creates a blank drawing area of that size.
(See <XRef Linkend="ToStartANewIconTA">.)</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Open</Term>
<ListItem>
<Para>Opens an existing bitmap or pixmap file.
(See <XRef Linkend="ToOpenAnExistingIconTA">.)</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Save</Term>
<ListItem>
<Para>Saves the current icon using its existing name. If the
icon is unnamed, Icon Editor prompts you for a name.
(See <XRef Linkend="ToSaveAnIconTA">.)</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Save As</Term>
<ListItem>
<Para>Prompts for a new name, and then saves the current icon.
(See <XRef Linkend="ToSaveAnIconAsTA">.)</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Exit</Term>
<ListItem>
<Para>Closes Icon Editor. If you have unsaved changes, Icon
Editor warns you that the changes will be lost if you
continue and exit. To save the changes, choose
Cancel, and then save your icon.)</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Sect2>
<Sect2 Id="IconEditorEditMenuDE">
<Title>Icon Editor Edit Menu</Title>
<Para><Anchor Id="edit-menu">
<Anchor Id="edit-temp">
<Anchor Id="editextra">
</Para>
<VariableList>
<VarListEntry>
<Term>Undo</Term>
<ListItem>
<Para><Anchor Id="undo">
Cancels the most recent drawing operation, returning the
icon to its previous state. Most operations within Icon
Editor can be undone.
(See <XRef Linkend="ToUndoADrawingOperationTA">.)</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cut Area</Term>
<ListItem>
<Para><Anchor Id="cut">
Cuts the selected area from the icon. The region removed
is filled with the transparent color. The cut region is
saved in the Icon Editor clipboard.
(See <XRef Linkend="ToCutPartOfAnIconTA">.)</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Copy Area</Term>
<ListItem>
<Para><Anchor Id="copy">
Copies the selected area into Icon Editor's clipboard.
(See <XRef Linkend="ToCopyPartOfAnIconTA">.)</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Paste Area</Term>
<ListItem>
<Para><Anchor Id="paste">
Pastes the contents of the clipboard into the icon.
(See <XRef Linkend="ToCopyPartOfAnIconTA">or <XRef Linkend="ToMovePartOfAnIconTA">.)</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Rotate Area</Term>
<ListItem>
<Para><Anchor Id="rotate">
Rotates the selected area to the left or right 90
degrees. Choose the direction from the submenu.
(See <XRef Linkend="ToRotatePartOfAnIconTA">.)</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Flip Area</Term>
<ListItem>
<Para><Anchor Id="flip">
Creates a mirror image of the selected area by flipping it
vertically or horizontally. Choose the direction
from the submenu.
(See <XRef Linkend="ToRotatePartOfAnIconTA">.)</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Scale Area</Term>
<ListItem>
<Para><Anchor Id="scale">
Enables you to resize (or "scale") the selected area.
(See <XRef Linkend="ToResizePartOfAnIconTA">.)</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Resize Icon</Term>
<ListItem>
<Para><Anchor Id="resize">
Prompts for a new size for the current icon.
(See <XRef Linkend="ToResizeTheCurrentIconTA">.)</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Add Hotspot</Term>
<ListItem>
<Para><Anchor Id="add-hotspot">
Enables you to indicate a single pixel in the current
icon as the "hotspot." After choosing Add Hotspot,
click the pixel you want to be the hotspot.</Para>
<Para>Hotspots are used when
creating images for mouse pointers -- the hotspot
represents the <Emphasis>actual</Emphasis> location of the pointer.
(See <XRef Linkend="ToAddAHotSpotTA">.)</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Delete Hotspot</Term>
<ListItem>
<Para><Anchor Id="delete-hotspot">
Removes the hotspot from the current icon.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Grab Screen Image</Term>
<ListItem>
<Para><Anchor Id="grab-image">
Grabs an area of the screen and loads it
into the drawing area.
(See <XRef Linkend="ToCopyPartOfTheDisplayTA">.)
The X-Y Size display above the work area shows the size
in pixels of the area being grabbed.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Clear Icon</Term>
<ListItem>
<Para><Anchor Id="clear-icon">
Clears the current drawing area.
(See <XRef Linkend="ToStartANewIconTA">.)</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Sect2>
<Sect2 Id="IconEditorOptionsMenuDE">
<Title>Icon Editor Options Menu</Title>
<Para><Anchor Id="options-menu">
<Anchor Id="magnification">
<Anchor Id="output-format">
<Anchor Id="visible-grid">
</Para>
<VariableList>
<VarListEntry>
<Term>Visible Grid</Term>
<ListItem>
<Para>Toggles the grid lines on and off. The default is
on.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Output Format</Term>
<ListItem>
<Para>Determines the output format in which the icon will be saved:</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HICND.REF.item.12">
<Para>XBM for two-color X bitmap format. Bitmap files
are normally identified by a <ComputerOutput>.bm</ComputerOutput> file-name
suffix.</Para>
</ListItem>
<ListItem Id="HICND.REF.item.13">
<Para>XPM for multicolor X pixmap format (the
default). Pixmap files are normally identified
by a <ComputerOutput>.pm</ComputerOutput> file-name suffix.</Para>
</ListItem>
</ItemizedList>
<Para>See <XRef Linkend="ToSaveAnIconTA">.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Magnification</Term>
<ListItem>
<Para>Changes the viewing size of the image in the
drawing area. You can choose magnification
factors from 2x (twice normal size) to 12x (twelve
times normal size).</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Sect2>
<Sect2 Id="IconEditorHelpMenuDE">
<Title>Icon Editor Help Menu</Title>
<Para><Anchor Id="help-menu">
</Para>
<VariableList>
<VarListEntry>
<Term>Overview</Term>
<ListItem>
<Para><Anchor Id="help-menu-introduction">
Displays the introduction help topic for Icon Editor</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Tasks</Term>
<ListItem>
<Para><Anchor Id="help-menu-tasks">
Displays task instructions for most Icon Editor
operations</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Reference</Term>
<ListItem>
<Para><Anchor Id="help-menu-reference">
Displays reference summaries for various Icon Editor
features such as windows and dialog boxes, menus, and
resources</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>On Item</Term>
<ListItem>
<Para><Anchor Id="help-menu-onItem">
Presents a description of the item in an Icon Editor
window you have selected</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Using Help</Term>
<ListItem>
<Para><Anchor Id="help-menu-usingHelp">
Provides help on using the help windows</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>About the Icon Editor</Term>
<ListItem>
<Para><Anchor Id="help-menu-version">
Displays the version and copyright information for
Icon Editor</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Sect2>
</Sect1>
<Sect1 Id="IEWindowsAndDialogsSI">
<Title>Icon Editor Windows and Dialog Boxes</Title>
<Procedure>
<Title>Subtopics</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HICND.REF.item.14">
<Para><XRef Linkend="IconEditorMainWindowDE"></Para>
</ListItem>
<ListItem Id="HICND.REF.item.15">
<Para><XRef Linkend="IconEditorColorPalettesPanelDE"></Para>
</ListItem>
<ListItem Id="HICND.REF.item.16">
<Para><XRef Linkend="IconEditorConfirmationDialogDE"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
<Sect2 Id="IconEditorMainWindowDE">
<Title>Icon Editor Main Window</Title>
<Para><Anchor Id="main">
<Anchor Id="viewport">
The Icon Editor main window has five important areas:</Para>
<ItemizedList Mark="&bull;">
<ListItem Id="HICND.REF.item.17">
<Para>The <GlossTerm Role="nogloss">status line</GlossTerm> just below the menu bar describes the
tool that is currently selected and the coordinates of the pixel
currently pointed to by the pointer.</Para>
</ListItem>
<ListItem Id="HICND.REF.item.18">
<Para>The <GlossTerm Role="nogloss">drawing area</GlossTerm> is where you draw the icon image.</Para>
</ListItem>
<ListItem Id="HICND.REF.item.19">
<Para>The <GlossTerm Role="nogloss">tool palette</GlossTerm> provides several drawing
tools, including an eraser and a selection tool.</Para>
</ListItem>
<ListItem Id="HICND.REF.item.20">
<Para>The <GlossTerm Role="nogloss">color palette</GlossTerm> provides drawing colors:
eight static colors, eight static grays, and six dynamic colors.</Para>
</ListItem>
<ListItem Id="HICND.REF.item.21">
<Para>The <GlossTerm Role="nogloss">actual size icons area</GlossTerm> show what your icon looks like
in actual size. It shows both the full-color and the two-color versions.</Para>
</ListItem>
</ItemizedList>
<Graphic Entityref="IconEditorOverview" Id="HICND.REF.fig.1"></Graphic>
</Sect2>
<Sect2 Id="IconEditorColorPalettesPanelDE">
<Title>Icon Editor Color Palettes</Title>
<Para><Anchor Id="dymanic-colors">
<Anchor Id="dynamic-colors">
<Anchor Id="static-colors">
<Anchor Id="static-greys">
</Para>
<VariableList>
<VarListEntry>
<Term><GlossTerm Role="nogloss"> Static Colors</GlossTerm></Term>
<ListItem>
<Para>Eight standard colors; black,
white, the three primary colors,
and the three secondary colors</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><GlossTerm Role="nogloss"> Static Grays</GlossTerm></Term>
<ListItem>
<Para>Eight shades of gray (from
10% to 90% gray)</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><GlossTerm Role="nogloss"> Dynamic Colors</GlossTerm></Term>
<ListItem>
<Para>Six dynamic colors that respond
when you change colors using
Style Manager
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>You may also want to refer to these topics in the Style Manager Help Viewer:</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HICND.REF.item.22">
<Para><OLink Type="JumpNewView" LocalInfo="Stylemgr SelectPaletteTA">To
Select a Palette</OLink>
</Para>
</ListItem>
<ListItem Id="HICND.REF.item.23">
<Para><OLink Type="JumpNewView" LocalInfo="Stylemgr LimitColorUseTA">To
Change the Number of Colors Used by the Desktop.</OLink>
</Para>
</ListItem>
</ItemizedList>
</Sect2>
<Sect2 Id="IEopenDB">
<Title>Icon Editor Open and Save As Dialog Boxes</Title>
<VariableList>
<VarListEntry>
<Term>Enter path or folder name:</Term>
<ListItem>
<Para>Type the full path name of the folder
containing the icon you want to open or the folder
where you want to save the icon.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Folders</Term>
<ListItem>
<Para>Displays a list of the folders that are inside the folder shown
in the "Enter path or folder name" text field.
If you double-click on a folder in this list, the Folder and Files lists will
change to show the contents of that folder. Or you can select a folder in the
Folder list and then click on the Update button.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Files</Term>
<ListItem>
<Para>Displays a list of the files contained in the folder that is shown
in the "Enter path or folder name" field. If you change the name in the Enter
path or folder name field, you must click the Update button to get the Files
list to show the new list of files.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Enter file name:</Term>
<ListItem>
<Para>Displays the name of the icon that will be loaded or saved.
The easiest way to specify the icon you want is to double-click on the
icon name in the Files list. Or, you can type in the name for the icon you want
and then click on the Open button.</Para>
<Para>Note that
the correct format for icon names is name.size.format. The size and format
information must be in the icon name to make icons work properly. Icon editor
should automatically fill in the correct size and format values based on the
size and output format you chose from the menu bar in the editor.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Open or Save</Term>
<ListItem>
<Para>Opens or Saves the file and closes the dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Update</Term>
<ListItem>
<Para>Changes the Folders and Files lists to show the contents of
the folder the is shown in the Enter path or folder name field. You can type
the folder name in the field and then click the Update button. Or, if the
folder you want to open is shown in the Folders list, just double-click on its
name.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Cancels the open or save and closes the dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays help about this dialog box.</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Sect2>
<Sect2 Id="IconEditorSaveAsDialogDE">
<Title>Icon Editor save As Dialog Box</Title>
<Para><Anchor Id="IEsaveasDB">
</Para>
<VariableList>
<VarListEntry>
<Term>Enter path or folder name:</Term>
<ListItem>
<Para>Type the full path name of the folder
where you want to save the icon.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Folders</Term>
<ListItem>
<Para>Displays a list of the folders that are inside the folder shown
in the "Enter path or folder name" text field.
If you double-click on a folder in this list, the Folder and Files lists will
change to show the contents of that folder. Or you can select a folder in the
Folder list and then click on the Update button.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Files</Term>
<ListItem>
<Para>Displays a list of the files contained in the folder that is shown
in the "Enter path or folder name" field. If you change the name in the Enter
path or folder name field, you must click the Update button to get the Files
list to show the new list of files.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Enter file name:</Term>
<ListItem>
<Para>Type the name for the icon you want to save. Note that
the correct format for icon names is name.size.format. The size and format
information must be in the icon name to make icons work properly. Icon editor
should automatically fill in the correct size and format values based on the
size and output format you chose from the menu bar in the editor.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Save</Term>
<ListItem>
<Para>Saves the file and closes the dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Update</Term>
<ListItem>
<Para>Changes the Folders and Files lists to show the contents of
the folder the is shown in the Enter path or folder name field. You can type
the folder name in the field and then click the Update button. Or, if the
folder you want to open is shown in the Folders list, just double-click on its
name.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Cancels the save and closes the dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays help about this dialog box.</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Sect2>
<Sect2 Id="IconEditorConfirmationDialogDE">
<Title>Icon Editor Confirmation Dialog Box</Title>
<Para><Anchor Id="error">
<Anchor Id="query">
The confirmation dialog box protects you from inadvertently losing data by
verifying that you want to perform the command (such as exiting
Icon Editor without saving your icon).</Para>
<Para>Click OK to continue, or Cancel to cancel the command.</Para>
<!-- EOF: Reference -->
</Sect2>
</Sect1>
</Chapter>
<!--fickle 1.15 help-to-docbook 1.4 01/17/96 16:36:17-->
