From unknown Sun Aug 17 10:17:20 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34842: 26.1; Alist documentation: let-alist Resent-From: =?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?= Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 13 Mar 2019 14:42:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 34842 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 34842@debbugs.gnu.org X-Debbugs-Original-To: "bug-gnu-emacs@gnu.org" Received: via spool by submit@debbugs.gnu.org id=B.15524880877628 (code B ref -1); Wed, 13 Mar 2019 14:42:02 +0000 Received: (at submit) by debbugs.gnu.org; 13 Mar 2019 14:41:27 +0000 Received: from localhost ([127.0.0.1]:42206 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h454P-0001yw-N6 for submit@debbugs.gnu.org; Wed, 13 Mar 2019 10:41:27 -0400 Received: from eggs.gnu.org ([209.51.188.92]:40994) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h44gZ-0001NT-U6 for submit@debbugs.gnu.org; Wed, 13 Mar 2019 10:16:49 -0400 Received: from lists.gnu.org ([209.51.188.17]:42028) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1h44gO-0000Fx-8A for submit@debbugs.gnu.org; Wed, 13 Mar 2019 10:16:40 -0400 Received: from eggs.gnu.org ([209.51.188.92]:55359) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h44gL-0001SD-AM for bug-gnu-emacs@gnu.org; Wed, 13 Mar 2019 10:16:36 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: **** X-Spam-Status: No, score=4.3 required=5.0 tests=BAYES_50,FREEMAIL_FROM, FROM_EXCESS_BASE64, HTML_MESSAGE, RCVD_IN_DNSWL_NONE, RECEIVED_FROM_WINDOWS_HOST, URIBL_BLOCKED autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1h44gC-0000Br-1P for bug-gnu-emacs@gnu.org; Wed, 13 Mar 2019 10:16:31 -0400 Received: from mail-oln040092013056.outbound.protection.outlook.com ([40.92.13.56]:6417 helo=NAM05-CO1-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1h44g9-00009M-KT for bug-gnu-emacs@gnu.org; Wed, 13 Mar 2019 10:16:22 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=outlook.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=369ICCuCaLF7EbrqHl8QacQ1OVPUNsfWWVnzspuGZPw=; b=Sj7bBgFeKrzF3BMOg93TDVJuiQoyCJZBXOPjyeaDvue0T10MHDxTaNahZcRh1WPfMjvOKDrPuEmtj+UOf83Icq5cgWPSQ2e2WSXFxTtaItMdFGa7Ulqr4a1WdmYiIiJOso9Xh5UJPJruEeAJA8tY5/H8u0YcjMv4pcOwb60bOqRrX2wK3Y07pm9ASslp+LFCZOLFjh40f+DZH6U8LrVFwOk1oCjaudKy9AkGFkXL7CofXzhfIQDWdD4IUTfB06u5Tnwh8v8Ck/8HEfdt3TTtDBIJCqirQkeW+DuM9J3FjBFe8GYASxtQqJQdRVsy1c7Q479l8IULKUEqj7lGiTGzrA== Received: from DM3NAM05FT032.eop-nam05.prod.protection.outlook.com (10.152.98.60) by DM3NAM05HT056.eop-nam05.prod.protection.outlook.com (10.152.98.244) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.1709.11; Wed, 13 Mar 2019 14:16:15 +0000 Received: from BN8PR04MB5555.namprd04.prod.outlook.com (10.152.98.58) by DM3NAM05FT032.mail.protection.outlook.com (10.152.98.144) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.1730.2 via Frontend Transport; Wed, 13 Mar 2019 14:16:15 +0000 Received: from BN8PR04MB5555.namprd04.prod.outlook.com ([fe80::890f:1d5c:65a6:f0d3]) by BN8PR04MB5555.namprd04.prod.outlook.com ([fe80::890f:1d5c:65a6:f0d3%3]) with mapi id 15.20.1686.021; Wed, 13 Mar 2019 14:16:15 +0000 From: =?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?= Thread-Topic: 26.1; Alist documentation: let-alist Thread-Index: AQHU2WfoQNkpN7Cxwka7S9tpV8PRbA== Date: Wed, 13 Mar 2019 14:16:15 +0000 Message-ID: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-incomingtopheadermarker: OriginalChecksum:E61F3BDEDD8581421E53C43E25585814C758943EF5186586B30AD2CD49934D52; UpperCasedChecksum:FEF2C73D229F7A84DFBDC61E2E1CEE07D9A018A497703C8D642CFB41654C867B; SizeAsReceived:6655; Count:42 x-ms-exchange-messagesentrepresentingtype: 1 x-tmn: [QlGo+oyQImzvLx06so5U+O01+mDKDZX3] x-ms-publictraffictype: Email x-incomingheadercount: 42 x-eopattributedmessage: 0 x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(20181119110)(201702061078)(5061506573)(5061507331)(1603103135)(2017031320274)(2017031324274)(2017031323274)(2017031322404)(1601125500)(1603101475)(1701031045); SRVR:DM3NAM05HT056; x-ms-traffictypediagnostic: DM3NAM05HT056: x-microsoft-antispam-message-info: lJ606YRlrjfJHWZOF65o+viYV+KUDVBXgK8xscJmPujKYx0xXHecFRm1CkuqmQxM Content-Type: multipart/alternative; boundary="_000_BN8PR04MB555503D4DD1283F20EAC7C578B4A0BN8PR04MB5555namp_" MIME-Version: 1.0 X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-CrossTenant-Network-Message-Id: 0799feee-51d0-4b83-aaa5-08d6a7be7457 X-MS-Exchange-CrossTenant-rms-persistedconsumerorg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-CrossTenant-originalarrivaltime: 13 Mar 2019 14:16:15.6640 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Internet X-MS-Exchange-CrossTenant-id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM3NAM05HT056 X-detected-operating-system: by eggs.gnu.org: Windows 7 or 8 [fuzzy] X-Received-From: 40.92.13.56 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Spam-Score: 1.1 (+) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: The macro let-alist is too useful to work with JSON-parsed data for it to be missing from the docs. In the page https://www.gnu.org/software/emacs/manual/html_node/elisp/Association-Lists.html we should add some documentation about it. Below a suggestion. Content analysis details: (1.1 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 0.0 URIBL_BLOCKED ADMINISTRATOR NOTICE: The query to URIBL was blocked. See http://wiki.apache.org/spamassassin/DnsBlocklists#dnsbl-block for more information. [URIs: outlook.com] 1.0 SPF_SOFTFAIL SPF: sender does not match SPF record (softfail) 0.0 FREEMAIL_FROM Sender email is commonly abused enduser mail provider (seb.hoagie[at]outlook.com) 0.0 HTML_MESSAGE BODY: HTML included in message 0.1 FROM_EXCESS_BASE64 From: base64 encoded unnecessarily X-Mailman-Approved-At: Wed, 13 Mar 2019 10:41:24 -0400 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.1 (/) --_000_BN8PR04MB555503D4DD1283F20EAC7C578B4A0BN8PR04MB5555namp_ Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 VGhlIG1hY3JvIGxldC1hbGlzdCBpcyB0b28gdXNlZnVsIHRvIHdvcmsgd2l0aCBKU09OLXBhcnNl ZCBkYXRhIGZvciBpdCB0byBiZSBtaXNzaW5nIGZyb20gdGhlIGRvY3MuDQoNCkluIHRoZSBwYWdl IGh0dHBzOi8vd3d3LmdudS5vcmcvc29mdHdhcmUvZW1hY3MvbWFudWFsL2h0bWxfbm9kZS9lbGlz cC9Bc3NvY2lhdGlvbi1MaXN0cy5odG1sIHdlIHNob3VsZCBhZGQgc29tZSBkb2N1bWVudGF0aW9u IGFib3V0IGl0LiBCZWxvdyBhIHN1Z2dlc3Rpb24uDQoNClRoYW5rIHlvdSENCg0K4oCUIE1hY3Jv OiBsZXQtYWxpc3QgYHZhbHVlYA0KQ3JlYXRlcyBhIGJpbmRpbmcgZm9yIGVhY2ggc3ltYm9sIGlu IHRoZSBhc3NvY2lhdGlvbiBsaXN0IGB2YWx1ZWAsIHByZWZpeGVkIHdpdGggZG90LiBUaGlzIGlz IHZlcnkgdXNlZnVsIHdoZW4gYWNjZXNzaW5nIHNldmVyYWwgaXRlbXMgaW4gdGhlIHNhbWUgYWxp c3QsIGFuZCBpdCdzIGJlc3QgdW5kZXJzdG9vZCB0aHJvdWdoIGEgc2ltcGxlIGV4YW1wbGU6DQoN CihzZXRxIGNvbG9ycyAnKChyb3NlIHJlZCkgKGxpbHkgd2hpdGUpIChidXR0ZXJjdXAgeWVsbG93 KSkpDQoobGV0LWFsaXN0IGNvbG9ycw0KICAgIChwcmludCAucm9zZSkNCiAgICAocHJpbnQgLmJ1 dHRlcmN1cCkpDQogICAg4oeSIHJlZA0KICAgIOKHkiB5ZWxsb3cNCg0KDQoNCkluIEdOVSBFbWFj cyAyNi4xIChidWlsZCAxLCB4ODZfNjQtdzY0LW1pbmd3MzIpDQogb2YgMjAxOC0wNS0zMCBidWls dCBvbiBDSVJST0NVTVVMVVMNClJlcG9zaXRvcnkgcmV2aXNpb246IDA3ZjhmOWJjNWE1MWY1YWE5 NGViMDk5ZjNlMTVmYmUwYzIwZWExZWENCldpbmRvd2luZyBzeXN0ZW0gZGlzdHJpYnV0b3IgJ01p Y3Jvc29mdCBDb3JwLicsIHZlcnNpb24gMTAuMC4xNzEzNA0KUmVjZW50IG1lc3NhZ2VzOg0KV2hl biBkb25lIHdpdGggYSBidWZmZXIsIHR5cGUgQy1jIEMtYw0KVHlwZSBDLWMgQy1jIHRvIGZpbmlz aCwgb3IgQy1jIEMtayB0byBjYW5jZWwNCkF1dG8tc2F2aW5nLi4uZG9uZQ0KU2F2aW5nIGZpbGUg YzovSG9tZS9naXRodWIvcGVwaXRhLy5naXQvQ09NTUlUX0VESVRNU0cuLi4NCldyb3RlIGM6L0hv bWUvZ2l0aHViL3BlcGl0YS8uZ2l0L0NPTU1JVF9FRElUTVNHDQpHaXQuRXhlIGZpbmlzaGVkDQpN YXJrIHNldA0KUnVubmluZyBDOi9Qcm9ncmFtIEZpbGVzL0dpdC9taW5ndzY0L2xpYmV4ZWMvZ2l0 LWNvcmUvZ2l0LmV4ZSBwdXNoIC12IG9yaWdpbiBtYXN0ZXI6cmVmcy9oZWFkcy9tYXN0ZXINCkdp dC5FeGUgZmluaXNoZWQNCmRlbGV0ZS1iYWNrd2FyZC1jaGFyOiBUZXh0IGlzIHJlYWQtb25seSBb NCB0aW1lc10NCg0KQ29uZmlndXJlZCB1c2luZzoNCiAnY29uZmlndXJlIC0td2l0aG91dC1kYnVz IC0taG9zdD14ODZfNjQtdzY0LW1pbmd3MzINCiAtLXdpdGhvdXQtY29tcHJlc3MtaW5zdGFsbCAn Q0ZMQUdTPS1PMiAtc3RhdGljIC1nMycnDQoNCkNvbmZpZ3VyZWQgZmVhdHVyZXM6DQpYUE0gSlBF RyBUSUZGIEdJRiBQTkcgUlNWRyBTT1VORCBOT1RJRlkgQUNMIEdOVVRMUyBMSUJYTUwyIFpMSUIN ClRPT0xLSVRfU0NST0xMX0JBUlMgVEhSRUFEUyBMQ01TMg0KDQpJbXBvcnRhbnQgc2V0dGluZ3M6 DQogIHZhbHVlIG9mICRMQU5HOiBFTlUNCiAgbG9jYWxlLWNvZGluZy1zeXN0ZW06IHV0Zi04DQoN Ck1ham9yIG1vZGU6IE1hZ2l0DQoNCk1pbm9yIG1vZGVzIGluIGVmZmVjdDoNCiAgc2VtYW50aWMt bWlub3ItbW9kZXMtZm9ybWF0OiAoKDpldmFsIChpZiAob3Igc2VtYW50aWMtaGlnaGxpZ2h0LWVk aXRzLW1vZGUgc2VtYW50aWMtc2hvdy11bm1hdGNoZWQtc3ludGF4LW1vZGUpICBTKSkpDQogIGVs ZWN0cmljLXBhaXItbW9kZTogdA0KICBkZWxldGUtc2VsZWN0aW9uLW1vZGU6IHQNCiAgZ2xvYmFs LWhsLWxpbmUtbW9kZTogdA0KICB3aGljaC1rZXktbW9kZTogdA0KICBueWFuLW1vZGU6IHQNCiAg bWFnaXQtZ2l0Zmxvdy1tb2RlOiB0DQogIGdsb2JhbC1tYWdpdC1maWxlLW1vZGU6IHQNCiAgZGlm Zi1hdXRvLXJlZmluZS1tb2RlOiB0DQogIG1hZ2l0LWF1dG8tcmV2ZXJ0LW1vZGU6IHQNCiAgZ2xv YmFsLWdpdC1jb21taXQtbW9kZTogdA0KICBpY29tcGxldGUtbW9kZTogdA0KICBpZG8tdmVydGlj YWwtbW9kZTogdA0KICBkb29tLW1vZGVsaW5lLW1vZGU6IHQNCiAgZWxkb2MtaW4tbWluaWJ1ZmZl ci1tb2RlOiB0DQogIGFzeW5jLWJ5dGVjb21wLXBhY2thZ2UtbW9kZTogdA0KICByZWNlbnRmLW1v ZGU6IHQNCiAgZ2xvYmFsLWNvbXBhbnktbW9kZTogdA0KICBjb21wYW55LW1vZGU6IHQNCiAgZ2xv YmFsLWFuenUtbW9kZTogdA0KICBhbnp1LW1vZGU6IHQNCiAgc2hlbGwtZGlydHJhY2stbW9kZTog dA0KICBzeW1vbi1tb2RlOiB0DQogIG1pbmlvbnMtbW9kZTogdA0KICBpZG8tdWJpcXVpdG91cy1t b2RlOiB0DQogIGlkby1ldmVyeXdoZXJlOiB0DQogIGdsb2JhbC12aXNpYmxlLW1hcmstbW9kZTog dA0KICB2aXNpYmxlLW1hcmstbW9kZTogdA0KICBnbG9iYWwtZmx5Y2hlY2stbW9kZTogdA0KICBw cm9qZWN0aWxlLW1vZGU6IHQNCiAgdG9vbHRpcC1tb2RlOiB0DQogIGdsb2JhbC1lbGRvYy1tb2Rl OiB0DQogIGVsZWN0cmljLWluZGVudC1tb2RlOiB0DQogIG1vdXNlLXdoZWVsLW1vZGU6IHQNCiAg ZmlsZS1uYW1lLXNoYWRvdy1tb2RlOiB0DQogIGdsb2JhbC1mb250LWxvY2stbW9kZTogdA0KICBm b250LWxvY2stbW9kZTogdA0KICBhdXRvLWNvbXBvc2l0aW9uLW1vZGU6IHQNCiAgYXV0by1lbmNy eXB0aW9uLW1vZGU6IHQNCiAgYXV0by1jb21wcmVzc2lvbi1tb2RlOiB0DQogIGJ1ZmZlci1yZWFk LW9ubHk6IHQNCiAgc2l6ZS1pbmRpY2F0aW9uLW1vZGU6IHQNCiAgY29sdW1uLW51bWJlci1tb2Rl OiB0DQogIGxpbmUtbnVtYmVyLW1vZGU6IHQNCiAgdHJhbnNpZW50LW1hcmstbW9kZTogdA0KDQpM b2FkLXBhdGggc2hhZG93czoNCmM6L2hvbWUvZ2l0aHViL3BlcGl0YS90ZW1wIGhpZGVzIGM6L2hv bWUvZ2l0aHViL3BhbmRhL3RlbXANCn4vLmVtYWNzLmQvbGlzcC9kaXJlZC1naXQtaW5mbyBoaWRl cyBjOi9Ib21lLy5lbWFjcy5kL2VscGEvZGlyZWQtZ2l0LWluZm8tMC4yL2RpcmVkLWdpdC1pbmZv DQoNCkZlYXR1cmVzOg0KKHNoYWRvdyBzb3J0IG1haWwtZXh0ciBlbWFjc2J1ZyBzZW5kbWFpbCBw ZXBpdGEgbG9hZGhpc3QgbWFya2Rvd24tbW9kZQ0KY29sb3IgcGNtcGwtdW5peCBlbS14dHJhIGVt LXJlYmluZCBlbS1zbWFydCBlbS10cmFtcCB0ZXhuZm8tdXBkIHRleGluZm8NCm1hbiBlbS11bml4 IGVtLXRlcm0gdGVybSBlaGVscCBlbS1zY3JpcHQgZW0tcHJvbXB0IGVtLWxzIGVtLWhpc3QgZW0t cHJlZA0KZW0tZ2xvYiBlbS1kaXJzIGVtLWNtcGwgZW0tYmFzaWMgZW0tYmFubmVyIGVtLWFsaWFz IGVzaC12YXIgZXNoLWlvDQplc2gtY21kIGVzaC1vcHQgZXNoLWV4dCBlc2gtcHJvYyBlc2gtYXJn IGVzaC1ncm91cHMgZXNoZWxsIGVzaC1tb2R1bGUNCmVzaC1tb2RlIGVzaC11dGlsIHByb2ZpbGVy IHB1bHNlIGVpZWlvLW9wdCBoZWxwLWZucyB3YXJuaW5ncw0Kc3Vid29yZC1tb2RlLWV4cGFuc2lv bnMgY2FwLXdvcmRzIHN1cGVyd29yZCBzdWJ3b3JkIHJ1YnktbW9kZS1leHBhbnNpb25zDQpydWJ5 LW1vZGUgc21pZSBlcnQgZXdvYyBhdXRvbG9hZCByYWRpeC10cmVlIGxpc3AtbW50IHRhci1tb2Rl DQptYWdpdC1wYXRjaCBtYWdpdC1zdWJ0cmVlIG1hZ2l0LWVkaWZmIHRpbWV6b25lDQpweXRob24t ZWwtZmdhbGxpbmEtZXhwYW5zaW9ucyBweXRob24gdHJhbXAtc2ggY2wtcHJpbnQgZGVidWcgY29u Zi1tb2RlDQpkaXJlZC14IGRhYmJyZXYgdmMtYnpyIHZjLXNyYyB2Yy1zY2NzIHZjLXN2biB2Yy1j dnMgdmMtcmNzIHZjDQp2Yy1kaXNwYXRjaGVyIGRlYWRncmVwIHNwaW5uZXIgcm5nLXhzZCB4c2Qt cmVnZXhwIHJuZy1jbXBjdA0KbnhtbC1tb2RlLWV4cGFuc2lvbnMgcm5nLW54bWwgcm5nLXZhbGlk IHJuZy1sb2Mgcm5nLXVyaSBybmctcGFyc2UNCm54bWwtcGFyc2Ugcm5nLW1hdGNoIHJuZy1kdCBy bmctdXRpbCBybmctcHR0cm4gbnhtbC1ucyBueG1sLW1vZGUNCm54bWwtb3V0bG4gbnhtbC1yYXAg bnhtbC11dGlsIG54bWwtZW5jIHhtbHRvayBidWctcmVmZXJlbmNlIG1hZ2l0LWV4dHJhcw0Kc3Bl ZWRiYXIgc2ItaW1hZ2UgZXppbWFnZSBkZnJhbWUgb3JnLXJtYWlsIG9yZy1taGUgb3JnLWlyYyBv cmctaW5mbw0Kb3JnLWdudXMgbm5pciBnbnVzLXN1bSBnbnVzLWdyb3VwIGdudXMtdW5kbyBnbnVz LXN0YXJ0IGdudXMtY2xvdWQgbm5pbWFwDQpubm1haWwgbWFpbC1zb3VyY2UgdXRmNyBuZXRyYyBu bm9vIGdudXMtc3BlYyBnbnVzLWludCBnbnVzLXJhbmdlDQpnbnVzLXdpbiBvcmctZG9jdmlldyBk b2MtdmlldyBqa2EtY29tcHIgaW1hZ2UtbW9kZSBvcmctYmlidGV4IGJpYnRleA0Kb3JnLWJiZGIg b3JnLXczbSBvcmctZWxlbWVudCBhdmwtdHJlZSBnZW5lcmF0b3IgdGhlLW9yZy1tb2RlLWV4cGFu c2lvbnMNCm9yZyBvcmctbWFjcm8gb3JnLWZvb3Rub3RlIG9yZy1wY29tcGxldGUgb3JnLWxpc3Qg b3JnLWZhY2VzIG9yZy1lbnRpdGllcw0Kb3JnLXZlcnNpb24gb2ItZW1hY3MtbGlzcCBvYiBvYi10 YW5nbGUgb3JnLXNyYyBvYi1yZWYgb2ItbG9iIG9iLXRhYmxlDQpvYi1rZXlzIG9iLWV4cCBvYi1j b21pbnQgb2ItY29yZSBvYi1ldmFsIG9yZy1jb21wYXQgb3JnLW1hY3MNCm9yZy1sb2FkZGVmcyBt aXNlYXJjaCBtdWx0aS1pc2VhcmNoIHR3by1jb2x1bW4gaXNvLXRyYW5zbCBmYWNlLXJlbWFwDQp2 Yy1naXQgY29tcGFueS1vZGRtdXNlIGNvbXBhbnkta2V5d29yZHMgY29tcGFueS1ldGFncyBjb21w YW55LWd0YWdzDQpjb21wYW55LWRhYmJyZXYtY29kZSBjb21wYW55LWRhYmJyZXYgY29tcGFueS1m aWxlcyBjb21wYW55LWNhcGYNCmNvbXBhbnktY21ha2UgY29tcGFueS14Y29kZSBjb21wYW55LWNs YW5nIGNvbXBhbnktc2VtYW50aWMgY29tcGFueS1lY2xpbQ0KY29tcGFueS10ZW1wbGF0ZSBjb21w YW55LWJiZGIgbGludW0gd2hpdGVzcGFjZSBjc3YgZGVwbG95LXN0YXR1cyBwYW5kYQ0KbGV0LWFs aXN0IGVsZWMtcGFpciBkZWxzZWwgaGwtbGluZSB3cy1idXRsZXIgd2hpY2gta2V5DQp3ZWItbW9k ZS1leHBhbnNpb25zIHdlYi1tb2RlIHNxbCB2aWV3IHNseSBzbHktY29tcGxldGlvbiBzbHktYnV0 dG9ucw0Kc2x5LW1lc3NhZ2VzIHNseS1jb21tb24gYXByb3BvcyBhcmMtbW9kZSBhcmNoaXZlLW1v ZGUgbm91dGxpbmUgb3V0bGluZQ0KaHlwZXJzcGVjIHBvd2Vyc2hlbGwgb21uaXNoYXJwIG9tbmlz aGFycC11bml0LXRlc3QtYWN0aW9ucw0Kb21uaXNoYXJwLWNvZGUtc3RydWN0dXJlIG9tbmlzaGFy cC1zZXJ2ZXItaW5zdGFsbGF0aW9uDQpvbW5pc2hhcnAtZm9ybWF0LWFjdGlvbnMgb21uaXNoYXJw LXNvbHV0aW9uLWFjdGlvbnMNCm9tbmlzaGFycC1oZWxtLWludGVncmF0aW9uIG9tbmlzaGFycC1u YXZpZ2F0aW9uLWFjdGlvbnMNCm9tbmlzaGFycC1jdXJyZW50LXN5bWJvbC1hY3Rpb25zIG9tbmlz aGFycC1hdXRvLWNvbXBsZXRlLWFjdGlvbnMNCm9tbmlzaGFycC1zZXJ2ZXItYWN0aW9ucyBvbW5p c2hhcnAtaHR0cC11dGlscyBvbW5pc2hhcnAtdXRpbHMNCm9tbmlzaGFycC1zZXJ2ZXItbWFuYWdl bWVudCBvbW5pc2hhcnAtc2V0dGluZ3MgZXRhZ3MgeHJlZiBwb3B1cA0KY3NoYXJwLW1vZGUgbnlh bi1tb2RlIG1hZ2l0LWdpdGZsb3cgbWFnaXQtYm9va21hcmsgbWFnaXQtc3VibW9kdWxlDQptYWdp dC1vYnNvbGV0ZSBtYWdpdC1ibGFtZSBtYWdpdC1zdGFzaCBtYWdpdC1iaXNlY3QgbWFnaXQtcHVz aA0KbWFnaXQtcHVsbCBtYWdpdC1mZXRjaCBtYWdpdC1jbG9uZSBtYWdpdC1yZW1vdGUgbWFnaXQt Y29tbWl0DQptYWdpdC1zZXF1ZW5jZSBtYWdpdC1ub3RlcyBtYWdpdC13b3JrdHJlZSBtYWdpdC10 YWcgbWFnaXQtbWVyZ2UNCm1hZ2l0LWJyYW5jaCBtYWdpdC1yZXNldCBtYWdpdC1maWxlcyBtYWdp dC1yZWZzIG1hZ2l0LXN0YXR1cyBtYWdpdA0KbWFnaXQtcmVwb3MgbWFnaXQtYXBwbHkgbWFnaXQt d2lwIG1hZ2l0LWxvZyB3aGljaC1mdW5jIG1hZ2l0LWRpZmYNCnNtZXJnZS1tb2RlIGRpZmYtbW9k ZSBtYWdpdC1jb3JlIG1hZ2l0LWF1dG9yZXZlcnQgYXV0b3JldmVydCBmaWxlbm90aWZ5DQptYWdp dC1tYXJnaW4gbWFnaXQtdHJhbnNpZW50IG1hZ2l0LXByb2Nlc3MgbWFnaXQtbW9kZSB0cmFuc2ll bnQNCmdpdC1jb21taXQgbWFnaXQtZ2l0IG1hZ2l0LXNlY3Rpb24gbWFnaXQtdXRpbHMgY3JtIGxv Zy1lZGl0IHBjdnMtdXRpbA0KYWRkLWxvZyB3aXRoLWVkaXRvciBzZXJ2ZXIganNvbi1tb2RlIGpz b24tcmVmb3JtYXQganNvbi1zbmF0Y2hlcg0KanMtbW9kZS1leHBhbnNpb25zIGpzIGh0bWwtbW9k ZS1leHBhbnNpb25zIHNnbWwtbW9kZSBjYy1tb2RlLWV4cGFuc2lvbnMNCmNjLW1vZGUgY2MtZm9u dHMgY2MtZ3Vlc3MgY2MtbWVudXMgY2MtY21kcyBjYy1zdHlsZXMgY2MtYWxpZ24gY2MtZW5naW5l DQpjYy12YXJzIGNjLWRlZnMgaW1lbnUgaWNvbXBsZXRlIGlkby12ZXJ0aWNhbC1tb2RlIGlidWZm ZXItcHJvamVjdGlsZQ0KZm9ybWF0LWFsbCBkb3RuZXQgZG9vbS1tb2RlbGluZSBkb29tLW1vZGVs aW5lLXNlZ21lbnRzIGRvb20tbW9kZWxpbmUtZW52DQphbGwtdGhlLWljb25zIGFsbC10aGUtaWNv bnMtZmFjZXMgZGF0YS1tYXRlcmlhbCBkYXRhLXdlYXRoZXJpY29ucw0KZGF0YS1vY3RpY29ucyBk YXRhLWZpbGVpY29ucyBkYXRhLWZhaWNvbnMgZGF0YS1hbGx0aGVpY29ucw0KZG9vbS1tb2RlbGlu ZS1jb3JlIHByb2plY3Qgc2hyaW5rLXBhdGggZiBlbGRvYy1ldmFsIGRvY2tlciBkb2NrZXItdm9s dW1lDQpkb2NrZXItbmV0d29yayBkb2NrZXItbWFjaGluZSBkb2NrZXItaW1hZ2UgZG9ja2VyLWNv bnRhaW5lcg0KZG9ja2VyLXByb2Nlc3MgZG9ja2VyLXV0aWxzIHRhYmxpc3QgdGFibGlzdC1maWx0 ZXIgc2VtYW50aWMvd2lzZW50L2NvbXANCnNlbWFudGljL3dpc2VudCBzZW1hbnRpYy93aXNlbnQv d2lzZW50IHNlbWFudGljL3V0aWwtbW9kZXMgc2VtYW50aWMvdXRpbA0Kc2VtYW50aWMgc2VtYW50 aWMvdGFnIHNlbWFudGljL2xleCBzZW1hbnRpYy9mdyBtb2RlLWxvY2FsIGNlZGV0DQpkb2NrZXIt Z3JvdXAgbWFnaXQtcG9wdXAgYXN5bmMtYnl0ZWNvbXAgYXN5bmMgZGFzaGJvYXJkDQpkYXNoYm9h cmQtd2lkZ2V0cyByZWNlbnRmIHRyZWUtd2lkZ2V0IHBhZ2UtYnJlYWstbGluZXMgY2FsLW1lbnUg Y2FsZW5kYXINCmNhbC1sb2FkZGVmcyBib29rbWFyayBwcCBld3ctbG51bSBld3cgbW0tdXJsIGdu dXMgbm5oZWFkZXIgdXJsLXF1ZXVlIHNocg0Kc3ZnIHhtbCBkb20gYnJvd3NlLXVybCBleHBhbmQt cmVnaW9uIHRleHQtbW9kZS1leHBhbnNpb25zDQplci1iYXNpYy1leHBhbnNpb25zIGV4cGFuZC1y ZWdpb24tY29yZSBleHBhbmQtcmVnaW9uLWN1c3RvbSBlZGlmZi1tZXJnDQplZGlmZi13aW5kIGVk aWZmLWRpZmYgZWRpZmYtbXVsdCBlZGlmZi1oZWxwIGVkaWZmLWluaXQgZWRpZmYtdXRpbCBlZGlm Zg0KY29tcGFueSBlZG1hY3JvIGttYWNybyBwY2FzZSBicm93c2Uta2lsbC1yaW5nIGNsIGFuenUg ZG9ja2VyLXRyYW1wDQp0cmFtcC1jYWNoZSB0cmFtcCB0cmFtcC1jb21wYXQgdHJhbXAtbG9hZGRl ZnMgdHJhbXB2ZXIgdWNzLW5vcm1hbGl6ZQ0Kc2hlbGwgcGNvbXBsZXRlIHBhcnNlLXRpbWUgYWR2 aWNlIGRvb20tY2hhbGxlbmdlci1kZWVwLXRoZW1lIHN5bW9uDQpiYXR0ZXJ5IG1pbmlvbnMgaWRv LWNvbXBsZXRpbmctcmVhZCsgbWVtb2l6ZSBzIGN1cy1lZGl0IHdpZC1lZGl0DQptaW5pYnVmLWVs ZGVmIGlkbyB2aXNpYmxlLW1hcmsgZWFzeS1tbW9kZSBmbHljaGVjayBjbC1leHRyYSBqc29uIG1h cA0KZmluZC1mdW5jIGhlbHAtbW9kZSBzdWJyLXggZGFzaCBjdXMtc3RhcnQgY3VzLWxvYWQgcHJv amVjdGlsZSBncmVwDQpjb21waWxlIGNvbWludCBhbnNpLWNvbG9yIHJpbmcgaWJ1Zi1leHQgaWJ1 ZmZlciBpYnVmZmVyLWxvYWRkZWZzDQp0aGluZ2F0cHQgZG9vbS10aGVtZXMgZG9vbS10aGVtZXMt Y29tbW9uIG1tLWFyY2hpdmUgbWVzc2FnZSBkaXJlZA0KZGlyZWQtbG9hZGRlZnMgZm9ybWF0LXNw ZWMgcmZjODIyIG1tbCBtbWwtc2VjIGVwYSBkZXJpdmVkIGVwZyBnbnVzLXV0aWwNCnJtYWlsIHJt YWlsLWxvYWRkZWZzIG1haWxhYmJyZXYgZ21tLXV0aWxzIG1haWxoZWFkZXIgbW0tZGVjb2RlIG1t LWJvZGllcw0KbW0tZW5jb2RlIG1haWwtdXRpbHMgbmV0d29yay1zdHJlYW0gc3RhcnR0bHMgdXJs LWh0dHAgdGxzIGdudXRscw0KbWFpbC1wYXJzZSByZmMyMjMxIHJmYzIwNDcgcmZjMjA0NSBtbS11 dGlsIGlldGYtZHJ1bXMgbWFpbC1wcnN2ciB1cmwtZ3cNCm5zbSBybWMgcHVueSB1cmwtY2FjaGUg dXJsLWF1dGggdXJsIHVybC1wcm94eSB1cmwtcHJpdmFjeSB1cmwtZXhwYW5kDQp1cmwtbWV0aG9k cyB1cmwtaGlzdG9yeSB1cmwtY29va2llIHVybC1kb21zdWYgdXJsLXV0aWwgbWFpbGNhcA0KZmlu ZGVyLWluZiBnaC1jb21tb24gbWFyc2hhbCBlaWVpby1jb21wYXQgcnggc2x5LWF1dG9sb2FkcyBp bmZvIHBhY2thZ2UNCmVhc3ltZW51IGVwZy1jb25maWcgdXJsLWhhbmRsZXJzIHVybC1wYXJzZSBh dXRoLXNvdXJjZSBjbC1zZXEgZWllaW8NCmVpZWlvLWNvcmUgY2wtbWFjcyBlaWVpby1sb2FkZGVm cyBwYXNzd29yZC1jYWNoZSB1cmwtdmFycyBzZXEgYnl0ZS1vcHQNCmd2IGJ5dGVjb21wIGJ5dGUt Y29tcGlsZSBjY29udiBjbC1sb2FkZGVmcyBjbC1saWIgdGltZS1kYXRlIG11bGUtdXRpbA0KdG9v bHRpcCBlbGRvYyBlbGVjdHJpYyB1bmlxdWlmeSBlZGlmZi1ob29rIHZjLWhvb2tzIGxpc3AtZmxv YXQtdHlwZQ0KbXdoZWVsIGRvcy13MzIgbHMtbGlzcCBkaXNwLXRhYmxlIHRlcm0vdzMyLXdpbiB3 MzItd2luIHczMi12YXJzDQp0ZXJtL2NvbW1vbi13aW4gdG9vbC1iYXIgZG5kIGZvbnRzZXQgaW1h Z2UgcmVnZXhwLW9wdCBmcmluZ2UNCnRhYnVsYXRlZC1saXN0IHJlcGxhY2UgbmV3Y29tbWVudCB0 ZXh0LW1vZGUgZWxpc3AtbW9kZSBsaXNwLW1vZGUNCnByb2ctbW9kZSByZWdpc3RlciBwYWdlIG1l bnUtYmFyIHJmbi1lc2hhZG93IGlzZWFyY2ggdGltZXIgc2VsZWN0DQpzY3JvbGwtYmFyIG1vdXNl IGppdC1sb2NrIGZvbnQtbG9jayBzeW50YXggZmFjZW1lbnUgZm9udC1jb3JlDQp0ZXJtL3R0eS1j b2xvcnMgZnJhbWUgY2wtZ2VuZXJpYyBjaGFtIGdlb3JnaWFuIHV0Zi04LWxhbmcgbWlzYy1sYW5n DQp2aWV0bmFtZXNlIHRpYmV0YW4gdGhhaSB0YWktdmlldCBsYW8ga29yZWFuIGphcGFuZXNlIGV1 Y2pwLW1zIGNwNTE5MzINCmhlYnJldyBncmVlayByb21hbmlhbiBzbG92YWsgY3plY2ggZXVyb3Bl YW4gZXRoaW9waWMgaW5kaWFuIGN5cmlsbGljDQpjaGluZXNlIGNvbXBvc2l0ZSBjaGFyc2NyaXB0 IGNoYXJwcm9wIGNhc2UtdGFibGUgZXBhLWhvb2sgamthLWNtcHItaG9vaw0KaGVscCBzaW1wbGUg YWJicmV2IG9iYXJyYXkgbWluaWJ1ZmZlciBjbC1wcmVsb2FkZWQgbmFkdmljZSBsb2FkZGVmcw0K YnV0dG9uIGZhY2VzIGN1cy1mYWNlIG1hY3JvZXhwIGZpbGVzIHRleHQtcHJvcGVydGllcyBvdmVy bGF5IHNoYTEgbWQ1DQpiYXNlNjQgZm9ybWF0IGVudiBjb2RlLXBhZ2VzIG11bGUgY3VzdG9tIHdp ZGdldCBoYXNodGFibGUtcHJpbnQtcmVhZGFibGUNCmJhY2txdW90ZSB3MzJub3RpZnkgdzMyIGxj bXMyIG11bHRpLXR0eSBtYWtlLW5ldHdvcmstcHJvY2VzcyBlbWFjcykNCg0KTWVtb3J5IGluZm9y bWF0aW9uOg0KKChjb25zZXMgMTYgMTcwOTczNiAyODE0NTIpDQogKHN5bWJvbHMgNTYgNzE2ODUg MSkNCiAobWlzY3MgNDggMzU5MiAzNjIpDQogKHN0cmluZ3MgMzIgMjUwNjg4IDc5Mjc2KQ0KIChz dHJpbmctYnl0ZXMgMSA3NzcxNjMwKQ0KICh2ZWN0b3JzIDE2IDEzOTUyNSkNCiAodmVjdG9yLXNs b3RzIDggMjk4NzE2MiA3NTE2KQ0KIChmbG9hdHMgOCAxNTQ0IDM1NDIpDQogKGludGVydmFscyA1 NiAxODg0NCA3ODIwKQ0KIChidWZmZXJzIDk5MiA5NykpDQoNCg== --_000_BN8PR04MB555503D4DD1283F20EAC7C578B4A0BN8PR04MB5555namp_ Content-Type: text/html; charset="utf-8" Content-Transfer-Encoding: base64 PGh0bWw+DQo8aGVhZD4NCjxtZXRhIGh0dHAtZXF1aXY9IkNvbnRlbnQtVHlwZSIgY29udGVudD0i dGV4dC9odG1sOyBjaGFyc2V0PXV0Zi04Ij4NCjxzdHlsZSB0eXBlPSJ0ZXh0L2NzcyIgc3R5bGU9 ImRpc3BsYXk6bm9uZTsiPiBQIHttYXJnaW4tdG9wOjA7bWFyZ2luLWJvdHRvbTowO30gPC9zdHls ZT4NCjwvaGVhZD4NCjxib2R5IGRpcj0ibHRyIj4NCjxkaXYgc3R5bGU9ImZvbnQtZmFtaWx5OkNh bGlicmksSGVsdmV0aWNhLHNhbnMtc2VyaWY7IGZvbnQtc2l6ZToxMnB0OyBjb2xvcjpyZ2IoMCww LDApIj4NCjxzcGFuPlRoZSBtYWNybyBsZXQtYWxpc3QgaXMgdG9vIHVzZWZ1bCB0byB3b3JrIHdp dGggSlNPTi1wYXJzZWQgZGF0YSBmb3IgaXQgdG8gYmUgbWlzc2luZyBmcm9tIHRoZSBkb2NzLjwv c3Bhbj48L2Rpdj4NCjxkaXYgc3R5bGU9ImZvbnQtZmFtaWx5OkNhbGlicmksSGVsdmV0aWNhLHNh bnMtc2VyaWY7IGZvbnQtc2l6ZToxMnB0OyBjb2xvcjpyZ2IoMCwwLDApIj4NCjxzcGFuPjxicj4N Cjwvc3Bhbj48L2Rpdj4NCjxkaXYgc3R5bGU9ImZvbnQtZmFtaWx5OkNhbGlicmksSGVsdmV0aWNh LHNhbnMtc2VyaWY7IGZvbnQtc2l6ZToxMnB0OyBjb2xvcjpyZ2IoMCwwLDApIj4NCjxzcGFuPklu IHRoZSBwYWdlJm5ic3A7PGEgaHJlZj0iaHR0cHM6Ly93d3cuZ251Lm9yZy9zb2Z0d2FyZS9lbWFj cy9tYW51YWwvaHRtbF9ub2RlL2VsaXNwL0Fzc29jaWF0aW9uLUxpc3RzLmh0bWwiIGlkPSJMUE5v TFA0MTkyMzMiPmh0dHBzOi8vd3d3LmdudS5vcmcvc29mdHdhcmUvZW1hY3MvbWFudWFsL2h0bWxf bm9kZS9lbGlzcC9Bc3NvY2lhdGlvbi1MaXN0cy5odG1sPC9hPiZuYnNwO3dlIHNob3VsZCBhZGQg c29tZSBkb2N1bWVudGF0aW9uIGFib3V0IGl0LiBCZWxvdw0KIGEgc3VnZ2VzdGlvbi48L3NwYW4+ PC9kaXY+DQo8ZGl2IHN0eWxlPSJmb250LWZhbWlseTpDYWxpYnJpLEhlbHZldGljYSxzYW5zLXNl cmlmOyBmb250LXNpemU6MTJwdDsgY29sb3I6cmdiKDAsMCwwKSI+DQo8c3Bhbj48YnI+DQo8L3Nw YW4+PC9kaXY+DQo8ZGl2IHN0eWxlPSJmb250LWZhbWlseTpDYWxpYnJpLEhlbHZldGljYSxzYW5z LXNlcmlmOyBmb250LXNpemU6MTJwdDsgY29sb3I6cmdiKDAsMCwwKSI+DQo8c3Bhbj5UaGFuayB5 b3UhPC9zcGFuPjwvZGl2Pg0KPGRpdiBzdHlsZT0iZm9udC1mYW1pbHk6Q2FsaWJyaSxIZWx2ZXRp Y2Esc2Fucy1zZXJpZjsgZm9udC1zaXplOjEycHQ7IGNvbG9yOnJnYigwLDAsMCkiPg0KPGJyPg0K PC9kaXY+DQo8ZGl2IHN0eWxlPSJmb250LWZhbWlseTpDYWxpYnJpLEhlbHZldGljYSxzYW5zLXNl cmlmOyBmb250LXNpemU6MTJwdDsgY29sb3I6cmdiKDAsMCwwKSI+DQo8c3Bhbj48c3Bhbj7igJQg TWFjcm86IGxldC1hbGlzdCBgdmFsdWVgPGJyPg0KPC9zcGFuPg0KPGRpdj5DcmVhdGVzIGEgYmlu ZGluZyBmb3IgZWFjaCBzeW1ib2wgaW4gdGhlIGFzc29jaWF0aW9uIGxpc3QgYHZhbHVlYCwgcHJl Zml4ZWQgd2l0aCBkb3QuIFRoaXMgaXMgdmVyeSB1c2VmdWwgd2hlbiBhY2Nlc3Npbmcgc2V2ZXJh bCBpdGVtcyBpbiB0aGUgc2FtZSBhbGlzdCwgYW5kIGl0J3MgYmVzdCB1bmRlcnN0b29kIHRocm91 Z2ggYSBzaW1wbGUgZXhhbXBsZTo8YnI+DQo8L2Rpdj4NCjxzcGFuPjwvc3Bhbj48L3NwYW4+PC9k aXY+DQo8ZGl2IHN0eWxlPSJmb250LWZhbWlseTpDYWxpYnJpLEhlbHZldGljYSxzYW5zLXNlcmlm OyBmb250LXNpemU6MTJwdDsgY29sb3I6cmdiKDAsMCwwKSI+DQo8YnI+DQo8L2Rpdj4NCjxkaXYg c3R5bGU9ImZvbnQtZmFtaWx5OkNhbGlicmksSGVsdmV0aWNhLHNhbnMtc2VyaWY7IGZvbnQtc2l6 ZToxMnB0OyBjb2xvcjpyZ2IoMCwwLDApIj4NCihzZXRxIGNvbG9ycyAnKChyb3NlIHJlZCkgKGxp bHkgd2hpdGUpIChidXR0ZXJjdXAgeWVsbG93KSkpPGJyPg0KPC9kaXY+DQo8ZGl2IHN0eWxlPSJm b250LWZhbWlseTpDYWxpYnJpLEhlbHZldGljYSxzYW5zLXNlcmlmOyBmb250LXNpemU6MTJwdDsg Y29sb3I6cmdiKDAsMCwwKSI+DQoobGV0LWFsaXN0IGNvbG9yczwvZGl2Pg0KPGRpdiBzdHlsZT0i Zm9udC1mYW1pbHk6Q2FsaWJyaSxIZWx2ZXRpY2Esc2Fucy1zZXJpZjsgZm9udC1zaXplOjEycHQ7 IGNvbG9yOnJnYigwLDAsMCkiPg0KJm5ic3A7ICZuYnNwOyAocHJpbnQgLnJvc2UpPC9kaXY+DQo8 ZGl2IHN0eWxlPSJmb250LWZhbWlseTpDYWxpYnJpLEhlbHZldGljYSxzYW5zLXNlcmlmOyBmb250 LXNpemU6MTJwdDsgY29sb3I6cmdiKDAsMCwwKSI+DQombmJzcDsgJm5ic3A7IChwcmludCAuYnV0 dGVyY3VwKSk8L2Rpdj4NCjxkaXYgc3R5bGU9ImZvbnQtZmFtaWx5OkNhbGlicmksSGVsdmV0aWNh LHNhbnMtc2VyaWY7IGZvbnQtc2l6ZToxMnB0OyBjb2xvcjpyZ2IoMCwwLDApIj4NCiZuYnNwOyAm bmJzcDsg4oeSIHJlZDxicj4NCjwvZGl2Pg0KPGRpdiBzdHlsZT0iZm9udC1mYW1pbHk6Q2FsaWJy aSxIZWx2ZXRpY2Esc2Fucy1zZXJpZjsgZm9udC1zaXplOjEycHQ7IGNvbG9yOnJnYigwLDAsMCki Pg0KJm5ic3A7ICZuYnNwOyDih5IgeWVsbG93PGJyPg0KPC9kaXY+DQo8ZGl2IHN0eWxlPSJmb250 LWZhbWlseTpDYWxpYnJpLEhlbHZldGljYSxzYW5zLXNlcmlmOyBmb250LXNpemU6MTJwdDsgY29s b3I6cmdiKDAsMCwwKSI+DQo8YnI+DQo8L2Rpdj4NCjxkaXYgc3R5bGU9ImZvbnQtZmFtaWx5OkNh bGlicmksSGVsdmV0aWNhLHNhbnMtc2VyaWY7IGZvbnQtc2l6ZToxMnB0OyBjb2xvcjpyZ2IoMCww LDApIj4NCjxicj4NCjwvZGl2Pg0KPGRpdiBzdHlsZT0iZm9udC1mYW1pbHk6Q2FsaWJyaSxIZWx2 ZXRpY2Esc2Fucy1zZXJpZjsgZm9udC1zaXplOjEycHQ7IGNvbG9yOnJnYigwLDAsMCkiPg0KPGJy Pg0KPC9kaXY+DQo8ZGl2IHN0eWxlPSJmb250LWZhbWlseTpDYWxpYnJpLEhlbHZldGljYSxzYW5z LXNlcmlmOyBmb250LXNpemU6MTJwdDsgY29sb3I6cmdiKDAsMCwwKSI+DQo8c3Bhbj5JbiBHTlUg RW1hY3MgMjYuMSAoYnVpbGQgMSwgeDg2XzY0LXc2NC1taW5ndzMyKTxicj4NCjwvc3Bhbj4NCjxk aXY+Jm5ic3A7b2YgMjAxOC0wNS0zMCBidWlsdCBvbiBDSVJST0NVTVVMVVM8YnI+DQo8L2Rpdj4N CjxkaXY+UmVwb3NpdG9yeSByZXZpc2lvbjogMDdmOGY5YmM1YTUxZjVhYTk0ZWIwOTlmM2UxNWZi ZTBjMjBlYTFlYTxicj4NCjwvZGl2Pg0KPGRpdj5XaW5kb3dpbmcgc3lzdGVtIGRpc3RyaWJ1dG9y ICdNaWNyb3NvZnQgQ29ycC4nLCB2ZXJzaW9uIDEwLjAuMTcxMzQ8YnI+DQo8L2Rpdj4NCjxkaXY+ UmVjZW50IG1lc3NhZ2VzOjxicj4NCjwvZGl2Pg0KPGRpdj5XaGVuIGRvbmUgd2l0aCBhIGJ1ZmZl ciwgdHlwZSBDLWMgQy1jPGJyPg0KPC9kaXY+DQo8ZGl2PlR5cGUgQy1jIEMtYyB0byBmaW5pc2gs IG9yIEMtYyBDLWsgdG8gY2FuY2VsPGJyPg0KPC9kaXY+DQo8ZGl2PkF1dG8tc2F2aW5nLi4uZG9u ZTxicj4NCjwvZGl2Pg0KPGRpdj5TYXZpbmcgZmlsZSBjOi9Ib21lL2dpdGh1Yi9wZXBpdGEvLmdp dC9DT01NSVRfRURJVE1TRy4uLjxicj4NCjwvZGl2Pg0KPGRpdj5Xcm90ZSBjOi9Ib21lL2dpdGh1 Yi9wZXBpdGEvLmdpdC9DT01NSVRfRURJVE1TRzxicj4NCjwvZGl2Pg0KPGRpdj5HaXQuRXhlIGZp bmlzaGVkPGJyPg0KPC9kaXY+DQo8ZGl2Pk1hcmsgc2V0PGJyPg0KPC9kaXY+DQo8ZGl2PlJ1bm5p bmcgQzovUHJvZ3JhbSBGaWxlcy9HaXQvbWluZ3c2NC9saWJleGVjL2dpdC1jb3JlL2dpdC5leGUg cHVzaCAtdiBvcmlnaW4gbWFzdGVyOnJlZnMvaGVhZHMvbWFzdGVyPGJyPg0KPC9kaXY+DQo8ZGl2 PkdpdC5FeGUgZmluaXNoZWQ8YnI+DQo8L2Rpdj4NCjxkaXY+ZGVsZXRlLWJhY2t3YXJkLWNoYXI6 IFRleHQgaXMgcmVhZC1vbmx5IFs0IHRpbWVzXTxicj4NCjwvZGl2Pg0KPGRpdj48YnI+DQo8L2Rp dj4NCjxkaXY+Q29uZmlndXJlZCB1c2luZzo8YnI+DQo8L2Rpdj4NCjxkaXY+Jm5ic3A7J2NvbmZp Z3VyZSAtLXdpdGhvdXQtZGJ1cyAtLWhvc3Q9eDg2XzY0LXc2NC1taW5ndzMyPGJyPg0KPC9kaXY+ DQo8ZGl2PiZuYnNwOy0td2l0aG91dC1jb21wcmVzcy1pbnN0YWxsICdDRkxBR1M9LU8yIC1zdGF0 aWMgLWczJyc8YnI+DQo8L2Rpdj4NCjxkaXY+PGJyPg0KPC9kaXY+DQo8ZGl2PkNvbmZpZ3VyZWQg ZmVhdHVyZXM6PGJyPg0KPC9kaXY+DQo8ZGl2PlhQTSBKUEVHIFRJRkYgR0lGIFBORyBSU1ZHIFNP VU5EIE5PVElGWSBBQ0wgR05VVExTIExJQlhNTDIgWkxJQjxicj4NCjwvZGl2Pg0KPGRpdj5UT09M S0lUX1NDUk9MTF9CQVJTIFRIUkVBRFMgTENNUzI8YnI+DQo8L2Rpdj4NCjxkaXY+PGJyPg0KPC9k aXY+DQo8ZGl2PkltcG9ydGFudCBzZXR0aW5nczo8YnI+DQo8L2Rpdj4NCjxkaXY+Jm5ic3A7IHZh bHVlIG9mICRMQU5HOiBFTlU8YnI+DQo8L2Rpdj4NCjxkaXY+Jm5ic3A7IGxvY2FsZS1jb2Rpbmct c3lzdGVtOiB1dGYtODxicj4NCjwvZGl2Pg0KPGRpdj48YnI+DQo8L2Rpdj4NCjxkaXY+TWFqb3Ig bW9kZTogTWFnaXQ8YnI+DQo8L2Rpdj4NCjxkaXY+PGJyPg0KPC9kaXY+DQo8ZGl2Pk1pbm9yIG1v ZGVzIGluIGVmZmVjdDo8YnI+DQo8L2Rpdj4NCjxkaXY+Jm5ic3A7IHNlbWFudGljLW1pbm9yLW1v ZGVzLWZvcm1hdDogKCg6ZXZhbCAoaWYgKG9yIHNlbWFudGljLWhpZ2hsaWdodC1lZGl0cy1tb2Rl IHNlbWFudGljLXNob3ctdW5tYXRjaGVkLXN5bnRheC1tb2RlKSAmbmJzcDtTKSkpPGJyPg0KPC9k aXY+DQo8ZGl2PiZuYnNwOyBlbGVjdHJpYy1wYWlyLW1vZGU6IHQ8YnI+DQo8L2Rpdj4NCjxkaXY+ Jm5ic3A7IGRlbGV0ZS1zZWxlY3Rpb24tbW9kZTogdDxicj4NCjwvZGl2Pg0KPGRpdj4mbmJzcDsg Z2xvYmFsLWhsLWxpbmUtbW9kZTogdDxicj4NCjwvZGl2Pg0KPGRpdj4mbmJzcDsgd2hpY2gta2V5 LW1vZGU6IHQ8YnI+DQo8L2Rpdj4NCjxkaXY+Jm5ic3A7IG55YW4tbW9kZTogdDxicj4NCjwvZGl2 Pg0KPGRpdj4mbmJzcDsgbWFnaXQtZ2l0Zmxvdy1tb2RlOiB0PGJyPg0KPC9kaXY+DQo8ZGl2PiZu YnNwOyBnbG9iYWwtbWFnaXQtZmlsZS1tb2RlOiB0PGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyBk aWZmLWF1dG8tcmVmaW5lLW1vZGU6IHQ8YnI+DQo8L2Rpdj4NCjxkaXY+Jm5ic3A7IG1hZ2l0LWF1 dG8tcmV2ZXJ0LW1vZGU6IHQ8YnI+DQo8L2Rpdj4NCjxkaXY+Jm5ic3A7IGdsb2JhbC1naXQtY29t bWl0LW1vZGU6IHQ8YnI+DQo8L2Rpdj4NCjxkaXY+Jm5ic3A7IGljb21wbGV0ZS1tb2RlOiB0PGJy Pg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyBpZG8tdmVydGljYWwtbW9kZTogdDxicj4NCjwvZGl2Pg0K PGRpdj4mbmJzcDsgZG9vbS1tb2RlbGluZS1tb2RlOiB0PGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNw OyBlbGRvYy1pbi1taW5pYnVmZmVyLW1vZGU6IHQ8YnI+DQo8L2Rpdj4NCjxkaXY+Jm5ic3A7IGFz eW5jLWJ5dGVjb21wLXBhY2thZ2UtbW9kZTogdDxicj4NCjwvZGl2Pg0KPGRpdj4mbmJzcDsgcmVj ZW50Zi1tb2RlOiB0PGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyBnbG9iYWwtY29tcGFueS1tb2Rl OiB0PGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyBjb21wYW55LW1vZGU6IHQ8YnI+DQo8L2Rpdj4N CjxkaXY+Jm5ic3A7IGdsb2JhbC1hbnp1LW1vZGU6IHQ8YnI+DQo8L2Rpdj4NCjxkaXY+Jm5ic3A7 IGFuenUtbW9kZTogdDxicj4NCjwvZGl2Pg0KPGRpdj4mbmJzcDsgc2hlbGwtZGlydHJhY2stbW9k ZTogdDxicj4NCjwvZGl2Pg0KPGRpdj4mbmJzcDsgc3ltb24tbW9kZTogdDxicj4NCjwvZGl2Pg0K PGRpdj4mbmJzcDsgbWluaW9ucy1tb2RlOiB0PGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyBpZG8t dWJpcXVpdG91cy1tb2RlOiB0PGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyBpZG8tZXZlcnl3aGVy ZTogdDxicj4NCjwvZGl2Pg0KPGRpdj4mbmJzcDsgZ2xvYmFsLXZpc2libGUtbWFyay1tb2RlOiB0 PGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyB2aXNpYmxlLW1hcmstbW9kZTogdDxicj4NCjwvZGl2 Pg0KPGRpdj4mbmJzcDsgZ2xvYmFsLWZseWNoZWNrLW1vZGU6IHQ8YnI+DQo8L2Rpdj4NCjxkaXY+ Jm5ic3A7IHByb2plY3RpbGUtbW9kZTogdDxicj4NCjwvZGl2Pg0KPGRpdj4mbmJzcDsgdG9vbHRp cC1tb2RlOiB0PGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyBnbG9iYWwtZWxkb2MtbW9kZTogdDxi cj4NCjwvZGl2Pg0KPGRpdj4mbmJzcDsgZWxlY3RyaWMtaW5kZW50LW1vZGU6IHQ8YnI+DQo8L2Rp dj4NCjxkaXY+Jm5ic3A7IG1vdXNlLXdoZWVsLW1vZGU6IHQ8YnI+DQo8L2Rpdj4NCjxkaXY+Jm5i c3A7IGZpbGUtbmFtZS1zaGFkb3ctbW9kZTogdDxicj4NCjwvZGl2Pg0KPGRpdj4mbmJzcDsgZ2xv YmFsLWZvbnQtbG9jay1tb2RlOiB0PGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyBmb250LWxvY2st bW9kZTogdDxicj4NCjwvZGl2Pg0KPGRpdj4mbmJzcDsgYXV0by1jb21wb3NpdGlvbi1tb2RlOiB0 PGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyBhdXRvLWVuY3J5cHRpb24tbW9kZTogdDxicj4NCjwv ZGl2Pg0KPGRpdj4mbmJzcDsgYXV0by1jb21wcmVzc2lvbi1tb2RlOiB0PGJyPg0KPC9kaXY+DQo8 ZGl2PiZuYnNwOyBidWZmZXItcmVhZC1vbmx5OiB0PGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyBz aXplLWluZGljYXRpb24tbW9kZTogdDxicj4NCjwvZGl2Pg0KPGRpdj4mbmJzcDsgY29sdW1uLW51 bWJlci1tb2RlOiB0PGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyBsaW5lLW51bWJlci1tb2RlOiB0 PGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyB0cmFuc2llbnQtbWFyay1tb2RlOiB0PGJyPg0KPC9k aXY+DQo8ZGl2Pjxicj4NCjwvZGl2Pg0KPGRpdj5Mb2FkLXBhdGggc2hhZG93czo8YnI+DQo8L2Rp dj4NCjxkaXY+YzovaG9tZS9naXRodWIvcGVwaXRhL3RlbXAgaGlkZXMgYzovaG9tZS9naXRodWIv cGFuZGEvdGVtcDxicj4NCjwvZGl2Pg0KPGRpdj5+Ly5lbWFjcy5kL2xpc3AvZGlyZWQtZ2l0LWlu Zm8gaGlkZXMgYzovSG9tZS8uZW1hY3MuZC9lbHBhL2RpcmVkLWdpdC1pbmZvLTAuMi9kaXJlZC1n aXQtaW5mbzxicj4NCjwvZGl2Pg0KPGRpdj48YnI+DQo8L2Rpdj4NCjxkaXY+RmVhdHVyZXM6PGJy Pg0KPC9kaXY+DQo8ZGl2PihzaGFkb3cgc29ydCBtYWlsLWV4dHIgZW1hY3NidWcgc2VuZG1haWwg cGVwaXRhIGxvYWRoaXN0IG1hcmtkb3duLW1vZGU8YnI+DQo8L2Rpdj4NCjxkaXY+Y29sb3IgcGNt cGwtdW5peCBlbS14dHJhIGVtLXJlYmluZCBlbS1zbWFydCBlbS10cmFtcCB0ZXhuZm8tdXBkIHRl eGluZm88YnI+DQo8L2Rpdj4NCjxkaXY+bWFuIGVtLXVuaXggZW0tdGVybSB0ZXJtIGVoZWxwIGVt LXNjcmlwdCBlbS1wcm9tcHQgZW0tbHMgZW0taGlzdCBlbS1wcmVkPGJyPg0KPC9kaXY+DQo8ZGl2 PmVtLWdsb2IgZW0tZGlycyBlbS1jbXBsIGVtLWJhc2ljIGVtLWJhbm5lciBlbS1hbGlhcyBlc2gt dmFyIGVzaC1pbzxicj4NCjwvZGl2Pg0KPGRpdj5lc2gtY21kIGVzaC1vcHQgZXNoLWV4dCBlc2gt cHJvYyBlc2gtYXJnIGVzaC1ncm91cHMgZXNoZWxsIGVzaC1tb2R1bGU8YnI+DQo8L2Rpdj4NCjxk aXY+ZXNoLW1vZGUgZXNoLXV0aWwgcHJvZmlsZXIgcHVsc2UgZWllaW8tb3B0IGhlbHAtZm5zIHdh cm5pbmdzPGJyPg0KPC9kaXY+DQo8ZGl2PnN1YndvcmQtbW9kZS1leHBhbnNpb25zIGNhcC13b3Jk cyBzdXBlcndvcmQgc3Vid29yZCBydWJ5LW1vZGUtZXhwYW5zaW9uczxicj4NCjwvZGl2Pg0KPGRp dj5ydWJ5LW1vZGUgc21pZSBlcnQgZXdvYyBhdXRvbG9hZCByYWRpeC10cmVlIGxpc3AtbW50IHRh ci1tb2RlPGJyPg0KPC9kaXY+DQo8ZGl2Pm1hZ2l0LXBhdGNoIG1hZ2l0LXN1YnRyZWUgbWFnaXQt ZWRpZmYgdGltZXpvbmU8YnI+DQo8L2Rpdj4NCjxkaXY+cHl0aG9uLWVsLWZnYWxsaW5hLWV4cGFu c2lvbnMgcHl0aG9uIHRyYW1wLXNoIGNsLXByaW50IGRlYnVnIGNvbmYtbW9kZTxicj4NCjwvZGl2 Pg0KPGRpdj5kaXJlZC14IGRhYmJyZXYgdmMtYnpyIHZjLXNyYyB2Yy1zY2NzIHZjLXN2biB2Yy1j dnMgdmMtcmNzIHZjPGJyPg0KPC9kaXY+DQo8ZGl2PnZjLWRpc3BhdGNoZXIgZGVhZGdyZXAgc3Bp bm5lciBybmcteHNkIHhzZC1yZWdleHAgcm5nLWNtcGN0PGJyPg0KPC9kaXY+DQo8ZGl2Pm54bWwt bW9kZS1leHBhbnNpb25zIHJuZy1ueG1sIHJuZy12YWxpZCBybmctbG9jIHJuZy11cmkgcm5nLXBh cnNlPGJyPg0KPC9kaXY+DQo8ZGl2Pm54bWwtcGFyc2Ugcm5nLW1hdGNoIHJuZy1kdCBybmctdXRp bCBybmctcHR0cm4gbnhtbC1ucyBueG1sLW1vZGU8YnI+DQo8L2Rpdj4NCjxkaXY+bnhtbC1vdXRs biBueG1sLXJhcCBueG1sLXV0aWwgbnhtbC1lbmMgeG1sdG9rIGJ1Zy1yZWZlcmVuY2UgbWFnaXQt ZXh0cmFzPGJyPg0KPC9kaXY+DQo8ZGl2PnNwZWVkYmFyIHNiLWltYWdlIGV6aW1hZ2UgZGZyYW1l IG9yZy1ybWFpbCBvcmctbWhlIG9yZy1pcmMgb3JnLWluZm88YnI+DQo8L2Rpdj4NCjxkaXY+b3Jn LWdudXMgbm5pciBnbnVzLXN1bSBnbnVzLWdyb3VwIGdudXMtdW5kbyBnbnVzLXN0YXJ0IGdudXMt Y2xvdWQgbm5pbWFwPGJyPg0KPC9kaXY+DQo8ZGl2Pm5ubWFpbCBtYWlsLXNvdXJjZSB1dGY3IG5l dHJjIG5ub28gZ251cy1zcGVjIGdudXMtaW50IGdudXMtcmFuZ2U8YnI+DQo8L2Rpdj4NCjxkaXY+ Z251cy13aW4gb3JnLWRvY3ZpZXcgZG9jLXZpZXcgamthLWNvbXByIGltYWdlLW1vZGUgb3JnLWJp YnRleCBiaWJ0ZXg8YnI+DQo8L2Rpdj4NCjxkaXY+b3JnLWJiZGIgb3JnLXczbSBvcmctZWxlbWVu dCBhdmwtdHJlZSBnZW5lcmF0b3IgdGhlLW9yZy1tb2RlLWV4cGFuc2lvbnM8YnI+DQo8L2Rpdj4N CjxkaXY+b3JnIG9yZy1tYWNybyBvcmctZm9vdG5vdGUgb3JnLXBjb21wbGV0ZSBvcmctbGlzdCBv cmctZmFjZXMgb3JnLWVudGl0aWVzPGJyPg0KPC9kaXY+DQo8ZGl2Pm9yZy12ZXJzaW9uIG9iLWVt YWNzLWxpc3Agb2Igb2ItdGFuZ2xlIG9yZy1zcmMgb2ItcmVmIG9iLWxvYiBvYi10YWJsZTxicj4N CjwvZGl2Pg0KPGRpdj5vYi1rZXlzIG9iLWV4cCBvYi1jb21pbnQgb2ItY29yZSBvYi1ldmFsIG9y Zy1jb21wYXQgb3JnLW1hY3M8YnI+DQo8L2Rpdj4NCjxkaXY+b3JnLWxvYWRkZWZzIG1pc2VhcmNo IG11bHRpLWlzZWFyY2ggdHdvLWNvbHVtbiBpc28tdHJhbnNsIGZhY2UtcmVtYXA8YnI+DQo8L2Rp dj4NCjxkaXY+dmMtZ2l0IGNvbXBhbnktb2RkbXVzZSBjb21wYW55LWtleXdvcmRzIGNvbXBhbnkt ZXRhZ3MgY29tcGFueS1ndGFnczxicj4NCjwvZGl2Pg0KPGRpdj5jb21wYW55LWRhYmJyZXYtY29k ZSBjb21wYW55LWRhYmJyZXYgY29tcGFueS1maWxlcyBjb21wYW55LWNhcGY8YnI+DQo8L2Rpdj4N CjxkaXY+Y29tcGFueS1jbWFrZSBjb21wYW55LXhjb2RlIGNvbXBhbnktY2xhbmcgY29tcGFueS1z ZW1hbnRpYyBjb21wYW55LWVjbGltPGJyPg0KPC9kaXY+DQo8ZGl2PmNvbXBhbnktdGVtcGxhdGUg Y29tcGFueS1iYmRiIGxpbnVtIHdoaXRlc3BhY2UgY3N2IGRlcGxveS1zdGF0dXMgcGFuZGE8YnI+ DQo8L2Rpdj4NCjxkaXY+bGV0LWFsaXN0IGVsZWMtcGFpciBkZWxzZWwgaGwtbGluZSB3cy1idXRs ZXIgd2hpY2gta2V5PGJyPg0KPC9kaXY+DQo8ZGl2PndlYi1tb2RlLWV4cGFuc2lvbnMgd2ViLW1v ZGUgc3FsIHZpZXcgc2x5IHNseS1jb21wbGV0aW9uIHNseS1idXR0b25zPGJyPg0KPC9kaXY+DQo8 ZGl2PnNseS1tZXNzYWdlcyBzbHktY29tbW9uIGFwcm9wb3MgYXJjLW1vZGUgYXJjaGl2ZS1tb2Rl IG5vdXRsaW5lIG91dGxpbmU8YnI+DQo8L2Rpdj4NCjxkaXY+aHlwZXJzcGVjIHBvd2Vyc2hlbGwg b21uaXNoYXJwIG9tbmlzaGFycC11bml0LXRlc3QtYWN0aW9uczxicj4NCjwvZGl2Pg0KPGRpdj5v bW5pc2hhcnAtY29kZS1zdHJ1Y3R1cmUgb21uaXNoYXJwLXNlcnZlci1pbnN0YWxsYXRpb248YnI+ DQo8L2Rpdj4NCjxkaXY+b21uaXNoYXJwLWZvcm1hdC1hY3Rpb25zIG9tbmlzaGFycC1zb2x1dGlv bi1hY3Rpb25zPGJyPg0KPC9kaXY+DQo8ZGl2Pm9tbmlzaGFycC1oZWxtLWludGVncmF0aW9uIG9t bmlzaGFycC1uYXZpZ2F0aW9uLWFjdGlvbnM8YnI+DQo8L2Rpdj4NCjxkaXY+b21uaXNoYXJwLWN1 cnJlbnQtc3ltYm9sLWFjdGlvbnMgb21uaXNoYXJwLWF1dG8tY29tcGxldGUtYWN0aW9uczxicj4N CjwvZGl2Pg0KPGRpdj5vbW5pc2hhcnAtc2VydmVyLWFjdGlvbnMgb21uaXNoYXJwLWh0dHAtdXRp bHMgb21uaXNoYXJwLXV0aWxzPGJyPg0KPC9kaXY+DQo8ZGl2Pm9tbmlzaGFycC1zZXJ2ZXItbWFu YWdlbWVudCBvbW5pc2hhcnAtc2V0dGluZ3MgZXRhZ3MgeHJlZiBwb3B1cDxicj4NCjwvZGl2Pg0K PGRpdj5jc2hhcnAtbW9kZSBueWFuLW1vZGUgbWFnaXQtZ2l0ZmxvdyBtYWdpdC1ib29rbWFyayBt YWdpdC1zdWJtb2R1bGU8YnI+DQo8L2Rpdj4NCjxkaXY+bWFnaXQtb2Jzb2xldGUgbWFnaXQtYmxh bWUgbWFnaXQtc3Rhc2ggbWFnaXQtYmlzZWN0IG1hZ2l0LXB1c2g8YnI+DQo8L2Rpdj4NCjxkaXY+ bWFnaXQtcHVsbCBtYWdpdC1mZXRjaCBtYWdpdC1jbG9uZSBtYWdpdC1yZW1vdGUgbWFnaXQtY29t bWl0PGJyPg0KPC9kaXY+DQo8ZGl2Pm1hZ2l0LXNlcXVlbmNlIG1hZ2l0LW5vdGVzIG1hZ2l0LXdv cmt0cmVlIG1hZ2l0LXRhZyBtYWdpdC1tZXJnZTxicj4NCjwvZGl2Pg0KPGRpdj5tYWdpdC1icmFu Y2ggbWFnaXQtcmVzZXQgbWFnaXQtZmlsZXMgbWFnaXQtcmVmcyBtYWdpdC1zdGF0dXMgbWFnaXQ8 YnI+DQo8L2Rpdj4NCjxkaXY+bWFnaXQtcmVwb3MgbWFnaXQtYXBwbHkgbWFnaXQtd2lwIG1hZ2l0 LWxvZyB3aGljaC1mdW5jIG1hZ2l0LWRpZmY8YnI+DQo8L2Rpdj4NCjxkaXY+c21lcmdlLW1vZGUg ZGlmZi1tb2RlIG1hZ2l0LWNvcmUgbWFnaXQtYXV0b3JldmVydCBhdXRvcmV2ZXJ0IGZpbGVub3Rp Znk8YnI+DQo8L2Rpdj4NCjxkaXY+bWFnaXQtbWFyZ2luIG1hZ2l0LXRyYW5zaWVudCBtYWdpdC1w cm9jZXNzIG1hZ2l0LW1vZGUgdHJhbnNpZW50PGJyPg0KPC9kaXY+DQo8ZGl2PmdpdC1jb21taXQg bWFnaXQtZ2l0IG1hZ2l0LXNlY3Rpb24gbWFnaXQtdXRpbHMgY3JtIGxvZy1lZGl0IHBjdnMtdXRp bDxicj4NCjwvZGl2Pg0KPGRpdj5hZGQtbG9nIHdpdGgtZWRpdG9yIHNlcnZlciBqc29uLW1vZGUg anNvbi1yZWZvcm1hdCBqc29uLXNuYXRjaGVyPGJyPg0KPC9kaXY+DQo8ZGl2PmpzLW1vZGUtZXhw YW5zaW9ucyBqcyBodG1sLW1vZGUtZXhwYW5zaW9ucyBzZ21sLW1vZGUgY2MtbW9kZS1leHBhbnNp b25zPGJyPg0KPC9kaXY+DQo8ZGl2PmNjLW1vZGUgY2MtZm9udHMgY2MtZ3Vlc3MgY2MtbWVudXMg Y2MtY21kcyBjYy1zdHlsZXMgY2MtYWxpZ24gY2MtZW5naW5lPGJyPg0KPC9kaXY+DQo8ZGl2PmNj LXZhcnMgY2MtZGVmcyBpbWVudSBpY29tcGxldGUgaWRvLXZlcnRpY2FsLW1vZGUgaWJ1ZmZlci1w cm9qZWN0aWxlPGJyPg0KPC9kaXY+DQo8ZGl2PmZvcm1hdC1hbGwgZG90bmV0IGRvb20tbW9kZWxp bmUgZG9vbS1tb2RlbGluZS1zZWdtZW50cyBkb29tLW1vZGVsaW5lLWVudjxicj4NCjwvZGl2Pg0K PGRpdj5hbGwtdGhlLWljb25zIGFsbC10aGUtaWNvbnMtZmFjZXMgZGF0YS1tYXRlcmlhbCBkYXRh LXdlYXRoZXJpY29uczxicj4NCjwvZGl2Pg0KPGRpdj5kYXRhLW9jdGljb25zIGRhdGEtZmlsZWlj b25zIGRhdGEtZmFpY29ucyBkYXRhLWFsbHRoZWljb25zPGJyPg0KPC9kaXY+DQo8ZGl2PmRvb20t bW9kZWxpbmUtY29yZSBwcm9qZWN0IHNocmluay1wYXRoIGYgZWxkb2MtZXZhbCBkb2NrZXIgZG9j a2VyLXZvbHVtZTxicj4NCjwvZGl2Pg0KPGRpdj5kb2NrZXItbmV0d29yayBkb2NrZXItbWFjaGlu ZSBkb2NrZXItaW1hZ2UgZG9ja2VyLWNvbnRhaW5lcjxicj4NCjwvZGl2Pg0KPGRpdj5kb2NrZXIt cHJvY2VzcyBkb2NrZXItdXRpbHMgdGFibGlzdCB0YWJsaXN0LWZpbHRlciBzZW1hbnRpYy93aXNl bnQvY29tcDxicj4NCjwvZGl2Pg0KPGRpdj5zZW1hbnRpYy93aXNlbnQgc2VtYW50aWMvd2lzZW50 L3dpc2VudCBzZW1hbnRpYy91dGlsLW1vZGVzIHNlbWFudGljL3V0aWw8YnI+DQo8L2Rpdj4NCjxk aXY+c2VtYW50aWMgc2VtYW50aWMvdGFnIHNlbWFudGljL2xleCBzZW1hbnRpYy9mdyBtb2RlLWxv Y2FsIGNlZGV0PGJyPg0KPC9kaXY+DQo8ZGl2PmRvY2tlci1ncm91cCBtYWdpdC1wb3B1cCBhc3lu Yy1ieXRlY29tcCBhc3luYyBkYXNoYm9hcmQ8YnI+DQo8L2Rpdj4NCjxkaXY+ZGFzaGJvYXJkLXdp ZGdldHMgcmVjZW50ZiB0cmVlLXdpZGdldCBwYWdlLWJyZWFrLWxpbmVzIGNhbC1tZW51IGNhbGVu ZGFyPGJyPg0KPC9kaXY+DQo8ZGl2PmNhbC1sb2FkZGVmcyBib29rbWFyayBwcCBld3ctbG51bSBl d3cgbW0tdXJsIGdudXMgbm5oZWFkZXIgdXJsLXF1ZXVlIHNocjxicj4NCjwvZGl2Pg0KPGRpdj5z dmcgeG1sIGRvbSBicm93c2UtdXJsIGV4cGFuZC1yZWdpb24gdGV4dC1tb2RlLWV4cGFuc2lvbnM8 YnI+DQo8L2Rpdj4NCjxkaXY+ZXItYmFzaWMtZXhwYW5zaW9ucyBleHBhbmQtcmVnaW9uLWNvcmUg ZXhwYW5kLXJlZ2lvbi1jdXN0b20gZWRpZmYtbWVyZzxicj4NCjwvZGl2Pg0KPGRpdj5lZGlmZi13 aW5kIGVkaWZmLWRpZmYgZWRpZmYtbXVsdCBlZGlmZi1oZWxwIGVkaWZmLWluaXQgZWRpZmYtdXRp bCBlZGlmZjxicj4NCjwvZGl2Pg0KPGRpdj5jb21wYW55IGVkbWFjcm8ga21hY3JvIHBjYXNlIGJy b3dzZS1raWxsLXJpbmcgY2wgYW56dSBkb2NrZXItdHJhbXA8YnI+DQo8L2Rpdj4NCjxkaXY+dHJh bXAtY2FjaGUgdHJhbXAgdHJhbXAtY29tcGF0IHRyYW1wLWxvYWRkZWZzIHRyYW1wdmVyIHVjcy1u b3JtYWxpemU8YnI+DQo8L2Rpdj4NCjxkaXY+c2hlbGwgcGNvbXBsZXRlIHBhcnNlLXRpbWUgYWR2 aWNlIGRvb20tY2hhbGxlbmdlci1kZWVwLXRoZW1lIHN5bW9uPGJyPg0KPC9kaXY+DQo8ZGl2PmJh dHRlcnkgbWluaW9ucyBpZG8tY29tcGxldGluZy1yZWFkJiM0MzsgbWVtb2l6ZSBzIGN1cy1lZGl0 IHdpZC1lZGl0PGJyPg0KPC9kaXY+DQo8ZGl2Pm1pbmlidWYtZWxkZWYgaWRvIHZpc2libGUtbWFy ayBlYXN5LW1tb2RlIGZseWNoZWNrIGNsLWV4dHJhIGpzb24gbWFwPGJyPg0KPC9kaXY+DQo8ZGl2 PmZpbmQtZnVuYyBoZWxwLW1vZGUgc3Vici14IGRhc2ggY3VzLXN0YXJ0IGN1cy1sb2FkIHByb2pl Y3RpbGUgZ3JlcDxicj4NCjwvZGl2Pg0KPGRpdj5jb21waWxlIGNvbWludCBhbnNpLWNvbG9yIHJp bmcgaWJ1Zi1leHQgaWJ1ZmZlciBpYnVmZmVyLWxvYWRkZWZzPGJyPg0KPC9kaXY+DQo8ZGl2PnRo aW5nYXRwdCBkb29tLXRoZW1lcyBkb29tLXRoZW1lcy1jb21tb24gbW0tYXJjaGl2ZSBtZXNzYWdl IGRpcmVkPGJyPg0KPC9kaXY+DQo8ZGl2PmRpcmVkLWxvYWRkZWZzIGZvcm1hdC1zcGVjIHJmYzgy MiBtbWwgbW1sLXNlYyBlcGEgZGVyaXZlZCBlcGcgZ251cy11dGlsPGJyPg0KPC9kaXY+DQo8ZGl2 PnJtYWlsIHJtYWlsLWxvYWRkZWZzIG1haWxhYmJyZXYgZ21tLXV0aWxzIG1haWxoZWFkZXIgbW0t ZGVjb2RlIG1tLWJvZGllczxicj4NCjwvZGl2Pg0KPGRpdj5tbS1lbmNvZGUgbWFpbC11dGlscyBu ZXR3b3JrLXN0cmVhbSBzdGFydHRscyB1cmwtaHR0cCB0bHMgZ251dGxzPGJyPg0KPC9kaXY+DQo8 ZGl2Pm1haWwtcGFyc2UgcmZjMjIzMSByZmMyMDQ3IHJmYzIwNDUgbW0tdXRpbCBpZXRmLWRydW1z IG1haWwtcHJzdnIgdXJsLWd3PGJyPg0KPC9kaXY+DQo8ZGl2Pm5zbSBybWMgcHVueSB1cmwtY2Fj aGUgdXJsLWF1dGggdXJsIHVybC1wcm94eSB1cmwtcHJpdmFjeSB1cmwtZXhwYW5kPGJyPg0KPC9k aXY+DQo8ZGl2PnVybC1tZXRob2RzIHVybC1oaXN0b3J5IHVybC1jb29raWUgdXJsLWRvbXN1ZiB1 cmwtdXRpbCBtYWlsY2FwPGJyPg0KPC9kaXY+DQo8ZGl2PmZpbmRlci1pbmYgZ2gtY29tbW9uIG1h cnNoYWwgZWllaW8tY29tcGF0IHJ4IHNseS1hdXRvbG9hZHMgaW5mbyBwYWNrYWdlPGJyPg0KPC9k aXY+DQo8ZGl2PmVhc3ltZW51IGVwZy1jb25maWcgdXJsLWhhbmRsZXJzIHVybC1wYXJzZSBhdXRo LXNvdXJjZSBjbC1zZXEgZWllaW88YnI+DQo8L2Rpdj4NCjxkaXY+ZWllaW8tY29yZSBjbC1tYWNz IGVpZWlvLWxvYWRkZWZzIHBhc3N3b3JkLWNhY2hlIHVybC12YXJzIHNlcSBieXRlLW9wdDxicj4N CjwvZGl2Pg0KPGRpdj5ndiBieXRlY29tcCBieXRlLWNvbXBpbGUgY2NvbnYgY2wtbG9hZGRlZnMg Y2wtbGliIHRpbWUtZGF0ZSBtdWxlLXV0aWw8YnI+DQo8L2Rpdj4NCjxkaXY+dG9vbHRpcCBlbGRv YyBlbGVjdHJpYyB1bmlxdWlmeSBlZGlmZi1ob29rIHZjLWhvb2tzIGxpc3AtZmxvYXQtdHlwZTxi cj4NCjwvZGl2Pg0KPGRpdj5td2hlZWwgZG9zLXczMiBscy1saXNwIGRpc3AtdGFibGUgdGVybS93 MzItd2luIHczMi13aW4gdzMyLXZhcnM8YnI+DQo8L2Rpdj4NCjxkaXY+dGVybS9jb21tb24td2lu IHRvb2wtYmFyIGRuZCBmb250c2V0IGltYWdlIHJlZ2V4cC1vcHQgZnJpbmdlPGJyPg0KPC9kaXY+ DQo8ZGl2PnRhYnVsYXRlZC1saXN0IHJlcGxhY2UgbmV3Y29tbWVudCB0ZXh0LW1vZGUgZWxpc3At bW9kZSBsaXNwLW1vZGU8YnI+DQo8L2Rpdj4NCjxkaXY+cHJvZy1tb2RlIHJlZ2lzdGVyIHBhZ2Ug bWVudS1iYXIgcmZuLWVzaGFkb3cgaXNlYXJjaCB0aW1lciBzZWxlY3Q8YnI+DQo8L2Rpdj4NCjxk aXY+c2Nyb2xsLWJhciBtb3VzZSBqaXQtbG9jayBmb250LWxvY2sgc3ludGF4IGZhY2VtZW51IGZv bnQtY29yZTxicj4NCjwvZGl2Pg0KPGRpdj50ZXJtL3R0eS1jb2xvcnMgZnJhbWUgY2wtZ2VuZXJp YyBjaGFtIGdlb3JnaWFuIHV0Zi04LWxhbmcgbWlzYy1sYW5nPGJyPg0KPC9kaXY+DQo8ZGl2PnZp ZXRuYW1lc2UgdGliZXRhbiB0aGFpIHRhaS12aWV0IGxhbyBrb3JlYW4gamFwYW5lc2UgZXVjanAt bXMgY3A1MTkzMjxicj4NCjwvZGl2Pg0KPGRpdj5oZWJyZXcgZ3JlZWsgcm9tYW5pYW4gc2xvdmFr IGN6ZWNoIGV1cm9wZWFuIGV0aGlvcGljIGluZGlhbiBjeXJpbGxpYzxicj4NCjwvZGl2Pg0KPGRp dj5jaGluZXNlIGNvbXBvc2l0ZSBjaGFyc2NyaXB0IGNoYXJwcm9wIGNhc2UtdGFibGUgZXBhLWhv b2sgamthLWNtcHItaG9vazxicj4NCjwvZGl2Pg0KPGRpdj5oZWxwIHNpbXBsZSBhYmJyZXYgb2Jh cnJheSBtaW5pYnVmZmVyIGNsLXByZWxvYWRlZCBuYWR2aWNlIGxvYWRkZWZzPGJyPg0KPC9kaXY+ DQo8ZGl2PmJ1dHRvbiBmYWNlcyBjdXMtZmFjZSBtYWNyb2V4cCBmaWxlcyB0ZXh0LXByb3BlcnRp ZXMgb3ZlcmxheSBzaGExIG1kNTxicj4NCjwvZGl2Pg0KPGRpdj5iYXNlNjQgZm9ybWF0IGVudiBj b2RlLXBhZ2VzIG11bGUgY3VzdG9tIHdpZGdldCBoYXNodGFibGUtcHJpbnQtcmVhZGFibGU8YnI+ DQo8L2Rpdj4NCjxkaXY+YmFja3F1b3RlIHczMm5vdGlmeSB3MzIgbGNtczIgbXVsdGktdHR5IG1h a2UtbmV0d29yay1wcm9jZXNzIGVtYWNzKTxicj4NCjwvZGl2Pg0KPGRpdj48YnI+DQo8L2Rpdj4N CjxkaXY+TWVtb3J5IGluZm9ybWF0aW9uOjxicj4NCjwvZGl2Pg0KPGRpdj4oKGNvbnNlcyAxNiAx NzA5NzM2IDI4MTQ1Mik8YnI+DQo8L2Rpdj4NCjxkaXY+Jm5ic3A7KHN5bWJvbHMgNTYgNzE2ODUg MSk8YnI+DQo8L2Rpdj4NCjxkaXY+Jm5ic3A7KG1pc2NzIDQ4IDM1OTIgMzYyKTxicj4NCjwvZGl2 Pg0KPGRpdj4mbmJzcDsoc3RyaW5ncyAzMiAyNTA2ODggNzkyNzYpPGJyPg0KPC9kaXY+DQo8ZGl2 PiZuYnNwOyhzdHJpbmctYnl0ZXMgMSA3NzcxNjMwKTxicj4NCjwvZGl2Pg0KPGRpdj4mbmJzcDso dmVjdG9ycyAxNiAxMzk1MjUpPGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyh2ZWN0b3Itc2xvdHMg OCAyOTg3MTYyIDc1MTYpPGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyhmbG9hdHMgOCAxNTQ0IDM1 NDIpPGJyPg0KPC9kaXY+DQo8ZGl2PiZuYnNwOyhpbnRlcnZhbHMgNTYgMTg4NDQgNzgyMCk8YnI+ DQo8L2Rpdj4NCjxkaXY+Jm5ic3A7KGJ1ZmZlcnMgOTkyIDk3KSk8YnI+DQo8L2Rpdj4NCjxzcGFu Pjwvc3Bhbj48YnI+DQo8L2Rpdj4NCjwvYm9keT4NCjwvaHRtbD4NCg== --_000_BN8PR04MB555503D4DD1283F20EAC7C578B4A0BN8PR04MB5555namp_-- From unknown Sun Aug 17 10:17:20 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34842: 26.1; Alist documentation: let-alist Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 13 Mar 2019 15:17:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34842 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: =?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?= , 34842@debbugs.gnu.org Received: via spool by 34842-submit@debbugs.gnu.org id=B34842.155249019911057 (code B ref 34842); Wed, 13 Mar 2019 15:17:01 +0000 Received: (at 34842) by debbugs.gnu.org; 13 Mar 2019 15:16:39 +0000 Received: from localhost ([127.0.0.1]:42242 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h45cU-0002sG-BX for submit@debbugs.gnu.org; Wed, 13 Mar 2019 11:16:38 -0400 Received: from userp2120.oracle.com ([156.151.31.85]:37682) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h45cS-0002s2-B9 for 34842@debbugs.gnu.org; Wed, 13 Mar 2019 11:16:36 -0400 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x2DF9BiM003342; Wed, 13 Mar 2019 15:16:30 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=ZcuIKLUJ8+q8vveBuf5SK+rVwRYeEAt5df4o8BaZWhY=; b=PEs3ZeEYMJVkiXaXDQqTJBfFWtt8fcNjW7jSHz+2kDVEUf2imppArfzj3tBwEdjaIqDU 1F22N0a/KAAEcHYzHeqCEK8hSXqTw97p/SCItjhvcfWvQGju4iB4qshg4mZ6JmUnb14c 3WtrqzYtxC1BAIox3cHFSaESPWETyrEKN8LSLQSRLk1e0AbGxY7lIUJrCiLBoZQ50AZK lTVCQwG+xxC7HjqWG1Ld9gfzFzKj1iB1r6ydIFeQ1TmgznD86Ts9IizwOxScO2S9VtbD HSN4YJGKutKQtxg3tS0ppVDKImDW7jD3MfMW/NNcXN0JZ7rZyUmK+RX3UqG1OOR/Zor6 6w== Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp2120.oracle.com with ESMTP id 2r464rkjew-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 13 Mar 2019 15:16:30 +0000 Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0022.oracle.com (8.14.4/8.14.4) with ESMTP id x2DFGTrm013523 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 13 Mar 2019 15:16:29 GMT Received: from abhmp0006.oracle.com (abhmp0006.oracle.com [141.146.116.12]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id x2DFGS8S015160; Wed, 13 Mar 2019 15:16:29 GMT MIME-Version: 1.0 Message-ID: <3c296021-c231-4c62-b8e3-0e870cb224cc@default> Date: Wed, 13 Mar 2019 08:16:28 -0700 (PDT) From: Drew Adams References: In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4822.0 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9194 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1903130109 X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > In [(elisp)`Association Lists']=C2=A0we should add some > documentation about [macro `let-alist']. Below a > suggestion. 1. I agree that it might be good to document this macro in node `Association Lists'. 2. But the example suggested is much less clear than the example in the doc string. 3. The example in the doc string is itself not correct. Instead of "essentially" it should just show the actual macroexpansion. And it should use a different variable name than `alist'. E.g.: (let-alist my-alist (if (and .title .body) .body .site .site.contents)) expands to: (let ((alist my-alist)) (let ((\.title (cdr (assq 'title alist))) (\.body (cdr (assq 'body alist))) (\.site (cdr (assq 'site alist))) (\.site\.contents (cdr (assq 'contents (cdr (assq 'site alist)))))) (if (and \.title \.body) \.body \.site \.site\.contents))) (And yes, the backslashes are necessary.) 4. The last paragraph of the doc string is unclear. What does "access alists inside the original alist" mean? How is anything it tries to describe "displayed in the example above", which has NO nesting of `let-alist'? Whatever it might be trying to say, if the point of the last paragraph is important, then perhaps an example of such nesting is called for, pointing out what is meant. Perhaps such a paragraph and example don't need to be in both the doc string and the manual (dunno how important this is, not knowing what it's really trying to say). 5. The doc (manual and doc string) should explicitly say that `assq' is used, not `assoc'. It should not just hand-wave about this, saying "search is done". And it should say what it means by "this search is done at compile time" - what the consequences of this are. From unknown Sun Aug 17 10:17:20 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34842: 26.1; Alist documentation: let-alist Resent-From: =?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?= Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 13 Mar 2019 17:25:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34842 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "34842@debbugs.gnu.org" <34842@debbugs.gnu.org> Received: via spool by 34842-submit@debbugs.gnu.org id=B34842.155249789923389 (code B ref 34842); Wed, 13 Mar 2019 17:25:01 +0000 Received: (at 34842) by debbugs.gnu.org; 13 Mar 2019 17:24:59 +0000 Received: from localhost ([127.0.0.1]:42440 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h47cf-000658-Kn for submit@debbugs.gnu.org; Wed, 13 Mar 2019 13:24:59 -0400 Received: from mail-oln040092006041.outbound.protection.outlook.com ([40.92.6.41]:50807 helo=NAM03-BY2-obe.outbound.protection.outlook.com) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h46ls-0004nI-89 for 34842@debbugs.gnu.org; Wed, 13 Mar 2019 12:30:27 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=outlook.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Pk65wkZXQnHp6O/HKVkIqYJhIubsQlFMFJmsXsvmv3U=; b=e1uP93SQwlYVLfLCT+UPRN+mKUK6kFmPTdpwYJuN25RqJoCFiE5+2FBBJD0+szdZLoZInyx4iCqT048xw7Wr9+wCWDYDfxUdFzq5rnNgFESnIa49pDYxyHU8k/ONQivQ+IH3rJCuPN/Aq9b5SS6bMlETb4pTvlcyFJ2mRgi8AGv8TCSjCyEHoGDTV7BBunpkXL6tksyAPz85kf9H+S06Z5zUyntFgAV/cMrJr2WCb+LeHBTDFK1+V3Iy/aNHyK5hhIICvXAMMvhUyDHhsVlutao1jdI7rh3qB41EpEVb6a5SH9SwHLUoP23Oyfv8YmUMCDJQZ3K66uLLpocWyB1nlQ== Received: from CO1NAM03FT014.eop-NAM03.prod.protection.outlook.com (10.152.80.52) by CO1NAM03HT039.eop-NAM03.prod.protection.outlook.com (10.152.81.45) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.1686.19; Wed, 13 Mar 2019 16:30:17 +0000 Received: from BN8PR04MB5555.namprd04.prod.outlook.com (10.152.80.53) by CO1NAM03FT014.mail.protection.outlook.com (10.152.80.101) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.1709.13 via Frontend Transport; Wed, 13 Mar 2019 16:30:17 +0000 Received: from BN8PR04MB5555.namprd04.prod.outlook.com ([fe80::890f:1d5c:65a6:f0d3]) by BN8PR04MB5555.namprd04.prod.outlook.com ([fe80::890f:1d5c:65a6:f0d3%3]) with mapi id 15.20.1686.021; Wed, 13 Mar 2019 16:30:17 +0000 From: =?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?= Thread-Topic: bug#34842: 26.1; Alist documentation: let-alist Thread-Index: AQHU2WfoQNkpN7Cxwka7S9tpV8PRbKYJrKYAgAAUn+s= Date: Wed, 13 Mar 2019 16:30:16 +0000 Message-ID: References: , <3c296021-c231-4c62-b8e3-0e870cb224cc@default> In-Reply-To: <3c296021-c231-4c62-b8e3-0e870cb224cc@default> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-incomingtopheadermarker: OriginalChecksum:103EA529AD4B56DB7D73510CE8EC58B7324914DA93A97040E6CCB842E8ECAC5D; UpperCasedChecksum:70F4D6616EDD4243D69B5583D8AF069F126749D6B9361CB25A1D3914B0A08AE1; SizeAsReceived:6897; Count:44 x-ms-exchange-messagesentrepresentingtype: 1 x-tmn: [hg3wgY7uFsKs3PSaFvG0GEfiRE6POdaO] x-ms-publictraffictype: Email x-incomingheadercount: 44 x-eopattributedmessage: 0 x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(20181119110)(201702061078)(5061506573)(5061507331)(1603103135)(2017031320274)(2017031323274)(2017031324274)(2017031322404)(1601125500)(1603101475)(1701031045); SRVR:CO1NAM03HT039; x-ms-traffictypediagnostic: CO1NAM03HT039: x-microsoft-antispam-message-info: 1CixYHOLR06ewyo1tAvJq9jykyX5Hurg6Noyg1JL+LzX7RBo64tAlbu8hbUKi5aX Content-Type: multipart/alternative; boundary="_000_BN8PR04MB5555A95657B2651F4689FE408B4A0BN8PR04MB5555namp_" MIME-Version: 1.0 X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-CrossTenant-Network-Message-Id: 550c2c20-7d69-46e7-c6cf-08d6a7d12d61 X-MS-Exchange-CrossTenant-rms-persistedconsumerorg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-CrossTenant-originalarrivaltime: 13 Mar 2019 16:30:17.0539 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Internet X-MS-Exchange-CrossTenant-id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO1NAM03HT039 X-Spam-Score: 0.0 (/) X-Mailman-Approved-At: Wed, 13 Mar 2019 13:24:56 -0400 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --_000_BN8PR04MB5555A95657B2651F4689FE408B4A0BN8PR04MB5555namp_ Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable I thought that the example in the docstring was too long compared to the sm= aller/simpler examples in the rest of the page, but wouldn't be against usi= ng that instead if it's more clear. The nested access example is in .site.contents, maybe being explicit about = which line displays the concept would be a nice improvement. And most of what you said in point 5 is above my level so I will defer to p= eople with more knowledge. Thank you for your feedback Drew! --------------------------------------------------- Why Emacs? http://david.rothlis.net/emacs/why.html From: Drew Adams Sent: Wednesday, March 13, 9:16 AM Subject: RE: bug#34842: 26.1; Alist documentation: let-alist To: Sebasti=E1n Mon=EDa, 34842@debbugs.gnu.org > In [(elisp)`Association Lists'] we should add some > documentation about = [macro `let-alist']. Below a > suggestion. 1. I agree that it might be good= to document this macro in node `Association Lists'. 2. But the example sug= gested is much less clear than the example in the doc string. 3. The exampl= e in the doc string is itself not correct. Instead of "essentially" it shou= ld just show the actual macroexpansion. And it should use a different varia= ble name than `alist'. E.g.: (let-alist my-alist (if (and .title .body) .bo= dy .site .site.contents)) expands to: (let ((alist my-alist)) (let ((\.titl= e (cdr (assq 'title alist))) (\.body (cdr (assq 'body alist))) (\.site (cdr= (assq 'site alist))) (\.site\.contents (cdr (assq 'contents (cdr (assq 'si= te alist)))))) (if (and \.title \.body) \.body \.site \.site\.contents))) (= And yes, the backslashes are necessary.) 4. The last paragraph of the doc s= tring is unclear. What does "access alists inside the original alist" mean?= How is anything it tries to describe "displayed in the example above", whi= ch has NO nesting of `let-alist'? Whatever it might be trying to say, if th= e point of the last paragraph is important, then perhaps an example of such= nesting is called for, pointing out what is meant. Perhaps such a paragrap= h and example don't need to be in both the doc string and the manual (dunno= how important this is, not knowing what it's really trying to say). 5. The= doc (manual and doc string) should explicitly say that `assq' is used, not= `assoc'. It should not just hand-wave about this, saying "search is done".= And it should say what it means by "this search is done at compile time" -= what the consequences of this are. --_000_BN8PR04MB5555A95657B2651F4689FE408B4A0BN8PR04MB5555namp_ Content-Type: text/html; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable
I thought that the example in the docstring was too long compared to the sm= aller/simpler examples in the rest of the page, but wouldn't be against usi= ng that instead if it's more clear.

The nested access example is in .site.contents, maybe being explicit about = which line displays the concept would be a nice improvement.

And most of what you said in point 5 is above my level so I will defer to p= eople with more knowledge.

Thank you for your feedback Drew!

---------------------------------------------------
Why Emacs? 



From: Drew Adams
Sent: Wednesday, March 13, 9:16 AM
Subject: RE: bug#34842: 26.1; Alist documentation: let-alist
To: Sebasti=E1n Mon=EDa, 34842@debbugs.gnu.org


> In [(elisp)`Association Lists'] we should add some > documenta= tion about [macro `let-alist']. Below a > suggestion. 1. I agree that it= might be good to document this macro in node `Association Lists'. 2. But t= he example suggested is much less clear than the example in the doc string. 3. The example in the doc string is itself not = correct. Instead of "essentially" it should just show the actual = macroexpansion. And it should use a different variable name than `alist'. E= .g.: (let-alist my-alist (if (and .title .body) .body .site .site.contents)) expands to: (let ((alist my-alist)) (let ((\.= title (cdr (assq 'title alist))) (\.body (cdr (assq 'body alist))) (\.site = (cdr (assq 'site alist))) (\.site\.contents (cdr (assq 'contents (cdr (assq= 'site alist)))))) (if (and \.title \.body) \.body \.site \.site\.contents))) (And yes, the backslashes are ne= cessary.) 4. The last paragraph of the doc string is unclear. What does &qu= ot;access alists inside the original alist" mean? How is anything it t= ries to describe "displayed in the example above", which has NO nesting of `let-alist'? Whatever it might be try= ing to say, if the point of the last paragraph is important, then perhaps a= n example of such nesting is called for, pointing out what is meant. Perhap= s such a paragraph and example don't need to be in both the doc string and the manual (dunno how important this= is, not knowing what it's really trying to say). 5. The doc (manual and do= c string) should explicitly say that `assq' is used, not `assoc'. It should= not just hand-wave about this, saying "search is done". And it should say what it means by &quo= t;this search is done at compile time" - what the consequences of this= are.

--_000_BN8PR04MB5555A95657B2651F4689FE408B4A0BN8PR04MB5555namp_-- From unknown Sun Aug 17 10:17:20 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34842: 26.1; Alist documentation: let-alist Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 13 Mar 2019 17:52:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34842 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: =?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?= , 34842@debbugs.gnu.org Received: via spool by 34842-submit@debbugs.gnu.org id=B34842.155249950626028 (code B ref 34842); Wed, 13 Mar 2019 17:52:01 +0000 Received: (at 34842) by debbugs.gnu.org; 13 Mar 2019 17:51:46 +0000 Received: from localhost ([127.0.0.1]:42478 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h482c-0006lk-CG for submit@debbugs.gnu.org; Wed, 13 Mar 2019 13:51:46 -0400 Received: from userp2120.oracle.com ([156.151.31.85]:43374) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h482a-0006lI-7G for 34842@debbugs.gnu.org; Wed, 13 Mar 2019 13:51:44 -0400 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x2DHnMFD157680; Wed, 13 Mar 2019 17:51:38 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=ilHYnBYEl9SU3IQla2FhDck9d8QTUVPIkbrC5aDzvpE=; b=IYKIS0U25HThtsiwJC1UKiW6fvmnjWA6grDrpACLbHU/TSRAKpwRViukPR5Jbuzg986T HJTFXYlC1E5xsn6AuK6UFJhESyU2zpyVnzYqxKML2gDjO8LgmwC00gTW5Hlcwz0gcGnG O0AnlcAr//M2uPMHCTc5uDFvc9zbGOPICJNzOXL+oO/8x9tUxEjtpsmsOumLXta9zV3B zFkWiqGaINDO2eDiyB7nO7nTgN6L1qPCxFBj6BubqkshcdSta4ofYYU/Km49z2m+vRge rhgPjaZ3uNRo5EfmMliUdD5sf87zEqu7vzJvQcfmPGJhh/S8cvqbWv9EljVCipXD7eir rw== Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp2120.oracle.com with ESMTP id 2r464rmjgh-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 13 Mar 2019 17:51:37 +0000 Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id x2DHpa0k030710 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 13 Mar 2019 17:51:37 GMT Received: from abhmp0006.oracle.com (abhmp0006.oracle.com [141.146.116.12]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id x2DHpaW8025895; Wed, 13 Mar 2019 17:51:36 GMT MIME-Version: 1.0 Message-ID: <1fa49979-2e67-44bd-86cd-080bb9f7e1de@default> Date: Wed, 13 Mar 2019 10:51:36 -0700 (PDT) From: Drew Adams References: > <3c296021-c231-4c62-b8e3-0e870cb224cc@default> In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4822.0 (x86)] Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9194 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=843 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1903130124 X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Thanks for filing the bug, BTW. > I thought that the example in the docstring was > too long compared to the smaller/simpler examples > in the rest of the page, but wouldn't be against > using that instead if it's more clear.=20 The example could be shorter, yes. But it needs to be correct and show what `let-alist' does. > The nested access example is in .site.contents, But the doc talks about nested uses of `let-alist'. There is only one `let-alist' in the example that the doc claims shows the behavior of nesting `let-alist'. From unknown Sun Aug 17 10:17:20 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34842: 26.1; Alist documentation: let-alist Resent-From: =?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?= Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 14 Mar 2019 04:48:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34842 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "34842@debbugs.gnu.org" <34842@debbugs.gnu.org> Received: via spool by 34842-submit@debbugs.gnu.org id=B34842.155253883522848 (code B ref 34842); Thu, 14 Mar 2019 04:48:02 +0000 Received: (at 34842) by debbugs.gnu.org; 14 Mar 2019 04:47:15 +0000 Received: from localhost ([127.0.0.1]:42725 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h4IGw-0005wR-GL for submit@debbugs.gnu.org; Thu, 14 Mar 2019 00:47:14 -0400 Received: from mail-oln040092005032.outbound.protection.outlook.com ([40.92.5.32]:59798 helo=NAM02-SN1-obe.outbound.protection.outlook.com) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h4IGu-0005wB-PI for 34842@debbugs.gnu.org; Thu, 14 Mar 2019 00:47:13 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=outlook.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=rwr1SSUAJs1QOcj8x9MhZLR9bh9tNPbuK9GI0naMkg8=; b=FrahAQ5yr8QpwjnJvJTrwo/GHs0RPbzPewmNLSrRgzJIULL/4yXAaXeuXwXyJXM4qHCYhwobY7zf+/Gg+yMaiTPddV8+ZxkU23UZ3yif8rEPNcLbmSjjVRGbZ3hZ7vtqfu+LlDepk5/a7WXq3XSmcwxcZTB7LuCyiOdRfmgCGURo7Js9qPn5KQ5c2bAQGaoIAsJGuN8gnj37FbWS5ZaCkafT/djDb4Gfvyrml73KkD86pF5A1P0FkeX6duGCL+/hrmzfzszGdDRv4Z4Wj+9hOGs6l6Pg5bek3NsTEeA9HD9M8249M+EqbI2Heh5I5gKQ7i06dBoXzOvlJuZUCemhXA== Received: from BL2NAM02FT056.eop-nam02.prod.protection.outlook.com (10.152.76.56) by BL2NAM02HT174.eop-nam02.prod.protection.outlook.com (10.152.77.10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1686.19; Thu, 14 Mar 2019 04:47:05 +0000 Received: from BN8PR04MB5555.namprd04.prod.outlook.com (10.152.76.56) by BL2NAM02FT056.mail.protection.outlook.com (10.152.77.221) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1686.19 via Frontend Transport; Thu, 14 Mar 2019 04:47:06 +0000 Received: from BN8PR04MB5555.namprd04.prod.outlook.com ([fe80::890f:1d5c:65a6:f0d3]) by BN8PR04MB5555.namprd04.prod.outlook.com ([fe80::890f:1d5c:65a6:f0d3%3]) with mapi id 15.20.1686.021; Thu, 14 Mar 2019 04:47:05 +0000 From: =?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?= Thread-Topic: bug#34842: 26.1; Alist documentation: let-alist Thread-Index: AQHU2WfoQNkpN7Cxwka7S9tpV8PRbKYJrKYAgAAUn+uAABa5AIAAtyOc Date: Thu, 14 Mar 2019 04:47:05 +0000 Message-ID: References: > <3c296021-c231-4c62-b8e3-0e870cb224cc@default> , <1fa49979-2e67-44bd-86cd-080bb9f7e1de@default> In-Reply-To: <1fa49979-2e67-44bd-86cd-080bb9f7e1de@default> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-incomingtopheadermarker: OriginalChecksum:971221099B9269B35864B760771A12C92C03C3AE66E1E7998F7A42D04B05CB10; UpperCasedChecksum:CEB0FD8A312FBA73130F8E0381014D3CC17650EF2052CC2F9F28C71B6D99FC52; SizeAsReceived:7049; Count:44 x-ms-exchange-messagesentrepresentingtype: 1 x-tmn: [j1LfxDLN5BMe+r/hC9k4ZA9/fUslgIxW] x-ms-publictraffictype: Email x-incomingheadercount: 44 x-eopattributedmessage: 0 x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(20181119110)(201702061078)(5061506573)(5061507331)(1603103135)(2017031320274)(2017031322404)(2017031323274)(2017031324274)(1601125500)(1603101475)(1701031045); SRVR:BL2NAM02HT174; x-ms-traffictypediagnostic: BL2NAM02HT174: x-microsoft-antispam-message-info: eEbOHvMONu2lRCI/jYoqSTqcuK4BiGInb4uA1O7gArjdQu5zjMscdDh2gEO2da99 Content-Type: multipart/alternative; boundary="_000_BN8PR04MB5555A6BF2B41241F94807CAA8B4B0BN8PR04MB5555namp_" MIME-Version: 1.0 X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-CrossTenant-Network-Message-Id: 28f9957e-9f81-4ad1-7c27-08d6a8381be3 X-MS-Exchange-CrossTenant-rms-persistedconsumerorg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-CrossTenant-originalarrivaltime: 14 Mar 2019 04:47:05.8261 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Internet X-MS-Exchange-CrossTenant-id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL2NAM02HT174 X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --_000_BN8PR04MB5555A6BF2B41241F94807CAA8B4B0BN8PR04MB5555namp_ Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable I think when it says nested let-alist uses, it refers to the fact that let-= alist automatically went to the next level of depth to provide a binding fo= r .title Without that feature you would need a second let-alist: (let-alist .company= # more code here) Sorry for the lack of formatting I'm on mobile. Hope that made sense! --------------------------------------------------- Why Emacs? http://david.rothlis.net/emacs/why.html From: Drew Adams Sent: Wednesday, March 13, 11:51 AM Subject: RE: bug#34842: 26.1; Alist documentation: let-alist To: Sebasti=E1n Mon=EDa, 34842@debbugs.gnu.org Thanks for filing the bug, BTW. > I thought that the example in the docstri= ng was > too long compared to the smaller/simpler examples > in the rest of= the page, but wouldn't be against > using that instead if it's more clear.= The example could be shorter, yes. But it needs to be correct and show wha= t `let-alist' does. > The nested access example is in .site.contents, But t= he doc talks about nested uses of `let-alist'. There is only one `let-alist= ' in the example that the doc claims shows the behavior of nesting `let-ali= st'. --_000_BN8PR04MB5555A6BF2B41241F94807CAA8B4B0BN8PR04MB5555namp_ Content-Type: text/html; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable
I think when it says nested let-alist uses, it refers to the fact that let-= alist automatically went to the next level of depth to provide a binding fo= r .title

Without that feature you would need a second let-alist: (let-alist .company= # more code here)

Sorry for the lack of formatting I'm on mobile. Hope that made sense!

---------------------------------------------------
Why Emacs? 



From: Drew Adams
Sent: Wednesday, March 13, 11:51 AM
Subject: RE: bug#34842: 26.1; Alist documentation: let-alist
To: Sebasti=E1n Mon=EDa, 34842@debbugs.gnu.org


Thanks for filing the bug, BTW. > I thought that the example in the docs= tring was > too long compared to the smaller/simpler examples > in th= e rest of the page, but wouldn't be against > using that instead if it's= more clear. The example could be shorter, yes. But it needs to be correct and show what `let-alist' does. > The nested= access example is in .site.contents, But the doc talks about nested uses o= f `let-alist'. There is only one `let-alist' in the example that the doc cl= aims shows the behavior of nesting `let-alist'.

--_000_BN8PR04MB5555A6BF2B41241F94807CAA8B4B0BN8PR04MB5555namp_-- From unknown Sun Aug 17 10:17:20 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34842: 26.1; Alist documentation: let-alist Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 12 Oct 2019 23:33:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34842 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: =?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?= Cc: 34842@debbugs.gnu.org Received: via spool by 34842-submit@debbugs.gnu.org id=B34842.157092313230506 (code B ref 34842); Sat, 12 Oct 2019 23:33:01 +0000 Received: (at 34842) by debbugs.gnu.org; 12 Oct 2019 23:32:12 +0000 Received: from localhost ([127.0.0.1]:34483 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJQrr-0007vy-K7 for submit@debbugs.gnu.org; Sat, 12 Oct 2019 19:32:11 -0400 Received: from quimby.gnus.org ([80.91.231.51]:42682) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJQrp-0007vl-E3 for 34842@debbugs.gnu.org; Sat, 12 Oct 2019 19:32:09 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iJQrl-0001RA-7U; Sun, 13 Oct 2019 01:32:07 +0200 From: Lars Ingebrigtsen References: Date: Sun, 13 Oct 2019 01:32:04 +0200 In-Reply-To: ("=?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?="'s message of "Wed, 13 Mar 2019 14:16:15 +0000") Message-ID: <87eezhh763.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: =?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?= writes: > The macro let-alist is too useful to work with JSON-parsed data for it to be > missing from the docs. > > In the page > https://www.gnu.org/software/emacs/manual/html_node/elisp/Association-Lists.ht [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Sebasti=C3=A1n Mon=C3=ADa writes: > The macro let-alist is too useful to work with JSON-parsed data for it to= be > missing from the docs. > > In the page > https://www.gnu.org/software/emacs/manual/html_node/elisp/Association-Lis= ts.html > we should add some documentation about it. Below a suggestion. > > Thank you! > > =E2=80=94 Macro: let-alist `value` > Creates a binding for each symbol in the association list `value`, prefix= ed with > dot. This is very useful when accessing several items in the same alist, = and it's > best understood through a simple example: > > (setq colors '((rose red) (lily white) (buttercup yellow))) > (let-alist colors > (print .rose) > (print .buttercup)) > =E2=87=92 red > =E2=87=92 yellow Even though I question the usefulness of this macro (especially since it doesn't nest well, so it seems just kinda ad-hoc), I've now documented it along the lines you suggest. Drew wanted the manual to describe more fully the actual details behind the implementation, but I think that doesn't add much clarity. --=20 (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Sat Oct 12 19:32:17 2019 Received: (at control) by debbugs.gnu.org; 12 Oct 2019 23:32:17 +0000 Received: from localhost ([127.0.0.1]:34486 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJQrx-0007wG-0I for submit@debbugs.gnu.org; Sat, 12 Oct 2019 19:32:17 -0400 Received: from quimby.gnus.org ([80.91.231.51]:42696) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJQrv-0007w7-1B for control@debbugs.gnu.org; Sat, 12 Oct 2019 19:32:15 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iJQrs-0001RI-9R for control@debbugs.gnu.org; Sun, 13 Oct 2019 01:32:14 +0200 Date: Sun, 13 Oct 2019 01:32:11 +0200 Message-Id: <87d0f1h75w.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #34842 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: tags 34842 fixed close 34842 27.1 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) tags 34842 fixed close 34842 27.1 quit From unknown Sun Aug 17 10:17:20 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34842: 26.1; Alist documentation: let-alist Resent-From: "Basil L. Contovounesios" Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 13 Oct 2019 02:04:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34842 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed To: Lars Ingebrigtsen Cc: 34842@debbugs.gnu.org, =?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?= Received: via spool by 34842-submit@debbugs.gnu.org id=B34842.15709322013972 (code B ref 34842); Sun, 13 Oct 2019 02:04:02 +0000 Received: (at 34842) by debbugs.gnu.org; 13 Oct 2019 02:03:21 +0000 Received: from localhost ([127.0.0.1]:34637 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJTE6-00011x-K4 for submit@debbugs.gnu.org; Sat, 12 Oct 2019 22:03:19 -0400 Received: from mail-wr1-f53.google.com ([209.85.221.53]:33851) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJTE3-00011h-N5 for 34842@debbugs.gnu.org; Sat, 12 Oct 2019 22:03:16 -0400 Received: by mail-wr1-f53.google.com with SMTP id j11so15740107wrp.1 for <34842@debbugs.gnu.org>; Sat, 12 Oct 2019 19:03: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; bh=+ebZRqyHvPncejgCp6ZVQH6d5TTBjqOZw/jyS+Q5rKM=; b=VnGUJgDb65Lujtq3uaeBqJLKysYDsfRm3+MyWpVPZNbmCGpOjCSMRS+Y6FJtjvsXsS 9CWtqaWXcKGxFN9/yzblA9earEs3bsCJ9jloZHoR3oPjRv1kwqccT96CRs/wd08J5YfY 07VfiHW2XDQiHpwd1kLAZ5w12mDIgUQI4Cb/DmLR/Y9u+LMDdFQkha0A+0/A5pCpMFOW eKVfQVALLZQmWxmDQ2bRf5ib5ZDWuI1IQcxdu5ZcFmkVsIH36C5uadAbVIZA2jYtv1Pq VWEkhj0kt4jbRuZwsNBxPu8SVokfaQSxPNUbEivli9ChrdVlgGCJSLZ9ZOOc4FFgS1jk kz3w== 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; bh=+ebZRqyHvPncejgCp6ZVQH6d5TTBjqOZw/jyS+Q5rKM=; b=lpMD2p5oMpXabafuQzYxmb6iNlZM5aqO55QWEX8Y3fn+4jQ6CPwxnFNJKoo0/yaZ8G MOykvtLS7V3eiRH0kP7fbood02MvogHEKsG7Fqy6NS51HJ8QRC9nq9SyCBshg5zE32w5 tBi+GnJI59WEfda2ge1D30YsnCa8HUgPy9bBO9PmK3XXRK8YcZqSxy5ZIy/x7aZK6ILP v9IfVlJSBQsE+0FTfy16kAqwc9MUd1wRe3dWAzw+DrMcb9/jHVmnKHFkXbMa6MQ7jrX+ avN1OqFOQ1M056KZYPOqKYHIi3irYT8Qa03JziM6zCaIRCWggRJKv506vfaxJklmQn4p NADQ== X-Gm-Message-State: APjAAAXs5vxWWGtRZ2AQCI7o/x7+jLOP3DfgExX6h3D1VSfIykXxWEXV nLN1y4YENT/gGmMnJlUfJX2iFw== X-Google-Smtp-Source: APXvYqyxsmFhr7olZppq8+r11MsKscJB8O6aI75fHIV6L9+z72NOv9LkXydb841dmuHUZOOXtMCQvg== X-Received: by 2002:adf:dd8b:: with SMTP id x11mr19453958wrl.113.1570932189855; Sat, 12 Oct 2019 19:03:09 -0700 (PDT) Received: from localhost ([2a02:8084:20e2:c380:92bd:1bfd:38fc:fae2]) by smtp.gmail.com with ESMTPSA id r18sm21689968wme.48.2019.10.12.19.03.08 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 12 Oct 2019 19:03:08 -0700 (PDT) From: "Basil L. Contovounesios" References: <87eezhh763.fsf@gnus.org> Date: Sun, 13 Oct 2019 03:03:07 +0100 In-Reply-To: <87eezhh763.fsf@gnus.org> (Lars Ingebrigtsen's message of "Sun, 13 Oct 2019 01:32:04 +0200") Message-ID: <871rvh9zc4.fsf@tcd.ie> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Lars Ingebrigtsen writes: > Sebasti=C3=A1n Mon=C3=ADa writes: > >> The macro let-alist is too useful to work with JSON-parsed data for it t= o be >> missing from the docs. >> >> In the page >> https://www.gnu.org/software/emacs/manual/html_node/elisp/Association-Li= sts.html >> we should add some documentation about it. Below a suggestion. >> >> Thank you! >> >> =E2=80=94 Macro: let-alist `value` >> Creates a binding for each symbol in the association list `value`, prefi= xed with >> dot. This is very useful when accessing several items in the same alist,= and it's >> best understood through a simple example: >> >> (setq colors '((rose red) (lily white) (buttercup yellow))) >> (let-alist colors >> (print .rose) >> (print .buttercup)) >> =E2=87=92 red >> =E2=87=92 yellow > > Even though I question the usefulness of this macro (especially since it > doesn't nest well, so it seems just kinda ad-hoc), I've now documented > it along the lines you suggest. Drew wanted the manual to describe more > fully the actual details behind the implementation, but I think that > doesn't add much clarity. Thanks. The following constitute what I think are some opportunities for clarifying the current doc. WDYT? --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=let-alist.diff diff --git a/doc/lispref/lists.texi b/doc/lispref/lists.texi index c06e95640d..00c2211c36 100644 --- a/doc/lispref/lists.texi +++ b/doc/lispref/lists.texi @@ -1781,39 +1781,51 @@ Association Lists @sc{car}. @end defun -@defmac let-alist alist body -Creates a binding for each symbol used as keys the association list -@var{alist}, prefixed with dot. This can be useful when accessing -several items in the same association list, and it's best understood -through a simple example: +@defmac let-alist alist body@dots{} +This macro sets up a local binding for each variable that is used in +@var{body} and whose name starts with a dot, and then evaluates +@var{body}. In each case the dot-prefixed variable is bound to the +value associated with its dot-less suffix in the association list +@var{alist}. + +This can be convenient when accessing several items in the same +association list, and is best understood through a simple example: @lisp (setq colors '((rose . red) (lily . white) (buttercup . yellow))) (let-alist colors (if (eq .rose 'red) .lily)) -=> white + @result{} white @end lisp -The @var{body} is inspected at compilation time, and only the symbols -that appear in @var{body} with a @samp{.} as the first character in -the symbol name will be bound. Finding the keys is done with -@code{assq}, and the @code{cdr} of the return value of this -@code{assq} is assigned as the value for the binding. +The @var{body} is inspected at compilation time, and only those +variables that appear in @var{body} and whose name starts with a +@samp{.} are bound. Each such @var{.symbol} is bound to the @sc{cdr} +of the first association for @var{symbol} in @var{alist} using +@code{assq}. If no such association exists, @var{.symbol} is bound to +@code{nil}: -Nested association lists is supported: +@lisp +(let-alist colors + .tulip) + @result{} nil +@end lisp + +Nested association lists are also supported by concatenating multiple +dot-prefixed symbols: @lisp (setq colors '((rose . red) (lily (belladonna . yellow) (brindisi . pink)))) (let-alist colors (if (eq .rose 'red) .lily.belladonna)) -=> yellow + @result{} yellow @end lisp -Nesting @code{let-alist} inside each other is allowed, but the code in -the inner @code{let-alist} can't access the variables bound by the -outer @code{let-alist}. +Nesting @code{let-alist} inside calls to itself is allowed, but the +@var{body} of the inner @code{let-alist} can't access the bindings set +up by the outer @code{let-alist}. @end defmac @node Property Lists --=-=-= Content-Type: text/plain -- Basil --=-=-=-- From unknown Sun Aug 17 10:17:20 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34842: 26.1; Alist documentation: let-alist Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 13 Oct 2019 02:49:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34842 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed To: "Basil L. Contovounesios" Cc: 34842@debbugs.gnu.org, =?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?= Received: via spool by 34842-submit@debbugs.gnu.org id=B34842.157093489915759 (code B ref 34842); Sun, 13 Oct 2019 02:49:02 +0000 Received: (at 34842) by debbugs.gnu.org; 13 Oct 2019 02:48:19 +0000 Received: from localhost ([127.0.0.1]:34661 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJTvf-000467-2m for submit@debbugs.gnu.org; Sat, 12 Oct 2019 22:48:19 -0400 Received: from quimby.gnus.org ([80.91.231.51]:47108) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJTvc-00045y-Ld for 34842@debbugs.gnu.org; Sat, 12 Oct 2019 22:48:17 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iJTvY-0003Ya-K4; Sun, 13 Oct 2019 04:48:14 +0200 From: Lars Ingebrigtsen References: <87eezhh763.fsf@gnus.org> <871rvh9zc4.fsf@tcd.ie> Date: Sun, 13 Oct 2019 04:48:11 +0200 In-Reply-To: <871rvh9zc4.fsf@tcd.ie> (Basil L. Contovounesios's message of "Sun, 13 Oct 2019 03:03:07 +0100") Message-ID: <87a7a5e4yc.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: "Basil L. Contovounesios" writes: > Thanks. The following constitute what I think are some opportunities > for clarifying the current doc. WDYT? Looks good to me, but: Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) "Basil L. Contovounesios" writes: > Thanks. The following constitute what I think are some opportunities > for clarifying the current doc. WDYT? Looks good to me, but: > +@samp{.} are bound. Each such @var{.symbol} is bound to the @sc{cdr} > +of the first association for @var{symbol} in @var{alist} using > +@code{assq}. If no such association exists, @var{.symbol} is bound to > +@code{nil}: > > +@lisp > +(let-alist colors > + .tulip) > + @result{} nil > +@end lisp This bit seems superfluous. (cdr (assq ...)) is nil when no such association exists, but this makes it sound like that's a special case somehow... -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From unknown Sun Aug 17 10:17:20 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34842: 26.1; Alist documentation: let-alist Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 13 Oct 2019 07:17:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34842 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed To: Lars Ingebrigtsen Cc: contovob@tcd.ie, 34842@debbugs.gnu.org, seb.hoagie@outlook.com Received: via spool by 34842-submit@debbugs.gnu.org id=B34842.15709509638636 (code B ref 34842); Sun, 13 Oct 2019 07:17:01 +0000 Received: (at 34842) by debbugs.gnu.org; 13 Oct 2019 07:16:03 +0000 Received: from localhost ([127.0.0.1]:34843 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJY6h-0002Ee-Va for submit@debbugs.gnu.org; Sun, 13 Oct 2019 03:16:03 -0400 Received: from eggs.gnu.org ([209.51.188.92]:35745) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJY6f-0002EP-Td for 34842@debbugs.gnu.org; Sun, 13 Oct 2019 03:15:58 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:54745) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1iJY6a-0007Uk-6Z; Sun, 13 Oct 2019 03:15:52 -0400 Received: from [176.228.60.248] (port=2321 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1iJY6Z-0002u7-N7; Sun, 13 Oct 2019 03:15:52 -0400 Date: Sun, 13 Oct 2019 10:15:44 +0300 Message-Id: <83wod9kten.fsf@gnu.org> From: Eli Zaretskii In-reply-to: <87a7a5e4yc.fsf@gnus.org> (message from Lars Ingebrigtsen on Sun, 13 Oct 2019 04:48:11 +0200) References: <87eezhh763.fsf@gnus.org> <871rvh9zc4.fsf@tcd.ie> <87a7a5e4yc.fsf@gnus.org> MIME-version: 1.0 Content-type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Lars Ingebrigtsen > Date: Sun, 13 Oct 2019 04:48:11 +0200 > Cc: 34842@debbugs.gnu.org, Sebastián Monía > > > "Basil L. Contovounesios" writes: > > > Thanks. The following constitute what I think are some opportunities > > for clarifying the current doc. WDYT? > > Looks good to me, but: I have one more nit: why was @dots{} added after @var{body} in the @defmac line? There's only one body here, isn't it? Thanks. From unknown Sun Aug 17 10:17:20 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34842: 26.1; Alist documentation: let-alist Resent-From: "Basil L. Contovounesios" Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 13 Oct 2019 12:19:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34842 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed To: Lars Ingebrigtsen Cc: 34842@debbugs.gnu.org, =?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?= Received: via spool by 34842-submit@debbugs.gnu.org id=B34842.157096908414298 (code B ref 34842); Sun, 13 Oct 2019 12:19:02 +0000 Received: (at 34842) by debbugs.gnu.org; 13 Oct 2019 12:18:04 +0000 Received: from localhost ([127.0.0.1]:35310 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJcoz-0003iJ-OM for submit@debbugs.gnu.org; Sun, 13 Oct 2019 08:18:02 -0400 Received: from mail-wr1-f51.google.com ([209.85.221.51]:40842) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJcox-0003i1-Jv for 34842@debbugs.gnu.org; Sun, 13 Oct 2019 08:18:00 -0400 Received: by mail-wr1-f51.google.com with SMTP id h4so16560466wrv.7 for <34842@debbugs.gnu.org>; Sun, 13 Oct 2019 05:17:59 -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; bh=Es9mVKJbIL1rVk1+iFtL6tCl5gV0JD69ZsUDFlBAxD0=; b=JhET3bFbJci6ZAvdqE3ImbKjo/QEPCvh7Xx/Cx9hkqYz5vWH2pQyS/d+No1ZhUHonY 1ELHFgG5hCM3nxuWLG659G+yu9tch4USMyVRbwYq2VcE7WOBrfy8G1Kb6IDMHwPdonr7 /KBFT+KUqDgpqDujRxqLQsR8xZRGpVytJuxHQ5LzkUdpezI8A+Veg+GPFsmOjyRS0ldr YCdqjXWD7emnfLbBJUrTqjrfDMPtnjCdO5oM+1SVb+zEgyFuGzQcz5H95cqiozSJiGmE GIdC4J3tugTOWz/AWWbrkrFD2Xzj1nMbzUA8WOEChyTz4UKiXU5LTGuDJ72VfUH+jaSa gYDA== 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; bh=Es9mVKJbIL1rVk1+iFtL6tCl5gV0JD69ZsUDFlBAxD0=; b=RupszychnXzPctiohjyAvEI/gPrprSi62J37tDnEaoYZB9v/JuxyeLL3E0ZxGgo6qJ ct+0VyUuT69orfBSe649OtL1QZSX/eCGpq399AUr07yw4L98jjdanuXef9ty2Rw8EjJ2 c5tJgT+yfoG644MTYsEAHhxe+MFvrXfSzYyottFuK7p9hHu5QUDOeIKq1Ee0blgjrk4l JwFodloelcIkUMz+1aadm9vRmRPuxqGunvmjGDFTuBDlGqADrdEJCOZQdmRBgP7imUE/ 2nAHxNLausJS0FeWxxLshuS+lG+Ri3jaJwItvhfYnlwP9lOlDKVnBPO9UsmQ/I1qWCWr CX9Q== X-Gm-Message-State: APjAAAWTgWilLB3LtP9n/nRkXWLjgtqKcO/qkDr4BoPHYHD1bN21c11L mShrBZ28Cm3L06zdFQqrSWkWOg== X-Google-Smtp-Source: APXvYqy1I7GKJcdU62Cl1ce8IeGox41dyLU+MIo7LHlRazsAVYDBPRNzRZ++OmDZCnxE0yqihTko8Q== X-Received: by 2002:a5d:4302:: with SMTP id h2mr11916590wrq.35.1570969073793; Sun, 13 Oct 2019 05:17:53 -0700 (PDT) Received: from localhost ([2a02:8084:20e2:c380:1f68:7ff5:120d:64e]) by smtp.gmail.com with ESMTPSA id x2sm18807048wrn.81.2019.10.13.05.17.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 13 Oct 2019 05:17:53 -0700 (PDT) From: "Basil L. Contovounesios" References: <87eezhh763.fsf@gnus.org> <871rvh9zc4.fsf@tcd.ie> <87a7a5e4yc.fsf@gnus.org> Date: Sun, 13 Oct 2019 13:17:51 +0100 In-Reply-To: <87a7a5e4yc.fsf@gnus.org> (Lars Ingebrigtsen's message of "Sun, 13 Oct 2019 04:48:11 +0200") Message-ID: <87y2xoj0uo.fsf@tcd.ie> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Lars Ingebrigtsen writes: > "Basil L. Contovounesios" writes: > >> Thanks. The following constitute what I think are some opportunities >> for clarifying the current doc. WDYT? > > Looks good to me, but: Thanks. >> +@samp{.} are bound. Each such @var{.symbol} is bound to the @sc{cdr} >> +of the first association for @var{symbol} in @var{alist} using >> +@code{assq}. If no such association exists, @var{.symbol} is bound to >> +@code{nil}: >> >> +@lisp >> +(let-alist colors >> + .tulip) >> + @result{} nil >> +@end lisp > > This bit seems superfluous. (cdr (assq ...)) is nil when no such > association exists, but this makes it sound like that's a special case > somehow... It's just making it explicit without having to refer to specifics of the implementation. I think it's a common style in the docs, but I don't feel strongly about it. Would you rather remove the example, the sentence, or both? -- Basil From unknown Sun Aug 17 10:17:20 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34842: 26.1; Alist documentation: let-alist Resent-From: "Basil L. Contovounesios" Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 13 Oct 2019 12:39:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34842 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed To: Eli Zaretskii Cc: Lars Ingebrigtsen , 34842@debbugs.gnu.org, seb.hoagie@outlook.com Received: via spool by 34842-submit@debbugs.gnu.org id=B34842.157097030424034 (code B ref 34842); Sun, 13 Oct 2019 12:39:02 +0000 Received: (at 34842) by debbugs.gnu.org; 13 Oct 2019 12:38:24 +0000 Received: from localhost ([127.0.0.1]:35330 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJd8h-0006Fa-Vm for submit@debbugs.gnu.org; Sun, 13 Oct 2019 08:38:24 -0400 Received: from mail-wm1-f42.google.com ([209.85.128.42]:36455) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJd8f-0006FN-I0 for 34842@debbugs.gnu.org; Sun, 13 Oct 2019 08:38:22 -0400 Received: by mail-wm1-f42.google.com with SMTP id m18so14144115wmc.1 for <34842@debbugs.gnu.org>; Sun, 13 Oct 2019 05:38:21 -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=vXKxijZ//z+CowVkP4xrPwBrklwi2EcjuM2cPCXfTSI=; b=gpMtLgp7d+LFCBtNq38ERK5GSlgPb1yWGE64fOfMcMAgMlvrTvYTluqnX17bV07/8d kNHwpEcFXhZsrkiLfrCsrgI7XwvtRPRf5l0Uq5egxWExEeyw8QTLvqiAeSN5xI0BWmb0 L/66794/OKKO5y3KscjOl2wj6A6YY0ymRwE6ikulFTOkw+L5twj3nyqvmjuddNCqqc9u eO6Fov30Fi1Y1ChnDdsgb0gxdbEXgxgBqqas+a2vTDJ3o/eWQVIM3zPi0XdeIm+H2DJN oMQ9ul8/M1O9w1WBiwlClnhSSUGyT7lSMBrbpiR8LXsrlyxbMSYe3SmjWZ7Jzls2pE3o j1zA== 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=vXKxijZ//z+CowVkP4xrPwBrklwi2EcjuM2cPCXfTSI=; b=POUzSWhEoQksXu0dpsAVIiycaiebkTr4KsKU9fO3Zc3aumYVT47Rwj7v90e60SWXW6 +N9nlBYaIt7lqZ8z0Sr5QxLA5XNi9u4VRC0NtOXtiuEvGsXjXJV79LFPhZEt9s4nOGgo QjjPF64kuzitf195HqJBkOW78hVhK8snOg+lANZweWLVlpuUy50gKp4dPjUH3fDaDUxs /I2A7R61LHJk9xzqIQyBcBtzPqHIQaSJPZg+JJrHi2Nl/IOhQm4UQxjAxxwbhGaMnSfJ xXBeYy5mGw+uZb+6exGuEF+Qiz7lzDLnTu7S4w2KdjM4jcbllcE8B8XrI1ylxQ4j3t7l PSQA== X-Gm-Message-State: APjAAAUrwf/vDAGp5V17gFLAGTq+q6U6v1y7pp6MN+sKC0k39Stzg6q3 tiTBCTz3uMdkkkAiVo/vC3Q+3Q== X-Google-Smtp-Source: APXvYqzFaqErmAEJtO5BWWd80lZg7Xu5wJHKD9rsAzhfOgG2pvOw4AHiMPT2e9nRdYmC5Uf14uhtRQ== X-Received: by 2002:a05:600c:28d:: with SMTP id 13mr11664528wmk.100.1570970295526; Sun, 13 Oct 2019 05:38:15 -0700 (PDT) Received: from localhost ([2a02:8084:20e2:c380:1f68:7ff5:120d:64e]) by smtp.gmail.com with ESMTPSA id h14sm19759246wro.44.2019.10.13.05.38.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 13 Oct 2019 05:38:14 -0700 (PDT) From: "Basil L. Contovounesios" References: <87eezhh763.fsf@gnus.org> <871rvh9zc4.fsf@tcd.ie> <87a7a5e4yc.fsf@gnus.org> <83wod9kten.fsf@gnu.org> Date: Sun, 13 Oct 2019 13:38:09 +0100 In-Reply-To: <83wod9kten.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 13 Oct 2019 10:15:44 +0300") Message-ID: <87lftohlce.fsf@tcd.ie> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Eli Zaretskii writes: >> From: Lars Ingebrigtsen >> Date: Sun, 13 Oct 2019 04:48:11 +0200 >> Cc: 34842@debbugs.gnu.org, Sebasti=C3=A1n Mon=C3=ADa >> >>=20 >> "Basil L. Contovounesios" writes: >>=20 >> > Thanks. The following constitute what I think are some opportunities >> > for clarifying the current doc. WDYT? >>=20 >> Looks good to me, but: > > I have one more nit: why was @dots{} added after @var{body} in the > @defmac line? There's only one body here, isn't it? There's only one body indeed, but it comprises multiple forms. The Elisp manual currently contains over 50 occurrences of body..., including the following: -- Macro: dolist (var list [result]) body... -- Special Form: catch tag body... -- Macro: ignore-errors body... -- Macro: defun name args [doc] [declare] [interactive] body... -- Macro: lambda args [doc] [interactive] body... -- Macro: defsubst name args [doc] [declare] [interactive] body...=20=20= =20=20=20 -- Macro: defmacro name args [doc] [declare] body... -- Macro: with-eval-after-load library body... -- Special Form: eval-when-compile body... Whereas it only contains 7 occurrences of '&rest body': -- Macro: pcase-defmacro name args [doc] &rest body -- Macro: with-connection-local-variables &rest body -- Macro: gv-define-setter name arglist &rest body -- Macro: gv-letplace (getter setter) place &rest body -- Macro: minibuffer-with-setup-hook function &rest body -- Macro: with-coding-priority coding-systems &rest body... -- Macro: with-temp-message message &rest body [Note that with-coding-priority uses both &rest and body...] And let-alist is the only occurrence of a body without either &rest or an ellipsis: -- Macro: let-alist alist body Of course there is also the forms... style, of which there are under 20 occurrences, including: -- Special Form: progn forms... -- Special Form: if condition then-form else-forms... -- Macro: when condition then-forms... -- Macro: unless condition forms... -- Special Form: while condition forms... -- Special Form: let (bindings...) forms... I don't mind which style is preferred, but let-alist should probably pick one of the existing ones, right? Any preference? Thanks, --=20 Basil From unknown Sun Aug 17 10:17:20 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34842: 26.1; Alist documentation: let-alist Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 13 Oct 2019 13:17:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34842 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed To: "Basil L. Contovounesios" Cc: larsi@gnus.org, 34842@debbugs.gnu.org, seb.hoagie@outlook.com Received: via spool by 34842-submit@debbugs.gnu.org id=B34842.157097256327488 (code B ref 34842); Sun, 13 Oct 2019 13:17:02 +0000 Received: (at 34842) by debbugs.gnu.org; 13 Oct 2019 13:16:03 +0000 Received: from localhost ([127.0.0.1]:35364 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJdj5-00078h-Kg for submit@debbugs.gnu.org; Sun, 13 Oct 2019 09:16:03 -0400 Received: from eggs.gnu.org ([209.51.188.92]:34464) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJdj3-00078S-SA for 34842@debbugs.gnu.org; Sun, 13 Oct 2019 09:15:58 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:57607) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1iJdiy-0007Me-11; Sun, 13 Oct 2019 09:15:52 -0400 Received: from [176.228.60.248] (port=4658 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1iJdix-000644-2K; Sun, 13 Oct 2019 09:15:51 -0400 Date: Sun, 13 Oct 2019 16:15:39 +0300 Message-Id: <83h84clrb8.fsf@gnu.org> From: Eli Zaretskii In-reply-to: <87lftohlce.fsf@tcd.ie> (contovob@tcd.ie) References: <87eezhh763.fsf@gnus.org> <871rvh9zc4.fsf@tcd.ie> <87a7a5e4yc.fsf@gnus.org> <83wod9kten.fsf@gnu.org> <87lftohlce.fsf@tcd.ie> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: "Basil L. Contovounesios" > Cc: Lars Ingebrigtsen , 34842@debbugs.gnu.org, > seb.hoagie@outlook.com > Date: Sun, 13 Oct 2019 13:38:09 +0100 > > I don't mind which style is preferred, but let-alist should probably > pick one of the existing ones, right? Any preference? I prefer either "body" or "forms@dots{}". From unknown Sun Aug 17 10:17:20 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34842: 26.1; Alist documentation: let-alist Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 13 Oct 2019 17:40:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34842 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed To: "Basil L. Contovounesios" Cc: 34842@debbugs.gnu.org, =?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?= Received: via spool by 34842-submit@debbugs.gnu.org id=B34842.157098837229442 (code B ref 34842); Sun, 13 Oct 2019 17:40:01 +0000 Received: (at 34842) by debbugs.gnu.org; 13 Oct 2019 17:39:32 +0000 Received: from localhost ([127.0.0.1]:36846 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJhq7-0007em-Rq for submit@debbugs.gnu.org; Sun, 13 Oct 2019 13:39:32 -0400 Received: from quimby.gnus.org ([80.91.231.51]:34806) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJhq5-0007ed-PV for 34842@debbugs.gnu.org; Sun, 13 Oct 2019 13:39:30 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iJhq2-0003TZ-5X; Sun, 13 Oct 2019 19:39:28 +0200 From: Lars Ingebrigtsen References: <87eezhh763.fsf@gnus.org> <871rvh9zc4.fsf@tcd.ie> <87a7a5e4yc.fsf@gnus.org> <87y2xoj0uo.fsf@tcd.ie> Date: Sun, 13 Oct 2019 19:39:25 +0200 In-Reply-To: <87y2xoj0uo.fsf@tcd.ie> (Basil L. Contovounesios's message of "Sun, 13 Oct 2019 13:17:51 +0100") Message-ID: <87o8ykbl4i.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: "Basil L. Contovounesios" writes: > It's just making it explicit without having to refer to specifics of the > implementation. I think it's a common style in the docs, but I don't > feel strongly about it. Would you rather remove the [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) "Basil L. Contovounesios" writes: > It's just making it explicit without having to refer to specifics of the > implementation. I think it's a common style in the docs, but I don't > feel strongly about it. Would you rather remove the example, the > sentence, or both? I think both the sentence and the example are confusing, because they make an issue out of things behaving normally as if that behaviour is special to this case. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no