To:	SMGR Users				Bulletin: 05

From:	Neal Rhodes /MNOP Ltd

Subject: Details on Adding Files

Here are a couple of observations on adding/mass loading sources based on some
recent questions:

1. REVISION STRINGS: SMGR will add a standard revision header to each source 
file added.  This required by Sccs, recommended for Rcs.    The default 
contents to be added is contained in $SMGRHOME/adm/srchdr.   This file as 
delivered has generic contents for a variety of languages.   You will no 
doubt want to hack it down to that needed for Progress. 

You may even want different revision headers for different categories of files.
For instance, the Progress sources would take a different syntax from C 
language sources, which would be different from Shell scripts.   You can place
a file named "_srchdr" in the category subdirectory in order to make SMGR
override the standard one.   For instance: 
	- Suppose you had C sources stored in a category named "clib".   
	- Create a file named $SMGRHOME/data/clib/_srchdr, and place a 
	revision string in it using C syntax. 

2. RESIDUE OF ADD: After the Detail->Create is completed, what is left in the
original source directory is original source, with the revision header 
inserted in it.  It has read/write priveledges.   A copy of your unaltered 
source is in /tmp.  In the interest of being cautious with your source code, 
we do not delete this copy.   We would hate to see some permission issue 
result in losing a source file.  Ideally, after the add is successful, we 
would hope that you would then Fetch the file.  This will prompt for removal
of the file, then will create a read-only file marked as revision 1.01.  The
read-only permission helps to jog the memory of developers that they should
now check out files when changes are needed. 

When using the Mass Source Load, this means that you are left with a directory
full of files, and Fetching each one might be cumbersome.   We suggest the
following:
	- Backup these sources somewhere and then delete them;
	- run the following code:
		=========================================================
		{smgrglob.i} {stexchkv.i} {strevvar.i}
		SMGR-COMMAND: 
			for each stsadm where cat = "WHATEVER" no-lock:
				assign 	sfile = file   scat = cat 
					snormal-pathname = "/usr/tmp"
		    			srev = "1.01".
		    {stfetex.i}
		    end.
		=========================================================
	You will want to alter the where clause to fix your situation.

[FINI]