From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: "Miguel V. S. Frasson" Newsgroups: gmane.emacs.bugs Subject: bug#34708: alist-get has unclear documentation Date: Sat, 2 Mar 2019 12:40:57 -0300 Message-ID: References: <87wolhr5k6.fsf@web.de> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="00000000000054c54e05831e5a84" Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="122173"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 34708@debbugs.gnu.org To: Michael Heerdegen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Mar 02 16:53:23 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.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1h06x0-000VfF-L9 for geb-bug-gnu-emacs@m.gmane.org; Sat, 02 Mar 2019 16:53:22 +0100 Original-Received: from localhost ([127.0.0.1]:55915 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h06wz-0005CX-Mo for geb-bug-gnu-emacs@m.gmane.org; Sat, 02 Mar 2019 10:53:21 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:43006) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h06vm-0004RK-JS for bug-gnu-emacs@gnu.org; Sat, 02 Mar 2019 10:52:07 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1h06m2-0007lW-Rr for bug-gnu-emacs@gnu.org; Sat, 02 Mar 2019 10:42:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:44288) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1h06m2-0007lO-HR for bug-gnu-emacs@gnu.org; Sat, 02 Mar 2019 10:42:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1h06m2-0004iB-83 for bug-gnu-emacs@gnu.org; Sat, 02 Mar 2019 10:42:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Miguel V. S. Frasson" Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 02 Mar 2019 15:42:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34708 X-GNU-PR-Package: emacs Original-Received: via spool by 34708-submit@debbugs.gnu.org id=B34708.155154128018052 (code B ref 34708); Sat, 02 Mar 2019 15:42:02 +0000 Original-Received: (at 34708) by debbugs.gnu.org; 2 Mar 2019 15:41:20 +0000 Original-Received: from localhost ([127.0.0.1]:57832 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h06lL-0004h6-PN for submit@debbugs.gnu.org; Sat, 02 Mar 2019 10:41:20 -0500 Original-Received: from mail-it1-f176.google.com ([209.85.166.176]:35704) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h06lK-0004gs-CJ for 34708@debbugs.gnu.org; Sat, 02 Mar 2019 10:41:19 -0500 Original-Received: by mail-it1-f176.google.com with SMTP id 188so1436546itb.0 for <34708@debbugs.gnu.org>; Sat, 02 Mar 2019 07:41:18 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=7R5YoNz3mebPcbPEmVw4v6sr3hIOoNo8UPgzdvuIMig=; b=RqdjM7IkbTyJDREP88WsVtdLIJ6mK/OT9Z4nM0/WCkH/tfDqzATorDsjhAYC91pXhp zQSiLJYBMQP3YxJtj5cqfNkK0jMzPO0hQ+SnKMTcZpGaqS8joCMhV07J42ZH+9m5bVTe gWSxDxmCPpn9t0chNuu0oMIxC+BPNlV5sZX5YSr9TCuAtSJLt+Pq099zyf+/USreeAQn kJM2UAINeqT4TYMm+c2GqAO5vhyPizWCTbfYvaOH0CPgrx3dVZJH5Af7q4WnRY4Xntrd z0q+SNx4mRpbYAkB4jtYQiYrdutN3+FJuGmw4v5pnzqkol4zT7XpCIiztVoCFBPHs1ia f1wA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=7R5YoNz3mebPcbPEmVw4v6sr3hIOoNo8UPgzdvuIMig=; b=ihQUamupVulyKIL5rk389UYxL+UiyuQLVfv/OVNChb3iYl9Q3Jt9nHEqcw5X5m9/bP coftiOtP3fee3J6YkguACmJCFy9vnUtXZXL1ZrGXd9oJmgJ3ZyMFsa2eHxGbc7G3kqAc A9Qs+kRaqPA1PRt0Kvxfba1HJNSAbL23+mOyUrogI8TT4JrLss7CQRnGWU6wfT6TjTcO 1pycSkJIxG7JGB9gyghcibfM/GMaEzCvLXzNvRlhoXD3NLEoPWK+AM8tH30VAP5j7dCM T4YEr1evD5ouiYaQfeJ0zUpTVBoTckIdz47qq7dknxtWYObf+FX6QEwS9YX7HbIhNHDY DIYw== X-Gm-Message-State: AHQUAuaGONHFoI9caZVCfrXETXPbo5xGolYEfqWx86cF3Fy5prkvjWD0 vDlj+ZdwmNS1eo1D/fvMAQdWRxV+ghCnXV0f9PI= X-Google-Smtp-Source: AHgI3IZEoHdAtLfE7OBXrE8cgzeHA904BSLbY4Boc/tSnUadgWVSuNmkDbrHFjDte4Ts1XSrs7DHL+e1QYkF/Qa3ovM= X-Received: by 2002:a24:ac58:: with SMTP id m24mr6059209iti.129.1551541271313; Sat, 02 Mar 2019 07:41:11 -0800 (PST) In-Reply-To: <87wolhr5k6.fsf@web.de> 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:155967 Archived-At: --00000000000054c54e05831e5a84 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hi Michael Em s=C3=A1b, 2 de mar de 2019 06:25, Michael Heerdegen escreveu: > "Miguel V. S. Frasson" writes: > > > * Last paragraph starts with `This'. What is `this'? ALIST? TESTFN? > > alist-get itself? > > Only one of those makes sense to me. Do you know what a generalized > variable is? > I think so, ALIST, but 'this' should be the last thing that was referred to or talked about. The point is that the documentation must be clear, and it is not in this case. I know about generalized variables but really never used myself. > * How do I use `this' or `it' to set a value? Function is alist-*get* > > but somehow I can set values. A simple example on doc-string and/or > > info node would explain everything. > > That could make sense, since it's an important use case and generalized > variables are probably not something everyone is used to. > I can't imagine how to *set* anything with alist-get. It seams to me that it just use the value of ALIST for look up, so talk about generalized variables is meaningless to me here. > * Action of REMOVE is described, but it doesn't correspond to code. > > REMOVE is ignored. > > That's ok: the generalized variable is implemented in gv.el. > > > Michael. > Miguel > --00000000000054c54e05831e5a84 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hi Michael=C2=A0

<= div dir=3D"ltr" class=3D"gmail_attr">Em s=C3=A1b, 2 de mar de 2019 06:25, M= ichael Heerdegen <michael_he= erdegen@web.de> escreveu:
&q= uot;Miguel V. S. Frasson" <mvsfrasson@gmail.com> writes:
> * Last paragraph starts with `This'. What is `this'? ALIST? TE= STFN?
> alist-get itself?

Only one of those makes sense to me.=C2=A0 Do you know what a generalized variable is?

I think so, ALIST, but 'this'= should be the last thing that was referred to or talked about. The point i= s that the documentation must be clear, and it is not in this case.=C2=A0

I know about generalized = variables but really never used myself.

> * How do I use `this' or `it' to set a value? Function is alis= t-*get*
> but somehow I can set values. A simple example on doc-string and/or > info node would explain everything.

That could make sense, since it's an important use case and generalized=
variables are probably not something everyone is used to.
<= /div>

I can't imagin= e how to *set* anything with alist-get. It seams to me that it just use the= value of ALIST for look up, so talk about generalized variables is meaning= less to me here.

> * Action of REMOVE = is described, but it doesn't correspond to code.
> REMOVE is ignored.

That's ok: the generalized variable is implemented in gv.el.


Michael.

Miguel=C2=A0
--00000000000054c54e05831e5a84--