[qv]<notecards>RELEASE1.0>DOC>NOTECARDS-PART2.BRAVO!1

All contents of the NoteFile are viewed through windows. Windows are standard LISP facilities and are manipulated with individual window menus. Windows may be overlapped and can be moved about the screen with the menu or mouse.

Display the menu by placing the cursor in the title bar of the card or box and depressing the right mouse button. Select the relevant command before releasing the button. The commands of this menu are as follows:

Close — similar to Close and Save without access to the sub-menu (See Sections 2.3. NoteCard Menu: Close and Save and 6.2. Mouse Functions.)

Move — moves the card or box to a new location on the screen. When this command is selected, the cursor becomes a square and jumps to the upper right corner of the card. Attached to the square is an outline similar in size to the card. Move this outline by moving the mouse, to a new location. Press the left button and the card will jump to its new position. (See Section 6.2. Mouse Functions for an alternative method.)

Shape — allows the user to specify a new shape and/or location for the existing card or box. After selecting this command a small outline pops up next to the cursor. There are two options for shaping:

Reshape — when the middle button is depressed, the cursor will take on the shape of the nearest corner of the card or box with the outline expanding to meet the opposite corner. Keeping the button down and moving the cursor expands or shrinks the outline to the desired shape. Releasing the button pops the card into its new shape. This method is useful for making small adjustments to a card or box that is already positioned correctly.

Relocate and Reshape — move the outline to a new location, depress the left button, shape the outline by moving the square and release the button. The card will jump to its new location in its new shape.

Shrink — shrinks the card or box down to its title bar. The card or box can be restored by selecting Expand from the window menu or by selecting a pointer icon pointing to the card or box.

When the cursor is outside all cards and boxes, depressing the left button will transform the cursor to a square. This square can be used to either move or close a card or box

Move — keeping the button down, move the square into the card/box near a corner. Then move the square out of the card/box passing the square through the same corner. The square will pick up an outline of the card/box. Move this outline to a new location on the screen by moving the square. Release the button and the card or box will jump to the new position. (See Section 6.1. Window Menu: Move for an alternative method.)

Close — keeping the button down, pass the square several times through the middle of a border of the card or box. This movement will close the card or box. This Close is similar to Close and Save without access to the sub-menu. (See Sections 2.2 NoteCard Menu: Close and Save and 6.1. Window Menu: Close.)

The "Text" NoteCard is designed for the collection of characters typed in by the user. When a text card is created, a blank card is displayed on the screen with a flashing caret indication where to begin typing. Characters may then be edited using the standard LISP text editor, TEdit.

TEdit operates on "selected" text. The editor uses a combination of standard keys and special keys from the Dandelion keyboard to aid the user when editing a card or box. Because these special keys are not obviously labeled on the keyboard a description of location is necessary.

Tab — the tab key. This key is the first key to the left in the second row of keys in the main key pad and is just under the Esc key.

Selected text is highlighted in some way. Insertions begin at the current caret position; deletion and other operations are applied to the currently selected text. Refer to the section above describing the Dandelion keyboard for any unfamiliar keys.

Text is selected using the mouse. There are two regions within a text card: The area containing text, and a "line bar" just inside the left edge of the card. While the cursor is inside the text region, it appears as the normal up-and-left-pointing arrow. When the cursor moves into the line bar, it changes to an up-and-right-pointing arrow.

The left mouse button always selects the smallest things. In the text region, it selects the character the cursor is pointing to; in the line bar, it selects the single line the cursor is pointing to.

The middle mouse button selects larger things (select with both buttons if using a two-button mouse). In the text region, it selects the word the cursor is over, and in the line bar it selects the paragraph the cursor is next to.

The right button always extends a selection. The current selection is extended to include the character/word/line/paragraph you are now pointing at. For example, if the existing selection was a whole-word selection, the extended selection will also consist of whole words.

Ctrl-selection — Holding the ctrl key down while selecting text specifies a "delete" selection. The text will be shown white-on-black. When you release the ctrl key, the selected text will be deleted. To abort a ctrl-selection, release the ctrl key before releasing the mouse button. Reselect with the mouse, if necessary, to achieve this.

