aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc
diff options
context:
space:
mode:
authorRobin Haberkorn <robin.haberkorn@googlemail.com>2024-09-09 16:54:26 +0200
committerRobin Haberkorn <robin.haberkorn@googlemail.com>2024-09-09 18:22:21 +0200
commit4f231871a0208ec9bcc2679fce25d3b9795d1597 (patch)
treebdc9055166fe236f009c6640acf53b6706310c27 /doc
parent41ab5cf0289dab60ac1ddc97cf9680ee2468ea6c (diff)
downloadsciteco-4f231871a0208ec9bcc2679fce25d3b9795d1597.tar.gz
added raw ANSI mode to facilitate 8-bit clean editing (refs #5)
* When enabled with bit 2 in the ED flags (0,4ED), all registers and buffers will get the raw ANSI encoding (as if 0EE had been called on them). You can still manually change the encoding, eg. by calling 65001EE afterwards. * Also the ANSI mode sets up character representations for all bytes >= 0x80. This is currently done only depending on the ED flag, not when setting 0EE. * Since setting 16,4ED for 8-bit clean editing in a macro can be tricky - the default unnamed buffer will still be at UTF-8 and at least a bunch of environment registers as well - we added the command line option `--8bit` (short `-8`) which configures the ED flags very early on. As another advantage you can mung the profile in 8-bit mode as well when using SciTECO as a sort of interactive hex editor. * Disable UTF-8 checks in 8-bit clean mode (sample.teco_ini).
Diffstat (limited to 'doc')
-rw-r--r--doc/sciteco.1.in9
-rw-r--r--doc/sciteco.7.template5
2 files changed, 13 insertions, 1 deletions
diff --git a/doc/sciteco.1.in b/doc/sciteco.1.in
index 73303a1..b03f62d 100644
--- a/doc/sciteco.1.in
+++ b/doc/sciteco.1.in
@@ -19,6 +19,7 @@ Scintilla-based \fBT\fPext \fBE\fPditor and \fBCO\fPrrector
.OP "-e|--eval" macro
.OP "-m|--mung"
.OP "--no-profile"
+.OP "-8|--8bit"
.RI [ "UI option .\|.\|." ]
.OP "--"
.RI [ script ]
@@ -191,6 +192,14 @@ munging an empty file.
This is useful to fix up a broken profile script.
This option has no effect when a file is explicitly munged with
.BR \-\-mung .
+.IP "\fB-8\fR, \fB--8bit\fR"
+.SCITECO_TOPIC "-8" "--8-bit"
+Use raw single-byte ANSI encoding by default and disable automatic EOL conversion,
+which optimizes \*(ST for 8-bit cleanliness.
+It is equivalent to executing \(lq16,4ED\(rq, but since it is executed
+very early at startup, all Q-Registers and the unnamed buffer will
+already be in ANSI encoding.
+This option is also useful when munging the profile macro.
.IP "\fIUI options .\|.\|.\fP"
Some graphical user interfaces, notably GTK+, provide
additional command line options.
diff --git a/doc/sciteco.7.template b/doc/sciteco.7.template
index f344820..a5b7f4a 100644
--- a/doc/sciteco.7.template
+++ b/doc/sciteco.7.template
@@ -1086,7 +1086,10 @@ Currently, \*(ST supports UTF-8 and single-byte ANSI encodings,
that can also be used for editing raw binary files.
\# You can configure other single-byte code pages with EE,
\# but there isn't yet any way to insert characters.
-UTF-8 is the default codepage for new buffers and Q-Registers.
+UTF-8 is the default codepage for new buffers and Q-Registers
+unless the 2nd \fBED\fP flag bit is set.
+You can also specify \fB--8bit\fP to optimize \*(ST for
+8-bit cleanliness.
While navigation in documents with single-byte encodings
takes place in constant time, \*(ST uses heuristics in
UTF-8 documents for translating between byte and character