Small documentation written by Eric Totel on 27.September.1994

		--------------------------------
		- BumpRevv.rexx and MUIBuilder -
		-       How to use them ?      -
		--------------------------------


I.  BumpRev.rexx : what is it ?
-------------------------------

In this directory, you can find an ARexx script called 'BumpRev.rexx'.

This script is an enhanced version of Bumprev from Commodore. Its goal
is to manage and to provide a way to update the strings version in
your programs (C and assembly).

The use of this script is really simple :


The template is :
"Name/A,Version,Revision,File/K,Copyright/K,IncRev/K/S,Verbose/K/S,Asm/K/S"

An example of use could be :
rx bumprev.rexx Name prog File revision.h Version 1 Revision 0 Copyright "© by Sylvain Rougier" IncRev Verbose

Here is the output of the previous command (in file revision.h) :

#define REVISION 0
#define VERSIONREVISION "1.0"
#define DATE 27.09.94
#define VERS "prog 1.0"
#define VSTRING "prog 1.0 (27.09.94)\r\n"
#define VERSTAG "$VER:prog 1.0 (27.09.94)"


II.  Author.
------------

BumpRev.rexx was written by Sylvain Rougier and Pierre Carrette (who improved
it to fit MUIBuilder's needs !!!!)

III. Requirements.
------------------

This hack will probably work only with C language (thanks to the
macros !!!!!!), so you have to use C.

To run the script, you have to use the RexxDosSupport.library
which is provided in this directory in its original archive.

This library is freely distributable, but copyrighted by

	***  Hartmut Goebel ***

For more informations, please read the documentation included
in the archive RexxDosSupport.lha.


IV. Use with MUIBuilder.
------------------------

This script is useful for C users !!!! It provides the ability to handle
the well-known VERSION strings macros directly inside MUIBuilder.

BumpRev.rexx will update your version string according to the arguments
you provided.

You just have to enter some special strings into the application
object attributes :

- Base		: the name of your application		(as usual)
- Author	: your name				(as usual)
- Title		: "VERS"
- Version	: "VERSTAG"
- Copyright	: "VERS" © your name
- Description	: a description of your application	(as usual)

Before any code generation, edit one of the files 'C-Header' or 'H-Header'
located in the 'Modules' directory. Add in the file of your choice the line
'#include "revision.h"' where "revision.h" is the output file of BumpRev.rexx.

With BumpRev.rexx you can generate the same file "version.h" for every
project : so this change in 'H-Header' or 'C-Header' is valid for all
of these projects.

V. Greetings.
-------------

I want to thank Pierre Carrette who provided me
with this script and made some improvements so that it works with MUIBuider !

you can contact Pierre Carrette at :

	Pierre Carrette : bvme@chasseneuil.em.slb.com