 
	THIS IS THE README.1ST FILE FOR THE CONTRIBUTIONS TO THE
	SPRING 1983 DECUS SYMPOSIUM PROGRAM EXCHANGE THROUGH THE
	RSX SIG FROM USAFETAC, SCOTT AFB, ILLINOIS.
 
 IN THIS DIRECTORY ARE THE FOLLOWING FILES:
 
	DSPLOG.FTN - THE SOURCE FOR THE 'DISPLAY LOGIC' PROGRAM
		PRESENTED IN A SHORT PAPER AT THE SPRING 1982 (ATLANTA)
		DECUS SYMPOSIUM UNDER THE TOPIC "EMBEDDED PDL AIDS 
		FORTRAN PROGRAM DESIGN AND MAINTENANCE".  THIS SOURCE
		PROGRAM IS ITSELF A COMPLETE ILLUSTRATION OF THE
		PRINCIPLES OF EMBEDDING PROGRAM DESIGN LANGUAGE, OR
		PSEUDO-CODE, IN A STRUCTURED FORTRAN PROGRAM, WHERE
		THE STRUCTURE IS GRAPHICALLY ILLUSTRATED BY THE LEVEL
		OF INDENTATION OF BOTH THE FORTRAN STATEMENTS AND THE
		PDL STATEMENTS (WHICH ARE WRITTEN ON SPECIALLY-FLAGGED
		FORTRAN COMMENTS).  
		     THE DSPLOG PROGRAM, WHEN EXECUTED, WILL EXTRACT
		THE EMBEDDED PDL FROM A FORTRAN SOURCE AND DISPLAY IT
		ALONE, SO THAT THE STRUCTURE AND LOGIC OF THE PROGRAM
		CAN BE STUDIED INDEPENDENTLY OF THE CODE.
		     NATURALLY, TO USE THIS TECHNIQUE SATISFACTORILY
		ONE MUST HAVE A CERTAIN AMOUNT OF SELF-DISCIPLINE IN
		ORDER TO MAKE THE SOURCE AND COMMENTS CORRESPOND TO EACH
		OTHER APPROPRIATELY.
 
	DSPLOG.PDL - A PRINT FILE OUTPUT FROM THE DSPLOG PROGRAM 
		OPERATING ON ITS OWN SOURCE TEXT, ILLUSTRATING THE
		PRINCIPLES STATED ABOVE.
 
	PRNDOC.PGM - AN INDIRECT COMMAND FILE CONTAINING THE SOURCE
		TEXT (FORTRAN 4-PLUS) FOR THE "PRINT DOCUMENTATION"
		PROGRAM USED AT USAFETAC TO PRINT EMBEDDED USER MANUALS
		(SUCH AS CAN BE FOUND WITHIN BOTH PRNDOC AND DSPLOG).
		THE COMMAND FILE SETS UP THE COMPILATION AND TASK-BUILD
		OF THE PROGRAM.
 
	PLOTSM.SUB - AN INDIRECT COMMAND FILE CONTAINING THE SOURCE
		TEXT (FORTRAN 4-PLUS) FOR THE "VIRTUAL" HALF OF THE
		VIRTUAL PLOTTER PACKAGE.
	PLOTTR.FTN - THE FORTRAN 4-PLUS SOURCE TEST FOR THE "REAL" HALF
		OF THE VIRTUAL PLOTTER PACKAGE.
		     THE VIRTUAL PLOTTER PACKAGE WAS PRESENTED IN A
		POSTER PAPER AT THE SPRING 1982 (ATLANTA) DECUS
		SYMPOSIUM.  IT PROVIDES A VERY SIMPLY WAY TO PUT A
		VIRTUAL PLOTTER ON A COMPUTER SYSTEM WHICH DOES NOT
		HAVE A REAL PLOTTER; THE VIRTUAL PLOTTER SUBROUTINE
		SIMULATES THE PRESENCE OF AN ACTUAL PLOTTER SOFTWARE
		PACKAGE, ACCEPTING THE ARGUMENTS PASSED TO IT AND WRITING
		A TRANSFER FILE WHICH CAN BE MOVED (E.G. VIA TAPE) TO A
		SYSTEM HAVING A REAL PLOTTER.  ON THE SECOND SYSTEM, THE
		PLOT TRANSFER PROGRAM "PLOTTR" READS THE TRANSFER FILE
		AND CALLS THE ACTUAL PLOTTER SOFTWARE. 
		     THE PACKAGE AS PRESENTED HERE USES CALCOMP-STYLE
		CALLS, WITH SOME ADDITIONAL SUPPORT FOR A VERSATEC
		RASTER PLOTTER.  IT CAN READILY BE TAILORED TO THE
		PARTICULARS OF ANY SIMILAR PLOTTER SOFTWARE SYSTEM.
 
 ALSO INCLUDED ARE A FEW SUBROUTINES USED BY SOME OF THE ABOVE PROGRAMS.
 THESE ARE ALL IN THE FORM OF INDIRECT COMMAND FILES CONTAINING THE
 FORTRAN 4-PLUS OR MACRO-11 SOURCE TEXT PLUS THE COMMANDS NEEDED TO
 COMPILE OR ASSEMBLE THEM.  THEY ARE AS FOLLOWS:
	BEGIN.SUB - USED TO TYPE STARTING MESSAGE AND DTG
	QUIT.SUB  - USED TO TYPE FINISHED MESSAGE AND DTG
	   (DOCUMENTATION ONLY; ENTRY POINT IS IN "BEGIN".)
	TRMSG.SUB - USED FOR SOME TERMINAL I/O.
	CHAR7.SUB - USED TO BUILD LARGE (7X7) CHARACTERS
	MESSG.SUB - USED FOR TERMINAL OUTPUT OF SIMPLE MESSAGES.
	   (OBSOLETE--SHOULD BE REPLACED WITH TRMSG.)
	TABIT.SUB - USED TO CHANGE TABS TO CORRECT NUMBER OF SPACES.
 
 PLEASE NOTE THAT ALL OF THE ABOVE SOURCES ARE EXACTLY AS THEY APPEAR ON
 OUR CURRENT SYSTEM, EXCEPT FOR THE ADDITION OF THE CAVEAT REPEATED 
 BELOW.  NO EFFORT HAS BEEN MADE TO CLEAN UP THE CODE PURELY FOR THIS
 DECUS DISTRIBUTION.  IF YOUR PROFESSIONAL SENSIBILITIES ARE OFFENDED BY
 SOME OF THE THINGS YOU SEE IN THESE FILES, PLEASE ACCEPT OUR APOLOGIES.
 THE CURRENT STATE OF OUR ART IS MUCH BETTER, BUT OUR RESOURCES DO NOT
 PERMIT RETROFITTING SOFTWARE FOR STYLE UNTIL MAINTENANCE IS REQUIRED
 FOR OTHER PURPOSES AS WELL.  GOOD LUCK!	C.S.Z.
