Interlisp.medley/internal/test/DOT.read-me-first

XAIS Testing Directory Structure
Special Files:  For saving overall-testing information
	Information	{Eris}<Test>, files named .name, e.g. ª.read-me-firstº , this file.
	Procedures	{Eris}<Test>Admin> for overall procedure files, rather than specific test plans or scripts
	Results	{Eris}<Test>ARs> for the results of AR test-case regression runs.
	Tools	{Eris}<Test>Tools> for general-purpose files like do-test or do-test-menu.
Language:  The Interlisp & Common Lisp languages, interpreters, compilers
	Plans	{Eris}<Test>Language>Plans>
	Results	{Eris}<Test>Language>Logs>
	Auto
		Test-Files	{Eris}<Test>Language>Auto>
		Aux-Files	{Eris}<Test>Language>Auto-Aux>
	Hand
		Scripts	{Eris}<Test>Language>Hand>
		Aux-Files	{Eris}<Test>Language>Hand-Aux>
I/O:  Streams, Windows
	Plans	{Eris}<Test>IO>Plans>
	Results	{Eris}<Test>IO>Logs>
	Auto
		Test-Files	{Eris}<Test>IO>Auto>
		Aux-Files	{Eris}<Test>IO>Auto-Aux>
	Hand
		Scripts	{Eris}<Test>IO>Hand>
		Aux-Files	{Eris}<Test>IO>Hand-Aux>
Prog Environment:  Exec, Code Editing, Debugging, Application Toolkits
	[subsection: Exec, Debugger, Editors]
		Plans	{Eris}<Test>Env>subsection>Plans>
		Results	{Eris}<Test>Env>subsection>Logs>
		Auto
			Test-Files	{Eris}<Test>Env>subsection>Auto>
			Aux-Files	{Eris}<Test>Env>subsection>Auto-Aux>
		Hand
			Scripts	{Eris}<Test>Env>subsection>Hand>
			Aux-Files	{Eris}<Test>Env>subsection>Hand-Aux>
Library: Individual Modules
	[Module name]
		Plans	{Eris}<Test>Library>module>Plans>
		Results	{Eris}<Test>Library>module>Logs>
		Auto
			Test-Files	{Eris}<Test>Library>module>Auto>
			Aux-Files	{Eris}<Test>Library>module>Auto-Aux>
		Hand
			Scripts	{Eris}<Test>Library>module>Hand>
			Aux-Files	{Eris}<Test>Library>module>Hand-Aux>
LispUsers: Repository for obsoleted library tests when modules are demoted
	[Module name]
		Plans	{Eris}<Test>LispUsers>module>Plans>
		Results	{Eris}<Test>LispUsers>module>Logs>
		Auto
			Test-Files	{Eris}<Test>LispUsers>module>Auto>
			Aux-Files	{Eris}<Test>LispUsers>module>Auto-Aux>
		Hand
			Scripts	{Eris}<Test>LispUsers>module>Hand>
			Aux-Files	{Eris}<Test>LispUsers>module>Hand-Aux>
Applications: ªCustomer Applications" for stress-testing system or subsystems
	[Application name]
		Plans	{Eris}<Test>Customer-Applications>application-name>Plans>
		Results	{Eris}<Test>Customer-Applications>application-name>Logs>
		Auto
			Test-Files	{Eris}<Test>Customer-Applications>application-name>Auto>
			Aux-Files	{Eris}<Test>Customer-Applications>application-name>Auto-Aux>
		Hand
			Scripts	{Eris}<Test>Customer-Applications>application-name>Hand>
			Aux-Files	{Eris}<Test>Customer-Applications>application-name>Hand-Aux>
[Subsystem, e.g. PCE]: One subdirectory per distinct product (PCE, Rooms, DEI, ...)
	Plans	{Eris}<Test>subsystem>Plans>
	Results	{Eris}<Test>subsystem>Logs>
	Auto
		Test-Files	{Eris}<Test>subsystem>Auto>
		Aux-Files	{Eris}<Test>subsystem>Auto-Aux>
	Hand
		Scripts	{Eris}<Test>subsystem>Hand>
		Aux-Files	{Eris}<Test>subsystem>Hand-Aux>
File Naming
ÿÿï%.test
ÿA file of DO-TEST forms, suitable for running with DO-TEST-FILE or DO-ALL-TESTS.  Within a directory, files are named x-y-z-w....test, with more general descriptions to the left, and more specific naming to the right.  For example, there might be several tests of Lists:  LIST-CREATION.TEST and LIST-MODIFICATION.TEST.  It is poor form to include the words REGRESSION, TEST, or such like in the file name:  Regression tests should be folded into the main test file, and all of these files are tests, so that's redundant.
ÿÿï%.u
ÿA script to be followed during hand testing.  Within a directory, files are named x-y-z-w....u, with more general descriptions to the left, and more specific naming to the right.  For example, the Exec might have several test files, e.g., Exec-PL.u, Exec-DIR.u, etc.
ÿÿï%.plan
ÿ	A plan for testing a section of the system, a new product like PCE, etc.
ÿÿï%-m-d-y.logÿ
	The results of running a test or series of tests.
;
$T>
Ô$0<>
$0<>
$0<,MODERN
MODERN

MODERNMODERNMODERN
MODERN!7
'

%
g
K
RJ
#
$

(
+

%
+



"
%


%G'

















"
!


!K

 

$
#

!
#N
*
,

0
/

-
/T
	
	

	
	

	
	

L3‹ézº