Index: docs/megatest.lyx
==================================================================
--- docs/megatest.lyx
+++ docs/megatest.lyx
@@ -468,12 +468,17 @@
 \end_inset
 
 
 \end_layout
 
-\begin_layout Code
+\begin_layout Section
+Choose Flow or Unstructured Run?
+\end_layout
 
+\begin_layout Standard
+A flow is a structured and specifically sequenced set of tests.
+ See the Flows chapter to understand the difference.
 \end_layout
 
 \begin_layout Chapter
 How to Write Tests
 \end_layout
@@ -546,11 +551,11 @@
 \begin_layout Subsection
 Create your main.csh script
 \end_layout
 
 \begin_layout Standard
-Note: Using csh is NOT recommended.
+Note: Using csh is NOT generally recommended.
  Use bash, perl, ruby, zsh or anything other than csh.
  We use csh here because it is popular in some industries.
  
 \end_layout
 
@@ -1136,10 +1141,146 @@
 \begin_layout Plain Layout
 
 waiton cpu mem
 \end_layout
 
+\end_inset
+
+
+\end_layout
+
+\begin_layout Chapter
+Flows
+\end_layout
+
+\begin_layout Standard
+A flow specifies the tests to run, the order and dependencies and is managed
+ by a running megatest process.
+\end_layout
+
+\begin_layout Section
+Flow Specification and Running
+\end_layout
+
+\begin_layout Subsection
+Write your flow file
+\end_layout
+
+\begin_layout Standard
+flows/<flowname>.config
+\end_layout
+
+\begin_layout Standard
+\begin_inset listings
+inline false
+status open
+
+\begin_layout Plain Layout
+
+# Flow: <flowname>
+\end_layout
+
+\begin_layout Plain Layout
+
+[flowconfig]
+\end_layout
+
+\begin_layout Plain Layout
+
+# turn on item level dependencies
+\end_layout
+
+\begin_layout Plain Layout
+
+itemdeps on
+\end_layout
+
+\begin_layout Plain Layout
+
+\end_layout
+
+\begin_layout Plain Layout
+
+[flowsteps]
+\end_layout
+
+\begin_layout Plain Layout
+
+# <testname>[,<predecessor>]
+\end_layout
+
+\begin_layout Plain Layout
+
+\end_layout
+
+\begin_layout Plain Layout
+
+# Run the test "copydata"
+\end_layout
+
+\begin_layout Plain Layout
+
+copydata
+\end_layout
+
+\begin_layout Plain Layout
+
+\end_layout
+
+\begin_layout Plain Layout
+
+# Run the test "setup" after copydata completes with PASS, WARN or WAIVE
+\end_layout
+
+\begin_layout Plain Layout
+
+setup,copydata
+\end_layout
+
+\begin_layout Plain Layout
+
+\end_layout
+
+\begin_layout Plain Layout
+
+# once the test "setup" completes successfully run sim1, sim2 and sim3
+\end_layout
+
+\begin_layout Plain Layout
+
+sim1,setup
+\end_layout
+
+\begin_layout Plain Layout
+
+sim2,setup
+\end_layout
+
+\begin_layout Plain Layout
+
+sim3,setup
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsection
+Run the flow
+\end_layout
+
+\begin_layout Standard
+\begin_inset listings
+inline false
+status open
+
+\begin_layout Plain Layout
+
+megatest -runflow <flowname> :FIELD1 val1 :FIELD2 val2 :runname wk32.4
+\end_layout
+
 \end_inset
 
 
 \end_layout