[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 2/2] Italicise etc and add tests for etc and i.e.
From: |
John Darrington |
Subject: |
[PATCH 2/2] Italicise etc and add tests for etc and i.e. |
Date: |
Sat, 23 May 2020 12:46:48 +0200 |
---
cfg.mk | 14 ++++++++++++++
doc/poke.texi | 8 ++++----
2 files changed, 18 insertions(+), 4 deletions(-)
diff --git a/cfg.mk b/cfg.mk
index 0e6731e8..a37ba248 100644
--- a/cfg.mk
+++ b/cfg.mk
@@ -25,3 +25,17 @@ sc_rockdabootism_missing_space:
exclude="([a-z]+\(3\)\.|poke\(wo\)men)" \
halt='missing space before (' \
$(_sc_search_regexp)
+
+sc_unitalicised_ie:
+ @prohibit='i\.e\.' \
+ in_vc_files='$(texinfo_suffix_re_)' \
+ exclude='@i{i\.e\.}' \
+ halt='found unitalicised "i.e" in Texinfo source' \
+ $(_sc_search_regexp)
+
+sc_unitalicised_etc:
+ @prohibit='\betc\b' \
+ in_vc_files='$(texinfo_suffix_re_)' \
+ exclude='@i{etc}' \
+ halt='found unitalicised "etc" in Texinfo source' \
+ $(_sc_search_regexp)
diff --git a/doc/poke.texi b/doc/poke.texi
index 967c4530..b5895410 100644
--- a/doc/poke.texi
+++ b/doc/poke.texi
@@ -3812,7 +3812,7 @@ deftype SBM_Header = byte[5];
However, this would not capture the properties of the fields
themselves, which would need to be remember by the user: which of
these five bytes correspond to the magic number? Is the pixels per
-line number signed or unsigned? etc.
+line number signed or unsigned? @i{etc}.
Poke provides a much better way to abstract collections of
heterogeneous data: @dfn{struct types}. Using a struct type we can
@@ -3990,8 +3990,8 @@ a frob per standard color, you would do it like:
@end example
The pickle also provides a function @code{color_name} that, given a
-color code, returns a printable name for the color, i.e. a string
-describing it. For user-defined colors, this string is fixed:
+color code, returns a printable name for the color, @i{i.e.} a string
+describing it. For user defined colors, this string is fixed:
@example
(poke) color_name (23)
@@ -4196,7 +4196,7 @@ writer.
Very often the structure of the data encoded in binary is not very
intelligible. This is because it is usual for binary formats to be
designed with other goals in mind other than being readable by humans:
-compactness, detailness, etc.
+compactness, detailness, @i{etc}.
In our pickle we of course want to provide access to the very finer
detail of the data structures. However, we also want for the user to
--
2.20.1