From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Wolfgang Jaehrling Newsgroups: gmane.lisp.guile.devel Subject: Re: Doc organization (Re: Around again, and docs lead role) Date: Thu, 8 May 2003 23:18:02 +0200 Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Message-ID: <20030508211802.GB258@gmx.de> References: <3E92E1B4002B0632@pop3.tiscalinet.es> <3EAFE4EC000D9733@pop1.tiscalinet.es> <87d6its93b.fsf@raven.i.defaultvalue.org> Reply-To: Wolfgang Jaehrling NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1052427705 5439 80.91.224.249 (8 May 2003 21:01:45 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Thu, 8 May 2003 21:01:45 +0000 (UTC) Cc: guile-devel@gnu.org Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Thu May 08 23:01:43 2003 Return-path: Original-Received: from monty-python.gnu.org ([199.232.76.173]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 19DsVP-0001MY-00 for ; Thu, 08 May 2003 23:00:43 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 19DsWb-0004S0-05 for guile-devel@m.gmane.org; Thu, 08 May 2003 17:01:57 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 19DsW9-0004KK-00 for guile-devel@gnu.org; Thu, 08 May 2003 17:01:29 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 19DsV4-0003ns-00 for guile-devel@gnu.org; Thu, 08 May 2003 17:00:26 -0400 Original-Received: from pop.gmx.net ([213.165.65.60] helo=mail.gmx.net) by monty-python.gnu.org with smtp (Exim 4.10.13) id 19DsUp-0003JD-00 for guile-devel@gnu.org; Thu, 08 May 2003 17:00:07 -0400 Original-Received: (qmail 24649 invoked by uid 65534); 8 May 2003 21:00:05 -0000 Original-Received: from dialin-145-254-212-024.arcor-ip.net (EHLO kaputt.schrott) (145.254.212.24) by mail.gmx.net (mp001-rz3) with SMTP; 08 May 2003 23:00:05 +0200 Original-Received: from wj by kaputt.schrott with local (Exim 3.35 #1 (Debian)) id 19DsmB-0000A7-00; Thu, 08 May 2003 23:18:03 +0200 Original-To: Rob Browning Content-Disposition: inline In-Reply-To: <87d6its93b.fsf@raven.i.defaultvalue.org> User-Agent: Mutt/1.3.28i X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1b5 Precedence: list List-Id: Developers list for Guile, the GNU extensibility library List-Help: List-Post: List-Subscribe: , List-Archive: List-Unsubscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.lisp.guile.devel:2296 X-Report-Spam: http://spam.gmane.org/gmane.lisp.guile.devel:2296 On Thu, May 08, 2003 at 11:21:12AM -0500, Rob Browning wrote: > Of course there would be a lot of duplicated text between the sections > since, for example, you'd have to document scm_list_p and list? in > separate sections with essentially the same text. Maintaining redundancy is no fun. But I don't think it is necessary here, just generate both versions from the same input. (Preferably embedding the information in - and extracting it from - the source code.) Cheers, GNU/Wolfgang _______________________________________________ Guile-devel mailing list Guile-devel@gnu.org http://mail.gnu.org/mailman/listinfo/guile-devel