From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Thomas S. Dye" Subject: Re: [RFC] Dog food, anyone? Date: Mon, 18 Dec 2017 14:12:27 -1000 Message-ID: References: <87efntod73.fsf@nicolasgoaziou.fr> <87efnrlml3.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:39364) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eR5a6-0007oH-N7 for emacs-orgmode@gnu.org; Mon, 18 Dec 2017 19:16:27 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eR5a2-0005z5-Mf for emacs-orgmode@gnu.org; Mon, 18 Dec 2017 19:16:26 -0500 Received: from gproxy4-pub.mail.unifiedlayer.com ([69.89.23.142]:58187) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eR5a2-0005u4-Gk for emacs-orgmode@gnu.org; Mon, 18 Dec 2017 19:16:22 -0500 Received: from cmgw2 (unknown [10.0.90.83]) by gproxy4.mail.unifiedlayer.com (Postfix) with ESMTP id 31831176225 for ; Mon, 18 Dec 2017 17:12:45 -0700 (MST) In-reply-to: <87efnrlml3.fsf@nicolasgoaziou.fr> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: Nicolas Goaziou Cc: Org Mode List Aloha Nicolas, Nicolas Goaziou writes: >> One change that might be made globally is the use of em-dash (---) to >> set off text, versus en-dash (--) between numerals, e.g. "the range of >> run times is 1--5 seconds". I've spotted several places where the >> en-dash is used to set off text. See this web site for the convention >> on dashes: >> >> https://www.gnu.org/software/texinfo/manual/texinfo/html_node/Conventions.html > > I think it is a matter of "American English" vs "British English" > convention. See, e.g., . > > I consistently used the latter because I find it more aesthetically > pleasing. As a GNU manual, we can switch to the American English > convention everywhere. In this case, however, em-dash are not > spaced-out. I find the en-dash with spaces more aesthetically pleasing, too. > > In the same vein, we also need to use title case. This needs some > special care as fuzzy links need to be updated accordingly. > > WDYT? Agreed. This is one of the first things we might do if manual.org becomes the official source of the Org manual. FYI, Phil Rooke's Documentation_Standards.org suggests title case for chapter heads and sentence case for section and subsection headings. > I changed it to > > ... by tweaking the header arguments (see [[* Using header > arguments]]) for compiling... > > For more information, see (info "(texinfo) @ref"), last paragraphs. > N.B.: I suggest to read it in regular info viewer, i.e., "info texinfo" > from the command line, instead of Emacs to make sense out of this. Yes, much better. All the best, Tom -- Thomas S. Dye http://www.tsdye.com