summaryrefslogtreecommitdiffstatshomepage
path: root/README.addescape
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2009-03-03 21:07:01 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2009-03-03 21:07:01 +0000
commit86e8f7e0bfb4f77c6c3037eba104791ae7b1d71e (patch)
tree53579f5c2bd36c73d43e0b8a31750167d3352955 /README.addescape
parent1e85c3949ce76b81aa8b89f634e30797ddc81cc8 (diff)
downloadmandoc-86e8f7e0bfb4f77c6c3037eba104791ae7b1d71e.tar.gz
mandoc-86e8f7e0bfb4f77c6c3037eba104791ae7b1d71e.tar.zst
mandoc-86e8f7e0bfb4f77c6c3037eba104791ae7b1d71e.zip
Character-escape addition simplified (see README.addescape, also added).
Diffstat (limited to 'README.addescape')
-rw-r--r--README.addescape17
1 files changed, 17 insertions, 0 deletions
diff --git a/README.addescape b/README.addescape
new file mode 100644
index 00000000..da52ee09
--- /dev/null
+++ b/README.addescape
@@ -0,0 +1,17 @@
+$Id: README.addescape,v 1.1 2009/03/03 21:07:01 kristaps Exp $
+
+This documents adding a new character escape to mdocterm(1). Character
+escapes are only syntax-validated in the back-end.
+
+Character escape may be in the form of \*x, \*(xx, \x, \(xx, \[n] and so
+on and so on. All of these are recognised according to their byte
+length.
+
+(1) If the escape is NOT recognised in enum tsym in term.h, add it.
+
+(2) Modify/create static struct termenc termencN, where N is the number
+of characters in the encoding. This is in mdocterm.c.
+
+(3) Possibly modify nescape() to recognise a new termencN.
+
+Everything else is automatic.