1ASEDIT - 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
2
3@(#) asedit help file: Ver. 1.300, 6 June 1994
4@(#) Copyright 1992 - 1994, Andrzej Stochniol, London, UK.
5
6@(#) special version for Emacs mode
7
8~0000000010
9	File menu (Alt+F)
10
11The File menu provides following commands:
12
13    New 	- creates a new asedit window
14
15    Open... 	- opens an existing file
16
17    Close 	- closes the active file and window
18
19    Save 	- saves the active file
20
21    Save As... 	- saves the active file under a new name
22
23    Insert... 	- inserts a file into the edited text
24
25    Print... 	- prints the active file or a selection
26
27    Exit 	- exits from the current window and quits ASEDIT if that was the last window
28~0000001000
29	File|New
30
31The File|New command opens a new asedit window with a default NoName1 file (or NoName2, and so on).
32
33You 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.
34
35The new edit window is completely independent from the previous one(s) (except the help system which is shared between all asedit windows).
36
37~0000001001
38	File|Open...  (F3)
39
40The File|Open command displays the   Open a File   dialog box, where you select or enter the name of a file to open.
41
42If the current window is being used to edit any text, a new window will be created to edit the requested file.
43
44The new window is completely independent from the previous one(s), except the help system which is shared between all asedit windows.
45
46_________
47See also:
48  Pop-up menu
49
50~0000001002
51	File|Close
52
53The File|Close command closes the edited file and its associated window (if it is not the last asedit window).
54
55If 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.
56
57~0000001003
58	File|Save (F2)
59
60The File|Save command saves the edited file to disk. Pressing the F2 key from within the program also performs the same task.
61
62If 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.
63_________
64See also:
65  Pop-up menu
66
67~0000001004
68	File|Save As...
69
70The File|Save As command opens up the  Save As   dialog box, where you can save the edited file under a different name.
71
72You can enter the new file name or select it from Files and Directories boxes, and then activate the OK button.
73
74If 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.
75
76Note: having saved the file all windows containing the old file name are updated with the new one.
77
78~0000001005
79	File|Insert...
80
81The 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.
82
83~0000001006
84	File|Print...
85
86The File|Print command opens up the   Print   dialog box, where you select what to print and which printer to print on.
87
88~0000001007
89	File|Exit
90
91The File|Exit command closes all ASEDIT windows and removes the program from the memory (quits it).
92
93If you've modified a file without saving it, ASEDIT prompts you to do so before exiting. See the  File not Saved !  warning dialog.
94
95_________
96See also:
97  Pop-up menu
98
99~0000100100
100	Open a File dialog box
101
102Open a File dialog box comes up when you choose the File|Open menu command.
103
104To open a file:
1051.  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.
1062.  Choose OK.
107
108If you would like to view only the file, set the Open for view only button.
109
110If the current window is being used to edit any text, a new window will be created to edit the requested file.
111
112For a detail description how to select a file see:
113	 Selecting a file
114
115Note: 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).
116
117~0000100200
118	File not Saved ! warning dialog
119
120File 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.
121
122You have to decide whether or not to save the file. Alternatively you can abandon the operation by activating the Cancel button.
123
124~0000100400
125	Save As dialog box
126
127Save As dialog box comes up when you choose the File|Save As menu command.
128
129To save file under a new name:
1301.  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.
1312.  Choose OK.
132
133If 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.
134
135For a detail description how to select a file see:
136	 Selecting a file
137
138~0000100401
139	Overwrite ? question dialog
140
141You'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.
142
143~0000100500
144	Insert a File dialog
145
146Insert 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.
147
148To insert contents of a file:
1491.  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.
1502.  Choose OK.
151
152For a detail description how to select a file see:
153	 Selecting a file
154
155~0000100600
156	Print dialog
157
158Print dialog comes up when you choose the File|Print menu command.
159
160To select print range	Select this
161___________________________________
162Entire document		Complete document radio button
163Selected text only	Selected text only radio button
164
165Setting printer:
166Choose 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.
167
168You can also use the print dialog to apply UNIX filters to either a selected text or the entire edit buffer.  For details see:
169	 Applying a UNIX filter
170
171(there you can find out how to write out a selected text to a file, and more ...).
172
173~0010060000
174	Applying a UNIX filter
175
176You 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.
177
178If 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.
179
180The examples below show how useful the Print dialog with UNIX filters can be.
181
182Block write.  Sometimes it is very useful to save a selected text into a file. To do this:
183- select the text
184- in the Print dialog set the  Selected text only  button (to pop-up the Print dialog use the File|Print command)
185- in the  Print using:  area write the following command:
186	cat - > file_name
187- activate OK button
188
189You can use the above method together with other UNIX filters to implement a number of interesting features. For example using as a print command:
190	fmt > file_name
191would create a formatted output on the file_name (further details see man pages for fmt), and the following "print" command:
192	spell > file_name
193would create a file with list of spelling errors.
194
195Notes:
196You 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.
197Most of the UNIX filters operate on complete lines, so DO include in the selected text the final line feed.
198
199~0000000020
200	Edit menu  (Alt+E)
201
202The Edit menu provides commands to cut, copy, and paste text in the edit window.
203If you make a mistake, you can undo changes. You can also reverse the effect of your recent undo(s).
204
205Each of the Edit menu commands is listed below:
206
207
208	 Undo
209
210	 Redo
211
212	 Cut
213
214	 Copy
215
216	 Paste
217
218	 Clear
219
220Before 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).
221You can select text either with keyboard or with the mouse. See  Text selection  for more information.
222
223Once 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.
224
225~0000002000
226	Edit|Undo	(Ctrl+Z)
227
228The Edit|Undo command restores the edited file to the way it was before the most-recent edit or cursor movement.
229Undo 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).
230
231There are restrictions on what and how many operations can be undone.
232Undo 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.
233
234To reverse the effect of the most recent Undo command use:
235	 Redo
236
237_________
238See also:
239  Alternate edit shortcut keys
240  Pop-up menu
241
242~0000200001
243	Alternate edit shortcut keys
244
245The following alternate shortcut keys for the most common edit operations are supported:
246
247  Edit|Undo	-  Alt+BackSpace
248  Edit|Redo	-  Shift+Alt+BackSpace
249  Edit|Cut  	-  Shift+Del
250  Edit|Copy	-  Ctrl+Ins
251  Edit|Paste	-  Shift+Ins
252
253Note:
254Both 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).
255~0000200002
256	Pop-up menu
257
258Asedit supports the most common editing actions in a separate quick editing pop-up menu. It includes the following commands:
259
260	Undo
261
262	Cut
263	Copy
264	Paste
265
266	Open...
267	Save
268
269	Exit
270
271Undo, Cut, Copy and Paste perform the same actions as appropriate commands in the Edit menu.
272Open, Save and Exit perform the same actions as appropriate commands in the File menu.
273
274To activate the pop-up menu press the right mouse button (when inside the main area). Then to select the command:
275  - drag the mouse to the command you want to choose;
276    or
277  - release the right button, then use any of the following methods to select the command you want:
278	click the command,
279	or
280	use the up and down arrow keys to go to the command, then press Enter to select it,
281	or
282	press the underlined letter of the command you want to select.
283
284
285~0000002001
286	Edit|Redo	(Shift+Ctrl+Z)
287
288The Edit|Redo command reverses the effect of the most recent  Undo  command.
289
290The 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.
291
292_________
293See also:
294  Alternate edit shortcut keys
295
296~0000002002
297	Edit|Cut	(Ctrl+X)
298
299The Edit|Cut command removes the  selected text  from your document and places the text in the Clipboard.
300
301To cut text to the Clipboard:
3021.  Select the contents you want to remove.
3032.  Choose Edit|Cut, or press Ctrl+X.
304    The contents will be placed in the Clipboard.
305
306You can then paste that text into the same or any other document with the Edit| Paste   command.
307
308The text remains in the  Clipboard  so you can paste it many times.
309
310_________
311See also:
312  Alternate edit shortcut keys
313  Pop-up menu
314~0000002003
315	Edit|Copy	(Ctrl+C)
316
317The Edit|Copy command leaves the  selected text  intact and places an exact copy of it in the Clipboard.
318
319To copy text to the Clipboard:
3201.  Select the contents you want to copy.
3212.  Choose Edit|Copy, or press Ctrl+C.
322    The contents will be placed in the Clipboard.
323
324You can then paste that text into the same or any other document with the Edit| Paste  command.
325
326The text remains in the  Clipboard  so you can paste it many times.
327
328_________
329See also:
330  Alternate edit shortcut keys
331  Pop-up menu
332~0000002004
333	Edit|Paste	(Ctrl+V)
334
335The 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.
336
337To paste text from the Clipboard:
3381.  Place the insertion point where you want to insert the Clipboard contents.
3392.  Choose Edit|Paste, or press Ctrl+V.
340
341_________
342See also:
343 Edit| Cut  command
344 Edit| Copy  command
345  Alternate edit shortcut keys
346  Pop-up menu
347~0000002005
348	Edit|Clear
349
350The Clear command removes the selected text but does not put it into the  Clipboard .
351
352This means you cannot paste the text as you could if you had chosen Edit| Cut  or Edit| Copy .
353
354~0000002006
355	Text selection
356
357You can select (highlight) text either with keyboard or with a mouse.
358
359From the keyboard simply:
360
361    -	Press Shift key while pressing any key that moves the cursor (arrows etc.)
362	To select the whole text press Shift+Ctrl+/ (to de-select all press Shift+Ctrl+\).
363
364With a mouse:
365
366    -   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.
367
368    -   In addition to the click-and-drag technique for text selection the multiple click technique is supported:
369a double-click selects a word, triple-clicking selects the current line, and quadruple-clicking selects all the edited text.
370You 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.
371
372    -   To extend or reduce a selection, hold Shift key and click.
373
374
375Once 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 .
376
377~0000002007
378	Clipboard
379
380For 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.
381
382Note that with keyboard shortcuts for Cut/Copy/Paste  Clipboard functionality is extended to all text areas in the program (including dialogs).
383
384~0000000030
385	Search menu  (Alt+S)
386
387The Search menu provides commands to search for text, replace text, go to a specific line, use bookmarks and match delimiters.
388
389Each of the Search menu commands is listed below:
390
391	 Find...
392
393	 Find Next
394
395	 Change
396
397	 Go to Line...
398
399	 Bookmark  >
400
401	 Match delimiter   >
402
403~0000003000
404	Search|Find... (Ctrl+Q,Ctrl+F)
405
406The Search|Find command displays the  Find  dialog box, where you type in the text you want to search for.
407In the dialog box there are several options that affect the search.
408
409You can also activate this command using Ctrl+Q,Ctrl+F key shortcut.
410
411~0000003001
412	Search|Find Next (Ctrl+L)
413
414The Find Next command repeats the last Search| Find  command or searches for the current selection.
415
416You can also activate this command using a Ctrl+L shortcut key.
417
418All settings made in the Find dialog box remain in effect when you choose Find Next.
419
420To 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).
421
422~0000003002
423	Search|Change (Ctrl+Q,Ctrl+A)
424
425The 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.
426
427You can also activate this command using Ctrl+Q,Ctrl+A shortcut key.
428
429~0000003003
430	Search|Go to Line...
431
432The Go to Line number command brings up the  Go to Line  prompt dialog, where you type in the line you want to go to.
433
434ASEDIT displays the current line number and column number in the Status Line located just below the edit window.
435
436~0000003004
437	Search|Bookmark
438
439The 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.
440Use one of two entries in the menu:
441
442
443	 Set 	- to set a bookmark
444
445	 Go to 	- to go to a bookmark
446
447
448Note:  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).
449
450
451~0000003005
452	Search|Match delimiter
453
454The 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.).
455
456The following pairs are supported: {}, (), [], <>, "", ``, //, '', \\ .
457
458
459To search for the matching delimiter:
460
4611. position the cursor just before the delimiter (for example {, ], or "),
4622. use one of the two entries in the menu:
463
464	Forward	- to match forward
465
466	Backward	- to match backward
467
468    - or -
469
470    use Ctrl+Q,Ctrl+[ shortcut key to match forward,
471
472    and Ctrl+Q,Ctrl+] shortcut key to match backward.
473
474
475Note that "backward" and "forward" make sense only for delimiters for which the pair direction is not implied (delimiters like: ", ', ,`, /, \).
476
477For 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: {}, (), [], <>).
478
479Note also that the resource "*selectDelimitedText" controls if the text delimited by the pair of characters is automatically selected.
480
481~0000300400
482	Set Bookmark
483
484To 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:
485 To set Bookmark	Use
486 ____________________________________
487    1		Ctrl+K,Ctrl+1
488    2		Ctrl+K,Ctrl+2
489    3		Ctrl+K,Ctrl+3
490	...
491    9		Ctrl+K,Ctrl+9
492    0		Ctrl+K,Ctrl+0
493
494To 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).
495
496~0000300401
497	Go to Bookmark
498
499To go to a bookmark use the Search|Bookmark|Go to menu. Then select the required bookmark number. Alternatively you can use following shortcut keys:
500 To go to Bookmark	Use
501 ____________________________________
502    1		Ctrl+Q,Ctrl+1
503    2		Ctrl+Q,Ctrl+2
504    3		Ctrl+Q,Ctrl+3
505	...
506    9		Ctrl+Q,Ctrl+9
507    0		Ctrl+Q,Ctrl+0
508
509Note 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).
510
511~0000300000
512	Find dialog box
513
514You use the Find dialog box to find a string in your text file.
515This dialog contains Text to Find: input box, Options check boxes and Direction radio buttons.
516
517The Text to Find: input box is where you enter the string to search for.
518
519Options govern the kind of strings that ASEDIT searches for:
520  Case sensitive   - check this box if you want to differentiate uppercase from lowercase;
521  Whole words only - check this box to search for words only (that is, the string must have punctuation or space characters on both sides).
522
523Direction specifies which way you want to search, starting from the current cursor position:
524  Forward  or
525  Backward.
526
527Once you've entered the search string in the input box, you can choose one of the buttons in the dialog action area:
528 Select		To
529 __________________________________________
530  Find Next	-  search for a next occurrence of the string,
531  Close	-  close the Find dialog (pop it down),
532  Help	-  call the help.
533
534Note: 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.
535
536The 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.
537
538_________
539See Also:
540  Change dialog box
541
542~0000300200
543	Change dialog box
544
545The 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.
546
547The Change dialog box contains Text to Find: input box, Change To: input box, Options check boxes and Direction radio buttons.
548
549The Text to Find: input box is where you enter the string to search for.
550
551The Change To: input box is where you enter the string into which found the found string would be changed to.
552
553Options govern the kind of strings that ASEDIT searches for:
554  Case sensitive   - check this box if you want to differentiate uppercase from lowercase;
555  Whole words only - check this box to search for words only (that is, the string must have punctuation or space characters on both sides).
556
557Direction specifies which way you want to search, starting from the current cursor position:
558  Forward  or
559  Backward.
560
561Once 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:
562 Choose			To
563 ________________________________________________
564  Find & Verify	-  begin a search for a next occurrences of the search string,
565  Change All	-  search for all occurrences of the search string and change them all to the string entered in the Change To: input box,
566  Close	-  close the Change dialog (pop it down),
567  Help	-  call up help.
568
569If 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.
570
571When 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.
572You 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.
573
574The 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.
575
576~0030020001
577	Change Prompt question dialog
578
579You've just found text to change. You have to decide now to change this occurrence, Skip it or Cancel (stop) the whole operation.
580
581~0030020002
582	Search question dialog
583
584You 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).
585
586You have to decide now either to continue the change operation or not.
587
588~0030020003
589	Change All information dialog
590
591The Change All action has just been completed. The dialog shows the number of items changed.
592
593Close the dialog using mouse or just press Enter key or Spacebar.
594~0000300300
595	Go to Line prompt dialog
596
597Go to Line prompt dialog comes up when you choose the Search|Go to Line menu command.
598
599You 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.
600
601If 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.
602
603Note that ASEDIT displays the current line number and column number in the status line located just below the edit window.
604
605~0000000040
606	View menu  (Alt+V)
607
608Sorry, this menu and its' help intormation are not available in the free release!
609
610
611~0000000050
612	Tools menu  (Alt+T)
613
614The Tools menu provides additional tools for text processing. It includes the following:
615
616     Spell 		-  check spelling
617
618     Sort 		-  sorting
619
620     Format >  		-  margins formatting and indentation
621
622     Change Case to >  	-  character case changing
623
624     Filters >  		-  User definable filters
625
626     Commands >  	-  User definable commands
627
628
629Note that the following commands are unavailable if no text is selected in the edit window:
630  Spell,  Sort, Format,  Change Case to and Filters.
631
632Remember that you can always undo the action if it does not produce what you wanted.
633
634_________
635See Also:
636  Text selection
637
638~0000005000
639	Tools|Spell
640
641The 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+/ ).
642
643Any word not found in the spell dictionary is displayed in the "Misspelled words" text dialog.
644
645
646Notes:
647The command is unavailable if no text is selected in the edit area.
648To use a non-standard spell checker redefine the "spellCmd" in the Asedit application defaults file.
649_________
650See Also:
651  Tools menu
652  Filter customization  if you want to understand or change "spellExt"
653
654~0000005001
655	Tools|Sort
656
657The Tools|Sort command is used to sort the selected text alphabetically (unless redefined). The program automatically extends the selected text to include whole lines.
658
659
660Notes:
661The command is unavailable if no text is selected in the edit area.
662To use a non-standard sort (or sort options) redefine the "sortCmd" in the Asedit application defaults file.
663_________
664See Also:
665  Tools menu
666  Filter customization  if you want to understand or change "sortExt"
667
668~0000005002
669	Tools|Format
670
671The Tools|Format command is used to format the selected text in a following way:
672
673     Move Left... 		-  move it left
674
675     Move Right... 	-  move it right
676
677     Indent with... 	-  indent it with a specified text
678
679     Reformat... 		-  fill the text between left and right margins
680
681     Expand tabs 		-  expand the Tab characters
682
683     Unexpand 		-  unexpand spaces to Tab characters
684
685
686~0000500200
687	Tools|Format|Move Left
688
689This command displays   Move Left   dialog box, where you enter the number of characters you want to move the selection by to the left.
690
691~0050020000
692	Move Left dialog box
693
694You 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.
695
696Note that before processing the selection is automatically extended to the whole line(s).
697
698
699~0000500201
700	Tools|Format|Move Right
701
702This command displays   Move Right   dialog box, where you enter the number of characters you want to move the selection by to the right.
703
704
705~0050020100
706	Move Right dialog box
707
708You 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.
709
710Note that before processing the selection is automatically extended to the whole line(s).
711
712
713~0000500202
714	Tools|Format|Indent with
715
716This command displays   Indent with   dialog box, where you enter the string you want to indent the selected text with.
717
718
719~0050020200
720	Indent with dialog box
721
722You 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.
723
724Note that before processing the selection is automatically extended to whole lines.
725
726
727~0000500203
728	Tools|Format|Reformat
729
730This command displays   Reformat   dialog box, where you enter margins you want the text to be reformatted to.
731
732~0050020300
733	Reformat dialog box
734
735You use the Reformat dialog box to reformat the selected text with new margins (fill area between margins).
736
737Specify 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.
738Then press Enter key or OK button.
739
740Note that before processing the selection is automatically extended to the whole line(s).
741
742~0000500204
743	Tools|Format|Expand tabs
744
745This command is used to expand all tab characters in the selected text into spaces. The current tabstops value is used (default 8).
746
747To replace spaces with Tab characters use Tools|Format| Unexpand .
748
749_________
750See Also:
751  Tools menu
752
753~0000500205
754	Tools|Format|Unexpand
755
756This command is used to replace spaces in the selected text with Tab characters (when possible).
757
758Note that tab stops will occur every eight columns (unless pr command is used, see below).
759
760By 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:
761"*unexpandCmd:	unexpand -a "
762(note that on SGI the default is "pr -t" because unexpand command is unavailable).
763
764For systems that have 'pr' command you can use the following definition to allow inserting tabs with the current tab interval and wherever is possible:
765"*unexpandCmd:		pr -t -i%d"
766
767The above customization should be done in your private Asedit application defaults file.
768
769
770To expand tab characters to spaces use Tools|Format| Expand tabs .
771
772_________
773See Also:
774  Tools menu
775
776
777
778~0000005003
779	Tools|Change Case to
780
781The Tools|Change Case to command is used to change the case of characters in the selected text. The following options are available:
782
783
784    Upper	-  Change text to uppercase
785
786    Lower	-  Change text to lowercase
787
788    Title	-  Capitalize the first letter of each word
789
790    Toggle	-  Change all uppercase text to lowercase and all lowercase text to uppercase
791
792
793~0000005004
794	Tools|Filters
795
796The Tools|Filters command is used to process a selected text:
797
798     New Filter... 		-  Use user specified filter
799
800     Word count 		-  Count the lines, words and bytes
801
802     Compress blank lines 	-  Replace multiple blank lines with one
803
804     Delete blank lines   	-  Delete blank lines
805
806     Double Space 		-  Double space the text
807
808     Delete Extra spaces   	-  Delete extra blanks
809
810~0000500400
811	Tools|Filters|New Filter
812
813This command displays   New Filter   dialog box, where you enter your filter command and choose where its output should go.
814
815~0050040000
816	New Filter dialog box
817
818You use the New Filter dialog box to specify your own filter to process the text selected in the edit area.
819Any system command or user program reading from standard input and writing to standard output can be used.
820
821Enter 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.
822
823If 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.
824
825
826Notes:
827Most of the UNIX filters operate on complete lines, so DO include in the selected text the final line feed.
828
829~0000500401
830	Tools|Filters|Word count
831
832This 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.
833
834
835~0000500402
836	Tools|Filters|Compress blank lines
837
838This 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.
839~0000500403
840	Tools|Filters|Delete blank lines
841
842This 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.
843~0000500404
844	Tools|Filters|Double Space
845
846This command is used to double space the current selection (insert extra empty line after each line).
847~0000500405
848	Tools|Filters|Delete Extra spaces
849
850This command is used to delete extra spaces in the current selection (i.e. replace multiple space and tab characters with a single space).
851
852~0000500406
853	Tools|Filters|User defined 5
854
855This is a user defined filter command.
856_________
857See Also:
858  Filter customization
859~0000500407
860	Tools|Filters|User defined 6
861
862This is a user defined filter command.
863_________
864See Also:
865  Filter customization
866~0000500408
867	Tools|Filters|User defined 7
868
869This is a user defined filter command.
870_________
871See Also:
872  Filter customization
873~0000500409
874	Tools|Filters|User defined 8
875
876This is a user defined filter command.
877_________
878See Also:
879  Filter customization
880~0000500410
881	Tools|Filters|User defined 9
882
883This is a user defined filter command.
884
885_________
886See Also:
887  Filter customization
888
889~0050041000
890	Filter customization
891
892
893Note: this is an advanced topic! Read it when you want to extend asedit functionality  by adding user defined filters or commands.
894
895
896In ASEDIT filters are implemented using two generic resources:
897	filter
898	fllterExt
899
900(for example there are: filter0, filterExt0).
901
902To customize a user defined command or filter redefine its' generic resources.
903
904The 'filter' resource specifies the filter to be invoked (for example wc).
905
906The 'filterExt', if specified, gives extra description how asedit is processing filter's output etc.
907It consists of following fields (order is important):
908
909  short name		Description
910
911  outputDepot		where the filter's output is going
912  outDialogTitle	title of the dialog where output will be shown in
913  otherDialogsTitle	title of other dialogs (errors/messages)
914  noOutMsg		message to be shown when no output is received
915  extendTo		flag for automatic selection extension, that takes place before processing
916
917
918All fields with their default values and possible predefined values, where relevant, are listed below:
919
920(N)  short name		Default value	Possible values (if limited)
921
922(1)  outputDepot	TO_CURRENT	TO_NONE, TO_STDOUT, TO_STDERR,
923					TO_CURRENT, TO_NEW, TO_TEXT_DIALOG
924(2)  outDialogTitle
925(3)  otherDialogsTitle
926(4)  noOutDialogType	TO_NONE		TO_NONE, DIALOG_ERROR, DIALOG_INFORMATION,
927					DIALOG_MESSAGE, DIALOG_WARNING
928
929(5)  noOutMsg
930(6)  extendTo		EXTEND_TO_LINES*	NO_EXTEND, EXTEND_TO_LEFT_LF,
931					EXTEND_TO_RIGHT_LF, EXTEND_TO_LINES
932
933Notes:
934Fields (2), (3) and (5) may contain any text and do not have default values.
935* extendTo default value for commands is NO_EXTEND (no need for selection extension).
936
937As a separator in the filterExt specification the following escape sequence is used: "\," (i.e. backspace followed immediately by comma).
938
939Below there are examples how the above specification is used in asedit:
940
941Example 1: Double Space
942*filter3:			sed G
943
944Note that 'filterExt3' is not specified (i.e. all default values are used).
945
946Example 2: Word count
947*filter0:	echo '     lines     words     bytes:' ; wc
948*filterExt0:	TO_TEXT_DIALOG\,Word count\, \, \, \, NO_EXTEND_TO_LF
949
950
951Example 3: Spell
952
953*spellCmd:	(cat; echo) | spell
954*spellExt:	TO_TEXT_DIALOG,\ Misspelled words:\, Spell \, DIALOG_INFORMATION ,\ Spelled correctly!\,NO_EXTEND_TO_LF
955
956
957
958
959~0000005005
960	Tools|Commands
961
962The Tools|Commands is used to start following commands:
963
964     New Command...     	-  User specified command
965
966     Current directory 	-  pwd
967
968     Date 			-  date
969
970     Host name 		-  hostname
971
972~0000500500
973	Tools|Commands|New Command...
974
975This command displays   New Command   dialog box, where you enter your command and choose where its' output should go.
976
977~0050050000
978	New Command dialog box
979
980You 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.
981
982Enter 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.
983
984If 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.
985
986~0000500501
987	Tools|Commands|Current directory
988
989This 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).
990~0000500502
991	Tools|Commands|Date
992
993This 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).
994~0000500503
995	Tools|Commands|Host name
996
997This 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).
998
999~0000500504
1000	Tools|Commands|User defined 3
1001
1002This is a user defined command.
1003_________
1004See Also:
1005  Command customization
1006~0000500505
1007	Tools|Commands|User defined 4
1008
1009_________
1010See Also:
1011  Command customization
1012~0000500506
1013	Tools|Commands|User defined 5
1014
1015This is a user defined command.
1016_________
1017See Also:
1018  Command customization
1019~0000500507
1020	Tools|Commands|User defined 6
1021
1022This is a user defined command.
1023_________
1024See Also:
1025  Command customization
1026~0000500508
1027	Tools|Commands|User defined 7
1028
1029This is a user defined command.
1030_________
1031See Also:
1032  Command customization
1033~0000500509
1034	Tools|Commands|User defined 8
1035
1036This is a user defined command.
1037_________
1038See Also:
1039  Command customization
1040~0000500510
1041	Tools|Commands|User defined 9
1042
1043This is a user defined command.
1044
1045_________
1046See Also:
1047  Command customization
1048~0000500555
1049	Command customization
1050
1051Note: this is an advanced topic! Read it when you want to extend asedit functionality  by adding user defined commands.
1052
1053
1054To customize a user defined command redefine its' two generic resources:
1055	cmd
1056	cmdExt
1057
1058They are practically identical to filter resources with the exceptions related to selections.
1059The 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.
1060
1061To find all the details about how to customize commands or filters see:
1062
1063	 Filter customization
1064
1065
1066~0000000060
1067	Options menu  (Alt+O)
1068
1069Sorry, this menu and its' help information are not available in the free release!
1070
1071
1072~0000000080
1073	Help Menu
1074
1075The Help menu provides access to the ASEDIT on-line help and to the information about the program.
1076
1077The following Help menu commands are available:
1078
1079  On Keys 	-  help about important keys
1080
1081  Index 	-  index of help available
1082
1083  On Help 	-  information on how to use the help
1084
1085  About... 	-  general information about ASEDIT
1086
1087
1088If you want to follow any of the topics above simply select it (either by mouse and double click or by cursor and Enter key).
1089~0000008000
1090	Help|On Keys
1091
1092Choose the Help|On Keys to learn about asedit shortcut keys.
1093
1094For on-line information on how to use Help, press F1, choose Help button  or choose Help|On Help menu command.
1095
1096
1097 Key	Function
1098________________________________________
1099 F1	Calls up context-sensitive Help
1100 F10	Quick method to toggle to the menu bar
1101 F3	Lets you open a file
1102 F2	Saves current file
1103
1104
1105
1106 Key	Function
1107________________________________________
1108 Alt+E	Takes you to the Edit menu
1109 Alt+F	Takes you to the File menu
1110 Alt+H	Takes you to the Help menu
1111 Alt+S	Takes you to the Search menu
1112 Alt+T	Takes you to the Tools menu
1113
1114~0000008001
1115	Help Index
1116
1117     ASEDIT Menus
1118
1119     Customization
1120
1121     Editing
1122
1123     Keyboard
1124
1125     Requirements
1126
1127     Screen Regions
1128
1129     Users' Q & A
1130
1131
1132For on-line information on how to use Help, press F1, choose Help button  or choose Help|On Help menu command.
1133
1134~0000008002
1135	Welcome to On-line Help for ASEDIT ver. 1.3
1136
1137You can learn about ASEDIT editor through the on-line hypertext Help system. What you're reading right now is a 'Help topic'.
1138
1139Most Help topics have link items ('Help keywords') that lead to other Help topics.
1140These links are embraced with vertical thick bars. When you position the cursor inside a link it becomes highlighted.
1141
1142To go to the Help topic:
11431. 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.
11442. To follow the link you can:
1145	double click the left mouse button
1146	or
1147	press Enter key
1148	or
1149	activate the Follow button in the action area (by mouse or keyboard).
1150
1151
1152Try it now; choose one of these Help keywords to get started:
1153
1154	 About On-line Help 	 How to Use Help
1155
1156	 ASEDIT Menus 		 The Editor
1157
1158While in the help pressing F1 (Help key) brings up what you're  reading now.
1159To close the Help window activate the Close button in the action area or press Escape key when the main help window has the focus.
1160
1161If the current help topic is longer than one page, use standard method of scrolling.
1162~0000008003
1163	Help|About
1164
1165When you choose the About command from the Help menu, an information dialog appears, showing ASEDIT copyright and version details.
1166
1167To close the box:
1168	Press Escape key, or
1169	activate Close button by pressing Enter or clicking it with the mouse.
1170
1171~0000800200
1172	About On-line Help
1173
1174With Help, you can:
1175 - Press F1 (Help key) to get information quickly.
1176 - View Help information while working in your application.
1177   For example, you can follow step-by-step instructions in the Help window while you perform a task in the program.
1178
1179On-line Help provides information about:
1180    -	menu commands and dialog box items
1181    -	command-line options
1182    -	the asedit editor functions
1183    -	asedit customization options
1184    -	... and more ...
1185
1186_________
1187See also:
1188  Welcome to On-line Help
1189  How to Use Help
1190
1191
1192Any queries or recommendations related to asedit can be send by E-mail to:
1193
1194	astoch@ic.ac.uk
1195
1196~0000800201
1197	How to Use Help
1198
1199    To read all of this topic, scroll down.
1200
1201You can use the on-line Help system from the Help menu or via the help key.
1202
1203Wherever 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.
1204
1205ASEDIT context-sensitive Help comes up in a dialog-style Help window as shown, schematically, below :
1206
1207 __________________________________
1208 |          ASEDIT - Help
1209 __________________________________
1210 |
1211 |
1212 |  Help  topic
1213 |  ...
1214 |  ...       .   .     .            <-- help
1215 |                                       text
1216 |  ...  |Help keyword| ...
1217 |
1218 |
1219 |
1220 __________________________________
1221 |
1222 | Follow  Back  Index  Close  Help  <-- action
1223 |                                       	area
1224 __________________________________
1225
1226
1227Select Help action buttons as follow:
1228
1229 Action button	Do this
1230 _______________________________
1231 Follow	Follow the hypertext link currently selected.
1232 Back  	Go to the previous Help topic.
1233 Index	Go to the Help index.
1234 Close   	Close the Help window (pop it down).
1235 Help   	Get help about the help system.
1236
1237
1238Navigating through a Help topic:
1239
1240    -  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.
1241
1242    -  if you're using a mouse, double click the Help keyword you're interested in.
1243
1244    -  alternatively you can position the cursor inside the Help keyword and activate the Follow button in the action area.
1245
1246Note for keyboard users:
1247 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.
1248
1249Choose one of these Help keywords to find out how to:
1250
1251	 Go to the Help Index
1252
1253	 Go to a previous Help topic
1254
1255Choose one of these keywords to find out more about the Help menu:
1256
1257	 On Keys
1258
1259	 Index
1260
1261	 On Help
1262
1263	 About...
1264
1265To close the Help window select Close button in the action area.
1266
1267~0000800202
1268	ASEDIT Menus
1269
1270ASEDIT editor is a menu driven program and the menu bar at the top of its window is a gateway to all commands and dialogs.
1271
1272To go to the menu bar:
1273    -	Click anywhere on it, or
1274    -	Press F10, or
1275    -   Press Alt key together with any underlined letter in the menu bar.
1276
1277You can choose any of these pull-down menus on the menu bar:
1278
1279	 File 	 Edit 	 Search 	 View
1280
1281	 Tools 	 Options 	 Help
1282
1283If you need detailed instructions on using the menu bar, go to the Help topic  How to Use Menus .
1284
1285For information about menu shortcut keys, go to the Help topic:  Shortcut keys
1286~0000800203
1287	The Editor
1288
1289ASEDIT is an easy to use text editor for X Window System built around Motif text widget.
1290
1291The main features include:
1292
1293  - (*) international release (versions for 7 languages)
1294  - graphical user interface (GUI)
1295  - multiple editing windows
1296  - easy to use "point and click" interface
1297  - drag and drop support (Motif 1.2 and above only)
1298  - file selection via file selection dialog
1299  - read only mode to view files
1300  - file insert functionality
1301  - print dialog that allows:
1302	(i)  selection of a printer and using extra print options
1303	(ii) selection of a print range (selected text only or
1304	     the complete document)
1305  - (*) comprehensive context sensitive, hypertext on-line help
1306  - multiple undo and redo of edit actions
1307  - Cut/Copy/Paste features
1308  - bookmarks (up to 10)
1309  - (*) parenthesis (pair) matching
1310  - comprehensive search and replace
1311  - line and column numbers
1312  - automatic indentation
1313  - shortcut keys for the most common edit features (based on CUA)
1314  - (*) pop-up menu for mouse oriented editing
1315  - (*) special version with keyboard bindings for EMACS's users
1316  - (*) customization via the standard X11/Motif resources method
1317  - (*) easy localization for left to right languages (8-bit characters)
1318  - (*) spell and sort commands
1319  - (*) commands to change case of letters
1320  - (*) formatting commands (expand/unexpand, move left/right, indent with,
1321	reformat margins)
1322  - (*) user customizable filters (up to 10); following filters are
1323	preconfigured: word count, compress multiple blank lines, delete
1324	blank lines, double space the text, delete extra spaces;
1325	new filter dialog is also available;
1326  - (*) user customizable commands (up to 10); following commands are
1327	preconfigured:	pwd, date, hostname;
1328	new command dialog is also available
1329  - (*) extended syntax (on program startup: show line <N>, open multiple
1330	files, set tabstops interval, set autoindent, etc.)
1331
1332(*) - means a completely new or dramatically improved feature in ver. 1.3
1333
1334
1335International information.
1336This 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.
1337
1338
1339The asedit window consists of a workspace with scrollbars (Edit Area), a Status Line at the bottom and the menu bar at the top.
1340
1341Read-only files:
1342ASEDIT 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).
1343
1344_________
1345See also:
1346  Edit Area
1347  Emacs bindings
1348  About On-line Help
1349~0080020207
1350	How to Use Menus
1351
1352There are three basic ways to select a menu command:
1353
1354Mouse:	Click the name of the menu you want to pull down, then click the menu command you want to choose.
1355F10:	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.
1356Alt:	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.
1357
1358You can also press the underlined letter of a menu name or command instead of using the arrow keys.
1359Additionally you can mix those techniques together.
1360
1361Menu commands may be followed by either an ellipsis mark (...), an arrow, or an acceleration key.
1362Their description is shown in the following table.
1363
1364  Mark	Name		What the Menu Command Does
1365 __________________________________________________
1366  ...	Ellipsis	Brings up a dialog box
1367
1368   ->	Arrow		Displays another menu
1369
1370   F2	Acceleration	Initiates some action when
1371 (etc.)	key		you choose this command or
1372			press the specified key(s)
1373
1374
1375Note: if a menu entry is not available it is greyed out and cannot be selected.
1376
1377~0080020100
1378	Go to the Help Index
1379
1380You can go to the Help Index by selecting Index button in the Help menu.
1381Alternatively, if the help window is already displayed, simply select the Index button in the help window action area.
1382
1383~0080020101
1384	Go to a previous Help topic
1385
1386You 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.
1387In this way you can backtrack through the Help topics you have viewed.
1388
1389~0000800101
1390	Customization
1391
1392You can change many of the visible aspects of ASEDIT, for example colours and fonts being used to suit your personal needs.
1393These changes can be made in files in your home directory called ".Xdefaults" and "Asedit".
1394
1395ASEDIT 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.
1396
1397Listed below is a more detailed description of the origin of resource database used for ASEDIT.
1398
1399Because 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.
1400
1401The four main sources for the resource database are:
1402 - /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).
1403 - $HOME/Asedit     -  user-specific resource file, that contains customizations a user has made himself or herself.
1404 - $HOME/.Xdefaults -  display specific (every X program can access them on its display connection).
1405 - $HOME/.Xdefaults-<hostname>  -  host specific resource file.
1406
1407Note: 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).
1408
1409If 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.
1410
1411_________
1412See also:
1413  Widget tree
1414  Command-line options
1415  Filter customization
1416  Localization
1417
1418~0080010101
1419	Command-line options
1420
1421You 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.
1422
1423The English syntax message is shown below.
1424
1425Usage:  asedit [options] [filename(s)]
1426where available options include:
1427
1428  -bg  <COLOR>		sets background (page) color for all elements
1429  -fg  <COLOR>		sets foreground (text) color
1430  -fn  <FONT>		sets one font list for the whole program
1431  -fnm <FONT>		sets font list for menu items and dialogs
1432  -fnt <FONT>		sets font list for the edit text area
1433  -helpdir  <DIR>      	sets directory for the asedit help file (asedit.hlp)
1434  -tab <N>    		sets the tabstops to interval of N characters
1435  +<N>         		after opening the file go to line <N>
1436  -emacs       		turns on Emacs mode (alternate shortcuts set is used)
1437  -/+ai        		turns on/off autoindent
1438  -/+status		turns on/off status line
1439  -/+wrap      		turns on/off auto wraparound (*slow* before Motif 1.2)
1440  -/+v         		turns on/off view only mode
1441  ..... 	and all standard X-Window options including:
1442  -display  <HOST:SCREEN>    	sets the display where the window will appear
1443  -geometry <WIDTHxHEIGHT+X+Y>	sets window size and position (in pixels)
1444  -iconic      		starts the program up iconified
1445  -xrm  <RESOURCE>	sets additional X resource specification
1446
1447
1448~0080010102 Customization/Filter customization -> Filter customization
1449~0080010103 Customization/Localization --> Localization
1450
1451~0000008050
1452	Localization
1453
1454Many 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:
1455  - the operating systems' locale mechanism, if any
1456  - the Motif implementation
1457  - the application itself
1458  - the user's system administrator
1459  - the user's language environment.
1460
1461If 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).
1462
1463_________
1464See also:
1465  Establishing the language environment
1466  Character composition
1467  Finding X Resource files
1468
1469~0000805000
1470	Establishing the language environment
1471
1472The 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.
1473
1474Choosing a locale (POSIX)
1475From the command line set the environment variable LANG. For example, when you type
1476in the Korn and Bourne shells:
1477	LANG=fr; export LANG
1478
1479or in the C shell:
1480	setenv LANG fr
1481
1482you 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).
1483
1484Note that on SunOS 4.x to set support for French (German and so on) you have to:
1485	set LANG to C, and
1486	LC_CTYPE to iso_8859_1.
1487
1488
1489~0000805001
1490	Character composition
1491
1492There 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.
1493To 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:
1494	xmodmap -e "keysym F12 = Multi_key"
1495
1496You can, of course, replace the "F12" with the name of any other key. For more detailed information, see the xmodmap(1) man page.
1497
1498~0000805002
1499	Finding X Resource files
1500
1501Note that users should rarely if ever need to modify the system wide application defaults files (appdefs).
1502
1503The default French and German appdefs for X-based applications are located in the
1504	/usr/lib/X11/fr/app-defaults  and
1505	/usr/lib/X11/de/app-defaults  directories, respectively.
1506
1507If 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.
1508
1509
1510
1511~0080010100
1512	asedit widget tree
1513
1514ASEDIT 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.
1515
1516Note that a special class name is used for the Emacs version of asedit.
1517
1518Asedit_em asedit
1519    TopLevelShell  asedit
1520        XmMainWindow  main
1521
1522            XmSeparatorGadget  Separator1
1523            XmSeparatorGadget  Separator2
1524            XmSeparatorGadget  Separator3
1525
1526            XmRowColumn  menuBar
1527                XmCascadeButton  File
1528                XmCascadeButton  Edit
1529                XmCascadeButton  Search
1530                XmCascadeButton  Tools
1531                XmCascadeButton  Help
1532
1533                XmMenuShell  popup_File_PD
1534
1535                    XmRowColumn  File_PD
1536                        XmPushButton  New
1537                        XmPushButton  Open
1538                        XmPushButton  Close
1539                        XmSeparator  separator
1540                        XmPushButton  Save
1541                        XmPushButton  Save_As
1542                        XmSeparator  separator
1543                        XmPushButton  Insert
1544                        XmPushButton  Print
1545                        XmSeparator  separator
1546                        XmPushButton  Exit
1547
1548                    XmRowColumn  Edit_PD
1549                        XmPushButton  Undo
1550                        XmPushButton  Redo
1551                        XmSeparator  separator
1552                        XmPushButton  Cut
1553                        XmPushButton  Copy
1554                        XmPushButton  Paste
1555                        XmSeparator  separator
1556                        XmPushButton  Clear
1557
1558                    XmRowColumn  Search_PD
1559                        XmPushButton  Find
1560                        XmPushButton  Repeat
1561                        XmPushButton  Change
1562                        XmPushButton  Go_to
1563                        XmSeparator  separator
1564                        XmCascadeButton  Mark
1565                        XmCascadeButton  Match
1566
1567                    XmRowColumn  Tools_PD
1568                        XmPushButton  Spell
1569                        XmPushButton  Sort
1570                        XmSeparator  separator
1571                        XmCascadeButton  Format
1572                        XmCascadeButton  Case
1573                        XmSeparator  separator
1574                        XmCascadeButton  Filters
1575                        XmCascadeButton  Commands
1576
1577                    XmRowColumn  Help_PD
1578                        XmPushButton  On_Keys
1579                        XmPushButton  Index
1580                        XmPushButton  On_Help
1581                        XmSeparator  separator
1582                        XmPushButton  About
1583
1584                    XmMenuShell  popup_Mark_PD
1585
1586                        XmRowColumn  Match_PD
1587                            XmPushButton  Forward
1588                            XmPushButton  Backward
1589
1590                        XmRowColumn  Filters_PD
1591                            XmPushButton  Extra
1592                            XmPushButton  0
1593                            XmPushButton  1
1594                            XmPushButton  2
1595                            XmPushButton  3
1596                            XmPushButton  4
1597
1598                        XmRowColumn  Mark_PD
1599                            XmCascadeButton  Set
1600                            XmCascadeButton  Go_to
1601
1602                        XmRowColumn  Format_PD
1603                            XmPushButton  MoveLeft
1604                            XmPushButton  MoveRight
1605                            XmPushButton  IndentWith
1606                            XmPushButton  Reformat
1607                            XmSeparator  separator
1608                            XmPushButton  Expand
1609                            XmPushButton  Unexpand
1610
1611                        XmRowColumn  Case_PD
1612                            XmPushButton  Upper
1613                            XmPushButton  Lower
1614                            XmPushButton  Title
1615                            XmPushButton  Toggle
1616
1617                        XmRowColumn  Commands_PD
1618                            XmPushButton  Extra
1619                            XmPushButton  0
1620                            XmPushButton  1
1621                            XmPushButton  2
1622
1623                        XmMenuShell  popup_Set_PD
1624
1625                            XmRowColumn  Set_PD
1626                                XmPushButton  0
1627                                XmPushButton  1
1628                                XmPushButton  2
1629                                XmPushButton  3
1630                                XmPushButton  4
1631                                XmPushButton  5
1632                                XmPushButton  6
1633                                XmPushButton  7
1634                                XmPushButton  8
1635                                XmPushButton  9
1636
1637                            XmRowColumn  Go_to_PD
1638                                XmPushButton  0
1639                                XmPushButton  1
1640                                XmPushButton  2
1641                                XmPushButton  3
1642                                XmPushButton  4
1643                                XmPushButton  5
1644                                XmPushButton  6
1645                                XmPushButton  7
1646                                XmPushButton  8
1647                                XmPushButton  9
1648
1649                XmDialogShell  open_dialog_popup
1650                    XmFileSelectionBox  open_dialog
1651                         XmLabelGadget  Items
1652                        XmScrolledWindow  ItemsListSW
1653                            XmScrollBar  VertScrollBar
1654                            XmScrollBar  HorScrollBar
1655                            XmList  ItemsList
1656                        XmLabelGadget  Selection
1657                        XmTextField  Text
1658                        XmSeparatorGadget  Separator
1659                        XmPushButtonGadget  OK
1660                        XmPushButtonGadget  Apply
1661                        XmPushButtonGadget  Cancel
1662                        XmPushButtonGadget  Help
1663                        XmLabelGadget  FilterLabel
1664                        XmLabelGadget  Dir
1665                        XmTextField  FilterText
1666                        XmScrolledWindow  DirListSW
1667                            XmScrollBar  VertScrollBar
1668                            XmScrollBar  HorScrollBar
1669                            XmList  DirList
1670                        XmFrame  frame
1671                            XmToggleButton  open_view_only
1672
1673                XmDialogShell  save_dialog_popup
1674                    XmFileSelectionBox  save_dialog
1675                        XmLabelGadget  Items
1676                        XmScrolledWindow  ItemsListSW
1677                            XmScrollBar  VertScrollBar
1678                            XmScrollBar  HorScrollBar
1679                            XmList  ItemsList
1680                        XmLabelGadget  Selection
1681                        XmTextField  Text
1682                        XmSeparatorGadget  Separator
1683                        XmPushButtonGadget  OK
1684                        XmPushButtonGadget  Apply
1685                        XmPushButtonGadget  Cancel
1686                        XmPushButtonGadget  Help
1687                        XmLabelGadget  FilterLabel
1688                        XmLabelGadget  Dir
1689                        XmTextField  FilterText
1690                        XmScrolledWindow  DirListSW
1691                            XmScrollBar  VertScrollBar
1692                            XmScrollBar  HorScrollBar
1693                            XmList  DirList
1694
1695                XmDialogShell  insert_dialog_popup
1696                    XmFileSelectionBox  insert_dialog
1697                        XmLabelGadget  Items
1698                        XmScrolledWindow  ItemsListSW
1699                            XmScrollBar  VertScrollBar
1700                            XmScrollBar  HorScrollBar
1701                            XmList  ItemsList
1702                        XmLabelGadget  Selection
1703                        XmTextField  Text
1704                        XmSeparatorGadget  Separator
1705                        XmPushButtonGadget  OK
1706                        XmPushButtonGadget  Apply
1707                        XmPushButtonGadget  Cancel
1708                        XmPushButtonGadget  Help
1709                        XmLabelGadget  FilterLabel
1710                        XmLabelGadget  Dir
1711                        XmTextField  FilterText
1712                        XmScrolledWindow  DirListSW
1713                            XmScrollBar  VertScrollBar
1714                            XmScrollBar  HorScrollBar
1715                            XmList  DirList
1716
1717                XmDialogShell  print_dialog_popup
1718                    XmSelectionBox  print_dialog
1719                        XmLabelGadget  Items
1720                         XmScrolledWindow  ItemsListSW
1721                            XmScrollBar  VertScrollBar
1722                            XmScrollBar  HorScrollBar
1723                            XmList  ItemsList
1724                        XmLabelGadget  Selection
1725                        XmTextField  Text
1726                        XmSeparatorGadget  Separator
1727                        XmPushButtonGadget  OK
1728                        XmPushButtonGadget  Apply
1729                        XmPushButtonGadget  Cancel
1730                        XmPushButtonGadget  Help
1731                        XmForm  form
1732                            XmLabel  range_title
1733                            XmForm  form1
1734                                XmFrame  frame
1735                                    XmRowColumn  range_radio_box
1736                                        XmToggleButton  selection
1737                                        XmToggleButton  complete
1738
1739                XmDialogShell  replace_dialog_popup
1740                    XmSelectionBox  replace_dialog
1741                        XmLabelGadget  Selection
1742                        XmTextField  Text
1743                        XmSeparatorGadget  Separator
1744                        XmPushButtonGadget  OK
1745                        XmPushButtonGadget  Apply
1746                        XmPushButtonGadget  Cancel
1747                        XmPushButtonGadget  Help
1748                        XmForm  form
1749                            XmForm  form_text
1750                                XmLabel  text_to_find_title
1751                                XmText  text_to_find
1752                                XmLabel  new_text_title
1753                                XmText  new_text
1754                            XmLabel  options_title
1755                            XmFrame  frame1
1756                                XmRowColumn  options_row_column
1757                                    XmToggleButton  case_sensitive
1758                                    XmToggleButton  whole_words
1759                            XmLabel  direction_title
1760                            XmFrame  frame2
1761                                XmRowColumn  direction_radio_box
1762                                    XmToggleButtonGadget  Forward
1763                                    XmToggleButtonGadget  Backward
1764
1765                XmDialogShell  go_to_line_popup
1766                    XmSelectionBox  go_to_line
1767                        XmLabelGadget  Selection
1768                        XmTextField  Text
1769                        XmSeparatorGadget  Separator
1770                        XmPushButtonGadget  OK
1771                        XmPushButtonGadget  Apply
1772                        XmPushButtonGadget  Cancel
1773                        XmPushButtonGadget  Help
1774
1775                XmDialogShell  moveLeft_dialog_popup
1776                    XmSelectionBox  moveLeft_dialog
1777                        XmLabelGadget  Selection
1778                        XmTextField  Text
1779                        XmSeparatorGadget  Separator
1780                        XmPushButtonGadget  OK
1781                        XmPushButtonGadget  Apply
1782                        XmPushButtonGadget  Cancel
1783                        XmPushButtonGadget  Help
1784
1785                XmDialogShell  moveRight_dialog_popup
1786                    XmSelectionBox  moveRight_dialog
1787                        XmLabelGadget  Selection
1788                        XmTextField  Text
1789                        XmSeparatorGadget  Separator
1790                         XmPushButtonGadget  OK
1791                        XmPushButtonGadget  Apply
1792                        XmPushButtonGadget  Cancel
1793                        XmPushButtonGadget  Help
1794
1795                XmDialogShell  indentWith_dialog_popup
1796                    XmSelectionBox  indentWith_dialog
1797                        XmLabelGadget  Selection
1798                        XmTextField  Text
1799                        XmSeparatorGadget  Separator
1800                        XmPushButtonGadget  OK
1801                        XmPushButtonGadget  Apply
1802                        XmPushButtonGadget  Cancel
1803                        XmPushButtonGadget  Help
1804
1805                XmDialogShell  reformat_dialog_popup
1806                    XmMessageBox  reformat_dialog
1807                        XmLabelGadget  Symbol
1808                        XmLabelGadget  Message
1809                        XmSeparatorGadget  Separator
1810                        XmPushButtonGadget  OK
1811                        XmPushButtonGadget  Cancel
1812                        XmPushButtonGadget  Help
1813                        XmForm  form
1814                            XmLabel  left_margin_title
1815                            XmText  left_margin
1816                            XmLabel  right_margin_title
1817                            XmText  right_margin
1818
1819                XmDialogShell  error_message_popup
1820                    XmMessageBox  error_message
1821                        XmLabelGadget  Symbol
1822                        XmLabelGadget  Message
1823                        XmSeparatorGadget  Separator
1824                        XmPushButtonGadget  OK
1825                        XmPushButtonGadget  Cancel
1826                        XmPushButtonGadget  Help
1827
1828                XmDialogShell  filter_dialog_popup
1829                    XmSelectionBox  filter_dialog
1830                        XmLabelGadget  Selection
1831                        XmTextField  Text
1832                        XmSeparatorGadget  Separator
1833                        XmPushButtonGadget  OK
1834                        XmPushButtonGadget  Apply
1835                        XmPushButtonGadget  Cancel
1836                        XmPushButtonGadget  Help
1837                        XmForm  form
1838                            XmLabel  depot_title
1839                            XmFrame  frame
1840                                XmRowColumn  depot_radio_box
1841                                    XmToggleButton  to_current
1842                                    XmToggleButton  to_new
1843                                    XmToggleButton  to_dialog
1844
1845                XmDialogShell  command_dialog_popup
1846                    XmSelectionBox  command_dialog
1847                        XmLabelGadget  Selection
1848                        XmTextField  Text
1849                        XmSeparatorGadget  Separator
1850                        XmPushButtonGadget  OK
1851                        XmPushButtonGadget  Apply
1852                        XmPushButtonGadget  Cancel
1853                        XmPushButtonGadget  Help
1854                        XmForm  form
1855                            XmLabel  depot_title
1856                            XmFrame  frame
1857                                XmRowColumn  depot_radio_box
1858                                    XmToggleButton  to_current
1859                                    XmToggleButton  to_new
1860                                    XmToggleButton  to_dialog
1861
1862                XmDialogShell  change_prompt_popup
1863                    XmSelectionBox  change_prompt
1864                        XmLabelGadget  Selection
1865                        XmTextField  Text
1866                        XmSeparatorGadget  Separator
1867                        XmPushButtonGadget  OK
1868                        XmPushButtonGadget  Apply
1869                        XmPushButtonGadget  Cancel
1870                        XmPushButtonGadget  Help
1871                        XmRowColumn  workarea
1872                            XmLabel  pixmap_label
1873                            XmLabel  text_label
1874
1875                XmDialogShell  continue_search_question_popup
1876                    XmMessageBox  continue_search_question
1877                        XmLabelGadget  Symbol
1878                        XmLabelGadget  Message
1879                        XmSeparatorGadget  Separator
1880                        XmPushButtonGadget  OK
1881                        XmPushButtonGadget  Cancel
1882                        XmPushButtonGadget  Help
1883
1884                XmDialogShell  about_popup
1885                    XmMessageBox  about
1886                        XmLabelGadget  Symbol
1887                        XmLabelGadget  Message
1888                        XmSeparatorGadget  Separator
1889                        XmPushButtonGadget  OK
1890                        XmPushButtonGadget  Cancel
1891                        XmPushButtonGadget  Help
1892
1893            XmForm  form_work
1894                XmPanedWindow  pane
1895                    XmScrolledWindow  edit_textSW
1896                        XmScrollBar  HorScrollBar
1897                        XmScrollBar  VertScrollBar
1898                        XmText  edit_text
1899                    XmScrolledWindow  edit_textSW
1900                        XmScrollBar  HorScrollBar
1901                        XmScrollBar  VertScrollBar
1902                        XmText  edit_text
1903                    XmSash  sash
1904                    XmSeparatorGadget  separator
1905                    XmSash  sash
1906                    XmSeparatorGadget  separator
1907
1908                XmForm  form_frame_bottom
1909                    XmFrame  frame_bottom_row
1910                        XmRowColumn  bottom_row
1911                            XmLabel
1912                            XmLabel  line
1913                            XmLabel  1
1914                            XmLabel  column
1915                            XmLabel  1
1916
1917            XmMenuShell  popup_QAccess_Popup
1918                XmRowColumn  QAccess_Popup
1919                    XmPushButton  Undo
1920                    XmSeparator  separator
1921                    XmPushButton  Cut
1922                    XmPushButton  Copy
1923                    XmPushButton  Paste
1924                    XmSeparator  separator
1925                    XmPushButton  Open
1926                    XmPushButton  Save
1927                    XmSeparator  separator
1928                    XmPushButton  Exit
1929
1930    XmDialogShell  save_warning_popup
1931        XmMessageBox  save_warning
1932            XmLabelGadget  Symbol
1933            XmLabelGadget  Message
1934            XmSeparatorGadget  Separator
1935            XmPushButtonGadget  OK
1936            XmPushButtonGadget  Cancel
1937            XmPushButtonGadget  Help
1938
1939    XmDialogShell  help_dialog
1940        XmPanedWindow  pane
1941            XmScrolledWindow  hypertext_textSW
1942                XmScrollBar  VertScrollBar
1943                XmText  hypertext_text
1944            XmForm  action_area
1945                XmPushButton  Follow
1946                XmPushButton  Back
1947                XmPushButton  Index
1948                XmPushButton  Close
1949                XmPushButton  Help
1950            XmSash  sash
1951            XmSeparatorGadget  separator
1952            XmSash  sash
1953            XmSeparatorGadget  separator
1954
1955
1956
1957
1958Note:	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).
1959
1960~0000000027
1961	Editing Index
1962
1963Back up
1964	 backing up a document
1965Cancelling
1966	 Cancelling before, during, or after an action
1967 Clipboard
1968	 copying text to
1969	 cutting text to
1970	 pasting text from
1971Command
1972	 choosing and carrying out
1973Compose key
1974	 Character composition
1975Copying
1976	 Copying a document
1977	 Copying text
1978		 using Clipboard
1979		 using Primary selection
1980		 using Secondary selection
1981Creating a document (see New document creating)
1982Cutting
1983	 text to Clipboard
1984Cursor (see Insertion point)
1985Deleting text
1986	 deletion keys
1987	 replacing text when you type
1988Dialog_box
1989	 choosing a button or selecting an option
1990	 inserting response in text box
1991	 moving
1992	 moving around in
1993 Exiting ASEDIT
1994Go to
1995	 Go to Line number
1996Help
1997	 How to Use Help
1998Highlighting (see Selecting)
1999Insertion point
2000	 Moving in dialog boxes
2001	 moving within text
2002Language environment
2003	 establishing
2004Load file box
2005	 Selecting a file
2006 Localization
2007Match delimiter (see Searching for the matching delimiter)
2008Moving through a document (see Scrolling)
2009Moving text
2010	 between X-Windows applications
2011	 within a file or between files
2012New document
2013	 creating
2014Opening
2015	 document
2016Option (see Dialog_box)
2017Pasting
2018	 text from Clipboard
2019	text from another X application (see Copying text)
2020
2021Parenthesis matching (see Searching for the matching delimiter)
2022Printing
2023	 document
2024Renaming
2025	 document
2026Redoing
2027	 undo action
2028Repeating
2029	 previous search
2030Replacing
2031	 text: searching and replacing
2032	 text: when you type
2033Saving
2034	 backup copy
2035	 document
2036Scrolling
2037	 with keys
2038	 with mouse
2039Searching
2040	 for the matching delimiter
2041	 for selection
2042	 for text
2043Selecting
2044	in dialog box (see Dialog Box)
2045	 text with keys
2046	 text with mouse
2047Travel keys (see Insertion point)
2048Undoing
2049	 Cancelling before, during, or after an action
2050
2051
2052~0000000077
2053	Keyboard
2054
2055 Deletion Keys
2056
2057 File Handling Keys
2058
2059 Function Keys
2060
2061 Insertion Keys
2062
2063Movement Keys
2064	 Moving and sizing windows
2065
2066	 Moving in dialog boxes
2067
2068	 Moving the insertion point within text
2069
2070Selection Keys
2071	 Selecting Text
2072
2073~0000007700
2074Deletion Keys
2075
2076Press Ctrl+Z to undo your last deletion.
2077
2078  Press	To delete
2079 ___________________________
2080
2081 BackSpace	Character to the left of insertion point
2082
2083 Del	Character to the right of insertion point or selected text
2084
2085 Ctrl+Del	Text to the right of insertion point up to end of a line
2086
2087 Ctrl+X	Selected text and send it to the Clipboard
2088
2089~0000007701
2090File Handling Keys
2091
2092  Press	To
2093 ____________________________
2094
2095 F3	Choose  File|Open
2096
2097 F2	Choose  File|Save
2098
2099~0000007702
2100Function Keys
2101
2102 Press	To
2103 ___________________________
2104
2105 F1	Get help on the currently selected command, open dialog box, or message
2106
2107 F3	Choose  File|Open
2108
2109 F2	Choose  File|Save
2110
2111 F7	Run the spell checking program for the selected text
2112
2113 F10	Toggle to the menu bar
2114
2115 Alt+F4	Close application or dialog window
2116
2117~0000007703
2118Insertion Keys
2119
2120 Press		To insert
2121 _________________________________
2122
2123 Ctrl+V	Clipboard contents
2124
2125When autoindent is turned on:
2126 Enter		New line and indent
2127
2128 Ctrl+Enter		New line
2129
2130When autoindent is turned off:
2131 Enter		New line
2132
2133 Ctrl+Enter  	New line and indent
2134
2135
2136Note:
2137Overtype mode in not supported before Motif 1.2.
2138~0000007704
2139   Movement Keys: Moving and sizing windows
2140
2141 Press	To
2142 _________________________________
2143
2144 Alt+F5   Restore application window to previous size.
2145
2146 Alt+F7   Move application window or dialog box; use the direction keys to move the window, then press Enter to set the position.
2147
2148 Alt+F8   Size application window; use the direction keys to size the window, then press Enter to set the size.
2149
2150 Alt+F9   Shrink application window to an icon.
2151
2152 Alt+F10  Enlarge application window to maximum size.
2153
2154Note:
2155You can also pull down the window menu using Alt+Spacebar or Shift+Escape and select the appropriate menu option.
2156In dialog windows the entries Alt+F5, Alt+F10 do not exist.
2157
2158~0000007705
2159   Movement Keys: Moving in dialog boxes
2160
2161 Press		To
2162 _________________________________
2163
2164 Tab		Move to next option
2165
2166 Shift+Tab	Move to previous option
2167
2168 Esc		Close dialog box without carrying out a command
2169
2170 Enter		Execute highlighted option
2171
2172 Alt+F7		Move dialog box; use the direction keys to move the dialog box, then press Enter to set the position
2173
2174~0000007706
2175   Movement Keys: Moving the insertion point within text
2176
2177 Press		 To move
2178 __________________________________
2179
2180 Direction keys	 One character or one line
2181
2182 Ctrl+'<-'  	 One word left
2183 Ctrl+'->'  	 One word right
2184 Ctrl+'up key' 	 One paragraph up
2185 Ctrl+'down key' One paragraph down
2186
2187 Home		 To beginning of line
2188 End		 To end of line
2189 Ctrl+Home	 To document beginning
2190 Ctrl+End	 To end of document
2191 PgUp		 Up one window
2192 PgDn		 Down one window
2193 Ctrl+PgUp	 To document beginning
2194 Ctrl+PgDn	 To end of document
2195
2196
2197_________
2198See also:
2199  Emacs bindings
2200
2201~0000770600
2202	Emacs bindings
2203
2204The default key bindings in "emacs" mode are patterned, where possible, after those in the Emacs text editor.
2205Following Emacs keyboard commands are available:
2206
2207 Ctrl+a   Beginning Of Line
2208 Ctrl+b   Backward Character
2209 Ctrl+d   Delete Next Character
2210 Ctrl+e   End Of Line
2211 Ctrl+f   Forward Character
2212 Ctrl+h   Delete Previous Character
2213 Ctrl+j   New Line And Indent
2214 Ctrl+k,Ctrl+k   Kill To End Of Line
2215	  (Note for the above: we cannot use the standard
2216	  Ctrl+k because it clashes with bookmarks setting)
2217 Ctrl+n   Next Line
2218 Ctrl+o   New Line And Backup
2219 Ctrl+p   Previous Line
2220 Ctrl+w   Kill Selection
2221 Ctrl+y   Unkill
2222
2223 Meta+b   Backward Word
2224 Meta+d   Delete Next Word
2225 Meta+y   Insert Current Selection
2226 Meta+<   Beginning Of File
2227 Meta+>   End Of File
2228 Meta+]   Forward Paragraph
2229 Meta+[   Backward Paragraph
2230 Meta+Delete   Delete To Start of Line
2231 Ctrl+Meta+f   Forward Word (we cannot use Meta+f because it clashes with the file menu accelerator)
2232
2233(Note: a small number of Emacs bindings are not implemented because they clash with menu accelerators)
2234
2235The 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:
2236
2237 Shift+Ctrl+a   Beginning of Line (extend of the selection)
2238 Shift+Meta+b   Backward word (extend of the selection)
2239 Shift+Ctrl+e   End of Line (extend of the selection)
2240 Shift+Meta+[   Backward Paragraph (extend of the selection)
2241 Shift+Meta+]   Forward Paragraph (extend of the selection)
2242 Shift+Meta+<   Beginning of File (extend of the selection)
2243 Shift+Meta+>   End of File (extend of the selection)
2244
2245
2246Since 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.
2247
2248
2249Note that the class name for asedit in Emacs mode is: Asedit_em.
2250
2251_________
2252See also:
2253  Moving the insertion point within text
2254  Selecting text with Keys
2255
2256~0000007707
2257   Selection Keys: Selecting Text
2258
2259 Press			To select
2260 __________________________________
2261
2262 Shift+direction keys	Characters or lines
2263
2264 Shift+Home		To beginning of line
2265
2266 Shift+End		To end of line
2267
2268 Ctrl+Shift+Home	To beginning of document
2269
2270 Ctrl+Shift+End		To end of document
2271
2272
2273Note: engaging the Caps Lock does not substitute for holding down the Shift key.
2274_________
2275See also:
2276  Emacs bindings
2277
2278~0000800104
2279	Requirements
2280
2281ASEDIT 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.
2282
2283The main platforms ASEDIT works on include:
2284	IBM RS/6000 running AIX 3.2.x
2285	SGI running IRIX 4.x or IRIX 5.x
2286	Sun Sparc running SunOS 4.x or SunOS 5.x
2287	Hewlett-Packard HP9000 series 700/800 running HP-UX 8.x or HP-UX 9.x
2288	Data General AViiON running DG/UX
2289	DEC Alpha running OSF/1
2290
2291~0000800105
2292	Screen Regions
2293
2294Specific for mwm (Motif Window Manager):
2295
2296   Icon
2297
2298   Maximize Button
2299
2300   Minimize Button
2301
2302   Resize Border Handles
2303
2304   Title Area
2305
2306   Title Bar
2307
2308   Window Menu Button
2309
2310
2311ASEDIT specific:
2312
2313   Edit Area
2314
2315   Menu bar
2316
2317   Scroll bars
2318
2319   Status Line
2320
2321~0080010500
2322	Icon
2323
2324Icons 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.
2325
2326Pressing 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:
2327
2328	Icon Window Menu
2329
2330Selection Accelerator	Description
2331______________________________________________________
2332
2333Restore	   Alt+F5	Opens the associated window
2334
2335Move	   Alt+F7	Allows the icon to be moved with keys
2336
2337Size	   Alt+F8	Inactive (not an option for icons)
2338
2339Minimize   Alt+F9	Inactive (not an option for icons)
2340
2341Maximize   Alt+F10	Opens the associated window to full screen size
2342
2343Lower	   Alt+F3	Moves icon to bottom of icon stack
2344
2345Close 	   Alt+F4	Causes client to terminate
2346
2347
2348Note 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.
2349
2350Double-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).
2351
2352~0080010501
2353	Maximize Button
2354
2355To 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).
2356
2357~0080010502
2358	Minimize Button
2359
2360To turn the window into an icon, click left button on the minimize button (the frame box with a small square in it).
2361
2362~0080010503
2363	Resize Border Handles
2364
2365To 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.
2366
2367~0080010504
2368	Title Area
2369
2370In addition to displaying the "asedit" name with a name of currently opened file, the title area is used to move the window.
2371To 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.
2372
2373~0080010505
2374	Title Bar
2375
2376Located along the top of a window.
2377Drag the title bar to move the window. Dialog boxes with title bars can also be moved in this way.
2378The title bar includes the title area, the minimize button, the maximize button, and the window menu button.
2379
2380~0080010506
2381	Window Menu Button
2382
2383The 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.
2384
2385	Default Window Menu
2386
2387Selection Accelerator	Description
2388______________________________________________________
2389
2390Restore	   Alt+F5	Restores the window to its' size
2391			before minimizing or maximizing
2392
2393Move	   Alt+F7	Allows the window to be moved
2394			with keys or mouse
2395
2396Size	   Alt+F8	Allows the window to be resized
2397
2398Minimize   Alt+F9	Turns the window into an icon
2399
2400Maximize   Alt+F10	Makes the window fill the screen
2401
2402Lower	   Alt+F3	Moves window to bottom of window stack
2403
2404Close 	   Alt+F4	Causes program to quit (or close the top window)
2405
2406~0080010507
2407Edit Area
2408
2409The main part of the ASEDIT window is taken by an editable workspace. Motif Text widget is used as a base for the workspace.
2410It allows text to be edited, inserted, and selected. The user can cut, copy and paste text using Clipboard, primary transfer, or secondary transfer.
2411Since Motif 1.2 text can also be dragged and dropped.
2412
2413The user interface implemented is based on the "point and click" model.
2414
2415The 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.
2416The editor is in text-insertion mode, as default.  Overwrite mode is supported only with Motif 1.2 or higher.
2417
2418~0080010508 0000800202 Screen Regions/Menu Bar -->	ASEDIT Menus
2419
2420~0080010509
2421Scroll bars
2422
2423To scroll text with the mouse use scroll bars. They are located at the right and bottom edges of the Edit Area.
2424The 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.
2425
2426Using vertical scroll bar
2427Part		Mouse action
2428__________________________________
2429
2430Top Arrow	Click to scroll up one line
2431Above Slider	Click to scroll up one full window
2432Slider		Drag to move to an appropriate location in the document
2433Below Slider	Click to scroll down one full window
2434Bottom Arrow	Click to scroll down one line
2435
2436Using horizontal scroll bar
2437Use the horizontal scroll bar to move left and right as you use the vertical scroll bar to move up and down.
2438Note:
2439The horizontal scrollbar does not exist when you use asedit in the "wrap word" mode.
2440
2441Scrolling with keys
2442When you use keys to move the insertion point to text outside the window, the document scrolls automatically, both vertically and horizontally.
2443Note 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.
2444
2445~0080010510
2446Status Line
2447
2448The 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.
2449
2450The edit status field shows either:
2451    -  nothing (space) when you start editing or no changes were made
2452    -  * (star) when changes were made to the edited text and they are not saved yet
2453    -  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.
2454
2455The line and column display area shows information about the insertion point position.
2456
2457Status information example:
2458Example		Meaning
2459*		Changes have been made and not saved yet
2460Line:: 12	Line number of the insertion point
2461Col::  33	Column number of the insertion point, spaces and tabs included
2462
2463
2464~0000800106
2465	Users' Q & A
2466
2467Listed below are some frequent users' questions and answers about ASEDIT.
2468
2469**Please**  read them and associated information before contacting the supporting person or the author of the program.
2470
2471
2472Program startup
2473_______________
2474
2475[Q] On a program startup I get a lot of warnings like this:
2476	Warning: translation table syntax error: Unknown keysym name: osfActivate
2477	...
2478What is wrong??
2479
2480[A] Probably, the key symbols database can't be accessed.
2481Check the environmental variable XKEYSYMDB by typing:
2482	echo $XKEYSYMDB
2483
2484If 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:
2485
2486For Bourne/Korn shell:
2487	XKEYSYMDB=/usr/openwin/lib/XKeysymDB; export XKEYSYMDB
2488
2489For C shell:
2490	setenv XKEYSYMDB /usr/openwin/lib/XKeysymDB
2491
2492... and start asedit again.
2493
2494Note 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.
2495
2496
2497[Q] I got used to Emacs bindings in asedit 1.2. What happened to them in ver. 1.3 ?
2498[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.
2499    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.
2500
2501
2502[Q] During a startup program I get a warning about incompatible application defaults file. Why ?
2503[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.
2504
2505
2506[Q] My localized version in XYZ language doesn't start up. Why ?
2507[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:
2508	appres Asedit asedit
2509If 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.
2510
2511
2512Files
2513_____
2514
2515[Q] I don't see any files in the File selection box. Why ?
2516[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:
2517         Selecting a file
2518
2519[Q] Accelerators (shortcuts for menu items) don't seem to work. They were a while ago. What's happened ?
2520[A] Check the status of the Caps Lock and Num Lock. Neither of them should be engaged.
2521
2522
2523Editing
2524_______
2525
2526[Q] Why can't I change anything in my file ?
2527[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.
2528
2529[Q] Why columns in my file don't line up ?
2530[A] You are most probably using a proportional font. Use a fixed font instead (see the original ASEDIT application defaults file).
2531
2532[Q] I can't undo an action I did a while ago. Why ?
2533[A] There is a limit on number of edit actions that can be undone. The default value is 250.
2534
2535[Q] How can I disable creating backup files ?
2536[A] Define the backupFileSuffix as an empty string. The definition should look like this:
2537	*backupFileSuffix:
2538    and should be placed in your Asedit defaults file (or in the system wide Asedit application defaults file if you are the system administrator).
2539
2540[Q] Why the background colour for the edit area is darker than I specify ?
2541[A] [only for asedit ver. 1.2 or when "*useOldColorSetup" resource is True]
2542    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.
2543
2544
2545Localization
2546____________
2547
2548[Q] Why my native language XYZ is not supported ?
2549[A] Because I don't know it (:-) ) and nobody contributed it yet.
2550
2551[Q] I really would like to get a version for my native language. Can I help ?
2552    Yes you can! If you are ready to spend some time translating a special localization file, contact me at:
2553	astoch@ic.ac.uk
2554    Note that asedit supports only the left to right languages with single-byte character sets.
2555
2556~0000002701
2557To cancel before, during, or after an action
2558
2559Before
2560   In a dialog box that has a Cancel button press Esc key or click Cancel.
2561   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.
2562
2563During
2564   Press Esc key.
2565   If the process does not stop, press Esc again.
2566Note: Some operations cannot be interrupted once started.
2567
2568After
2569   To cancel the most recent editing
2570   Choose Edit| Undo  or press Ctrl+Z.
2571Note: you can undo more than one editing operation, simply repeat the action above.
2572
2573~0000002703
2574To copy text to the Clipboard
2575
25761.   Select  the contents you want to remove.
25772.  Choose Edit|Copy or press Ctrl+C.
2578	The contents will be placed on the Clipboard.
2579
2580You can then paste that text into any other document with the Edit| Paste  command.
2581
2582The text remains in the  Clipboard  so you can paste it many times.
2583
2584_________
2585See also:
2586  Copying text
2587  Alternate edit shortcut keys
2588  Pop-up menu
2589
2590~0000002704
2591To cut text to the Clipboard
2592
25931.   Select  the contents you want to remove.
25942.  Choose Edit|Cut or press Ctrl+X.
2595	The contents will be placed on the Clipboard.
2596
2597You can then choose Edit| Paste  to paste that text into any other document (or somewhere else in the same document).
2598
2599The text remains in the  Clipboard  so you can paste it many times.
2600
2601_________
2602See also:
2603  Copying text
2604  Alternate edit shortcut keys
2605  Pop-up menu
2606
2607~0000002705
2608To paste text from the  Clipboard
2609
26101.  Place the insertion point where you want to insert the Clipboard contents.
26112.  Choose Edit|Paste or press Ctrl+V.
2612
2613
2614_________
2615See also:
2616 Edit| Cut  command
2617 Edit| Copy  command
2618  Copying text
2619  Alternate edit shortcut keys
2620  Pop-up menu
2621
2622~0000002706
2623   To choose and carry out a command
2624
2625  With keys
26261. Hold down the Alt key and press the underlined letter in the menu name.
2627   - or - Press F10 to go to the menu bar, then use the direction keys to select the menu you want, then press Enter.
26282. Press the underlined letter in the command name.
2629   - or -
2630   Use the direction keys to select the command you want, then press Enter.
2631
2632  With mouse
26331. Point to the menu name.
26342. Click the left mouse button.
26353. Point to the command name.
26364. Click the left mouse button.
2637
2638If 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.
2639_________
2640See also:
2641  Cancelling before, during, or after an action
2642  Choosing a button or selecting an option in a dialog box
2643
2644~0000002708
2645To copy a document
2646
26470. If you've just made some changes save them using File|Save.
26481. Choose File|Save As.
26492. In front of the file name, type the path name for the directory where you want to copy the document.
2650   - or -
2651   Type a different file name if you want a copy of the document in the same directory.
26523. Choose OK.
2653_________
2654See also:
2655  Making a backup copy of a document
2656
2657~0000002709
2658Copying text
2659
2660Three different methods of text copying are supported by ASEDIT:
2661
2662   Clipboard     Primary selection    Secondary selection
2663
2664
2665The use of different technique depends on personal preferences. Our recommendations are as follows:
2666
2667Clipboard - general usage; use as a longer-term storage; method widely accepted in the word-processing;
2668
2669Primary selection   - general method of transferring data between different X-Windows applications (for example, this is used to transfer data from/to xterm);
2670
2671Secondary selection - a quick method, but limited to Motif applications; it is most useful for copying text at the point where you are currently typing.
2672
2673~0000002710
2674To copy text using Clipboard:
2675
26761. Select the text you want to copy.
26772. Choose Edit|Copy or press Ctrl+C.
26783. If copying between documents, move the insertion point to the second document.
26794. Place the insertion point where you want to insert the copy (either using mouse or the direction keys).
26805. Choose Edit|Paste or press Ctrl+V.
2681
2682Note: The text remains in the Clipboard so you can paste it many times.
2683If you want to copy text between two documents using Clipboard, first open both documents using ASEDIT.
2684
2685_________
2686See also:
2687  Copying text using Primary selection
2688  Copying text using Secondary selection
2689  Alternate edit shortcut keys
2690  Pop-up menu
2691
2692~0000002711
2693To copy text using Primary selection:
2694
26951. Select the text you want to copy (it may be in ANY application supporting primary selections).
26962. Place the insertion point where you want to insert the copy (either using left button or the direction keys).
26973. Click the middle button.
2698
2699Note: 	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.
2700	The primary selection is very often used to copy text between different X-Windows applications.
2701
2702_________
2703See also:
2704  Copying text using Clipboard
2705  Copying text using Secondary selection
2706
2707~0000002712
2708To copy text using Secondary selection:
2709
27101. Place the insertion point where the copied text WILL go (either using left button or the direction keys).
27112. 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).
27123. Release the middle button. The marked text is immediately stuffed where the insertion cursor was placed before.
2713
2714Note: 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).
2715Whereas primary selections are supported, secondary selections are generally not. In fact only certain X-Windows programs support them.
2716
2717_________
2718See also:
2719  Copying text using Clipboard
2720  Copying text using Primary selection
2721
2722~0000002743
2723    To find the matching delimiter
2724
2725Position the cursor just before the delimiter (for example {, ], or "). Then:
2726
2727  press Ctrl+Q,Ctrl+[ to match forward,
2728
2729  or
2730
2731  press Ctrl+Q,Ctrl+] to match backward.
2732
2733
2734The following pairs are supported: {}, (), [], <>, "", ``, //, '', \\ .
2735
2736
2737You can also use the Search|Match delimiter menu.
2738
2739_________
2740See also:
2741 Search| Match delimiter  menu
2742
2743
2744~0000002715
2745To delete text when you start typing
27461.	Select text.
27472.	Start typing.
2748
2749
2750~0000002716
2751   To choose a button or select an option in a dialog box
2752
2753With keys
2754  Press (once or more) Tab or Shift+Tab key to go to the option requested, then press Enter or Spacebar.
2755  For the default button (usually OK), press Enter.
2756  For Cancel or Close, press Esc key.
2757
2758With mouse
2759  Point to the button or option and click the left mouse button.
2760
2761_________
2762See also:
2763  Moving around in a dialog box
2764
2765~0000002717
2766   To insert a response in a text box
2767
27681.  If the text box's border is not highlighted select the box by either:
2769	pointing it by mouse and clicking the left mouse button
2770	- or -
2771	pressing (once or more) Tab or Shift+Tab key to move focus to the box requested.
27722.  Type your response.
2773
2774    You can then edit your response the same way as in document text.
2775
2776~0000002718
2777   To move a window or dialog box
2778
2779   With keys
27801.	If the borders aren't visible, restore the window to display them.
27812.	Press Alt, Spacebar, M.
27823.	Press the direction keys to position the outline of the window.
27834.	Press Enter to move the window.
2784   With mouse
2785z	Drag the window or dialog box title bar.
2786	Note: Only some dialog boxes have title bars.
2787- or -
27881.	Choose Window Menu|Move.
27892.	Press a direction key.
27903.	Use the mouse to move the outline of the window or dialog box.
27914.	Click the left mouse button to anchor the window or dialog box in the new location.
2792_________
2793See also:
2794  Sizing a window
2795
2796~0000002719
2797   To move around in a dialog box
2798   With keys
2799	Press Tab to move through the buttons and options one by one (pressing Shift+Tab moves you backward).
2800   With mouse
2801	Point to the button or option and click the left mouse button.
2802_________
2803See also:
2804  Moving a window or dialog box
2805
2806~0000002720
2807   To exit ASEDIT
2808
2809	Choose File|Exit
2810
2811
2812Note: If you've modified a file without saving it, ASEDIT prompts you to do so before exiting.
2813      See the  File not Saved !  warning dialog.
2814
2815_________
2816See also:
2817  Pop-up menu
2818
2819~0000002726
2820Selecting a file
2821
2822You select a file using a special file selection dialog. Its' detailed description follows.
2823
2824The file selection dialog displays the file system hierarchy so that you can select a file or directory for.
2825
2826The 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").
2827
2828The dialog is broken down into three main components:
2829 - the directory mask identifies the directory to use and a filter or pattern-matching string;
2830 - 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);
2831 - the Selection text box identifies a file to use when the OK button is activated.
2832
2833The Filter button acts on the directory and pattern specified in the Filter text box.  For example, consider the following filter text:
2834	/home/turbo/demo/*
2835Since 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.
2836Note: Only files are placed in the Files list; directories are excluded since they are listed separately.
2837
2838The above seems straightforward, but it can become VERY confusing for some users. For example, consider the following filter text:
2839	/home/turbo/demo
2840This 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.
2841This is one of the MOST common mistake made by users!
2842
2843Therefore, you should remember to use the last "/" in the filter's path name to separate the directory part from the pattern part.
2844
2845Note about file selection box for loading (opening) a file:
2846The 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).
2847
2848
2849~0000002728
2850   To move text between applications
2851
2852Most X-Windows and Motif text applications support only "copy and paste" functionality (including primary and secondary selections).
2853To 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:
2854
28551.	Start both applications, and open the applicable files in each.
28562.	Select the text you want to move.
28573.	Choose Edit|Cut.
28584.	Place the insertion point where you want to insert the text.
28595.	Choose Edit|Paste.
2860- or -
28611.	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.
28622.	Select the text you want to move.
28633.	Choose Edit|Cut.
28644.	Close the application.
28655.	Start the application for the file where you want to move the text, then open that file.
28666.	Place the insertion point where you want to insert the text.
28677.	Choose Edit|Paste.
2868_________
2869See also:
2870  Cutting text to the Clipboard
2871  Moving text within a document or between documents
2872  Pasting text from the Clipboard
2873
2874~0000002729
2875   To move text within a document or between documents
2876
2877If you want to move text between two documents, first open both documents.
2878
2879   With command
28801.	Select the text you want to move.
28812.	Choose Edit|Cut.
28823.	Place the insertion point where you want to move the text.
28834.	Choose Edit|Paste.
2884
2885   With keys
28861.	Select the text you want to move.
28872.	Press Ctrl+X.
28883.	Place the insertion point where you want to move the text.
28894.	Press Ctrl+V.
2890
2891_________
2892See also:
2893  Copying text
2894  Moving text between applications
2895  Alternate edit shortcut keys
2896  Pop-up menu
2897
2898~0000002730
2899   To create a new document
2900
29011. Choose File|New.
29022. Type the text for the new document.
29033. Choose File|Save or File|Save As.
29044. Type name of a new document in the Save As dialog, then choose OK.
2905
2906~0000002731
2907   To open a document
29081.	Choose File|Open or press F3.
29092.	Type or select the name of the document you want to open.
2910	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.
29113.	Choose OK (or just press Enter).
2912
2913_________
2914See also:
2915  Pop-up menu
2916~0000002733
2917   To print a document
2918
2919   Choose File|Print.
2920_________
2921See also:
2922 File| Print
2923
2924~0000002734
2925   To rename a document
29261.	Choose File|Save As.
29272.	Type a new name for the document.
29283.	Choose OK.
2929	You now have a copy of the document with the new name.
29304.	If you want, delete the document with the old name.
2931_________
2932See also:
2933  Copying a document
2934  Making a backup copy of a document
2935
2936~0000002735
2937Redoing an undo action
2938
2939To redo undo operation select Edit| Redo . Alternatively use Shift+Ctrl+Z shortcut key.
2940
2941~0000002736
2942Repeating previous search
2943
2944To repeat previous search use Search| Find Next  command.
2945
2946Alternatively use Ctrl+L shortcut key (when in the edit window).
2947
2948~0000002737
2949To search and replace text
2950
29511.	Choose Search|Change.
29522.	Type the text you want to search for (change) in the Text to Find: box.
29533.	Type the replacement text in the Change To: box.
2954	- or -
2955	If you want to remove the Text to Find: text from the document, leave the Change To: box blank.
29564.	Options. If you want to limit the search, turn on Case sensitive and/or Whole words only.
29575.	Direction. You can select either Forward or Backward search.
29586.      Choose one of the buttons in the action area:
2959	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.
2960	- or -
2961	Change All button - If you want to make all the changes (the number of changes will be displayed afterwards in a pop-up dialog).
2962
2963_________
2964See also:
2965  Searching for text
2966
2967~0000002739
2968Backup copy of a document when saving
2969
2970As default ASEDIT creates a backup copy whenever a file with a specified name already exists (a default suffix .bak is used).
2971This 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).
2972
2973_________
2974See also:
2975  Copying a document
2976
2977~0000002740
2978To save a document
2979
2980     Choose File|Save or press F2 shortcut key.
2981
2982_________
2983See also:
2984  Making a backup copy of a document
2985  Renaming a document
2986  Pop-up menu
2987
2988~0000002745
2989   To search for text
29901.	Choose Search|Find.
29912.	Type the text you want to find in the Text to Find: box.
29923.	Options. If you want to limit the search, turn on Case sensitive and/or Whole words only.
29935.	Direction. You can select either Forward or Backward search.
29946.	Choose Find Next button to find the nearest occurrence of the text.
2995
2996_________
2997See also:
2998  Searching and replacing text
2999
3000~0000002747
3001   To select text with the mouse
3002
3003Any text
30041.	Point to the beginning of the text you want to select and click the left mouse button.
30052.	Hold down the left mouse button and move the mouse pointer to the end of the text you want to select.
3006	- or -
3007	Point to the end of the text you want to select, then hold down Shift and click the left mouse button.
3008
3009A word or line
30101.	Place the insertion point in the word or line.
30112.	For a word, double-click left mouse button.
3012	For a line, triple-click left mouse button.
3013
3014_________
3015See also:
3016  Selecting text with Keys
3017
3018~0000002744
3019    To search for selection
3020    (another occurrence of a selected text)
3021
30221. Select in the edit window what you want to search for
3023   (remember double-click selects a word).
30242. Press Ctrl+L or choose Search|Find Next command.
3025
3026All settings made in the Find dialog box remain in effect when you choose Find Next.
3027
3028Note: do NOT include a new line in the selection, otherwise the highlighted text is not treated as an item to search for.
3029_________
3030See also:
3031  Find dialog box
3032
3033~1800000000
3034	      List of menu commands
3035
3036
3037
3038