Document and test --print-tokens

man/remind.1.in

@@ -468,6 +468,14 @@ case-sensitive:
 The \fB\-\-version\fR option causes \fBRemind\fR to print its version number
 to standard output and then exit.
 .TP
+.B \-\-print-tokens
+The \fB\-\-print-tokens\fR option causes \fBRemind\fR to print the tokens
+used by the parser, built-in function names, and system variable names
+to standard output and then exit.  This output is designed to make it easy
+to create a syntax-highlighting file for various text editors.  The output
+can be modified by hand or by a script into a syntax-highlighting file
+with relative ease.
+.TP
 .B \-\-max-execution-time\fR=\fIn\fR
 Limit the total execution time (as measured by the wall clock) to
 \fIn\fR seconds.  This is useful if \fBRemind\fR is invoked on

tests/test-rem

@@ -597,6 +597,9 @@ if test $? = 0 ; then
     done
 fi
 
+# Test --print-tokens long option
+../src/remind --print-tokens < /dev/null >> ../tests/test.out 2>&1
+
 cmp -s ../tests/test.out ../tests/test.cmp
 if [ "$?" = "0" ]; then
    echo "Remind:  Acceptance test PASSED"

tests/test.cmp

@@ -13235,3 +13235,344 @@ No reminders.
 |          |          |          |          |          |          |          |
 +----------+----------+----------+----------+----------+----------+----------+
 
+# Remind Tokens
+
+addomit
+after
+at
+ban
+banner
+before
+cal
+clear
+clear-omit-context
+debug
+do
+dump
+dumpvars
+duration
+else
+endif
+errmsg
+exit
+expr
+first
+flush
+fourth
+from
+fset
+funset
+if
+iftrig
+in
+inc
+include
+includecmd
+last
+lastday
+lastworkday
+maybe
+maybe-uncomputable
+msf
+msg
+noqueue
+omit
+omitfunc
+once
+pop
+pop-omit-context
+preserve
+priority
+ps
+psfile
+push
+push-omit-context
+rem
+run
+satisfy
+scan
+scanfrom
+sched
+second
+set
+skip
+special
+tag
+third
+through
+unset
+until
+warn
+
+# Month Names
+
+apr
+april
+aug
+august
+dec
+december
+feb
+february
+jan
+january
+jul
+july
+jun
+june
+mar
+march
+may
+nov
+november
+oct
+october
+sep
+september
+
+# Weekdays
+
+fri
+friday
+mon
+monday
+sat
+saturday
+sun
+sunday
+thu
+thursday
+tue
+tuesday
+wed
+wednesday
+
+# Built-in Functions
+
+abs
+access
+adawn
+adusk
+ampm
+ansicolor
+args
+asc
+baseyr
+char
+choose
+coerce
+columns
+current
+date
+datepart
+datetime
+dawn
+day
+daysinmon
+defined
+dosubst
+dusk
+easterdate
+evaltrig
+filedate
+filedatetime
+filedir
+filename
+getenv
+hebdate
+hebday
+hebmon
+hebyear
+hour
+htmlescape
+htmlstriptags
+iif
+index
+isany
+isdst
+isleap
+isomitted
+language
+localtoutc
+lower
+max
+min
+minsfromutc
+minute
+mon
+monnum
+moondate
+moondatetime
+moonphase
+moontime
+multitrig
+ndawn
+ndusk
+nonomitted
+now
+ord
+orthodoxeaster
+ostype
+pad
+plural
+psmoon
+psshade
+realcurrent
+realnow
+realtoday
+rows
+sgn
+shell
+shellescape
+slide
+soleq
+stdout
+strlen
+substr
+sunrise
+sunset
+time
+timepart
+timezone
+today
+trig
+trigback
+trigdate
+trigdatetime
+trigdelta
+trigduration
+trigeventduration
+trigeventstart
+trigfrom
+trigger
+trigpriority
+trigrep
+trigscanfrom
+trigtags
+trigtime
+trigtimedelta
+trigtimerep
+triguntil
+trigvalid
+typeof
+tzconvert
+upper
+utctolocal
+value
+version
+weekno
+wkday
+wkdaynum
+year
+
+# System Variables
+
+$AddBlankLines
+$Ago
+$Am
+$And
+$April
+$At
+$August
+$CalcUTC
+$CalMode
+$Daemon
+$DateSep
+$DateTimeSep
+$December
+$DefaultColor
+$DefaultPrio
+$DefaultTDelta
+$DeltaOverride
+$DontFork
+$DontQueue
+$DontTrigAts
+$EndSent
+$EndSentIg
+$ExpressionTimeLimit
+$February
+$FirstIndent
+$FoldYear
+$FormWidth
+$Friday
+$Fromnow
+$Hour
+$Hplu
+$HushMode
+$IgnoreOnce
+$InfDelta
+$IntMax
+$IntMin
+$Is
+$January
+$July
+$June
+$LatDeg
+$Latitude
+$LatMin
+$LatSec
+$Location
+$LongDeg
+$Longitude
+$LongMin
+$LongSec
+$March
+$MaxFullOmits
+$MaxLateMinutes
+$MaxPartialOmits
+$MaxSatIter
+$MaxStringLen
+$May
+$MinsFromUTC
+$Minute
+$Monday
+$Mplu
+$NextMode
+$November
+$Now
+$NumFullOmits
+$NumPartialOmits
+$NumQueued
+$NumTrig
+$October
+$On
+$OnceFile
+$ParseUntriggered
+$Pm
+$PrefixLineNo
+$PSCal
+$RunOff
+$Saturday
+$September
+$SimpleCal
+$SortByDate
+$SortByPrio
+$SortByTime
+$SubsIndent
+$Sunday
+$SuppressLRM
+$SysInclude
+$T
+$Td
+$TerminalBackground
+$Thursday
+$TimeSep
+$Tm
+$Today
+$Tomorrow
+$Tt
+$Tuesday
+$Tw
+$Ty
+$U
+$Ud
+$Um
+$UntimedFirst
+$Use256Colors
+$UseBGVTColors
+$UseTrueColors
+$UseVTColors
+$Uw
+$Uy
+$Was
+$Wednesday