C
C
C
C************************************************************************
C*									*
C*	THIS SOFTWARE IS RELEASED FOR PUBLIC USE UNDER THE PROVISIONS	*
C*	OF AIR FORCE REGULATION 300-6, MAC SUPPLEMENT 1, PARA.11-7,	*
C*	BY USAFETAC/ADW, SCOTT AFB, IL 62225.  THIS SOFTWARE IS 	*
C*	RELEASED "AS-IS"; THE U. S. AIR FORCE HAS NO WARRANTY		*
C*	RESPONSIBILITY OR LIABILITY FOR THE OPERATION OR USE OF		*
C*	SOFTWARE RELEASED UNDER THIS POLICY.				*
C*									*
C*	RELEASE OF THIS SOFTWARE IS BEING DONE THROUGH DECUS, SO	*
C*	ALL USUAL DECUS DISCLAIMERS APPLY AS WELL.			*
C*									*
C*	UNDER THE PROVISIONS OF THE REGULATION CITED ABOVE, NO		*
C*	CONTRACTOR MAY CHARGE THE GOVERNMENT FOR THE USE OF THIS	*
C*	SOFTWARE DURING THE PERFORMANCE OF ANY CONTRACT WITH THE	*
C*	GOVERNMENT.							*
C*									*
C*	USERS WHO OBTAIN THIS SOFTWARE THROUGH DECUS DISTRIBUTION	*
C*	ARE WELCOME TO SEND COMMENTS TO THE AUTHOR, AS FOLLOWS:		*
C*		USAFETAC/ADW						*
C*		ATTN: MAJOR CARL S. ZIMMERMAN				*
C*		SCOTT AFB, IL  62225					*
C*	GIVEN THE EXIGENCIES OF MILITARY SERVICE, A REPLY TO YOUR	*
C*	COMMENTS CANNOT BE GUARANTEED.					*
C*									*
C************************************************************************
C
