From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.devel Subject: Re: Opaque objects and Emacs documentation Date: Wed, 22 Jul 2020 03:45:02 +0300 Message-ID: References: <20200712184908.13140.5739@vcs0.savannah.gnu.org> <20200712184909.BBC61209B1@vcs0.savannah.gnu.org> <7bf4d6ef-c0ec-43dc-ad5d-f6e81422ad90@yandex.ru> <83zh84m5ws.fsf@gnu.org> <3dd1c224-69b2-40af-5b2e-43a310253632@yandex.ru> <83tuybmtxs.fsf@gnu.org> <859f594b-1343-6d26-e1ac-7157c44eb56c@yandex.ru> <83a6zyk4tt.fsf@gnu.org> <6edffb7d-7708-534f-93ad-bf9180f5e0ed@yandex.ru> <835zamjsvk.fsf@gnu.org> <831rlajock.fsf@gnu.org> <1fcdc463-b3ab-2d32-31d7-904783ae0d81@yandex.ru> <83y2nii6sk.fsf@gnu.org> <750ecd90-0f89-5040-f737-2d8c1b8f01c9@yandex.ru> <83tuy3h87j.fsf@gnu.org> <9fb632ae-bd87-d9e4-bc5c-692894315833@yandex.ru> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="9793"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.10.0 Cc: Eli Zaretskii , Emacs developers , Richard Stallman , npostavs@gmail.com To: John Yates Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Jul 22 02:46:26 2020 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 1jy2tu-0002SX-8G for ged-emacs-devel@m.gmane-mx.org; Wed, 22 Jul 2020 02:46:26 +0200 Original-Received: from localhost ([::1]:41444 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jy2tt-0002Xq-3s for ged-emacs-devel@m.gmane-mx.org; Tue, 21 Jul 2020 20:46:25 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35924) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jy2sf-0001yS-2Y for emacs-devel@gnu.org; Tue, 21 Jul 2020 20:45:09 -0400 Original-Received: from mail-ej1-x636.google.com ([2a00:1450:4864:20::636]:41009) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jy2sd-0008Cg-5c; Tue, 21 Jul 2020 20:45:08 -0400 Original-Received: by mail-ej1-x636.google.com with SMTP id w9so359368ejc.8; Tue, 21 Jul 2020 17:45:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=/tZRslQLKjKvXydBPtxL7r6q9meoEBImQ0oJgGvLI+I=; b=GqIAQ7NT6ggwW7VsZ0HtWFSrq6qcCs59nWhjKpfe7dAPAQTlZvW49PDUDrVSRaEhxm c33imG1RLxy/jBnsQGrqBtzKJvx+j2Y+BRPAhVYOXEnUzi+odknFRyNMCFVIdh71/L3j QFchqwOo1P9IoR/U3eSuiEwrbY3tjogexxGEXMjD4Tkuuo7feHiy0lND9ou2raNm8hAh n1VCnjPEtJJrVR87wRJ+KlsTnefE1ZJoSksF5cAktnQE7hDyM8t9h++YcHXPXIxn+OAA T8E+pdaH1+syTbq4XWdpgXSrenFmgrI5xHNyigLRwYvv0u8JlfKKCKOMKt3pBmO5zRPW 009w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:subject:to:cc:references:from:message-id :date:user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=/tZRslQLKjKvXydBPtxL7r6q9meoEBImQ0oJgGvLI+I=; b=BdBfQIgGZXi1PAj4lujc7z5Tx19wk7kwnO/4LlngjyX8MMTZ218dHFC0O7OECe/bt1 JSY/uYnC86BuDj4osXVUoioXgwBdm7lU4A5mEBwE2Y2e5ZAnr+dD70xieOeUgn712dIy lWzxk2uU46PIXzc/UXh8R/zz8k22v9o9TDs0foD7K0DB2PM/ywatKHfyAlF9QPjyt24g VvAkvF4Dd6fSasJS92ZRYzZZTvWyYciz5+tDbwtRp43mGWisBP0HVZswtZrCrXIFV9Xt 3+Jxdln4oP3/TcdZujJl53tR0IBTh+XkThc95Yf4/Efp0/1uC1YEXTbO7YOR99Lx95dF /XPw== X-Gm-Message-State: AOAM5306oLlD9c1JsKofrpVLI6ZoZGqy2C3mFLJs6LZa5kb2dm5oSU+8 g3eMMV63QxvfPJZbs4chczJmvtAw X-Google-Smtp-Source: ABdhPJyZ1cmQJwQ2IjaioRH+aijJBHnzn1m98ccekGEQtr4RlLcHD84LVpOP+re1/nlAzpIFCe96jQ== X-Received: by 2002:a17:907:4420:: with SMTP id om24mr26912750ejb.10.1595378704730; Tue, 21 Jul 2020 17:45:04 -0700 (PDT) Original-Received: from [192.168.0.3] ([66.205.73.129]) by smtp.googlemail.com with ESMTPSA id e16sm17520734ejt.14.2020.07.21.17.45.03 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 21 Jul 2020 17:45:04 -0700 (PDT) In-Reply-To: Content-Language: en-US Received-SPF: pass client-ip=2a00:1450:4864:20::636; envelope-from=raaahh@gmail.com; helo=mail-ej1-x636.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: 0 X-Spam_score: 0.0 X-Spam_bar: / X-Spam_report: (0.0 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FORGED_FROMDOMAIN=1, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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" Xref: news.gmane.io gmane.emacs.devel:253153 Archived-At: On 21.07.2020 23:29, John Yates wrote: > The project.el dispatcher never interprets an instance handle. > It merely holds onto it and then presents it to a backend as part > of a method invocation.  The handle only needs to capture (in a > backend private fashion) enough context to allow carrying out the > various methods. That is right. There is really very little use in knowing what such an instance handle contains and how, since the caller will just need to pass it forward to one of the project methods.