From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.help Subject: Re: What does "tag space" mean? Date: Fri, 01 Mar 2013 16:19:06 +0200 Message-ID: <83wqtrurs5.fsf@gnu.org> References: <20130301203952.bd28e3ed22f0d37bff19518f@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: QUOTED-PRINTABLE X-Trace: ger.gmane.org 1362147568 20070 80.91.229.3 (1 Mar 2013 14:19:28 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 1 Mar 2013 14:19:28 +0000 (UTC) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Fri Mar 01 15:19:52 2013 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UBQoK-0003fJ-PA for geh-help-gnu-emacs@m.gmane.org; Fri, 01 Mar 2013 15:19:44 +0100 Original-Received: from localhost ([::1]:51897 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UBQnz-00015I-L3 for geh-help-gnu-emacs@m.gmane.org; Fri, 01 Mar 2013 09:19:23 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:50277) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UBQnj-00013q-S2 for help-gnu-emacs@gnu.org; Fri, 01 Mar 2013 09:19:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UBQni-0003mO-6q for help-gnu-emacs@gnu.org; Fri, 01 Mar 2013 09:19:07 -0500 Original-Received: from mtaout22.012.net.il ([80.179.55.172]:53427) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UBQnh-0003m4-VE for help-gnu-emacs@gnu.org; Fri, 01 Mar 2013 09:19:06 -0500 Original-Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0MIZ00L00J37GP00@a-mtaout22.012.net.il> for help-gnu-emacs@gnu.org; Fri, 01 Mar 2013 16:19:02 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MIZ00LH8JRPIS10@a-mtaout22.012.net.il> for help-gnu-emacs@gnu.org; Fri, 01 Mar 2013 16:19:02 +0200 (IST) In-reply-to: X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 X-Received-From: 80.179.55.172 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:89310 Archived-At: > Date: Fri, 1 Mar 2013 14:21:45 +0100 > From: Aur=C3=A9lien Aptel > Cc: help-gnu-emacs@gnu.org >=20 > I've started to write a small guide to the C code on emacswiki [1]. > Any contribution welcome :) Comments: . Unless you intend to cover non-Posix platforms, I suggest to remov= e from the "Build configuration" everything that is not applicable t= o Posix systems, like config.bat. . I suggest to show the relevant pieces of C code when you describe something like Lisp_Object or XVECTORP. I think it will make the document much more self-contained, as anyone who reads it will nee= d to consult the C code anyway. . Don't point to specific source line numbers, they change very frequently as part of development. "Around line NNNN" is much better, and sometimes it is better to omit that entirely. . The part about 256MB limitation of buffers on 32-bit systems is incorrect: the max size is 512MB. Your bit calculations are in error. See VAL_MAX. . I question the usefulness of listing all of the Xfoo macros. It should be enough to explain that Xfoo(x) returns a C object corresponding to a Lisp object of type foo. Same goes for the foo= P macros. The document doesn't yet go too far to become interesting, so the above are just small nits. Thanks.