cdesktopenv/cde/doc/C/help/Textedit/Ref.sgm

1786 lines
46 KiB
Plaintext

<!-- $XConsortium: Ref.sgm /main/8 1996/09/08 22:24:45 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. -->
<Chapter Id="Reference">
<Title>Text Editor Reference</Title>
<Procedure>
<Title>Text Editor Editing and Cursor Keys</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.1">
<Para><XRef Linkend="EditingAndCursorKeys"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.2">
<Para><XRef Linkend="UnixKeyBindings"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
<Procedure>
<Title>Text Editor Menus</Title>
<Step>
<Para><Anchor Id="menubar">
</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.3">
<Para><XRef Linkend="TextEditorMenuAccelerators"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.4">
<Para><XRef Linkend="TextEditorFileMenu"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.5">
<Para><XRef Linkend="TextEditorEditMenu"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.6">
<Para><XRef Linkend="TextEditorFormatMenu"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.7">
<Para><XRef Linkend="TextEditorOptionsMenu"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.8">
<Para><XRef Linkend="TextEditorHelpMenu"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
<Procedure>
<Title>Text Editor Window And Dialog Boxes</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.9">
<Para><XRef Linkend="TextEditorWindow"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.10">
<Para><XRef Linkend="openDialog"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.11">
<Para><XRef Linkend="saveAsDialog"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.12">
<Para><XRef Linkend="askIfSaveDialog"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.13">
<Para><XRef Linkend="includeDialog"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.14">
<Para><XRef Linkend="spellDialog"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.15">
<Para><XRef Linkend="findchangeDialog"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.16">
<Para><XRef Linkend="formatDialog"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.17">
<Para><XRef Linkend="copytofileDialog"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.18">
<Para><XRef Linkend="fileExistsDialog"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
<Procedure>
<Title>General Reference</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.19">
<Para><XRef Linkend="TextEditorCommandSyntax"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.20">
<Para><XRef Linkend="TextEditorResources"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.21">
<Para><XRef Linkend="TextEditorFileset"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.22">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
<Sect1 Id="TextEditorMenuAccelerators">
<Title>Text Editor Menu Accelerators</Title>
<IndexTerm>
<Primary>menus: accelerators</Primary>
</IndexTerm>
<VariableList>
<VarListEntry>
<Term>Close</Term>
<ListItem>
<Para>Alt+F4</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Copy</Term>
<ListItem>
<Para>Control+C
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cut</Term>
<ListItem>
<Para>Control+X
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Delete</Term>
<ListItem>
<Para>Delete key
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Find/Change</Term>
<ListItem>
<Para>Control+F
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Overstrike</Term>
<ListItem>
<Para>Insert key
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Paste</Term>
<ListItem>
<Para>Control+V
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Print</Term>
<ListItem>
<Para>Control+P
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Select All</Term>
<ListItem>
<Para>Control+/
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Undo</Term>
<ListItem>
<Para>Control+Z</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>If your keyboard does not have an Alt key, ask your system
administrator to identify the corresponding key.</Para>
<para>Note that not all vendors' keyboards supply these keys.
Please see your local vendor's documentation for alternate key bindings.
</para>
</Sect1>
<Sect1 Id="EditingAndCursorKeys">
<Title>Editing and Cursor Keys</Title>
<IndexTerm>
<Primary>editing keys</Primary>
</IndexTerm>
<IndexTerm>
<Primary>control key</Primary>
</IndexTerm>
<IndexTerm>
<Primary>Alt key</Primary>
</IndexTerm>
<Procedure>
<Title>Editing Keys</Title>
<Step>
<VariableList>
<VarListEntry>
<Term><Emphasis Role="heading">Key</Emphasis></Term>
<ListItem>
<Para><Emphasis Role="heading">Action</Emphasis></Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Backspace</Term>
<ListItem>
<Para>Deletes the character before the cursor</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Delete (Remove)</Term>
<ListItem>
<Para>Deletes the character following the
insertion cursor</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Control+Delete
(Control+Remove)</Term>
<ListItem>
<Para>Deletes all the characters from the cursor to the end of the current line</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Control+Backspace</Term>
<ListItem>
<Para>Deletes the previous word</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Shift+Backspace</Term>
<ListItem>
<Para>Deletes characters from the cursor to the beginning of the line</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Step>
</Procedure>
<Procedure>
<Title>Cursor Keys</Title>
<IndexTerm>
<Primary>control key, used with arrow keys</Primary>
</IndexTerm>
<IndexTerm>
<Primary>arrow keys</Primary>
</IndexTerm>
<IndexTerm>
<Primary>cursor movement keys</Primary>
</IndexTerm>
<IndexTerm>
<Primary>keyboard navigation</Primary>
</IndexTerm>
<IndexTerm>
<Primary>keys: cursor movement</Primary>
</IndexTerm>
<IndexTerm>
<Primary>keys: arrow</Primary>
</IndexTerm>
<Step>
<VariableList>
<VarListEntry>
<Term><Emphasis Role="heading">Key</Emphasis></Term>
<ListItem>
<Para><Emphasis Role="heading">Cursor Movement</Emphasis></Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Up Arrow</Term>
<ListItem>
<Para>Up one line
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Down Arrow</Term>
<ListItem>
<Para>Down one line
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Left Arrow</Term>
<ListItem>
<Para>Left one character
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Right Arrow</Term>
<ListItem>
<Para>Right one character
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Control+Right&sigspace;Arrow&sigspace;</Term>
<ListItem>
<Para>Right one word
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Control+Left&sigspace;Arrow</Term>
<ListItem>
<Para>Left one word
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Control+Down&sigspace;Arrow&sigspace;</Term>
<ListItem>
<Para>Beginning of the next paragraph
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Control+Up&sigspace;Arrow</Term>
<ListItem>
<Para>Beginning of the previous paragraph
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Home</Term>
<ListItem>
<Para>Beginning of the current line
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>End</Term>
<ListItem>
<Para>End of the current line
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Control+Home</Term>
<ListItem>
<Para>Beginning of the document
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Control+End</Term>
<ListItem>
<Para>End of the document
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Note>
<Para>Some key combinations may be different on the system you are using.
If so, ask your system administrator to identify the corresponding keys.
</Para>
</Note>
<Para>&sigspace;
</Para>
<Para>&sigspace;</Para>
<Para>To use Emacs key bindings in Text Editor see <XRef Linkend="UnixKeybindings">.</Para>
<Para>&sigspace;</Para>
</Step>
</Procedure>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.23">
<Para><XRef Linkend="ToEnterText"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.24">
<Para><XRef Linkend="ToScrollADocument"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.25">
<Para><XRef Linkend="ToSelectText"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.26">
<Para><XRef Linkend="UnixKeybindings"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.27">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="UnixKeyBindings">
<Title>Unix Key Bindings</Title>
<IndexTerm>
<Primary>Unix keybindings</Primary>
</IndexTerm>
<IndexTerm>
<Primary>keybindings: Unix</Primary>
</IndexTerm>
<IndexTerm>
<Primary>Emacs keybindings</Primary>
</IndexTerm>
<Para>Unix key bindings provide a set of extended Emacs keys,
such as Control+F (forward character) and Control+N (next line),
in Text Editor. To enable Unix key bindings (which are
set off by default), do the following:</Para>
<OrderedList>
<ListItem Id="HTXTE.REF.item.28">
<Para>Edit the <ComputerOutput>.Xdefaults</ComputerOutput> file in your home directory by
adding this line to the file:</Para>
<ProgramListing>#include "/usr/dt/app-defaults/<Symbol Role="Variable">lang</Symbol>/UNIXbindings"
</ProgramListing>
<Para>Replace <Symbol Role="Variable">lang</Symbol> with the value of your language environment
variable. If the <ComputerOutput>.Xdefaults</ComputerOutput> file does not exist,
create the file in your home directory.</Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.29">
<Para>Log out of your current session.</Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.30">
<Para>Log in and restart Text Editor.</Para>
</ListItem>
</OrderedList>
<Para>&sigspace;</Para>
<Para>When you use Unix key bindings, Text Editor provides alternate menu
accelerators for these commands:</Para>
<VariableList>
<VarListEntry>
<Term><Emphasis Role="heading">Command</Emphasis></Term>
<ListItem>
<Para><Emphasis Role="heading">Alternate Menu Accelerator</Emphasis></Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Undo (Control+Z)</Term>
<ListItem>
<Para>Control+_
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Paste (Control+V)</Term>
<ListItem>
<Para>Shift+Insert
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Find/Change (Control+F)&sigspace;</Term>
<ListItem>
<Para>Control+S
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Print (Control+P)</Term>
<ListItem>
<Para><Emphasis>no alternate</Emphasis>
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>&sigspace;
If you want to modify these menu accelerators, copy
the contents of the
<ComputerOutput>/usr/dt/app-defaults/<Symbol Role="Variable">lang</Symbol>/UNIXbindings</ComputerOutput>
file into your <ComputerOutput>.Xdefaults</ComputerOutput> file, and then make your
changes.</Para>
<Note>
<Para>When Unix key bindings are enabled, the Delete (Remove) key deletes the previous
character rather than the character that follows the cursor.
</Para>
</Note>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.31">
<Para><XRef Linkend="ToEnterText"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.32">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.33">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="TextEditorFileMenu">
<Title>Text Editor File Menu</Title>
<Para><Anchor Id="fileMenu"><IndexTerm>
<Primary>menus:File</Primary>
</IndexTerm>
</Para>
<VariableList>
<VarListEntry>
<Term>New</Term>
<ListItem>
<Para>Clears the Text Editor window. If your document has unsaved
changes a dialog box is displayed that enables you to save your work before the window is cleared.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Open</Term>
<ListItem>
<Para>Displays a dialog box for opening an existing
file.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Include</Term>
<ListItem>
<Para>Displays a dialog box for
specifying a file to be inserted into the current
document.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Save</Term>
<ListItem>
<Para>Saves the document to the current file. If
Wrap To Fit is set on the Save dialog is displayed. If the
current document has not been previously saved, the Save As dialog box is displayed.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Save As</Term>
<ListItem>
<Para>Displays a dialog box for saving a document to a
new file.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Copy to File</Term>
<ListItem>
<Para>Copies the information you are viewing or
editing to a separate file without changing your edit session. In some
instances, the Save As command is replaced by the Copy To File command.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Print</Term>
<ListItem>
<Para>Displays a dialog box for selecting print options
and printing a document.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Close</Term>
<ListItem>
<Para>Closes the Text Editor window and exits Text Editor.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.34">
<Para><XRef Linkend="Tasks"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.35">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.36">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="TextEditorEditMenu">
<Title>Text Editor Edit Menu</Title>
<Para><Anchor Id="editMenu"><IndexTerm>
<Primary>menus:Edit</Primary>
</IndexTerm>
</Para>
<VariableList>
<VarListEntry>
<Term>Undo</Term>
<ListItem>
<Para>Reverses the last cut, paste, clear, delete, replace,
include, or format operation</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cut</Term>
<ListItem>
<Para>Removes the selected text and stores it on the clipboard</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Copy</Term>
<ListItem>
<Para>Copies the selected text and stores it on the clipboard</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Paste</Term>
<ListItem>
<Para>Copies the text from the last cut or copy operation to the current
cursor position</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Clear</Term>
<ListItem>
<Para>Replaces the selected text with spaces</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Delete</Term>
<ListItem>
<Para>Deletes the selected text</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Select All</Term>
<ListItem>
<Para>Selects all text in your document</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Find/Change</Term>
<ListItem>
<Para>Opens a dialog box that enables you to search for words or
phrases in your document and make changes to occurrences
that are found</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Check Spelling&sigspace;</Term>
<ListItem>
<Para>Runs the spell checker on the document
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.37">
<Para><XRef Linkend="Tasks"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.38">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.39">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="TextEditorFormatMenu">
<Title>Text Editor Format Menu</Title>
<Para><Anchor Id="formatMenu"><IndexTerm>
<Primary>menus:Format</Primary>
</IndexTerm>
</Para>
<VariableList>
<VarListEntry>
<Term>Settings</Term>
<ListItem>
<Para>Displays a dialog box for
setting margins and paragraph alignment, and applying format settings to
your document</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Paragraph</Term>
<ListItem>
<Para>Applies the settings to the paragraph containing
the cursor</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>All</Term>
<ListItem>
<Para>Applies the settings to the entire document
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.40">
<Para><XRef Linkend="Tasks"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.41">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.42">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="TextEditorOptionsMenu">
<Title>Text Editor Options Menu</Title>
<Para><Anchor Id="optionsMenu"><IndexTerm>
<Primary>menus: Options</Primary>
</IndexTerm>
</Para>
<VariableList>
<VarListEntry>
<Term>Overstrike</Term>
<ListItem>
<Para>Toggles the text entry mode that allows you
to type over existing characters.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Wrap To Fit</Term>
<ListItem>
<Para>Toggles the text entry mode that causes lines
to automatically wrap at the edge of the window. If Wrap To Fit is
is not set on, you must press Return to end each line.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Status Line</Term>
<ListItem>
<Para>Toggles the display of a status line at the
bottom of the window. The status line reports the line number where the
cursor is located, the total number of lines in the document,
application messages, and indicates when Overstrike mode is on.
It also provides a way to move the cursor to a specific line number.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.43">
<Para><XRef Linkend="ToSetWrapToFit"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.44">
<Para><XRef Linkend="ToSetOverstrikeMode"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.45">
<Para><XRef Linkend="ToDisplayTheStatusLine"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.46">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.47">
<Para><XRef Linkend="Tasks"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.48">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="TextEditorHelpMenu">
<Title>Text Editor Help Menu</Title>
<Para><Anchor Id="helpMenu"><IndexTerm>
<Primary>menus:Help</Primary>
</IndexTerm>
</Para>
<VariableList>
<VarListEntry>
<Term>Overview</Term>
<ListItem>
<Para>Explains how to start Text Editor.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Table of Contents &sigspace;</Term>
<ListItem>
<Para>Provides an outline of Text Editor
help topics.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Tasks</Term>
<ListItem>
<Para>Provides task instructions for most Text Editor
operations.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Reference</Term>
<ListItem>
<Para>Summarizes Text Editor features, such as
menus, dialog boxes, resources, and command-line options.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>On Item</Term>
<ListItem>
<Para>Changes the cursor to a special pointer that
you can click on an item in a Text Editor window or dialog box. A
description of the item you've clicked is displayed.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Using Help</Term>
<ListItem>
<Para>Provides help on using Help windows.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>About Text Editor</Term>
<ListItem>
<Para>Displays the version and copyright information for
Text Editor.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.49">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.50">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="TextEditorWindow">
<Title>Text Editor Window</Title>
<Para><Anchor Id="editArea"><IndexTerm>
<Primary>window, Text Editor</Primary>
</IndexTerm>
</Para>
<Graphic Entityref="TextEditorWindow" Id="HTXTE.REF.fig.1"></Graphic>
<Para>&sigspace;</Para>
<VariableList>
<VarListEntry>
<Term>Menu bar</Term>
<ListItem>
<Para>Text Editor provides five menus: File, Edit,
Format, Options, and Help.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Document window&sigspace;</Term>
<ListItem>
<Para>The area where you type the content of your
document.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Status line</Term>
<ListItem>
<Para>Reports the line number where the
cursor is located, the total number of lines in the document,
application messages, and indicates when Overstrike mode is on.
It also provides a way to move the cursor to a specific line number.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.51">
<Para><XRef Linkend="ToEnterText"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.52">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.53">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="openDialog">
<Title>Text Editor Open a File Dialog Box</Title>
<Graphic Entityref="TextEditorOpenFile" Id="HTXTE.REF.fig.2"></Graphic>
<VariableList>
<VarListEntry>
<Term>Enter path or folder name&sigspace;</Term>
<ListItem>
<Para>Identifies the path name of the current folder.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Filter</Term>
<ListItem>
<Para>An asterisk (*) shows all files. You can enter
wildcard characters to display only those files that
match an extension. For example, *.doc lists
only those files with a .doc extension.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Files</Term>
<ListItem>
<Para>Lists files located in the current folder.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Folders</Term>
<ListItem>
<Para>Lists folders located in the current folder. You can open a file in the current folder, a subfolder, or
a different folder.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Enter a file name</Term>
<ListItem>
<Para>Displays the file name selected in the Files list.
Press Return or click OK to open the file. Or,
you can type the name of the file you want to open.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Opens the file specified in the Enter a file name field.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Update</Term>
<ListItem>
<Para>Displays a new list of files after
changing the filter key or changing to a new folder.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Cancels the Open operation.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Describes text entry fields, selection
lists, and buttons in the dialog box.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.54">
<Para><XRef Linkend="ToOpenAnExistingDocument"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.55">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.56">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="saveAsDialog">
<Title>Text Editor Save As Dialog Box</Title>
<Graphic Entityref="TextEditorSaveAs" Id="HTXTE.REF.fig.3"></Graphic>
<VariableList>
<VarListEntry>
<Term>Enter path or folder name&sigspace;</Term>
<ListItem>
<Para>Identifies the path name of the
current folder.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Filter</Term>
<ListItem>
<Para>An asterisk (*) shows all files. You can enter
wildcard characters to display only those files that
match an extension. For example, *.doc lists
only those files with a .doc extension.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Files</Term>
<ListItem>
<Para>Lists files located in the current folder.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Folders</Term>
<ListItem>
<Para>Lists folders located in the current folder.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Enter file name</Term>
<ListItem>
<Para>Field in which you type a new file name for your document.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Saves the file using the name provided.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Update</Term>
<ListItem>
<Para>Displays a new list of files after
changing the filter key or changing to a new folder.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Cancels the Save As operation.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>If you use Wrap To Fit, these additional choices appear in the
dialog box:</Para>
<Graphic Entityref="TextEditorWordWrap" Id="HTXTE.REF.fig.4"></Graphic>
<ItemizedList Mark="&bull;">
<ListItem Id="HTXTE.REF.item.57">
<Para>Add newline characters to the end of word-wrapped lines.</Para>
<Para>This is the default choice. It adds a newline character to the
end of each wrapped line and preserves line breaks
exactly as they appear in your document.</Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.58">
<Para>Do not add newlines. Only line breaks created by Return
will be preserved.</Para>
<Para>This option retains the "soft" line breaks inserted by Wrap To Fit.
If you reopen the document, the text conforms to the width of the
new window.
</Para>
</ListItem>
</ItemizedList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.59">
<Para><XRef Linkend="ToSaveADocumentToANewFile"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.60">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.61">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="askIfSaveDialog">
<Title>Text Editor Save Dialog Box</Title>
<Para>&sigspace;
If you use the Wrap To Fit option, the Save dialog box is displayed when
you save changes to your document. Line breaks inserted by Wrap To Fit
can be handled in two ways:</Para>
<Graphic Entityref="TextEditorSave" Id="HTXTE.REF.fig.5"></Graphic>
<ItemizedList Mark="&bull;">
<ListItem Id="HTXTE.REF.item.62">
<Para>Add newline characters to the end of word-wrapped lines.</Para>
<Para>This is the default choice. It adds a newline character to the
end of each wrapped line and preserves line breaks
exactly as they appear in your document.</Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.63">
<Para>Do not add newlines. Only line breaks created by Return
will be preserved.</Para>
<Para>This option retains the "soft" line breaks inserted by Wrap To Fit.
If you reopen the document, the text conforms to the width of the
new window.
</Para>
</ListItem>
</ItemizedList>
<VariableList>
<VarListEntry>
<Term>Yes</Term>
<ListItem>
<Para>Saves the current file or displays the Save As
dialog box for saving your document</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>No</Term>
<ListItem>
<Para>Proceeds with the operation without saving the file.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Cancels the operation</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Describes the Save dialog box
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Note>
<Para>The Save dialog is also displayed if you choose a menu command that
will result in the loss of your current editing changes.
</Para>
</Note>
<Graphic Entityref="TextEditorConfirmClose" Id="HTXTE.REF.fig.6"></Graphic>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.64">
<Para><XRef Linkend="ToSaveADocumentToTheCurrentFile"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.65">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.66">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="includeDialog">
<Title>Text Editor Include a File Dialog Box</Title>
<Graphic Entityref="TextEditorInclude" Id="HTXTE.REF.fig.7"></Graphic>
<VariableList>
<VarListEntry>
<Term>Enter path or folder name&sigspace;</Term>
<ListItem>
<Para>Identifies the path name of the current folder.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Filter</Term>
<ListItem>
<Para>An asterisk (*) shows all files. You can enter
wildcard characters to display only those files that
match an extension. For example, *.doc lists
only those files with a .doc extension.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Files</Term>
<ListItem>
<Para>Lists files located in the current folder.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Folders</Term>
<ListItem>
<Para>Lists folders located in the current folder.</Para>
<Para>You can insert a file from the current folder, a subfolder, or
a different folder.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Enter a file name</Term>
<ListItem>
<Para>Displays the file name selected in the Files list.
Click OK or press Return to include the file. Or,
you can type the name of the file you want to include.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Inserts the file specified in the Enter file name field at the location of the cursor.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Update</Term>
<ListItem>
<Para>Displays a new list of files after
changing the filter key or changing to a new folder.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Cancels the Include operation.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Describes text entry fields, selection
lists, and buttons in the dialog box.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.67">
<Para><XRef Linkend="ToIncludeAFile"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.68">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.69">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="spellDialog">
<Title>Text Editor Spell Dialog Box</Title>
<Para><Anchor Id="sp-spelllist">
<Anchor Id="sp-changeto">
</Para>
<Graphic Entityref="TextEditorSpell" Id="HTXTE.REF.fig.8"></Graphic>
<VariableList>
<VarListEntry>
<Term>Misspelled Words</Term>
<ListItem>
<Para>Lists the misspelled words found in the document.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Change To</Term>
<ListItem>
<Para>Field in which to type the correctly spelled word.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Find</Term>
<ListItem>
<Para>Finds the first occurrence of the misspelled
word. Find proceeds from the location of the insertion cursor.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Change</Term>
<ListItem>
<Para>Replaces the highlighted word with the correct spelling.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Change All</Term>
<ListItem>
<Para>Replaces all occurrences of the misspelled word.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Close</Term>
<ListItem>
<Para>Closes the dialog box.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>&sigspace;</Para>
<Note>
<Para>The Check Spelling command is only available for English.
</Para>
</Note>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.70">
<Para><XRef Linkend="ToCheckSpelling"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.71">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.72">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="findchangeDialog">
<Title>Text Editor Find/Change Dialog Box</Title>
<Para><Anchor Id="fc-find">
<Anchor Id="fc-changeto">
</Para>
<Graphic Entityref="TextEditorFindChange" Id="HTXTE.REF.fig.9"></Graphic>
<VariableList>
<VarListEntry>
<Term>Find</Term>
<ListItem>
<Para>Field in which to type a word or phrase that you
want to find. Find is case sensitive.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Change To</Term>
<ListItem>
<Para>Field in which to type the replacement text.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Find</Term>
<ListItem>
<Para>Finds the first occurrence of the misspelled word.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Change</Term>
<ListItem>
<Para>Replaces the highlighted word with the replacement text.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Change All</Term>
<ListItem>
<Para>Replaces all occurrences of the search string.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Close</Term>
<ListItem>
<Para>Closes the dialog box.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.73">
<Para><XRef Linkend="ToFindOrChangeText"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.74">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.75">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="formatDialog">
<Title>Text Editor Format Settings Dialog Box</Title>
<Para><Anchor Id="format-leftmargin">
<Anchor Id="format-rightmargin">
<Anchor Id="format-alignment">
</Para>
<Graphic Entityref="TextEditorSettings" Id="HTXTE.REF.fig.10"></Graphic>
<Para>&sigspace;</Para>
<VariableList>
<VarListEntry>
<Term>Left Margin</Term>
<ListItem>
<Para>The number of characters to indent the printed text from
the left edge of the paper</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Right Margin</Term>
<ListItem>
<Para>The number of columns for the text
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Left Align</Term>
<ListItem>
<Para>Aligns text lines on the left margin
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Right Align</Term>
<ListItem>
<Para>Aligns text lines on the right margin
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Justify</Term>
<ListItem>
<Para>Aligns text in a block style with equal left and right margins</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Center</Term>
<ListItem>
<Para>Text lines are centered</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Paragraph</Term>
<ListItem>
<Para>Applies the settings to the paragraph
containing the cursor</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>All</Term>
<ListItem>
<Para>Applies the settings to the entire document
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Close</Term>
<ListItem>
<Para>Closes the dialog box</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.76">
<Para><XRef Linkend="ToFormatADocument"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.77">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.78">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="copytofileDialog">
<Title>Text Editor Copy To File Dialog Box</Title>
<Para>Other applications can use Text Editor as a tool to edit information
and may restrict how editing changes are saved. For example, in some
instances the Save As command may be replaced by Copy To File,
which enables you to create a copy of the information
you are viewing or editing without changing your edit session to the
new file.
</Para>
<Graphic Entityref="TextEditorCopyToFile" Id="HTXTE.REF.fig.11"></Graphic>
<VariableList>
<VarListEntry>
<Term>Enter path or folder name&sigspace;</Term>
<ListItem>
<Para>Identifies the path name of the
current folder.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Filter</Term>
<ListItem>
<Para>An asterisk (*) shows all files. You can enter
wildcard characters to display only those files that
match an extension. For example, *.doc lists
only those files with a .doc extension.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Files</Term>
<ListItem>
<Para>Lists files located in the current folder.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Folders</Term>
<ListItem>
<Para>Lists folders located in the current folder.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Enter file name</Term>
<ListItem>
<Para>Field in which you type a new file name for your document.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Copies the information to the file name provided.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Update</Term>
<ListItem>
<Para>Displays a new list of files after
changing the filter key or changing to a new folder.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Cancels the Save As operation.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>If you use Wrap To Fit, these additional choices appear in the
dialog box:</Para>
<Graphic Entityref="TextEditorWordWrap" Id="HTXTE.REF.fig.12"></Graphic>
<ItemizedList Mark="&bull;">
<ListItem Id="HTXTE.REF.item.79">
<Para>Add newline characters to the end of word-wrapped lines.</Para>
<Para>This is the default choice. It adds a newline character to the
end of each wrapped line and preserves line breaks
exactly as they appear in your document.</Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.80">
<Para>Do not add newlines. Only line breaks created by Return
will be preserved.</Para>
<Para>This option retains the "soft" line breaks inserted by Wrap To Fit.
If you reopen the document, the text conforms to the width of the
new window.
</Para>
</ListItem>
</ItemizedList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.81">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.82">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="fileExistsDialog">
<Title>Text Editor File Exists Dialog Box</Title>
<Graphic Entityref="TextEditorFileExists" Id="HTXTE.REF.fig.13"></Graphic>
<Para>When saving a document, if you enter the name of an existing file
this dialog box is displayed.</Para>
<ItemizedList Mark="&bull;">
<ListItem Id="HTXTE.REF.item.83">
<Para>To overwrite the original file, click OK.</Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.84">
<Para>To enter a different file name, click Cancel and choose
Save As from the File menu.
</Para>
</ListItem>
</ItemizedList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.85">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.86">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="TextEditorCommandSyntax">
<Title>Text Editor Command-line Syntax and Options</Title>
<IndexTerm>
<Primary>Text Editor: starting in Terminal window</Primary>
</IndexTerm>
<Para>The command-line syntax for starting Text Editor is:
</Para>
<ProgramListing>dtpad [<Symbol Role="Variable">options</Symbol>]
</ProgramListing>
<Para>Where <Symbol Role="Variable">options</Symbol> is one or more of the following:</Para>
<VariableList>
<VarListEntry>
<Term><ComputerOutput>-server</ComputerOutput></Term>
<ListItem>
<Para>Specifies that Text Editor should be started in server
mode with no initial window displayed. Subsequent invocations of Text
Editor that run in the default requestor mode cause the server to create
a separate edit window for each request.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><ComputerOutput>-standAlone</ComputerOutput></Term>
<ListItem>
<Para>This option forces Text Editor to run in standalone
mode in which it handles its own editing independently of the Text Editor
server. This can be useful if one desires an instance of
Text Editor with an environment different from that of other Text Editor
windows. An example would be running an instance under a different locale,
or with different color resources. This is equivalent to setting
the <ComputerOutput>standAlone</ComputerOutput> resource to True.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><ComputerOutput>-exitOnLastClose</ComputerOutput></Term>
<ListItem>
<Para>Specifies that the Text Editor server process
should terminate when the last edit window for the display is closed. This
option is applicable only with the <ComputerOutput>-server</ComputerOutput> option. If this option is not
specified, the Text Editor server process remains active indefinitely, even
when all edit windows have been closed.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><ComputerOutput>-noBlocking</ComputerOutput></Term>
<ListItem>
<Para>Specifies that the Text Editor
requestor terminate as soon as the Text Editor server signifies that it can
access a file in the referenced folder. In the absence of this option the
Text Editor requestor process will block, and will exit only when it
receives notification from the Text Editor server that the window has been closed.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><ComputerOutput>-statusLine</ComputerOutput></Term>
<ListItem>
<Para>This option causes Text Editor to display a status
line at the bottom of the edit window. The status line reports the line
number where the cursor is located, the total number of lines in the document,
application messages, and alerts the user when Overstrike mode is on.
It also provides a way to move the cursor to a specific line number.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><ComputerOutput>-wrapToFit</ComputerOutput></Term>
<ListItem>
<Para>Specifies that Wrap To Fit is set on at start up.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.87">
<Para><XRef Linkend="Tasks"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.88">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.89">
<Para>Refer to the <ComputerOutput>dtpad(1)</ComputerOutput> man page for a
complete list and description of Text Editor command-line options.
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="TextEditorResources">
<Title>Text Editor Resources</Title>
<IndexTerm>
<Primary>application resources</Primary>
</IndexTerm>
<IndexTerm>
<Primary>resources</Primary>
</IndexTerm>
<Para>The following resources control the appearance and behavior of
Text Editor.
</Para>
<Para><ComputerOutput>Dtpad*server: [ true | false ]</ComputerOutput>
</Para>
<Para Role="indent">Specifies that Text Editor should be started in server mode to
process all subsequent edit requests for the display. Setting this resource
to True is equivalent to specifying the <ComputerOutput>-server</ComputerOutput> command-line option.</Para>
<Para><ComputerOutput>Dtpad*standAlone: [ true | false ]</ComputerOutput>
</Para>
<Para Role="indent">Specifies whether the current Text Editor process should run in
standalone mode, where it handles its own editing, or in requestor mode,
where the actual editing is handled by a single, separate Text Editor
server process. Setting this resource to True is
equivalent to specifying the <ComputerOutput>-standAlone</ComputerOutput> command-line option.</Para>
<Para><ComputerOutput>Dtpad*blocking: [ true | false ]</ComputerOutput>
</Para>
<Para Role="indent">Specifies that when Text Editor is run in the default
requestor mode, where the actual editing is handled by a separate Text
Editor server process, the requestor process should not exit until the
window associated with the edit request is closed. Setting
this resource to False is equivalent to specifying the
<ComputerOutput>-noBlocking</ComputerOutput> command-line option.</Para>
<Para><ComputerOutput>Dtpad*exitOnLastClose: [ true | false ]</ComputerOutput>
</Para>
<Para Role="indent">Specifies whether the Text Editor server process should terminate when
the last active edit window is closed. If this resource is set to False, then the
Text Editor server will continue to run, ready to receive a message to edit
a file. If this resource is set to True, the Text Editor server will terminate when the last active
edit window is closed.</Para>
<Para><ComputerOutput>Dtpad*statusLine: [ true | false ]</ComputerOutput>
</Para>
<Para Role="indent">Specifies whether Text Editor should display the status line at
the bottom of the edit window. Setting this resource to True is equivalent
to specifying the <ComputerOutput>-statusLine</ComputerOutput> command-line option.</Para>
<Para><ComputerOutput>Dtpad*wrapToFit: [ true | false ]</ComputerOutput>
</Para>
<Para Role="indent">Specifies whether Text Editor should have Wrap To Fit enabled
(True) or
disabled (False) when the editor is started. Setting this resource to True
is equivalent to specifying the <ComputerOutput>-wrapToFit</ComputerOutput> command-line
option.</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.90">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.91">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.92">
<Para>Refer to the <ComputerOutput>dtpad(1)</ComputerOutput> man page for a
complete list and description of Text Editor resources.</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
<Sect1 Id="TextEditorFileset">
<Title>Text Editor Fileset</Title>
<IndexTerm>
<Primary>Text Editor, executable</Primary>
</IndexTerm>
<IndexTerm>
<Primary>application defaults</Primary>
</IndexTerm>
<IndexTerm>
<Primary>resources</Primary>
</IndexTerm>
<Para>Text Editor's executable file and application defaults file
are:</Para>
<VariableList>
<VarListEntry>
<Term>Executable file</Term>
<ListItem>
<Para><ComputerOutput>/usr/dt/bin/dtpad</ComputerOutput>
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Application defaults file</Term>
<ListItem>
<Para><ComputerOutput>/usr/dt/app-defaults/<Symbol Role="Variable">lang</Symbol>/Dtpad</ComputerOutput>
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="HTXTE.REF.item.93">
<Para><XRef Linkend="Reference"></Para>
</ListItem>
<ListItem Id="HTXTE.REF.item.94">
<Para><XRef Linkend="TableOfContents"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect1>
</Chapter>
<!--fickle 1.15 help-to-docbook 1.4 01/17/96 16:51:41-->