From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.help Subject: RE: [External] : Supplying DOC string in a `defun' using `defvar' Date: Wed, 2 Jun 2021 19:58:25 +0000 Message-ID: References: <871r9ly7v3.fsf@web.de> <87r1hlw6pn.fsf@web.de> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="33033"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Christopher Dimech , "help-gnu-emacs@gnu.org" To: Stefan Monnier Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Wed Jun 02 22:01:54 2021 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1loX3o-0008LS-TO for geh-help-gnu-emacs@m.gmane-mx.org; Wed, 02 Jun 2021 22:01:53 +0200 Original-Received: from localhost ([::1]:54864 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1loX3n-0007hz-8X for geh-help-gnu-emacs@m.gmane-mx.org; Wed, 02 Jun 2021 16:01:51 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:43650) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1loX0d-0006Bf-9m for help-gnu-emacs@gnu.org; Wed, 02 Jun 2021 15:58:35 -0400 Original-Received: from userp2130.oracle.com ([156.151.31.86]:51244) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1loX0Z-0006Oz-Vq for help-gnu-emacs@gnu.org; Wed, 02 Jun 2021 15:58:35 -0400 Original-Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 152JoAgh136819; Wed, 2 Jun 2021 19:58:28 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2020-01-29; bh=5aYKNdGQwNfput8ei6iRgrWz88lwcXao0AfbNGSnpKE=; b=YSlIERR//TeBer7fjrMFXqrz6TGfioMJvZX7Bo3/HnGRUrtakIjir3TZ9ax7pricbR6F ALy0qheRtAgND7EqSp1MtN9Vcdqd4IAfaMkl73tz8RQcrJ2njpJqQJblHQ8AGkowfx75 fjmz39vGHFEp9xh+M43lONrpBnMGXtiGoTMS/w7GfAoDp3SSi3/jo81jIbdYKCsi/FvQ 3Xaf8IU+qe8YYf1SGrYcNinA3s6vgkqN5MIiiLUIiMsTKbCgzfTrKrqHDUy7wSCvjk43 yORMtgXdpHgODK7AHs+GlG4e4UwzKZdtUKmUT9AKnumpEkz2HWeQOyQ4TjgeZPcBlqkY Zw== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by userp2130.oracle.com with ESMTP id 38ud1shkbq-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 02 Jun 2021 19:58:28 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 152Jsei9187494; Wed, 2 Jun 2021 19:58:28 GMT Original-Received: from nam12-bn8-obe.outbound.protection.outlook.com (mail-bn8nam12lp2173.outbound.protection.outlook.com [104.47.55.173]) by userp3020.oracle.com with ESMTP id 38x1bd6rkc-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 02 Jun 2021 19:58:28 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=JUW33oKUaqE3eXlid/U/6Wjr/ArctwZqXnDu4m0bPad8NCIPlGyl55iRd+Q3WkeTuPrfEPmXWXykZiinGOtUdpdG/au1PQjtItI1Liipu1ccepMK/xLNeeaYXRlL0mVgupoAYHAQGfzHhaRW5SCu0ecBS37DZv4713K97Fu5i2eDiNxihRkyfKOGGiFoX3XWmUpzyRLQYvUw8Q+1XppPwusOwNQYrlABNc6m1YWezEOPhFdJ2lFeGQdkKfeFlWsbhVn6X/mv1DlRPvXPuLFhGna+35mnKur0eDvILNG6o5PolRyxycCRqjjeA2tB8f3w6mJYa455AI37CsSk/treVQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=5aYKNdGQwNfput8ei6iRgrWz88lwcXao0AfbNGSnpKE=; b=dcHzf25R6VBdTEr6Qe3MjcIbWgIjjElVcjf8zimYaSZv1EZstfIeqGwQ4oCHZ8+2t/cX+dy2AY03dIKqVhL5IQ58JcbgIUpQce0khsb8pIrGjdt4Xg9nBgU82ypT1kaLlEY5ilfVVLrBEQLticAsJl81lAV3xhC1pdIiEdrR75FmNH2pbn9gmXNoEtqRL1auvOeZQ/khNg6/YpEx6kA3QJq9qZHB4WYHy4OciU7h7WLKoM4Wl1jjsxMvahjtdgdGUk4A3ASUqePiCrZA5Pj0Co44CBJbU3jA/FyAWpD/v2RWmsvoVibyoL5rP3X6hdB0s/v8uZg5/0+aGeTOV0MmiA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=5aYKNdGQwNfput8ei6iRgrWz88lwcXao0AfbNGSnpKE=; b=ouJVBHE60UE7XjjpsEMHnYr7W5r/ZVlXM7E12j+BkayedBs1jVZeLQJJLgs/tuBDhbf6jnQxbre3oaqt24DTt1y6x7viv4w3y+5XYzHNuevOgJ9NftcpY+3oLwuCV15rLlIXWCkA8mv/LEtRMCO5WQmr//9MPbZAEmlXuvUlfpk= Original-Received: from CO1PR10MB4466.namprd10.prod.outlook.com (2603:10b6:303:9b::10) by MWHPR10MB1888.namprd10.prod.outlook.com (2603:10b6:300:113::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4173.20; Wed, 2 Jun 2021 19:58:25 +0000 Original-Received: from CO1PR10MB4466.namprd10.prod.outlook.com ([fe80::f8ce:e306:cfd7:6f9f]) by CO1PR10MB4466.namprd10.prod.outlook.com ([fe80::f8ce:e306:cfd7:6f9f%7]) with mapi id 15.20.4173.030; Wed, 2 Jun 2021 19:58:25 +0000 Thread-Topic: [External] : Supplying DOC string in a `defun' using `defvar' Thread-Index: AQHXV94e8DymPTXqI0O/6Z8VPx1al6sBIIHQ In-Reply-To: Accept-Language: en-US Content-Language: en-US authentication-results: iro.umontreal.ca; dkim=none (message not signed) header.d=none;iro.umontreal.ca; dmarc=none action=none header.from=oracle.com; x-originating-ip: [73.170.83.28] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 604b5441-9e1f-4a2c-a65c-08d92600c868 x-ms-traffictypediagnostic: MWHPR10MB1888: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:8882; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: elYyBuMkDET0eG3wBVPq5aJR4xHH+Jb4iRnRQpMo1MU8Zaoeh63vzUZQ5P8alwSDYUeyw24Nya9wMl4dzuLNTC2Q56ETg6zcGj0SgqoKLqS1g4975VadEaXqkO/VtdXnNXsk4qakeLrJLooXdpWRNXDBkt81YhwdFCx2R0nAimVw1cfFwRvxpQa36pGNO2XlG3RsMrJcwn1FPLyLTfrhN0Xqnd2V632imwOlT7eKqGN3ZkvEFrDumzShgIR9AqE04SPN9lRJ76cNJxSzuOB84gJnwQCI2OtgGVKb2likHaNBOBvvgXGO7NUcLj9HPYX3eHoFBJsAQcs5n/aOaOMIMOXNCCClI3QpnEbdzavBGla1BprQGmixc2zmJ7x+jEXUngXpkmABw2vPuP1LzPJm4fqohX4mtIUrNuhMMyPIaf7+oqp9rcHfUvi9myjEoA/X1lHTCNr+Y0bYJtlKfNiPuWyD4NomXVC5dTUffU0m1Ns4zTz69O7E/5Ua+77PGKqaEaL+5Af0fSQUkjYiKD9MQcACa6SSMtLw4MZ0FdySd7L9ZHrYCOL6ds+lB8daC8S33tJAfpmWrdojjTVMzyxH/Qms5sDQ6pNvE2oJ3c1T7qmd1E+8LCatQEbM3qiXfvLtxoKKFmAyyi6jSw0DZ+cACw== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:CO1PR10MB4466.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(376002)(396003)(39860400002)(366004)(136003)(346002)(66476007)(66556008)(76116006)(44832011)(38100700002)(4744005)(66446008)(8936002)(122000001)(54906003)(316002)(296002)(6506007)(66946007)(64756008)(9686003)(8676002)(7696005)(55016002)(2906002)(33656002)(4326008)(71200400001)(52536014)(6916009)(5660300002)(86362001)(186003)(26005)(478600001)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: =?us-ascii?Q?eWzIItMSdVHkB9EVSxrunWcWUKn8xVM8sgtGAVYsfqo5E+Zrxb02HLt7niIX?= =?us-ascii?Q?GQdz9ylGUCVOo0R010l76eji85r0lP+rqz3MLsjfwDvNA2O1EEic68Z5k84/?= =?us-ascii?Q?hdQpnb6FuhSPrBz+JO8qUXNOonx3muPWXsF22O6RtOSJj5uQ2fOK8mvy9GFC?= =?us-ascii?Q?DErZaLt0j7AeQMvomPO7shi4etSWIW/K8LUQMYNw+BOLDWB1KiS3LDYU/jhG?= =?us-ascii?Q?dPDs6/Nwyad3wwi+vMEuBgfp+vxywLU2YypcM79MBkyGVsZkTeSkZjOmwmVp?= =?us-ascii?Q?OkOVYcZkJ4WHsX3eqP8eDl8y3rDxkw1oFnYD3Eg31DW7DVb7dpNwRSlcW0kx?= =?us-ascii?Q?BOxxIaCQQFnTWRaDtOKhVfZliKkFl/iJKyIthSh3Xb5dtaVgI2BNcTbpwZzk?= =?us-ascii?Q?ZEFWpMIle5BUr/b5qg80jBaXjmp9O4YUDVFaFt2wNpkGT1pxF94LyOQLlqPH?= =?us-ascii?Q?HFfZaK2VitZNnwqzNIwJ5M7aac5OedkxTY49+H2+ZTHWP5n4C+5Lyn6NIC/5?= =?us-ascii?Q?oSYbR1lNtJVyFAH9vQ9/J1z//Hqx8myKjZmEDBw4hcrL5JmwS0yPDhQ8dka/?= =?us-ascii?Q?K2d7sieRQEy0m4IBnitP72pCSS9K9M3jyW5T6GgJaakQzzI/ghEntgIPj6og?= =?us-ascii?Q?WUJl x-ms-exchange-transport-forked: True X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: CO1PR10MB4466.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 604b5441-9e1f-4a2c-a65c-08d92600c868 X-MS-Exchange-CrossTenant-originalarrivaltime: 02 Jun 2021 19:58:25.3115 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: 7SLzBqwr9g4eATR1kLuIhF6fNKPEV5Iwq+opUi8N8TBdq7NnXRB7fL/MnwqbkmA2ChtidmE6UrxPGtp/w3BnXA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: MWHPR10MB1888 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=10003 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=773 adultscore=0 malwarescore=0 mlxscore=0 suspectscore=0 spamscore=0 phishscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2104190000 definitions=main-2106020126 X-Proofpoint-ORIG-GUID: aBZrGfAXICjTmhZe5Loyq47Y9yHEBBeP X-Proofpoint-GUID: aBZrGfAXICjTmhZe5Loyq47Y9yHEBBeP X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=10003 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 priorityscore=1501 suspectscore=0 phishscore=0 lowpriorityscore=0 mlxlogscore=999 malwarescore=0 clxscore=1015 spamscore=0 impostorscore=0 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2104190000 definitions=main-2106020125 Received-SPF: pass client-ip=156.151.31.86; envelope-from=drew.adams@oracle.com; helo=userp2130.oracle.com X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_BL=0.001, RCVD_IN_MSPIKE_L3=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.io gmane.emacs.help:130513 Archived-At: > >> it's a new language feature, so it makes sense that > >> you need to use the new dialect for it be available. > > > > I don't see how that makes sense at all. It doesn't > > follow logically that every "new language feature" > > must work _only_ with the lexical binding dialect > > turned ON. > > Indeed it doesn't mean it would be bad to support > (:documentation ) in the dynbound case. But > it's argument for not bothering to do so. As the examples in this thread indicate, users will be mightily confused when they try to use :documentation without `lexical-binding' turned on. This thread is a poster child for such confusion. Is the aim to cause such bother intentionally, to get users looking into discovering why the gotcha, and thus discover (and use) `lexical-binding'? Or is this bug/bother for users really just a case of "not bothering" to DTRT? Either way, it seems like this should be fixed, preferably sooner rather than later.