Shift-selection — Holding the shift key down while selecting text is a "copy-source" selection. A copy source is marked with a dashed underline. Whatever is selected as a copy source when the shift key is released will be copied to the current caret position. This also works when copying text from one text card to another. To abort a copy, release the shift key before releasing the mouse button.

Ctrl-shift-selection — Holding the ctrl and shift keys down while selecting text is a "move" selection. A move is marked by white-on-black. Whatever is selected as a "move" source when the ctrl and shift keys are released will be moved to the current caret position. This also works when moving text from one text card to another. To abort a move, release the ctrl and shift keys before releasing the mouse button.

Inserting text — Except for command characters, whatever is typed on the keyboard is inserted at the current caret position. The BS key and ctrl-A both act as a backspace, deleting the character just before the caret. Ctrl-W is the backspace-word command.

Deleting text — Hitting the delete key causes the currently-selected text to be deleted. The ctrl-selection method described above may also be used.

Copying text — Use shift-selection, as described above. This operation also works when copying text from one text card to another.

Moving text — Use ctrl-shift-selection, as described above. This operation also works when moving text from one text card to another.

Undoing an edit operation — The lower key of the middle column of the right-hand key pad is the Undo key. It will undo the most recent edit command. Undo is itself undo-able, so you can never back up more than a single command.

Redoing an edit operation — The esc key is the Redo key. It will redo the most recent edit command on the current selection. For example, if you insert some text, then select elsewhere, hitting ESC will insert a copy of the text in the new place also. If the last command was a delete, Redo will delete the currently-selected text; if it was a font change, the same change will be applied to the current selection.

The Text Editor Menu contains a list of commands used to edit text in a FileBox or Text NoteCard. Display the menu by placing the cursor in the title bar of the box or card and depressing the middle mouse button.

Advanced Editing Menu — displays above the text card or box a list of commands used for editing. The Advanced Editing Menu contains selectable menu buttons and places to type text (e.g., what to search for when you do a Find). The menu can be edited, so the usual editing operations work--with one change. Some parts of the menu can’t be selected or operated on; they’re protected. The places you can select are: menu buttons, the margin ruler (see below), and between pairs of curly braces, so: {}.

has two buttons on it. The Quit button needs no further arguments, while the Hardcopy button can take two arguments: the name of the server to print to and the number of copies to print. Fill the text in before hitting the menu button.

Scroll the display to see all possible commands (see Section 2.4. Scrolling). Select the desired command with the left mouse button.

Type a string of characters between the brackets {}, then select Find. The system then hunts from the caret toward the end of document for a match. Selects the first match found; if there is none, nothing happens.

Substitute — substitutes, within the current selection, all instances of a search string of characters, supplied by the user, with a replacement string of characters, supplied by the user.

Hardcopy — takes two optional text arguments. If you specify a server name, the hardcopy will be sent there. You may also specify how many copies of the document you want; if you don’t put anything in the "copies" field, you get one copy.

The Character Looks Menu changes the character looks of the selected characters; the font, character size, and face (bold, italic, etc.). The menu looks like this:

Generally speaking, you select the text you want to change, set the entries in this menu up as you want the text to appear, then make the change by hitting the APPLY button.

If you have a piece of text whose looks you want to copy, select the text and hit the SHOW button. The menu will be filled in to match that text’s looks. You can then APPLY it elsewhere, perhaps after modifying things slightly.

The second line of the menu is a list of character properties which can be modified independently. Each of the menu buttons has three states: If the button appears white-on-black, that property will be turned on; If the button appears with a diagonal line, that property will be turned off; If the button appears black-on-white, that property will be left alone.

Why is it useful to leave a property alone? Suppose you have a paragraph in Times Roman with some bold and some italic in it. If you want to change the font to Helvetica without changing the boldness or italicness, you can do so.

The third line of the menu is a list of font-family names. You can select among them: selecting one family deselects any others. You can also select no family by mouse buttoning between two of the families. If you APPLY with no font family selected, the text will be left in whatever font family it was.

The last line of the menu lets you set the font’s size, and specify any superscripting or subscripting. Fill in the "Size:" field with a number, and APPLYing will change all the selected characters to that size. Leave it empty, and the characters will retain their existing sizes.

