\begindata{text,268629828}
\textdsversion{12}
\template{help}
\chapter{EZ: A Document Editor}


\section{What EZ is}


\leftindent{EZ is an editing program that you can use to create, edit, and 
format many different types of documents.  This help document tells you how to 
use EZ to create and edit text documents.   For details about creating and 
editing non-text types of documents with EZ or inserting such documents into 
EZ text documents, see the  \italic{insets}  overview file.  


This help document is designed to be both an introduction for new users of EZ 
and a reference guide for more experienced users.  Once you are familiar with 
the basics of EZ, you may wish to explore its many other features; details on 
how to do so appear in the \bold{Other Features of EZ} and \bold{Related Tools} 
sections at the end of this document.

}
\leftindent{This document has the following sections:\leftindent{ 

}}
\leftindent{\leftindent{Starting EZ

Inserting text and Moving around

Deleting, moving and copying text 

Formatting text

\leftindent{Changing fonts

Changing line spacing and margins

Page breaks}

Footnotes

Table of Contents

Index and References

Previewing and Printing

Saving and Quitting

Checkpointing 

Pop-up Menu meanings 

Other Features of EZ

Preferences

Quick Reference

Recent Changes

Related Tools}}


\section{Starting EZ }


\leftindent{To begin working with EZ, move the cursor into Typescript.  At the 
prompt, type ez, followed by the name of the file you want to edit and press 
Enter, like this:


\leftindent{\typewriter{ez filename}}

\bold{
}Like many Andrew programs, EZ runs in its own window, so typing "ez 
\italic{filename}" will cause a new EZ window to appear with the contents of 
the file called \italic{filename} in the body of the window (if 
\italic{filename} names a new file, the window will be blank).  


You can open two EZ windows simultaneously by typing:


\typewriter{\leftindent{ez filename1 filename2}}


Advanced users may even wish to be able to open more than two files at a time 
at the start of an EZ session.  See the section on EZ in the 
 \italic{preferences } help document to learn how to make this possible.


You can also create files that have "extensions" in their names, like this:


\typewriter{\leftindent{ez filename.extension}}


Some file extensions cause EZ to provide you with special editing tools.  See 
the  \italic{ez-extensions}  help document for details about these extensions. 



\bold{Warnings about starting EZ:}  If you start EZ without naming a file to 
edit, EZ displays the words "No files specified" in the title bar and prompts 
you to type in a file name with the message "Please enter the name of an 
initial file:" followed by a pathname.  Type in the name of the file and press 
Enter to begin editing.


\bold{Warnings about filenames: }The following characters have special meaning 
to UNIX.  While it is possible to use them in a filename, it is better not to 
do so, just to avoid having your commands misinterpreted:


\leftindent{/  \\  "  '  *  ;  -  ?  [  ]  \{  \}  (  )  ~  !  $  <  >   space}


\bold{Note: }  Do not use the underscore character "_" in program source 
filenames.  A dynamic linking feature of ATK makes use of the underscore in 
program source file names.  Because text files will not be affected by this 
change, you may use underscores in their names.}


\section{Inserting text and Moving around in the EZ window}


\leftindent{\bold{Inserting text at the caret. }  To begin inserting text in 
an EZ document, move the mouse cursor into the EZ window.  Notice that there 
is a small black triangle in the upper left hand corner of the EZ window (at 
the beginning of the document).  This is the text caret, which marks your 
current position in the document.  Any text you type appears immediately to 
the left of the text caret.  


It is important to distinguish the mouse cursor from the text caret.  The 
mouse cursor (which becomes a black arrow with a curved tail while inside a 
window) indicates the current "focus of attention" of your workstation.  In 
EZ, you use it to help you move the text caret around.  The text caret itself 
marks your location in the document.  Only the location of the text caret, and 
not the location of the mouse cursor within the window, determines where the 
text you type appears.


\bold{Wrapping text.}  An important thing to notice is that EZ automatically 
"wraps" text as you insert it.  Wrapping means that when a line of text 
reaches the edge of the window, EZ automatically moves the next word to the 
next line.  Thus no carriage returns are necessary between lines.   \italic{Do 
not press Enter to add carriage returns unless you want to start a new 
paragraph or leave a blank line in your text}.  Adding extra carriage returns 
causes formatting errors in the printed form of your document.  


\bold{Moving around in EZ.}  If you wish to insert text (or otherwise work on 
your document) somewhere other than at the beginning of the document, you must 
move the text caret.   You do this with the aid of the mouse cursor 
and\italic{ scrollbar }.


If the place where you wish to begin working is visible in the window, simply 
move the mouse cursor to the exact position where you wish to insert text. 
 Click the left mouse button, and the text caret "jumps" from its previous 
location to appear there. 


To move to a part of your document that is not currently visible in the 
window, use the scrollbar (if you are unfamiliar with the very useful 
functions of the  \italic{scrollbar }, you may wish to read the help document 
on it ). Once you have found the desired part of your document, point the 
mouse cursor at the exact location where you want to work and click the left 
mouse button. 


}\section{Deleting, moving and copying text } 


\leftindent{\bold{Deleting text. }If the text that you wish to delete from 
your document is very short (say a word or two), it is probably simplest to 
move the text caret to the end of the offending section and backspace over it 
(by pressing Backspace or Delete). 


To delete longer stretches of text, it is best to use EZ's\italic{  selection 
 }and  \italic{menu  }features, which allow you to select a section of text 
and perform a function on the whole section at once.  The easiest way to 
select a piece of text is to use the following steps:


\smaller{\leftindent{1) Move the cursor to the beginning of the text you want 
to select.  Press the left mouse button to place the text caret at that point.


2) Move the arrow cursor to the end of the text you want to select.  


3) Press the \bold{right} mouse button to complete the selection.  The 
selected text appears in reverse video (white characters in a black box).  

