# README for lwpp
# created 1999-Aug-15 19:28 jmk
# autodate: 2000-Jun-27 04:03

+----------+
| Contents |
+----------+

  - Description
  - History
  - Other Documentation
  - License
  - Disclaimer

+-------------+
| Description |
+-------------+

Lwpp is a lightweight text file preprocessor.  Lwpp reads a file as
input and writes sections of the file as output, based on certain
conditions embedded in the file as preprocessor directives.  Lwpp is
meant mostly to emulate the C preprocessor's '#if[n]def ... #endif'
functionality, but without any of cpp's other C-oriented features
(including macro expansion), and without putting extra newlines into
the output.  Lwpp uses the environment as a dictionary of symbol
definitions, so you can use the value of regular environment variables
(such as HOME or HOST) as symbol definitions without having to define
them again on the command line.

I created lwpp out of a need to preprocess spec files for RPM packages,
so that i could build more than one variant of a package from one
specfile.  I started out using GNU m4 for that purpose, but i
discovered some unfortunate limitations in the m4 language dealing with
commas.  Hence, lwpp.  I hope it's useful to others as well.

+---------+
| History |
+---------+

v1.0.1 2000-Jun-27

  - Fixed flaw where @if .. @else .. @if .. @else constructs nested
    more than three deep would not resolve to the proper condition in
    some cases.

  - License changed from GPL to more liberal BSD/MIT-style license (see
    below).

v1.0 1999-Aug-15

  - Initial public release.

+---------------------+
| Other Documentation |
+---------------------+

The lwpp distribution should contain the following other documents:

  ChangeLog         - Describes specific changes in lwpp's source code.
  INSTALL.txt       - Describes how to install lwpp.
  Lwpp-HOWTO.txt    - Describes how to use lwpp.

+----------+
| Location |
+----------+

This and newer versions of lwpp can be found at:

  http://www.jmknoble.cx/software/lwpp/

+-------------+
| Bug Reports |
+-------------+

There are no bugs in lwpp.  If you find any such nonexistent bug,
please report it to me immediately at:

  Jim Knoble <jmknoble@jmknoble.cx>

so that i can confirm its nonexistence.  :)

+----------------------------------+
| Copyright, License, and Warranty |
+----------------------------------+

Lwpp is Copyright (C) 1999,2000 Jim Knoble

THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
express or implied, including but not limited to the warranties of
merchantability, fitness for a particular purpose and
noninfringement. In no event shall the author(s) be liable for any
claim, damages or other liability, whether in an action of
contract, tort or otherwise, arising from, out of or in connection
with the software or the use or other dealings in the software.

Permission to use, copy, modify, distribute, and sell this software
and its documentation for any purpose is hereby granted without
fee, provided that the above copyright notice appear in all copies
and that both that copyright notice and this permission notice
appear in supporting documentation.

Your mileage may vary.  Eat your vegetables.

-- 
jim knoble | jmknoble@jmknoble.cx | http://www.jmknoble.cx/