home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / b / bingo300.zip / READ.ME < prev    next >
Text File  |  1992-10-18  |  15KB  |  337 lines
  1.                          Read Me file for Bingo 3.00
  2.                          ---------------------------
  3.  
  4.           "I feel you have done a great programming job with
  5.      Bingo ..."
  6.  
  7.           "I've chosen Bingo over most of its competition.  It's
  8.      fully featured and configurable and offers and extensive
  9.      menuing system for access to infrequently used commands."
  10.  
  11.           "Enclosed is my registration for Bingo.  This is a fine
  12.      piece of work.  I must especially compliment the mouse
  13.      interface, which is the best I have seen."
  14.  
  15.           "Great editor!  Exactly what I've been looking for.
  16.       Please send the current version if I don't have the
  17.       latest."
  18.  
  19.           "Keep up the good work, Bingo surely is one of the best
  20.      editors around and deserves success."
  21.  
  22.           "Bingo's great!"
  23.  
  24.           "Bingo is an excellent text processor."
  25.  
  26.           "Couldn't live without Bingo now!"
  27.  
  28.      These are some of the things people have said about The
  29. Bingo Programmer's Text Editor.  Now that you have this copy in
  30. your hands, you can see for yourself what all the excitement is
  31. about.
  32.  
  33.    This file list various pertinent information about the Bingo
  34. Programmer's Text Editor such as:
  35.    -->   included files
  36.    -->   features of Bingo, and what's new with this version
  37.    -->   major bugs fixed in this version
  38.    -->   some notes about registering
  39.    -->   quick guide to geting started
  40.    -->   author's comments
  41.    -->   how to contact the author
  42.    -->   how to acquire the latest version
  43.    -->   upgrade policy
  44.    -->   registering Bingo through the Public (software) Library (PsL)
  45.  
  46. Included files on disk/in archive:
  47. ----------------------------------
  48.  
  49.    READ.ME      : this file.  chock full of *extremely* important
  50.                   stuff -- read this completely
  51.  
  52.    BE.EXE       : Bingo Editor 3.00 executable
  53.  
  54.    KEYCFG.EXE   : Bingo Editor 3.00 Key Definition executable;
  55.                   translates your definitions from text to
  56.                   Bingo's 'compiled' format.
  57.  
  58.    KEYINFO.EXE  : Bingo Editor 3.00 Key Information executable;
  59.                   extracts plain text definitions from Bingo's
  60.                   compiled format.
  61.  
  62.    HEXKEY.COM   : Executable to determine Hexadecimal value of
  63.                   keystrokes for Keycfg or Chess
  64.  
  65.    BINGO.DOC    : documentation for Bingo; ready to be printed out
  66.                   on an ascii line printer, laser printers included.
  67.  
  68.    REGISTER.DOC : copy of the license agreement and registration
  69.                   form, ready to be printed out on an ascii line
  70.                   printer.
  71.  
  72.    KEYCFG.SET   : compiled key configuration from BINGO.CFG, file
  73.                   Bingo looks for on startup
  74.  
  75.    BINGO.INI    : initialization file for Bingo 3.00
  76.    
  77.    BINGO.HLP    : help file for the supplied sample keyboard
  78.                   definition file (the one I use)
  79.  
  80.    BINGO.CFG    : sample keyboard definition file (the one I use)
  81.                                 
  82.  
  83.    Additionally, a number of additional *.cfg files:
  84.                   
  85.    WSKEY.CFG    : sample Wordstar-Like key definition file
  86.    WPKEY.CFG    : sample WordPerfect-Like key definition file
  87.    EMACS.CFG    : sample Emacs-Like key definition file
  88.  
  89.    And a number of *.chs sample Chess files:
  90.    ASK.CHS      : sample Chess program which, along with ASK.TXT,
  91.                   which will present a list of config options,
  92.                   ask you to pick one, then display its current
  93.                   setting.
  94.    HEXKEY.CHS   : sample Chess program which will display the
  95.                   return value of a recognized keystroke, simlar 
  96.                   to HEXKEY.COM
  97.    SIDEBY.CHS   : two sample Chess functions which, when attached
  98.                   to keys via KEYCFG, will allow side-by-side
  99.                   synchronized scrolling of two vertical windows.
  100.  
  101. Features of Bingo through version 3.00
  102. --------------------------------------
  103.    - high speed execution, with particularly fast searches,
  104.      screen handling, and file I/O
  105.    - virtual memory for file storage; up to 240 Megabytes of file
  106.      storage possible                
  107.    - CHESS C-like interpreted language giving you access to
  108.      Bingo's powers in a true programmable language with looping,
  109.      decision making, functions, variables and more.
  110.    - more friendly execution under OS/2, Windows, and other DOS
  111.      multitasking systems
  112.    - full color support       
  113.    - programmable integrated mouse support 
  114.    - support of VGA, EGA, & MCGA extended text modes 
  115.    - superb macro capability 
  116.    - large suite of utility functions: entab; detab; 
  117.      command repeat; shift; etc.  
  118.    - custom define your own keyboard setup 
  119.    - complete menu system supporting most Bingo functions 
  120.    - multiple files, multiple windows: view different sections of
  121.      the same file, or different files at the same time
  122.    - execute DOS commands, including command-line compilers
  123.      within only ~3k of overhead
  124.    - regular expression search and replace 
  125.    - completely configurable from within itself 
  126.    - use placemarks to mark positions in files 
  127.    - user definable help file 
  128.    - extensive block operation support, include point, line and
  129.      column marking, and two different sets of block operations
  130.    - one default block buffer, plus 26 additional named buffers
  131.    - wordwrap, paragraph formatting, and autoindent support included
  132.      for text processing work
  133.    - C Mode supports programming in the C programming language
  134.    - User-defined delimiter and indentation matching 
  135.    - directory list picker 
  136.    - execute *any* Bingo function from within Bingo whether it
  137.      has been assigned to a key or not using a 'function picker'
  138.    - interrupt Bingo at any point and exit, and when you restart
  139.      Bingo it will pick up exactly where you left off
  140.    - print files & blocks through the serial port, parallel port,
  141.      or to a file, with or without line numbers
  142.    - set printing left margin, top margin, and lines per page 
  143.    - automatic processing of errors generated by the Borland and
  144.      Microsoft developmental tools.  
  145.    - undelete stack of deleted items
  146.    - execute any command or macro "globally" over all files in the ring 
  147.    - profile files allow file extension specific settings.
  148.  
  149. Bugs Fixed in Version 3.00
  150. --------------------------
  151.    A host of small bugs were squashed.  A couple of the larger
  152. ones are:                           
  153. -  fixed a bug with Bingo not saving the configured Matching
  154. Delimiters into the BINGO.INI file
  155. -  fixed a bug which prevented Bingo from starting up in anything
  156. but the current screen dimensions.
  157. -  fixed a bug where Bingo did not save configured matching
  158. delimiters.
  159. -  fixed a bug in exiting files when the 'conf_win_close' option
  160. was turned off.
  161. -  fixed a bug with Bingo not always keeping the cursor size
  162. updated properly when switching between files.
  163.    
  164. New features of Version 3.00
  165. ----------------------------
  166. -  'conf_macro_death' is no longer available; tapping the Scroll
  167. Lock key now interrupts macro execution as well as repeating
  168. keys.
  169. -  rewrote the box draw routine to mix single and double lines
  170. nicely, and to allow an 'erase' mode.
  171. -  'conf_wild_load' controls the loading of wildcarded filenames. 
  172. You can specify that Bingo:
  173.    1) *never* automatically load all matches
  174.    2) automatically load all matches *only* at startup
  175.    3) automatically load all matches *only* after startup
  176.    4) *always* automatically load all matches
  177. -  KEYCFG now allows you to define 3-key combinations as well as
  178. 1- and 2-key combinations.  This should allow for nice emulation
  179. of the WordPerfect (TM) keyboard layout.     
  180. -  KEYINFO updated to produce nicer output.
  181. - 'threekey_def' added to support defining 3-key combinations.
  182.  
  183.    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  184.    !   AND ... ... ... A TRUE INTERPRETED COMMAND LANUGAGE!   !
  185.    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  186.  
  187. -  That's right folks.  I have added a whole new dimension to
  188. Bingo's power.  Version 3.00 introduces CHESS, Bingo's
  189. interpreted command language.  Chess is a minimal C-Like
  190. interpreter and includes programming constructs such as while
  191. loops, if-then-else statements, variables, function calls, and
  192. more.  Chess subprograms can interrogate many of Bingo's internal
  193. variables, can ask for user input, and do many other things. 
  194. Chess code can be placed directly into a *.cfg file and assigned
  195. to keystrokes if desired.  Files containing Chess subprograms can
  196. be executed.  Profile files have been updated to allow a Chess
  197. command file to be run each time the profile file is loaded.
  198. - 'exec_chess' function added which executes a previously defined
  199. Chess function, with parameters if necessary.
  200. - 'interpret' added as a KEYCFG/KEYINFO function only; this
  201. provides identical functionality to 'exec_chess' except it is a
  202. bit faster.
  203. - 'conf_chess_trace' function added to allow you to "step"
  204. through the execution of a Chess subprogram.
  205. - searching and replacing in marked areas is now handled
  206. differently.  By choosing the 'M' modifier in the options box,
  207. Bingo will search from the current cursor position (if you are
  208. inside the block) or the start of the block until the end of the
  209. block.  The target string must be completely enclosed in the
  210. marked area.  All three types of marked blocks are supported.
  211. - 'mark_word' function added which marks the current word
  212. according to the current word definition.
  213. - added the -c command line flag, which allows you to specify a
  214. Chess program file for Bingo to execute after startup.  Syntax
  215. is:   be.exe -c<chess name>.  <chess name> will be executed as
  216. the last thing before turning Bingo over to user control.
  217. - 'conf_dialogue' function allows you to choose between Bingo's
  218. interface.  It allows either Bingo's classic "boxes" method or
  219. two variations using a command-line at the bottom of the screen.
  220.  
  221. Upgrades
  222. --------
  223.    This is the release of version 3.00.  Users who are currently
  224. registered users of Bingo are entitled to upgrades according to
  225. the following chart.
  226.  
  227.       Version           Registration      Entitled to
  228.       -------           ------------      -----------
  229.       2.01 or before    any               v3.00 for USD $5.00
  230.       2.10 (x)          Lifetime          v3.00 for USD $5.00
  231.       2.10 (x)          One-time          none
  232.       2.11 (x)          Lifetime          v3.00 for free
  233.       2.11 (x)          One-time          v3.00 for free
  234.       
  235. Registering
  236. -----------
  237.    Starting with version 2.10, there is a two-tiered registration
  238. method.  You can register for the current version, one time only,
  239. for $40.00.  This is called Single Version registering.  This
  240. type of registration entitles you to use the current version of
  241. Bingo, and to support for that version.
  242.    You can also opt for the Lifetime registration, for $75.00.
  243. This entitles you to subsequent revisions for a $5 fee,
  244. and support for as long as the product is available.
  245.    People who registered prior to version 2.10 are automatically
  246. upgraded to Lifetime registrations.
  247.    When you register your copy of Bingo, you will get an
  248. executable with your name on the opening screen, so you can show
  249. everyone what an honest person you are.
  250.  
  251. Contacting the Author:
  252. ----------------------
  253.    Feel free to contact me any time about any problems, suggestions,
  254. or just plain discussions concerning Bingo, regardless of whether
  255. you are registered.  Without users, any product, now matter how
  256. good, is so much raw data sitting on a disk somewhere.  Either
  257. write or call to this address:
  258.  
  259.                   Christopher R. S. Schanck
  260.                   PO Box 279
  261.                   Hanover MD 21076
  262.                   (410) 379-9019
  263.  
  264. if that number should give you any trouble, use:
  265.  
  266.                   (215) 691-1070
  267.                   9am to 6pm EST
  268.  
  269. Compuserve
  270. ----------
  271.    Contact me at 70541,3614.  This is the most reliable way to
  272. contact me, as I check my email regularly.
  273.  
  274. PsL Shareware Registration
  275. --------------------------
  276.      You can order directly from me at the above address or from
  277. Public (software) Library with your MC, Visa, AmEx or Discover
  278. card by calling 800-2424-PsL or 713-524-6394 or by FAX to
  279. 713-524-6398 or by CompuServe to 71355,470 or by mail to PsL, PO
  280. Box 35705, Houston, Texas 77235-5705.  Bingo's order # is 10399.
  281. Please use this number when ordering if possible.  These numbers
  282. are for ordering only.  For information about dealer pricing,
  283. volume discounts, site licensing, shipping of product, returns,
  284. latest version number or other technical information, contact me.
  285.                                       
  286. Quick Guide to Getting Started
  287. ------------------------------
  288.    Getting started with Bingo is very easy.  Copy all of the
  289. files into one directory, such as c:\bingo.  Place this directory
  290. in your PATH= statement in your CONFIG.SYS file (this change
  291. won't take effect until you reboot).  Now type:
  292.    be <filename>
  293. to start Bingo editing the file <filename>.
  294.    Once in Bingo, there are a couple of keys which are important
  295. to remember.  In particular, the Escape key will bring up the
  296. main menu (kinda important!) and the F1 key will pop up the help
  297. file.  The help file will list most basic commands, but
  298. navigation will work as you might expect, with the arrow keys and
  299. PgUp & PgDn moving the cursor.
  300.    Have fun!
  301.  
  302. Comments & Notes
  303. ----------------
  304.    Version 3.00 of Bingo is most capable, sophisticated version
  305. of Bingo ever shipped.  It comes with more documentation, more
  306. sample files, and more auxilary tools than any previous version. 
  307. For example, v3.00 comes with 4 keyboard definition files,
  308. including Emacs-, Wordstar-, and Wordperfect-like files, plus a
  309. newly revamped default Bingo definition.  The help file for the
  310. default setup has likewise been polished.
  311.    KEYINFO is much more capable than it has been in previous
  312. versions, while BOPTS replaces PAGESIZE and adds much more
  313. functionality.  And last but not least, the base documentation is
  314. now greatly expanded.
  315.    
  316. Getting the Latest Version
  317. --------------------------
  318.    There are two sure ways to aquire the latest version of Bingo.
  319. One is by calling the Computer Connections BBS in Washington DC.
  320. This is a very fine, very large board which is excellently
  321. managed.  It will always have the latest release, and E-Mail left
  322. for me their will get responded to.  The phone number is:
  323.    (202) 547-2008
  324.  
  325.    The other way is to look for it on Compuserve, usually as
  326. BINGOX.ZIP or BExxxx.zip in the IBMAPP area.
  327.  
  328. Hints
  329. -----
  330.      I would like to compile a list of hints to include with Bingo.
  331. Most users have discovered sharp little tricks about configuring
  332. Bingo, and about using the more complex functions.  So send me
  333. your ideas for this file, and it may get included in the next
  334. release.  This includes any nifty macros you come across, and
  335. with the advent of Chess, Chess functionality you come up with.
  336.  
  337.