standard lib: added getopt.tes for parsing command line options in scripts

 * this uses an optstring compatible with getopt(3).
 * It does not use repeated getopt calls to iterate options, though
   but places the results in registers beginning with "getopt.".
   E.g. option "C" will result in "getopt.C" being set after the
   call to setopt.
   String arguments are supported and are placed in the string part
   of the getopt registers.
 * The grosciteco.tes and symbols-extract.tes scripts make use of
   getopt now, to simplify and clean up their command line handling.

3 files changed, 17 insertions, 10 deletions

diff --git a/doc/Makefile.am b/doc/Makefile.am
index e63284a..fed0ebb 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -40,8 +40,8 @@ CLEANFILES += $(women_DATA)
 # cannot currently read stdin, so the grosciteco postprocessor
 # has to be run on a separate file.
 %.woman %.woman.tec : %.intermediate grosciteco.tes
-	$(SCITECO_FULL) -m @srcdir@/grosciteco.tes \
-	                   $(basename $<).woman $(basename $<).woman.tec $<
+	$(SCITECO_FULL) -m -- @srcdir@/grosciteco.tes \
+	                $@ $<
 
 %.intermediate : % sciteco.tmac
 	@GROFF@ -Z -Tascii -t -man -M@srcdir@ -msciteco $< >$@
diff --git a/doc/grosciteco.tes b/doc/grosciteco.tes
index 7be01fb..262f2c0 100755
--- a/doc/grosciteco.tes
+++ b/doc/grosciteco.tes
@@ -1,9 +1,14 @@
 #!/usr/local/bin/sciteco -m
-!* grosciteco.tes <output-woman> <output-tec> <input> *!
+!* grosciteco.tes [-t <output-tec>] [--] <output-woman> <input> *!
+
+:EMQ[$SCITECOPATH]/getopt.tes
 
 !* Process command-line options *!
-LR 0X[output-woman] 2LR 0X[output-tec] 2LR 0X[input] HK
-EBQ[input]
+[optstring]t: M[getopt]"F (0/0) '
+LR 0X[output-woman] 2LR 0X[input] HK
+:Q[getopt.t]"< EU[getopt.t]Q[output-woman].tec '
+
+EBN[input]
 
 ! skip whitespace characters !
 @#sw{
@@ -278,6 +283,6 @@ EQ[styles]
 !* Generate topic index *!
 J I!*Q[topics]*!^J
 
-EWQ[output-tec]
+EWQ[getopt.t]
 
 -EX
diff --git a/doc/grosciteco.tes.1.in b/doc/grosciteco.tes.1.in
index e890a96..0aac8dc 100644
--- a/doc/grosciteco.tes.1.in
+++ b/doc/grosciteco.tes.1.in
@@ -15,8 +15,9 @@ GNU roff post-processor for \*(ST
 .SH SYNOPSIS
 .
 .SY grosciteco.tes
+.OP "-t" tec_output
+.OP "--"
 .I text_output
-.I tec_output
 .I input
 .YS
 .
@@ -66,9 +67,7 @@ documentation within \*(ST.
 .
 .SH OPTIONS
 .
-.IP "\fItext_output\fP
-The plain-text output file, e.g. \(lqgreat-macro.woman\(rq.
-.IP "\fItec_output\fP
+.IP "\fB-t \fItec_output\fR"
 The \*(ST script that when executed after loading
 \fItext_output\fP into a Scintilla view, styles that document.
 It can be thought of as representing meta-information
@@ -76,6 +75,9 @@ for \fItext_output\fP.
 In order to cooperate with the \(lqwoman\(rq lexer and
 \*(ST's \fB?\fP command, its file name should be
 \fItext_output\fP.tec, e.g. \(lqgreat-macro.woman.tec\(rq.
+This is also the default when omitted.
+.IP "\fItext_output\fP
+The plain-text output file, e.g. \(lqgreat-macro.woman\(rq.
 .IP "\fIinput\fP"
 The \fIinput\fP file is in \fBtroff\fP's device-independant
 output format.