From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Thien-Thi Nguyen Newsgroups: gmane.emacs.devel Subject: Re: Possible change to startup.el Date: Thu, 31 Mar 2005 13:37:08 +0200 Message-ID: Reply-To: ttn@glug.org NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1112271005 4946 80.91.229.2 (31 Mar 2005 12:10:05 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 31 Mar 2005 12:10:05 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Mar 31 14:10:02 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1DGyUm-00034K-3q for ged-emacs-devel@m.gmane.org; Thu, 31 Mar 2005 14:09:56 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DGylS-0004XY-JG for ged-emacs-devel@m.gmane.org; Thu, 31 Mar 2005 07:27:10 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1DGyG6-0007eI-NC for emacs-devel@gnu.org; Thu, 31 Mar 2005 06:54:47 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1DGyG2-0007bs-Mt for emacs-devel@gnu.org; Thu, 31 Mar 2005 06:54:44 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DGyFy-0007Tg-Sb for emacs-devel@gnu.org; Thu, 31 Mar 2005 06:54:39 -0500 Original-Received: from [151.38.237.38] (helo=surf.glug.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1DGxtW-0005hC-Gk for emacs-devel@gnu.org; Thu, 31 Mar 2005 06:31:27 -0500 Original-Received: from ttn by surf.glug.org with local (Exim 3.35 #1 (Debian)) id 1DGxz2-0003wE-00; Thu, 31 Mar 2005 13:37:08 +0200 Original-To: Miles Bader In-reply-to: message from Miles Bader on Thu, 31 Mar 2005 10:40:05 +0900 Original-References: 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:35415 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:35415 From: Miles Bader Date: Thu, 31 Mar 2005 10:40:05 +0900 So what exactly is that patch supposed to do? here is a suitable ChangeLog entry: * startup.el (fancy-splash-text): For tutorial line, consult language environment and display accordingly, in format: TITLE, tab, EN-PREFIX*, LIST-OF-AVAILABLE-TUTORIALS. (fancy-splash-insert): If arg is a thunk, call it for a string. the asterisk after EN-PREFIX means that it may be omitted if there is no need for it. (arguably there is no need for it in any case.) I'm not sure it's a good idea to take the description `first sentence in the tutorial' literally; a sentence may not be the best unit to use, as something that sounds natural when inserted into the splash page may look odd as a standalone first sentence in the tutorial. in this context, i interpret sentence as "text followed by period". something like "Emacs Tutorial." (with period), in which case TITLE is taken to be "Emacs Tutorial" (without the period). thus, this is not a "normal" sentence w/ verbs and other words. the current standalone first sentence is normal but will need to be changed (w/ the help of translators) from: BLAH BLAH BLAH. ETC ETC to the stylized: TITLE. BLAH BLAH BLAH. ETC ETC. translators are encouraged to reduce awkwardness (w/ the advent of TITLE) in the BLAH part, perhaps by reworking or eliminating it entirely. It seem better to do as I suggested earlier, and structure it more as a `title' in the actual tutorial file (that is, simply the words "Emacs Tutorial" or equivalent, on a line by themselves, possibly centered on the first line, followed by a blank line). this is the same as rms' design, except that TITLE is delimited by first newline instead of first period. initially, i thought newline delim was better since it could be added simply (w/o changing current text) and, just as simply, be removed upon presentation. however, i suppose that violates the "one source for data" principle, so i can see value in using period delim and reworking the BLAH part. thi