ASEDIT - help 1.30. (C) A. Stochniol   167 227 1 11 10 168 1000 676 1001 1104 1002 1542 1003 1912 1004 2279 1005 2823 1006 3032 1007 3183 100100 3481 100200 4395 100400 4724 100401 5340 100500 5584 100600 6122 10060000 6901 20 8405 2000 9343 200001 10120 200002 10633 2001 11469 2002 11822 2003 12368 2004 12913 2005 13389 2006 13603 2007 14925 30 15237 3000 15558 3001 15851 3002 16329 3003 16588 3004 16858 3005 17373 300400 18611 300401 19176 300000 19685 300200 21050 30020001 23336 30020002 23511 30020003 23802 300300 24006 40 24657 50 24774 5000 25439 5001 26039 5002 26527 500200 26952 50020000 27128 500201 27447 50020100 27627 500202 27950 50020200 28113 500203 28416 50020300 28566 500204 29005 500205 29284 5003 30227 5004 30621 500400 31047 50040000 31213 500401 32044 500402 32229 500403 32464 500404 32673 500405 32816 500406 33004 500407 33132 500408 33260 500409 33388 500410 33516 50041000 33646 5005 35961 500500 36191 50050000 36357 500501 37025 500502 37267 500503 37475 500504 37727 500505 37850 500506 37941 500507 38064 500508 38187 500509 38310 500510 38433 500555 38557 60 39214 80 39334 8000 39819 8001 40436 8002 40722 8003 41891 800200 42161 800201 42811 800202 44907 800203 45526 80020207 48312 80020100 49508 80020101 49736 800101 50010 80010101 51965 80010102 53376 80010103 53447 8050 53504 805000 54286 805001 55146 805002 56138 80010100 56687 27 76203 77 78096 7700 78357 7701 78712 7702 78838 7703 79165 7704 79497 7705 80185 7706 80551 770600 81116 7707 83178 800104 83590 800105 84129 80010500 84438 80010501 85760 80010502 85980 80010503 86128 80010504 86473 80010505 86878 80010506 87146 80010507 88081 80010508 88825 80010509 88890 80010510 90191 800106 91082 2701 95574 2703 96160 2704 96585 2705 97042 2706 97347 2708 98172 2709 98568 2710 99247 2711 99927 2712 100609 2743 101430 2715 101827 2716 101911 2717 102321 2718 102689 2719 103308 2720 103604 2726 103840 2728 106548 2729 107740 2730 108317 2731 108525 2733 108894 2734 108989 2735 109296 2736 109423 2737 109589 2739 110456 2740 110895 2745 111079 2747 111480 2744 112052 1800000000 112540 200000 2001 200100 2000 200101 200001 100700 100200 100701 200002 100101 200002 10010000 2726 100300 200002 10040000 100401 10040001 2726 10050000 2726 200200 2006 200201 2004 200202 2007 200203 200001 200204 200002 200300 2006 200301 2004 200302 2007 200303 200001 200304 200002 200400 2007 200401 2002 200402 2003 200403 200001 200404 200002 200500 2007 200501 2002 200502 2003 200600 20 200601 50 30000000 300200 30020000 300000 300100 3000 80010600 2726 80020000 8002 80020001 800201 80020102 8000 80020103 8001 80020104 8002 80020105 8003 80020200 10 80020201 20 80020202 30 80020203 40 80020204 50 80020205 60 80020206 80 80020208 8000 800100 800202 800102 27 800103 77 2700 2739 2702 2007 270100 2000 270300 2006 270301 2004 270302 2007 270303 2709 270304 200001 270305 200002 270400 2006 270401 2004 270402 2007 270403 2709 270404 200001 270405 200002 270500 2007 270501 2002 270502 2003 270503 2709 270504 200001 270505 200002 270600 2701 270601 2716 270800 2739 270900 2710 270901 2711 270902 2712 271000 2711 271001 2712 271002 200001 271003 200002 271100 2710 271101 2712 271200 2710 271201 2711 274300 3005 271600 2719 271800 7704 271900 2718 272000 100200 272001 200002 272800 2704 272801 2729 272802 2705 272900 2709 272901 2728 272902 200001 272903 200002 273100 200002 273300 1006 273400 2708 273401 2739 273500 2001 273600 3001 273700 2745 273900 2708 274000 2739 274001 2734 274002 200002 274500 2737 274700 7707 2713 2704 2714 7700 2721 3003 2722 800201 2723 7705 2724 7706 2732 2705 2738 2715 2741 7706 2746 7707 2742 80010509 2748 2701 274400 300000 2707 805001 2725 805000 2727 8050 30040000 300400 30040001 300400 30040002 300400 30040003 300400 30040004 300400 30040005 300400 30040006 300400 30040007 300400 30040008 300400 30040009 300400 300500 3005 300501 3005 30040100 300401 30040101 300401 30040102 300401 30040103 300401 30040104 300401 30040105 300401 30040106 300401 30040107 300401 30040108 300401 30040109 300401 400000 80010510 400200 4002 400201 4002 400202 4002 400203 4002 400204 4002 500000 50 500100 50 50020401 50 50020501 50 500001 50041000 500101 50041000 50040600 50041000 50040700 50041000 50040800 50041000 50040900 50041000 50041000 50041000 50050400 500555 50050500 500555 50050600 500555 50050700 500555 50050800 500555 50050900 500555 50051000 500555 50055500 50041000 50020400 500205 50020500 500204 5006 2006 500300 5003 500301 5003 500302 5003 500303 5003 600300 0 6003 0 600301 0 6003 0 600302 0 6003 0 600303 0 6003 0 600304 0 6003 0 600305 0 6003 0 600306 0 6003 0 600307 0 6003 0 600308 0 6003 0 600309 0 6003 0 80010102 50041000 80010103 8050 80010508 800202 80020300 80010507 80020301 770600 80020302 800200 770100 1001 770101 1003 770200 1001 770201 1003 770700 770600 77060000 7706 77060001 7707 8009 1800000000 1800000001 2006 1800000002 4001 1800000003 2007 1800000004 3004 1800000005 3002 1800000006 1004 1800000007 2004 1800000008 10 1800000009 5001 1800000010 20 ~0000000001

