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