To make a selection box disappear, click the left mouse button. }}


(For information about other ways to select text, see the  \italic{selection 
} help document. Also, if you are not familiar with how to make menus appear 
and how to choose options from them, you may wish to read the  \italic{menus 
} help document before continuing.)


Once you have selected the area you wish to delete, bring up the menus and 
select the \bold{Cut} option from the front menu card.  The selected area 
disappears.}\leftindent{\bold{ } 


\bold{Moving text.}  Text that you have deleted by choosing the \bold{Cut 
}option does not actually disappear forever--EZ stores it in the 
 \italic{cutbuffer} .  The cutbuffer is a special file for temporary storage 
of text that you have cut or copied.   Using the \bold{Paste} menu option, you 
can not insert any text or objects except for the very last selection that was 
\bold{Cut}.  Using keyboard commands, however, you can cycle back through the 
last eight previously \bold{Cut} items that are held in a "cut ring."  See 
the\italic{  cutbuffer  }help file for more information.


\bold{Copying text.}  You can place the same text in more than one place in 
your document without having to type it more than once, by choosing 
\bold{Copy}\bold{ }from the front menu card after selecting a text region. 
 The selected text region does not disappear, but is stored in the cutbuffer 
nonetheless.  Move the text caret and choose \bold{Paste} from the front menu 
card to insert the copied text at the new location.


\bold{Cutting, copying, and pasting text in multiple windows.}  A useful 
feature of EZ (and Andrew) is that it allows you to delete and move text not 
only within one document, but also into and out of virtually any window on 
your screen.  So, for example, you can copy part of your EZ file into a mail 
message, into another EZ file, or even into the Typescript.  You can also cut, 
copy, or paste text from those windows into your EZ document.  There are some 
restrictions, however.  You can use the \bold{Cut} and \bold{Paste} options 
only in files that belong to you. Other files (including help documents such 
as this one, and files belonging to other users) are in "Read Only" mode. 
 This means you can only copy text from them; you cannot delete or add 
anything. } 


\section{Formatting styles: changing fonts}


\leftindent{\bold{Adding styles.} You can alter the appearance of the text in 
your EZ files in numerous ways by adding format commands called "styles."  To 
add styles you use EZ's selection and menu features.  If you read the previous 
section on \bold{Deleting}\bold{ text}, you already know how to 
 \italic{select  }text and choose from menus.  


Once you have selected a text region, you can choose style options from four 
of the menus that appear, which are labelled \italic{Font}, \italic{Justify,} 
\italic{Title and} \italic{Region} (these cards only appear when a region is 
selected).  Some of the options on these cards change the typeface of the text 
(making it bold or italic, for example), other options change text positioning 
(providing indenting or centering) and others do both. For easy reference, the 
section below on \bold{Pop-Up Menu Meanings }summarizes all the available 
functions.   


You may add more than one style to the same piece of text if you wish, by 
choosing one style and then another while the region is still selected.   You 
can also embed styles, adding a further style to a portion of a region that 
already contains a style (\italic{this example shows a \bold{bold subregion} 
in a region of italic style}).  However, you should use multiple styles 
sparingly, because removing them is not always as easy as adding them.


\bold{Listing styles.}  To see exactly what styles apply to a region of text 
in your document, use EZ's style-listing feature:


\leftindent{\smaller{1) Position the text caret in the text that you want to 
check.


2) Press Esc-s  (the Esc key followed by s.)}}


