Imported Debian patch 110.74-1
[hcoop/zz_old/debian/smlnj.git] / debian / nowhere.1
diff --git a/debian/nowhere.1 b/debian/nowhere.1
new file mode 100644 (file)
index 0000000..c1fe330
--- /dev/null
@@ -0,0 +1,59 @@
+.TH nowhere 1 "July 21, 2004"
+.SH NAME
+nowhere \- a tree parser generator for Standard ML
+.SH SYNOPSIS
+.B nowhere
+.I file
+.br
+.SH DESCRIPTION
+This manual page documents briefly the
+.B nowhere
+command.
+This manual page was written for the Debian distribution
+because the original program does not have a manual page.
+
+The
+.B nowhere
+program is a simple source to source translation tool that expands out
+case expressions with conditional patterns.
+
+Conditional patterns use the "where" keyword.  For example:
+
+ case l of
+   [x,y,z] where x=1 => 1
+ | _ => 2
+
+means the same as:
+
+ case l of
+   [1,y,z] => 1
+ | _ => 2
+
+Currently, the input file must be of the following form:
+
+ local
+   <definitions>
+ in
+   <body>
+ end
+   <definitions>
+
+should include all datatypes definitions that are used inside the
+.IR body .
+It is only for the tool's benefit and does not appear in the output.
+Only
+.I body
+appears at the output.  You can use the special declaration
+
+     include "filename"
+
+to import extra definitions.
+
+The tool translates all case expressions with guards into the appropriate code.
+
+.SH SEE ALSO
+.I /usr/share/doc/nowhere/README
+.br
+.SH AUTHOR
+This manual page was written by Aaron Read <amread@nyx.net>. for the
+Debian GNU/Linux system (but may be used by others)