From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: ludo@gnu.org (Ludovic =?iso-8859-1?Q?Court=E8s?=) Newsgroups: gmane.lisp.guile.devel Subject: Re: two spaces after sentence + other doc janitorial duties Date: Fri, 02 Jul 2010 15:23:26 +0200 Message-ID: <87aaqauiep.fsf@gnu.org> References: <87tyorqddl.fsf@ambire.localdomain> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: dough.gmane.org 1278077114 17440 80.91.229.12 (2 Jul 2010 13:25:14 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 2 Jul 2010 13:25:14 +0000 (UTC) To: guile-devel@gnu.org Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Fri Jul 02 15:25:13 2010 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1OUgEy-0007FT-ME for guile-devel@m.gmane.org; Fri, 02 Jul 2010 15:25:12 +0200 Original-Received: from localhost ([127.0.0.1]:57534 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OUgEx-0004f2-Uf for guile-devel@m.gmane.org; Fri, 02 Jul 2010 09:25:11 -0400 Original-Received: from [140.186.70.92] (port=32793 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OUgEs-0004ex-SB for guile-devel@gnu.org; Fri, 02 Jul 2010 09:25:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OUgEr-0005dw-Kb for guile-devel@gnu.org; Fri, 02 Jul 2010 09:25:06 -0400 Original-Received: from lo.gmane.org ([80.91.229.12]:41451) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OUgEr-0005do-8J for guile-devel@gnu.org; Fri, 02 Jul 2010 09:25:05 -0400 Original-Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1OUgEq-0007Bb-5S for guile-devel@gnu.org; Fri, 02 Jul 2010 15:25:04 +0200 Original-Received: from acces.bordeaux.inria.fr ([193.50.110.5]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 02 Jul 2010 15:25:04 +0200 Original-Received: from ludo by acces.bordeaux.inria.fr with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 02 Jul 2010 15:25:04 +0200 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 58 Original-X-Complaints-To: usenet@dough.gmane.org X-Gmane-NNTP-Posting-Host: acces.bordeaux.inria.fr X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 14 Messidor an 218 de la =?iso-8859-1?Q?R=E9volution?= X-PGP-Key-ID: 0xEA52ECF4 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 83C4 F8E5 10A3 3B4C 5BEA D15D 77DD 95E2 EA52 ECF4 X-OS: x86_64-unknown-linux-gnu User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.2 (gnu/linux) Cancel-Lock: sha1:Sh4GK9J9QVE0VvOaOalJk2S3d8I= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:10602 Archived-At: Hi, Andy Wingo writes: > Heya, > > On Fri 25 Jun 2010 18:35, Thien-Thi Nguyen writes: > >> Normally, texinfo source should have two spaces after each sentence: >> >> Blah the first. Blah more. ;; only one space, not cool >> Blah the first. Blah more. ;; two spaces, ok > > Why is this the case? TeX itself gets this right, why can't makeinfo? I’m not sure whether/how TeX gets it right. Two spaces after a sentence is visually the closest thing to English typography rules, which thereby distinguish end-of-sentence periods from abbreviation periods, as mentioned in the Texinfo manual (info "(texinfo) Ending a Sentence"). The GCS also recommends it (info "(standards) Comments"), and Emacs’ M-e expects it too. >> commit 3323ec063ccc87b210e6da04c57c625af270b230 >> Author: Neil Jerram >> Date: Sun Dec 27 23:24:09 2009 +0000 >> >> Automatic manual updates following libguile docstring changes >> >> and since then there have been many other manual updates. So, should i >> interpret the six months since that update to mean that we are no longer >> using a docstring.el-based system? Am i missing something? > > I don't really understand docstring.el. How should I use it? I have > simply been copying changes over manually. Same for me. So I’m curious. :-) >> Other changes i have in mind: >> >> - convert "..." to "@dots{}"; >> - convert "i.e. FOO" to "i.e., FOO" >> (and likewise "i. e. FOO" and "e.g. FOO"); > > Great. +1 (Likewise, “e.g.” -> “e.g.,”.) >> - choose "Returns" or "Return" and use it everywhere; > > Sure. “Return”, I think. Thanks, Ludo’.