Typing Esc-s gives you two kinds of information:  


\leftindent{1) The message line at the bottom of the screen lists all the 
styles that apply to the region where the text caret is placed. }


\leftindent{2) Esc-s also automatically selects the text region associated 
with the first style in the list. For more information on how to read the 
style list and how to use style-listing when removing styles, see the 
\italic{ ez-styles}  help document.}


\bold{Removing a single style.}  To remove a single style, place the text 
caret anywhere within the styled region.  Choose \bold{Plainer} from the front 
menu card.  You can also use \bold{Plainer} after selecting the single-styled 
region, if you want the greater degree of control afforded by selecting.


\bold{Removing all styles from a region.}  If you have added several styles to 
a region and now wish to remove all of them, select the desired region, and 
then choose \bold{Plainest} from the front menu card.  All of the styles that 
apply \bold{\italic{only }}to the selected region are removed.  See the 
 \italic{ez-styles}  help document for details.  


\bold{Removing embedded styles from a region.}  Removing only some of the 
multiple styles that you have added to a region can become complicated.  To 
avoid costly mistakes, you should understand and use EZ's style-listing 
feature to help you remove only the styles you wish and only from the desired 
region. The  \italic{ez-styles } help document explains how to do so.  

}
\section{Formatting text: line spacing and margins

}
\leftindent{\bold{Line Spacing.}  By default, EZ prints documents 
single-spaced.  To print documents with different line spacing, use the .ls 
(line-spacing) troff command.  For double-spaced output, put the line


\leftindent{.ls 2 }


at the beginning of your document (on a line by itself), select it and choose 
\bold{FormatNote} from the \italic{Region} menu card (see the section on 
Pop-Up Menu Meanings for more about the FormatNote style).  For 
triple-spacing, substitute .ls 3. 


All the text that follows a .ls command line will be printed with the 
indicated spacing. For example, you can change to a different line spacing by 
placing another .ls command later on in the document.  You can change back to 
single-spacing by using .ls 1.


Notice that line spacing commands do not change the format of text as it 
appears in the EZ window.  The visible effects of line spacing commands appear 
when the document is previewed or printed.  For more information, see the 
"Printing and Previewing" section below.


\bold{Changing margins in printed documents. } EZ prints documents with 
default margins of 1 1/4 inches on both left and right.  Margins are set using 
two commands from troff: the \italic{\bold{.}po} (page offset) command, which 
sets the left margin, and the \bold{.}\italic{ll} (line length) command, which 
determines how long the line of text will be.  The right margin is not 
controlled directly, but is calculated to fill the remaining page width, using 
the formula 8.5 - ( \italic{.po}  +  .\italic{ll }).  The smallest possible 
printed left margin is 1/2", which you get when you set .\italic{po} to 0.  In 
general, 1/2" is added to any .\italic{po} that you specify. The same 1/2" is 
\italic{subtracted} from whatever .\italic{ll} you specify.


\smaller{\bold{Example}. To get 1" margins on both sides, place the following 
command at the beginning of your document, and surround it with a 
\bold{FormatNote} style from the \italic{Region} menu card. (The "i" following 
the numbers stands for "inches.")


\leftindent{.po .5i   

.ll 7i  

 } 

\bold{Example.} To get a 1.5" left margin, but only a 1" right margin, use the 
following commands:


\leftindent{.po 1i

.ll 6.5i

}}}
\section{Formatting text: page breaks}