For character offsets, you have three choices: Normal characters lie on the baseline; Superscript characters lie above the baseline by the distance you specify (2 points by default); Subscript characters lie below the baseline by the distance you specify (2 points by default). As with font family names, you may mouse in the space between options to neutralize the choice. APPLYing with a neutral choice leaves characters with the super- and subscripting they had, if any.

The Paragraph Looks Menu changes the looks of the selected paragraph. Included is a ruler to indicate paragraph margins. The menu looks like this:

Below this menu, if you scroll it up far enough, is a solid black rectangle, used for setting indentations, and a ruler, used for setting tab stops.

As with the Character Looks Menu, you select the text you want to change, set the entries in this menu up as you want the text to appear, then make the change by hitting the APPLY button.

If you have a paragraph whose looks you want to copy, select the text and hit the SHOW button. The menu will be filled in to match that text’s looks. You can then APPLY it elsewhere, perhaps after modifying things slightly.

The second line of the menu is for specifying how the paragraph margins are to be justified. A Left justified paragraph has a ragged right margin, but is justified flush with the left margin. A Right justified paragraph has a ragged left margin, but is justified flush on the right. A Centered paragraph is centered between the two margins. A Justified paragraph is set flush with both the left and right margins.

The space between lines in a paragraph is called "line leading". You can specify it, in units of printer’s points. You can also leave space in front of a paragraph (without using extra carriage returns) by specifying "paragraph leading," also in units of printer’s points.

You set paragraph margins using the margin ruler on the bottom. There are three margin values: The left margin for the paragraph’s first line, the left margin for the rest of the paragraph, and the paragraph’s right margin. The margin ruler is has three sensitive areas, one for each margin value. Margins are measured in printer’s picas (6 to the inch), with a grain of 1/2 pica. There are 12 points to the pica. Plans exist for allowing different units (and granularity) in the ruler.

The first-line left margin is controlled by the top half of the ruler, left end. To move it, push a mouse button near the left edge, and hold it. Moving the mouse pulls the margin along with it; the margin ruler always shows the current values of the margins. If you push the RIGHT mouse button over the margin, it becomes neutral; i.e., APPLYing the paragraph menu won’t change the first-line left margins of any paragraphs.
The rest-of-paragraph left margin is controlled by the bottom half of the ruler, left end. You move it (and neutralize it) the same way.

Likewise for the right margin, which is controlled by the right end of the margin ruler. There are a couple of differences here. First, you can set the right margin to 0, which will create a "floating" right margin (one that follows the right edge of the edit window or of the printed page). This is signalled by a margin ruler that is as wide as the window, but shows a value of 0 at its right end.

Since the editing window may be narrower than the document, you can also set the right margin beyond the edge of the window, by pulling it with the mouse, and pulling past the window edge. A right margin you can’t see is represented by a double wavy line at the right edge.

You can also set tab stops using the margin ruler. The space below the ruler markings is sensitive to all three mouse buttons, and is used to represent tab stops.

To set a tab, you first nned to choose what kind of tab you want, using the line starting with "Tab Type:." Make your choice of tab type the same way you’d choose a font family. Left tabs are regular typewriter type tabs; Right tabs take the succeeding text and push it so it is flush-right against the tab stop location; Centered tabs cause the succeeding text to be centered about the tab stop; Decimal tabs (not implemented) cause the succeeding text to have its decimal point lined up on the tab stop. Tab stops are shown in the margin ruler as small arrows with suggestive tails.

To create a new tab stop, use the middle mouse button. In the region below the ruler markings (and the numbers!), point to where you want the tab to be, and press the middle mouse button. The tab should appear; as long as you hold the button down, the tab will follow the mouse around, so you can adjust its location. To move a tab stop, point at it and press the left mouse button. As long as you hold it down, the tab stop will follow the mouse. To delete a tab stop, point at it and press the right mouse button.

Change Font — pops up three seperate menus allowing the user to change the font of selected text; font type, style and size. Select the characters that are to be changed before selecting this command.

The "Graph" NoteCard is designed to allow the user to construct a layout of user-defined words or phrases, called nodes, which may be linked together with lines to indicate some structure. Each node may be easily moved about the card without losing its links.

