From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: [corrector(s) needed] doc/lispref/internals.texi tweaks Date: Wed, 14 Nov 2012 19:10:54 +0200 Message-ID: <83zk2kt8ip.fsf@gnu.org> References: <50A0DB8F.1090008@yandex.ru> <83obj1vclt.fsf@gnu.org> <50A3C741.1060707@yandex.ru> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1352913123 2630 80.91.229.3 (14 Nov 2012 17:12:03 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 14 Nov 2012 17:12:03 +0000 (UTC) Cc: emacs-devel@gnu.org To: Dmitry Antipov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Nov 14 18:12:13 2012 Return-path: Envelope-to: ged-emacs-devel@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 1TYgVW-0000Nn-Au for ged-emacs-devel@m.gmane.org; Wed, 14 Nov 2012 18:12:10 +0100 Original-Received: from localhost ([::1]:32891 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TYgVM-0002JD-DB for ged-emacs-devel@m.gmane.org; Wed, 14 Nov 2012 12:12:00 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:39508) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TYgVH-0002IN-Lt for emacs-devel@gnu.org; Wed, 14 Nov 2012 12:11:58 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TYgVE-0005D6-Jb for emacs-devel@gnu.org; Wed, 14 Nov 2012 12:11:55 -0500 Original-Received: from mtaout20.012.net.il ([80.179.55.166]:35436) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TYgVE-0005Ci-BO for emacs-devel@gnu.org; Wed, 14 Nov 2012 12:11:52 -0500 Original-Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0MDH00900LFVNR00@a-mtaout20.012.net.il> for emacs-devel@gnu.org; Wed, 14 Nov 2012 19:10:36 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MDH009JRMDLIF70@a-mtaout20.012.net.il>; Wed, 14 Nov 2012 19:10:33 +0200 (IST) In-reply-to: <50A3C741.1060707@yandex.ru> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 X-Received-From: 80.179.55.166 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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 Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:154860 Archived-At: > Date: Wed, 14 Nov 2012 20:30:57 +0400 > From: Dmitry Antipov > CC: Emacs development discussions > > >> Date: Mon, 12 Nov 2012 15:20:47 +0400 > >> From: Dmitry Antipov > >> > >> There are some bits for doc/lispref/internals.texi, which looks a bit > >> outdated and incomplete... > > > > Thanks, some comments below. > > Great thanks! Do you have the patience for one more round? Yep. > +@code{garbage-collect} returns a list with information on amount of space > +in use, where each entry has the form @samp{(name size used)} or > +@samp{(name size used free)}. In the entry, @samp{name} is a symbol Here, "name", "size", "used", etc. stand for something else, so they should be in @var, both inside @samp and in the text that describes them. > +@item cons-size > +Internal size of a cons cell, e.g. @code{sizeof (struct Lisp_Cons)}. If you have a period that doesn't end a sentence and is followed by a space, put a @: between the period and the space, so that the typesetter will know this isn't the end of a sentence, and typesets the space correctly. IOW, "e.g.@:". And I think you mean "i.e.", not "e.g." here (and elsewhere in this table). > +when the threshold is exhausted, but only the next time the Lisp evaluator > +is called. "Lisp interpreter", I think. > +bits is the value itself. Integer values are immediate, e.g. directly ^^^^ "i.e.@:" > +it's equal to the width of an underlying platform pointer (e.g. 32-bit on ^^^^ "i.e.@:" Thanks.