From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Some experience with the igc branch Date: Wed, 25 Dec 2024 17:28:29 +0200 Message-ID: <861pxv234y.fsf@gnu.org> References: <87o713wwsi.fsf@telefonica.net> <87a5cnfj8t.fsf@protonmail.com> <86seqe4j4f.fsf@gnu.org> <87ttaucub8.fsf@protonmail.com> <87pllicrpi.fsf@protonmail.com> <864j2u442i.fsf@gnu.org> <87ldw6as5f.fsf@protonmail.com> <86o7112rnq.fsf@gnu.org> <867c7p2nz4.fsf@gnu.org> <861pxx2lh7.fsf@gnu.org> <86ldw40xbo.fsf@gnu.org> <868qs329kj.fsf@gnu.org> <864j2r25hg.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="14089"; mail-complaints-to="usenet@ciao.gmane.io" Cc: pipcet@protonmail.com, ofv@wanadoo.es, emacs-devel@gnu.org, eller.helmut@gmail.com, acorallo@gnu.org To: Gerd =?utf-8?Q?M=C3=B6llmann?= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Dec 25 16:29:25 2024 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1tQTK8-0003WQ-In for ged-emacs-devel@m.gmane-mx.org; Wed, 25 Dec 2024 16:29:24 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tQTJP-0001C1-66; Wed, 25 Dec 2024 10:28:39 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tQTJM-000193-FJ for emacs-devel@gnu.org; Wed, 25 Dec 2024 10:28:36 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tQTJL-0007iw-Ib; Wed, 25 Dec 2024 10:28:35 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=JzfqhnX9b8Jd6//EgDVepwHzQsjafRiJIVL9kbERRmM=; b=hLeX6EijgW3PABjuu2+S A6Cfn2C6VVrl6uqwzeEd0BrdQLj9DAxvbqwxxF2FgzNJ1bQcXLzb9GewOhfAizItdeD+yy59INjnK DnA69srEeTHjBsupeGc1vW2mgWr/vq+eQ8C9MREk8sUgP6D2VBpVDCx5EbZyMFvahd4eqdHReqV8x v9LJ5kw33WnX4NT8sxfWehn4hG60co/qPWEvTcr+nTloWGW3Ocd7FRCPaoqQdJt0P07CcgfpuRjmv cUMPZ/uI7NBzjcqDdR1nBJEPjLzWm76NgB/vKBNaKLtQ3hq955kyWvdSz4seW+Z7K5xYDDFsF6rCk btONNNma9Evpsw==; In-Reply-To: (message from Gerd =?utf-8?Q?M?= =?utf-8?Q?=C3=B6llmann?= on Wed, 25 Dec 2024 15:57:32 +0100) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:327106 Archived-At: > From: Gerd Möllmann > Cc: pipcet@protonmail.com, ofv@wanadoo.es, emacs-devel@gnu.org, > eller.helmut@gmail.com, acorallo@gnu.org > Date: Wed, 25 Dec 2024 15:57:32 +0100 > > Eli Zaretskii writes: > > > I guess I'm yearning for some commentary in igc.c, not unlike what you > > wrote in xdisp.c at the time, which would explain the basics, like > > what are roots, what's the purpose of all those root_create_SOMETHING > > functions, what's the difference between exact and ambiguous roots, > > etc. Because currently we are not too spoiled by comments in igc.c. > > Would a reference to the MPS Guide > > https://memory-pool-system.readthedocs.io/en/latest/guide/index.html# > > help? Not really. Their documentation is (a) too vague/abstract/circular (i.e., stuff is not explained for itself, but instead they cross-reference to some other stuff -- e.g., try to understand what is a "root"), and (b) not specific to Emacs, so the relation between MPS terminology and Emacs objects is missing.