The Graph Editing menu is a standard feature of LISP. Display the menu by depressing the right mouse button in the body of the card. Select the desired command before releasing the button.

Prompts for several of the following commands are viewed in the black window at the top of the screen. To close the menu before making a selection, move the cursor outside the menu before releasing the button.

Add Node — pops up a window prompting the user to type in a node label name followed with a carriage return. The label will appear next to the cursor within the graph card. Move the label, by moving the cursor, to its desired location. Plant the label by clicking any mouse button.

Delete Node — select the node to be deleted with the left mouse button. The black prompt window will expect a "Y" for yes or an "N" for no followed by a carriage return to confirm deletion.

Add Link — select the "from" node and the "to" node with the left mouse button. If a another link is made between the same two nodes in the opposite direction, the lines representing the links will not be visible.

Label Smaller — decreases the font size of the selected node. Repeat this command as necessary to achieve the desired font size. This command does not work on pointer icon labels.

Label Larger — increases the font size of the selected node. Repeat this command as necessary to achieve the desired font size. This command does not work on pointer icon labels.

Sketch/Map is a graphics NoteCard in which the user is able to place text and put down groups of points to achieve desired shapes. Each group of points is called a graphic object. This card may also include maps.

The Sketch Editing Menu is a standard feature of LISP and is designed to aid the user in creating sketches. Display the menu by depressing the middle mouse button (depress both buttons if using a two-button mouse) in the title bar of the card. Select the desired command before releasing the button.

If more than one command is going to be executed, it is convenient to keep the menu visible. This is achieved by selecting Fix Menu from the Sketch Menu (see Fix Menu below). Select commands with the left or middle mouse button.

Delete — deletes a selected box, circle, line drawing, or pointer icon. Note that delete cancels the entire graphic object. All graphic objects are identified when Delete is chosen, and the user must select the object to be deleted. To cancel this selection before deleting, place the cursor outside the sketch card and click a mouse button.

Move — moves a selected point of a graphic object. Depending on which point is selected, only that point of the entire object will be moved. For example, moving the radius point of a circle will change the radius while moving the center point will move the whole circle. Text is moved by designating where the center of the string is to be placed.

Change — enables the user to change the looks of text, a line or a curve. All graphic objects are identified when Change is chosen, and the user must select the object to be changed. The Change commands vary for different types of objects because each has different properties. If in doubt, select the object that is to change and see what choices are offered. Selecting outside the offered menu will not change anything.

Text — change enables the user to change the font size and justification of the text string relative to its position. Select from the following sub-menu:

Size — displays a pad of numbers from which the user chooses the brush size and clicks OK to exit. If brush size is not to change, select OK to cancel the command.

Boxes and Lines — change enables the user to change the brush size by displaying a pad of numbers from which the user chooses the brush size and clicks OK to exit. If brush size is not to change, select OK to cancel the command.

Map — displays a map of the world. When selected, a map of the world appears on the screen. Outline the section of the map that is to appear in the sketch card by placing the cursor at the top of a region surrounding this section, depressing the left mouse button, sweeping the cursor across the area and releasing the button. The map of the world closes. The user is now required to specify an area in the card where the portion of the map is to be displayed. Place the cursor in the card, depress the left mouse button and sweep the cursor down to indicate the desired area. The area may be smaller or larger than the original map selection.

— to sketch a box. Depressing the left or middle mouse button, designate a corner of the box, sweep the cursor diagonally to shape the box, and release the button. To cancel this command before beginning the box, move the cursor outside the card and depress a mouse button.

Text — pops up a window prompting the user to type in a text string followed by a carriage return. Place the cursor in the sketch card. After pressing return, the text string will appear next to the cursor. The string can be located by moving the cursor with the mouse and depressing any mouse button to plant the string at the desired location. (See 9.2. Sketch Mouse Functions for an alternative way of entering text.)

This command cannot be canceled. If selection was not intended, follow through with the command and then use Delete or Undo to erase the string.

— to sketch closed lines. A line is defined by a number of special points called knots. These knots are placed in the card by depressing any mouse button while moving the cursor in a desired pattern. To draw a line through these knots, move the cursor outside the card and click any mouse button.

