From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: Emacs setup assistants Date: Sat, 22 May 2004 17:44:19 -0400 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <4nhdub2ef6.fsf@lifelogs.com> <7137-Fri21May2004203220+0300-eliz@gnu.org> Reply-To: rms@gnu.org NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1085338730 20698 80.91.224.253 (23 May 2004 18:58:50 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 23 May 2004 18:58:50 +0000 (UTC) Cc: tzz@lifelogs.com, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sun May 23 20:58:44 2004 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1BRyBH-00042F-00 for ; Sun, 23 May 2004 20:58:43 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BRyBH-0007l9-00 for ; Sun, 23 May 2004 20:58:43 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1BRy81-0007e0-1p for emacs-devel@quimby.gnus.org; Sun, 23 May 2004 14:55:21 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.34) id 1BRqVx-0001EO-EI for emacs-devel@gnu.org; Sun, 23 May 2004 06:47:44 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.34) id 1BRmao-0005Ug-QS for emacs-devel@gnu.org; Sun, 23 May 2004 02:36:51 -0400 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1BRhEb-0003FI-Rp for emacs-devel@gnu.org; Sat, 22 May 2004 20:53:01 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34) id 1BReHz-0007aF-R5; Sat, 22 May 2004 17:44:19 -0400 Original-To: Eli Zaretskii In-reply-to: <7137-Fri21May2004203220+0300-eliz@gnu.org> X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.4 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:23859 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:23859 We could surround the non-Texinfo parts by @ignore ..@end ignore. Or we could use directives inside comments as in "@c something". It is an idea worth considering. It assumes you do NOT run Makeinfo on the Texinfo file but rather use a completely separate parser. I am not sure that is the right way to do it. However, using it this way can't be right: @ignore @c assistant @node Hello, choose a server @variable server :string "default.server.com" @text You can define the server: @variable{server} @end text .... @end ignore @c end assistant It would not make sense to put a @node command into the @ignore. There's no sense using @node unless you want node structure, and @ignore thwarts that. Only specific directives for the assistant structure should be marked as comments. @c would probably be more convenient for that. The other alternative is to run the Texinfo text thru Makeinfo. Then you need to mark the data for the assistant using things that will feed into the output. I think that way is easier.