commit: ba881fa1e70cf15082b6130080b9c799c8c491cc Author: Ulrich Müller <ulm <AT> gentoo <DOT> org> AuthorDate: Mon Feb 15 07:48:30 2021 +0000 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> CommitDate: Mon Feb 15 07:48:30 2021 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=ba881fa1
devbook-guide: Note about dashes moved from contributing to here Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org> appendices/contributing/text.xml | 5 ----- appendices/devbook-guide/text.xml | 7 +++++++ 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><d/></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 : <uri link = "https://www.gentoo.org/"> Correct: <uri link="https://www.gentoo.org/"> </codesample> +<p> +<b>Dashes</b> used as in-sentence punctuation <d/> like this <d/> should be +written as a <c><d/></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>