aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorUlrich Müller <ulm@gentoo.org>2021-02-15 08:48:30 +0100
committerUlrich Müller <ulm@gentoo.org>2021-02-15 08:48:30 +0100
commitba881fa1e70cf15082b6130080b9c799c8c491cc (patch)
treea1354781db1ff072f56eaa9b7450e28b37ca332b /appendices
parentkeywording: Fix coding style (diff)
downloaddevmanual-ba881fa1e70cf15082b6130080b9c799c8c491cc.tar.gz
devmanual-ba881fa1e70cf15082b6130080b9c799c8c491cc.tar.bz2
devmanual-ba881fa1e70cf15082b6130080b9c799c8c491cc.zip
devbook-guide: Note about dashes moved from contributing to here
Signed-off-by: Ulrich Müller <ulm@gentoo.org>
Diffstat (limited to 'appendices')
-rw-r--r--appendices/contributing/text.xml5
-rw-r--r--appendices/devbook-guide/text.xml7
2 files changed, 7 insertions, 5 deletions
diff --git a/appendices/contributing/text.xml b/appendices/contributing/text.xml
index 1bc3b65..10ab565 100644
--- a/appendices/contributing/text.xml
+++ b/appendices/contributing/text.xml
@@ -135,11 +135,6 @@ amount of depth.
This is not a formal document. The writing style is intended to be
professional but readable.
</li>
- <li>
- When using in-sentence hyphens as punctuation <d/> like this <d/> use a space,
- followed by the <c>&lt;d/&gt;</c> tag. The build system will automatically turn
- this into a proper Unicode long dash.
- </li>
</ul>
</body>
diff --git a/appendices/devbook-guide/text.xml b/appendices/devbook-guide/text.xml
index 70b4dab..d37bbce 100644
--- a/appendices/devbook-guide/text.xml
+++ b/appendices/devbook-guide/text.xml
@@ -647,6 +647,13 @@ Wrong : &lt;uri link = "https://www.gentoo.org/"&gt;
Correct: &lt;uri link="https://www.gentoo.org/"&gt;
</codesample>
+<p>
+<b>Dashes</b> used as in-sentence punctuation <d/> like this <d/> should be
+written as a <c>&lt;d/&gt;</c> tag surrounded by spaces. It would be difficult
+to distinguish a Unicode em-dash from a hyphen when editing the source using a
+fixed-width font.
+</p>
+
</body>
</subsection>
<subsection>