home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / forth / compiler / fpc / doc / newz.txt < prev    next >
Text File  |  1991-03-14  |  10KB  |  217 lines
  1. NEWZ.TXT                The NEW Zimmers Editor              02/22/90
  2.  
  3.   Welcome to the "NEW IMPROVED" Zimmer's editor/environment. The
  4. NEWZ.ZIP file contains the following files:
  5.  
  6.         NEWZ.EXE        The Full featured version of Zimmer's editor.
  7.         NEWZ.CFG        A configuration file for NEWZ.EXE.
  8.         NEWZ.TXT        This documentation file.
  9.         ZHELP.TXT       The hypertext help system.
  10.         HYPER.NDX       The hypertext index file for ZHELP.TXT.
  11.         SZ.COM          A small version of Zimmers editor (25k).
  12.         ZZ.COM          An environment manager.
  13.         ZZ.CFG          A document that sets up ZZ.
  14.         INDEX.COM       A stand alone version of the index compiler.
  15.         INDEX.CFG       The configuration file for INDEX.COM
  16.  
  17. Getting started
  18.  
  19.   The NEWZ.CFG file needs to be either in the directory where you are
  20. editing, or in the ROOT directory of the current drive.  NEWZ.CFG is a
  21. text file that sets the editors options, and tells NEWZ where to find
  22. its files.  The default contents of NEWZ.CFG specify that NEWZ's files
  23. are in the directory "\FPC\NEWZ".  You can edit NEWZ.CFG if you have
  24. installed NEWZ in some other directory.  NEWZ must access NEWZ.CFG,
  25. HYPER.NDX, and ZHELP.TXT for the online hypertext help system to work.
  26.  
  27.   Several changes have occured since the last NEWZ release, converting
  28. NEWZ into an environment for whatever compiler you are using.  You can
  29. of course still use NEWZ like you did before, as a normal text editor.
  30.  
  31. What Does It Mean?
  32.  
  33.   Many of you have probably seen versions of the Turbo Pascal compiler
  34. over the years. It is a good compiler, but what impressed many people
  35. was the ability to perform the "EDIT, COMPILE, DEBUG" cycle from within
  36. the compiler. Turbo Pascal provides an integrated environment for
  37. program development.  This is an idea that was really pioneered by
  38. Basic, you can do whatever you need to do without leaving Basic.
  39. Compilers of course provide their own set of problems when it comes to
  40. interactivity. They are mostly command line driven, with many options to
  41. be typed with each command. MAKE utilities automate this to a large
  42. degree, but still don't shorten the actual development cycle while
  43. working on an individual module of a program. This is where ZZ and NEWZ
  44. come in to connect together your the Edit, Compile, Debug and Make
  45. process into an environment that invokes each major operation with a
  46. single keystroke.
  47.  
  48.  
  49.                     ┌─ ^F1 ───> Edit <current_file>.MSG file
  50.                     │
  51.                     ├─ ^F2 ──-> Execute <current_file>.COM or .EXE
  52.                     │
  53.                     ├─ ^F4 ───> Edit ZZ.CFG file
  54.                     │
  55.                     ├─ ^F5 ───> Compiler
  56.                     │
  57.         ZZ/NEWZ ────┼─ ^F7 ───> Debugger
  58.                     │
  59.                     ├─ ^F8 ───> Build "C" HYPER.NDX file
  60.                     │
  61.                     ├─ ^F9 ───> Linker
  62.                     │
  63.                     └─ ^F10 ──> Make
  64.  
  65.  
  66.  
  67.  
  68.   ZZ consumes only about 12k of you valuble program memory, and retains
  69. no memory when you leave the environment.
  70.  
  71.  
  72.   In addition, this version of the NEWZ editor includes features that
  73. make it very useful when working with multiple source file programs.
  74. NEWZ can now compile an index file of all symbols in your source files.
  75. It then provides a hypertext browsing environment where you can easily
  76. view, change, and explore a multitude of source files with full nest and
  77. return to where you were. Locating any symbol in a multi-thousand symbol
  78. index file on an 80286 machine takes less than one second. This version
  79. of NEWZ supports Forth type symbols, and assembly symbols. Support for
  80. "C" is also provided by the program CTAGS.EXE. See NEWZ's hypertext help
  81. under configuration for details of how to setup and build an index file
  82. of your source files.
  83.  
  84. Additional Features
  85.  
  86.   NEWZ includes many features, here is a brief summary:
  87.  
  88.         1. Work with up to 20 files at one time. (Only one file is in
  89.         memory but switching between files with a hard disk is very
  90.         quick, and requires only a single keystroke.)
  91.  
  92.         2. Pull down menus and pop up dialog boxes are supported for
  93.         ease of use, along with "POWER" Control and Alt sequences for
  94.         experienced users.
  95.  
  96.         3. Hypertext help is provided to ease the learning process.
  97.  
  98.         4. Searching is supported within a file, and across multiple
  99.         files, to help find any file that contains a particular
  100.         character sequence.
  101.  
  102.         5. You can "Shell" out to DOS to perform any needed commands,
  103.         and you can easily repeat a particular DOS command with a two
  104.         key sequence. This allows NEWZ to be your shell when performing
  105.         repeated compiles.
  106.  
  107.         6. DOS commands can be typed into documents, and performed with
  108.         a single keystroke. "Alt-F2"   "<dir;pause>"
  109.  
  110.         7. Keystroke Macros are provided, to ease those operations that
  111.         need to be repeated. A repeat function allows a macro to be
  112.         performed a specified number of times.
  113.  
  114.         8. A search path is supported, allowing NEWZ to find a file you
  115.         specify across directory boundries without having to type in the
  116.         actual path at file open time.
  117.  
  118.         9. You can set the default file extension to any three
  119.         characters. The specified extension will be applied to a file
  120.         when no extension is specified.
  121.  
  122.         10. Full margin control is provided, with paragraph reformat.
  123.         Word wrap can be turned on or off, or set to a default value.
  124.  
  125.         11. Maximum file size is limited by available memory, and will
  126.         typically be greater than 250k on a 640k machine.
  127.  
  128.         12. Full Cut/Copy/Paste is supported within and between files.
  129.  
  130.         13. Line drawing allows documents that will be printed on IBM
  131.         compatible printers to box sections of text, and use graphic
  132.         characters and bullets to hilight sections.
  133.  
  134.         14. Paragraph line sorting is provided to allow simple document
  135.         databases to be created. Sorting is performed on the current
  136.         column down to the next blank line.
  137.  
  138.         15. EGA/VGA high resolution text modes are supported, NEWZ will
  139.         automatically adjust to whatever screen size your display is set
  140.         for up to 132 columns by 60 lines.
  141.  
  142.         16. Search and replace including global replace are provided.
  143.  
  144.         17. You can create your own hypertext systems for training.
  145.  
  146.         18. SPEED! NEWZ is very fast, moving around a document, or from
  147.         one end to the other, is limited by the repeat rate of your
  148.         keyboard, not NEWZ's redisplay speed. On a 4.7 MHZ 8088 machine,
  149.         NEWZ can redisplay more than ten full (80x24) screens per
  150.         second.
  151.  
  152.         19. Both COLOR and MONOCROME are supported automatically with no
  153.         installation required for your hardware.
  154.  
  155.         20. NEWZ automatically reconizes and supports a mouse when a
  156.         driver is present. The mouse can be used with pulldown menus,
  157.         cursor positoning, scanning through a document, and text line
  158.         selection for Cut and Copy operations.
  159.  
  160.         21. You can specify in the NEWZ.CFG configuration file whether
  161.         you want backup copies kept of your edits.
  162.  
  163.         22. ZZ turns NEWZ into a compiler environment/director.
  164.  
  165.         23. "Alt-O S" toggle between expanding TABs and showing them as
  166.         a character.
  167.  
  168.         24. LASERJET and PROPRINT are supported printer drivers now with
  169.         an option in the NEWZ.CFG file.
  170.  
  171.         25. TABSIZE n1, and TABX ON|OFF allow setting the tab size in
  172.         the configuration file, as well as specifying whether tabs
  173.         should be expanded when editing. The default is EXPAND TABS.
  174.  
  175.         26. "Ctrl-\" displays the current memory usage in the computer.
  176.  
  177.         27. Modified F-PC so that all programs (including the Z editor)
  178.         will now flush themselves to Expanded memory if there is enough
  179.         available when shelling out to do a DOS command. This frees up
  180.         all except about 8000 bytes of program space for any other
  181.         thing you might want to do while shelled to DOS.
  182.  
  183.         28. New parameters in NEWZ.CFG, "SWAPEMM ON|OFF" to control
  184.         whether the editor will try to use expanded memory when
  185.         shelling to DOS, and "SWAPFILE <filename>" that will allow the
  186.         editor to try to swap itself to a file when shelling out to
  187.         DOS. The file specified can be on any drive, but will be very
  188.         slow unless it is on a RAMDRIVE.  SWAPEMM defaults to ON, and
  189.         SWAPFILE defaults to disabled.
  190.  
  191.         29. Added the TCOMed version of INDEX to the NEWZ .ZIP file.
  192.         This allows you to index a bunch of files automatically,
  193.         without having to startup the NEWZ editor and manually using
  194.         the build index function in the file menu.
  195.  
  196. Shareware
  197.  
  198.   The NEWZ editor is shareware. If you find NEWZ useful in your daily
  199. work, join other satisfied users and register your copy by sending a
  200. check for $60.00 to the address below.  Be sure to specify the NEWZ
  201. editor in your letter, and include a return address.  You will receive
  202. the latest copy of NEWZ.  If you also want the source for NEWZ, include
  203. an additional $50.00 ($110.00 total), and specify that in your letter.
  204. The F-PC Forth development system on which NEWZ is built will be
  205. included with the latest source for NEWZ.
  206.  
  207.   Register TODAY by sending your check to the following address.
  208.  
  209.                                 Tom Zimmer
  210.                                 292 Falcato Drive
  211.                                 Milpitas, Ca. 95035
  212.                                 U.S.A.
  213.  
  214.                                         Home (408) 263-8859
  215.                                         Work (408) 954-6946
  216.  
  217.