=============================================================================
REFERENCES Bibliographic Software                                Version 4.3d
Version history                                  (c) Volker Kiefel, 1995-2007
=============================================================================

    This file describes essential changes/enhancements implemented in recent
    versions of REFERENCES. The current version of this software is 4.3d.

Version 4.3d (August 2007)
    Internal change: function ein_zeile() rewritten to fix the following bug:
    strings in Linux UTF-8 encoding with broad characters were truncated when
    typed at the prompt. If more characters were typed than the default length
    of the recipient string, the additional characters were accepted for the
    following operations (e.g. menu options).

    The ISBN field has been enlarged to 20 characters due to a change of the
    international standard book number format in 2007. ("The ISBN is 13 digits
    long if assigned after January 1, 2007, and 10 digits long if assigned
    before that date." Source: http://en.wikipedia.org/wiki/ISBN, accessed
    August 1, 2007).

    Linux only: highlighting of menu options in square brackets may be enabled
    with the ENABLE_HL variable in the configuration file. This requires that
    "ANSI escape codes" are understood by the terminal used for references
    (this is probably the case with modern Linux distributions).  This feature
    is not available for win32 of References, as the functions of the
    ``ansi.sys'' driver cannot be made available easily in modern Windows
    versions.

    Another macro format definition added (AU-YR-CIT-MFD) for citations in the
    format "First-Author et al, year" without brackets may be used for lists
    of references, in the final text ///list-of-citations/// can be converted
    via (///list-of-citations///) to (list-of-citations).

    Awk script file emptylines.awk added, this allows to remove empty lines
    from a text file.

    Function [main-i] now also shows number of lines of screen assumed by
    References

    Some operations of awk scripts resulted in errors (Linux) when (GNU) gawk
    was used, it is therefore recommended to use Kernighan's awk (nawk) or
    mawk at present.

    Manual updated.

Version 4.3c (December 2006)
    Linux: instead of the text viewing tool, the external ``less'' command may
    be used for viewing texts (in order to use less, add the line USES_LESS=1
    and - optional - the less command line options to LESS_OPTIONS in the
    configuration file).
    
    Linux: two `icons' have been added (as .png-files) to the
    /bin-subdirectory which may be used to configure an installer on the
    desktop. With the win32-version one .ico file is provided.
    

Version 4.3b (December 2006)
    Linux: now Linux installations with both utf-8 encoding (default, as in
    v4.3) and with latin-1 or latin-9 encoding (new in v4.3b) of text files
    are supported (latin-1/9 encoding added in v4.3b).

    The menu [main-t ed] has now also been added as [main-e ed] for ease of
    use. The manual has been updated.

    Text viewing function: in the following situations

        [main-t vi]
        [edit-main-v]
        [main-e c a] (viewing of abstract files)
        [main-e s a] (viewing of abstract files)
        [main-e b ... a] (viewing of abstract files)

    this function starts by showing the first text page, without stopping with
    a useless prompt (e.g. ``view abstract'') to make the user interface more
    intuitive.

    In other situations, more explanations have been added to prompts to make
    the user interface more intuitive.

    Functions for operations on sets of reference numbers represented by
    bbt-files have been added [main-b u], [main-b i] and [main-b d].

    User interface: in some functions informations on the following steps of
    operations have been included, bracketed by pairs of `----'.
    
    A bug of the [main-l tu] and [main-l tm] functions causing crashes of the
    Linux version removed.
    
    Manual updated.

Version 4.3a (September 2006)
    References is now developed on a Linux system, however, the win32-port
    will be also be provided in the future. Therefore the accompanying text
    files will be in ``Unix text format'' in the future.

    Text viewing function (e. g. [main-t vi]): options "[s] show line number",
    "[g] go to line number" and "[/] find" added. Option "[edit-main-v] view
    text file" added.

    New menu option [edit-main f e] `select an alternative text editor' added
    (this is so far not implemented in the main program). This menu option is
    particularly intended for Linux users, who want to switch ot a text editor
    with a graphical user interface with better access to the clipboard.

    Minor bugs removed.

    Manual has been expanded (new chapter: ``What can References do for me'') 
    and updated.

Version 4.3 (May 2006)
    Major changes: beginning with this version, References is provided as
    win32 and Linux software. Encoding of the internal representation of data
    has been changed from codepage 850 (cp850) to latin-1. The Linux port
    assumes that text files are handled in utf-8 encoding. A tool to convert
    .arr and .fd-files from cp850 to latin-1 (before importing them into the
    v4.3 database) has been added. Binary files for Linux are not provided,
    they should be compiled by the user.
    
    Support of MS-DOS has been abandoned. The References manual (refsdok.pdf)
    has been updated.

Version 4.2 (October 2005)
    New field for all document types: idnr. [Main-t me] (convert medline input
    to form) inserts PubMed identification number (pmid:) digital identifier
    (doi) and pii identifier (pii:) into the idnr-field.

    The function for selection of files by the user now asks for initial
    characters (as described for [main-t ed m] and [edit-main-m] in v4.1j) in
    all situations.

    New command [edit-main-h] calls PDF viewer with the References
    documentation (refsdok.pdf).
    
    The file selection function now asks for initial character(s) of file
    name, if a empty string is entered (default), all files will be listed.
    
    Change in user interface: if the variable OPEN_EDITOR_YN is set to `1'
    (default) in the configuration file, References prompts you to open a 
    previously created/changed text file with the message:
      
      open editor with ``name-of-text-file''? [y/n]
      
    This makes the References user interface more comfortable. You may turn
    off this behaviour by setting `OPEN_EDITOR_YN=0' in refs.cfg.
    
    Width of the field for the journal code has been enlarged from 4 to 10
    characters. Changes in the structure of the table for format definitions:
    field width changed from 14 to 24 characters, number of fields for the
    `localization line (chapter/article in a book)' (named `b2 localization
    nn' in .fde files) changed from 80 to 60.

    Technical changes: 
    - portable version of the function reading files in directories written
      (verzeichnis_auslesen() in fl_ut.c)
    - all awk-scripts for text manipulation have been updated or rewritten:
      output text file names may now be entered, scripts are now more
      `portable', they do no longer depend upon gawk, but may now also be used
      with awk (Kernighan) or mawk. Kernighan's awk is now included instead
      of gawk.

Version 4.1j (July 2005)
    The menu options [main-t ed m] and [edit-main-m] now ask for initial
    characters of filenames before listing files, this allows to restrict the
    number of files listed. The function [main-e lk] ("list keywords") no more
    leads into a loop, which was impractical to use.

    New command of the text editor shell [edit-main-p snc] (sort groups of
    numeric citations). This function allows to sort numeric citations in a
    manuscript and to compress consecutive numbers [1, 2, 3, 4] -> [1-4].  A
    section describing how to create superscripted numerical citations in
    manuscripts written with OpenOffice.org/StarOffice writer and Microsoft
    Word has been added to the documentation.
    
    Radmin tests, if the file refsrun.$ exists, if yes, you are asked to     
    delete it. 

    Important internal change: If fwrite() fails to write a record into a
    database file, an index file or a bbt-file, a message is issued and the
    program is stopped. This has been implemented to avoid that failure to
    write to the database remains undetected by the user.
    
Version 4.1i (March 2005)
    New tool `Radmin' allows administration of References databases:
    installation in any directory/folder is now much easier, creation of
    databases may also be done by Radmin. Documentation updated.

    New script for creation of OpenOffice/StarOffice macros that generate
    macros for converting bibliographic citations in the manuscript.

Version 4.1h (March 2005)
    New behaviour for commands [main-l s], [main-l u], [main-l tu] [main-l b]:
    if reference number is not found, the string ``--reference number--'' is
    inserted instead of text (i.e. after the reference number, the reference)
    number was not inserted in v4.1g.
    
    New behaviour for [main-s]: if records are found for a search command, a
    record is shown immediately after the search, the program jumps to the
    first record or the current record. The commands [main-e b], [main-e s]
    act similarly.

    Documentation: rewritten chapter ``How to process manuscripts with
    citations in author-date-format with a, b, c ... appended to the year of
    publication'' in the documentation. Description of this problem will be
    completed in the future.

    Starting batch files data.bat, e-data.bat, tutorial.bat, e-tutorial.bat
    corrected: last line changed to "set REFS_CFG_PATH="

    Generic macro format for proceccing citations in the manuscript changed
    from
      ///1///refscite(i03544)///1///[8]///1///
    to
      ///A///refscite(i03544)///B///[8]///C///
    Please be aware to change your macro format definitions.


Version 4.1g (August 2004)
    Layout of menus [main-e], [main-l], [main-b] improved. Menu (options) 
    [main t ed] added: it is now possible to edit text files from references
    program (in a similar way as from the text editor shell). New command
    [edit-main-t] added. New command [edit-main-p vi]: generates a citation
    search-and-replace script for vi/vim text editors (new script
    bin/vi_sr.awk).

    New behaviour for [main-l s], [main-l u], [main-l tu] [main-l b]: if
    reference number is not found, the string ``--reference number--'' is
    inserted. 
    New behaviour for [main-l m], [main-l tm]: if reference number is not
    found, the string ``==reference number=='' is inserted. 
    New behaviour for [main-b ay]: if reference number is not found, the
    string ``..reference number..'' is inserted into the text field.  These
    changes allow to process manuscripts with references not included in the
    database, details are described in the documentation: section ``Special
    problems/Process manuscripts with references not included in the
    database''.

    Awk filter programs ``fromcite.awk'' and ``tocite.awk'' added. Description
    can be found in section ``Tools for LaTeX and References'' of the
    documentation.

    Generation of formatted lists of references: support for ``underlined''
    added (documented in ``Special problems/Make lists of references with
    different fonts'')

    Documentation updated.

Version 4.1f (March 2004)
    New command [edit-main-p osw] which generates macros to create citations
    in OpenOffice.org/StarOffice WRITER documents (new scripts ooo-xsr.awk and
    ooo-sr.awk). 
    
    References starting screen: information on WORKING DIRECTORIES AND FILES
    removed. This infomations remains available under the [main-i] command.

Version 4.1e (January 2004)
    [Main-l b] (create BibTeX database) now converts quotes (") into `` or ''
    (this was a problem for BibTeX databases created with the previous
    References versions: quotes were not at all converted and had to be
    removed or replaced manually). A small bug in the same function removed:
    ``ß'' is now converted into {\ss} (and not {\"ss} as before). References
    should now create fairly correct BibTeX databases.

    New command [main-f c]: ``edit configuration file'' added.

    Menu structure of text editor shell changed: [edit-main-f] (``file and
    system functions'') created.

    Documentation: Section ``Create a bibliographic format definition'' has
    been added to the ``Tutorial''-chapter.

Version 4.1d (October 2003)
    User interface: Call to shell commands in References [main-f s] and text
    editor shell [edit-main-c]: the last shell command may be repeated by
    entering an empty line. Search [main-s]: if the search command file does
    not exist, or if the first line in the file is empty, the program directly
    prompts for search command and output file name. Import of references
    [main-e ir]: preview of data to be imported now includes "volume" for j1
    and j2 document types.

Version 4.1c (August 2003)
    Minor improvements of user interface: Function [main-t me] (convert 
    medline input to form) offers option to delete the input text file. New 
    menu option [edit-main-f]: access to file manager as in [main-f f]. 
    Command [main-f f d] (``delete file'' in the file manager) now explicitly 
    shows path/name of selected file to be deleted.

    In the configuration file, number of lines per screen now may be assigned
    *any* number between 25 and 60. 
    
    New keyword for bibliographic or macro format definitions: %tab inserts
    a tab character.

    Some inconsistencies in the code corrected (redundant declarations 
    removed).

    Gawk.exe v3.1.3 is now included (instead of v3.1.2).

Version 4.1b
    Browsing in database now writes records into REFS.LOG, all important
    functions are now written to the log-file. Zip-archives are now also
    distributed as self-extracting files (.exe for win32-systems).

    Dokumentation: tutorial chapter on writing bibliographic format
    definitions added.

Version 4.1a
    Inconsistencies in the documentation fixed, r41asrc.zip: sourcecode moved
    into the src-subdirectory (as in v4.0x).

Version 4.1
    Major changes -- new document types: j2 (article in a journal with
    institutional authors or without authors), b3 (book with institutional
    editor or without editor), m1 (miscellanea), m2 (miscellanea with
    institutional editor or without editor) added. A shell which calls text
    editor and AWK-scrips has been added as executable file (etext.exe).
    
    New keywords for bibliographic or macro format definitions: %ina(),
    %ine(), %howpub, %hp(), the keyword %p() has been made available to all 
    localization lines.

    New field labels for scerch commands: edtn (edition number of book,
    applies to b1, b2, b3); volj (volume of a journal, applies to j1, j2).

    Updated and enlarged documentation (refsdok.pdf)
   
Version 4.0d
    Functions writing input forms: "convert Medline" [main-t][me] and
    [main-e][j1], [b1] and [b2] now show the highest reference number of the
    current database in their prompt. This makes it easier to assign new
    reference numbers to new records.
    
Version 4.0c
    Some minor bugs removed, documentation in refsdok.pdf updated.

Version 4.0b
    Documentation: description of installation procedure has been changed and
    simplified and a chapter on the most important error messages has been
    added in refsdok.pdf. 
    
    The sortrefs.awk-script has been improved. 

Version 4.0a
    
    Nearly identical to version 4.0 (no changes in refs40.exe!). In addition,
    gawk.exe is now included, sort.exe is no more required (this makes the
    installation less complicated). The "sortrefs"-procedure has been changed
    (it is now an AWK-script which makes development of new sorting patterns
    more flexible, changes are described in the manual). The sortrefs.bat-file
    (missing in v4.0) is now included. Documentation has been updated.

Version 4.0

    Completely rewritten version as "console" application for Windows 9.x, ME,
    NT, 2000, XP. A MS-DOS version can be compiled from the sources. All
    complex input operations are now performed through text files using a text
    editor.  Documentation is now provided as PDF-file (generated with LaTeX)
    and has been compeletely rewritten. Documentation can now be generated
    from the sources as .dvi-file or a .ps file, if a TeX/LaTeX system is
    available. 

    Entering, editing of bibliographic references, new keywords and new
    journal data is now performed through forms (text files), this is now much
    more comfortable than input fileds in previous versions of References.

    References now provides more consistent support for LaTeX. Bibliography
    database files (.bib files for use with BibTeX) may can now be generated
    directly.

    All format defintions now may be exported with a single command [main-d
    ea]. Format definitions are now created or modified with text files
    (filename extension .fde).

Version 3.6

    Major enhancements of v3.6 concern the documentation provided in the text
    files (cf. below). Now the complete documentation is available in
    English, some documents are provided in an additional German version.

    Technical changes:
    
    The `binary' file format for exporting bibliographic format definitions
    (filename extension FD3 in previous versions) has been abandoned. The
    "RefFormatD" menu option has therefore been changed: the "FdToText" and
    "TextToFd" options were removed from the menu, format definitions are now
    exported through "Export" and "Import" into a text file format with the
    filename extension `FD'. The more flexible "FD"-file now replaces the
    former "FD3"-format.  This file type is required for transfer of
    bibliographic format definitions into later versions of REFERENCES
    including to versions on other platforms.

    The space for the `localization strings'-fields in the bibliographic
    format definition record (menu option: "RefFormatD") has been doubled.

    Function "BatchTableBrowse": menu item "KeyValue" has been added.

    A new menu option: "SearchBrowse", has been added to the "EditView"-menu.
    It shows the records listed in the BBT-file produced by the last
    "SearchR"-command.

    Command "BatchT" "Write", selection of [ESC] or [F10] for data entry now
    prompts for saving ("Ok") or ignoring ("Cancel") the changes made.

    Function: "Transfer" "SrchR" now writes a complete report on all changes
    made into SRCHREPL.LOG log file.

    The command "EditView" "Abstracts" "DatabaseToText" writes the text file
    (e. g. abstract) ABSTRACT._T_ which is overwritten each time this command
    is called. In previous versions the text of the current record was
    appended to a `LOG'-file named ABSTRACT.DOC. This file has now been
    renamed into `ABSTRACT.LOG'.

    Function "Transfer" "Import" prompts you for deletion of archive file
    after import.

    Command "ListR" "UserDefined": The `Description'-field is now printed on
    screen after writing text the file. you may enter a reminder into the
    `Description'--field, if a format definition requires that an output text
    file has to be processed with a "SrchR"-command or an AWK-script, e. g.:
    `VANCOUVER...(-> VANCOU.SCF)'.

    The text input fields layout has been changed to [_____]

    Documentation:

    The documentation of the program has been extended and essential parts
    have been rewritten. An English translation of the REFSDOK.GER
    documentation file has been added (REFSDOK.ENG), the SHORT35.ENG file is
    no longer supported and has therefore been removed. Translated (English)
    and improved versions of the TUTORIAL (rewritten!), PUBLISH (rewritten!),
    GLOSSAR and TECHDOC documents have been included, the German version of
    TECHDOC has been omitted. In the German files, `Umlaute' have been
    converted into ae, oe, ue, Ue, Oe, Ue and `szet' into ss.

    The documentation can be viewed with the text editor called by the DOS
    batch file generated by "Help" "HelpFiles" command. If you wish to view
    the files with another software (a `pager' or `text-viewer'), you may
    assign its name to the `PAGER'-variable in the REFS.CFG-file.

Version 3.5 (major changes)

    The standard version is now compiled with the DJGPP port (version 2.02)
    of the GCC--compiler (GCC version 2.8.1, an alternative version compiled
    with the EMX--port of the GCC is available from the program author or may
    be compiled from the sourcecode). Both compilers proved to be reliable
    and stable tools in the development of REFERENCES!

    Version 3.5 is now released together with the source code and published
    under the terms of the GNU General Public License as published by the
    Free Software Foundation (cf. COPYING).

    New data fields have been implemented. J1-document type: month and day of
    publication, issue number of a journal, ISSN (international standard
    serial number); B1 and B2 document types: ISBN (international standard
    book number). Accordingly, the keywords %day, %d(), %month, %m(),
    %issuenum, %isn(); %issn, %isn(), %isbn, %ibn() and %v() have been
    implemented in the format definition mechanism.

    The "EditView" "CompleteBrowse"/"BatchTableBrowse" commands have been
    modified: during browsing the screen is not cleared, but srolls up so
    that the previously shown records remain visible.
    
    The format of records for format definitionions has been changed, this
    implies that FD3-files from earlier versions cannot be read, for transfer
    between versions, the command "RefFormatD" "FdToText" can be used. Within
    version 3.5, FD3-files can still be used.

    Import from archive files no more requires that items are already sorted,
    this made slight changes in the sorting order of keywords and journal
    codes possible.

    (Version compiled with DJGPP only, no ANSI.SYS): The screen is saved and
    restored upon termination of the program.

    In the `Search command' line (command "SearchR"), a text file may be
    selected for viewing with [F2].

    Commands "Transfer" "LaTeX" and "Transfer" "TextLaTeX": the characters
    `ø', `à' and `æ' are now adequately translated into LaTeX constructs.

    Command "BatchT" "SortBBT": the new option "Invert" has been added
    (copies a BBT-file into a BBT-file with reverse order).

    The command "BatchT" "TexttoBBT" has been modified: records with empty
    KEYWORDS-field are no longer transferred into the BBT-file

    The "SelectTextF" command has been renamed into the function "SHelpF"
    (select help file for viewing) and the command "EHelpF" (`select help
    file for loading into the text editor') has been added.

    The "Transfer" "Medline" command has been modified: leading blank lines
    in the text file to be converted are now ignored and do not lead to
    termination before the conversion is done (which was the case before).

Version 3.4a

    In addition to the `standard' version compiled with the EMX-port of the
    GCC, an experimental version has been prepared using DJ Delorie's DJGPP
    port of the GCC. The DJGPP--Version requires an environment which
    provides DPMI-services, therefore it runs under different flavours of
    Windows (this has been tested) or under OS/2 (not tested). In addition, a
    free 32-bit DPMI-server (CWSDPMI) is included so that this version may
    also run under `plain' MS-DOS (PC-DOS). The EMX-Version is the standard
    version which should run under MS-DOS, Windows, OS/2 (OS/2 not tested).

    The source code is now provided freely, REFERENCES is now licensed under
    the terms of the GNU General Public License as published by the Free
    Software Foundation, details are found in the text file copying.

    Alternative copy commands (e. g. the UNIXish `cp' provieded with the
    DJGPP compiler package) for the file manager may now be defined in the
    REFS.CFG file, default is MS-DOS's COPY.

    "Transfer" "Medline": MH-fields longer than 45 characters are more
    completely imported, only restriction: entries>45 characters separated by
    "," will be truncated.

    A new text file `type' (extension SCF): SCRIPT FILE has been introduced.
    The "ListR" "Macro" command now produces SCF files and the macro with the
    instructions for the "SrchR" command is now a SCF--file. This was done as
    TXT--files to be operated on ond TXT-files with the `search and replace'
    items could be confused in earlier versions.  The file manager has been
    adapted to handle also this file type. The menus for the selection of
    filename extensions have been changed (`1' instead of `1:TXT').

    "EditView" "EnterEdit" (data entry): After selecting "Cancel" or [ESC] in
    the data entry menu the user is aked to confirm ("BackToDataEntry") if
    she/he really wishes to quit (with the changes made in data enty lost).

    "EditView" "EnterEdit" (data entry): It is now `forbidden' to save a
    record without a keyword, automatically the string `--dummy keyword--' is
    added, you will delete it if you enter keywords.

    Bugs removed:

    Commands "EditView" "Abstracts" "TextToDatabase"/"DatabaseToText": the
    program halted with a reference number not present in the database (bug
    removed).

    Bugs identified with the bounds-checking code included in GCC 2.8.1 (EMX)
    in f_ver.c and re_edit.c were corrected.

Version 3.4 (major changes: REFERENCES has been rewritten as genuine
    'extended-DOS' (32-bit) software).

    The complete program code has been ported to one executable file. It may
    run under "pure DOS" and in a DOS Window under MS-Windows 3.1, Windows 95
    Windows 98, or Windows NT, however, stability of REFERENCES has not been
    excessively studied under WINDOWS, but crashes have not been observed by
    the program author in different environments.

    In detail: An executable program file (REFS34.EXE) was compiled and
    linked using Eberhard Mattes' (excellent) EMX-DOS (and OS/2) port of the
    GCC compiler and may run under MS-DOS (using the EMX-DOS-extender),
    MS-Windows (using the RSX.EXE "DOS-extender") and under Windows NT.

    Database format has been changed considerably: The `Volume'-field was
    enlarged (12 -> 20) characters; the `Status'-field: 1 -> 12 characters.
    The field (formerly a field with constant length) with the keywords may
    now contain up to 999 entries (max. length of entry field: 32.000
    characters), the keywords (or descriptions are now stored in the DESC.DAT
    database file).  Due to these changes data have to be transferred to the
    new version via archive file.  These changes make storage of keywords
    much more flexible and search commands (KEYW) are executed quicker.

    Bibliographic references in the MEDLINE format can now be converted into
    an archive file and directly imported. This gives access to direct online
    import from the NLM database.

    "RefFormatD": Contents of the (binary) FORMDEF.DAT file may be converted
    into a text file ("FdToText") and this text file may be imported into
    FORMDEF.DAT (TextToFd).

    "SearchR" Search-Commands: Field label and string are now seperated by
    '=' no more by '@', as search commands as 'auth=Liebig|Pasteur' are more
    easily understandable than 'auth@Liebig|Pasteur'.

    File manager: "Delete" command now asks for confirmation before deleting
    a file. A "Move" command for moving an external file has been
    implemented.

    Text viewer functions have been enhanced.

    Layout of the file selection screen has been changed. In certain
    situations, the number of the selected file is stored during as long
    as the program is running.

    Help files may now be directly viewed from REFERENCES under the menu
    option "SelectTextF".

    Text files can now be viewed during data entry with the new "TextView"
    function.

    Some help screens have been rewritten.

    In order to avoid conflicts between the memory management of REFERENCES
    version 3.4 and the text editor selected by the user, REFERENCES writes
    the call to the editor and text file into a batch file, which can be
    called after leaving REFERENCES or from a different window under
    Windows(TM). It is thus avoided that the editor runs as a subprocess
    'spawned' from REFERENCES.

    Internal buffers for sorting have been considerably enlarged (made
    possible by shifting to 32-bit compilers) resulting in higher speed of
    sorting procedures (Import, Reconstruction).

    Bugs removed:

    In the file manager "ImportCopy" and "ExportCopy": in the `Path' input
    field the program accepted slashes (ok for most C-compilers!), but the
    DOS copy command refused to copy from into a dictionary like /test. In
    version 3.4 slashes (which you may still enter: e. g. /test) are
    converted into backslashes (as expected by MSDOS: \test\).

    Some minor code inconsistencies have been found (upon compilation with
    the GCC-compiler) and corrected.

Version 3.3a (bugfix, installation requires version 3.3)

   Bugs removed:

   In the "EnterEdit" "ViewText" function ASCII 255 produced the "<END OF
   FILE>" indicator and terminated the screen page (bug removed in vtxt.exe)

   In the "FileSystem" "FileManager" "Rename"/"2x" commands the text entry
   field for the new file accepted 13 characters instead of 12 characters;
   the internal function checking validity of file names did not reject file
   names like
          123456789.tx
                  ^
          1234567890.t
                  ^^
          1234567890AB
                  ^^^^
   instead, these filenames were handed over to DOS, which truncated them
   correctly to `12345678.tx', `12345678.t', `12345678', respectively (bug
   removed in file_mg.exe).

Version 3.3 (major enhancements of functions and program code, data format
   slightly changed, see `abstract text entries', completely new archive
   file format).  Most important, you may use the database of version 3.2
   with the new version without changes.

   The format of the archive (text) file format has been completely changed
   and improved, the filename extension is now ARR ("ARchive of
   References").  The format is technically superior to the AR3 format
   (which imposed severe restrictions to the user as it did not allow certain
   characters to be entered in many fields as '@', '$', '^', '&', this is
   no longer a problem!). Moreover this new format will follow future
   versions of REFERENCES as it will allow to introduce new fields to the
   REFERENCES database structure (and therefore allow compatibility between
   this version and future versions especially those supporting other OSs).
   The last (but not least) important advantage of the ARR file format: it is
   more easily understood, it simply explains itself, the structure is
   described in REFSDOK.GER and SHORT33.ENG

   User interface: in all text input fields, you may now toggle with the
   INSERT key between the 'insert' (default) and 'overwrite' editing modes,
   the editing mode is indicated by the shape of the cursor (`underline'
   cursor:  insert [default], `block cursor': overwrite).

   Screen color option #10 has been slightly changed.

   After calling the main REFERENCES executable file, the screen is now
   explicitly switched to 25 lines if necessary (especially useful if the
   program used before left the screen with more lines, e. g. 43 or 50 lines)
   and a splash screen is presented.

   After calling the main REFERENCES executable file, the database, index and
   BBT-files of the current database are checked for their file size. Access
   to the program is inhibited if the file size of at least one file
   indicates a damaged file. Absent files and files with the size 0 bytes are
   `accepted'.

   Improvements in the use of the "EditView" "EnterEdit" commands: In the
   "Enter-Edit" menu selection of "Edit" will bring you to the 'current
   field', i. e. the field which was left before calling the "Enter-Edit"
   menu with [ESC] or [F10]. Moreover, the screen is not cleared upon calling
   the "Enter-Edit" menu.

   A function which writes a format definition into a text file has been
   implemented, it may be called by the command: "RefFormatD" "Text". The
   name given to the output text file is FORMDEF.TXT.

   The "ListR" "JournalKeyword" commands write lists of journal names and
   keywords now into *two* text files "__JOUR__.TXT" and "__KEYW__.TXT" (in
   the previous versions this information was written into a single text
   file).

   Automatic search-replace function for text files added (command "SrchR"):
   a tool for preparing text file manuscripts with correctly formatted
   references to articles, some format definitions and macro files provided.
   SrchR may also be used for the preparation of LaTeX files and for
   conversion of text files between the ASCII and ANSI formats.

   The command "FileSystem" "RebuildDbase" writes the log file: it contains
   if the functions for builing an index files enconter duplicate keys in the
   DAT files (a sort of inconsistency in a REFERENCES database file).

   Different options for generation of `macros' and `lists of references'
   have now been implemented in the ListR-menu -- default (which may be
   changed) for macro text file name: MACRO.TXT, for list of references file
   name: REFLIST.TXT (as in earlier versions). This makes the generation of
   macros more simple.

   The file-manager (command "FileSystem" "FileManager") has been extended:
   you may now make a copy of a file in the current database directory
   (option "2x") and rename a file (option "Rename").

   Function "XtractRefNo": Files with extensions other than `TXT' may now be
   searched for reference numbers.

   Functions for extensively diagnosing database integrity have been
   implemented, commands: 'FileSystem' 'Verify'... This is a major new
   feature of REFERENCES 3.3! It checks all files with the DAT, IX and
   BBT name extension (i. e. all `binary' files read and written by
   references).

   BatchT (functions for management/manipulation of batch tables): Binary
   batch files can now be edited directly from within REFERENCES ("BatchT"
   "Write"). New command "BatchT" "More" "Clear" removes records with an
   empty 'reference number' field.

   Maximal length of (abstract) text entries has now been extended to 30,000
   characters.

   Help screens have been rewritten.

   Standalone command line programs for the work with text files -- may be
   installed optionally:

   ENDLINE: converts UNIX-style end-of-line codes to MS-DOS-style end-of-line
   codes (useful for many text files to be obtained via the internet, which
   are often stored on UNIX servers)

   TXTLINES: Converts text files with `long lines' into text files with
   paragraphs formatted in short lines (suitable for most text editors).
   Details may be found in the documentation. TXTLINES is a 32-bit protected
   mode program (MS-DOS) requiring a 386 or higher processor. Useful tool for
   writing entire manuscripts for publications with a text editor.

   Bugs renoved:

   system crash theoretically could occur following import of too long
   abstract texts (> 20,000 in version 3.2) from a manipulated REFERENCES
   archive -- solution (bug removed): text will now be truncated (if it is
   longer than approxiamtely 30,000 characters in version 3.3).

   "Transfer" "Import" did not work properly with author/editor lists
   containing authors/editors names/first names of maximal length (26, 6
   characters, respectively). In this case, the program appended the '0'
   character and produced too long string lengths for these fields (bug
   removed).

   "ListR" functions showed inpredictible side effects with damaged
   BBT-files: too long reference numbers (bug removed), this type of defect
   will now also detected with one of the file verifying functions.

   An internal inconsistency removed in version 3.3 (this is not of interest
   for the 'normal' user, but for the programmer who writes software to read
   the REFERENCES database files directly!): In journal.dat the command
   "Transfer" "Import" (transf.exe) of versions 3.0-3.2 copied 'b1' and 'b2',
   the code for the document type into the field one_jounal_rec.kuerzel
   ['Zeitschriftenkennung' in techdoc.ger] (as well into
   one_jounal_rec.reftyp ['Dokumenttyp' in techdoc.ger], the appropriate
   field), while "EditView" "EnterEdit" did not. This inconsistent behaviour,
   which was implemented deliberately in REFERENCES 2.x causes no problems in
   version 3.0-3.2 but was removed for version 3.3, as it is no more logical
   or necessary. Thus in the new records produced by the REFERENCES version
   3.3 commands "Transfer" "Import" and "EditView" "EnterEdit" the field
   one_journal_rec.kuerzel ['Zeitschriftenkennung'] is empty for the 'b1' or
   'b2' document types (as expected).

   Many chapters in the documentation have been rewritten and completes,
   descriptions of the new functions have been added.

   Support for TeX/LaTeX has been enhanced (TeX/LaTeX-related stuff described
   in LATEX.GER)

Version 3.2: major enhancements of the complete program code.

   The screen color ist now controlled by the COLORS variable in the REFS.CFG
   file and does not any more require the ANSI.SYS driver to be loaded.

   The file selection screen now shows the files alphabetically sorted (if
   the number of files is < 500). All text input fields are now equipped with
   a 'clipboard' allowing copying of text lines between fields.

   Documentation in text files rewritten and improved.

   Help screens have been rewritten.

   Format definition language: keyword %n added.  Functions for complete
   management references within the text of a manuscript added: REFERENCES
   can now generate macros for text processing programs, REFERENCES can now
   'extract' reference numbers from a manuscript text. These improvements now
   allow complete processing of references within a manuscript.  Samples for
   format definitions included.

   Bugs fixed:  ListR function:  in the m, n combinations determining the
   number of authors/editors to be printed into the text file, the value m=1
   is now correctly interpreted.  If the user enters values: n < m, the
   program interprets them as n = m.

   Bug removed in the data entry function:  keywords, insertion of a long
   keyword now possible.

Version 3.1a (minor changes):  'Text-Latex' command added, which allows
   conversion of any text file into LaTeX style (TXT2TEX.EXE).

   Menu structure:  from nearly all funtions, the program jumps back to the
   main menu.

   'EnterEdit' function:  Program automatically inserts 'NN,N' into the
   authors' and editors' fields, when the field is empty and openend for the
   first time.

   'Search' command can be processed on a subset of records in a database
   referred to in a BBT file.

   Records defined in a BBT-file can be more easily deleted in the database.

   Functions for deleting duplicate records added.

   Abstracts can be viewed from within the 'Browse' function.

   Enhanced translation utility from version 2.x provided on a separate disk
   (fixing a 'bug' due to differing sorting orders in reference numbers in
   versions 3.x and 2.x).

   Function for stripping archive files included (ArchiveExch)

Version 3.1-Bugfix 1: A bug in the fil_fun.exe file has been fixed. (In the
   RenameRecords function abstract texts were not handled properly.) The file
   R31FIX1.ZIP has been distributed among users, it is included in the new
   program disk.

Version 3.1: Major enhancements:  functions for work with text files have
   been added. These 'abstract' text files are also included into the
   renaming, deleting, and archiving database functions of REFERENCES. Any
   text editor can be included into the text file.  The screen output can be
   colored.

Version 3.0a: Minor changes in internal program code.  Primitive text-viewing
   utility (VTXT.COM), addition for use with the LaTeX program package
   (REFS2TEX.EXE), extension of the b1 (Book) document format (now allowing
   also definition of pages).  Format definition for transfer of data from
   REFERENCES to ProCite (TM) (DOS Version).

Version 3.0: Entire Program rewritten in the 'C'-programming language as a
   16-bit `real mode' program. New internal database format. New archive
   format (*.ar3) for exchange of data. Translation tools for transfer of
   data from version 2.x provided on a separate disk.

Version 2.4 (and earlier versions referred to as version 2.x):  REFERENCES
   had been written as a database application for PARADOX versions 4.0, 4.5
   ((c) Borland International).

Version 1.x: first draft of REFERENCES as a database program application:
   PARADOX for DOS version 3.0.

vim:ai tw=78 shiftwidth=3 fileencoding=latin1