\leftindent{\bold{Creating and deleting pagebreaks.}  All text that is entered 
into an EZ window becomes automatically paginated upon printing or previewing. 
 EZ simply inserts a page break into the document when no more information can 
fit onto the current page.  There are, however, times when you may want to 
insert a page break before a particular page is completely filled.  EZ lets 
you do this through the use of a pagebreak \italic{inset}.


\bold{Creating a pagebreak}.  To add a pagebreak, place the text caret at the 
desired page break position, and select \bold{Insert Pagebreak} from EZ's 
\italic{Page} menu.  EZ places a line like this:

\begindata{bp,268667524}
\enddata{bp,268667524}
\view{bpv,268667524,0,0,0}

on the page to mark the position of the pagebreak.  This line is actually an 
\italic{inset} (for more information, see the  \italic{insets}  help file). 
 In this case, the inset can be thought of as a special character that EZ uses 
to represent a pagebreak.  


\bold{Deleting a pagebreak}.  To remove the pagebreak, position the text caret 
to the right of the grey line and backspace.  The message,


\leftindent{\leftindent{Really delete inset(s)?


}}is printed in a dialogue box.  Click in the appropriate box (either 
\bold{yes} or \bold{no}) to continue or abort the deletion.  When properly 
deleted, the pagebreak inset vanishes, leaving only the text caret in its 
place.


To see the effects of both pagebreak insets and ordinary pagination, use EZ's 
\bold{Preview} option (for more information, see the \bold{Previewing and 
Printing} section below).  


\bold{Moving between pagebreaks}.  Pagebreak insets in a document are useful 
for a number of reasons.  Not only do they allow you to control the 
positioning of pagebreaks, but they also enable you to move around more easily 
in lengthy documents.


To move to the next occurrence of a pagebreak, select \bold{Next Page} from 
EZ's \italic{Page} menu.  The text automatically scrolls so that the pagebreak 
is positioned at the top of the window.  The \bold{Previous Page} option, also 
located in the \italic{Page} menu, works in a similar manner, but searches 
instead for a pagebreak inset occurring before the current text caret 
position.


By strategically positioning pagebreaks at the end of specific chapters or 
sections, you can use EZ's \bold{Next Page} and \bold{Previous Page} options 
to move directly between different portions of the document.


}\section{Footnotes

}
\leftindent{Many formal documents require numbered footnotes in order to 
better organize various bits of information.}  \leftindent{EZ provides a 
useful footnote option that allows you to easily create and manage footnote 
entries.  For more information, see the \italic{ ez-footnotes } help file.

}\leftindent{
}\section{Table of Contents}\leftindent{


Constructing a table of contents manually can be rather difficult and time 
consuming.  In order to help you with this task, EZ has a \bold{Table of 
Contents} option which automatically creates a table of contents from an 
existing document.  It is also useful as an interactive table of contents for 
viewing documents on-line.  For more information, refer to the 
 \italic{ez-contents  }help file.


}\section{Index}\leftindent{


In addition to the Table of Contents feature, ez also allows you to create 
different types of indexes for your document.  For more information, refer to 
the  \italic{ez-index}  help file.  


You can also cross reference different parts of a file using reference insets. 
 See the  \italic{ez-refs}  help file.}

\leftindent{
}\section{Previewing and Printing}


\leftindent{\bold{Previewing.}  Even though you can see the styles that you 
apply to the text in your document, the EZ window does not always show 
everything exactly as it will appear in the printed version.   For example, 
the screen is more restricted than a printer in the typeface sizes it can 
display.  You can see more exactly how your completed file will appear on the 
printed page by choosing the \bold{Preview} option from the \italic{File} menu 
card.  This option opens a separate Preview window containing your document. 
 For more information about Preview, see the  \italic{preview } help document.}


\leftindent{\bold{Printing.}  You can print your file by choosing the 
\bold{Print} option from either the \italic{File} menu card in EZ or the front 
menu card in Preview.  This option invokes a special printing program for EZ 
files.  See the  \italic{ezprint}  help document for more information.  You 
can also use the \bold{Set Printer} option (described in the \bold{Pop-Up Menu 
Meanings }section below) to change the name of the printer where your file is 
sent for printing.  }


\leftindent{By default, EZ prints your files in the same bodyfont that is used 
to display them on the screen.  To print EZ files (as well as files from all 
BE2 programs) in a different font than the one used for screen display, use 
the print.bodyfont preference to set a new font.  See the section on Printing 
in the   \italic{preferences}  help document for details.


\bold{Postscript.  }You can create a PostScript file from an EZ document by 
following the instructions in \italic{ ez-ps}  help file.}


\section{Saving and Quitting}


\leftindent{\bold{Saving.}  To save the document you are editing in the EZ 
window, choose the \bold{Save} option from the front menu card.  When the 
document is saved into a file, the message "Wrote File" and the pathname of 
your file appear in the message area at the bottom of the window.   


It is recommended that you choose \bold{Save} frequently while you use EZ, in 
order to minimize the amount of work you might lose if for some reason the EZ 
session ends unexpectedly. For more details on this aspect of EZ, see the 
 \italic{ez-buffers}  help document.}


