home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0040 - 0049 / ibm0040-0049 / ibm0040.tar / ibm0040 / DBRIEF.ZIP / READ.ME < prev    next >
Encoding:
Text File  |  1991-04-24  |  10.3 KB  |  221 lines
  1.  
  2.                            Addendum Documentation
  3.                               dBRIEF For dBase
  4.                                v3.10 for DOS
  5.  
  6.                                March 10, 1991
  7.  
  8.                (Certified for use with BRIEF v3.1 And Later)
  9.  
  10. To report bugs, suggestions, or other items, you may call Customer Support
  11. at (617) 431-2338, or Global Technologies at (303) 337-7758.
  12.  
  13. -  Conditions that may cause problems:
  14.  
  15.     * If you run SETUP while viewing the file DBRIEF.H your system will hang.
  16.  
  17.     * If you attempt to run any dbrief interface option while viewing 
  18.          INTERFAC.CFG, it will appear to hang, just press Alt-N if you have
  19.          other buffers in memory.  If not, you must exit from BRIEF.
  20.  
  21.     * If you attempt to print a file via the spool option BEFORE invoking the
  22.          TSR print spooler, PRINT.COM BRIEF will hang.
  23.  
  24.     * Some keyboard assignment may not work on all keyboards.  Make sure the 
  25.          101KEY.DRV driver file is invoked.
  26.  
  27.     * Long text in setup fields such as author name causes problems
  28.          specifically related to memory management and the dialog manager.
  29.  
  30.     * A BRIEF line length less that 230 characters will cause some template
  31.          expansion keywords to not function properly.  Additionally, macro 
  32.          compilation problems can be experienced.
  33.  
  34.  
  35.  
  36. Documentation Updates
  37. ______________________________________________________________________________
  38.  
  39. -  The dBRIEF User's Guide incorrectly describes this release as v3.0.  The
  40.    text should read v3.1.
  41.  
  42. -  A mouse interface was added to dBRIEF v3.1 at the last minute.  As a
  43.    result, time was not available to update the dBRIEF User's Guide.  Refer
  44.    to the following notes for information about the mouse interface:
  45.  
  46. -  The mouse can be used whenever you display one of the menus associated
  47.    with:  Assistance, Help, the APX dictionary, External interfaces,
  48.    Graphics, Scanning, and the SourceView library.
  49.  
  50. -  The mouse can be used as follows:
  51.   
  52.    Close menu window -- Click on Close button at top of menu window
  53.    Move to menu item -- Click on desired menu item
  54.    Select menu item  -- Double-click on desired menu item
  55.    Scroll down one line -- Click on down arrow in vertical scroll bar
  56.    Scroll up one line   -- Click on up arrow in vertical scroll bar
  57.    Scroll down one page -- Click below thumb in vertical scroll bar
  58.    Scroll up one page   -- Click above thumb in vertical scroll bar
  59.  
  60.  
  61. Operational Notes
  62. ______________________________________________________________________________
  63.  
  64. -  There are significant changes in this new version of dBRIEF, and if there 
  65.    was one word that best described the enhancements, it would be 
  66.    "customizable".  The primary header file for dBRIEF, DBRIEF.H, is full of 
  67.    flags and switches that let you define the behavior of dBRIEF.  Please 
  68.    familiarize yourself with this file by reading the technical reference 
  69.    section of the manual and perusing the header file.
  70.  
  71. -  Because of the dependencies of various macros, it is best to terminate your
  72.    BRIEF editing session and recompile the dBRIEF macros whenever you change a
  73.    header file constant.  This is accomplished by using the batch file CDBRIEF
  74.    as shown below:
  75.  
  76.       C:\BRIEF\DBRIEF> cdbrief <HeaderConstant>  [enter]
  77.  
  78.  
  79. Bug Fixes [Version 3.10]
  80. ______________________________________________________________________________
  81.  
  82. -  Alt-E with a double-dot wild card path specifier such as {..\dir\*.prg}
  83.    or a direct path specifier starting at the root level, incorrectly creates 
  84.    new buffers of the matching names in the current edit directory.  This has 
  85.    been fixed so that it is possble to use direct path and double-dot 
  86.    specifiers with wild card edits from within BRIEF.
  87.  
  88. -  The new ability to direct the previous scan menu file to a TMP or BTMP
  89.    directory will cause a problem if the environment value isn't followed 
  90.    by a back slash {\}.  This has been fixed so that the forms shown below 
  91.    are supported.
  92.  
  93.       set tmp=e:\    or...    set tmp=e:     or...    set tmp=c:\brief
  94.  
  95. -  The PVCS interface was being confused by the dBRIEF messages on startup.
  96.    The messages have been moved out of the _init() macro and into the
  97.    dbrief() macro to eliminate confusion.
  98.  
  99. -  The page number on printed output will now be formatted properly. 
  100.    Previous versions caused the page number to drift beyond the right margin.
  101.  
  102. -  Wildcard editing from within BRIEF was not able to parse the file path pro-
  103.    perly when reading files from the root directory.  This has been fixed so
  104.    that both formats shown can be used.
  105.  
  106.       File [dBASE IV-PRG def]: a:\*.prg
  107.    or...
  108.       File [dBASE IV-PRG def]: a:*.prg
  109.  
  110. -  The time keyword for the header template language has been modified to re-
  111.    turn proper times after 12 o'clock noon and before 1pm.
  112.  
  113. -  Source.m was modified to not display long output file names in the command
  114.    prompts.
  115.  
  116. -  The help and assist menus have been modified to display menus in 43, 50,
  117.    and 60 line mode without displaying extra blank lines in the menu.
  118.  
  119. -  The "uncomment block" feature has been fixed so that it will handle
  120.    varying types of comments now used by Clipper 5.0.
  121.  
  122. -  The DO C and DO W template expansion routines have been modified to
  123.    delete the extra new line created during expansion.
  124.  
  125. -  Added the WHILE...ENDDO structure to the Clipper 5.0 support paradigm.
  126.  
  127. -  DISPLAY STRUCTURE and SCATTER/GATHER commands now work properly when
  128.    editing files that have extensions other than "PRG".  These commands were
  129.    improperly blocked except during PRG file editing.  The command block has 
  130.    been removed.
  131.  
  132. -  SCATTER, GATHER, and INITIALIZE has been fixed so that leading memvar 
  133.    characters are now inserted properly.  Case for the leading and trailing 
  134.    memvar character is also now preserved.
  135.  
  136. -  The Clipper 5.0 block commenting command has been fixed so that the //
  137.    comment type can be used.  Previously, the command {comment block //}
  138.    would produce a single slash comment in the marked column.
  139.  
  140. -  The DOW template expansion was entering a space following the .T. and
  141.    leaving the cursor on the same line.  This has been fixed so that it simply
  142.    places a new line character at the end of the line.
  143.  
  144.  
  145. Enhancements [Version 3.10]
  146. ______________________________________________________________________________
  147.  
  148. -  To better support preprocessor constants and #include files, a new lookup
  149.    feature has been added that allows you to quickly see the value assigned to
  150.    a constant #DEFINEd in the current buffer or a separate #INCLUDE file. 
  151.    Simply position the cursor to the first character of the preprocessor
  152.    constant, and press Alt-UpArrow.  dBRIEF will search backwards from the
  153.    cursor location for a matching #define.  If not found in the current
  154.    buffer, the search will continue in reverse order through all specified
  155.    include files listed in the current buffer.  The specified #include files
  156.    will be searched for in memory first, then on disk in the current buffer,
  157.    followed by a final search in the DOS include environment variable.
  158.  
  159. -  In both the object editing and preprocessor searching features, #include
  160.    formats can now be expressed in any of the following three formats.
  161.  
  162.       #include     file.h
  163.       #include    "file.h"
  164.       #include    <file.h>
  165.  
  166.    dBRIEF will also search the DOS environment variable INCLUDE for files
  167.    when using either of these features.  A search of the INCLUDE directory
  168.    will begin after the file has been looked for on the current directory.
  169.  
  170. -  A new scan gateway has been added that allows you to point at a word,
  171.    variable, or phrase and launch a scan operation.  From the cursor
  172.    position forward, the text is parsed to the next word and immediately
  173.    submitted to the scanner by pressing Ctrl-DnArrow.  This eliminates an
  174.    enormous amount of typing.  Additionally, the Ctrl-DnArrow can be invoked
  175.    with a marked string to invoke a scan for text highlighted by the marked
  176.    area.
  177.  
  178. -  The load time of dBRIEF has been slightly improved in this version.
  179.  
  180. -  The CDBRIEF batch file is now more intelligent.  It has the capability of
  181.    compiling all dBRIEF macros, or just the ones necessary when a header con-
  182.    stant has been changed.  For instance, if you change the constant
  183.    dbr_mem_trail, CDBRIEF will compile DISPLAY.M, SETCMDS.M, and appropriate
  184.    surfaces when invoked as follows:
  185.  
  186.       C:\BRIEF\DBRIEF> cdbrief dbr_mem_trail  [enter]
  187.  
  188.    The parameter that you pass to CDBRIEF must be lower case, and only one
  189.    parameter is allowed.  The compilation process is optimized by the batch 
  190.    file so you don't waste time recompiling everything.  CDBRIEF can still
  191.    compile all macros by invoking it without a parameter.
  192.  
  193. -  The Scanner has been enhanced to support scanning options for UDFs (user
  194.    defined functions), UDPs (procedures), and UDCs (user defined commands)
  195.    which are now supported by Clipper 5.0 and the dBASE IV Pro Compiler. 
  196.    The command syntax's are shown below.
  197.  
  198.       Command+: scan udfs        (same as "scan functions")
  199.       Command+: scan udps        (same as "scan procedures")
  200.       Command+: scan udcs
  201.  
  202.    Currently, the UDCS command option simply looks for preprocessor
  203.    command definition statements such as "#command" as used in Clipper 5.0.
  204.    As other language vendors add UDCs to their products, dBRIEF will be
  205.    modified to address those designs.
  206.  
  207. -  The scanner has also been modified to save the previous scan menu file in
  208.    the BTMP or TMP environment variable directory.  It reads the environment
  209.    variable (if it exists) and uses the path specification for storage and
  210.    retrieval of the previous scans.  If the BTMP is pointing to a RAM drive,
  211.    scanning performance can be increased substantially.
  212.  
  213. -  The scanner has also been modified to use BRIEFs case sensitivity
  214.    status.  The status is controlled with Ctrl-F5.
  215.  
  216. -  The "coordinates" string used for window coordinate translations has
  217.    been modified to include differing support for compilers and interpreters. 
  218.    The string created for dBASE III Plus, FoxBase+, FoxPro, and dbXL includes
  219.    the word "TO" embodied within the coordinate parameters since that format
  220.    is used more frequently by those products.
  221.