vc README file

5th March, 2021

INTRODUCTION
    vc is a utility program that provides a simple preprocessor
    capability for ascii files.  See the man page, vc.1, for a full
    description.

COMPILING
    To compile and build the vc executable, enter the
    command:
        make clean
        make

    Optionally you can install vc and the man documentation by:
        sudo make install

    Consult the Makefiles if you need to change the location of
    binaries and documentation.

    The simple test suite can be run with:
        make test

DOCUMENTATION
    The man sub-directory contains vc documentation in both
    UNIX man format (vc.1) and HTML (index.html).  These can be
    re-built by entering the command:
        make doc-clean && make doc

    The source man page (vc.in.1) is written in mdoc format and processed
    with mandoc.

ERRORS
    Should you encounter errors during use of vc, please
    email mark.willson@hydrus.org.uk with relevant details.

LICENCE
    Copyright (C) 2002, 2003, 2004, 2021, 2024  Mark Willson.

    This program is free software; you can redistribute it and/or
    modify it under the terms of the GNU General Public License
    as published by the Free Software Foundation; either version 2
    of the License, or (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
    02111-1307, USA.

RELEASE HISTORY
    6th November, 2004      1.2     First public release
    5th March,    2021      1.2.1   Source changes to support modern C
                                    compilers; doc build optional
    11th June,    2023      1.3.0   Relaxed handling of undeclared variables,
                                    read from stdin if no files named
    12th April,   2024      1.3.1   Implement Pratt parser
                                    Expansion supports bracketed expressions
    26th April,   2024      1.3.2   Eliminate mandoc warnings for man page
                                    Fix defect with inc command on last line
                                    of file