home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 5 / ctrom5b.zip / ctrom5b / DOS / TEKST / AURORA2 / READ.ME < prev    next >
Text File  |  1995-04-28  |  19KB  |  476 lines
  1.  
  2.            ***  Welcome to The Aurora Editor version 2.0!  ***
  3.                   (C) Copyright 1993-1995 nuText Systems
  4.                       All rights reserved worldwide.
  5.  
  6.  
  7. Note: this version of Aurora is NOT public domain or free software, but
  8. is distributed as shareware for EVALUATION PURPOSES ONLY.
  9.  
  10. Individuals are granted a limited license to use this shareware software
  11. for a 30-day period on a private, non-commercial basis, in order to
  12. decide whether or not Aurora suits their needs. At the end of the 30-day
  13. evaluation period, the individual MUST either purchase a fully licensed
  14. copy of this software, or discontinue using Aurora.
  15.  
  16.  
  17. Introduction
  18. ────────────
  19. Aurora is one of the finest text editors available today. Many hours
  20. have gone into the development and testing of this software. However, we
  21. can only continue to develop and support the software if those who use
  22. Aurora purchase a license for it. Aurora is very reasonably priced, but
  23. it is not free. You may try this software for up to 30 days with no
  24. obligation to pay for using it (subject to the conditions stated in the
  25. Aurora Editor User's Guide). If you continue to use Aurora after the
  26. 30-day evaluation period, you must purchase a fully licensed copy. For
  27. ordering and pricing information, see ORDERFRM.DOC.
  28.  
  29. The Aurora Editor software is owned by nuText Systems or its suppliers
  30. and is protected by United States copyright laws and international
  31. treaty provisions. The Aurora Editor, and The Aurora Macro Language are
  32. trademarks of nuText Systems. All other trademarks and registered
  33. trademarks referenced in this file are the property of their respective
  34. owners.
  35.  
  36. For COPYRIGHT AND PROPRIETARY RIGHTS, LICENSE AND RESTRICTIONS, WARRANTY
  37. DISCLAIMER, US GOVERNMENT RESTRICTED RIGHTS, and TRADEMARK information,
  38. see LICENSE.DOC.
  39.  
  40. Please take a moment to review this file before using Aurora. It
  41. contains helpful information on how to obtain technical support, and
  42. highlights the major new features and changes in version 2.0.
  43.  
  44.  
  45. Disk Contents
  46. ─────────────
  47. NOTE: To reduce the size of the shareware archive, only the 386 version
  48. of Aurora is included in this package. An 8086 version is available from
  49. the Aurora Support BBS. See technical support below for BBS access
  50. details.
  51.  
  52.  
  53. Executable files:
  54.   A.EXE         - Aurora/386
  55.  
  56. Macro Object files:
  57.   A.X           - The editor boot macro
  58.   INSTALL.X     - Installation macro
  59.   LIB.X         - Compiled editor library macro code
  60.  
  61. Macro Source files:
  62.   COLOR.AML     - Color definitions
  63.   CONFIG.AML    - Configuration settings
  64.   DEFINE.AML    - Compile-time declarations, constants, functions
  65.   EXT.AML       - Editor extension source code
  66.   INSTALL.AML   - Installation macro source code
  67.   MAIN.AML      - The main macro source file
  68.   MOUSE.AML     - Mouse definitions
  69.   SYNTAX.AML    - Syntax highlighting definitions
  70.   SYSTEM.AML    - System settings
  71.   TRAN.AML      - Translation sample definitions
  72.  
  73. Other files:
  74.   FILE_ID.DIZ   - Description for BBS's
  75.   LICENSE.DOC   - Copyright, License, and Restrictions
  76.   ORDERFRM.DOC  - Ordering information and order form
  77.   READ.ME       - Introduction and last-minute information
  78.   VENDOR.DOC    - Distribution restrictions
  79.  
  80. Documentation:
  81.   FUNCTION.DOX  - The Aurora Macro Language Function Reference
  82.   LANGUAGE.DOX  - The Aurora Macro Language Reference
  83.   QUICKFUN.DOX  - The AML Function Quick Reference
  84.   REGEXP.DOX    - Regular Expression Searching Reference
  85.   TIPS.DOX      - Miscellaneous User Tips
  86.   USER.DOX      - The Aurora Editor User's Guide
  87.  
  88. Editor styles:
  89.   AUKBD.AML     - Aurora-style keyboard layout and functions
  90.   AUMENU.AML    - Aurora-style menu definitions
  91.   BRKBD.AML     - Brief-style keyboard layout and functions
  92.   BRMENU.AML    - Brief-style menu definitions
  93.   QEKBD.AML     - QEdit/TSE-style keyboard layout and functions
  94.   QEMENU.AML    - QEdit/TSE-style menu definitions
  95.   WPKBD.AML     - WordPerfect-style keyboard layout and functions
  96.   WPMENU.AML    - WordPerfect-style menu definitions
  97.   WSKBD.AML     - WordStar/Borland IDE keyboard layout and functions
  98.   WSMENU.AML    - WordStar/Borland IDE menu definitions
  99.  
  100. Color palettes:
  101.   BLUGREEN.AML  - Blue and green
  102.   FLUORESC.AML  - Fluorescent
  103.   GREENCH.AML   - Green charcoal
  104.   REDBLUE.AML   - Red and blue
  105.   WIMBLEDN.AML  - Wimbledon
  106.  
  107. Macro Utilities and Samples:
  108.   CALCPAD.AML   - a simple calculator pad
  109.   CALENDAR.AML  - Display a popup calendar window
  110.   CLRCHART.AML  - Display a popup color chart window
  111.   COMPRESS.AML  - Find occurrences of a string via folding
  112.   COUNTCHR.AML  - Count characters in a file or block
  113.   COUNTWRD.AML  - Count words in a file or block
  114.   DELBLANK.AML  - Delete blank lines in a file or block
  115.   DELDUP.AML    - Delete duplicate lines in a file
  116.   DRAWBOX.AML   - Draw a box around a mark
  117.   EXAMPLE.AML   - Examples and macro source code fragments
  118.   FULLDATE.AML  - Get the date and time in full-format
  119.   HELPLANG.AML  - Language Reference Topics menu
  120.   HELPUSER.AML  - User's Guide Topics menu
  121.   KEYCODES.AML  - Display various keycodes
  122.   KEYDEF.AML    - Display key assignments
  123.   LONGLINE.AML  - Find the longest line in a file
  124.   MACLIST.AML   - Display a popup menu of macros and macro descriptions
  125.   PALETTE.AML   - Change the color palette
  126.   SCAN2.AML     - Find all occurrences of a string in a directory/filespec
  127.   SUMBLOCK.AML  - Add up numbers in a marked block
  128.   TABS.AML      - Entab or Detab a file or block
  129.   WHERE.AML     - Find all occurrences of a file on your computer
  130.  
  131.  
  132. Technical Support
  133. ─────────────────
  134. Although we will do our best to answer questions for all users, licensed
  135. users will receive higher priority. If you are contacting us with a
  136. problem about the software, please have the following information
  137. available:
  138.  
  139.   - The editor version number and the date of the A.EXE file
  140.   - The operating environment (DOS, OS/2, Windows, etc) and operating
  141.       system version number you are using
  142.   - The names and versions of any memory managers or resident utilities
  143.       you are using in CONFIG.SYS and AUTOEXEC.BAT
  144.   - The amount of memory and disk space available
  145.   - Your computer hardware
  146.  
  147.  
  148. You can obtain technical support or information in the following ways:
  149.  
  150. 1. Call The Aurora Support BBS at (301) 230-1214. The BBS is available
  151.    24 hours a day, 7 days a week, at speeds from 2400 bps to 14,400 bps.
  152.    Use modem settings <N81>.
  153.  
  154. 2. Send EMail to:
  155.      Internet:  71702.1025@compuserve.com
  156.      CIS:       71702,1025
  157.  
  158. 3. Telephone: (301) 468-2255
  159.  
  160. 4. Write to:
  161.      nuText Systems
  162.      P.O. Box 2405
  163.      Kensington, MD 20891-2405  USA
  164.  
  165. Please feel free to contact us at any time to offer comments or suggest
  166. improvements to this product. Many previous suggestions have been
  167. implemented in version 2.0.
  168.  
  169.  
  170. Aurora v2.00e
  171. ─────────────
  172. Version 2.00e is primarily a maintenance release and also includes the
  173. following changes:
  174.  
  175. * New sample utility macros were added to the MACRO subdirectory:
  176.  
  177.     COMPRESS.AML  - Finds occurrences of a string via folding
  178.     MACLIST.AML   - Displays a popup menu of macros and macro descriptions
  179.     SCAN2.AML     - Finds all occurrences of a string in a directory/filespec
  180.     WHERE.AML     - Finds all occurrences of a file on your computer
  181.  
  182. * The following sample macros where removed (ENTAB and VIEWMEM can still
  183.   be obtained from the Aurora Support BBS):
  184.  
  185.     ENTAB.AML
  186.     UTILITY.AML
  187.     VIEWMEM.AML
  188.  
  189. * Fixes
  190.  
  191.  
  192. Aurora v2.00d
  193. ─────────────
  194. Version 2.00d is a maintenance release.
  195.  
  196.  
  197. Aurora v2.00c
  198. ─────────────
  199. Version 2.00c is primarily a maintenance release. A new sample macro
  200. CALCPAD.AML (a simple calculator pad) is also included.
  201.  
  202.  
  203. Aurora v2.00b
  204. ─────────────
  205. Version 2.00b is a maintenance release.
  206.  
  207.  
  208. Aurora v2.00a
  209. ─────────────
  210. Version 2.00a is primarily a maintenance release and includes the
  211. following:
  212.  
  213. * Source code is provided for the installation macro (INSTALL.AML)
  214.  
  215. * New sample macros were added to the MACRO subdirectory:
  216.  
  217.     CLRCHART.AML  - displays a popup color chart window
  218.     CALENDAR.AML  - displays a popup calendar window
  219.  
  220. * Live WordWrap preserves spaces across multiple lines, and now works
  221.   correctly when AutoIndent is OFF.
  222.  
  223. * Fixes
  224.  
  225.  
  226. What's new in Aurora v2.0:
  227. ─────────────────────────
  228. This section briefly highlights some of the new features available in
  229. Aurora version 2.0. For more detailed information, see the Aurora Editor
  230. User's Guide, the AML Language Reference, and the AML Function
  231. Reference.
  232.  
  233. * There have been major performance increases throughout the editor.
  234.   Extensive benchmark testing has shown Aurora v2.0 to be one of the
  235.   fastest editors currently available.
  236.  
  237. * A new, easy-to-use macro language (AML) has replaced the old macro
  238.   language. General features of the new language include:
  239.  
  240.     - New easy-to-learn, highlighted syntax
  241.     - Improved error recovery
  242.     - Greatly increased execution and compilation performance
  243.     - Descriptive function names
  244.     - A revised function set, with many new functions
  245.     - Simplified function parameters
  246.     - More complete documentation with numerous examples
  247.  
  248.   Individual macro language changes are much too comprehensive and
  249.   numerous to list here. See the Aurora Macro Language Reference for an
  250.   overview and tutorial of the new macro language, and the AML Function
  251.   Reference for a full description of macro language functions.
  252.  
  253. * Integrated macro language compilation support moves the cursor
  254.   directly to syntax errors in your macros.
  255.  
  256. * Over 3000 lines of macro language source code, utilities, and examples
  257.   are included. See the .AML files in the main Aurora directory, and the
  258.   .AML files in the MACRO and STYLE subdirectories.
  259.  
  260. * A new Macro Utilities popup menu is accessible from the Macro menu and
  261.   allows you to run several useful macros:
  262.  
  263.     COUNTCHR.AML  - Count characters in a file or block
  264.     COUNTWRD.AML  - Count words in a file or block
  265.     DELBLANK.AML  - Delete blank lines in a file or block
  266.     DELDUP.AML    - Delete duplicate lines in a file
  267.     DRAWBOX.AML   - Draw a box around a mark
  268.     ENTAB.AML     - Customizable Entab macro
  269.     FULLDATE.AML  - Get the date and time in full-format
  270.     KEYCODES.AML  - Display various keycodes
  271.     KEYDEF.AML    - Check key assignments
  272.     LONGLINE.AML  - Find the longest line in a file
  273.     PALETTE.AML   - Change the color palette
  274.     SUMBLOCK.AML  - Add up numbers in a marked block
  275.     TABS.AML      - Entab and Detab a file or block
  276.     VIEWMEM.AML   - Display an area of DOS memory
  277.  
  278. * The new 'pickmacro' <shift f12> command lists all macros in the MACRO
  279.   subdirectory, and allows you to select one for execution.
  280.  
  281. * New comprehensive highlighted documentation is provided in the DOC
  282.   subdirectory, including:
  283.  
  284.     FUNCTION.DOX  - The Aurora Macro Language Function Reference
  285.     LANGUAGE.DOX  - The Aurora Macro Language Reference
  286.     QUICKFUN.DOX  - An AML Function Quick Reference
  287.     REGEXP.DOX    - Regular Expression Searching Reference
  288.     TIPS.DOX      - Miscellaneous User Tips
  289.     USER.DOX      - The Aurora Editor User's Guide
  290.  
  291.   The Help menu has been modified to reflect the new documentation, and
  292.   provides 'topics' menus to help you navigate through the Macro
  293.   Language Reference and the User's Guide.
  294.  
  295. * The hot-keys <shift f1> and <shift f2> allow you to display context
  296.   sensitive help on a macro language function name at the cursor. This
  297.   feature can be very helpful when learning to use the macro language.
  298.  
  299. * FAST Color Syntax Highlighting is now provided, and can be customized
  300.   for almost any programming language, or even text files. See the new
  301.   configuration files SYNTAX.AML and SYNTAX2.AML for syntax highlighting
  302.   definitions based on file extensions.
  303.  
  304. * Words or identifiers in your text can be highlighted in any color
  305.   on-the-fly from within an edit session, by using the new 'Highlight
  306.   Word' <ctrl \> command on the Edit menu. This can can be very useful
  307.   for finding instances of a word in a document, or marking occurrences
  308.   of variables, functions, or other identifiers in your program source
  309.   code.
  310.  
  311. * More complete folding and outlining capabilities have been provided,
  312.   including support for:
  313.  
  314.     - automatic saving and loading of folds as comments in the
  315.         source file
  316.     - opening folds for editing, and closing folds
  317.     - changing the fold description on closed folds
  318.     - optional searching through closed folds
  319.     - exporting files or blocks of text without folds
  320.  
  321.   The edit window Fold menu has been modified to reflect the new folding
  322.   enhancements.
  323.  
  324. * Live, real-time Word Wrap is now available from the Set Menu, in
  325.   addition to the old standard Word Wrap.
  326.  
  327. * A new 'Incremental Search' <ctrl i> command has been added to the
  328.   search menu, allowing you to search for a string one character at a
  329.   time.
  330.  
  331. * A new 'Find Occurrences' <ctrl h> command is available from the search
  332.   menu. This command displays a popup menu showing all the lines in a
  333.   file where a search string is found, and allows you to optionally edit
  334.   these lines in a separate file.
  335.  
  336. * Support for a full range of Regular Expression search and replace
  337.   operators is provided. A new search option 'x' has been added for
  338.   regular expressions, and can be used in the Find, Replace, Scan Files,
  339.   and Find Occurrences prompts.
  340.  
  341. * The number of occurrences of a search string can be counted with the
  342.   new search option 'a'.
  343.  
  344. * A new installation macro guides you through the installation process.
  345.  
  346. * Aurora can now be configured to emulate several other popular editors
  347.   and word processors. You will be prompted to select an editor 'style'
  348.   at installation. The following editor styles are currently available
  349.   in the shareware version:
  350.  
  351.     - Aurora
  352.     - Brief
  353.     - QEdit/TSE
  354.     - WordPerfect
  355.     - WordStar/Borland IDE
  356.  
  357. * You can choose from several new pre-defined color palettes at
  358.   installation:
  359.  
  360.     - Blue and green
  361.     - Fluorescent
  362.     - Green charcoal
  363.     - Red and blue
  364.     - Wimbledon
  365.  
  366. * Three new window settings are associated with each edit window and can
  367.   be toggled ON and OFF from the Set menu:
  368.  
  369.     - Live Word Wrap
  370.     - Syntax Highlighting
  371.     - Undo
  372.  
  373. * Popup history windows are available from any prompt with history by
  374.   entering <pgup> or <pgdn> at the prompt, or by clicking the left mouse
  375.   button on the prompt history tab ().
  376.  
  377. * A new 'File Name Completion' feature has been added for prompts which
  378.   expect filenames to be entered. You can enter <tab> or <ctrl tab>
  379.   within these prompts to display a picklist for a partially entered
  380.   filename or filespec.
  381.  
  382. * A new Two-line box prompt style is included. The prompt style can be
  383.   changed from the Window menu, or by changing the 'PromptStyle' setting
  384.   in CONFIG.AML.
  385.  
  386. * One-line and two-line box prompts can now be resized horizontally by
  387.   grabbing the left or right prompt borders with the mouse, or by using
  388.   the keyboard (<ctrl f5> + <shift> + cursor keys).
  389.  
  390. * Dialog boxes have been revised.
  391.  
  392. * Additional color settings were added for edit windows, file manager
  393.   windows, prompts, and dialog boxes.
  394.  
  395. * Dialog box and popup menu positions can now be saved and restored when
  396.   the 'SaveDialog' setting is ON.
  397.  
  398. * Text can be now be copied from within a prompt to the clipboard by
  399.   using the clipboard Copy <grey+> command. This can be used to save
  400.   complex search strings entered at a prompt for later use.
  401.  
  402. * Several enhancements were made to the File Manager including:
  403.  
  404.    - the sort menu allows you to sort-by-extension
  405.    - the disk volume and free space are displayed on the status line
  406.    - marked files are highlighted
  407.    - the number of marked files and the total size (in bytes) of all
  408.      marked files are displayed on the status line
  409.    - you can jump quickly to a file within the file manager (or a file
  410.      picklist) by repeatedly entering the first letter of the desired
  411.      filename until the cursor is positioned at the file.
  412.  
  413. * Pull-down menus can be detached from the menu bar and moved around the
  414.   screen by grabbing the menu borders with the mouse, or by using the
  415.   keyboard (<ctrl f5> + cursor keys).
  416.  
  417. * A new window was added to show progress while scanning through files
  418.   with the 'askscan' <ctrl s> command.
  419.  
  420. * The system-wide Date and Time format is now configurable (see
  421.   SYSTEM.AML for details). You can also configure a new 'Thousands
  422.   separator' character for displaying large numbers.
  423.  
  424. * Entab and Detab are now both builtin functions. See the 'tabblock'
  425.   function in FUNCTION.TXH.
  426.  
  427. * Options to trim trailing blanks and entab while saving have been
  428.   added. See the 'SaveOpt' setting in CONFIG.AML
  429.  
  430. * Better CUA-style <shift> key marking is supported, including support
  431.   for <shift home>, <shift end>, <shift ctrl home>, <shift ctrl end>,
  432.   <shift pgdn>, etc.
  433.  
  434. * The default mouse-marking mode has been changed to 'stream' marking.
  435.  
  436. * Key macros can now be repeated with the Repeat Key function
  437.   <ctrl q><q>.
  438.  
  439. * The text reformatting commands are now configured (by default) to
  440.   maintain the indenting relationship between the first and second lines
  441.   being reformatted, and to preserve the spacing between words.
  442.  
  443. * The block Fill function <ctrl k><f> now also fills a marked block with
  444.   with a repeating string (not just a repeating character).
  445.  
  446. * The new configuration setting 'InsAbove' forces marked blocks to be
  447.   inserted above the cursor position (rather than below), for the block
  448.   Copy, Move, and clipboard Paste commands. See CONFIG.AML.
  449.  
  450. * The new configuration setting 'MenuCursor' allows the video hardware
  451.   cursor to be displayed on the menus and the file manager, which may be
  452.   helpful for blind users. See CONFIG.AML.
  453.  
  454. * Simple block quoting support is provided by the new 'quote' <shift f9>
  455.   command. For text quoting on a line-by-line basis, use the
  456.   'commentline' <alt f1> command.
  457.  
  458. * The 'commentline' <alt f1> command is now sensitive to the extension
  459.   of the current file.
  460.  
  461. * The 'goto line' <ctrl j> and 'goto column' prompts will now jump to a
  462.   relative distance away from the current cursor position. To move by a
  463.   relative amount, specify '+' or '-' immediately before the line or
  464.   column.
  465.  
  466. * The new commands 'compilemacro2' <shift f10> and 'runmacro2' <shift
  467.   f11> will compile and run the macro source file displayed in the
  468.   current edit window. This can be very convenient when developing new
  469.   external macros.
  470.  
  471. * The status line hex indicator now displays '[EL]' when the cursor is
  472.   beyond the end of the line.
  473.  
  474. * Many other minor additions and changes
  475.  
  476.