aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPaul Garlick <pgarlick@tourbillion-technology.com>2020-07-01 12:08:46 +0100
committerPaul Garlick <pgarlick@tourbillion-technology.com>2020-07-01 12:08:46 +0100
commitb2568147c752c1103d49e5bd2431d2314744b29b (patch)
tree6f51ed3b43d49c0bdeb9328c3283d34495487011 /doc
parent15d2e4bbf79e9f424fa1ead8b6fba0f4f8bab031 (diff)
downloadfullSWOF-utils-b2568147c752c1103d49e5bd2431d2314744b29b.tar.gz
doc: Add Demos chapter.
* doc/fullswof-utils.texi (Demos): Add chapter.
Diffstat (limited to 'doc')
-rw-r--r--doc/fullswof-utils.texi20
1 files changed, 20 insertions, 0 deletions
diff --git a/doc/fullswof-utils.texi b/doc/fullswof-utils.texi
index 1132a86..6be130f 100644
--- a/doc/fullswof-utils.texi
+++ b/doc/fullswof-utils.texi
@@ -43,6 +43,7 @@ Utility scripts for the FullSWOF shallow flow solver
@menu
* Installation:: Installing FullSWOF-utils.
* Usage::
+* Demos::
* GNU Free Documentation License:: The license of this manual.
* Index:: Complete Index.
@end menu
@@ -293,6 +294,25 @@ number of height intervals
Comment lines are allowed in the boundary definition file. Lines that
start with the @samp{#} character are treated as comments.
+@node Demos, GNU Free Documentation License, Boundary Definition File, Top
+@comment node-name, next, previous, up
+@chapter Demos
+
+Examples of input files that demonstrate how to use
+@emph{FullSWOF-utils} programs are included in the @file{demo}
+directory. Sample height data, in the file @file{topography.txt}, is
+also provided.
+
+To run the demos directly, first change the current working directory to
+the @file{demo} directory. Then execute the individual program
+(@pxref{Invoking makeBoundary} for an example).
+
+The input files may be viewed with a text editor. To experiment with
+the control parameters, first back up the distributed input files and
+then edit the parameter values as desired. Note that the
+@command{makeBoundary} program will overwrite its output file if it
+already exists.
+
@node GNU Free Documentation License, Index, Usage, Top
@appendix GNU Free Documentation License
@include fdl-1.3.texi