\leftindent{\bold{Quitting.}  To quit using EZ, choose the \bold{Quit} option 
from the front menu card.  If you try to quit without saving changes you have 
made to the text, you are prompted to save the changes you have made. 

}
\leftindent{\bold{Note:}  if you have worked with multiple files during the EZ 
session and have not saved all of them, you may continue to be prompted, even 
though you choose \bold{Save} in the current window before trying to quit. 
 See the \italic{ ez-buffers } help document for more information on working 
with multiple files. }


\section{Checkpointing}


\leftindent{EZ provides another safeguard against loss of your work, in 
addition to the frequent saves that you should make.  After you have made 
changes to a file once, EZ begins to save your work automatically in 
"checkpoint"  files.  A checkpoint file has the same name as the file in which 
your document is stored, with the additional extension .CKP.  If the EZ 
session does end unexpectedly, you can recover most of the changes you made by 
finding the .CKP file in your directory and using \bold{mv} to convert the 
.CKP file into the regular version of the file.  (Note that normally the .CKP 
file associated with a document does not appear in your directory because 
choosing \bold{Save} removes it.)}


\leftindent{You can tell when EZ is checkpointing your document because the 
clockface cursor appears on the screen in place of the arrow cursor, and the 
message line displays "Checkpointing. . . " At those moments, anything that 
you type will not appear in the window until after the clockface disappears.}


\leftindent{\bold{Changing checkpoint frequency.}  By default, EZ will 
checkpoint your document about every two minutes.  Should the EZ session end 
unexpectedly, you will lose only the changes you made in the last two minutes. 
 However, some users find the pause required while a file is checkpointing to 
be annoying, especially with long documents.  You can change how often EZ 
checkpoints your documents by changing the ez.CheckpointMinimum preference in 
 your  \italic{preferences}  file.  See also the \bold{Other Features of EZ} 
section below. }


\section{Pop-Up Menu Meanings}


\leftindent{EZ provides two kinds of menu cards.  "Main" menu cards are always 
available.  When you select a text region, EZ adds "selected region" menu 
cards to the Main ones.  The menu cards and options discussed in this section 
appear when your EZ file does not have one of the special extensions listed in 
the  \italic{ez-extensions}  help document.  The menus available in files with 
special extensions may differ slightly.  }


\subsection{Main menus}


\leftindent{The menus listed in this section are available at all times, 
whether you have a selected region or not.  Some of the particular options, 
however, are only available when there are no selected regions.  Such options 
are marked below.}


\italic{Front Menu Card}


\leftindent{\bold{Paste:} Inserts cut or copied text back into a document at 
the text caret.  You must have previously cut or copied something for 
\bold{Paste} to work.  Only available when there are no selected regions.}


\leftindent{\bold{Save:} Saves all changes in the file that you are editing. 
  After your file has been saved, the message "Wrote file" appears in the 
response line, followed by the pathname of the file that was saved.}


\leftindent{\bold{Switch file: } Replaces the current file in the buffer with 
a new file that you specify.  A dialogue box comes up, prompting you to save 
any changes before it switches to the new file.  To learn what buffers are, 
and how they work in EZ, see the  \italic{ez-buffers}  help document.}


\leftindent{\bold{Plainer:}  Removes the "innermost" style from the region of 
style application where the text caret is placed.  (A similar option on the 
selected region menus, \bold{Plainest}, removes all styles that apply only to 
the selected region of text. See the  \italic{ez-styles}  help document for 
details.)}


\leftindent{\bold{Delete Window: } Deletes the window you are in.


\bold{Quit:} Quits all windows and buffers associated with the current EZ 
process.  (To learn what is meant by the terms "buffer" and "process," see the 
 \italic{ez-buffers}  help document.)  If you try to quit without saving 
changes you are prompted to save. }


\leftindent{If you have worked with more than one file during the EZ session 
and have not saved all of them, you may continue to be prompted.}


\italic{Search/Spell Menu Card


}\leftindent{For more information about the four searching options listed 
below or about the use of regular expression searching in EZ, see the 
 \italic{searching}  help document. }


\leftindent{\bold{Forward:} Searches forward from the position of the text 
caret for the set of characters you specified.  After you choose this option, 
EZ puts the "Find:" prompt in the message region.  Type the word or phrase 
that you want to search for and press the Enter key.  If any of the following 
characters are in the search string, 


\leftindent{[  ]  *  .  \\}


precede them with a backslash (\\).


\bold{Backward:}  Searches backward from the text caret for the character 
string that you specify.


\bold{Search Again: } Repeats the previous search.


\bold{Query Replace:}  Finds the character string that you specify and 
replaces it with a second character string that you specify.  See the 
 \italic{query-replace } help document for details.


\bold{Check Spelling: } Checks your spelling throughout the document.  (See 
the  \italic{spellcheck   }help document.)}