@(#) asedit help file: Ver. 1.300, 6 June 1994
@(#) Copyright 1992 - 1994, Andrzej Stochniol, London, UK.

@(#) special version for Emacs mode

~0000000010
	File menu (Alt+F)

The File menu provides following commands:

    New 	- creates a new asedit window

    Open... 	- opens an existing file

    Close 	- closes the active file and window

    Save 	- saves the active file

    Save As... 	- saves the active file under a new name

    Insert... 	- inserts a file into the edited text

    Print... 	- prints the active file or a selection

    Exit 	- exits from the current window and quits ASEDIT if that was the last window
~0000001000
	File|New

The File|New command opens a new asedit window with a default NoName1 file (or NoName2, and so on).

You will be prompted for the name of the file when you attempt to save the edit window contents. This allows you to start typing as soon as the window is opened.

The new edit window is completely independent from the previous one(s) (except the help system which is shared between all asedit windows).

~0000001001
	File|Open...  (F3)

The File|Open command displays the   Open a File   dialog box, where you select or enter the name of a file to open.

If the current window is being used to edit any text, a new window will be created to edit the requested file.

The new window is completely independent from the previous one(s), except the help system which is shared between all asedit windows.

_________
See also:
  Pop-up menu 

~0000001002
	File|Close

The File|Close command closes the edited file and its associated window (if it is not the last asedit window).

If you've modified a file without saving it, you get first the  File not Saved !  warning dialog and you have to decide whether or not to save the file. Alternatively you can abandon the operation by activating the Cancel button.

~0000001003
	File|Save (F2)

The File|Save command saves the edited file to disk. Pressing the F2 key from within the program also performs the same task.

If you haven't specified a file name yet (i.e. your text is called NoName1, NoName2, or so on ) you will be prompted to do so in the same way as in File|Save As... command.
_________
See also:
  Pop-up menu 

~0000001004
	File|Save As...

The File|Save As command opens up the  Save As   dialog box, where you can save the edited file under a different name.

You can enter the new file name or select it from Files and Directories boxes, and then activate the OK button.

If you use the name of an existing file, ASEDIT prompts you with   Overwrite ?   question dialog. You must then decide to overwrite the existing file or Cancel the operation.

Note: having saved the file all windows containing the old file name are updated with the new one.

~0000001005
	File|Insert...

The File|Insert command opens up the   Insert a File   dialog box, where you select or enter a file name.  Contents of the file will be inserted at the current cursor position.

~0000001006
	File|Print...

The File|Print command opens up the   Print   dialog box, where you select what to print and which printer to print on.

~0000001007
	File|Exit

The File|Exit command closes all ASEDIT windows and removes the program from the memory (quits it).

If you've modified a file without saving it, ASEDIT prompts you to do so before exiting. See the  File not Saved !  warning dialog.

_________
See also:
  Pop-up menu 

~0000100100
	Open a File dialog box

Open a File dialog box comes up when you choose the File|Open menu command.

To open a file:
1.  Type or select the name of the file you want to open. If the file is not listed in the current directory, either type the directory name in front of the document name, or select the directory in the Directories box.
2.  Choose OK.

If you would like to view only the file, set the Open for view only button.

If the current window is being used to edit any text, a new window will be created to edit the requested file.

For a detail description how to select a file see:
	 Selecting a file 

Note: if a file is read only you cannot edit it and it is opened automatically in the view only mode. The view only mode can be easily recognized by lighter colour of the main window and a letter 'R' in the Status Line (you would find that many menu options are insensitive as well).

~0000100200
	File not Saved ! warning dialog

File not Saved ! warning dialog comes up when you choose either the File|Close or File|Exit menu commands and you've modified a file without saving it.

You have to decide whether or not to save the file. Alternatively you can abandon the operation by activating the Cancel button.

~0000100400
	Save As dialog box

Save As dialog box comes up when you choose the File|Save As menu command.

To save file under a new name:
1.  Type or select the new file name. If the required file is not listed in the current directory, either type the directory name in front of the file name, or select the directory using the Directories box.
2.  Choose OK.

If you use the name of an existing file, asedit prompts you with  Overwrite ?   question dialog.  You must then decide to overwrite the existing file or Cancel the operation.

For a detail description how to select a file see:
	 Selecting a file 

~0000100401
	Overwrite ? question dialog

You've just specified name of a file which already exists. You have to decide now either to carry on the operation (i.e. overwrite the previous file contents) or Cancel the whole operation altogether.

~0000100500
	Insert a File dialog

Insert a File dialog comes up when you choose the File|Insert menu command.  Use this dialog to insert a whole contents of a file in a current cursor position.

To insert contents of a file:
1.  Type or select the name of the file you want to insert. If the file is not listed in the current directory, either type the directory name in front of the document name, or select the directory in the Directories box.
2.  Choose OK.

For a detail description how to select a file see:
	 Selecting a file 

~0000100600
	Print dialog

Print dialog comes up when you choose the File|Print menu command.

To select print range	Select this
___________________________________
Entire document		Complete document radio button
Selected text only	Selected text only radio button

Setting printer:
Choose one from the list of Printers installed. Having done so, the printer name is copied to the Print using: area, where you can add extra parameters (e.g. "-n 3" would give you three printed copies). You may even specify your own/special print command.

You can also use the print dialog to apply UNIX filters to either a selected text or the entire edit buffer.  For details see:
	 Applying a UNIX filter 

(there you can find out how to write out a selected text to a file, and more ...).

~0010060000
	Applying a UNIX filter

You can use the Print dialog to apply UNIX filters to either a selected text or the entire edit buffer. To do that specify a required filter command in the  Print using:  area.

If you want to intercept output of the filter use a specialized Tools|Filters|New Filter command. With that command you can direct output to the current window, a new window or a text dialog.

The examples below show how useful the Print dialog with UNIX filters can be.

Block write.  Sometimes it is very useful to save a selected text into a file. To do this:
- select the text
- in the Print dialog set the  Selected text only  button (to pop-up the Print dialog use the File|Print command)
- in the  Print using:  area write the following command:
	cat - > file_name
- activate OK button

You can use the above method together with other UNIX filters to implement a number of interesting features. For example using as a print command:
	fmt > file_name
would create a formatted output on the file_name (further details see man pages for fmt), and the following "print" command:
	spell > file_name
would create a file with list of spelling errors.

Notes:
You should substitute the "file_name" above with your chosen file name. But remember, that the system does not check if such a file already exists, so carefully choose the name to avoid overwriting your "precious" file.
Most of the UNIX filters operate on complete lines, so DO include in the selected text the final line feed.

~0000000020
	Edit menu  (Alt+E)

The Edit menu provides commands to cut, copy, and paste text in the edit window.
If you make a mistake, you can undo changes. You can also reverse the effect of your recent undo(s).

Each of the Edit menu commands is listed below:


	 Undo 

	 Redo 

	 Cut 

	 Copy 

	 Paste 

	 Clear 

Before you can use most of the commands in this menu, you need to know about selecting text (because most editor actions apply to selected text).
You can select text either with keyboard or with the mouse. See  Text selection  for more information.

Once you have selected text, the edit commands in the Edit menu and the Clipboard become available. The  Clipboard  is the magic behind cutting and pasting. It's a special area in X Window System that holds text that you have cut or copied, so you can paste it elsewhere. The Clipboard works in close co-operation with the commands in the Edit menu.

~0000002000
	Edit|Undo	(Ctrl+Z)

The Edit|Undo command restores the edited file to the way it was before the most-recent edit or cursor movement.
Undo performs action by single back-editing actions, i.e. sometimes you have to make several undoes to restore the previous editor state. It is especially true for some group edit functions (especially true for Motif 1.1 versions).

There are restrictions on what and how many operations can be undone.
Undo will insert characters that have been deleted, delete any characters that have been inserted and move the cursor back to a position prior to the edit action that changed the text.

To reverse the effect of the most recent Undo command use:
	 Redo 

_________
See also:
  Alternate edit shortcut keys 
  Pop-up menu 

~0000200001
	Alternate edit shortcut keys

The following alternate shortcut keys for the most common edit operations are supported:

  Edit|Undo	-  Alt+BackSpace
  Edit|Redo	-  Shift+Alt+BackSpace
  Edit|Cut  	-  Shift+Del
  Edit|Copy	-  Ctrl+Ins
  Edit|Paste	-  Shift+Ins

Note:
Both sets of shortcut keys for Clipboard operations can be used from within any text area, including those in dialogs. Their scope of action is wider than the Edit|Cut/Copy/Paste commands, which are limited to the main text area(s).
~0000200002
	Pop-up menu

Asedit supports the most common editing actions in a separate quick editing pop-up menu. It includes the following commands:

	Undo

	Cut
	Copy
	Paste

	Open...
	Save

	Exit

Undo, Cut, Copy and Paste perform the same actions as appropriate commands in the Edit menu.
Open, Save and Exit perform the same actions as appropriate commands in the File menu.

To activate the pop-up menu press the right mouse button (when inside the main area). Then to select the command:
  - drag the mouse to the command you want to choose;
    or
  - release the right button, then use any of the following methods to select the command you want:
	click the command,
	or
	use the up and down arrow keys to go to the command, then press Enter to select it,
	or
	press the underlined letter of the command you want to select.


~0000002001
	Edit|Redo	(Shift+Ctrl+Z)

The Edit|Redo command reverses the effect of the most recent  Undo  command.

The Redo command only has an effect immediately after an Undo command or after another Redo command. A series of Redo commands reverses the effects of a series of Undo commands.

_________
See also:
  Alternate edit shortcut keys 

~0000002002
	Edit|Cut	(Ctrl+X)

The Edit|Cut command removes the  selected text  from your document and places the text in the Clipboard.

To cut text to the Clipboard:
1.  Select the contents you want to remove.
2.  Choose Edit|Cut, or press Ctrl+X.
    The contents will be placed in the Clipboard.

You can then paste that text into the same or any other document with the Edit| Paste   command.

The text remains in the  Clipboard  so you can paste it many times.

_________
See also:
  Alternate edit shortcut keys 
  Pop-up menu 
~0000002003
	Edit|Copy	(Ctrl+C)

The Edit|Copy command leaves the  selected text  intact and places an exact copy of it in the Clipboard.

To copy text to the Clipboard:
1.  Select the contents you want to copy.
2.  Choose Edit|Copy, or press Ctrl+C.
    The contents will be placed in the Clipboard.

You can then paste that text into the same or any other document with the Edit| Paste  command.

The text remains in the  Clipboard  so you can paste it many times.

_________
See also:
  Alternate edit shortcut keys 
  Pop-up menu 
~0000002004
	Edit|Paste	(Ctrl+V)

The Edit|Paste command inserts the text from the  Clipboard  into the current text widget at the cursor position. This command is unavailable if the Clipboard is empty.

To paste text from the Clipboard:
1.  Place the insertion point where you want to insert the Clipboard contents.
2.  Choose Edit|Paste, or press Ctrl+V.

_________
See also:
 Edit| Cut  command
 Edit| Copy  command
  Alternate edit shortcut keys 
  Pop-up menu 
~0000002005
	Edit|Clear

The Clear command removes the selected text but does not put it into the  Clipboard .

This means you cannot paste the text as you could if you had chosen Edit| Cut  or Edit| Copy .

~0000002006
	Text selection

You can select (highlight) text either with keyboard or with a mouse.

From the keyboard simply:

    -	Press Shift key while pressing any key that moves the cursor (arrows etc.)
	To select the whole text press Shift+Ctrl+/ (to de-select all press Shift+Ctrl+\).

With a mouse:

    -   Drag the mouse pointer over the desired text while holding down the left mouse button. If you need to continue the selection past a window's edge, just drag off the side and the text will automatically scroll.

    -   In addition to the click-and-drag technique for text selection the multiple click technique is supported:
a double-click selects a word, triple-clicking selects the current line, and quadruple-clicking selects all the edited text.
You can extend the above technique to select multiple objects (words or lines) when you drag the mouse after the last button press (note: do not release the button before the drag operation). To select a number of words click once and press, then drag the mouse. To select a number of lines double click and press, then drag the mouse.

    -   To extend or reduce a selection, hold Shift key and click.


Once you have selected text, the Cut and Copy commands in the  Edit menu  become available, as well as most of the commands in the  Tools menu .

~0000002007
	Clipboard

For the user Clipboard is a temporary storage area for cut or copied text.  You can paste the contents of the Clipboard into any ASEDIT file.

Note that with keyboard shortcuts for Cut/Copy/Paste  Clipboard functionality is extended to all text areas in the program (including dialogs).

~0000000030
	Search menu  (Alt+S)

The Search menu provides commands to search for text, replace text, go to a specific line, use bookmarks and match delimiters.

Each of the Search menu commands is listed below:

	 Find... 

	 Find Next 

	 Change 

	 Go to Line... 

	 Bookmark  > 

	 Match delimiter   > 

~0000003000
	Search|Find... (Ctrl+Q,Ctrl+F)

The Search|Find command displays the  Find  dialog box, where you type in the text you want to search for.
In the dialog box there are several options that affect the search.

You can also activate this command using Ctrl+Q,Ctrl+F key shortcut.

~0000003001
	Search|Find Next (Ctrl+L)

The Find Next command repeats the last Search| Find  command or searches for the current selection.

You can also activate this command using a Ctrl+L shortcut key.

All settings made in the Find dialog box remain in effect when you choose Find Next.

To search quickly for another occurrence of a text, highlight it and press Ctrl+L (do NOT include a new line, otherwise the highlighted text is not treated as an item to search for).

~0000003002
	Search|Change (Ctrl+Q,Ctrl+A)

The Change command brings up the  Change  dialog box, where you type in the text you want to search for and text you want to replace it with.

You can also activate this command using Ctrl+Q,Ctrl+A shortcut key.

~0000003003
	Search|Go to Line...

The Go to Line number command brings up the  Go to Line  prompt dialog, where you type in the line you want to go to.

ASEDIT displays the current line number and column number in the Status Line located just below the edit window.

~0000003004
	Search|Bookmark

The Bookmark command displays another menu that consists of two entries: Set and Go to. They allow you to use up to ten bookmarks in each asedit window.
Use one of two entries in the menu:


	 Set 	- to set a bookmark

	 Go to 	- to go to a bookmark


Note:  Bookmarks preserve their positions during editing but there are situations that this doesn't make sense. Then the active bookmarks will be set to point to the text beginning (for example when you delete the whole text).


~0000003005
	Search|Match delimiter

The Match delimiter command displays another menu that consists of two entries: Forward and Backward. These entries are use to search for the matching delimiter (for example [, }, " etc.).

The following pairs are supported: {}, (), [], <>, "", ``, //, '', \\ .


To search for the matching delimiter:

1. position the cursor just before the delimiter (for example {, ], or "),
2. use one of the two entries in the menu:

	Forward	- to match forward

	Backward	- to match backward

    - or -

    use Ctrl+Q,Ctrl+[ shortcut key to match forward,

    and Ctrl+Q,Ctrl+] shortcut key to match backward.


Note that "backward" and "forward" make sense only for delimiters for which the pair direction is not implied (delimiters like: ", ', ,`, /, \).

For pair delimiters for which the direction of the matching is implied by the current character, you can use either of the commands. For example you can use either Ctrl+Q,Ctrl+[ or Ctrl+Q,Ctrl+] shortcut key to find the matching bracket for "["  (the same goes to any of the following characters: {}, (), [], <>).

Note also that the resource "*selectDelimitedText" controls if the text delimited by the pair of characters is automatically selected.

~0000300400
	Set Bookmark

To set a bookmark, position the cursor at a required point and use the Search|Bookmark|Set menu item.  Then select one of ten (1,2,3, ..., 9,0) bookmarks available.  Alternatively you can use following shortcut keys:
 To set Bookmark	Use
 ____________________________________
    1		Ctrl+K,Ctrl+1
    2		Ctrl+K,Ctrl+2
    3		Ctrl+K,Ctrl+3
	...
    9		Ctrl+K,Ctrl+9
    0		Ctrl+K,Ctrl+0

To go to an already set bookmark use Search|Bookmark|Go to|# or use the following shortcut key: Ctrl+Q,Ctrl+#  (where # denotes the bookmark number).

~0000300401
	Go to Bookmark

To go to a bookmark use the Search|Bookmark|Go to menu. Then select the required bookmark number. Alternatively you can use following shortcut keys:
 To go to Bookmark	Use
 ____________________________________
    1		Ctrl+Q,Ctrl+1
    2		Ctrl+Q,Ctrl+2
    3		Ctrl+Q,Ctrl+3
	...
    9		Ctrl+Q,Ctrl+9
    0		Ctrl+Q,Ctrl+0

Note that the required bookmark must be already set. In the menu Search|Bookmark|Go to  only bookmarks already set are available (the others are greyed out).

~0000300000
	Find dialog box

You use the Find dialog box to find a string in your text file.
This dialog contains Text to Find: input box, Options check boxes and Direction radio buttons.

The Text to Find: input box is where you enter the string to search for.

Options govern the kind of strings that ASEDIT searches for:
  Case sensitive   - check this box if you want to differentiate uppercase from lowercase;
  Whole words only - check this box to search for words only (that is, the string must have punctuation or space characters on both sides).

Direction specifies which way you want to search, starting from the current cursor position:
  Forward  or
  Backward.

Once you've entered the search string in the input box, you can choose one of the buttons in the dialog action area:
 Select		To
 __________________________________________
  Find Next	-  search for a next occurrence of the string,
  Close	-  close the Find dialog (pop it down),
  Help	-  call the help.

Note: pressing Enter in the Text to Find: input box activates the default button in the action area, i.e. the one marked with an additional outline.

The Find dialog stays on the screen after a search is completed so you can easily find a next occurrence of the string searched for. If you want to close the dialog use the Close button.

_________
See Also:
  Change dialog box 

~0000300200
	Change dialog box

The Change dialog box, where you type in the text you want to search for and text you want to replace it with, is almost identical to the  Find  dialog box.

The Change dialog box contains Text to Find: input box, Change To: input box, Options check boxes and Direction radio buttons.

The Text to Find: input box is where you enter the string to search for.

The Change To: input box is where you enter the string into which found the found string would be changed to.

Options govern the kind of strings that ASEDIT searches for:
  Case sensitive   - check this box if you want to differentiate uppercase from lowercase;
  Whole words only - check this box to search for words only (that is, the string must have punctuation or space characters on both sides).

Direction specifies which way you want to search, starting from the current cursor position:
  Forward  or
  Backward.

Once you've entered the search string and the replacement string in the input boxes, you can choose one of the buttons in the dialog action area:
 Choose			To
 ________________________________________________
  Find & Verify	-  begin a search for a next occurrences of the search string,
  Change All	-  search for all occurrences of the search string and change them all to the string entered in the Change To: input box,
  Close	-  close the Change dialog (pop it down),
  Help	-  call up help.

If the Find & Verify button has been selected and the text found, the  Change Prompt  question dialog pops-up. You then have to verify if the text found is to be changed, skipped or the whole operation cancelled/stopped.

When you use Change All option and you've started the search from within the file and you reach either the end of the file (forward search direction) or beginning of the file  (backward search direction), you are prompted with  Search  question dialog.
You can then decide to continue the search operation or not. If you've decided to continue, when the search arrives back at the starting position the   Change All   information dialog shows the number of items changed.

The Change dialog stays on the screen after a search is completed so you can easily start a new change operation. If you want to close the dialog use the Close button.

~0030020001
	Change Prompt question dialog

You've just found text to change. You have to decide now to change this occurrence, Skip it or Cancel (stop) the whole operation.

~0030020002
	Search question dialog

You had started the search from within the file and you've just reached either the end of the file (forward search direction) or beginning of the file  (backward search direction).

You have to decide now either to continue the change operation or not.

~0030020003
	Change All information dialog

The Change All action has just been completed. The dialog shows the number of items changed.

Close the dialog using mouse or just press Enter key or Spacebar.
~0000300300
	Go to Line prompt dialog

Go to Line prompt dialog comes up when you choose the Search|Go to Line menu command.

You have to type in a line number you want to go to (position the insertion cursor at). Then press Enter key or activate the OK button.

If you've entered a line number that does not exist, ASEDIT prompts you with the Error! dialog. This dialog shows also the existing range of line numbers. When you dismiss this error dialog you return to the Go to Line prompt dialog to respecify the line number.

Note that ASEDIT displays the current line number and column number in the status line located just below the edit window.

~0000000040
	View menu  (Alt+V)

Sorry, this menu and its' help intormation are not available in the free release!


~0000000050
	Tools menu  (Alt+T)

The Tools menu provides additional tools for text processing. It includes the following:

     Spell 		-  check spelling

     Sort 		-  sorting

     Format >  		-  margins formatting and indentation

     Change Case to >  	-  character case changing

     Filters >  		-  User definable filters

     Commands >  	-  User definable commands


Note that the following commands are unavailable if no text is selected in the edit window:
  Spell,  Sort, Format,  Change Case to and Filters.

Remember that you can always undo the action if it does not produce what you wanted.

_________
See Also:
  Text selection 

~0000005000
	Tools|Spell

The Tools|Spell command is used to run the spell checking program for the selected text. To check all of your document select it first (for this use quadruple mouse click or Shift+Ctrl+/ ).

Any word not found in the spell dictionary is displayed in the "Misspelled words" text dialog.


Notes:
The command is unavailable if no text is selected in the edit area.
To use a non-standard spell checker redefine the "spellCmd" in the Asedit application defaults file.
_________
See Also:
  Tools menu 
  Filter customization  if you want to understand or change "spellExt"

~0000005001
	Tools|Sort

The Tools|Sort command is used to sort the selected text alphabetically (unless redefined). The program automatically extends the selected text to include whole lines.


Notes:
The command is unavailable if no text is selected in the edit area.
To use a non-standard sort (or sort options) redefine the "sortCmd" in the Asedit application defaults file.
_________
See Also:
  Tools menu 
  Filter customization  if you want to understand or change "sortExt"

~0000005002
	Tools|Format

The Tools|Format command is used to format the selected text in a following way:

     Move Left... 		-  move it left

     Move Right... 	-  move it right

     Indent with... 	-  indent it with a specified text

     Reformat... 		-  fill the text between left and right margins

     Expand tabs 		-  expand the Tab characters

     Unexpand 		-  unexpand spaces to Tab characters


~0000500200
	Tools|Format|Move Left

This command displays   Move Left   dialog box, where you enter the number of characters you want to move the selection by to the left.

~0050020000
	Move Left dialog box

You use the Move Left dialog box to move the selected text to the left by some spaces. Enter the number of spaces you want to move the text by to the left, then press Enter key or OK button.

Note that before processing the selection is automatically extended to the whole line(s).


~0000500201
	Tools|Format|Move Right

This command displays   Move Right   dialog box, where you enter the number of characters you want to move the selection by to the right.


~0050020100
	Move Right dialog box

You use the Move Right dialog box to move the selected text to the right by some spaces. Enter the number of spaces you want to move the text by to the right, then press Enter key or OK button.

Note that before processing the selection is automatically extended to the whole line(s).


~0000500202
	Tools|Format|Indent with

This command displays   Indent with   dialog box, where you enter the string you want to indent the selected text with.


~0050020200
	Indent with dialog box

You use the Indent with dialog box to indent the selected text with a specified string. Enter the string you want to indent the selection with, then press Enter key or OK button.

Note that before processing the selection is automatically extended to whole lines.


~0000500203
	Tools|Format|Reformat

This command displays   Reformat   dialog box, where you enter margins you want the text to be reformatted to.

~0050020300
	Reformat dialog box

You use the Reformat dialog box to reformat the selected text with new margins (fill area between margins).

Specify the right margin of the new text layout. You might also specify a new left margin. If you don't specify it (leave it blank) the left margin will not be changed.
Then press Enter key or OK button.

Note that before processing the selection is automatically extended to the whole line(s).

~0000500204
	Tools|Format|Expand tabs

This command is used to expand all tab characters in the selected text into spaces. The current tabstops value is used (default 8).

To replace spaces with Tab characters use Tools|Format| Unexpand .

_________
See Also:
  Tools menu 

~0000500205
	Tools|Format|Unexpand

This command is used to replace spaces in the selected text with Tab characters (when possible).

Note that tab stops will occur every eight columns (unless pr command is used, see below).

By default, only leading spaces and tabs are reconverted to tabs. If you would like to insert tabs wherever their presence compresses the resultant text (by replacing two or more characters) redefine the "*unexpandCmd" as:
"*unexpandCmd:	unexpand -a "
(note that on SGI the default is "pr -t" because unexpand command is unavailable).

For systems that have 'pr' command you can use the following definition to allow inserting tabs with the current tab interval and wherever is possible:
"*unexpandCmd:		pr -t -i%d"

The above customization should be done in your private Asedit application defaults file.


To expand tab characters to spaces use Tools|Format| Expand tabs .

_________
See Also:
  Tools menu 



~0000005003
	Tools|Change Case to

The Tools|Change Case to command is used to change the case of characters in the selected text. The following options are available:


    Upper	-  Change text to uppercase

    Lower	-  Change text to lowercase

    Title	-  Capitalize the first letter of each word

    Toggle	-  Change all uppercase text to lowercase and all lowercase text to uppercase


~0000005004
	Tools|Filters

The Tools|Filters command is used to process a selected text:

     New Filter... 		-  Use user specified filter

     Word count 		-  Count the lines, words and bytes

     Compress blank lines 	-  Replace multiple blank lines with one

     Delete blank lines   	-  Delete blank lines

     Double Space 		-  Double space the text

     Delete Extra spaces   	-  Delete extra blanks

~0000500400
	Tools|Filters|New Filter

This command displays   New Filter   dialog box, where you enter your filter command and choose where its output should go.

~0050040000
	New Filter dialog box

You use the New Filter dialog box to specify your own filter to process the text selected in the edit area.
Any system command or user program reading from standard input and writing to standard output can be used.

Enter filter name (and parameters if needed) in the text box. Choose where the filter output will go by selecting one of the buttons in the Direct output to: box. Note that selecting Current window means that the current selection will be replaced with the filter output. Then press Enter or activate OK button.

If the filter takes substantial amount of time to finish, you will get a Wait! dialog. Using this dialog you can stop this long process, if needed.


Notes:
Most of the UNIX filters operate on complete lines, so DO include in the selected text the final line feed.

~0000500401
	Tools|Filters|Word count

This command calls Unix wc filter for the current selection.  Number of lines, words and bytes for the selected text is shown in a text dialog.


~0000500402
	Tools|Filters|Compress blank lines

This command is used to replace multiple blank lines with a single one for the current selection. Note that a line consisting of only space and tab characters is treated as a blank one.
~0000500403
	Tools|Filters|Delete blank lines

This command is used to delete all blank lines for the current selection. Note that a line consisting of only space and tab characters is treated as a blank one.
~0000500404
	Tools|Filters|Double Space

This command is used to double space the current selection (insert extra empty line after each line).
~0000500405
	Tools|Filters|Delete Extra spaces

This command is used to delete extra spaces in the current selection (i.e. replace multiple space and tab characters with a single space).

~0000500406
	Tools|Filters|User defined 5

This is a user defined filter command.
_________
See Also:
  Filter customization 
~0000500407
	Tools|Filters|User defined 6

This is a user defined filter command.
_________
See Also:
  Filter customization 
~0000500408
	Tools|Filters|User defined 7

This is a user defined filter command.
_________
See Also:
  Filter customization 
~0000500409
	Tools|Filters|User defined 8

This is a user defined filter command.
_________
See Also:
  Filter customization 
~0000500410
	Tools|Filters|User defined 9

This is a user defined filter command.

_________
See Also:
  Filter customization 

~0050041000
	Filter customization


Note: this is an advanced topic! Read it when you want to extend asedit functionality  by adding user defined filters or commands.


In ASEDIT filters are implemented using two generic resources:
	filter
	fllterExt

(for example there are: filter0, filterExt0).

To customize a user defined command or filter redefine its' generic resources.

The 'filter' resource specifies the filter to be invoked (for example wc).

The 'filterExt', if specified, gives extra description how asedit is processing filter's output etc.
It consists of following fields (order is important):

  short name		Description

  outputDepot		where the filter's output is going
  outDialogTitle	title of the dialog where output will be shown in
  otherDialogsTitle	title of other dialogs (errors/messages)
  noOutMsg		message to be shown when no output is received
  extendTo		flag for automatic selection extension, that takes place before processing


All fields with their default values and possible predefined values, where relevant, are listed below:

(N)  short name		Default value	Possible values (if limited)

(1)  outputDepot	TO_CURRENT	TO_NONE, TO_STDOUT, TO_STDERR,
					TO_CURRENT, TO_NEW, TO_TEXT_DIALOG
(2)  outDialogTitle
(3)  otherDialogsTitle
(4)  noOutDialogType	TO_NONE		TO_NONE, DIALOG_ERROR, DIALOG_INFORMATION,
					DIALOG_MESSAGE, DIALOG_WARNING

(5)  noOutMsg
(6)  extendTo		EXTEND_TO_LINES*	NO_EXTEND, EXTEND_TO_LEFT_LF,
					EXTEND_TO_RIGHT_LF, EXTEND_TO_LINES

Notes:
Fields (2), (3) and (5) may contain any text and do not have default values.
* extendTo default value for commands is NO_EXTEND (no need for selection extension).

As a separator in the filterExt specification the following escape sequence is used: "\," (i.e. backspace followed immediately by comma).

Below there are examples how the above specification is used in asedit:

Example 1: Double Space
*filter3:			sed G

Note that 'filterExt3' is not specified (i.e. all default values are used).

Example 2: Word count
*filter0:	echo '     lines     words     bytes:' ; wc
*filterExt0:	TO_TEXT_DIALOG\,Word count\, \, \, \, NO_EXTEND_TO_LF


Example 3: Spell

*spellCmd:	(cat; echo) | spell
*spellExt:	TO_TEXT_DIALOG,\ Misspelled words:\, Spell \, DIALOG_INFORMATION ,\ Spelled correctly!\,NO_EXTEND_TO_LF




~0000005005
	Tools|Commands

The Tools|Commands is used to start following commands:

     New Command...     	-  User specified command

     Current directory 	-  pwd

     Date 			-  date

     Host name 		-  hostname

~0000500500
	Tools|Commands|New Command...

This command displays   New Command   dialog box, where you enter your command and choose where its' output should go.

~0050050000
	New Command dialog box

You use the New Command dialog box to specify your own command. By a command we mean any system command or a user program that does NOT need any input.

Enter command name (and parameters if needed) in the text box. Choose where the command output will go by selecting one of the buttons in the Direct output to: box. Note that selecting Current window means that the current selection, if present, will be replaced with the command output. Then press Enter or activate OK button.

If the command takes substantial amount of time to finish you will get a Wait! dialog. Using this dialog you can stop this long process, if needed.

~0000500501
	Tools|Commands|Current directory

This command calls Unix 'pwd' command. The full name of the current directory will be inserted at the current cursor location (note that if there is a text selected the command will replace it).
~0000500502
	Tools|Commands|Date

This command calls Unix 'date' command. The current date will be inserted at the current cursor location (note that if there is a text selected the command will replace it).
~0000500503
	Tools|Commands|Host name

This command calls Unix 'hostname' command. The name of the computer the program is running on will be inserted at the current cursor location (note that if there is a text selected the command will replace it).

~0000500504
	Tools|Commands|User defined 3

This is a user defined command.
_________
See Also:
  Command customization 
~0000500505
	Tools|Commands|User defined 4

_________
See Also:
  Command customization 
~0000500506
	Tools|Commands|User defined 5

This is a user defined command.
_________
See Also:
  Command customization 
~0000500507
	Tools|Commands|User defined 6

This is a user defined command.
_________
See Also:
  Command customization 
~0000500508
	Tools|Commands|User defined 7

This is a user defined command.
_________
See Also:
  Command customization 
~0000500509
	Tools|Commands|User defined 8

This is a user defined command.
_________
See Also:
  Command customization 
~0000500510
	Tools|Commands|User defined 9

This is a user defined command.

_________
See Also:
  Command customization 
~0000500555
	Command customization

Note: this is an advanced topic! Read it when you want to extend asedit functionality  by adding user defined commands.


To customize a user defined command redefine its' two generic resources:
	cmd
	cmdExt

They are practically identical to filter resources with the exceptions related to selections.
The selected text is not needed to perform the command, and if it does exist it is not extended (as default). Note that if the selection does exist before the command start it will be replaced by the command output.

To find all the details about how to customize commands or filters see:

	 Filter customization 


~0000000060
	Options menu  (Alt+O)

Sorry, this menu and its' help information are not available in the free release!


~0000000080
	Help Menu

The Help menu provides access to the ASEDIT on-line help and to the information about the program.

The following Help menu commands are available:

  On Keys 	-  help about important keys

  Index 	-  index of help available

  On Help 	-  information on how to use the help

  About... 	-  general information about ASEDIT


If you want to follow any of the topics above simply select it (either by mouse and double click or by cursor and Enter key).
~0000008000
	Help|On Keys

Choose the Help|On Keys to learn about asedit shortcut keys.

For on-line information on how to use Help, press F1, choose Help button  or choose Help|On Help menu command.


 Key	Function
________________________________________
 F1	Calls up context-sensitive Help
 F10	Quick method to toggle to the menu bar
 F3	Lets you open a file
 F2	Saves current file



 Key	Function
________________________________________
 Alt+E	Takes you to the Edit menu
 Alt+F	Takes you to the File menu
 Alt+H	Takes you to the Help menu
 Alt+S	Takes you to the Search menu
 Alt+T	Takes you to the Tools menu

~0000008001
	Help Index

     ASEDIT Menus 

     Customization 

     Editing 

     Keyboard 

     Requirements 

     Screen Regions 

     Users' Q & A 


For on-line information on how to use Help, press F1, choose Help button  or choose Help|On Help menu command.

~0000008002
	Welcome to On-line Help for ASEDIT ver. 1.3

You can learn about ASEDIT editor through the on-line hypertext Help system. What you're reading right now is a 'Help topic'.

Most Help topics have link items ('Help keywords') that lead to other Help topics.
These links are embraced with vertical thick bars. When you position the cursor inside a link it becomes highlighted.

To go to the Help topic:
1. Move the cursor to a word or phrase embraced with vertical thick bars. You can move using mouse or keyboard. Now the word (phrase) becomes highlighted.
2. To follow the link you can:
	double click the left mouse button
	or
	press Enter key
	or
	activate the Follow button in the action area (by mouse or keyboard).


Try it now; choose one of these Help keywords to get started:

	 About On-line Help 	 How to Use Help 

	 ASEDIT Menus 		 The Editor 

While in the help pressing F1 (Help key) brings up what you're  reading now.
To close the Help window activate the Close button in the action area or press Escape key when the main help window has the focus.

If the current help topic is longer than one page, use standard method of scrolling.
~0000008003
	Help|About

When you choose the About command from the Help menu, an information dialog appears, showing ASEDIT copyright and version details.

To close the box:
	Press Escape key, or
	activate Close button by pressing Enter or clicking it with the mouse.

~0000800200
	About On-line Help

With Help, you can:
 - Press F1 (Help key) to get information quickly.
 - View Help information while working in your application.
   For example, you can follow step-by-step instructions in the Help window while you perform a task in the program.

On-line Help provides information about:
    -	menu commands and dialog box items
    -	command-line options
    -	the asedit editor functions
    -	asedit customization options
    -	... and more ...

_________
See also:
  Welcome to On-line Help 
  How to Use Help 


Any queries or recommendations related to asedit can be send by E-mail to:

	astoch@ic.ac.uk

~0000800201
	How to Use Help

    To read all of this topic, scroll down.

You can use the on-line Help system from the Help menu or via the help key.

Wherever you are in the ASEDIT, you can press F1 (Help key) to see a Help topic about the currently active menu command or dialog-box. This is called context-sensitive Help.

ASEDIT context-sensitive Help comes up in a dialog-style Help window as shown, schematically, below :

 __________________________________
 |          ASEDIT - Help
 __________________________________
 |
 |
 |  Help  topic
 |  ...
 |  ...       .   .     .            <-- help
 |                                       text
 |  ...  |Help keyword| ...
 |
 |
 |
 __________________________________
 |
 | Follow  Back  Index  Close  Help  <-- action
 |                                       	area
 __________________________________


Select Help action buttons as follow:

 Action button	Do this
 _______________________________
 Follow	Follow the hypertext link currently selected.
 Back  	Go to the previous Help topic.
 Index	Go to the Help index.
 Close   	Close the Help window (pop it down).
 Help   	Get help about the help system.


Navigating through a Help topic:

    -  you can press the Ctrl key and the right or left arrow keys to move the cursor to a Help keyword (or use any other movement keys). Help keywords are embraced with vertical thick bars. Then press Enter.

    -  if you're using a mouse, double click the Help keyword you're interested in.

    -  alternatively you can position the cursor inside the Help keyword and activate the Follow button in the action area.

Note for keyboard users:
 To move keyboard focus from the action area (the row of buttons) to the help text window use Tab key, in the other direction use Shift+Tab key.

Choose one of these Help keywords to find out how to:

	 Go to the Help Index 

	 Go to a previous Help topic 

Choose one of these keywords to find out more about the Help menu:

	 On Keys 

	 Index 

	 On Help 

	 About... 

To close the Help window select Close button in the action area.

~0000800202
	ASEDIT Menus

ASEDIT editor is a menu driven program and the menu bar at the top of its window is a gateway to all commands and dialogs.

To go to the menu bar:
    -	Click anywhere on it, or
    -	Press F10, or
    -   Press Alt key together with any underlined letter in the menu bar.

You can choose any of these pull-down menus on the menu bar:

	 File 	 Edit 	 Search 	 View 

	 Tools 	 Options 	 Help 

If you need detailed instructions on using the menu bar, go to the Help topic  How to Use Menus .

For information about menu shortcut keys, go to the Help topic:  Shortcut keys 
~0000800203
	The Editor

ASEDIT is an easy to use text editor for X Window System built around Motif text widget.

The main features include:

  - (*) international release (versions for 7 languages)
  - graphical user interface (GUI)
  - multiple editing windows
  - easy to use "point and click" interface
  - drag and drop support (Motif 1.2 and above only)
  - file selection via file selection dialog
  - read only mode to view files
  - file insert functionality
  - print dialog that allows:
	(i)  selection of a printer and using extra print options
	(ii) selection of a print range (selected text only or
	     the complete document)
  - (*) comprehensive context sensitive, hypertext on-line help
  - multiple undo and redo of edit actions
  - Cut/Copy/Paste features
  - bookmarks (up to 10)
  - (*) parenthesis (pair) matching
  - comprehensive search and replace
  - line and column numbers
  - automatic indentation
  - shortcut keys for the most common edit features (based on CUA)
  - (*) pop-up menu for mouse oriented editing
  - (*) special version with keyboard bindings for EMACS's users
  - (*) customization via the standard X11/Motif resources method
  - (*) easy localization for left to right languages (8-bit characters)
  - (*) spell and sort commands
  - (*) commands to change case of letters
  - (*) formatting commands (expand/unexpand, move left/right, indent with,
	reformat margins)
  - (*) user customizable filters (up to 10); following filters are
	preconfigured: word count, compress multiple blank lines, delete
	blank lines, double space the text, delete extra spaces;
	new filter dialog is also available;
  - (*) user customizable commands (up to 10); following commands are
	preconfigured:	pwd, date, hostname;
	new command dialog is also available
  - (*) extended syntax (on program startup: show line <N>, open multiple
	files, set tabstops interval, set autoindent, etc.)

(*) - means a completely new or dramatically improved feature in ver. 1.3


International information.
This international Release, includes the following language versions: English, Dutch, French,  German, Polish, Portuguese and Swedish. All commands and messages are localized for each language. The on-line help is available only in English.


The asedit window consists of a workspace with scrollbars (Edit Area), a Status Line at the bottom and the menu bar at the top.

Read-only files:
ASEDIT switches itself into read-only mode when the file opened is marked as read-only or a user specifically requested view only mode in the file open box.  The user cannot change anything in such mode and the file is shown on a slightly lighter background (to give a visual hint to a user).

_________
See also:
  Edit Area 
  Emacs bindings 
  About On-line Help 
~0080020207
	How to Use Menus

There are three basic ways to select a menu command:

Mouse:	Click the name of the menu you want to pull down, then click the menu command you want to choose.
F10:	Press F10 key, then use the arrow keys to go to the menu you want and use them again to select a command. Press Enter to choose the selected command.
Alt:	Press Alt key and the underlined letter of the menu you want (such as Alt+F for the File menu), use the arrow keys to select a command, then press Enter to choose the command.

You can also press the underlined letter of a menu name or command instead of using the arrow keys.
Additionally you can mix those techniques together.

Menu commands may be followed by either an ellipsis mark (...), an arrow, or an acceleration key.
Their description is shown in the following table.

  Mark	Name		What the Menu Command Does
 __________________________________________________
  ...	Ellipsis	Brings up a dialog box

   ->	Arrow		Displays another menu

   F2	Acceleration	Initiates some action when
 (etc.)	key		you choose this command or
			press the specified key(s)


Note: if a menu entry is not available it is greyed out and cannot be selected.

~0080020100
	Go to the Help Index

You can go to the Help Index by selecting Index button in the Help menu.
Alternatively, if the help window is already displayed, simply select the Index button in the help window action area.

~0080020101
	Go to a previous Help topic

You can Go to a previous Help topic (i.e. the topic that you read before the current one) by selecting the  Back  button in the action area of the Help window.
In this way you can backtrack through the Help topics you have viewed.

~0000800101
	Customization

You can change many of the visible aspects of ASEDIT, for example colours and fonts being used to suit your personal needs.
These changes can be made in files in your home directory called ".Xdefaults" and "Asedit".

ASEDIT may be customized as well for all users.  It is done by changing the file /usr/lib/X11/app-defaults/Asedit (default system configuration).  Please remember that your personal entries in ".Xdefaults" and "Asedit" files overrides them.

Listed below is a more detailed description of the origin of resource database used for ASEDIT.

Because there are different categories for which ASEDIT may be customized, there are multiple files from which the resource database is constructed. These files are then merged in a specific sequence into the resource database. In this process entries from one file may be overridden by entries from another.

The four main sources for the resource database are:
 - /usr/lib/X11/app-defaults/Asedit   -  the application-specific resource file, that contains all the resource specifications not coded into the program (normally it should not be changed by the user; Note: the app defaults directory might be different on your computer).
 - $HOME/Asedit     -  user-specific resource file, that contains customizations a user has made himself or herself.
 - $HOME/.Xdefaults -  display specific (every X program can access them on its display connection).
 - $HOME/.Xdefaults-<hostname>  -  host specific resource file.

Note: resource specifications can also be included directly or indirectly in the command line invoking a program (you can treat that as a last stage of getting the program resources).

If you would like to customize asedit, in more details than you can find from the supplied Asedit file, you have to know the widget structure of the program.

_________
See also:
  Widget tree 
  Command-line options 
  Filter customization 
  Localization 

~0080010101
	Command-line options

You can call asedit with the "-help" command-line option to get the usage message in your local language. If a command-line option is not recognized the program stops and the syntax message is printed as well.

The English syntax message is shown below.

Usage:  asedit [options] [filename(s)]
where available options include:

  -bg  <COLOR>		sets background (page) color for all elements
  -fg  <COLOR>		sets foreground (text) color
  -fn  <FONT>		sets one font list for the whole program
  -fnm <FONT>		sets font list for menu items and dialogs
  -fnt <FONT>		sets font list for the edit text area
  -helpdir  <DIR>      	sets directory for the asedit help file (asedit.hlp)
  -tab <N>    		sets the tabstops to interval of N characters
  +<N>         		after opening the file go to line <N>
  -emacs       		turns on Emacs mode (alternate shortcuts set is used)
  -/+ai        		turns on/off autoindent
  -/+status		turns on/off status line
  -/+wrap      		turns on/off auto wraparound (*slow* before Motif 1.2)
  -/+v         		turns on/off view only mode
  ..... 	and all standard X-Window options including:
  -display  <HOST:SCREEN>    	sets the display where the window will appear
  -geometry <WIDTHxHEIGHT+X+Y>	sets window size and position (in pixels)
  -iconic      		starts the program up iconified
  -xrm  <RESOURCE>	sets additional X resource specification


~0080010102 Customization/Filter customization -> Filter customization
~0080010103 Customization/Localization --> Localization

~0000008050
	Localization

Many aspects of localization depend on the particular operating system, Motif implementation, and user environment in which the application runs. The following must all cooperate for correct localization to occur:
  - the operating systems' locale mechanism, if any
  - the Motif implementation
  - the application itself
  - the user's system administrator
  - the user's language environment.

If you use X Window System Release 5 (or later) and Motif 1.2 (or later) you have the right setup to run asedit in other languages. On systems with X11R4/Motif 1.1 it is vendor dependent (some vendors built in the necessary extensions).

_________
See also:
  Establishing the language environment 
  Character composition 
  Finding X Resource files 

~0000805000
	Establishing the language environment

The actual language environment in which an application operates is specified by the application user, often by setting an environment variable (LANG on POSIX-based systems) or by setting the xnlLanguage resource.

Choosing a locale (POSIX)
From the command line set the environment variable LANG. For example, when you type
in the Korn and Bourne shells:
	LANG=fr; export LANG

or in the C shell:
	setenv LANG fr

you set the locale of whatever window you enter it in to French. That window will remain in French until you explicitly change locales again. When you start asedit from this window you will get asedit in French (assuming that you've installed the French version).

Note that on SunOS 4.x to set support for French (German and so on) you have to:
	set LANG to C, and
	LC_CTYPE to iso_8859_1.


~0000805001
	Character composition

There are many characters used in non-English languages that are not part of the ASCII character set. If you have a national keyboard you are lucky because you can enter them directly. If you're using an American keyboard you'll have to type those characters by composing them.
To compose a character, you usually need a special key - compose key, then you enter the appropriate key sequence for the character you want to type. For instance to produce the character 'ø', you might press the Compose key, the the slash '/', then 'o'. Not every keyboard has a Compose key, however. If doesn't and you need one, you can remap a key you're not using to be the Compose key. To do that use xmodmap(1) command. For instance, to remap F12 function key to be the Compose key, enter this command:
	xmodmap -e "keysym F12 = Multi_key"

You can, of course, replace the "F12" with the name of any other key. For more detailed information, see the xmodmap(1) man page.

~0000805002
	Finding X Resource files

Note that users should rarely if ever need to modify the system wide application defaults files (appdefs).

The default French and German appdefs for X-based applications are located in the
	/usr/lib/X11/fr/app-defaults  and
	/usr/lib/X11/de/app-defaults  directories, respectively.

If you're having trouble finding appdefs on your system, try looking at the environment variables XAPPLRESDIR, XUSERFILESEARCHPATH, and XFILESEARCHPATH. They specify where to look for application-specific X resource files.



~0080010100
	asedit widget tree

ASEDIT widget tree (widget hierarchy) is shown below. All widgets are listed by class name and instance (you should use either of them, if needed, during customization through resources). Widgets hierarchy is shown by indentation.

Note that a special class name is used for the Emacs version of asedit.

Asedit_em asedit
    TopLevelShell  asedit
        XmMainWindow  main
        
            XmSeparatorGadget  Separator1
            XmSeparatorGadget  Separator2
            XmSeparatorGadget  Separator3
          
            XmRowColumn  menuBar
                XmCascadeButton  File
                XmCascadeButton  Edit
                XmCascadeButton  Search
                XmCascadeButton  Tools
                XmCascadeButton  Help
                
                XmMenuShell  popup_File_PD

                    XmRowColumn  File_PD
                        XmPushButton  New
                        XmPushButton  Open
                        XmPushButton  Close
                        XmSeparator  separator
                        XmPushButton  Save
                        XmPushButton  Save_As
                        XmSeparator  separator
                        XmPushButton  Insert
                        XmPushButton  Print
                        XmSeparator  separator
                        XmPushButton  Exit

                    XmRowColumn  Edit_PD
                        XmPushButton  Undo
                        XmPushButton  Redo
                        XmSeparator  separator
                        XmPushButton  Cut
                        XmPushButton  Copy
                        XmPushButton  Paste
                        XmSeparator  separator
                        XmPushButton  Clear

                    XmRowColumn  Search_PD
                        XmPushButton  Find
                        XmPushButton  Repeat
                        XmPushButton  Change
                        XmPushButton  Go_to
                        XmSeparator  separator
                        XmCascadeButton  Mark
                        XmCascadeButton  Match

                    XmRowColumn  Tools_PD
                        XmPushButton  Spell
                        XmPushButton  Sort
                        XmSeparator  separator
                        XmCascadeButton  Format
                        XmCascadeButton  Case
                        XmSeparator  separator
                        XmCascadeButton  Filters
                        XmCascadeButton  Commands

                    XmRowColumn  Help_PD
                        XmPushButton  On_Keys
                        XmPushButton  Index
                        XmPushButton  On_Help
                        XmSeparator  separator
                        XmPushButton  About

                    XmMenuShell  popup_Mark_PD

                        XmRowColumn  Match_PD
                            XmPushButton  Forward
                            XmPushButton  Backward

                        XmRowColumn  Filters_PD
                            XmPushButton  Extra
                            XmPushButton  0
                            XmPushButton  1
                            XmPushButton  2
                            XmPushButton  3
                            XmPushButton  4

                        XmRowColumn  Mark_PD
                            XmCascadeButton  Set
                            XmCascadeButton  Go_to

                        XmRowColumn  Format_PD
                            XmPushButton  MoveLeft
                            XmPushButton  MoveRight
                            XmPushButton  IndentWith
                            XmPushButton  Reformat
                            XmSeparator  separator
                            XmPushButton  Expand
                            XmPushButton  Unexpand

                        XmRowColumn  Case_PD
                            XmPushButton  Upper
                            XmPushButton  Lower
                            XmPushButton  Title
                            XmPushButton  Toggle

                        XmRowColumn  Commands_PD
                            XmPushButton  Extra
                            XmPushButton  0
                            XmPushButton  1
                            XmPushButton  2

                        XmMenuShell  popup_Set_PD

                            XmRowColumn  Set_PD
                                XmPushButton  0
                                XmPushButton  1
                                XmPushButton  2
                                XmPushButton  3
                                XmPushButton  4
                                XmPushButton  5
                                XmPushButton  6
                                XmPushButton  7
                                XmPushButton  8
                                XmPushButton  9

                            XmRowColumn  Go_to_PD
                                XmPushButton  0
                                XmPushButton  1
                                XmPushButton  2
                                XmPushButton  3
                                XmPushButton  4
                                XmPushButton  5
                                XmPushButton  6
                                XmPushButton  7
                                XmPushButton  8
                                XmPushButton  9

                XmDialogShell  open_dialog_popup
                    XmFileSelectionBox  open_dialog
                         XmLabelGadget  Items
                        XmScrolledWindow  ItemsListSW
                            XmScrollBar  VertScrollBar
                            XmScrollBar  HorScrollBar
                            XmList  ItemsList
                        XmLabelGadget  Selection
                        XmTextField  Text
                        XmSeparatorGadget  Separator
                        XmPushButtonGadget  OK
                        XmPushButtonGadget  Apply
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help
                        XmLabelGadget  FilterLabel
                        XmLabelGadget  Dir
                        XmTextField  FilterText
                        XmScrolledWindow  DirListSW
                            XmScrollBar  VertScrollBar
                            XmScrollBar  HorScrollBar
                            XmList  DirList
                        XmFrame  frame
                            XmToggleButton  open_view_only

                XmDialogShell  save_dialog_popup
                    XmFileSelectionBox  save_dialog
                        XmLabelGadget  Items
                        XmScrolledWindow  ItemsListSW
                            XmScrollBar  VertScrollBar
                            XmScrollBar  HorScrollBar
                            XmList  ItemsList
                        XmLabelGadget  Selection
                        XmTextField  Text
                        XmSeparatorGadget  Separator
                        XmPushButtonGadget  OK
                        XmPushButtonGadget  Apply
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help
                        XmLabelGadget  FilterLabel
                        XmLabelGadget  Dir
                        XmTextField  FilterText
                        XmScrolledWindow  DirListSW
                            XmScrollBar  VertScrollBar
                            XmScrollBar  HorScrollBar
                            XmList  DirList

                XmDialogShell  insert_dialog_popup
                    XmFileSelectionBox  insert_dialog
                        XmLabelGadget  Items
                        XmScrolledWindow  ItemsListSW
                            XmScrollBar  VertScrollBar
                            XmScrollBar  HorScrollBar
                            XmList  ItemsList
                        XmLabelGadget  Selection
                        XmTextField  Text
                        XmSeparatorGadget  Separator
                        XmPushButtonGadget  OK
                        XmPushButtonGadget  Apply
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help
                        XmLabelGadget  FilterLabel
                        XmLabelGadget  Dir
                        XmTextField  FilterText
                        XmScrolledWindow  DirListSW
                            XmScrollBar  VertScrollBar
                            XmScrollBar  HorScrollBar
                            XmList  DirList

                XmDialogShell  print_dialog_popup
                    XmSelectionBox  print_dialog
                        XmLabelGadget  Items
                         XmScrolledWindow  ItemsListSW
                            XmScrollBar  VertScrollBar
                            XmScrollBar  HorScrollBar
                            XmList  ItemsList
                        XmLabelGadget  Selection
                        XmTextField  Text
                        XmSeparatorGadget  Separator
                        XmPushButtonGadget  OK
                        XmPushButtonGadget  Apply
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help
                        XmForm  form
                            XmLabel  range_title
                            XmForm  form1
                                XmFrame  frame
                                    XmRowColumn  range_radio_box
                                        XmToggleButton  selection
                                        XmToggleButton  complete

                XmDialogShell  replace_dialog_popup
                    XmSelectionBox  replace_dialog
                        XmLabelGadget  Selection
                        XmTextField  Text
                        XmSeparatorGadget  Separator
                        XmPushButtonGadget  OK
                        XmPushButtonGadget  Apply
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help
                        XmForm  form
                            XmForm  form_text
                                XmLabel  text_to_find_title
                                XmText  text_to_find
                                XmLabel  new_text_title
                                XmText  new_text
                            XmLabel  options_title
                            XmFrame  frame1
                                XmRowColumn  options_row_column
                                    XmToggleButton  case_sensitive
                                    XmToggleButton  whole_words
                            XmLabel  direction_title
                            XmFrame  frame2
                                XmRowColumn  direction_radio_box
                                    XmToggleButtonGadget  Forward
                                    XmToggleButtonGadget  Backward

                XmDialogShell  go_to_line_popup
                    XmSelectionBox  go_to_line
                        XmLabelGadget  Selection
                        XmTextField  Text
                        XmSeparatorGadget  Separator
                        XmPushButtonGadget  OK
                        XmPushButtonGadget  Apply
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help

                XmDialogShell  moveLeft_dialog_popup
                    XmSelectionBox  moveLeft_dialog
                        XmLabelGadget  Selection
                        XmTextField  Text
                        XmSeparatorGadget  Separator
                        XmPushButtonGadget  OK
                        XmPushButtonGadget  Apply
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help

                XmDialogShell  moveRight_dialog_popup
                    XmSelectionBox  moveRight_dialog
                        XmLabelGadget  Selection
                        XmTextField  Text
                        XmSeparatorGadget  Separator
                         XmPushButtonGadget  OK
                        XmPushButtonGadget  Apply
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help

                XmDialogShell  indentWith_dialog_popup
                    XmSelectionBox  indentWith_dialog
                        XmLabelGadget  Selection
                        XmTextField  Text
                        XmSeparatorGadget  Separator
                        XmPushButtonGadget  OK
                        XmPushButtonGadget  Apply
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help

                XmDialogShell  reformat_dialog_popup
                    XmMessageBox  reformat_dialog
                        XmLabelGadget  Symbol
                        XmLabelGadget  Message
                        XmSeparatorGadget  Separator
                        XmPushButtonGadget  OK
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help
                        XmForm  form
                            XmLabel  left_margin_title
                            XmText  left_margin
                            XmLabel  right_margin_title
                            XmText  right_margin

                XmDialogShell  error_message_popup
                    XmMessageBox  error_message
                        XmLabelGadget  Symbol
                        XmLabelGadget  Message
                        XmSeparatorGadget  Separator
                        XmPushButtonGadget  OK
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help

                XmDialogShell  filter_dialog_popup
                    XmSelectionBox  filter_dialog
                        XmLabelGadget  Selection
                        XmTextField  Text
                        XmSeparatorGadget  Separator
                        XmPushButtonGadget  OK
                        XmPushButtonGadget  Apply
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help
                        XmForm  form
                            XmLabel  depot_title
                            XmFrame  frame
                                XmRowColumn  depot_radio_box
                                    XmToggleButton  to_current
                                    XmToggleButton  to_new
                                    XmToggleButton  to_dialog

                XmDialogShell  command_dialog_popup
                    XmSelectionBox  command_dialog
                        XmLabelGadget  Selection
                        XmTextField  Text
                        XmSeparatorGadget  Separator
                        XmPushButtonGadget  OK
                        XmPushButtonGadget  Apply
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help
                        XmForm  form
                            XmLabel  depot_title
                            XmFrame  frame
                                XmRowColumn  depot_radio_box
                                    XmToggleButton  to_current
                                    XmToggleButton  to_new
                                    XmToggleButton  to_dialog

                XmDialogShell  change_prompt_popup
                    XmSelectionBox  change_prompt
                        XmLabelGadget  Selection
                        XmTextField  Text
                        XmSeparatorGadget  Separator
                        XmPushButtonGadget  OK
                        XmPushButtonGadget  Apply
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help
                        XmRowColumn  workarea
                            XmLabel  pixmap_label
                            XmLabel  text_label

                XmDialogShell  continue_search_question_popup
                    XmMessageBox  continue_search_question
                        XmLabelGadget  Symbol
                        XmLabelGadget  Message
                        XmSeparatorGadget  Separator
                        XmPushButtonGadget  OK
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help

                XmDialogShell  about_popup
                    XmMessageBox  about
                        XmLabelGadget  Symbol
                        XmLabelGadget  Message
                        XmSeparatorGadget  Separator
                        XmPushButtonGadget  OK
                        XmPushButtonGadget  Cancel
                        XmPushButtonGadget  Help

            XmForm  form_work
                XmPanedWindow  pane
                    XmScrolledWindow  edit_textSW
                        XmScrollBar  HorScrollBar
                        XmScrollBar  VertScrollBar
                        XmText  edit_text
                    XmScrolledWindow  edit_textSW
                        XmScrollBar  HorScrollBar
                        XmScrollBar  VertScrollBar
                        XmText  edit_text
                    XmSash  sash
                    XmSeparatorGadget  separator
                    XmSash  sash
                    XmSeparatorGadget  separator

                XmForm  form_frame_bottom
                    XmFrame  frame_bottom_row
                        XmRowColumn  bottom_row
                            XmLabel
                            XmLabel  line
                            XmLabel  1
                            XmLabel  column
                            XmLabel  1

            XmMenuShell  popup_QAccess_Popup
                XmRowColumn  QAccess_Popup
                    XmPushButton  Undo
                    XmSeparator  separator
                    XmPushButton  Cut
                    XmPushButton  Copy
                    XmPushButton  Paste
                    XmSeparator  separator
                    XmPushButton  Open
                    XmPushButton  Save
                    XmSeparator  separator
                    XmPushButton  Exit

    XmDialogShell  save_warning_popup
        XmMessageBox  save_warning
            XmLabelGadget  Symbol
            XmLabelGadget  Message
            XmSeparatorGadget  Separator
            XmPushButtonGadget  OK
            XmPushButtonGadget  Cancel
            XmPushButtonGadget  Help

    XmDialogShell  help_dialog
        XmPanedWindow  pane
            XmScrolledWindow  hypertext_textSW
                XmScrollBar  VertScrollBar
                XmText  hypertext_text
            XmForm  action_area
                XmPushButton  Follow
                XmPushButton  Back
                XmPushButton  Index
                XmPushButton  Close
                XmPushButton  Help
            XmSash  sash
            XmSeparatorGadget  separator
            XmSash  sash
            XmSeparatorGadget  separator




Note:	If asedit was built with X Window System Release 5 you can obtain all of the above information running the "editres" application (a special event handler was registered by us to participate in the Editres protocol). You can even dynamically set asedit resources running editres (see editres description).

~0000000027
	Editing Index

Back up
	 backing up a document 
Cancelling
	 Cancelling before, during, or after an action 
 Clipboard 
	 copying text to 
	 cutting text to 
	 pasting text from 
Command
	 choosing and carrying out 
Compose key
	 Character composition 
Copying
	 Copying a document 
	 Copying text 
		 using Clipboard 
		 using Primary selection 
		 using Secondary selection 
Creating a document (see New document creating)
Cutting
	 text to Clipboard 
Cursor (see Insertion point)
Deleting text
	 deletion keys 
	 replacing text when you type 
Dialog_box
	 choosing a button or selecting an option 
	 inserting response in text box 
	 moving 
	 moving around in 
 Exiting ASEDIT 
Go to
	 Go to Line number 
Help
	 How to Use Help 
Highlighting (see Selecting)
Insertion point
	 Moving in dialog boxes 
	 moving within text 
Language environment
	 establishing 
Load file box
	 Selecting a file 
 Localization 
Match delimiter (see Searching for the matching delimiter)
Moving through a document (see Scrolling)
Moving text
	 between X-Windows applications 
	 within a file or between files 
New document
	 creating 
Opening
	 document 
Option (see Dialog_box)
Pasting
	 text from Clipboard 
	text from another X application (see Copying text)

Parenthesis matching (see Searching for the matching delimiter)
Printing
	 document 
Renaming
	 document 
Redoing
	 undo action 
Repeating
	 previous search 
Replacing
	 text: searching and replacing 
	 text: when you type 
Saving
	 backup copy 
	 document 
Scrolling
	 with keys 
	 with mouse 
Searching
	 for the matching delimiter 
	 for selection 
	 for text 
Selecting
	in dialog box (see Dialog Box)
	 text with keys 
	 text with mouse 
Travel keys (see Insertion point)
Undoing
	 Cancelling before, during, or after an action 


~0000000077
	Keyboard

 Deletion Keys 

 File Handling Keys 

 Function Keys 

 Insertion Keys 

Movement Keys
	 Moving and sizing windows 

	 Moving in dialog boxes 

	 Moving the insertion point within text 

Selection Keys
	 Selecting Text 

~0000007700
Deletion Keys

Press Ctrl+Z to undo your last deletion.

  Press	To delete
 ___________________________

 BackSpace	Character to the left of insertion point

 Del	Character to the right of insertion point or selected text

 Ctrl+Del	Text to the right of insertion point up to end of a line

 Ctrl+X	Selected text and send it to the Clipboard

~0000007701
File Handling Keys

  Press	To
 ____________________________

 F3	Choose  File|Open 

 F2	Choose  File|Save 

~0000007702
Function Keys

 Press	To
 ___________________________

 F1	Get help on the currently selected command, open dialog box, or message

 F3	Choose  File|Open 

 F2	Choose  File|Save 

 F7	Run the spell checking program for the selected text

 F10	Toggle to the menu bar

 Alt+F4	Close application or dialog window

~0000007703
Insertion Keys

 Press		To insert
 _________________________________

 Ctrl+V	Clipboard contents

When autoindent is turned on:
 Enter		New line and indent

 Ctrl+Enter		New line

When autoindent is turned off:
 Enter		New line

 Ctrl+Enter  	New line and indent


Note:
Overtype mode in not supported before Motif 1.2.
~0000007704
   Movement Keys: Moving and sizing windows

 Press	To
 _________________________________

 Alt+F5   Restore application window to previous size.

 Alt+F7   Move application window or dialog box; use the direction keys to move the window, then press Enter to set the position.

 Alt+F8   Size application window; use the direction keys to size the window, then press Enter to set the size.

 Alt+F9   Shrink application window to an icon.

 Alt+F10  Enlarge application window to maximum size.

Note:
You can also pull down the window menu using Alt+Spacebar or Shift+Escape and select the appropriate menu option.
In dialog windows the entries Alt+F5, Alt+F10 do not exist.

~0000007705
   Movement Keys: Moving in dialog boxes

 Press		To
 _________________________________

 Tab		Move to next option

 Shift+Tab	Move to previous option

 Esc		Close dialog box without carrying out a command

 Enter		Execute highlighted option

 Alt+F7		Move dialog box; use the direction keys to move the dialog box, then press Enter to set the position

~0000007706
   Movement Keys: Moving the insertion point within text

 Press		 To move
 __________________________________

 Direction keys	 One character or one line

 Ctrl+'<-'  	 One word left
 Ctrl+'->'  	 One word right
 Ctrl+'up key' 	 One paragraph up
 Ctrl+'down key' One paragraph down

 Home		 To beginning of line
 End		 To end of line
 Ctrl+Home	 To document beginning
 Ctrl+End	 To end of document
 PgUp		 Up one window
 PgDn		 Down one window
 Ctrl+PgUp	 To document beginning
 Ctrl+PgDn	 To end of document


_________
See also:
  Emacs bindings 

~0000770600
	Emacs bindings

The default key bindings in "emacs" mode are patterned, where possible, after those in the Emacs text editor.
Following Emacs keyboard commands are available:

 Ctrl+a   Beginning Of Line
 Ctrl+b   Backward Character
 Ctrl+d   Delete Next Character
 Ctrl+e   End Of Line
 Ctrl+f   Forward Character
 Ctrl+h   Delete Previous Character
 Ctrl+j   New Line And Indent
 Ctrl+k,Ctrl+k   Kill To End Of Line
	  (Note for the above: we cannot use the standard
	  Ctrl+k because it clashes with bookmarks setting)
 Ctrl+n   Next Line
 Ctrl+o   New Line And Backup
 Ctrl+p   Previous Line
 Ctrl+w   Kill Selection
 Ctrl+y   Unkill

 Meta+b   Backward Word
 Meta+d   Delete Next Word
 Meta+y   Insert Current Selection
 Meta+<   Beginning Of File
 Meta+>   End Of File
 Meta+]   Forward Paragraph
 Meta+[   Backward Paragraph
 Meta+Delete   Delete To Start of Line
 Ctrl+Meta+f   Forward Word (we cannot use Meta+f because it clashes with the file menu accelerator)

(Note: a small number of Emacs bindings are not implemented because they clash with menu accelerators)

The general method of keyboard text selecting in ASEDIT is moving the cursor with the Shift key hold down.  To extend this method to Emacs' movement keys the following additional bindings are implemented:

 Shift+Ctrl+a   Beginning of Line (extend of the selection)
 Shift+Meta+b   Backward word (extend of the selection)
 Shift+Ctrl+e   End of Line (extend of the selection)
 Shift+Meta+[   Backward Paragraph (extend of the selection)
 Shift+Meta+]   Forward Paragraph (extend of the selection)
 Shift+Meta+<   Beginning of File (extend of the selection)
 Shift+Meta+>   End of File (extend of the selection)


Since all of these key bindings are set through the translations and resource manager, the user and the application programmer can modify them by changing the Text widget's translations resource.


Note that the class name for asedit in Emacs mode is: Asedit_em.

_________
See also:
  Moving the insertion point within text 
  Selecting text with Keys 

~0000007707
   Selection Keys: Selecting Text

 Press			To select
 __________________________________

 Shift+direction keys	Characters or lines

 Shift+Home		To beginning of line

 Shift+End		To end of line

 Ctrl+Shift+Home	To beginning of document

 Ctrl+Shift+End		To end of document


Note: engaging the Caps Lock does not substitute for holding down the Shift key.
_________
See also:
  Emacs bindings 

~0000800104
	Requirements

ASEDIT runs on most workstations supporting X Window System and Motif.  To run remotely you need X-Server supporting X-Windows.  Note that a proper international support is available only since X-Windows Release 5 and Motif 1.2.

The main platforms ASEDIT works on include:
	IBM RS/6000 running AIX 3.2.x
	SGI running IRIX 4.x or IRIX 5.x
	Sun Sparc running SunOS 4.x or SunOS 5.x
	Hewlett-Packard HP9000 series 700/800 running HP-UX 8.x or HP-UX 9.x
	Data General AViiON running DG/UX
	DEC Alpha running OSF/1

~0000800105
	Screen Regions

Specific for mwm (Motif Window Manager):

   Icon 

   Maximize Button 

   Minimize Button 

   Resize Border Handles 

   Title Area 

   Title Bar 

   Window Menu Button 


ASEDIT specific:

   Edit Area 

   Menu bar 

   Scroll bars 

   Status Line 

~0080010500
	Icon

Icons are small graphic representations of windows. A window can be minimized (iconified) using the minimize button on the window frame. Icons provide a way to reduce clutter on the screen.

Pressing mouse left button when the pointer is over an icon causes the icon's window menu to pop up. Releasing the button (press + release without moving mouse = click) causes the menu to stay posted. The menu contains the following selections:

	Icon Window Menu

Selection Accelerator	Description
______________________________________________________

Restore	   Alt+F5	Opens the associated window

Move	   Alt+F7	Allows the icon to be moved with keys

Size	   Alt+F8	Inactive (not an option for icons)

Minimize   Alt+F9	Inactive (not an option for icons)

Maximize   Alt+F10	Opens the associated window to full screen size

Lower	   Alt+F3	Moves icon to bottom of icon stack

Close 	   Alt+F4	Causes client to terminate


Note that pressing middle button over an icon also causes the icon's window menu to pop up. To make a menu selection, drag the pointer over the menu and release middle button when the desired item is highlighted.

Double-clicking left button on an icon normalizes the icon into its' associated window (in general, double-clicking a mouse button is a quick way to perform a function).

~0080010501
	Maximize Button

To make the window fill the screen  (or enlarge to the largest size allowed by the configuration files), click left button on the maximize button (the frame box with a large square in it).

~0080010502
	Minimize Button

To turn the window into an icon, click left button on the minimize button (the frame box with a small square in it).

~0080010503
	Resize Border Handles

To change the size of a window, move the pointer over a resize border handle (the cursor changes), press left button, and drag the window to a new size. When the button is released, the window is resized. While dragging is being performed, a rubber-band outline is displayed to indicate the new window size.

~0080010504
	Title Area

In addition to displaying the "asedit" name with a name of currently opened file, the title area is used to move the window.
To move the window, place the pointer over the title area, press left button and drag the window to a new location. A wide frame is moved during the drag to indicate the new location. When the button is released, the window is moved to the new location.

~0080010505
	Title Bar

Located along the top of a window.
Drag the title bar to move the window. Dialog boxes with title bars can also be moved in this way.
The title bar includes the title area, the minimize button, the maximize button, and the window menu button.

~0080010506
	Window Menu Button

The Window Menu Button is the frame box with horizontal bar in it. To pull down the window menu, press left button. While pressing, drag the pointer on the menu to your selection, then release the button when your selection is highlighted. Alternatively, you can click left button to pull down the menu and keep it posted; then position the pointer and select.

	Default Window Menu

Selection Accelerator	Description
______________________________________________________

Restore	   Alt+F5	Restores the window to its' size
			before minimizing or maximizing

Move	   Alt+F7	Allows the window to be moved
			with keys or mouse

Size	   Alt+F8	Allows the window to be resized

Minimize   Alt+F9	Turns the window into an icon

Maximize   Alt+F10	Makes the window fill the screen

Lower	   Alt+F3	Moves window to bottom of window stack

Close 	   Alt+F4	Causes program to quit (or close the top window)

~0080010507
Edit Area

The main part of the ASEDIT window is taken by an editable workspace. Motif Text widget is used as a base for the workspace.
It allows text to be edited, inserted, and selected. The user can cut, copy and paste text using Clipboard, primary transfer, or secondary transfer.
Since Motif 1.2 text can also be dragged and dropped.

The user interface implemented is based on the "point and click" model.

The insertion cursor, displayed as an I-beam, shows where input is inserted. Clicking the left button moves the insertion cursor to a new position, so newly typed text may be inserted at arbitrary locations.
The editor is in text-insertion mode, as default.  Overwrite mode is supported only with Motif 1.2 or higher.

~0080010508 0000800202 Screen Regions/Menu Bar -->	ASEDIT Menus

~0080010509
Scroll bars

To scroll text with the mouse use scroll bars. They are located at the right and bottom edges of the Edit Area.
The size of the scroll slider inside the scroll bar represents how much of the document being edited is visible; it's position indicate your location in the document (vertically or horizontally). You can use the mouse to scroll to other parts of the document.

Using vertical scroll bar
Part		Mouse action
__________________________________

Top Arrow	Click to scroll up one line
Above Slider	Click to scroll up one full window
Slider		Drag to move to an appropriate location in the document
Below Slider	Click to scroll down one full window
Bottom Arrow	Click to scroll down one line

Using horizontal scroll bar
Use the horizontal scroll bar to move left and right as you use the vertical scroll bar to move up and down.
Note:
The horizontal scrollbar does not exist when you use asedit in the "wrap word" mode.

Scrolling with keys
When you use keys to move the insertion point to text outside the window, the document scrolls automatically, both vertically and horizontally.
Note that holding down the Ctrl key while pressing any movement key extends the scope of action it performs. For example, '<-' moves one character left, Ctrl+'<-' moves one word left.

~0080010510
Status Line

The line at the bottom of the ASEDIT window that shows status information. It consists of: one character wide edit status field and line and column display area.

The edit status field shows either:
    -  nothing (space) when you start editing or no changes were made
    -  * (star) when changes were made to the edited text and they are not saved yet
    -  R (letter R) when the file is opened for view only (read-only mode); this mode might be selected by the user during loading of a file or might be set automatically for files that are read-only for the user.

The line and column display area shows information about the insertion point position.

Status information example:
Example		Meaning
*		Changes have been made and not saved yet
Line:: 12	Line number of the insertion point
Col::  33	Column number of the insertion point, spaces and tabs included


~0000800106
	Users' Q & A

Listed below are some frequent users' questions and answers about ASEDIT.

**Please**  read them and associated information before contacting the supporting person or the author of the program.


Program startup
_______________

[Q] On a program startup I get a lot of warnings like this:
	Warning: translation table syntax error: Unknown keysym name: osfActivate
	...
What is wrong??

[A] Probably, the key symbols database can't be accessed.
Check the environmental variable XKEYSYMDB by typing:
	echo $XKEYSYMDB

If it is not set up or points to a wrong file correct it. Below you can find a sequence for a SOLARIS standard configuration. Type:

For Bourne/Korn shell:
	XKEYSYMDB=/usr/openwin/lib/XKeysymDB; export XKEYSYMDB

For C shell:
	setenv XKEYSYMDB /usr/openwin/lib/XKeysymDB

... and start asedit again.

Note if you don't have XKeysymDB on your system ,or the above method doesn't work, get a copy of XKeysymDB and put it into /usr/lib/X11 directory.


[Q] I got used to Emacs bindings in asedit 1.2. What happened to them in ver. 1.3 ?
[A] There were to many clashes between the popular shortcut keys and the Emacs keys. From version 1.3 the Emacs bindings have been dropped in the default version.
    However, you can run asedit in a special Emacs mode by specifying "-emacs" command line option. Note that an alternate set of bindings is used, the class name for such asedit is Asedit_em and alternate help file "asedit_em.hlp" is needed.


[Q] During a startup program I get a warning about incompatible application defaults file. Why ?
[A] Probably an old (version 1.1x or 1.2x) application defaults file was loaded. Those files are incompatible with asedit 1.3 and some functionality might be lost.  You *should* correct it!  Read the next question.


[Q] My localized version in XYZ language doesn't start up. Why ?
[A] Appropriate application defaults file was not found. Check the current settings for the LANG variable.  Run the following command to see what asedit resources are loaded on startup:
	appres Asedit asedit
If you're having trouble finding appdefs on your system, try looking at the environment variables XAPPLRESDIR, XUSERFILESEARCHPATH, and XFILESEARCHPATH. They specify where to look for application-specific X resource files.


Files
_____

[Q] I don't see any files in the File selection box. Why ?
[A] Most probably you specified the filter part improperly, i.e. without the trailing '\' or the directory part.  For a detail description how to select a file see:
         Selecting a file 

[Q] Accelerators (shortcuts for menu items) don't seem to work. They were a while ago. What's happened ?
[A] Check the status of the Caps Lock and Num Lock. Neither of them should be engaged.


Editing
_______

[Q] Why can't I change anything in my file ?
[A] The file is read-only or was opened for view only.  This is the case if the status line shows a letter R and the edit window background is slightly lighter than usual.

[Q] Why columns in my file don't line up ?
[A] You are most probably using a proportional font. Use a fixed font instead (see the original ASEDIT application defaults file).

[Q] I can't undo an action I did a while ago. Why ?
[A] There is a limit on number of edit actions that can be undone. The default value is 250.

[Q] How can I disable creating backup files ?
[A] Define the backupFileSuffix as an empty string. The definition should look like this:
	*backupFileSuffix:
    and should be placed in your Asedit defaults file (or in the system wide Asedit application defaults file if you are the system administrator).

[Q] Why the background colour for the edit area is darker than I specify ?
[A] [only for asedit ver. 1.2 or when "*useOldColorSetup" resource is True]
    ASEDIT distinguishes visually editable state of any text widget from its' read-only state but making it slightly darker.  Before ver. 1.3 the darker colour was calculated internally by asedit; the background colour resource definition was used for the view only state.


Localization
____________

[Q] Why my native language XYZ is not supported ?
[A] Because I don't know it (:-) ) and nobody contributed it yet. 

[Q] I really would like to get a version for my native language. Can I help ?
    Yes you can! If you are ready to spend some time translating a special localization file, contact me at: 
	astoch@ic.ac.uk
    Note that asedit supports only the left to right languages with single-byte character sets.

~0000002701
To cancel before, during, or after an action

Before
   In a dialog box that has a Cancel button press Esc key or click Cancel.
   In a dialog box that has a Close button, an action is carried out as soon as you choose an option. Esc key will not reverse these actions.

During
   Press Esc key.
   If the process does not stop, press Esc again.
Note: Some operations cannot be interrupted once started.

After
   To cancel the most recent editing
   Choose Edit| Undo  or press Ctrl+Z.
Note: you can undo more than one editing operation, simply repeat the action above.

~0000002703
To copy text to the Clipboard

1.   Select  the contents you want to remove.
2.  Choose Edit|Copy or press Ctrl+C.
	The contents will be placed on the Clipboard.

You can then paste that text into any other document with the Edit| Paste  command.

The text remains in the  Clipboard  so you can paste it many times.

_________
See also:
  Copying text 
  Alternate edit shortcut keys 
  Pop-up menu 

~0000002704
To cut text to the Clipboard

1.   Select  the contents you want to remove.
2.  Choose Edit|Cut or press Ctrl+X.
	The contents will be placed on the Clipboard.

You can then choose Edit| Paste  to paste that text into any other document (or somewhere else in the same document).

The text remains in the  Clipboard  so you can paste it many times.

_________
See also:
  Copying text 
  Alternate edit shortcut keys 
  Pop-up menu 

~0000002705
To paste text from the  Clipboard 

1.  Place the insertion point where you want to insert the Clipboard contents.
2.  Choose Edit|Paste or press Ctrl+V.


_________
See also:
 Edit| Cut  command
 Edit| Copy  command
  Copying text 
  Alternate edit shortcut keys 
  Pop-up menu 

~0000002706
   To choose and carry out a command

  With keys
1. Hold down the Alt key and press the underlined letter in the menu name.
   - or - Press F10 to go to the menu bar, then use the direction keys to select the menu you want, then press Enter.
2. Press the underlined letter in the command name.
   - or -
   Use the direction keys to select the command you want, then press Enter.

  With mouse
1. Point to the menu name.
2. Click the left mouse button.
3. Point to the command name.
4. Click the left mouse button.

If a command name is followed by an ellipsis (...), a dialog box will appear. Choose the options you want, then press Enter or click OK to carry out the command.
_________
See also:
  Cancelling before, during, or after an action 
  Choosing a button or selecting an option in a dialog box 

~0000002708
To copy a document

0. If you've just made some changes save them using File|Save.
1. Choose File|Save As.
2. In front of the file name, type the path name for the directory where you want to copy the document.
   - or -
   Type a different file name if you want a copy of the document in the same directory.
3. Choose OK.
_________
See also:
  Making a backup copy of a document 

~0000002709
Copying text

Three different methods of text copying are supported by ASEDIT:

   Clipboard     Primary selection    Secondary selection 


The use of different technique depends on personal preferences. Our recommendations are as follows:

Clipboard - general usage; use as a longer-term storage; method widely accepted in the word-processing;

Primary selection   - general method of transferring data between different X-Windows applications (for example, this is used to transfer data from/to xterm);

Secondary selection - a quick method, but limited to Motif applications; it is most useful for copying text at the point where you are currently typing.

~0000002710
To copy text using Clipboard:

1. Select the text you want to copy.
2. Choose Edit|Copy or press Ctrl+C.
3. If copying between documents, move the insertion point to the second document.
4. Place the insertion point where you want to insert the copy (either using mouse or the direction keys).
5. Choose Edit|Paste or press Ctrl+V.

Note: The text remains in the Clipboard so you can paste it many times.
If you want to copy text between two documents using Clipboard, first open both documents using ASEDIT.

_________
See also:
  Copying text using Primary selection 
  Copying text using Secondary selection 
  Alternate edit shortcut keys 
  Pop-up menu 

~0000002711
To copy text using Primary selection:

1. Select the text you want to copy (it may be in ANY application supporting primary selections).
2. Place the insertion point where you want to insert the copy (either using left button or the direction keys).
3. Click the middle button.

Note: 	An important constraint is that only one window may "own" a selection property at one time. This means that once the user makes another primary selection, the original selection is lost.
	The primary selection is very often used to copy text between different X-Windows applications.

_________
See also:
  Copying text using Clipboard 
  Copying text using Secondary selection 

~0000002712
To copy text using Secondary selection:

1. Place the insertion point where the copied text WILL go (either using left button or the direction keys).
2. Go to the text that needs to be copied and mark it by pressing and dragging the mouse middle button (the text should be now underlined).
3. Release the middle button. The marked text is immediately stuffed where the insertion cursor was placed before.

Note: Unlike primary selections, which may be retrieved many times, secondary selections are immediate and can only be stuffed once (at the time the selection is made).
Whereas primary selections are supported, secondary selections are generally not. In fact only certain X-Windows programs support them.

_________
See also:
  Copying text using Clipboard 
  Copying text using Primary selection 

~0000002743
    To find the matching delimiter

Position the cursor just before the delimiter (for example {, ], or "). Then:

  press Ctrl+Q,Ctrl+[ to match forward,

  or

  press Ctrl+Q,Ctrl+] to match backward.


The following pairs are supported: {}, (), [], <>, "", ``, //, '', \\ .


You can also use the Search|Match delimiter menu.

_________
See also:
 Search| Match delimiter  menu


~0000002715
To delete text when you start typing
1.	Select text.
2.	Start typing.


~0000002716
   To choose a button or select an option in a dialog box

With keys
  Press (once or more) Tab or Shift+Tab key to go to the option requested, then press Enter or Spacebar.
  For the default button (usually OK), press Enter.
  For Cancel or Close, press Esc key.

With mouse
  Point to the button or option and click the left mouse button.

_________
See also:
  Moving around in a dialog box 

~0000002717
   To insert a response in a text box

1.  If the text box's border is not highlighted select the box by either:
	pointing it by mouse and clicking the left mouse button
	- or -
	pressing (once or more) Tab or Shift+Tab key to move focus to the box requested.
2.  Type your response.

    You can then edit your response the same way as in document text.

~0000002718
   To move a window or dialog box

   With keys
1.	If the borders aren't visible, restore the window to display them.
2.	Press Alt, Spacebar, M.
3.	Press the direction keys to position the outline of the window.
4.	Press Enter to move the window.
   With mouse
z	Drag the window or dialog box title bar.
	Note: Only some dialog boxes have title bars.
- or -
1.	Choose Window Menu|Move.
2.	Press a direction key.
3.	Use the mouse to move the outline of the window or dialog box.
4.	Click the left mouse button to anchor the window or dialog box in the new location.
_________
See also:
  Sizing a window 

~0000002719
   To move around in a dialog box
   With keys
	Press Tab to move through the buttons and options one by one (pressing Shift+Tab moves you backward).
   With mouse
	Point to the button or option and click the left mouse button.
_________
See also:
  Moving a window or dialog box 

~0000002720
   To exit ASEDIT

	Choose File|Exit


Note: If you've modified a file without saving it, ASEDIT prompts you to do so before exiting.
      See the  File not Saved !  warning dialog.

_________
See also:
  Pop-up menu 

~0000002726
Selecting a file

You select a file using a special file selection dialog. Its' detailed description follows.

The file selection dialog displays the file system hierarchy so that you can select a file or directory for.

The dialog provides the ability for you to specify a  Filter  to indicate which files from a directory you are interested in. This filter is generally given as a regular expression using UNIX meta-characters (e.g. "*" matches all files, while "*.c" matches all files that end in ".c").

The dialog is broken down into three main components:
 - the directory mask identifies the directory to use and a filter or pattern-matching string;
 - the  Directories  and  Files  list boxes break down the mask into two lists (a list of directories and a list of files within the selected item from the directory list);
 - the Selection text box identifies a file to use when the OK button is activated.

The Filter button acts on the directory and pattern specified in the Filter text box.  For example, consider the following filter text:
	/home/turbo/demo/*
Since directories are delimited by the "/" character, the very last segment ("*") is the "pattern" and is treated as a filter for the directory preceding it ("/home/turbo/demo"). When you select the Filter button or press Enter key in the filter's text box, the directory part of the filter is searched and all the directories within that directory are displayed in the Directories list. The pattern part is then used to find all matching files within the directory; the result is listed in the Files list.
Note: Only files are placed in the Files list; directories are excluded since they are listed separately.

The above seems straightforward, but it can become VERY confusing for some users. For example, consider the following filter text:
	/home/turbo/demo
This path name appears to be a common directory path, but in fact, the directory is "/home/turbo" and the pattern is "demo". If searched, the Directories list will contain all the directories in "/home/turbo" and the Files part won't contain anything because "demo" is a directory - not a pattern that will match any other files.
This is one of the MOST common mistake made by users!

Therefore, you should remember to use the last "/" in the filter's path name to separate the directory part from the pattern part.

Note about file selection box for loading (opening) a file:
The file selection box for loading a file has one extra toggle button embedded in a frame located just below the Directories and Files lists. It is called Open for view only and you should toggle it on when you would like to view only the specified file (as opposed to changing it).


~0000002728
   To move text between applications

Most X-Windows and Motif text applications support only "copy and paste" functionality (including primary and secondary selections).
To move text between applications an extra "cut and paste" functionality must be build in. This is usually done with Edit menu. If both applications use the standard Motif Cut/Paste procedures you can easily move text between them. To move text:

1.	Start both applications, and open the applicable files in each.
2.	Select the text you want to move.
3.	Choose Edit|Cut.
4.	Place the insertion point where you want to insert the text.
5.	Choose Edit|Paste.
- or -
1.	If you run one application at a time, start the application for the file containing the text you want to move, then open that file.
2.	Select the text you want to move.
3.	Choose Edit|Cut.
4.	Close the application.
5.	Start the application for the file where you want to move the text, then open that file.
6.	Place the insertion point where you want to insert the text.
7.	Choose Edit|Paste.
_________
See also:
  Cutting text to the Clipboard 
  Moving text within a document or between documents 
  Pasting text from the Clipboard 

~0000002729
   To move text within a document or between documents

If you want to move text between two documents, first open both documents.

   With command
1.	Select the text you want to move.
2.	Choose Edit|Cut.
3.	Place the insertion point where you want to move the text.
4.	Choose Edit|Paste.

   With keys
1.	Select the text you want to move.
2.	Press Ctrl+X.
3.	Place the insertion point where you want to move the text.
4.	Press Ctrl+V.

_________
See also:
  Copying text 
  Moving text between applications 
  Alternate edit shortcut keys 
  Pop-up menu 

~0000002730
   To create a new document

1. Choose File|New.
2. Type the text for the new document.
3. Choose File|Save or File|Save As.
4. Type name of a new document in the Save As dialog, then choose OK.

~0000002731
   To open a document
1.	Choose File|Open or press F3.
2.	Type or select the name of the document you want to open.
	If the document is not listed in the current directory, either type the directory name in front of the document name, or select the directory in the Directories box.
3.	Choose OK (or just press Enter).

_________
See also:
  Pop-up menu 
~0000002733
   To print a document

   Choose File|Print.
_________
See also:
 File| Print 

~0000002734
   To rename a document
1.	Choose File|Save As.
2.	Type a new name for the document.
3.	Choose OK.
	You now have a copy of the document with the new name.
4.	If you want, delete the document with the old name.
_________
See also:
  Copying a document 
  Making a backup copy of a document 

~0000002735
Redoing an undo action

To redo undo operation select Edit| Redo . Alternatively use Shift+Ctrl+Z shortcut key.

~0000002736
Repeating previous search

To repeat previous search use Search| Find Next  command.

Alternatively use Ctrl+L shortcut key (when in the edit window).

~0000002737
To search and replace text

1.	Choose Search|Change.
2.	Type the text you want to search for (change) in the Text to Find: box.
3.	Type the replacement text in the Change To: box.
	- or -
	If you want to remove the Text to Find: text from the document, leave the Change To: box blank.
4.	Options. If you want to limit the search, turn on Case sensitive and/or Whole words only.
5.	Direction. You can select either Forward or Backward search.
6.      Choose one of the buttons in the action area:
	Find & Verify button - If you want to confirm each change before it's done. Each time you will be prompted to change or skip the text found, or cancel the search altogether.
	- or -
	Change All button - If you want to make all the changes (the number of changes will be displayed afterwards in a pop-up dialog).

_________
See also:
  Searching for text 

~0000002739
Backup copy of a document when saving

As default ASEDIT creates a backup copy whenever a file with a specified name already exists (a default suffix .bak is used).
This can be however changed (overridden) by setting the "*backupFileSuffix" resource. Different/local language suffix may be chosen or the backup copy option might be completely turned off (by specifying no suffix).

_________
See also:
  Copying a document 

~0000002740
To save a document

     Choose File|Save or press F2 shortcut key.

_________
See also:
  Making a backup copy of a document 
  Renaming a document 
  Pop-up menu 

~0000002745
   To search for text
1.	Choose Search|Find.
2.	Type the text you want to find in the Text to Find: box.
3.	Options. If you want to limit the search, turn on Case sensitive and/or Whole words only.
5.	Direction. You can select either Forward or Backward search.
6.	Choose Find Next button to find the nearest occurrence of the text.

_________
See also:
  Searching and replacing text 

~0000002747
   To select text with the mouse

Any text
1.	Point to the beginning of the text you want to select and click the left mouse button.
2.	Hold down the left mouse button and move the mouse pointer to the end of the text you want to select.
	- or -
	Point to the end of the text you want to select, then hold down Shift and click the left mouse button.

A word or line
1.	Place the insertion point in the word or line.
2.	For a word, double-click left mouse button.
	For a line, triple-click left mouse button.

_________
See also:
  Selecting text with Keys 

~0000002744
    To search for selection
    (another occurrence of a selected text)

1. Select in the edit window what you want to search for
   (remember double-click selects a word).
2. Press Ctrl+L or choose Search|Find Next command.

All settings made in the Find dialog box remain in effect when you choose Find Next.

Note: do NOT include a new line in the selection, otherwise the highlighted text is not treated as an item to search for.
_________
See also:
  Find dialog box 

~1800000000
	      List of menu commands



