From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Stefan Newsgroups: gmane.emacs.devel Subject: Re: DOC for Mac OS shown for Emacs compiled for X. Date: Fri, 29 Oct 2004 16:37:58 -0400 Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Message-ID: References: <20041029080140.SPWE44.mxfep02.bredband.com@coolsville.localdomain> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1099085103 2371 80.91.229.6 (29 Oct 2004 21:25:03 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 29 Oct 2004 21:25:03 +0000 (UTC) Cc: Andreas Schwab , emacs devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Oct 29 22:39:04 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1CNdWa-0005Yq-00 for ; Fri, 29 Oct 2004 22:39:04 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CNdeR-0002TD-Iz for ged-emacs-devel@m.gmane.org; Fri, 29 Oct 2004 16:47:11 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CNdeB-0002ML-U7 for emacs-devel@gnu.org; Fri, 29 Oct 2004 16:46:56 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CNde8-0002KI-PK for emacs-devel@gnu.org; Fri, 29 Oct 2004 16:46:53 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CNde6-0002K6-Ur for emacs-devel@gnu.org; Fri, 29 Oct 2004 16:46:52 -0400 Original-Received: from [206.47.199.166] (helo=simmts8-srv.bellnexxia.net) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CNdVf-0003DY-8r for emacs-devel@gnu.org; Fri, 29 Oct 2004 16:38:07 -0400 Original-Received: from empanada.home ([67.71.25.5]) by simmts8-srv.bellnexxia.net (InterMail vM.5.01.06.10 201-253-122-130-110-20040306) with ESMTP id <20041029203759.ICBM1692.simmts8-srv.bellnexxia.net@empanada.home>; Fri, 29 Oct 2004 16:37:59 -0400 Original-Received: by empanada.home (Postfix, from userid 502) id C2DDD3435B5; Fri, 29 Oct 2004 16:37:58 -0400 (EDT) Original-To: "Jan D." In-Reply-To: <20041029080140.SPWE44.mxfep02.bredband.com@coolsville.localdomain> (Jan D.'s message of "Fri, 29 Oct 2004 10:00:53 +0200 (CEST)") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/21.3.50 (darwin) 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: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:29152 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:29152 > Is the approach in the attached patch OK? I generate a list with the > objects used to build Emacs and in Snarf-documentation I compare the files > in DOC with that list. If not in that list, those sections in DOC > are skipped. I think instead that the docstring should be the same no matter what system I'm running on. If the behavior is not quite the same, either the docstring should be general enough to describe the common part, or it should include a discussion of the possible differences on various platforms. This way I can write code on GNU/Linux and be warned if I'm using things that might work differently on some other system. Stefan