\italic{Page Menu Card}


\leftindent{\bold{Insert Pagebreak:}  Places a pagebreak inset at the position 
of the text caret.


\bold{Next Page:}  Moves the text caret to the next page break inset and 
scrolls the document to that point.


\bold{Previous Page:}  Moves the text caret to the last page break inset and 
scrolls the document to that point.


\bold{Insert Footnote:}  Places an opened footnote inset at the position of 
the text caret.  For more information, see the \italic{ez-footnotes} help 
document.


\bold{Open Footnotes:}  Opens every footnote inset in the current document. 
 For more information, see the \italic{ez-footnotes} help document.


\bold{Close Footnotes:}  Closes every footnote inset in the current document. 
 For more information, see the \italic{ez-footnotes} help document.


\bold{Table of Contents:}  Opens a Table of Contents window for the current 
document.  For more information, refer to the \italic{ez-contents }help 
document.}


\italic{File Menu Card}


\leftindent{\bold{Save As:} Saves the current file with a new name.  When the 
"Write to file:" prompt appears, it contains the pathname of the current file. 
 To save the file with a new name, backspace over the old name, type in the 
new name, and press Enter.


\bold{Save All: } Saves the changes to all of the files that are contained in 
buffers.  (To learn what buffers are, and how to use them in EZ, see the 
 \italic{ez-buffers}  help document.)  It also saves newly-created buffers 
into files if you have named them.  Buffers that do not have names will not be 
saved.  


\bold{Insert file:}  Prompts you for the name of a file to be inserted at the 
text caret position.  The file can be in non-text formats (Table, Raster, Eq, 
Fad) but currently there are problems with using this option for Zip insets; 
see the \italic{ zip } help document for details.


\bold{Set Printer:}  Prompts you for the name of the printer you want for 
files printed during this EZ session (and lists the name of your current 
default printer).  Type the name of the new printer and press Enter, or just 
press Enter to keep the default setting.


\bold{Preview: } Starts the Preview program on the current document to show 
what the document will look like when printed.  For more information, see the 
\italic{preview }help document.


\bold{Print:}  Submits a printing request for the document.  


\bold{Add Template:}  Prompts you for the name of a document template that 
will be added to the document.   For information about the system templates 
that are available, see the  \italic{templates  }help document. }


\bold{Selected region menus

}
The following menu cards appear only when there is a selected region in an EZ 
window.  When you choose one of the options listed here, it will affect the 
selected text.


\italic{Front Menu Card}


\leftindent{The following three options are added to those on the Main menus 
front menu card.  (In addition,\bold{ Paste} does not appear when \bold{Cut 
}and \bold{Copy} do.)


\bold{Cut:}  Deletes the selected text and stores it in the cutbuffer.  You 
can put the text you cut most recently back into any window by choosing Paste.


\bold{Copy:}  Copies the selected text into the cutbuffer.  You can put the 
text you copied most recently back into any window by choosing Paste.


\bold{Plainest:  }Removes all styles that apply only to the selected region.}


\italic{Font Menu Card} 


\leftindent{\bold{Bold:}  Makes the selected text appear in boldface. 


\bold{Italic: } Makes the selected text appear in italics. 


\bold{Superscript: } Decreases the size of the selected text by 2 points (a 
point equals 1/72 of an inch) and prints the text above the default baseline. 


\bold{Bigger:}  Increases the size of the selected text by 2 points (a point 
equals 1/72 of an inch).  The 2 points are added to the text size specified in 
your ez.bodyfont preference.  The text may not appear to change on the screen 
if there is no screen font that is 2 points larger than the current one. 
 However, when you print the document, the text will be printed out with the 
larger font.


\bold{Smaller: } Decreases the size of the selected text by 2 points (a point 
equals 1/72 of an inch).  The 2 points are added to the text size specified in 
your ez.bodyfont preference.  The text may not appear to change on the screen 
if there is no screen font that is 2 points smaller than the current one. 
 However, when you print the document, the text will be printed out with the 
smaller font.


\bold{Subscript: } Decreases the size of the selected text by 2 points (a 
point equals 1/72 or an inch), and prints the text below the default baseline. 
     


\bold{Typewriter: } Prints the selected text in a fixed-width font.}


\italic{Justify Menu Card }


