From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Changes to windows.texi Date: Sat, 08 Nov 2008 22:16:08 +0200 Message-ID: References: <4914514C.9020700@gmx.at> <4915EF09.3080806@gmx.at> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: ger.gmane.org 1226175388 2263 80.91.229.12 (8 Nov 2008 20:16:28 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 8 Nov 2008 20:16:28 +0000 (UTC) Cc: emacs-devel@gnu.org To: martin rudalics Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Nov 08 21:17:31 2008 connect(): Connection refused Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1KyuFJ-0003pL-05 for ged-emacs-devel@m.gmane.org; Sat, 08 Nov 2008 21:17:25 +0100 Original-Received: from localhost ([127.0.0.1]:42591 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KyuEB-00050q-Hf for ged-emacs-devel@m.gmane.org; Sat, 08 Nov 2008 15:16:15 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1KyuE5-00050X-Sm for emacs-devel@gnu.org; Sat, 08 Nov 2008 15:16:09 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1KyuE4-00050L-Bq for emacs-devel@gnu.org; Sat, 08 Nov 2008 15:16:08 -0500 Original-Received: from [199.232.76.173] (port=46493 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KyuE4-00050I-6D for emacs-devel@gnu.org; Sat, 08 Nov 2008 15:16:08 -0500 Original-Received: from mtaout2.012.net.il ([84.95.2.4]:43553) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1KyuE3-0000Bz-NI for emacs-devel@gnu.org; Sat, 08 Nov 2008 15:16:07 -0500 Original-Received: from conversion-daemon.i_mtaout2.012.net.il by i_mtaout2.012.net.il (HyperSendmail v2004.12) id <0KA10090071KYF00@i_mtaout2.012.net.il> for emacs-devel@gnu.org; Sat, 08 Nov 2008 22:17:53 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([77.126.241.172]) by i_mtaout2.012.net.il (HyperSendmail v2004.12) with ESMTPA id <0KA1003OF71SM9M0@i_mtaout2.012.net.il>; Sat, 08 Nov 2008 22:17:53 +0200 (IST) In-reply-to: <4915EF09.3080806@gmx.at> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by monty-python.gnu.org: Solaris 9.1 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:105474 Archived-At: > Date: Sat, 08 Nov 2008 20:56:57 +0100 > From: martin rudalics > CC: emacs-devel@gnu.org > > Many thanks for looking into this. And many thanks for making the changes in the first place. > Here makeinfo (GNU texinfo - 4.8) does not capitalize the S for @xref, > so I was not aware of any such a problem. Or does it capitalize them > only in the printed manual? It should capitalize them everywhere. Are you sure it doesn't for you? Not even at the beginning of a sentence? > > Another potential issue is as in this example, which is a full > > sentence: > > > > @var{window} defaults to the selected window. > > > > This makes "window", starting with a lower-case w, begin a sentence, > > which might look like a typo in the printed manual. (In the Info > > manual, @var upcases its argument, so the problem is not visible.) > > the original text was > > > > If @var{window} is omitted, this function returns the buffer for the > > selected window. > > > > and thus didn't have this problem. I didn't fix these sentences. > > The problem is that I would have to write > > If @var{window} is omitted or @code{nil}, this function returns the > buffer for the selected window. > > to be correct, which means the sentence gets twice as long. And there > are many instances of that. Writing > > If @var{window} is omitted or @code{nil}, the selected window is > used. > > doesn't strike me as elegant either. Anyway, I'll try to fix these > somehow. I suggest The default for @var{window} is the selected window. > > I also don't understand why you removed paragraph indentation as in > > this example: > > > > - Here is how you can determine whether a given position @var{position} > > -is off the screen due to horizontal scrolling: > > +Here is how you can determine whether a given position @var{position} is > > +off the screen due to horizontal scrolling: > > > > I didn't fix these, either. > > This must have happened when I refilled them. I shall look into this. > > Are such indentations necessary for formatting or are they a stylistic > convention? I think it's a convention to have the first paragraph of a section not to be indented, and indent all the others, although the manual is not always consistent in this. Richard, could you please answer this question? > That is, makeinfo produces them anyway What makeinfo does is controlled by @firstparagraphindent and @paragraphindent.