aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorRobin Haberkorn <robin.haberkorn@googlemail.com>2024-11-10 20:33:39 +0300
committerRobin Haberkorn <robin.haberkorn@googlemail.com>2024-11-10 20:33:39 +0300
commit0ddb6a853eca4de886a18cb3419981234b738edb (patch)
treed63cb99398c6c4562834eedacb869c081a2f6975
parentb844b67dec65bf46f101a3cd86d4e4ddc627c63e (diff)
downloadsciteco-0ddb6a853eca4de886a18cb3419981234b738edb.tar.gz
updated grosciteco.tes(1): mention new macros, changed command lines and restrictions
-rw-r--r--TODO4
-rw-r--r--doc/grosciteco.tes.1.in16
2 files changed, 19 insertions, 1 deletions
diff --git a/TODO b/TODO
index 473916c..e5d2bf4 100644
--- a/TODO
+++ b/TODO
@@ -572,6 +572,10 @@ Features:
* session.tes: Perhaps persist the search-replace registers "-" and "_".
Ideally we would also persist any manually configured lexer,
but we cannot easily store the current buffer's lexer.
+ * grosciteco: Does not currently support diacritics.
+ This is because Groff decomposes characters in intermediate output.
+ Either we have to consult devutf8/R or use wrap g_unichar_compose().
+ This will be important once we want to localize documentation.
Optimizations:
* Use SC_DOCUMENTOPTION_STYLES_NONE in batch mode.
diff --git a/doc/grosciteco.tes.1.in b/doc/grosciteco.tes.1.in
index d264afc..ba75a7a 100644
--- a/doc/grosciteco.tes.1.in
+++ b/doc/grosciteco.tes.1.in
@@ -132,6 +132,16 @@ Marks the end of an area that must be formatted in a
monospaced font.
The optional \fBSP\fP keyword may be specified to skip one
line vertically (via troff's \fB.sp\fP request).
+.TQ
+\fB.SCITECO_STARTSTYLING\fP
+.SCITECO_TOPIC .SCITECO_STARTSTYLING SCITECO_STARTSTYLING
+Marks the beginning of a block for manual Scintilla styling.
+.TQ
+\fB.SCITECO_SETSTYLING\fP \fIstyle\fP
+.SCITECO_TOPIC .SCITECO_SETSTYLING SCITECO_SETSTYLING
+Assign the given Scintilla style number to the block beginning with
+.BR .SCITECO_STARTSTYLING .
+This style must have been configured in a custom macro.
.
.LP
These public macros will be ignored if \(lqsciteco.tmac\(rq
@@ -157,7 +167,7 @@ a \*(ST macro package with a man page called
.RS
.SCITECO_TT
.EX
-groff -Z -Tascii -man -M@scitecodatadir@ -msciteco \\
+groff -Z -Kutf-8 -Tutf8 -man -M@scitecodatadir@ -msciteco \\
great-macro.tes.7sciteco >great-macro.tes.7sciteco.intermediate
grosciteco.tes great-macro.tes.7sciteco.woman great-macro.tes.7sciteco.woman.tec \\
great-macro.tes.7sciteco.intermediate
@@ -173,7 +183,11 @@ to make the files accessible in \*(ST's online-help system.
.
.SH BUGS
.
+.LP
\fBgrosciteco\fP is quite slow, although this is a \*(ST issue.
+.LP
+The \fBpic\fP(1) preprocessor is poorly supported and diacritics
+may not be rendered properly.
.
.
.SH SEE ALSO