home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 2 / crawlyvol2.bin / apps / text_ed / 7up_engl / 7up_docu / 7up_engl.doc next >
Text File  |  1993-04-19  |  62KB  |  1,491 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                            The Manual for
  11.  
  12.                            7777777
  13.                           7     7
  14.                                7   U  U  PPPP
  15.                               7    U  U  P  P
  16.                              7     UUUU  PPPP
  17.                             7            P
  18.                            7             P
  19.  
  20.                           --------------------
  21.                               Version 2.09d
  22.                                 14.07.92
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                   Table of contents               Page
  36.                   ------------------------------------
  37.                   0.   Product description           3
  38.                   1.   System requirements           4
  39.                   1.1. Installation                  4
  40.                   1.2. Operation under Gemini*       5
  41.                   1.3. Operation under MultiGEM*     5
  42.                   2.   The Dropdown Menus            5
  43.                   2.1. Configuration save           13
  44.                   3.   The Keyboard                 13
  45.                   3.1. The Function keys            15
  46.                   3.2. The SHIFT key                15
  47.                   4.   Block operations             16
  48.                   4.1. Column setting               16
  49.                   4.2. Numeric Operations           16
  50.                   5.   Search and Replace           17
  51.                   6.   The Print menus              21
  52.                   7.   The Desktop icons            23
  53.                   8.   The GEM-Window               24
  54.                   8.1. The Dialog boxes             24
  55.                   9.   The Clipboard                24
  56.                  10.   Technical Details            25
  57.                  11.   The TURBO-C HELP Accessory   29
  58.                  12.   Trips and Ticks              30
  59.                  13.   Four Words                   30
  60.                  14.   Greetings                    30
  61.  
  62. 0. Product description
  63. ----------------------
  64. 7UP is a GEM*Text editor for the Atari ST. 7UP uses the Advantages of this
  65. Shell, such as Dropdown Menus, GEM-Window, Dialog boxes and Desktop icons.
  66. For Operation under MultiGEM can 7UP also without Desktop icons working
  67. become. See Chapter 1.3 and 2.1.
  68.  
  69. 7UP can both with the Mouse as also by Keyboard commands be controlled
  70. and has been, as far as as possible, according to Proper programming lines
  71. developed.
  72.  
  73. 7UP  makes use of  no exotic formats, no getting used to poor Features, so that
  74. everything  immediately  with it  is clear.  One  Strength  of 7UP  is its high
  75. Speed and the Possibility of Column processing. With it can one comfortably
  76. edit and calculate Numeric tables(!), which with other Editors  normally is not
  77. possible (see Chapter 4).
  78.  
  79. Moreover 7UP provides by efficient Functions Searching for Text passages,
  80. GREP and Match, programmable Function keys, loadable GDOS-Fonts, a Text preview
  81. function and convenient Printing.
  82.  
  83. With its Shell function  can It with the Management system communicate.
  84. With  7UP as many as 7 Texts,  with  up to  512 Characters per Line,
  85. "simultaneously" can be edited (thus the Name 7UP).
  86.  
  87. 7UP  is a Shareware program. Therefore you are asked to pay the Author an
  88. appropriate  Amount,  when  You with 7UP are pleased, and its regular  use
  89. want. When you no Pirate copy use want and in Further development  of  7UP
  90. are interested, use please this  opportunity and invest this Amount, so that
  91. in the Future inexpensive Software you can continue to receive . Otherwise is
  92. the further development of 7UP undermined, by the amount of that Pirate copy.
  93.  
  94. The Cost for the Version 2.00 of 7UP is as follows:
  95.    Atari ST/STe/TT                  : 50.- DM
  96.  
  97. Shareware is not cost-free!
  98.  
  99. 7UP  is available by your Sending a 720 kilobyte formatted 3.5" Disk and
  100. a stamped and addressed Return envelope to the following Address:
  101.  
  102. Address:
  103.    Michael Thänitz
  104.    Osningstr. 69
  105.    4800 Bielefeld 1
  106.    Germany (Deutschland)
  107.  
  108. Account-number:
  109.    SSK Bielefeld
  110.    BLZ 480 501 61
  111.    KNR 64573009
  112.  
  113. E-Mail:
  114.    MAUS-Net
  115.    Michael Thänitz @ BI
  116.  
  117. Quark Bielefeld
  118.    USERNAME: MICHAEL THÄNITZ
  119.    TEL. 0521/24222 (PEP)
  120.  
  121. When you Ask about 7UP, mention please always the Version-number.
  122. You find it at the Beginning of the Users manual or in the Copyright menu.
  123.  
  124. Forget  please not, Your Address on the transfer form to note, with it you
  125. as  user registered become can. Your copy is subject to Data protection and
  126. cannot be given away to a third party.
  127.  
  128. It  is  expressly  desired that  7UP  be distributed,  only in
  129. complete,  unchanged  Form.  On the Disk or in the Archive
  130. must the following Files be:
  131.  
  132.    7UP.APP       7UP Main program
  133.    7UP.Rsc       Resource file for 7UP
  134.    7UPICN.Rsc    Icon file for Gemini*
  135.    NEWICONS.Rsc  Icon file for Gemini* from René T. Fritz
  136.    7UP.DOC       Users manual (what you are now reading)
  137.    LINKS.LAY     Layout for the left Page of this DOKU (12 CPI)
  138.    RECHTS.LAY    Layout for the right Page of this DOKU (12 CPI)
  139.    TAXPATCH.TTP  Patch program for the Value Added Tax
  140.    TAXPATCH.DOC  Users manual for TAXPATCH
  141.    CALCLOCK.ACC  Printer spooler compatible with PC-GEM/3 CALCLOCK
  142.    CALCLOCK.INF  INF-File with it
  143.    CALCLOCK.DOC  Users manual for CALCLOCK
  144.    SPOOL.TTP     MUPFEL-Command for Gemini*-Desktop
  145.    SPOOL.C       Source for SPOOL.TTP
  146.    SPOOL.MAN     Online-Manual for MUPFEL
  147.    CHANGES.TXT   News
  148.  
  149. Uploading to Bulletin board systems is express desired. Please recommend
  150. 7UP further, when with it you are pleased. When not, well yes...
  151.  
  152. It  is  express  forbidden,  7UP  at expense in the  PD-Version to
  153. sell.  Generally  can be said, that from Third parties no Charge
  154. in any  Way  for  7UP  can be made. For your handling can a charge
  155. be rightly pursued.
  156.  
  157. 7UP  has been  according to my best abilities developed and tested.
  158. Not-withstanding could it to Errors come. The Author assumes none whatsoever
  159. Liability for Damage in any way, direct or indirect arising from the use of 7UP.
  160. It  can  also not guaranteed be, that 7UP for any certain Purpose fit is.
  161.  
  162. Should  you  Error  find,  then delete please, if possible, all AUTO folder
  163. programs and  Desk accessories. If the Error now always remains reproducible,
  164. inform me please. You can easily notify by per E-Mail. Suggestions for
  165. improvemenent are just as welcome.
  166.  
  167. 1. System requirements
  168. ----------------------
  169. For  Operation of 7UP is an Atari ST Computer with Disk drive,
  170. TOS  in ROM and at least 512Kbyte RAM necessary. Each further
  171. Expansion level such as Hard-disk or more RAM increases your Convenience.
  172. 7UP  should also on the Mega STe and TT run perfectly. Just as are
  173. also  Big screens  with Color display supported. Problems could it
  174. display with large Dialog boxes in lowest Monitor-resolution (320X200).
  175.  
  176. 1.1 Installation
  177. ----------------
  178. Copy  the Files from the Disk in(to) a Folder of Your Choice.
  179. The  Accessory  CALCLOCK.ACC  and CALCLOCK.INF copy in(to) the Root-
  180. folder of the  Boot partition of Your Hard-disk. When you only a Floppy-
  181. disk drive possess, copy the ACC to your Boot disk.
  182. For  the  Keyboard setup  via  Control Panel I recommend the following
  183. Value: Delay 200MS, Repeat rate 20MS.
  184.  
  185. 1.2. Operation under Gemini*
  186. --------------------------
  187. When you use the Desktop Gemini*, placed in the File 7UPICN.RSC
  188. is an Icon  for  7UP  to Use. As that Icon is in(to) Gemini* integrated,
  189. please see  the  Users manual  for  Gemini*.   SPOOL.TTP
  190. copy It in(to) the Folder \GDIST1_2\BIN\, SPOOL.MAN in(to) the
  191. Folder \GDIST1_2\MAN\ (Only Gemini* from Version 1.2).
  192.  
  193. 1.3. Operation under MultiGEM*
  194. ----------------------------
  195. As  already  mentioned, it runs  well on one new TOS-Version,
  196. PAM-MultiGEM, a Way Multitasking is allowed.
  197. Multitasking means:
  198.  
  199. 1. Start several Application programs. they run then like parallel.
  200. 2. Switch from one Program to another by Mouse click in the Window.
  201.    The Menu bar becomes automatically switched.
  202. 3. Desktop background is usable, so that the Communication with the
  203.    Management system further on possible is, e.G. Files copy.
  204.  
  205. Requirement:
  206.  
  207. 1. GEM-Program should not its own Desktop have, or it should
  208.    switch off be.
  209. 2. Clean Programming and compatible GEM-Binding (of) the Program.
  210.  
  211. Switch off the Desktop:
  212. Under "Work save" can you select, whether the Desktop is shown or not.
  213. See Chapter 2.1.
  214.  
  215. 2. The Dropdown Menus
  216. --------------------
  217. During  the Description of 7UP it is assumed, that you have 7UP
  218. at hand and are conversant in the use of GEM-Programs.
  219. The  Use of the Mouse, Dropdown Menus, Windows, Dialog boxes and Icons, as well
  220.  as
  221. their Manipulation, should be familiar.
  222. 7UP  provides seven Dropdown Menus in(to) which all Commands for the Control
  223. (of) the Program are contained. The Menus appear as follows:
  224.  
  225.   7UP   File     Edit       Search   Compute   Mode    Window   Options
  226. |-----|-------|------------|--------|---------|-------|---------|---------
  227. | about 7UP...    ◆A |
  228.  --------------------
  229.       | New layout        ^N |
  230.       | open...           ^O |
  231.       | Merge...          ^R |
  232.       | Information...    ^I |
  233.       |----------------------|
  234.       | Close Doc         ^U |
  235.       | Save              ^S |
  236.       | Save as...        ^M |
  237.       | Abort             ^D |
  238.       |----------------------|
  239.       | Call shell...     ^E |
  240.       |----------------------|
  241.       | Page layout...    ◆L |
  242.       | Print...          ^P |
  243.       |----------------------|
  244.       | Quit              ^Q |
  245.        ----------------------
  246.            | Undo           UNDO |
  247.            |---------------------|
  248.            | Select All       ^A |
  249.            |---------------------|
  250.            | Cut              ^X |
  251.            | Copy text        ^C |
  252.            | Paste text       ^V |
  253.            |---------------------|
  254.            | Left justify     ^K |
  255.            | Right justify    ^J |
  256.            |---------------------|
  257.            | Upper/lower case    |
  258.            | All upper           |
  259.            | All lower           |
  260.            | Capitalization      |
  261.            |---------------------|
  262.            | GEM-Clipboard    ◆G |
  263.             ---------------------
  264.                    | Search/Replace...  ^F |
  265.                    | Continue search    ^G |
  266.                    |-----------------------|
  267.                    | Go to Block start  ^G |
  268.                    | Go to Block end    ^E |
  269.                    |-----------------------|
  270.                    | Set mark...           |
  271.                    | go to Mark...         |
  272.                    |-----------------------|
  273.                    | go to Line...      ^L |
  274.                     -----------------------
  275.                             | Column block    ◆C |
  276.                             |--------------------|
  277.                             | Number          ◆N |
  278.                             | Sum             ◆S |
  279.                             | Average         ◆M |
  280.                             | Std.deviation   ◆D |
  281.                             | Value Added Tax ◆W |
  282.                             |--------------------|
  283.                             | Calculate all      |
  284.                              --------------------
  285.                                      | Set tabs         ◆T |
  286.                                      | Line length...   ◆U |
  287.                                      | Set block        ◆G |
  288.                                      | Insert mode  INSERT |
  289.                                      | Word wrap        ◆I |
  290.                                       ---------------------
  291.                                              | Next Window      ^W  |
  292.                                              |----------------------|
  293.                                              | ...over and under    |
  294.                                              | ...side by side      |
  295.                                              | ...stacked           |
  296.                                               ----------------------
  297.                                                     | Choose fonts...  ◆F |
  298.                                                     | Character set... ◆E |
  299.                                                     |---------------------|
  300.                                                     | auto. indent        |
  301.                                                     | Function keys...    |
  302.                                                     | Text preview...  ◆V |
  303.                                                     |---------------------|
  304.                                                     | Save settings  ...  |
  305.                                                      ---------------------
  306.  
  307. Note:
  308. After a number of the Menu entries are shown Letter combinations - The so
  309. called Keyboard shortcuts.
  310. See Chapter 3.
  311.  
  312. Menu: 7UP
  313. Here are shown theDesk accessories, naturally all freely accessible.
  314.  
  315. Menu selection: about 7UP... ◆A
  316. Here you find  the Copyright notice, as well as the Version number. When you
  317. Ask  me a question about  7UP, please always mention the Version-number. Under
  318. "Info" is shown a Short data block about 7UP.
  319.  
  320. Menu: File
  321. Under  this  Menu you find all Commands for the Loading, Saving and
  322. Printing of the Text, as well as for Quitting the Program.
  323.  
  324. Menu selection: New layout ^N
  325. For  a  new  Text give to open, select this Menu selection. It
  326. opens a Window as well as an Icon using the Name "Untitled.TXT". When
  327. you  later want to save this new  Text, assign in the FSB
  328. (File selection box) to the File any valid name you may choose.
  329.  
  330. Menu selection: open... ^O
  331. Enables loading of an already existing Textfile from Disk. It
  332. also produces a new Desktop icon. Select with the FSB the
  333. Textfile  that you wish to load. When you while loading press the SHIFT key,
  334. the Atari 'ß' changes in(to) an IBM*-compatible 'ß'. You
  335. have  then  less Problem with printing this Character. This works
  336. also for the "Merge...", as well as for "Paste text" in the Edit-Menu.
  337. See also Chapter 3.2.
  338.  
  339. Menu selection: Merge... ^R
  340. Places  a  File,  that you select with the FSB, at the current Cursor position.
  341.  
  342. Menu selection: Information... ^I
  343. Gives  Information about  the File or the marked Block in the active
  344. Window. The following Information is presented:
  345.  
  346. 1. Filename (editable)
  347. 2. File size
  348. 3. Number of lines
  349. 4. Number of pages (dependent on Page layout)
  350. 5. Number of loaded Files
  351. 6. free Working memory
  352.  
  353. When you have one or more Icons selected, you receive the appropriate
  354. Information about that Icon. The affected Icon blinks immediately before
  355. its information is displayed.
  356.  
  357. Menu selection: Close doc ^U
  358. Closes  the open Window for its Icon. If the File has been changed,  a dialog
  359. asking if you want to save the changes will appear, so there is no chance you
  360. will accidentally lose your work.
  361.  
  362. Menu selection: Save ^S
  363. Saves the File under the Window name. Spaces at the End of the Line  are
  364. automatically suppressed. When you hold down the SHIFT key, the text is appended
  365. to the existing file! The Text can by Tabs become compressed (see "Tabs...").
  366. Save only works if since the last Save changes in the Text  have been made.
  367. The Functions of the SHIFT key are in Chapter 3.2 explained.
  368.  
  369. Menu selection: Save as... ^M
  370. Gives  You before the Save the Opportunity to, in the File selection box,
  371. give a new Name to the file being saved. The new Name then also applies to the
  372. open window. If the filename already exists, a Warning alert results. When a
  373. Block is marked, only the Block is saved under the new Name. When  you during
  374. this Action press the SHIFT key, the File (the Block) onto the already existing
  375. File will be appended! Also here appears an appropriate Display. See Chapter
  376.  3.2.
  377.  
  378. Menu selection: Abort ^D
  379. The  Text  becomes  overloaded, i.e. it is deleted and from Disk  reloaded.
  380. You nevertheless are given a chance by alert box to save changes before the
  381. delete/reload.  The Function recommends itself, when you want to abandon all
  382. current changes.  When  no one  changes  have been made, nothing happens when
  383. you choose this selection.
  384.  
  385. Menu selection: Call shell... ^Z
  386. When  you from 7UP  a Desktop shell want to run, if the Shell pointer is
  387. supported,  can  you from here issue Commands to the Management system.
  388. e.g. Gemini*.
  389.  
  390. When  no Shell pointer is supported, e.g. original Atari Desktop,
  391. an appropriate  Error report  results. In the Help box can you
  392. these Facts of the case read.
  393.  
  394. With the Button "Program start" can an external Program using the File
  395. selection box  (FSB)  directly be called. As Parameter uses that which in
  396. the Command-line is placed, or that, which you with the  FSB  with the
  397. title "Start program"  select.  When you need no Parameter, so delete the
  398. Command-line by ESC or click Abort on "Parameter assign".
  399.  
  400. Menu selection: Page layout... ◆L
  401. Menu selection: Print...      ^P
  402. Page layout and Printer setup.
  403. To Print a marked Block no dialog box appears, because no Layout settings are
  404. necessary. Holding the SHIFT key sends a Formfeed after printing.
  405. See Chapter 6, 3.2 and 12.
  406.  
  407. Menu selection: Quit ^Q
  408. End the Program.  Changed  Files can still be saved. When you hold the SHIFT
  409. key while quitting, the last Configuration is saved.
  410. See Chapter 2.1 and 3.2.
  411.  
  412. Menu:Edit
  413. Under  this Menu you find all Commands for the Textblock handling.
  414.  
  415. Menu selection: Undo   UNDO
  416. Following Operations can with Undo be canceled:
  417.  
  418. 1. open File
  419. 2. Cut Block (only with the Clipboard)
  420. 3. Delete Line                 "
  421. 4. delete up to Line  end      "
  422. 5. Delete Word (Double click)  "
  423. 6. Editing a Line
  424.  
  425. Undo functions not, when its Menu entry is grayed (Disabled).
  426. You can also operate these Menu selections by the UNDO key.
  427. See Chapter 3.
  428.  
  429. Menu selection: Select all ^A
  430. Marks the whole  Text  or,  when no Window is open, all Icons,
  431. provided that 7UP is installed with its Desktop. The latter is
  432. helpful if you want to delete all Icons at once. See Chapter 1.3.
  433.  
  434. Menu selection: Cut ^X
  435. Cut  the marked Block, deletes It from the Text. The Block
  436. is  however not lost, but remains in the buffer. See Chapter 4.
  437.  
  438. Menu selection: Copy text ^C
  439. Copies  the marked  Block  in(to)  the buffer.  It can then be inserted
  440. anywhere, and as many times, as you wish. The block marking is lost in
  441. this operation.
  442.  
  443. Menu selection: Paste text ^V
  444. Places  the  cut  or  copied Block on the current Cursor-position. The
  445. Insertion can be multiply repeated. The Block naturally can even be
  446. pasted into another Window.
  447.  
  448. Menu selection: Left justify ^J
  449. Menu selection: Right justify ^K
  450. Shifts a  marked  Block by one Tabstop to the left or to the right.
  451. The block Marking is not lost. The Process can be multiply repeated.
  452. When  the Column block is activated, you can even shift Text columns.
  453.  
  454. Menu selection: Upper/lower case
  455. Menu selection: All upper
  456. Menu selection: All lower
  457. Menu selection: Capitalize
  458. Converts letters in the marked Block. Capitalize means to change the
  459. first  Letter of each Word to a Capital letter. By this selection
  460. actual Words, and not just strings separated by Spaces, are found
  461. and capitalized.
  462.  
  463. Menu selection: GEM-Clipboard ◆G
  464. All  Block operations  work using the GEM-Clipboard. Default has this
  465. Option switched-on. See also Chapter 9.
  466.  
  467. Menu: Search
  468. Under  this  Menu are all Commands for Search and Replace.
  469.  
  470. Menu selection: Search/Replace... ^F
  471. Here you can search and replace Character strings  in  Your Text.
  472. The Search text as well as the Configuration of the Buttons can
  473. be saved. See Chapter 5.
  474.  
  475. Menu selection: Continue search ^G
  476. Enables you to again Search or Replace, when not by Replace the
  477. Button  "all"  chosen has been (in that Case naturally all
  478. Text passages will have already been replaced).
  479. See Chapter 5.
  480.  
  481. Menu selection: Go to Block start
  482. Menu selection: Go to Block end
  483. When  a  Block is marked, can you hereby to Block start or Block end
  484. jump. The Cursor always positions itself at the beginning of the Line.
  485.  
  486. Menu selection: Set mark
  487. Internally Marks the  Text passage, where the Cursor is located.
  488. Up to  five Marks can be set.
  489.  
  490. Menu selection: Go to Mark
  491. Jump to the Place, where the last marked Text passage is.
  492. There can be up to  five user-set Mark that can be jumped to.
  493.  
  494. Menu selection: go to Line... ^L
  495. Shows  the  current  Line number where the cursor is located.
  496. Change  the  Number to the desired Line. The Cursor then jumps to the
  497. appropriate  Line.
  498.  
  499. Menu: Compute
  500. With the Help of this Function it is possible to do simple Calculation.
  501.  
  502. Menu selection: Column block ◆C
  503. Switches  between  normal  Block marking  and  the Column block
  504. marking. Column blocks are e.g. self-contained  Numbers-columns
  505. that conveniently can be copied to another Place.
  506. This is not possible with normal  Block marking. Default is
  507. this Option active. See also Chapter 4.
  508.  
  509. Menu selection: Number           ◆N
  510.                 Sum              ◆S
  511.                 Average          ◆M
  512.                 Std.deviation    ◆D
  513.                 Value Added Tax  ◆W
  514.                 Calculate all
  515.  
  516. Numeric  Operations  with Column blocks. To sue these functions
  517. the column block must be activated. See Chapter 4.2.
  518. The Value Added Tax  was at the  Time set at 14.00%. When it changes
  519. you must use the supplemental Program TAXPATCH.TTP. Even if you don't
  520. want to change it, you'll have to when the Federal government decides
  521. IT wants to change it. :-)
  522.  
  523. <translator's note: the VAT function may have seemed useless to American users,
  524. but if Mr. Clinton has his way... You can use TAXPATCH.TTP to reset this
  525. function to your state sales tax percentage, standard markup, or whatever you
  526. find useful>
  527.  
  528. Menu: Mode
  529. Here are setup choices that influence the operation of the editor.
  530.  
  531. Menu selection: Tabs... ◆T
  532. Enables Configuration (of) the Tabs, separately for each Window. The
  533. Tab stop becomes highlighted in the Info line of the Window. By the Button
  534. "compress" you can choose to save the document in compressed tab form.
  535. By pressing the  TAB key the cursor is moved to the next Tab-position
  536. placed. With BackTAB (SHIFT TAB) it becomes Tab position back positioned.
  537.  
  538. Menu selection: Line length... ◆U
  539. For text lines to constantly flow one after the other with consistent margins
  540. without your using the RETURN key as on a typewriter, here can the automatic
  541. Line wraparound  for the desired Column width be installed.
  542.  
  543. You  need  then to give no more  Consideration of the Line length.
  544. Type Your Text without worry about pressing RETURN. The Formatting
  545. result is automatic. Default is this Option active.
  546.  
  547. Menu selection: Set block  ◆B
  548. This is  a Complement of the Line wraparound. An unbroken Line becomes
  549. automatic in the Length being dragged. over several Line considered, receive
  550. you like this a left and right-justified arranged Text. 7UP  drags Lines with
  551. Words not considered separately, but  places a maximum of two Spaces between
  552. the individual Words. It can so occur, that the Block mark is not always one
  553. hundred percent reached. Default is this Option active.
  554.  
  555. Menu selection: Insert mode    INSERT
  556. Switches  between  Insert and overwrite mode. Default is this Option
  557. switched-on. See Chapter 3.
  558.  
  559. Menu selection: auto. Indent ◆I
  560. Enables the  Cursor  by Pressing the RETURN-Key to be positioned under
  561. the first Letters of the previous Line. This Option is intended for
  562. Programmers. Default is this Option switched-on.
  563.  
  564. Menu: Window
  565. Menu selection: Next Window ^W
  566. Makes possible Switching among various Windows.
  567. Alternatives:
  568.  
  569. 1. Double click on the appropriate Window Icon
  570. 2. Selection (of) the Icons and Operation (of) the Menu selection "open..."
  571. 3. Use the Shortcut '^W'
  572.  
  573. Menu selection: ...over and under
  574. Menu selection: ...side by side
  575. Menu selection: ...overlapped
  576. Orders several open Windows as you wish them displayed.
  577.  
  578. Menu: Options
  579. Here you find a series of additional Configurations, that mainly serve
  580. to make 7UP more convenient to use.
  581.  
  582. Menu selection: Font choice... ◆F
  583. In the Font choice box the following information is presented:
  584.  
  585. 1. Font name (only nonproportional Fonts)
  586. 2. Point size (of) the setup Fonts
  587. 3. Text color
  588. 4. Background color
  589. 5. Style sample in the small Window
  590.  
  591. To use GDOS-Fonts, (AMC)GDOS must be booted in the AUTO  folder.
  592. See Chapter 10.3.
  593.  
  594. The  Selection of the nonproportional Character sets is automatic. Usage is
  595. similar to that of the File selection box. A maximum of 16 Fonts with a maximum
  596. of 16  different Point sizes can be loaded. That should in Practice be enough.
  597. E.E. there also are not more Fonts available.
  598.  
  599. Be sure that both Font type and Point size are selected, when you press the
  600. OK-Button, else no new Font becomes installed.
  601.  
  602. You will note that some Fonts have Long names. Those names you can see by using
  603. the horizontal  Scrollbar.  If the installed Management system permits, you can
  604. in the editable FSM-Field also configure other In-between sizes.
  605.  
  606. 7UP  supports 16 Colors for the color Representation in the Text window.
  607. You can assign different Colors to the Text or the Background. You achieve the
  608. Color switching by Adjusting the little Scroll arrow beside the Colors box.
  609. There is placed 'F' for Font color and 'H' for Background color. The Button
  610. "Standard" places the Colour again to black/white. The Color setting can be
  611. saved, if you wish.
  612. The Help box provides information about the Installation of GDOS.
  613. See also Chapter 2.1 and 10.
  614.  
  615. Menu selection: Character set... ◆E
  616. Makes a Dialog box displaying the complete Character set appear. Here you can
  617. by Mouse-clicking on the desired Character, which is not accessable from the
  618. Keyboard, insert that character at the  current Cursor position. The inserted
  619. character will be of the font current selected by the font choice box. The
  620. following characters are not available:
  621.  
  622. 1. Null byte ($00)
  623. 2. Linefeed ($0A)
  624. 3. Carriage return ($0D)
  625.  
  626. As an Alternative you have, as under MSDOS, the Possibility to user-assign the
  627. Key code with the Help of the ALTERNATE key. Press the ALTERNATE key and give
  628. simultaneously the Decimal value (of) the desired Character. The Decimal value
  629. can be found in any ASCII-Table.
  630.  
  631. Menu selection: auto. Backup ◆B
  632. Produces a Backup file  with the Extension  'BAK', when you save a file.
  633. The old File is retained with the extension 'BAK'. Default is this Option
  634. switched-on.
  635.  
  636. Menu selection: Function keys...
  637. Controls usage of the Function keys for Text macros. The Text can be saved.
  638. When  on the chosen function key no one Macro exists, then appears the
  639. Dialog box for the Function keys, and you can assign a new Macro.
  640. When you have Marked a word, it becomes assigned to the Function key that
  641. you then press, but only if that function key was currently unassigned. The
  642. automatic  Usage  result  by  Pressing the Function key. The Help box shows
  643. the Variables that you can use in your macros.
  644. See also Chapter 3.1.
  645.  
  646. Menu selection: Text preview... ◆V
  647. The Text  becomes  in accordance with the "Page layout" displayed in little
  648. Windows. Here can you beforehand see, how your printed pages will appear.
  649. If you directly insert formfeeds (FF) into the text, be sure that the formfeed
  650. is the only character in the line! Otherwise you will confuse the layout.
  651.  
  652. You can interrupt the output by pressing the left mouse button.
  653.  
  654. When you want to look at an already formatted file, you should set the top and
  655. bottom margins and the header and footer lines to zero if you don't want them
  656. to appear. When you have a block marked, Text Preview  displays only the block.
  657.  
  658. Menu selection: Save settings
  659. See Chapter 2.1.
  660.  
  661. 2.1. Save settings
  662. ------------------
  663. There are two ways to Save the Configuration.
  664.  
  665. 1. Operation (of) the Menu selection "Save settings"
  666. 2. Press the SHIFT key while quitting the Program
  667.  
  668. Following settings are saved:
  669.  
  670. 1. current Window position
  671. 2. Icon position
  672. 3. Tabs (for each Window)
  673. 4. Configuration of the Menu choices
  674. 5. Configurations in the Dialog boxes
  675. 6. Default font and Color
  676. 7. The Names of the last edited Files (only by Quitting...)
  677. 8. Cursor position in the Text
  678.  
  679. When  you want the Desktop turned off for Operation under MultiGEM, you must
  680. answer the Question "Desktop turned off?" with "OK".
  681.  
  682. 3. The Keyboard
  683. ---------------
  684. You are already aware,  that after  the Commands in most of the Dropdown Menus
  685. are shown Characters such as ^X, or ◆G. These are the so-called Keyboard
  686.  shortcuts
  687. for the appropriate Commands. ^X  means Press and Press and hold the CONTROL-Key
  688. as well as the Letter 'X'. It is there all the same, whether 'x' or 'X'. The
  689. Character '◆' is shown for the ALTERNATE-Key, the Procedure is the same as with
  690. CONTROL. When you operate these Key-combinations, it acts the same as a Mouse
  691.  click
  692. on these Menu entries. So you can control most of the menu entries by the use of
  693. keyboard shortcuts.
  694.  
  695. CAPSLOCK
  696.    switches  on Capital letters. The Status becomes by 'CAPS' in the
  697.    Info line (of) the active Window highlighted.
  698.  
  699. INSERT
  700.    switches between Insert and overwrite mode.
  701.  
  702. CONTROL-Cursor  (left or right)
  703.    moves the Cursor from one Word to other. This uses not only Spaces
  704.    as word Separators, but also Special characters.
  705.  
  706. SHIFT-Cursor (left or right)
  707.    left jumps the cursor to the beginning of the line, right to the end.
  708.  
  709. BACKSPACE
  710.    deletes the Character to the left of the Cursor and pulls the Remainder of
  711.    the Line back accordingly.
  712.  
  713. DELETE
  714.    deletes the Character to the right of the Cursor and pulls the Remainder
  715.    the Line accordingly.
  716.  
  717. SHIFT-DELETE
  718.    deletes the Word under the Cursor.
  719.  
  720. Alt-DELETE
  721.    deletes from the Cursor position up to the Line  end.
  722.  
  723. CONTROL-Y
  724.    deletes the Line, in which the Cursor is placed. When the Clipboard is
  725.    activated the Line becomes recorded there.
  726.  
  727. TAB
  728.    places  in the  Insert mode  <Tab stop> Space and pushes the
  729.    Line to the right. In the overwrite mode becomes just the Cursor
  730.    to the right positioned.
  731.  
  732. SHIFT-TAB
  733.    set the Cursor one Tab position backward (to the left).
  734.  
  735. Cursor-key
  736.    Moves the cursor in the direction indicated by the arrow key.
  737.    Also hold down the SHIFT key, becomes the Screen page display
  738.    scrolled. You can position the Cursor also with the Mouse, by
  739.    pressing the left mouse button on the point where you want the
  740.    text cursor to be.
  741.  
  742. HOME
  743.    go to the Beginning (of) the Text.
  744.  
  745. CLR (SHIFT-HOME)
  746.    go to the End of the text.
  747.  
  748. SHIFT-Cursor-UP
  749.    scrolls page display up.
  750.  
  751. SHIFT-Cursor-DOWN
  752.    scrolls page display down.
  753.  
  754. UNDO
  755.    forces  the  Block operations  "Cut"  as well as  Delete line  with
  756.    CONTROL-Y to be canceled, assuming that the Clipboard  is  active.
  757.    Just the same can a single Line again be restored, assuming, that the
  758.    Cursor is located  in the appropriate Line.
  759.    With this must the Clipboard not be active.
  760.  
  761. ESC
  762.    has no one Function, except in Dialog boxes in the GEM-customary
  763.    Manner.
  764.  
  765. 3.1. The Function keys
  766. ------------------------
  767. The  Function keys can with Macros be 'loaded', the macros can then of course
  768. be inserted into the text as you wish. 7UP recognizes the following Variables:
  769.  
  770.    %H = Hour
  771.    %M = Minute
  772.    %S = Second
  773.    %T = Day
  774.    %M = Month
  775.    %J = Year  (2 digits)
  776.    %W = Weekday (Sunday, Monday, ...)
  777.    %D = Day of the Year
  778.    %F = complete Pathname of the current File
  779.    %F = Name of the current File
  780.  
  781. Example:
  782.    Bielefeld the %T.%M.19%J at %H:%M (o')clock
  783. produces:
  784.    Bielefeld the 15.05.1991 at 12:45 (o')clock
  785.  
  786. You can assign 20 function key macros, 10 unshifted and 10 shifted. The toggle
  787. button 'shifted'/'unshifted' in the function key dialog controls which way the
  788. macro is registered. As an additional aid, an upward pointing shift arrow
  789. appears in the dialog before the function key designation for each shifted
  790. macro. If the function key you press is unassigned, the dialog box will appear
  791. and you may assign a macro. If it is assigned, that macro will appear in your
  792. text at the cursor position. The Help selection of the dialog box shows you the
  793. available variables to be used in your macros. The Percent sign itself must be
  794. typed in as %% (double percent sign)!
  795. Your macro entries can of course be saved if you wish.
  796. See Chapter 2.1.
  797.  
  798. 3.2. The SHIFT key
  799. -------------------
  800. The  SHIFT key  has a special Meaning in many of 7UP's Functions.
  801. Here is a listing of the SHIFT key's effect on those functions:
  802.  
  803. Function              Effect
  804. --------------------------------------------------------------------------
  805. "open..."             Change Atari 'ß' in(to) IBM 'ß'
  806. "Merge..."              "      "        "
  807. "Save"                Appends the Text to the existing File
  808. "Save as..."             "         "            "         "
  809. "Print..."            When a block is marked, on Print completion there is
  810.                       a Formfeed sent to the printer (Single sheet entry)
  811. "Quit"                Stores the last System settings
  812. "Cut"                 Appends the Text on(to) the existing Clipboard file
  813. "Copy text"              "         "            "         "
  814. "Insert"              Change Atari 'ß' in(to) IBM 'ß'
  815.  
  816. Single click          Mark beginning (and end) of a block
  817. Double click          Marks entire Text line in the Window
  818. CONTROL-Y             Appends the Line onto the existing Clipboard file
  819.                       Not with RAM-Clipboard!
  820. Clicking on Icon      Make Selection of several Desktop icons
  821. Dialog box ("handle") Make Dialog box become transparent
  822. Dialog box centering  Centers Dialog boxes
  823.  
  824. 4. Block operations
  825. -------------------
  826. A Text block can in various ways be marked:
  827.  
  828. 1. Overstroking (of) the Texts with the Mouse, while pressing the Mouse button.
  829.    The Window scrolls automatically when you exceed the Window limits
  830. 2. Cursor positioning with the Mouse, while pressing the SHIFT key
  831. 3. Double click with the Mouse (Word marking)
  832.    Automatically selecting in "Search/Replace" or "Function keys..."
  833. 4. Double click with«by the Mouse, while pressing SHIFT key (Line marking)
  834.  
  835. Now can the familiar Cut-, Copy- and Paste functions take place.
  836. By "Information" (^I) you can see the Size (of) the marked Block in number of
  837. letters, lines and pages. A cut or copied Block remains in the Buffer until you
  838. replace it with a new Block operation. For instance, the Block in the buffer can
  839. always again be inserted.
  840.  
  841. When  a  Block is marked, it is immediately replaced by the newly selected one
  842. assuming that the Cursor is still located within the Blocks.
  843.  
  844. The  Column block mode is not in the Position to generate new lines. When
  845. you  so  on the End of text Column blocks want to add lines, you must
  846. before(hand) once or several times press the RETURN key.
  847.  
  848. 4.1. The Column setting
  849. --------------------
  850.    Sometimes it happens that     Activate the Column-
  851.    you want multiple columns     block and mark the
  852.    in your text (the way that    second   Column  as a
  853.    Newspapers usually are.       Block. Copy It in(to)
  854.    Write the text Columns        the Clipboard. Position
  855.    first of all with e.g. a      the Cursor at the
  856.    line length of 27. With       appropriate  Place
  857.    Help of the Column blocks     beside the first  Column
  858.    copy the second Column and    and place the Block from
  859.    place it beside the first.    the Clipboard again.
  860.  
  861. This way you can even make three columns if you wish. This Procedure is by using
  862. the Column block right simple and fast to do.
  863.  
  864. 4.2. Numeric Operations
  865. ---------------------------
  866. In Connection with the Column block is it possible,
  867. to do simple Calculating.
  868.  
  869. Procedure:
  870.  
  871. 1. Switch to the Column block mode
  872. 2. Mark a Number column
  873. 3. Operate one of the Mathematical menu selections
  874.  
  875. The Outcome becomes in a Box highlighted as well as copied into the Clipboard
  876. and can by "Insert" be copied in(to) the Text.
  877.  
  878. The result is shown to two  Decimal places, because the calculation method is
  879. based on the normal money calculations.
  880.  
  881. Mathematical Action of the Calculation methods:
  882.  
  883. 1. average
  884.  
  885.           n
  886.  _   1   --
  887.  x = -   \   x
  888.      n   /    i
  889.          --
  890.         i=1
  891.  
  892. 2. Standard deviation
  893.  
  894.            n
  895.       1   --      _
  896. s = ---  \  (x - x)
  897.      n-1  /    i
  898.           --
  899.          i=1
  900.  
  901. Note:
  902. It is possible, that 7UP here can deliver faulty Results,
  903. when gaps exist in the marked Column. e.g.:
  904.  
  905. Numbers:
  906.             1.0
  907.             2.0
  908.             3.0
  909.             4.0
  910.             5.0
  911. ----------------
  912. Number:     5
  913. Sum:     15.00
  914. Average : 3.00   Correct Outcome
  915.  
  916. Numbers:
  917.             1.0
  918.             2.0
  919.                 <-  Here a Number is missing!
  920.             4.0
  921.             5.0
  922. ----------------
  923. Number:     5     <- 4
  924. Sum:     12.00
  925. Average : 2.40  <- 3: False Outcome
  926.  
  927. The  Column of numbers should be uninterrupted. 7UP is not a normal
  928. Calculation program.  For the Results display the internationally used
  929. decimal point is shown.
  930.  
  931. 5. Search and Replace
  932. ----------------------
  933. A special Strength of 7UP is its Search and Replace of Text passages.
  934. 7UP  provides  efficient Functions from the Unix*-World. Exact descriptions of
  935. these functions are given below.
  936.  
  937. Open the"Search/Replace..." dialog from the menu (or by ^F).
  938.  
  939. In the first  of the two Input fields type in the String to be found. In the
  940. second field you may type in a replacement string if needed.
  941.  
  942. Which Search mode used  is determined by which of the round radio buttons you
  943. choose to activate. The square checkoff boxes (if not disabled for the
  944. operation you have chosen) provide other important search criteria choices.
  945. If boxes are disabled (not pertinent to the current operation), they will show
  946. as 'grayed out' or faint.
  947.  
  948. When a Block is marked, so interprets 7UP, whether a search-ender expression is
  949. marked, or whether in the Block itself marks the search range. If the Block is
  950. several Lines long, it is interpreted as the Search range. If it is only one
  951. Word or at most one Line, so must it the to search end expression be. You can
  952.  see
  953. by the way the small boxes are already marked when you open the dialog.
  954.  
  955. 7UP provides three Search modes:
  956.  
  957. 5.1.  The GREP-Function  (Get  Regular  ExPression).
  958. GREP seeks a Pattern in the Text, the exact Composition of which is not known.
  959.  
  960. You want For example to find all Words in the Text, that  instead of with the
  961. Umlaut 'ü', are written with "ue". (German) words like "Quelle" or "Aktuell"
  962. for instance are not written with "ü", and if you don't want to find them, you
  963. can use as the Search pattern "[^Q]ue[^l]" (do not use the Quotation marks, as
  964. they are only used in this text to distinguish what you must type in).
  965.  
  966. "ue"  is placed  there  for  the Umlaut substitute, and the angular Brackets
  967. contain the Letters whose Finding should be avoided. It  means  this:
  968. search for all "ue" not preceded by "Q" and followed by 'l'. '^'  indicates that
  969. the Character following it is not to be found. No Distinction is made between
  970. Large- and Small-letters. If you wish to find  all "ue" that are not umlaut
  971. substitutions, use "[Q]ue[l]" to specifically search for "Quelle" or  "Aktuell".
  972.  
  973. Because here now there is no '^' within the Bracket, you are Including the
  974.  bracketed
  975. letters in your search instead of excluding them.
  976.  
  977. There gives it basically the Problem, that you must know exactly which Words
  978. the search pattern will find and which it will not.  Using this  Pattern a Word
  979. like "Suelze" falls through the Net, even though an 'l' does come after "ue".
  980. We must therefore expand the Search pattern.  We  search  now all "ue" without
  981. 'Q' before it and without 'l' after, but after 'l' allows a 'z' to be.
  982. Search for "ue[l][^l]" and hope that "Suelze" now is found.
  983.  
  984. A second Example:
  985. You may in Your Text want to find all '/', where a Digit precedes, and then a
  986. Letter follows it. e.g. to find "22/BR" but not "138/0.5". The Search pattern
  987. is then "[0-9]/[a-z]". Before the '/' are only Digits, behind the '/' only
  988. Letters are allowed. As an alternate pattern you may use ":d/:a".
  989. For explanation see below
  990.  
  991. A third Example:
  992. You want to find all words that begin with one digit, Like the word "7UP".
  993. Here a preceding space is expected, so the search pattern is ": [0-9]".
  994.  
  995. Fourth Example:
  996. You want to find all punctuation that comes at the end of a line.
  997. e.g. Line ending  with '.'.  Type in "\.$". Consider that the '.' is a
  998. Special character and must be in quotes. The '$'-Character is used for the
  999. Line  end, and must naturally also be at the End (of) the regular expression.
  1000. When you want to find  all  Punctuation at the Line  end, type in "[,;.:!?]$".
  1001. (This is actually not a Comic-Chimpanzee-word!)
  1002.  
  1003. Note:
  1004. The  Quotation marks  before  and after the Examples just serve to
  1005. distinguish the examples within this Documentation.
  1006.  
  1007. The  Regular expression describes the Pattern to search for. It makes no
  1008. Distinction between Large and Small text. The Search possibilities correspond
  1009. with the technical Base and not the full Extended perfomance (of) the
  1010. Unix*-Program GREP.
  1011.  
  1012. Here is a List of those Special characters, that with the precise Wording use
  1013. as Search criteria is possible:
  1014.  
  1015. '.'    The period is placed for a desired Character.
  1016.  
  1017. '^'    The Caret is placed for the Line start (implemented, but not
  1018.        functioning; must however be quoted. see below).
  1019.  
  1020. '$'    The Dollar sign is placed for the Line  end.
  1021.  
  1022. '\'    The  Backslash  quoted  each  Characters. For the '.'-Characters self
  1023.        represent  to can, write "\."; just as "\\", "\^", "\$".
  1024.        Special characters must basically quoted become.
  1025.  
  1026.        The  Colon  describes  the Class (of) the  search ender Characters.
  1027. ':a'   is placed for an alphabetic Characters,
  1028. ':d'   for a Digit,
  1029. ':n'   for an alphanumeric Characters,
  1030. ':.'   for Punctuation,
  1031. ': '   for Space.
  1032.  
  1033. '*'    When  a  Character is followed by a '*', that means that the last
  1034.        Character entered is allowed any number of repeats.
  1035.        "fo*" finds "f", "fo", "foo", "fooo" etc.
  1036.  
  1037. '+'    As '*', however must the last Character at least once appear.
  1038.        "fo*" finds "fo", "foo", "fooo" etc.
  1039.  
  1040. '[]'   Character set.
  1041.        A Character string  in(to)  angular  Brackets  is placed  for exactly
  1042.  these
  1043.        Characters,  but no other.  When  the first Character is a '^'
  1044.        these Characters are excluded from the Search. e.g.: "[XYZ]"
  1045.        is placed  for  "XX"  and "ZYX", during "[^XYZ]" indeed "ABC" is not but
  1046.        "AXB" is found.  A Character string range can by '-' specified become.
  1047.        Take note of  It please,  that  [a-z] will find all alphabetical
  1048.  Characters,
  1049.        but [z-a]  in general no alphabetic Characters will find. Digits become
  1050.        by  [0-9] specified. There are also Limitations possible, e.g. [7-9]
  1051.        (so only 7,8,9). The same holds true for Letters, e.g. [m-e] or
  1052.  [^a-bd-z?]
  1053.        seek only the Letter 'C', all Digits, as well as Special characters
  1054.        except '?'. The Sequence of the Characters in the Bracket plays no Role.
  1055.  
  1056. In the Help box you can review these Special characters and their Meanings.
  1057.  
  1058. Note:
  1059. The Special characters are not separately interpreted  within the Character
  1060. string; the Caret '^' becomes only then as Negation allowed, when it is
  1061. placed at the start (of) the Character string (immediately after the '[').
  1062. The '$' is evaluated correctly only if it is the last character of the string.
  1063. '^' for the Line start is implemented, but is not functioning, because after a
  1064. Found set within a Line still more sought after becomes, and therefore the
  1065. GREP-Function becomes confused trying to start a new line.
  1066.  
  1067. Note:  The Search using regular Expressions is not trivial and requires a
  1068. certain amount of practice. It can even be, that certain uses of it will
  1069. remain beyond your grasp becuase you cannot formulate a search  pattern that
  1070. will yield the desired result. GREP is really not "find all".
  1071.  
  1072. 5.2. The Match function.
  1073. This is a familiar MS-DOS function, which in 7UP can take wildcards, preferably
  1074. '*' and '?'.
  1075. Take an example where we have a list with Article numbers before itself,
  1076. and may well need to search out all typical numbers for a certain sample group.
  1077. e.g.: 99XXX450, where XXX for three variable Digits is placed.
  1078. You therefore type as Search pattern "99???450". Here gives it now a
  1079. Specificity, that the search will find "99???450" ONLY if in the Line ONLY
  1080. those characters are placed.
  1081.  
  1082. Of course we do not expect these to be the only characters on a line, so We
  1083. expand the Search pattern by using the Format "*99???450*".
  1084.  
  1085. The Stars before and after the Numbers stand for any number of any characters.
  1086. The Wildcards are therefore '?' for one desired Characters and '*' for any
  1087. number of Characters. When you now want to search forprecisely for '*' or '?',
  1088. you must then change the Wildcards. You can replace the default wildcards in
  1089. the appropriate input field of the dialog box. It is important to note that
  1090. whatever character you use for the wildcard will not be found in the text by
  1091. that wildcard.
  1092.  
  1093. You  can also search for Text passages at the Beginning of the Line, as well
  1094. as at the End, when you appropriately restrict the Wildcards. Do you want to
  1095. search for a number at the beginning of the line? Type in "99???450*". At the
  1096. End of the line would be "*99???450". Here also you will find the concept
  1097. easier as you gain experience.
  1098.  
  1099. The Quotation marks before and after the Examples are naturally  not typed in,
  1100. they serve only the Distinguishing marks within this Documentation.
  1101.  
  1102. Note concerning GREP and Match:
  1103. Basically these functions are not useful if you want to automatically replace
  1104. one character string with another, because the exact length of the search
  1105. function is not fixed, and replacement in such cases can chaotically deform the
  1106. text. The wildcard functions should be used only for Search.
  1107.  
  1108. 5.3. Search.
  1109. Here the search pattern must exactly be matched. Only with this function is
  1110. replacing possible. You may search from the current cursor position, from the
  1111. start of the text, or only within a marked block. You control the Search
  1112. configuration using the checkoff boxes in the dialog. When a certain
  1113. combination is not possible, the appropriate checkoff boxes are disabled. They
  1114. are displayed in light gray and you cannot operate them.
  1115.  
  1116.  
  1117. 5.4. Replace
  1118. Hereby  becomes the found Text passage replaced by the substitute you have
  1119. chosen.
  1120. If you want to delete one or a string of words in the text, type in the word(s)
  1121. as the Search parameter, and leave the Replace parameter blank. If you want to
  1122. replace all occurrences without checking thier contexts, check the button
  1123. 'all'. By checking 'ask before', you instruct the program to stop at each
  1124. occurrence to ask you if you want to make the replacement. Should you wish to
  1125. change the replacement at that point, you may do so by changing it in the alert
  1126. box.
  1127.  
  1128. 6. The Print menus
  1129. -----------------
  1130. There are two Print menus. One for visually Shaping the Print page with
  1131. e.g. Header and Footer lines, a for the technical printing Aspects.
  1132.  
  1133. 6.1 Page layout
  1134. ----------------
  1135. You can configure the following Parameters for the Page size:
  1136.  
  1137. 1. Line length   (same for Header or Footer)
  1138. 2. left Margin   (e.g. Book margin)
  1139. 3. Page length   (12" = 72 Lines, DIN A4 = 70 Lines, 11" = 66 Lines)
  1140. 4. Top Margin    (unprinted)
  1141. 5. Header        (see below)
  1142. 6. Footer        (see below)
  1143. 7. Bottom Margin (unprinted)
  1144.  
  1145. Produces: The number of printable Lines (six Lines per 2.54mm).
  1146.  
  1147. For the Shaping of the Texts you can change Header and Footer lines as well as
  1148. the Page size in many dimensions. On Header and Footer lines you can insert
  1149. the following variables using the Function keys:
  1150.  
  1151.    %H = Hour
  1152.    %M = Minute
  1153.    %S = Second
  1154.    %T = Day
  1155.    %M = Month
  1156.    %J = Year  (2 places)
  1157.    %W = Weekday (Sunday, Monday, ...)
  1158.    %D = Day in the Year
  1159.    %F = complete Pathname of the current File
  1160.    %F = Name of the current File
  1161.    %P = Page number
  1162.  
  1163. The Positioning of Headers or Footers (left, right, centered) is chosen with
  1164. the round Buttons.
  1165.  
  1166. The Help box displays these Variables, if you should need a reminder.
  1167.  
  1168. Under  "Page format" you can configure the Size (of) the Printer paper.
  1169.  
  1170. For various tasks different layout settings are needed. You can save the page
  1171. layouts and load them as needed. The filename may be anything you want, but it
  1172. should be given the extension "LAY". The default layout file is named "7UP.LAY"
  1173. and 7UP attempts to load this file at startup. If you want to use a certain
  1174. layout file as your default, rename that file as "7UP.LAY". The name of the
  1175. layout file in use is highlighted at the right top of the 'Page Layout' dialog.
  1176.  
  1177. 6.2 Print
  1178. -----------
  1179. After you have installed the Layout for your Documents, you can now begin with
  1180. the printing. Set "Numbering", "Pages" and "Options" according to your needs.
  1181.  
  1182. "Numbering"
  1183.  
  1184. 1. XXXX Page number offset
  1185.    Use, for instance, when you have a title page that should not be numbered.
  1186.  
  1187. 2. XXXX First Print page
  1188. 3. XXXX Last Print page
  1189.    State the range of pages to print.
  1190.  
  1191. 4. XXX First Text column
  1192. 5. XXX Last Text column
  1193.    State the Text column, from and to that you want to print. Quite useful in
  1194.    a multicolumn page when you want to print one column as a 'clip'.
  1195.  
  1196. "Options" used to Configure the Spooler CALCLOCK:
  1197.  
  1198. 1. PRINT TO FILE...
  1199.    The print output is linked into a file, and the FSB automatically assigns a
  1200.    filename. This function is useful when you want to be able to see what the
  1201.    printed output will look like without wasting paper actually printing it.
  1202.  
  1203. 2. PRINT IN BACKGROUND
  1204.    7UP  can by using the Desk accessory CALCLOCK print Files in the background
  1205.    while you continue to use the computer. CALCLOCK.ACC must be installed for
  1206.    this to work. See CALCLOCK.DOC.
  1207.  
  1208. 3. DELETE SPOOL FILE
  1209.    CALCLOCK  produces a Temporary file, which after printing may be deleted.
  1210.  
  1211. 4. XX COPIES(n)
  1212.    XX  is  the number of copies you want CALCLOCK to print.
  1213.  
  1214.  
  1215. In "Page format" you can configure the Organization (of) the Entire text.
  1216.  
  1217. 1. HEADER AND FOOTER AFTER FIRST PAGE
  1218.    When you want the header and/or footer to only appear on the first page,
  1219.    turn this OFF.
  1220.  
  1221. 2. ALTERNATE PAGE LAYOUT
  1222.    Header and footer loacation (unless centered) will be alternated depending
  1223.    on whether a left or a right page is being printed.
  1224.  
  1225. 3. TRUNCATE LONG LINES
  1226.    If you want to avoid having the printer 'wrap around' lines that are longer
  1227.    than the permitted line length, (possibly confusing the Layout, you can
  1228.    truncate overlong lines in printing.
  1229.  
  1230. 4. PRINT ALL PAGES
  1231. 5. PRINT ONLY EVEN PAGES
  1232. 6. PRINT ONLY ODD PAGES
  1233.    When you want to print on both sides of the paper, you can print only the
  1234.    odd pages first, then re-feed the reverse side of the pages to print the
  1235.    even pages.
  1236.  
  1237. 7. EJECT LAST PAGE
  1238.    When you are not printing footer lines, activate this box to send the
  1239.    printer a formfeed command when printing terminates.
  1240.  
  1241. 8. PAUSE BETWEEN PAGES
  1242.    Wait for an individual sheet feed after each page. You can also quit
  1243.    printing during this wait state if desired.
  1244.  
  1245. You can abort printing at any time by pressing the ESCAPE [Esc] key.
  1246.  
  1247. 7. The Desktop icons
  1248. -------------------
  1249. On the Desktop background the following Icons are accessible:
  1250.  
  1251. 1. maximum of seven Text icons
  1252. 2. the Trashcan
  1253. 3. the Printer
  1254. 4. the Disk drive
  1255. 5. the Clipboard
  1256.  
  1257. The  Icons  can be freely positioned. Moving the Icons functions just as it does
  1258. on the GEM Desktop.
  1259. With the Rubberband lasso you can group-select more than one Icon. By holding
  1260.  the
  1261. SHIFT key while clicking on icons, you can group-select more than one icon.
  1262. Icons  react  on Single and Double clicks. By single-clicking you activate the
  1263. icon(s) for use with menu selections of the "File" menu, e.g. "Information...".
  1264.  
  1265. Double-clicking an icon opens it.
  1266. 1. the text icon opens a text window
  1267. 2. the trashcan opens the FSB for a "Delete" operation
  1268. 3. the Printer opens the FSB for a "Print File" operation using the spooler
  1269. 4, the disk drive opens the FSB for an "Open File" operation
  1270. 5. the Clipboard opens the SCRAP.TXT Clipboard file
  1271.  
  1272. Dragging a file icon to the printer, disk drive or trashcan, automatically
  1273. causes the appropriate action to be executed. Dragging a file icon to the
  1274. Clipboard copies its entire text to the Clipboard.
  1275.  
  1276. Also you can Expand the function of the Clipboard by Pressing the SHIFT key.
  1277.  
  1278. You can drag a File icon into a Window, and that file will be merged into the
  1279. window document at the cursor position exactly as it is with the menu selection
  1280. "Merge...", assuming that the File has already been saved to disk.
  1281.  
  1282. Dragging the file to the disk drive will Save the file; to the trashcan will
  1283. delete it; to the Clipboard will copy it to the Clipboard.
  1284.  
  1285. You can use the usual wildcards '*' and '?' in making deletions. "*.TXT" erases
  1286. all files with the extension "TXT", and "*.*" erases ALL files, so be very
  1287. careful using the wildcards.
  1288.  
  1289. To operate 7UP under multitasking you must turn off its desktop. These icon
  1290. operations listed above then are not possible. See Chapter 2.1.
  1291.  
  1292. 8. The GEM-Window
  1293. ------------------
  1294. All  Text is in a completely normal GEM-Window presented. The text window is
  1295. renamed in accordance with the name chosen for any "Save as..." operation, so
  1296. any subsequent "Save" reflects the new name.
  1297.  
  1298. The following information is displayed in the "Info" line at the top of the
  1299. window:
  1300. 1. Program name (during 7UP Operation without Desktop)
  1301. 2. '*' shows that text has been changed since the last Save
  1302. 3. "P:" = current Page (dependent on Page layout)
  1303. 4. "L:" = current Line
  1304. 5. "C:"  = current Column
  1305. 6. "l:" = Length of the Line in which the Cursor is placed
  1306. 7. Tab:" = number of spaces in the Tabs
  1307. 8. "W:" = Line wraparound column
  1308. 9. State of the CAPSLOCK key (CAPS = Caps on; nothing displayed = Caps off)
  1309.  
  1310. To move quickly among several open windows, use the shortcut '^W'. In the
  1311. Window menu you can choose your preferred configuration for multiple windows.
  1312.  
  1313. 8.1. The Dialog boxes
  1314. --------------------
  1315. Use of the dialog boxes is pretty much standard. All of the radio buttons and
  1316. checkboxes with help of the ALTERNATE key and the underlined letters are
  1317. accessable by keyboard. Actually you can even click on the text following the
  1318. radio buttons and checkboxes as they have been made mouse-clickable zones.
  1319.  
  1320. Aborting an operation can be accomplished using the "UNDO key, and help
  1321. obtained by pressing the HELP key. These conveniences have become a current
  1322. standard for ST programs.
  1323.  
  1324. You can shift the dialog boxes to a more convenient screen position by moving
  1325. the cursor to the dialog box's "donkey's ear" and dragging the dialog box as
  1326. you would a Desktop icon. By holding down the SHIFT key as you do this, the
  1327. dialog box becomes transparent. This is a quick way of checking what is "under"
  1328. the dialog box.
  1329.  
  1330. 7UP works flawlessly with LETEMFLY.
  1331.  
  1332. If you hold down SHIFT when you reopen a dialog box that has been moved, it
  1333. reopens in the original centered position.
  1334.  
  1335. 9. The Clipboard
  1336. -----------------
  1337. This is a chapter describing the operation of the Clipboard.
  1338.  
  1339. The Clipboard occupies its own folder, preferably in the root directory of the
  1340. boot partition of your hard disk or on the floppy disk in drive A: if you do
  1341. not use a hard drive. In this folder cut or copied data of any type
  1342. (in 7UP, text) can and should be recorded for the current program or any other
  1343. program to use. The folder is shown as "\CLIPBRD".
  1344.  
  1345. So all Cut and Copy operations divert data into this folder and into its file,
  1346. "SCRAP.TXT", and all Paste operations draw from this file.
  1347.  
  1348. Cut and Copy and Paste can of course be done without using the Clipboard, but
  1349. there are some advantages in using the Clipboard. For instance, by holding down
  1350. SHIFT as you Cut or Copy, the Cut or Copied block is appended to the already
  1351. existing \CLIPBRD\SCRAP.TXT file. Subsequent Paste operation wil then insert
  1352. the entire contents of SCRAP.TXT at the cursor position. If you don't hold down
  1353. the SHIFT key at the next Cut or Copy, SCRAP.TXT is once again overwritten in
  1354. the operation and the prior contents is thereby purged.
  1355.  
  1356. Block Delete operations hold the deleted range in the Clipboard, so you can
  1357. cancel the deletion with UNDO. The same holds true for line deletion using
  1358. CONTROL-Y, as long as the cursor remains located in the current line.
  1359.  
  1360. If no \CLIPBRD folder exists, 7UP will automatically create it and log it into
  1361. GEM. Atari ST users without hard disks will see a certain loss of speed during
  1362. Clipboard operations. Like all other application programs, 7UP shows to its
  1363. best advantage using a hard disk.
  1364.  
  1365. When the Clipboard is not activated, all Cut or Copied blocks or lines are
  1366. buffered in RAM and can be reinserted from there.
  1367.  
  1368. 10. Technical Details
  1369. ----------------------
  1370. For Experts and those who want to become experts.
  1371.  
  1372. 10.1
  1373. 7UP is in the Position to take Parameters in three different ways.
  1374. 1. in the normal way in the basepage
  1375. 2. according to the so-called EXARG-Method(ARGV=).
  1376. 3. by 'shell_read()'.
  1377.  
  1378. It  can up to to seven Parameters simultaneous be assigned. When the
  1379. Desktop lets you, can It so up to to seven Text files simultaneously
  1380. on the Icons of 7UP pull, and 7UP with them start.
  1381.  
  1382. 10.2
  1383. 7UP is able to communicate with the Desk accessory CALCLOCK.
  1384. CALCLOCK  places a built-in Printer spooler that will print ASCII text from a
  1385. background buffer. The standardized DRI protocols are used.
  1386.  
  1387. Filename to ACC send:
  1388.  
  1389.          accid=appl_find("CALCLOCK");                    /* Program-ID */
  1390.  
  1391.          msgbuf[0]=100;                                    /* Sendcode */
  1392.          msgbuf[1]=gl_apid;                              /* own apid */
  1393.          msgbuf[2]=-1;
  1394.          msgbuf[3]=strlen(filename);
  1395.          msgbuf[4]=(unsigned int)((long)filename >> 16);
  1396.          msgbuf[5]=(unsigned int)((long)filename & 0xffff);
  1397.          msgbuf[6]=1;                              /* Number of Copies */
  1398.          msgbuf[7]=0;       /* After Print: 0=not delete, 1=delete */
  1399.          appl_write(accid,16,msgbuf);
  1400.  
  1401. The  FILENAME must static be. It allows not topical on the Stack produce
  1402. became  be. Dynamic allocated Variables are likewise problematic, because
  1403. at least one Event must be awaited, before you again "free"ed become.
  1404.  
  1405. After successful ReceiptCALCLOCK sends the MSG 101 to msgbuf[0].
  1406.  
  1407. 10.3
  1408. 7UP supports (AMC)GDOS*. When GDOS is loaded, only nonproportional GDOS fonts
  1409. can be used. GDOS is not a part of 7UP. You may obtain GDOS (or AMC-GDOS) from
  1410. various sources.
  1411.  
  1412. <Translator's note: The author here goes into a detailed description of how to
  1413. set up GDOS. Since the time the original DOC was written, Atari has released
  1414. FONTGDOS, which obsoletes the section. Therefore I have left it out.>
  1415.  
  1416.  
  1417. Still in 1991 FSMGDOS should appear. It gives us Vector fonts, the quality of
  1418. whioch should put competitive products in the shade. We can hope that the new
  1419. FSMGDOS will bring order into the chaos that GDOS now represents, and that all
  1420. software packages will support it. 7UP will be updated to support FSMGDOS when
  1421. it becomes available.
  1422.  
  1423. <Translator's note: We are ever the optomists - here it is 1993 and we await
  1424. SPEEDO GDOS, which should "solve all our problems".>
  1425.  
  1426. 10.4
  1427. 7UP  bends no Vectors whatsoever and has therefore also no XBRA-problems.
  1428.  
  1429. 10.5
  1430. 7UP  has been for Operation on the TT appropriately
  1431.  modified, i.e. fast-LOAD- and TT-Ramflags are appropriately set.
  1432.  
  1433. 11. The TURBO-C HELP Accessory
  1434. ------------------------------
  1435. 7UP supports the "TURBO-C HELP Accessory". Mark a C-Keyword and operate the
  1436. HELP-Key.
  1437.  
  1438. For exact instructions in using TC_HELP.ACC, see the user's manual for that
  1439. program. TC_HELP.ACC supports the GEM-Clipboard, so you may move the help text
  1440. or programming info from it into your text as desired. TC_HELP.ACC is not
  1441. included in the 7UP archive, but may be freely copied and used. You should be
  1442. able to find it on public bulleting board systems.
  1443.  
  1444. 12. Trips and Ticks.
  1445. --------------------
  1446. Tabs:
  1447. When you open a document which has used tabs of other than 3, 5, or 8 spaces,
  1448. the document may not display the correct appearance. That is because 7UP uses a
  1449. default of 3 spaces for a tab. To bypass 7UP's default, you may open a new
  1450. (empty) window, adjust the tabs for that window as needed, then load the fille
  1451. as a Block. Your tabs will then appear correctly.
  1452.  
  1453. INF-File:
  1454.  
  1455. You can write-protect the 7UP.INF file, then any changes made in the 7UP
  1456. configuration wil not be saved.
  1457.  
  1458. Printer:
  1459.  
  1460. If you use a Hewlett-Packard DeskJet 500 printer, you should turn OFF the
  1461. perforation skip (DIP-switch A8). When printing a block, do so while holding
  1462. down the SHIFT key to have the printer eject the page after finishing printing.
  1463.  
  1464. It is generally recommended that you hold the SHIFT key while loading a text in
  1465. order for 7UP to use the IBM-compatible 'ß'. See Chapter 2, "Open...".
  1466.  
  1467. If you have a problem with the automatic pagelength, you can set 'hard' page
  1468. breaks by inserting formfeeds (FF). The formfeed character must be the olnly
  1469. character on the line. These formfeeds are not reflected in the page numbering
  1470. in the info line of your text window.
  1471.  
  1472. 13. Four Word
  1473. --------------
  1474. Here are four Words.
  1475.  
  1476. 14. Greeting
  1477. ------------
  1478. I wish you much enjoyment in your use of 7UP
  1479. Michael Thänitz
  1480.  
  1481. --------------------------------------------------------------------------
  1482. *GEM is a Trademark of Digital Research Inc.
  1483. *Gemini is a Shareware program from Gereon Steffens and Stefan Eissing.
  1484. *GDOS is a Trademark of Atari Corp.
  1485. *AMCGDOS is a Program from Arndt Beißner.
  1486. *Unix is a Trademark of AT&T.
  1487. *MultiGEM is a Program from PAM-Software.
  1488. *IBM is a Trademark of International Business Machines Corp.
  1489.  
  1490.       This document translated into English by Mike Valent, April 1993
  1491.             I assume no liability for any errors in translation