\leftindent{\bold{Center:}  Centers the selected text. 


\bold{FlushLeft: } Justifies the selected text to the prevailing left margin. 


\bold{FlushRight: } Justifies the selected text to the right margin.

}
\italic{Title Menu Card }


\leftindent{\bold{Major Heading: } Makes a heading that is centered and in a 
bigger size than the surrounding text. 


\bold{Heading: } Makes a bold heading and moves it to the left of the default 
left margin. 


\bold{Subheading:}  Makes a bold heading that is flush with the default left 
margin. 


\bold{Chapter:}  Makes a bold heading that is flush with the left margin and 
increases its size by 4 points compared to the surrounding text.  


\bold{Section: } Makes a bold heading that is flush with the left margin and 
increases its size by 2 points compared to the surrounding text. 


\bold{Subsection:}  Makes a bold heading that is flush with the left margin. 


\bold{Paragraph:}  Makes an italic heading that is flush with the left margin.}


\italic{Region Menu Card }


\leftindent{\bold{Quotation:}  Indents the left and right margins of the 
selected text and makes the text italic. 


\bold{Description:}  Creates a "hanging indent" or "outdented" paragraph by 
indenting the left margin of all but the first line of text. 


\bold{Example: } Indents the left margin of the selected text and displays it 
in a fixed-width font. 


\bold{Display:  }Indents both the left and right margins of the selected text. 
 The text at the right margin is ragged (not justified).


\bold{Indent:} Indents both the left and right margins of the selected text. 
Both margins are justified.


\bold{Left Indent:}  Indents the left margin of the selected text.


\bold{Format Note:}  This special style is used around commands from the 
formatting package called  troff , which you can include in your EZ documents 
in order to produce formatting effects not available as EZ menu items.  When 
the formatting part of the printing program sees a FormatNote, the command 
contained within the note is executed, rather than printed.  For details about 
some troff commands useful in EZ, see the  \italic{ez-troff}  help document. }

 

\section{Other Features of EZ}


\leftindent{Now that you know how to use EZ's basic features to create text 
documents, you may wish to learn more about "fancier" features of EZ.  The 
following list briefly describes many of these features and tells you how to 
get more information.


\bold{Creating an EZ initialization file. } EZ allows you to create your own 
initialization file (called an \italic{ .ezinit  }file).  This allows you to 
add to or change EZ's menu options and keybindings, and the meanings of 
filename extensions. To learn how to do so, see the \italic{ initfiles}  help 
document.  Creating your own .ezinit causes EZ to ignore the global 
initialization file, which includes many default settings.


\bold{Creating files with special extensions.}  Certain file extensions (such 
as .c, .h, .concept, .help, .letter, .raster, or .table) cause EZ to provide 
you with special programming packages (called \italic{ insets } ) appropriate 
for information in different formats, or with  templates  for text may contain 
menu options different from the ones described in this file.  If you don't 
want these special templates or packages, recreate the files with a different 
extension.  For information about how EZ interprets file extensions and 
assigns templates, see the  \italic{ez-extensions } and  \italic{initfiles 
} help documents.  


\bold{Editing other types of documents with EZ.}  You can edit non-text 
documents with EZ or include "insets" (such as pictures or tables) containing 
different types of information in an EZ document.  See the  \italic{insets 
} overview for details.


\bold{Changing checkpoint frequency. } By default, EZ will checkpoint your 
document about every two minutes.  Should the EZ session end unexpectedly, 
 you will lose only the changes you made in the last two minutes.  However, 
some users find the pause required while a file is checkpointing to be 
annoying, especially with long documents.  You can change the frequency of 
checkpointing in EZ by changing the value of ez.CheckpointMinimum in your 
preferences file; see the section on EZ in the  preferences  help document for 
details.  


You can also add an option to your EZ menus that allows you to change the 
checkpointing frequency only for the file you are currently working on.  To 
make the option \bold{Set Ckp Time} appear at the bottom of the \italic{File} 
card, use Copy to put the following line into your .ezinit file (do not type 
it yourself):


addmenu ezapp-set-buffer-checkpoint-latency "File,Set Ckp Time~32" frame


\bold{Note:}   If you use the line above, BE SURE to read the 
\italic{ initfiles } help document, especially if you do not already have an 
.ezinit file.   


\bold{Changing justification of text.}  By default, EZ displays and prints 
left and right justified text.  If you want to have text with a ragged right 
margin, include the ez.justified preference in your preferences file and type 
"off."  See the section on EZ in the  \italic{preferences}   help document.


\bold{Producing Scribe Files. } You can use EZ to produce .mss files for the 
Scribe formatter.  Just remember not to include any EZ styles because Scribe 
does not know how to interpret EZ's style commands.  You may want to use 
Plainest on the whole .mss file. 


\bold{Using multiple windows and buffers. } EZ provides many features for 
working with multiple windows and buffers.  The  ez-buffers  help document 
describes how files, buffers and windows work in EZ, and how best to use them. 
 It also explains how to use key-bindings and menu options to access EZ's 
file, buffer and window manipulation functions.  A more succinct list of the 
key-bindings is available in the  \italic{ez-keys}  help document.


\bold{Using the ctext editing package.  }The  \italic{ctext}  package contains 
a set of indentation and commenting features designed for C programmers. 
 Documents created with the .c or .h extension receive the package by default, 
unless you modify your .ezinit file to map these extensions differently.  You 
can also map additional extensions to ctext, if you wish.    See the help 
documents on  \italic{ctext } and  \italic{initfiles } for details.  You can 
also use the table of contents feature with ctext; see the 
 \italic{ez-contents}  help file.


\bold{Using troff commands for advanced formatting in EZ. } By using 
formatting commands from troff, a UNIX text formatting program, you can 
produce a variety of useful formatting effects in your documents, such as 
special margins and numbering, page breaks, spacing, headers and footers.  For 
additional information about using troff commands in EZ, see the 
 \italic{ez-troff  }help document. 


\bold{Translating EZ documents to troff. } Use the command "ezprint  -t 
 filename" to translate EZ documents into troff form.  The output will appear 
in your Typescript window and will not be saved in a file, unless you put it 
into an output file with a command like this:


ezprint  -t  filename1 > filename2   


where filename1 is the name of the file you wish to translate, and filename2 
is the troff file to be created.}


