home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff221a.lzh / ANSIEd / Demo.doc < prev    next >
Text File  |  1989-06-24  |  31KB  |  602 lines

  1.  
  2.                    __   _           ______      ______        _
  3.                   /_ | | \     ||  /_____/  || | _____|      | |
  4.                  // || ||\\    || //        || ||            ||
  5.                 //__|| || \\   || \\_____   || ||____    ____||
  6.                /____ | ||  \\  ||  \_____\  || | ____|  /____ |
  7.               //    || ||   \\ ||        \\ || ||      //    ||
  8.              //     || ||    \\|| _______// || ||_____ \\____||
  9.             //      || ||     \_| \______/  || |______| \_____|
  10.  
  11.                     ANSI Screen File Editor ---- V1.2.0aD
  12.                
  13.                     Copyright (c) 1989  Second Sight (tm)
  14.                
  15.                            Developed by Greg Epley
  16.  
  17.  
  18. (This is a minor bug-fix update to V1.2.0, denoted by the "a" in the
  19. version number.  The file requester did not display the proper rounded
  20. size for files/volumes; this has been fixed (e.g., a 2408 byte file now
  21. appears as "3K" which is correct; "2K" was displayed).  We appologize
  22. for any problems this might have caused.)
  23.  
  24.  
  25. Introduction
  26. ~~~~~~~~~~~~
  27. ANSIEd is an ANSI Screen File Editor.  It allows you to easily create and
  28. modify a screen of ANSI-style text/graphics on the Amiga [r].  The standard
  29. ANSI color set - RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE - and text
  30. styles - PLAIN, BOLDFACE, UNDERLINED, ITALIC - are provided, along with some
  31. simple editing and drawing functions.
  32.  
  33.     THIS IS A DEMO VERSION OF ANSIEd ONLY.  IN THE FUTURE, YOU CAN EASILY
  34.     DISTINGUISH DEMO VERSIONS OF OUR PRODUCTS BY THE 'D' FOLLOWING THE
  35.     VERSION NUMBER (e.g., V1.0.5D).
  36.     
  37.     "Save As" AND "Save" HAVE BEEN DISABLED.  AS A RESULT THERE ARE CERTAIN
  38.     OTHER FEATURES WHICH ARE DISABLED WITHIN THESE FUNCTIONS.  HOWEVER,
  39.     INFORMATION ON THEIR OPERATION IS INCLUDED IN THIS DOCUMENT FOR YOUR
  40.     CONVENIENCE.  TO GET THE "REAL" THING, FOLLOW THE INSTRUCTIONS UNDER
  41.     "Purchasing".
  42.     
  43.     IT IS VERY IMPORTANT THAT YOU READ THIS ENTIRE FILE BEFORE USING
  44.     ANSIEd.  EVEN IF YOU ARE FAMILIAR WITH THE BASIC OPERATION OF THE
  45.     AMIGA, THERE IS CERTAIN INFORMATION CONTAINED HEREIN WHICH WILL
  46.     HOPFULLY PREVENT ANY "SURPRISE" PROBLEMS.
  47.  
  48.  
  49. What is ANSI?
  50. ~~~~~~~~~~~~~
  51. Or more correctly, WHO is ANSI?  ANSI is the American National Standards
  52. Institue.  They, along with ISO (International Standards Organization) set
  53. various standards in various fields.  They are the ones that decide that
  54. the number 65 decimal represents the character "A" to the computer, among
  55. other things.  A subset of these numeric codes, recognized by most
  56. computers on the market today, control attributes of the display such as
  57. text color and style.  On the Amiga [r], the console and the printer devices
  58. are most likely to use these "display control codes".  The purpose of ANSIEd
  59. is to make creation of files with these control codes for screen (console)
  60. display simple.
  61.  
  62.  
  63. Documentation Symbols
  64. ~~~~~~~~~~~~~~~~~~~~~
  65. For the sake of space and brevity, the following symbols are used in the
  66. remainder of this document to represent certain actions.
  67.  
  68.     D-CLK    - means double-click the indicated mouse button (LEFT or
  69.               RIGHT will be indicated).
  70.     S-CLK    - means single-click the indicated mouse button (LEFT or
  71.               RIGHT will be indicated).
  72.         FG    - abbreviation of foreground.
  73.         BG    - abbreviation of background.
  74.  
  75. When it is necessary to indicate that you need to press a specific key to
  76. perform an action it will be enclosed in <> (angle brackets).  Examples
  77. are <RETURN> to press the large key above your right shift key or <CTRL><J>
  78. to press and hold the CTRL key and then press the J key.
  79.  
  80. The arrow or whatever other imagery you have saved under Preferences as your
  81. mouse pointer is referred to as the "pointer".  Also, since this is the first
  82. update to ANSIEd, new items are marked with a (N) symbol to indicate such.
  83.  
  84.  
  85. Running ANSIEd
  86. ~~~~~~~~~~~~~~
  87. If you wish to run ANSIEd from the CLI we suggest you set your stack size at
  88. 12000.  From the CLI prompt type:
  89.  
  90.     1> stack 12000    <RETURN>
  91.  
  92. Run ANSIEd from the Workbench [tm] by D-CLK RIGHT on the ANSIEd icon or from
  93. the CLI prompt type:
  94.  
  95.     1> ansied    <RETURN>
  96.  
  97. You can preceed the name from the CLI with the CLI "Run" command to spawn
  98. ANSIEd as a task from the CLI.
  99.  
  100. If you encounter a strange lockup error when running the program it is most
  101. likely due to insufficient memory.  If it seems that you have enough memory
  102. then try increasing the stack size to 20000.  Use the above CLI format to
  103. change the stack to 20000 (instead of 12000) or use the "Info" option from
  104. the "Workbench" menu on the Workbench [tm].  In "Info", change the stack
  105. from 12000 to 20000 and remember to select SAVE so it takes effect.
  106.  
  107. If you still encounter an error write down any messages that appear and
  108. contact me as soon as possible at one of the sources under "Purchasing"
  109. at the end of this document.  Describe what other programs you were running
  110. and your basic machine setup.  ANSIEd uses standard Intuition [tm] function
  111. calls and behaves according to Intuition [tm] as much as possible.
  112.  
  113. If you run ANSIEd from the Workbench [tm], the icon is set up with the stack
  114. size at 12000.  Also, a window will open on the Workbench [tm] for error
  115. messages.  As of V1.2.0, you may find that you need to increase the stack
  116. size to 20000 due to the increase in functions of the program.
  117.  
  118. ERRORS: When most any error occurs the display will usually flash.  In any
  119. event, a message is usually displayed on the Workbench [tm] screen.  It
  120. is VERY important that you write the FULL error message down if the message
  121. indicates a serious problem.  This is provided exclusively for quick and
  122. easy debugging and, frankly, we believe our system is better than any other
  123. that we have seen for this purpose (of course, it doesn't do any good to just
  124. write the message down if you don't contact me by mail, phone, or BBS, to
  125. tell me - comprende?)  Also, if a system requester appears at any time during
  126. use, it will push the Workbench [tm] screen to the front with the message.
  127. You MUST answer any system requesters that appear for ANSIEd to continue to
  128. operate properly.  Once responded to, press the <AMIGA><M> keys to move back
  129. to the ANSIEd display.  This also works for error messages displayed after
  130. a display flash; to view the message, press the <AMIGA><N> keys to move to
  131. the Workbench [tm] display and error window, then press the <AMIGA><M> keys
  132. to move back to the ANSIEd display.
  133.  
  134.  
  135. The Display
  136. ~~~~~~~~~~~
  137. ANSIEd displays a green title bar at the top, a color bar at the bottom with
  138. the current FG/BG colors as boxes on the far right of that bar, and the
  139. usable screen area (display) in between.  As of V1.2.0 you will also notice
  140. some additional items in the right side of the color bar.
  141.  
  142.  
  143. The Controls
  144. ~~~~~~~~~~~~
  145. The mouse, serves double-duty in selecting menu items, FG/BG colors, and
  146. cursor position.  As of V1.2.0 it also handles 2 drawing tools - freehand
  147. and box filled/unfilled.
  148.  
  149. When the mouse is just above the color select bar, the LEFT button will
  150. allow access to the menus and the RIGHT button access to cursor positioning.
  151.  
  152. When the mouse is within the color select bar, the LEFT button will set the
  153. FG color and the RIGHT button the BG color - when the pointer is over a color
  154. in the bar, of course.
  155.  
  156. Try selecting some FG/BG colors and notice the two small boxes in the far
  157. right of the color select bar change color.  One appears over the other,
  158. giving you an ordered representation of the currently selected colors.
  159.  
  160. Move the pointer above the color select bar and hold down the RIGHT button.
  161. You can examine the few, simple menu items this way.  There are keyboard
  162. shortcuts for most of them, available by pressing and holding the RIGHT
  163. AMIGA key and pressing the key given beside the menu item.  These are most
  164. useful for quickly selecting text styles from the style menu.
  165.  
  166. With the pointer still above the color select bar (no buttons pressed),
  167. S-CLK LEFT button and the cursor will jump to that position for editing.
  168. This is sometimes quicker than any of the keyboard cursor movements.
  169.  
  170. (N) As of V1.2.0, you will notice 3 small buttons in the right end of the
  171.     color select bar (between the color list and the FG/BG color status).
  172.     These are for selecting the operation mode.  From left to right, they
  173.     are a stylized "N", a squiggly line, and a box (diagonally split half
  174.     filled, half empty).  Here's what they are and how to use them:
  175.  
  176. (N) Normal Tool:
  177.       This is highlighted by default at startup.  S-CLK LEFT on it to
  178.       deselect any drawing tools and to allow cursor positioning with the
  179.       mouse without drawing.  As long as you hold the LEFT mouse button down
  180.       and move the pointer the cursor will move with it.
  181.       
  182. (N) Freehand Tool:
  183.       S-CLK LEFT on this to enter freehand drawing mode.  Now when you hold
  184.       the LEFT mouse button down and move the mouse around in the display
  185.       area it will draw character "pixels" in the BG color; to draw somewhere
  186.       else, just release the LEFT mouse button, move the pointer, and hold
  187.       down the LEFT mouse button while moving to draw.  To move the cursor
  188.       without leaving a "pixel" S-CLK LEFT on the Normal Tool to get back
  189.       in normal mode.
  190.     
  191. (N) Box Filled/Unfilled Tool:
  192.       To select to draw an unfilled box, S-CLK LEFT on the box tool.  It
  193.       doesn't matter where you click, just somewhere on the box.  To select
  194.       to draw a filled box, S-CLK RIGHT on the box tool.  In either case,
  195.       the image of the box will change to indicate the mode you have
  196.       selected.  Now, to draw a box: (a) move into the display area and hold
  197.       down the LEFT mouse button; this defines one corner of the box; (b)
  198.       while still holding it down move the mouse; you will see an image of a
  199.       box drawn whose size will change accordingly as you move the mouse;
  200.       when it is like you want it (c) release the LEFT mouse button and the
  201.       box will be drawn in the BG color.  To resume cursor positioning
  202.       without drawing boxes S-CLK LEFT on the Normal Tool to get back in
  203.       normal mode.  The white outline of a box that you see while holding
  204.       down the LEFT mouse button shows the outermost edges of the box that
  205.       will be drawn later.  Don't try to follow the mouse pointer!!! ---
  206.       follow the white outline.
  207.  
  208. Only one of these buttons can possibly be selected at one time.  That is, if
  209. you select one it will deselect whatever was highlighted.  There is no "Undo"
  210. for the drawing tools.  We will probably add this to a future version.  For
  211. now, if you are going to do some "major" drawing, save your work before you
  212. make any changes.
  213.  
  214. (In the "Version.doc" file you will notice a warning about entering anything
  215. into the lower right corner of the display buffer.  You CAN draw in that area
  216. safely as long as you DO NOT release the LEFT mouse button while in that area
  217. --- you have been well warned.)
  218.  
  219. The remaining keyboard controls are summarized below:
  220.  
  221.   SPACEBAR    - use to erase or draw a block at a time by properly setting
  222.                   the BG color; also moves the cursor.
  223.   BACKSPACE    - moves the cursor back one character space WITHOUT erasing;
  224.                   the cursor does NOT wrap at the edges.
  225.   RETURN    - moves the cursor down one screen line (in characters) to
  226.                   the left edge.
  227.  
  228. The remaining keys will not work at all or they will produce a character of
  229. some sort, rendered in the currently selected FG/BG/style at the current
  230. position.
  231.  
  232.  
  233. The Menus
  234. ~~~~~~~~~
  235. ANSIEd has the following items available in the menus (in order, top-bottom,
  236. left-right):
  237.  
  238.   Project:
  239.   
  240.       New    - initializes the editor environment to a blank slate.  You
  241.             only NEED to use this if you want to ensure the buffer is
  242. (N)               clear as well as the screen.  As of V1.2.0 this will warn
  243.                   you if you have made changes since the last save and give
  244.                   you a chance to save them.
  245.       Open    - allows you to load a file selected from the file requester.
  246.             It takes a few seconds to load a complex file so wait for
  247.                   the "snooze" cloud to disappear before resuming.  This
  248.                   does NOT ask if you wish to save the current buffer before
  249.                   loading a new file.
  250.      Save    - allows you to save a file under the current file name.  The
  251.             current file name is the same name you used in "Open" or
  252.                   "Save As".
  253.       Save As    - allows you to save a file selected from the file requester.
  254.                   It takes a few seconds to save a complex file so wait for
  255.                   the "snooze" cloud to disappear before resuming.
  256. (N)     Delete    - allows you to delete a file selected from the file
  257.                   requester.  A warning will pop up to ask you if you are
  258.                   sure (this is a safeguard function).  As of V1.2.0 this
  259.                   does NOT delete an icon (.info) file associated with the
  260.                   file you are deleting, since ANSIEd does not yet create
  261.                   its own icons for files.
  262.       About    - displays version/title/author information.
  263. (N)    Quit    - exits the program.  As of V1.2.0 this will warn you if you
  264.                   have made changes since the last save and give you a chance
  265.                   to save them.
  266.  
  267.   Style:
  268.   
  269.       The four options on this menu, "Plain", "Boldface", "Underlined",
  270.         and "Italic" let you select the current text rendering style.  They
  271.         have nothing to do with selecting colors.  The current style(s)
  272.         will be checkmarked in the style menu.
  273.         
  274.         "Plain" is mutually exclusive.  It will ALWAYS reset the text style
  275.         back to plain text.
  276.         
  277.         "Boldface", "Underlined", and "Italic" can be mixed.  That is, if
  278.         you select "Bold", type some text, and select "Underlined", you
  279.         will get BOLD-UNDERLINED text, not UNDERLINED text.  If you wanted
  280.         text UNDERLINED only, you would select "Plain" and then select
  281.         "Underlined".
  282.         
  283.   Special:
  284.   
  285. (N)     ANSI Filter On    -
  286.               select this to turn on an internal ANSI filter for use with
  287.                   the "Open" option on the "Project" menu.  During the load,
  288.                   any character outside the plain text range will be ignored.
  289.                   This is useful for loading ANSI files created on other
  290.                   computers or for getting back the plain text from an ANSI
  291.                   file.  When the filter is active a check will appear beside
  292.                   this item.  It is a toggle-select item.
  293. (N)     CRLF Line Term    -
  294.               select this to turn on another handy IBM ANSI feature which
  295.                   operates during the save process.  Most IBM BBS programs
  296.                   (you did know that many Amiga [r] BBS's are run off IBM
  297.                   equipment didn't you? hey! that's so they can free their
  298.                   Amiga's for those great games!) like their ANSI files to
  299.                   terminate lines in carriage returns [CR} and line feeds
  300.                   [LF].  ANSIEd normally only stores a LF since that's all
  301.                   the Amiga [r] console needs.  When this is active a check
  302.                   will appear beside this item.  It is a toggle-select item.
  303.  
  304.  
  305. Loading, Saving, and Deleting Files
  306. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  307. ANSIEd stores its files as compactly as possible.  At times, it will only
  308. write just enough of an ANSI control sequence as it needs.  You can use a
  309. regular text editor to embed ANSI codes in your plain ASCII text files
  310. before loading them into ANSIEd, but it really isn't necessary.  ANSIEd will
  311. pick up these codes regardless of the order you enter them but they MUST be
  312. VALID ANSI codes...or you just might get a surprise!
  313.  
  314. We would strongly suggest you keep your plain ASCII text files within certain
  315. limits: 78 characters per line, 22 lines.  When you use your ANSI file later,
  316. it will most likely be displayed in a window with a sizing box in the lower-
  317. right corner OR be subject to such a line width limit in telecommunications.
  318. Obeying this limit in your ANSI and plain ASCII text files should prevent any
  319. unwanted scrolling or chopping of lines.  Provided that you always follow
  320. this suggestion you will not encounter the lower right corner scroll bug
  321. mentioned in file "Version.doc".
  322.  
  323. "Save" and "Save As", under the "Project" menu, will automatically store an
  324. ANSI reset sequence at the start and end of the file being saved.  It is a
  325. safety feature we included to eliminate the unwanted color/style changes left
  326. over from previous ANSI displays when used with telecommunications software.
  327. The ANSI reset sequence is: set "Plain" text style, with FG color as 7
  328. (WHITE) and BG color as 0 (BLACK).
  329.  
  330. "Open", under the "Project" menu, will recognize VALID ANSI codes in any
  331. sequence.  "Open" is, of course, used to LOAD a file - the purpose of this
  332. terminology is to maintain style within the Amiga [r] interface.  It is
  333. somewhat slow right now but we are considering adding buffering in a future
  334. release.
  335.  
  336. You can load a file upon starting ANSIEd from the CLI or Workbench [tm].
  337. From the CLI prompt type:
  338.  
  339.     1> ansied [path/filename]    <RETURN>
  340.  
  341. The [path/filename] can simply be a filename alone if the file resides in the
  342. current directory you are CD'ed to.  Otherwise you should include the path
  343. (this includes a drive such as DF0: or a disk name, possibly followed by a
  344. directory).  Consult any one of several books on the Amiga [r] CLI if you
  345. need more help.
  346.  
  347. While it is possible to load a file at startup from the Workbench [tm], I
  348. wouldn't advise it at this time unless you know exactly how to setup the
  349. icon to do this.  We are considering a feature where ANSIEd will save its
  350. files with PROJECT-type icons in a future release, whose default tool will be
  351. ANSIEd.
  352.  
  353. (N) "Delete" displays the standard file requester and allows you to select a
  354.     file to delete from disk; since the file requester functions somewhat
  355.     differently its use is described here.  The file requester functions
  356.     normally as described below EXCEPT:
  357.  
  358.     (1) A file MUST be selected.  "OK" will NOT function if there is no
  359.         filename in the file text box (just below the entries list).
  360.         "Cancel" will back you out however.
  361.         
  362.     (2) When a file is selected and "OK" is selected, a delete warning
  363.         requester will pop up in the top left corner of the program display.
  364.         
  365.         (a) "Cancel" will back you out without deleting but will still leave
  366.             you in the file requester; just select "Cancel" again to exit the
  367.             file requester if you wish or select another file.
  368.             
  369.         (b) "OK" will ATTEMPT to delete the file; it will close both the
  370.             warning and file requesters; if the delete fails the display will
  371.             flash, indicating that the delete did not work, and a message to
  372.             this effect is printed to the error window on the Workbench [tm]
  373.             screen.  The delete will sometimes occur AFTER both requesters
  374.             are closed - this is normal and should not cause any problems.
  375.  
  376.  
  377. The File Requester
  378. ~~~~~~~~~~~~~~~~~~
  379. The File Requester appears when you select "Save As", "Open", or "Delete"
  380. from the "Project" menu.  This will be our standard means of requesting a
  381. path/file from the user.
  382.  
  383. (N) As of V1.2.0, the file requester was redesigned to make it easier to use
  384.     and to allow it to fit on a screen of any size and resolution.  The
  385.     previous file requester was too large and would have presented a problem
  386.     had we required its use on a lo-res display.  We think that the new
  387.     requester is much neater and easier to use.  Some new terminology is in
  388.     order, however, to make description of the new requester easier.
  389.  
  390.     First, it is considered that there are 2 types of information listed in
  391.     the requester.  "Entries" are files and directories; "Volumes" are
  392.     mounted disk units that are in use (including hard drives, recoverable
  393.     drives, etc.).
  394.  
  395.     Path/File Text Boxes:
  396.       These horizontial boxes appear, one above, one below, the list of
  397.       volumes-entries.  The Path Box (above the list), includes such things
  398.       as drive names, disk names (volumes), and directory names, and
  399.       combinations of any of these in that order.  The File Box (below the
  400.       list) only holds the selected filename.
  401.         
  402.     Volumes-Entries List and Slider
  403.       Between the path/file text boxes is a list of items.  These will either
  404.       be Entries (files/directories) OR mounted Volumes (disks), depending on
  405.       the Volumes-Entries Button selection (see below).  Seven (7) are shown
  406.       at one time, sorted alphabetically; a maximum of 1000 entries or 30
  407.       volumes.  Also notice the Slider to the right of the list.  Use this to
  408.       scroll up/down through the list or S-CLK LEFT inside the slider box
  409.       (not on the knob) to flip a page at a time through the list.  No arrow
  410.       buttons are provided since precise positioning isn't necessary and
  411.       since the file requester does not present a "window" into a larger
  412.       display.  If you do not see any volumes-entries in the list then a
  413.       non-terminal error has occurred or there was no information.  If there
  414.       is ever a serious error the display will flash and a message will be
  415.       displayed in the error window on the Workbench [tm] screen.  See the
  416.       section above on ERRORS for more information.
  417.         
  418.     Volumes-Entries Button
  419.       This is a toggle button.  Each time you call up the file requester
  420.       it ALWAYS lists entries first, so this button displays "Volumes".
  421.       When "Volumes" appears in this button, a S-CLK LEFT on the button will
  422.       display a list of mounted disk volumes in the list area.  When
  423.       "Entries" appears in this button, a S-CLK LEFT on the button will
  424.       display a list of files/directories, based on the path currently in
  425.       the Path Box.
  426.         
  427.     Parent Button
  428.       Located beside the Volumes-Entries button, this will move you back up
  429.       one level from within a directory towards the root.  It will NOT work
  430.       (1) if there are no more levels or (2) you are looking at a Volumes
  431.       list.  As of V1.2.0 the "ghosting" has been removed since it didn't
  432.       completely render properly.
  433.         
  434.     OK/Cancel Buttons
  435.       The "OK" button accepts your selection and the "Cancel" button rejects
  436.       your selection.  It is assumed that you know what selection incurs.
  437.       
  438. (N) As of V1.2.0, please see the description of the "Delete" function above
  439.     for information on how the function of the requester changes when using
  440.     "Delete".  You will also notice several enhancements to the display of
  441.     the file requester:
  442.  
  443. (N) * In the Entries list, DIRECTORIES appear in BOLD type in one color.
  444.       FILES appear in NORMAL type in another color.
  445.         
  446. (N) * When a selection is made from the list it is not highlighted.  The
  447.       selection will appear appropriately in the path or file box.  This is
  448.       changed due to improper rendering of the display during real-time
  449.       updates of the requester.
  450.     
  451. (N) * FILES and VOLUMES have a number which appears to the far left of the
  452.       list.  First, some explanation of this number: a letter (B, K, M, or G)
  453.       appears farthest to the right beside the number; B for Bytes, K for
  454.       Kilobytes, M for Megabytes, and G for Gigabytes.  Thus 64B is 64 bytes
  455.       and 173K is 173 Kilobytes.  For FILES, this number/id is the size
  456.       (rounded) of the file, or the amount of space USED on the disk.  For
  457.       VOLUMES, this number/id is the amount of space FREE on the volume; this
  458.       would seem to be more useful to me than the amount of space used.  If
  459.       your RAM Disk (RAM:) is available the amount of space USED is shown,
  460.       since the RAM Disk is ALWAYS full.  To remain compatible with V1.2 of
  461.       the system the RAM Disk is called RAM: to avoid crashing the machine.
  462.       This bug is fixed in V1.3 of the system but we will leave it like this
  463.       until most people are on V1.3/V1.4 of the system.
  464.  
  465.       (Incidentally, did you know that the Terabyte is 1 trillion bytes [or
  466.       1.0E12].  A Petabyte is 1 quadrillion bytes [or 1.0E15].  An Exabyte is
  467.       1 qunitillion bytes [or 1.0E18].  Unfortunately, the current definition
  468.       on the Amiga [r] seems to be limited to about 4 Gigabytes...at least
  469.       the entry size is defined as a 32 bit number, so 2^32 = 4,294,960,000
  470.       [approx].  Now when we get our 64 bit systems we can reach just over
  471.       18,446,700,000,000,000,000 or about 18 Exabytes; this is good Trivial
  472.       Pursuit stuff!)
  473.  
  474.  
  475. Development Tools
  476. ~~~~~~~~~~~~~~~~~
  477. ANSIEd was written entirely in Modula-2 using Release 3.1 of Interface
  478. Technologies' M2AMIGA Modula-2 Development System for the Amiga [r].  Graphic
  479. images were designed using DPaint-II, ZapIcon, and ILBMDump.
  480.  
  481.  
  482. Final Comments And Suggestions From The Developer
  483. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  484. While typing, the cursor will wrap to the next line.  CAUTION: Again, please
  485. do NOT enter a character in the lower-right position as that will cause the
  486. screen to roll up.  I've warned you for the last time NOW!
  487.  
  488. There is no insert/overstrike mode.  After creating several displays, I
  489. cannot understand why insert would really be needed.  Text/graphics ALWAYS
  490. write over any material under them.  The author of another ANSI editor
  491. proposes an insert/overstrike in his next release but it seems a waste of
  492. time and a real hassle when trying to create complex graphics.
  493.  
  494. Along with the changes mentioned throughout this document that will be
  495. provided in a future release, I also plan to include the IBM Graphics
  496. Character Set.  This will provide some very neat looking boxes and other
  497. graphics that are impossible with the Amiga [r] character set.
  498.  
  499. The best colors for text display have BG set as 0 (BLACK) and FG set as 2
  500. (GREEN), 3 (YELLOW), 5 (MAGENTA), 6 (CYAN), or 7 (WHITE).  Remember that the
  501. ANSI reset sequence "Plain" FG WHITE on BG BLACK, will automatically be
  502. written at the start and end of a file when it is saved.
  503.  
  504. Note that the null-space bug is fixed as of V1.2.0.  However, there still
  505. seems to be a problem with some files.  We recommend you ALWAYS 'Type' your
  506. files from the CLI to check them for proper display.  Don't expect them to
  507. look exactly the same since the Workbench [tm] is only 4 colors, but lines
  508. should wrap properly, and, in some cases, you may notice that colors don't
  509. seem to turn off.  I've checked and re-checked this and cannot find the
  510. problem.  The codes are THERE.  My guess is that space characters (32
  511. decimal) cause these codes to "stick" sometimes and on IBM, the character
  512. 255 decimal usually prevents this.  When we are certain that we have found a
  513. way to incorporate this into ANSIEd, regardless of the machine or font, this
  514. fix will be added to ANSIEd.  There is a temporary solution but it varies in
  515. how it works: set both FG and BG colors to black and fill one or more spaces
  516. along the entire rightmost edge of your image; you may want to save the file
  517. and check it from the CLI to see if this made any difference.  I've had some
  518. files where one space would work, sometimes 2, and once even 6 were needed
  519. for some reason!  There seems to be no pattern.
  520.  
  521. When you load your own plain ASCII text files for adding color/style changes,
  522. you will note that you get "Plain" FG RED on BG black text.  That's a bit
  523. hard for some people to read.  To fix it, just immediately save the file and
  524. then reload it.  The ANSI reset sequences will be saved and when you reload
  525. the file you'll have "Plain" FG WHITE on BG BLACK - much more readable!
  526.  
  527. If you are using ANSIEd to create graphics for an Amiga BBS that runs on IBM
  528. equipment, PLEASE use the new menu items V1.2.0 provides - ANSI Filter and
  529. CRLF Line Term.  You should save ANSI files with CRLF Line Term ON.  You can
  530. quickly fix any plain files using this too.  Just load them into ANSIEd,
  531. make sure CRLF Line Term is ON, then save them (under the same name or a new
  532. name).  You should then load the ANSI file into a text editor such as
  533. MicroEMACS and remove the "^[31;40;0m" sequence from the beginning and end
  534. of the file; leave the "^M"'s - that's part of what CRLF Line Term did to
  535. fix your file.
  536.  
  537. If you have further suggestions for new features or bugs/problems with this
  538. version contact me at one of the sources below.
  539.  
  540. I've enjoyed writing ANSIEd (well, for the most part - except when it got
  541. rather stubborn and persnickety) and hope you find it useful as well.  If
  542. you do, why not get the "REAL" thing?  See "Purchasing" below.
  543.  
  544. I will continue to release updates to ANSIEd as long as I receive a fair
  545. amount of interest and compensation.  Being a certified Commodore-Amiga
  546. developer, as well as having two college degrees in computer information
  547. systems, I simply cannot afford to "do it for fun" all the time.  And as
  548. the Amiga [r] seems to be the one place where I have this so-called
  549. "experience" that every employer wants, it looks like I'll have to make my
  550. living off the Amiga [r].  Don't assume "the other guy" will help me out -
  551. do it for yourself.  After all, how would you like to work for 2 months and
  552. then not get paid for it?  Think about it.
  553.  
  554.  
  555. Purchasing
  556. ~~~~~~~~~~
  557. Prices for any older versions of ANSIEd are no longer in effect.  If you are
  558. not sure if you have the most recent version or question the price, please
  559. give me a call or contact me so there are no mistakes.
  560.  
  561. To get the "REAL" thing - the most recent, fully functional version of
  562. ANSIEd, select ONE of the item #'s below and send the indicated items to the
  563. address given below (PLEASE include a note with the item # on it for our
  564. records or we can't process your order):
  565.  
  566.     Item #                        Price
  567.         ------------------------------------------------------
  568.         AED001    Send check only.            $20.00
  569.         AED002    Send a check, blank disk, and SASM*    $15.00
  570.         
  571. Make checks payable to: Greg Epley.  NC residents please add appropriate
  572. state tax.  Incomplete orders will NOT be processed or returned (including
  573. disks under option 2, unless a SASM is included under option 2, in which
  574. case we will send your blank disk back without any files).
  575.  
  576. Send to:    Second Sight
  577.             306 Arbor Drive
  578.             Lexington, NC  27292
  579.         Attn: Greg Epley
  580.  
  581. Please allow 3 weeks for delivery via US Mail.  Foreign/Canadian orders
  582. should expect an appropriate delay beyond this.
  583.  
  584. *SASM - Self-Addressed Stamped Mailer
  585.  
  586. If you would like to respond to this document, we can be reached by U.S. Mail
  587. at the address above or electronically at:
  588.         
  589.     MEGA-Byte (BBS) --- (704) 798-3431
  590.         The Amiga [r] Connection to "The NETWORK" Users Group
  591.     1200/2400 Baud, F8N1, 24 hrs/day
  592.         ANSI Color Graphics, 122MG, Private EMAIL
  593.         SYSOPs: Michael Love, Greg Epley
  594.         
  595. Electronic messages should be left to me, Greg Epley, in Private EMAIL with
  596. a maximum length of 150 lines (Mr. Love is just the SysOp and is not
  597. associated directly with the company).
  598.  
  599. ---------------------------------------------------------------------------
  600. Amiga is a registered trademark of Commodore-Amiga, Inc.  Workbench and
  601. Intuition are trademarks respectively of Commodore-Amiga, Inc.
  602.