From e7867fb0d9979c550e6e3d7597ece73b680c4af6 Mon Sep 17 00:00:00 2001 From: Robin Haberkorn Date: Fri, 26 Feb 2016 02:02:50 +0100 Subject: implemented self-documenting (online) help system * the new "?" (help) command can be used to look up help topics. * help topics are index from $SCITECOPATH/women/*.woman.tec files. * looking up a help topic opens the corresponding "womanpage" and jumps to the position of the topic (it acts like an anchor into the document). * styling is performed by *.woman.tec files. * Setting up the Scintilla view and munging the *.tec file is performed by the new "woman.tes" lexer. On supporting UIs (Gtk), womanpages are shown in a variable-width font. * Woman pages are usually not hand-written, but generated from manpages. A special Groff post-processor grosciteco has been introduced for this purpose. It is much like grotty, but can output SciTECO macros for styling the document (ie. the *.woman.tec files). It is documented in its own man-page. * grosciteco also introduces sciteco.tmac - special Troff macros for controlling the formatting of the document in SciTECO. It also defines .SCITECO_TOPIC which can be used to mark up help topics/terms in Troff markup. * Woman pages are generated/formatted by grosciteco at compile-time, so they will work on platforms without Groff (ie. as on windows). * Groff has been added as a hard compile-time requirement. * The sciteco(1) and sciteco(7) man pages have been augmented with help topic anchors. --- bootstrap.am | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) (limited to 'bootstrap.am') diff --git a/bootstrap.am b/bootstrap.am index 7c878c6..7ff35d3 100644 --- a/bootstrap.am +++ b/bootstrap.am @@ -2,10 +2,20 @@ # standard library library export SCITECOPATH=@top_srcdir@/lib +# This provides two implementations of SciTECO running +# on the host as build-time tools. +# $(SCITECO_MINIMAL) can be used during the build-process +# of the target SciTECO, but may have only limited support for +# the ES command (no symbolic identifiers). +# $(SCITECO_FULL) is a final version of SciTECO, but is only +# available after the binary has been built in src/ +# (ie. in SUBDIRS after src/). if BOOTSTRAP -BOOTSTRAP_SCITECO = @top_builddir@/src/sciteco-minimal$(EXEEXT) +SCITECO_MINIMAL = @top_builddir@/src/sciteco-minimal$(EXEEXT) +SCITECO_FULL = @top_builddir@/src/sciteco$(EXEEXT) else -BOOTSTRAP_SCITECO = @SCITECO@ +SCITECO_MINIMAL = @SCITECO@ +SCITECO_FULL = @SCITECO@ endif SUBST_MACRO = eb$<\e \ @@ -26,4 +36,4 @@ SUBST_MACRO = eb$<\e \ %/config.h: ; % : %.in - $(BOOTSTRAP_SCITECO) -e $$'$(SUBST_MACRO)' + $(SCITECO_MINIMAL) -e $$'$(SUBST_MACRO)' -- cgit v1.2.3