diff options
| author | Robin Haberkorn <robin.haberkorn@googlemail.com> | 2016-02-26 02:02:50 +0100 |
|---|---|---|
| committer | Robin Haberkorn <robin.haberkorn@googlemail.com> | 2016-11-18 07:05:52 +0100 |
| commit | e7867fb0d9979c550e6e3d7597ece73b680c4af6 (patch) | |
| tree | dc7a273abc5dd75ecdd94bc62419cd966f38b6d0 /src/Makefile.am | |
| parent | c0fe49457d37e4c51cd4fd829895a60ae24bc8af (diff) | |
| download | sciteco-e7867fb0d9979c550e6e3d7597ece73b680c4af6.tar.gz | |
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.
Diffstat (limited to 'src/Makefile.am')
| -rw-r--r-- | src/Makefile.am | 9 |
1 files changed, 5 insertions, 4 deletions
diff --git a/src/Makefile.am b/src/Makefile.am index 515accd..314faa4 100644 --- a/src/Makefile.am +++ b/src/Makefile.am @@ -43,6 +43,7 @@ libsciteco_base_la_SOURCES = main.cpp sciteco.h \ spawn.cpp spawn.h \ glob.cpp glob.h \ goto.cpp goto.h \ + help.cpp help.h \ rbtree.cpp rbtree.h \ symbols.cpp symbols.h \ interface.cpp interface.h @@ -75,10 +76,10 @@ CLEANFILES = $(BUILT_SOURCES) \ symbols-scintilla.cpp : @SCINTILLA_PATH@/include/Scintilla.h \ symbols-extract.tes - $(BOOTSTRAP_SCITECO) -m @srcdir@/symbols-extract.tes \ - $< $@ "SCI_" scintilla + $(SCITECO_MINIMAL) -m @srcdir@/symbols-extract.tes \ + $< $@ "SCI_" scintilla symbols-scilexer.cpp : @SCINTILLA_PATH@/include/SciLexer.h \ symbols-extract.tes - $(BOOTSTRAP_SCITECO) -m @srcdir@/symbols-extract.tes \ - $< $@ "SCLEX_,SCE_" scilexer + $(SCITECO_MINIMAL) -m @srcdir@/symbols-extract.tes \ + $< $@ "SCLEX_,SCE_" scilexer |