Index of /ports/devel/generate/work/generate-2.4

 Name                    Last modified       Size  Description

 Parent Directory        08-Aug-2008 19:03      -  
 Makefile.bak            30-Jan-2007 04:56     2k  
 driver.pck              30-Jan-2007 04:56     7k  
 expr.c                  30-Jan-2007 04:56     4k  
 generate.1              30-Jan-2007 04:56    10k  
 generate.c              30-Jan-2007 04:56    36k  
 getarg.c                30-Jan-2007 04:56    15k  
 getline.c               30-Jan-2007 04:56     7k  
 setup.py                30-Jan-2007 04:56     1k  
 sockunix.c              30-Jan-2007 04:56     2k  
 xstrtok.c               30-Jan-2007 04:56     4k  
 Makefile                04-Jan-2008 11:37     2k  
 xstrtok.o               04-Jan-2008 11:37     2k  
 Makefile.html           08-Aug-2008 19:03     4k  
 generate.c.html         08-Aug-2008 19:03   221k  
 getarg.c.html           08-Aug-2008 19:03    51k  
 sockunix.c.html         08-Aug-2008 19:03    15k  
 xstrtok.c.html          08-Aug-2008 19:03    20k  
 xstrtok.o.html          08-Aug-2008 19:03     0k  
 Makefile.bak.html       08-Aug-2008 19:03     4k  
 driver.pck.html         08-Aug-2008 19:03     0k  
 expr.c.html             08-Aug-2008 19:03    29k  
 generate.1.html         08-Aug-2008 19:03     0k  
 getline.c.html          08-Aug-2008 19:03    35k  
 setup.py.html           08-Aug-2008 19:03     3k  

Generate - a file generating utility

D'Arcy J.M. Cain
darcy@druid.net

Generate is a text preprocessor that I originally wrote to help me write custom accounting applications based on the Progress database product. I felt that the built in wasn't useful enough so I designed a new one and implemented it. It actually started life as a package configuration and batch file generator for DOS and mutated to a simple script interpreter to replace shar file distribution. At this point it has almost nothing in common with that first program.

The basic idea behind generate is to create a script which generates files. There is some simple flow control constructs but the power lies in its macro processing. I have shamelessly stolen ideas from cpp, m4, make and David Tilbrook's dtree.

There are a few extra files in the distribution which come from my personal library which you may find useful in themselves. Here is a short description of these:

getarg.c

This is my replacement for getopt. It looks the same to the user but allows the programmer to allow mixing option and non-option arguments on the command line and simplifies the method of getting defaults and extra arguments from various sources.

getline.c

My unbounded line input function. Given different defines at compile time it can compile into getline(3), a simple unbounded input function, xgetline(3) which does the same except that it does comment processing and xcat(1) which implements xgetline as a command for shell script processing.

xstrtok.c

A replacement for strtok(3). Because strtok is a little brain dead about multiple calls this is a modified version which carries the pertinent information in a structure. This allows more than one string to be parsed at the same time (the code is re-entrant.)

To build the distribution you should simply have to run make (GNU Make). If you need to do more (other than to change the compiler or CFLAGS) please let me know. You may want to define MANDIR and BINDIR for installation if you want to install into somewhere other than /usr/local.

The major differences between 2.1 and 2.2 are:

• Casts have been added to prevent compiler warnings.
• Allows over 10 positional parameters (Derik Barclay )

This program may be freely distributed as long as credit is given to D'Arcy J.M. Cain, the source is included and this notice remains intact. There is specifically no restrictions on use of the program including personal or commercial. You may even charge others for this program as long as the above conditions are met.

This is not shareware and no registration fee is expected. If you like the program and want to support this method of distribution, write a program and distribute it the same way and I will feel I have been paid.

The distribution of the latest version is available as a shar file or as a compressed tar file. Here is the man page.

Of course gifts of money, drinks and extravagant jewels are always welcome.