\section{Preferences}


\leftindent{There are numerous features of EZ that you can change if you do 
not like the default values set by system administrators.  These features 
include the font used in the EZ window, how often EZ checkpoints files, how 
long messages stay on the message line, and whether text is right justified. 
 If you are satisfied with the settings of these features, you do not need to 
do anything.  If you would like to change them, see the section on EZ in the 
 \italic{preferences}  help  document.  Be sure to read the rules and warnings 
near the top of that document.  }


\section{Quick Reference}


\leftindent{Syntax:


ez [option] filename


Options/arguments:


-r  Edit the next file you specify in read-only mode.


-w  Create a new window containing the next file you specify.


-fl  Force loading of your EZ initialization file.  Use this option to test 
your .ezinit file after making changes.  Any errors will appear in a 
"StartupErrors" buffer.  


-ni  Do not read any initialization file.  This allows you to start EZ to fix 
a mistake in an initialization file.}


\section{Recent Changes}


\leftindent{October 1987

You can now display and print documents from BE2 programs (such as EZ and 
Help) in different fonts using the print.bodyfont preference (See preferences 
above).  If you do not specify a print.bodyfont preference, your documents 
will continue to be printed with the same font used to display them on the 
screen.


January 1988

New release of EZ to campus.


Insets can now be used in EZ documents.  Insets are software packages that 
allow you to include different types of information in EZ documents.  You can 
also create non-text documents with EZ, such as pictures, tables, animations 
and equations, by using a new set of file extensions that have been added to 
the global.ezinit file.  See the  insets  and  initfiles  help documents for 
details.


Lookz is a new package that allows you to add or change the particular 
formatting effects associated with the styles that are available on EZ's 
selected region menus

(such as Chapter and Section).  See the  lookz  help document for details.


Numerous core dumping bugs have been fixed.}


\section{Related tools  }


Select (highlight) one of the italicized names and choose Show Help on 
Selected Word from the front menu card to see the help document for:


\leftindent{\italic{ez-buffers }      

\italic{ez-command }   (filename completion features)

\italic{ez-contents

ez-index}

\italic{ez-footnotes   } 

\italic{ez-keys}        

\italic{ez-ps }             (Getting PostScript from EZ files)

\italic{ez-refs }           (Cross references)

\italic{ez-styles}     

\italic{ez-troff }      

\italic{ezprint}         

\italic{initfiles  }     

\italic{insets   }       

\italic{lookz }             (Add or change styles in a document)

\italic{preview}        

\italic{searching}    

\italic{query-replace}

\italic{spellcheck}       

\italic{templates}        



 \
}\enddata{text,268629828}
