home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / fld-qd20.lha / qed_v2.0_cr / documents / Startup < prev   
Encoding:
Text File  |  1996-02-10  |  12.1 KB  |  295 lines
  1.                                    QED
  2.                                 Version 2.0
  3.  
  4.                Copyright © 1988-1990 by Darren M. Greenwald
  5.                   Copyright © 1996 by Phillip M. Wright
  6.                             All rights reserved
  7.  
  8. ======================================================================
  9.                                REQUIREMENTS
  10. ======================================================================
  11.  
  12. KICKSTART - 2.04 or higher
  13.  
  14. RAM - 256K RAM or more.
  15.  
  16. STACK USAGE - A minimum stack size of 10000 bytes is required.
  17.  
  18.  
  19. ======================================================================
  20.                         MAKING A BACKUP COPY OF QED
  21. ======================================================================
  22.  
  23.  
  24.      The first thing you should do is make a backup copy of QED, and any
  25. associated files.  If you don't know how to do this, you should read
  26. through the owner's manual shipped with your Amiga before using QED, or any
  27. other program.
  28.  
  29. ======================================================================
  30.                               INSTALLATION
  31. ======================================================================
  32.  
  33.      QED is not copy protected, and can be easily copied to any floppy
  34. disk, or hard drive.  QED is a stand-alone program, and easily installed.
  35.  
  36. CLI USERS:
  37.  
  38.      It is recommended you copy QED to the C: directory.  QED may be
  39. renamed to something else if you prefer.
  40.  
  41. WORKBENCH USERS:
  42.  
  43.      Simply drag the QED icon to any Workbench drawer.
  44.  
  45.  
  46. ======================================================================
  47.                     STARTING QED FROM THE WORKBENCH
  48. ======================================================================
  49.  
  50.      As a reminder, "QED" the program is a Workbench TOOL while the files
  51. it creates are known as Workbench PROJECTS.  There are a number of ways to
  52. start QED from the Workbench including:
  53.  
  54.  
  55. Double click on the QED TOOL icon -
  56.  
  57.     QED will open a single untitled text editing window.
  58.  
  59.  
  60. Double click on a PROJECT icon created by QED -
  61.  
  62.     QED will open a single text editing window, and open the
  63.     PROJECT.
  64.  
  65.  
  66. Multiple select PROJECTS created by QED -
  67.  
  68.     QED will open one, or more text editing windows, and attempt to
  69.     automatically open each of the highlighted PROJECTS.  The PROJECTS may
  70.     exist may exist in different DRAWERS.  Up to sixteen (16) project
  71.     files can be automatically opened using multiple selection.
  72.  
  73.  
  74.  
  75. ======================================================================
  76.                          STARTING QED FROM THE CLI
  77. ======================================================================
  78.  
  79.  
  80.      QED can be started from the CLI like any other program.  It is assumed
  81. that the reader who uses the CLI is already familiar with how to run
  82. programs from the CLI.
  83.  
  84.      Up to sixteen (16) filenames may be entered as command line arguments. 
  85. In this case QED will attempt to automatically open each in a separate text
  86. editing window.  If no filename is specified, then a single untitled text
  87. editing window is opened.
  88.  
  89.      There are a number of startup switches that can be included on the
  90. command line along with a list of file names.  These switches are
  91. documented further on in this manual, and can be included on the command
  92. line along with the list of filenames in any order.
  93.  
  94.  
  95. ======================================================================
  96.                         MAKING QED RESIDENT
  97. ======================================================================
  98.  
  99.      If you are using the Amiga Shell, QED is fully reentrant which means
  100. it can be made RESIDENT, and run multiple times without having to reload
  101. QED.  As a reentrant program QED requires a moderate size stack of at least
  102. 10000 bytes.  A memory savings technique is used which allows subsequent
  103. resident QED processes to use less memory; all memory is returned to the
  104. system when the final resident QED process is quit.
  105.  
  106.      Note that as of this writing, ARP's ARES command doesn't believe that
  107. QED is fully reentrant.  This is a problem with ARP's definition of how a
  108. reentrant program should look, so no attempt has been made to convince ARP
  109. otherwise.
  110.  
  111.  
  112. ======================================================================
  113.                             STARTUP ERRORS
  114. ======================================================================
  115.  
  116.      QED may not be able to run for a number of reasons.  In this case QED
  117. returns an error code to the CLI, and displays an error message in the CLI
  118. window, or a temporary window if started from the Workbench:
  119.  
  120. Error #    Description                                      
  121.  
  122. 20         Stack too small (10000 minimum)
  123. 21         Need KickStart 2.04, or higher
  124. 22         Cannot use system font
  125. 23         Error opening console.device
  126. 24         Not enough memory
  127. 25         Port name already in use
  128. 26         Unable to create ARexx port
  129.  
  130.  
  131. ======================================================================
  132.                             STARTUP MACROS
  133. ======================================================================
  134.  
  135.  
  136.      When QED is started it will by default automatically attempt to
  137. execute a QED macro called "startup", and an ARexx macro called
  138. "startup.qed".  Specifics on writing startup macros will be discussed in a
  139. separate document. 
  140.  
  141.      In addition, it is worth mentioning now that you can write macros
  142. which will be automatically executed when a file is opened based on the
  143. filename's extension.
  144.  
  145.      These auto-executing macros allow you to configure QED to suit your
  146. default preferences, as well as customize each text editing window based on
  147. the kinds of files you are working with.
  148.  
  149.      The startup macros are optional.  If they are not found, or ARexx is
  150. not available, these features are ignored.
  151.  
  152.  
  153. ======================================================================
  154.                          STARTUP SWITCHES
  155. ======================================================================
  156.  
  157.      There are a number of startup switches which may be entered from the
  158. CLI, or included in QED's Workbench icon as 'tooltypes' which allow you to
  159. control QED's macro capabilities.
  160.  
  161.  
  162. OPENING A PUBLIC AREXX PORT
  163. ----------------------------------------------------------------------
  164.  
  165. CLI: -P[optional port name]          Workbench: PORT=[optional port name]
  166.  
  167.      This switch tells QED that you want it to open a public ARexx port. 
  168. The public ARexx port is not needed to run macros from within QED; just if
  169. you want to send commands to QED from another ARexx task.
  170.  
  171.      If the port name is omitted, then QED will create a unique port name
  172. for you such as "QED1", "QED2", "QED3", etc.  If you specify the port name,
  173. such as '-Pmyport', the name is converted to uppercase letters such as
  174. "MYPORT".
  175.  
  176.      The public ARexx port is by default assigned to the first text editing
  177. window opened, and clearly displayed in the window's title bar.
  178.  
  179.  
  180. RUNNING QED AS A HIDDEN BACKGROUND PROCESS
  181. ----------------------------------------------------------------------
  182.  
  183. CLI: -H[optional port name]          Workbench: HIDDEN=[optional port name]
  184.  
  185.      This switch is similar to the -P switch above, and is meant for
  186. advanced users only.  This command allows you to use QED as a hidden text
  187. editing engine by running QED as a hidden background process.
  188.  
  189.      You can send any commands to the ARexx port which you might usually
  190. use, however there is no visible screen activity, no pull-down menus, no
  191. keyboard editing, etc.  This is an excellent way to run well debugged
  192. macros, and in addition your macros may run faster as there is no window
  193. drawing to be done.
  194.  
  195.      You can open the command mode window as part of your startup macro,
  196. and enter commands in command mode.  When the -H switch is used, only one
  197. file can be automatically opened at startup.
  198.  
  199.  
  200. RUNNING AN ALTERNATIVE QED FORMAT STARTUP MACRO
  201. ----------------------------------------------------------------------
  202.  
  203. CLI: -Q[alternative macro]   Workbench: QED=[alternative macro]
  204.  
  205.      This switch allows you to override the default search for a QED macro
  206. called 'startup' in your QED: directory.  If the -Q switch is used alone,
  207. then no startup macro will be run.  If the startup macro is not found, QED
  208. just continues, and sets up using the built-in defaults.
  209.  
  210.      The QED startup macro is always run before the first text editing
  211. window is made visible, and is an excellent way to quickly set-up the
  212. options, colors, keyboard, etc. to suit your preferences.
  213.  
  214.  
  215. RUNNING AN ALTERNATIVE AREXX FORMAT STARTUP MACRO
  216. ----------------------------------------------------------------------
  217.  
  218. CLI: -S[alternative macro]   Workbench: STARTUP=[alternative macro]
  219.  
  220. This switch allows you to override the default search for an ARexx macro
  221. called 'startup.qed'.  If the -S switch is used alone, then no startup
  222. macro will be run.  If the startup macro is not found, QED just continues,
  223. and sets up using the built-in defaults.
  224.  
  225.  
  226. RUNNING THE AREXX STARTUP MACRO AFTER OPENING A TEXT EDITING WINDOW
  227. ----------------------------------------------------------------------
  228.  
  229. CLI: -A                      Workbench: AFTER
  230.  
  231. Normally QED attempts to run your ARexx startup macro before the first text
  232. editing window is made visible.  However there may be times when you want
  233. to run the ARexx startup macro after the first text editing window is
  234. opened (e.g., debugging your startup macro with ARexx's tracing abilities,
  235. or when running an automated sequences of events).  In this case use this
  236. flag to tell QED you want to run the ARexx startup macro AFTER the first
  237. text editing window is made visible.
  238.  
  239.  
  240. ======================================================================
  241.                      FONTS, KEYBOARD, SCREENS, ETC.
  242. ======================================================================
  243.  
  244.      When you start QED, one of the first things it does is take a look to
  245. see what kind of font you are using as your system font.  The pull-down
  246. menus, requesters, and windows are automatically adjusted to make use of
  247. your system font.
  248.  
  249.      The pull-down menus have been designed to fit on a 640x200 screen
  250. using a font as wide as Topaz 9, and as tall as Topaz 11.  QED will not run
  251. if you are using a proportional system font, or reverse path font; it is
  252. after all a text editor, and not a desktop publishing program.  QED also
  253. will not run if your system font is too large; this can result in menus
  254. which when drawn are larger than the screen, and will trash memory outside
  255. of screen memory.
  256.  
  257.      Blitter based fast text rendering routines are built into the program.
  258. These routines make it possible for QED to redraw text at a very fast rate.
  259. Eight bit wide fonts will be rendered the fastest, however these routines
  260. will speed up rendering of fonts of virtually any size.  Those running fast
  261. 68020, or 68030 based machines may wish to turn this feature off from the
  262. command mode as a fast processor can be faster then the Amiga blitter.
  263.  
  264.      Some fonts such as Courier.font can be used, though they are not
  265. true non-proportional fonts.  It turns out Courier.font is marked as a
  266. non-proportional font, which is not entirely true.
  267.  
  268.      The colors used by QED have been selected for visibility on a one bit
  269. plane screen, however support is provided for selecting preferred text
  270. rendering colors far beyond the capabilities provided by the current
  271. generation of Amiga hardware.
  272.  
  273.      QED also uses your system's keymap to decode the alpha-numeric keys on
  274. the keyboard, and dead-keys are supported for those using keymaps which
  275. utilize this capability.  Some keys such as the RETURN key, CURSOR keys,
  276. TAB key, etc., are intercepted by QED, and are not decoded using your
  277. system's keymap (these keys can be remapped using QED commands).
  278.  
  279.      Text editing windows may be opened to the full size of your Workbench
  280. screen; overscan screens, NTSC or PAL displays, and the high res Moniterm
  281. monitor, or 2024 monitor can be utilized by QED.
  282.  
  283.  
  284. ***NOTE***
  285.  
  286. QED's font handling routines have been fully tested with Preferences,
  287. SetFont from David Haynie, and FastFonts from MicroSmiths Inc.  FastFonts
  288. is being distributed with Workbench 1.3, and supports the ability to modify
  289. your system font.
  290.  
  291. When running under version 2.0 of the operating system, QED uses your
  292. default screen font, which is the same font used by CLI windows to render
  293. text.
  294.  
  295.