— to sketch an ellipse. Indicate the center of the ellipse by depressing the left mouse button in the card. Indicate the semi-major axis by depressing the left mouse button in the card. Indicate the semi-minor axis by depressing the left mouse button in the card.

— to sketch a circle. Indicate the center of the circle by depressing the left mouse button in the card. Indicate the point of the circumference of the circle by depressing the left mouse button in the card.

Selection of this command displays a list of previously performed events. with the most recent event at the top of the list. To undo an event, select it from this list. If the same graphic object has been changed more than once, the changes to it must be undone in the reverse order in which they were performed. ("Wire" refers to lines.)

Brush — brush referes to a lines width and shape. used to change the default brush size. A pad of numbers is displayed from which the user chooses a brush size. Select OK to exit. If the brush size is not to change, select OK to cancel the command. The most recent change becomes the default for all Sketch/Map NoteCards created in the current NoteFile. The brush for an existing object can be changed by using the Change command above. (Brush referes to a line’s width and shape.)

This command is followed by a gray triangle pointing to the right indicating a sub-menu. This sub-menu is used to change the brush shape or size. To retrieve this sub-menu, slide the cursor to the right through the triangle, and select the desired sub-command before releasing the button.

Shape — enables the user to change the brush shape. The most recent change becomes the default for all Sketch/Map NoteCards created in the current NoteFile. Choose from the following sub-menu:

Zoom — changes the scale of the display. The user designates a portion of the sketch that will appear in the card by depressing any mouse button at a corner and sweeping the cursor over the portion to be displayed. The section may be smaller or larger than the current card size.

AutoZoom — changes the scale around a selected point. Holding the left button down will zoom the selected point to the nearest edge. Pressing the middle button will zoom the nearest edge point to the cursor. Holding either button down will zoom continuously in the appropriate direction. Use Home to return the sketch to its original form.

Entering Text — click the left mouse button inside the sketch card to indicate where the center of the text string is to appear. A flashing caret will indicate where to begin typing. Use Move to reposition the text string.

Drawing Lines — using the middle mouse button (both buttons if using a two-button mouse) enables the user to sketch straight lines one at a time. With the cursor in the sketch card, depress the button to indicate the origin. Lines may be drawn in two ways:

a.Keeping the mouse button down, pull the cursor away from the point of origin. A line will follow the cursor. Terminate the line by letting up on the button. Additional lines may be drawn using the same method, each line beginning where the last finished. Terminate the sequence by clicking outside the card.

b.After indicating the origin, move the cursor to the end point and depress the button. A line will connect the two points. This line will follow the cursor until the button is released. To create additional lines, continue to depress and release the button. Each additional line will begin where the last finished. Terminate the sequence by clicking outside the card.

Replace — select the first character to be replaced with the left mouse button and extend the selection with the middle button (both buttons if using a two-button mouse). The selected string is shown as white on black. Begin typing the new text. The old text is deleted as the new text is typed.

Characters or words within a string may not be moved or copied. A text string may be moved similarly to other graphic objects by using the Move command (see Section 9.1 Sketch Editing Menu.)

A system bug is not a result of incorrect input by the user. It is a problem in the system which appears occasionally due to a bug in a particular function being initiated by the user.

Because it is helpful to the designer of this system to know of any errors that occur, we request that a log be kept of problems encountered. Common problems and their recoveries are:

Occasionally a window pops up with an error message such as; Unknown Card Type. Write down what occurred before the window popped up, including the message displayed in the break window. Place the cursor in the body of the window, depress the middle mouse button (depress both buttons if using a two-button mouse) and select "↑" to close the window. This operation must be performed before proceeding with the normal input.

Occasionally text in Text NoteCards and FileBoxes is not be displayed properly. If this occurs, scrolling the card up or down usually corrects the display (see Section 2.4. Scrolling). If this doesn’t work, select Restart Editor from the Text Editor Menu (see Section 7.4. Text Editor Menu: Restart Editor).

This command may be helpful in repairing the NoteFile when there are inconsistencies or problem areas in the actual NoteFile. Select this command from the Main Menu. (See Section 5. Main Menu: Repair NoteFile.)