home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / wp / bb725.zip / READ.ME < prev    next >
Text File  |  1987-03-10  |  8KB  |  238 lines
  1.                   ██████████
  2.                                 ██████████████
  3.                                ███ · ████ · ███
  4.                                 ██████████████
  5.                                 ██████  ██████
  6.                                  ████████████
  7.                                    ████████
  8.                                   ██││││││██
  9.                                    ████████
  10.                                ██▄          ▄██
  11.                                 ▀██▄      ▄██▀
  12.                                   ▀██▄  ▄██▀
  13.                                     ▀████▀
  14.                                     ▄████▄
  15.                                   ▄██▀  ▀██▄
  16.                                 ▄██▀      ▀██▄
  17.                                ██▀          ▀██
  18.  
  19.                                 ┌────────────┐
  20.                                 │ BLACKBEARD │
  21.                                 └────────────┘
  22.  
  23.                             User Supported Software
  24.  
  25.    Blackbeard is designed to be a programmer's editor. It
  26. performs the editing tasks a programmer needs, in as fast and
  27. efficient manner as possible. It works the way you expect it to.
  28. The primary use for Blackbeard is for source code editing and it
  29. does all the things you would expect. It also has some word
  30. processing features; these were used to create this read.me file.
  31.  
  32. DOCUMENTATION
  33.  
  34.    Blackbeard does not come with a voluminous manual. The design
  35. team decided early on that a good editor should not need a large
  36. reference manual; most of the documentation is built in. The file
  37. BB.DOC explans the more complex features of Blackbeard.
  38.  
  39.    The Blackbeard diskette should have the following files:
  40.  
  41.      File              Description
  42.      -------------------------------------------------------
  43.      bb.exe            This is the Blackbeard program.
  44.  
  45.  
  46.      bb44.exe          This is the Blackbeard program set up
  47.                to run in 44 row by 132 column mode
  48.                on the Everex card. (No longer being
  49.                distributed. Available upon request.)
  50.  
  51.      bbc.exe           Blackbeard key binding compiler
  52.  
  53.      bbf.exe           Blackbeard text formatter. See BBF.DOC
  54.                instructions. Turns Blackbeard into a
  55.                full-featured word processor.
  56.  
  57.      bb.cfg            Blackbeard configuration file
  58.  
  59.      bb.key            Blackbeard key binding file compiled
  60.  
  61.      read.me           Blackbeard release notes
  62.  
  63.      bb.doc            Blackbeard manual
  64.  
  65.      bbf.doc           Blackbeard formatter manual
  66.  
  67.      bbc.doc           Blackbeard key compiler manual
  68.  
  69.      bbkeys.txt        Blackbeard key binding file ready for
  70.                compilation.
  71.  
  72.      m_bb.msc          Blackbeard Mouse systems button and
  73.                movement defintion file
  74.  
  75.      m_bb.com          Blackbeard Mouse systems compiled menu file.
  76.  
  77.      form.txt          Blackbeard order form.
  78.  
  79.      bbada.lng         Language syntax for Ada.
  80.  
  81. RUNNING BLACKBEARD
  82.  
  83.    To run blackbeard simply type:
  84.  
  85.       BB
  86.  
  87.    at the DOS prompt. Blackbeard will display the startup screen
  88. and ask you for a file to edit (use this one to get started). You
  89. can enter a file name just press return for a menu of available
  90. files in your current directory.
  91.  
  92.    To install backbeard  memory resident use:
  93.  
  94.       BB =R
  95.  
  96.    Blackbeard will install and consume about 150k of memory. Use
  97. <ALT> = or <ALT> - to invoke the editor.
  98.  
  99.    You can give Blackbeard a filename upon startup:
  100.  
  101.       BB <filename>
  102.  
  103.    When Blackbeard starts up it looks for two files: the
  104. configuration file and the macro file. The configuration file is
  105. required; the macro file is optional.
  106.  
  107. Configuration File
  108.  
  109.    Blackbeard keeps a configuration file that will allow you to
  110. customize the following areas:
  111.  
  112.       -  all items from the OPTIONS MENU
  113.       -  all items from the SETTINGS MENU
  114.       -  Window colors
  115.       -  WIndow sizes
  116.       -  the status line settings
  117.  
  118.    Blackbeard looks in the current subdirectory for a file named
  119. BB.CFG. This file will be used to set the configuration
  120. setttings. If there is not a file named BB.CFG in the current
  121. subdirectory, Blackbeard will look in the DOS environment for the
  122. symbol BBCFG, if it is found it will use the filename supplied
  123. with the symbol. This will let you keep one configuration file
  124. and use Blackbeard from any disk or directory.
  125.  
  126.    To set BBCFG place this command or one similar in you
  127. autoexec.bat file
  128.  
  129.          SET BBCFG=C:\BB.CFG
  130.  
  131.    See the OPTIONS/SETTINGS menu for the read and save
  132. configuration commands. These commands will request a filename
  133. and default to the current path and BB.CFG filename if none is
  134. given.
  135.  
  136.    In addition to options and settings, keystroke macros, and
  137. key bindings can be saved and loaded in upon initialization.
  138. See bb.doc for more details.
  139.  
  140. MENUS
  141.  
  142.    To access the menus and learn the commands press the escape
  143. <Esc> key and the menu will pop-up. You can execute a command or
  144. select any submenus by positioning the cursor on the item (using
  145. the keypad keys) and pressing the enter key (─┘). To exit a menu
  146. without choosing an item press the escape key. The menu action
  147. will be taken where the cursor was before you entered the menu.
  148. WIth few exceptions the menu commands all have their direct
  149. keyboard counterparts which are described to the right of the
  150. English command description. The direct commands use the keyboard
  151. letters and the shift () , Alt, and control (Ctrl) keys. The
  152. following describes how they are shown:
  153.  
  154.          ^R - means Ctrl-R
  155.          R - means Shift-R
  156.          αR - means Alt-R
  157.  
  158.    The function keys are designated as F1 - F10.
  159.  
  160. OPTIONS MENU AND STATUS LINE MENU
  161.  
  162.    The options and status line menus toggles with ON shown as
  163. high intensity and OFF as normal intensity. To toggle an item use
  164. the enter key.
  165.  
  166. THE MOUSE
  167.  
  168. Microsoft
  169.  
  170.    Blackbeard includes integral mouse support for the Microsoft
  171. mouse. Mouse movements are tranlsated into cursor movements; the
  172. left button is translated to enter and used to select menu items;
  173. the right button is translated to escape and used to pop-up and
  174. exit menus.
  175.  
  176. Mouse Systems
  177.  
  178.    The Blackbeard distribution diskette includes a mouse menu
  179. driver for the Mouse Systems Mouse. To use the mouse install the
  180. PC mouse menu driver by running MOUSESYS (this is described in
  181. your Mouse Systems Manual). Run the Blackbeard menu program with
  182. the following command:
  183.  
  184.       M_BB
  185.  
  186.    This will install a mouse driver for Blackbeard. Mouse
  187. movements are tranlsated into cursor movements; the left button
  188. is translated to enter and used to select menu items; the right
  189. button is translated to escape and used to pop-up and exit menus;
  190. the middle button and pressing the left and right buttons
  191. simultaneously (emulates αE) will repeat the last menu command.
  192.  
  193. SKULL & CROSSBONES
  194.  
  195.    Blackbeard's logo is a skull & crossbones that comes up when
  196. it is executed.  Since this logo can be annoying to some, here is
  197. how you can "patch" your bb.cfg to eliminate the skull &
  198. crossbones:
  199.  
  200.    Byte 254 (decimal) of the BB.CFG file
  201.  
  202. LEARNING TO USE BLACKBEARD
  203.  
  204.    The best way to learn how to use Blackbeard (or any product)
  205. is to use it.
  206.  
  207. Distribution and Registration
  208.  
  209.    As you know software copyright violation is rampant. This is
  210. why we have created Blackbeard. Because Blackbeard is a superior
  211. text editor and available for free distribution, there will be no
  212. need to pirate copyright sfotware to obtain advanced text editing
  213. features. Please feel free to give Blackbeard to you friends. We
  214. are counting on you as a participant in the largest distribution
  215. network in the nation (the owners and users of PCs) to make
  216. Blackbeard a popular product. With strong user support,
  217. Blackbeard will be enhanced with new features and capabilities
  218. making it the programmer's editor of choice.
  219.  
  220.    For twenty (20) dollars you can become a registered owner of
  221. Blackbeard. For your $20.00 you will appease your conscience
  222. about using unregistered software, receive a distinctive
  223. "Blackbeard" collectable, and a copy of the latest version of
  224. Blackbeard.  The file FORM.TXT can be used as an order form.
  225.  
  226.  
  227.  
  228.  
  229.  
  230.             SEND A CHECK MADE OUT TO BLACKBEARD TO:
  231.  
  232.                Blackbeard
  233.                1198 E. Baseline St.  Suite 113
  234.                San Bernardino, California  92410
  235.  
  236.  
  237.             We thank you for your support.
  238.