Index: docs/megatest.html ================================================================== --- docs/megatest.html +++ docs/megatest.html @@ -2,11 +2,11 @@ - + Megatest
@@ -84,33 +84,53 @@
Section 0.3: Reference
-Subsection 0.3.1: Environment variables -
-
-Subsection 0.3.2: Configuration files -
-
-
-Subsubsection 0.3.2.1: megatest.config -
-
-Subsubsection 0.3.2.2: runconfigs.config file -
-
-
-Subsection 0.3.3: Writing tests -
-
-
-Subsubsection 0.3.3.1: testconfig file -
-
-
-Subsection 0.3.4: Command line +Subsection 0.3.1: Configuration files +
+
+
+Subsubsection 0.3.1.1: Sections +
+
+Subsubsection 0.3.1.2: Variables +
+
+Subsubsection 0.3.1.3: Includes +
+
+Subsubsection 0.3.1.4: Setting a variable by running a command +
+
+Subsubsection 0.3.1.5: Notes +
+
+
+Subsection 0.3.2: Environment variables +
+
+Subsection 0.3.3: Configuration files +
+
+
+Subsubsection 0.3.3.1: megatest.config +
+
+Subsubsection 0.3.3.2: runconfigs.config file +
+
+
+Subsection 0.3.4: Writing tests +
+
+
+Subsubsection 0.3.4.1: testconfig file +
+
+
+Subsection 0.3.5: Command line
@@ -282,11 +302,62 @@

0.3 Reference

-0.3.1 Environment variables +0.3.1 Configuration files +

+

+0.3.1.1 Sections +

+
+[section name] +
+
+This creates a section named “section name” +
+

+0.3.1.2 Variables +

+
+VARX has this value +
+
+The variable “VARX” will have the value “has this value” +
+

+0.3.1.3 Includes +

+
+[include filename] +
+
+The file named “filename” will be included as if part of the calling file. NOTE: This means no section can be named “include “ (with the whitespace). +
+

+0.3.1.4 Setting a variable by running a command +

+
+VARNAME [system ls /tmp] +
+
+The variable “VARNAME” will get a value created by the Unix command “ls /tmp”. All lines of output from the command will be joined with a space. +
+

+0.3.1.5 Notes +

+ +

+0.3.2 Environment variables

@@ -399,14 +470,14 @@

-0.3.2 Configuration files +0.3.3 Configuration files

-0.3.2.1 megatest.config +0.3.3.1 megatest.config

@@ -573,11 +644,11 @@

-0.3.2.2 runconfigs.config file +0.3.3.2 runconfigs.config file

@@ -646,31 +717,43 @@
[default]
ENCRYTION true +
+
+#
[megacorp/india]
TESTPATH /nfs/testing/megacorp_runs +
+
+#
[femtocorp/cook_islands]
ENCRYTION false
TESTPATH /afs/kiatoa/testing/cook_islands +
+
+#
[femtocorp/new_zealand]
TESTPATH /afs/kiatao/testing/new_zealand +
+
+#
[megacorp/new_zealand]
@@ -690,14 +773,14 @@
TESTPATH /nfs/testing/megacorp_runs

-0.3.3 Writing tests +0.3.4 Writing tests

-0.3.3.1 testconfig file +0.3.4.1 testconfig file

@@ -774,11 +857,11 @@

-0.3.4 Command line +0.3.5 Command line

@@ -1115,10 +1198,10 @@
Index: docs/megatest.lyx ================================================================== --- docs/megatest.lyx +++ docs/megatest.lyx @@ -349,10 +349,133 @@ \end_layout \begin_layout Section Reference \end_layout + +\begin_layout Subsection +Configuration files +\end_layout + +\begin_layout Subsubsection +Sections +\end_layout + +\begin_layout Standard +[section name] +\end_layout + +\begin_layout Standard +This creates a section named +\begin_inset Quotes eld +\end_inset + +section name +\begin_inset Quotes erd +\end_inset + + +\end_layout + +\begin_layout Subsubsection +Variables +\end_layout + +\begin_layout Standard +VARX has this value +\end_layout + +\begin_layout Standard +The variable +\begin_inset Quotes eld +\end_inset + +VARX +\begin_inset Quotes erd +\end_inset + + will have the value +\begin_inset Quotes eld +\end_inset + +has this value +\begin_inset Quotes erd +\end_inset + + +\end_layout + +\begin_layout Subsubsection +Includes +\end_layout + +\begin_layout Standard +[include filename] +\end_layout + +\begin_layout Standard +The file named +\begin_inset Quotes eld +\end_inset + +filename +\begin_inset Quotes erd +\end_inset + + will be included as if part of the calling file. + NOTE: This means no section can be named +\begin_inset Quotes eld +\end_inset + +include +\begin_inset Quotes eld +\end_inset + + (with the whitespace). +\end_layout + +\begin_layout Subsubsection +Setting a variable by running a command +\end_layout + +\begin_layout Standard +VARNAME [system ls /tmp] +\end_layout + +\begin_layout Standard +The variable +\begin_inset Quotes eld +\end_inset + +VARNAME +\begin_inset Quotes erd +\end_inset + + will get a value created by the Unix command +\begin_inset Quotes eld +\end_inset + +ls /tmp +\begin_inset Quotes erd +\end_inset + +. + All lines of output from the command will be joined with a space. +\end_layout + +\begin_layout Subsubsection +Notes +\end_layout + +\begin_layout Itemize +Some variables are infered as lists. + Each token on the line separated by whitespace will be member of the list. +\end_layout + +\begin_layout Itemize +Comments (lines starting with #) and blank lines are ignored. +\end_layout \begin_layout Subsection Environment variables \end_layout @@ -1288,18 +1411,26 @@ \end_layout \begin_layout Code ENCRYTION true \end_layout + +\begin_layout Code +# +\end_layout \begin_layout Code [megacorp/india] \end_layout \begin_layout Code TESTPATH /nfs/testing/megacorp_runs \end_layout + +\begin_layout Code +# +\end_layout \begin_layout Code [femtocorp/cook_islands] \end_layout @@ -1308,18 +1439,26 @@ \end_layout \begin_layout Code TESTPATH /afs/kiatoa/testing/cook_islands \end_layout + +\begin_layout Code +# +\end_layout \begin_layout Code [femtocorp/new_zealand] \end_layout \begin_layout Code TESTPATH /afs/kiatao/testing/new_zealand \end_layout + +\begin_layout Code +# +\end_layout \begin_layout Code [megacorp/new_zealand] \end_layout