From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: "Basil L. Contovounesios" Newsgroups: gmane.emacs.bugs Subject: bug#37639: (elisp manual) About description of markers in strunct buffer_text. Date: Mon, 07 Oct 2019 03:36:02 +0100 Message-ID: <87eezpnuy5.fsf@tcd.ie> References: Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="260219"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: 37639@debbugs.gnu.org To: Takesi Ayanokoji Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Oct 07 04:37:12 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iHItc-0015ZF-I0 for geb-bug-gnu-emacs@m.gmane.org; Mon, 07 Oct 2019 04:37:12 +0200 Original-Received: from localhost ([::1]:40212 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iHItb-0006JE-EH for geb-bug-gnu-emacs@m.gmane.org; Sun, 06 Oct 2019 22:37:11 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44870) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iHItT-0006IU-Vx for bug-gnu-emacs@gnu.org; Sun, 06 Oct 2019 22:37:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iHItS-0007St-Td for bug-gnu-emacs@gnu.org; Sun, 06 Oct 2019 22:37:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:38253) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iHItS-0007Sn-Hz for bug-gnu-emacs@gnu.org; Sun, 06 Oct 2019 22:37:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iHItS-0005vl-Dn for bug-gnu-emacs@gnu.org; Sun, 06 Oct 2019 22:37:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Basil L. Contovounesios" Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 07 Oct 2019 02:37:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 37639 X-GNU-PR-Package: emacs Original-Received: via spool by 37639-submit@debbugs.gnu.org id=B37639.157041577922747 (code B ref 37639); Mon, 07 Oct 2019 02:37:02 +0000 Original-Received: (at 37639) by debbugs.gnu.org; 7 Oct 2019 02:36:19 +0000 Original-Received: from localhost ([127.0.0.1]:47074 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHIsk-0005uo-K9 for submit@debbugs.gnu.org; Sun, 06 Oct 2019 22:36:18 -0400 Original-Received: from mail-wr1-f65.google.com ([209.85.221.65]:44132) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHIsh-0005uN-C2 for 37639@debbugs.gnu.org; Sun, 06 Oct 2019 22:36:16 -0400 Original-Received: by mail-wr1-f65.google.com with SMTP id z9so13220152wrl.11 for <37639@debbugs.gnu.org>; Sun, 06 Oct 2019 19:36:15 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tcd-ie.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=xQwE1tM6iId1SAVzHMrKmS+C2CO44Y+AKZ8qZGS6owk=; b=BCJCG9eWFJbXmeP5LBD4EOde3NOd6COZkG727t33xt7RnDLRIRi2klLY8wNH86UgpY a3CKsfjGmVNiZT6DyilpsKzp1CL8UxONK13QpQic+TyE9IfRAGi9nklIXHd8M+gQgWEe ozKzoB8pLZ/8QIDBZVLvHeEe6Xfr4K3ANmJnBpKLN9yyzduWzYSQjkyyUIq7zC91KntI G/5DW1y4CgnyhKHuagWAGfp9I6GaVoNZlBYZkZCJJR+1OtfRvZ7Rrqa/dPl+kpUSF2dn uu3cRPoArlPTwZT0TqfsvopFhWqawA020fWy8zSjcWobYVCSOV5uTc7nIXlOoRzXTnJp dz9w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-transfer-encoding; bh=xQwE1tM6iId1SAVzHMrKmS+C2CO44Y+AKZ8qZGS6owk=; b=ILxK6wifnI/cVR/kcb6lqpH7uIdrtcZrVv0eDG2bPOAQRVuwjRXZwd/L5QHufxsWqr Sw8H7awffc6pmtrB4L0CUwPQq3tn08g3QUqxPDBHXpd6JAojGXNlVz1hJkPGzBK0XS0z 5Jz2zX62J+ImUyw4JiCxwRF0XwQtmGBGWNMCrLT0OkaGO+Mp+P91cOQgoXgLaJCi00hg T2vFb5MKnWZsmhCT1QdYYaIMu5SY8Ral0l/787u9UIm4BRinK5XIo7RGCrcStigxapFq 9R2LOwwk/02cdEd5COwXmC7a4kt8wEDXa9iBPa+PHMzE6AkfoNI9daU5fNeLGiwAzDya 330w== X-Gm-Message-State: APjAAAV5E4n8BMPTbg5CKU8WEjY4erD7jG2PJUNAt0GhT5jzNX+piGc1 u8Cgq/iH25y82CQp9AVtRnYKrw== X-Google-Smtp-Source: APXvYqxIIOA70xvNmXdXHK4Swd0pDJWlPeh6tEetQZYyTy8djYHEl3rY2P+2MX4T4SS5L7tfe9hoTQ== X-Received: by 2002:adf:ebce:: with SMTP id v14mr186683wrn.368.1570415769439; Sun, 06 Oct 2019 19:36:09 -0700 (PDT) Original-Received: from localhost ([2a02:8084:20e2:c380:92bd:1bfd:38fc:fae2]) by smtp.gmail.com with ESMTPSA id x16sm11520973wrl.32.2019.10.06.19.36.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 06 Oct 2019 19:36:08 -0700 (PDT) In-Reply-To: (Takesi Ayanokoji's message of "Mon, 7 Oct 2019 02:22:56 +0900") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:168476 Archived-At: severity 37639 minor quit Takesi Ayanokoji writes: > At @item markers > , in @subsection Buffer Internals > , in @section Object Internals > , in internals.texi > , in lispref manual, the manual says, > > This is actually a single marker, and successive elements in its marker > @code{chain} are the other markers referring to this buffer text. > > http://git.savannah.gnu.org/cgit/emacs.git/tree/doc/lispref/internals.tex= i#n2023 > > But I think @code{chain} should be markup-ed with @dfn, @emph, or quoted = with ` and '. Indeed, @code doesn't seem right here. I would go with either ``quotes'' or no markup at all, like the 'next' entry further down that page: =E2=80=98next=E2=80=99 A pointer to the next buffer, in the chain of all buffers, including killed buffers. This chain is used only for allocation and garbage collection, in order to collect killed buffers properly. > (Or "chain" is some kind of symbol defined in source files? I can't find = it.) No, it's just a metaphor. Thanks, --=20 Basil