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.devel Subject: RE: [External] : Re: [PATCH] elisp manual patch: add to file notification documentation Date: Tue, 13 Dec 2022 18:31:52 +0000 Message-ID: References: <87bko8knq2.fsf@rabkins.net> <875yefi5mq.fsf@rabkins.net> 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="26939"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel , Michael Albinus To: Yoni Rabkin , Stefan Kangas Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Dec 13 19:32:20 2022 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1p5A4i-0006l7-5u for ged-emacs-devel@m.gmane-mx.org; Tue, 13 Dec 2022 19:32:20 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p5A4U-0003g4-En; Tue, 13 Dec 2022 13:32:06 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p5A4Q-0003fU-RG for emacs-devel@gnu.org; Tue, 13 Dec 2022 13:32:03 -0500 Original-Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p5A4N-0003g8-7a for emacs-devel@gnu.org; Tue, 13 Dec 2022 13:32:01 -0500 Original-Received: from pps.filterd (m0246631.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 2BDGE1YZ015160; Tue, 13 Dec 2022 18:31:55 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-2022-7-12; bh=+Lk1ddoMKMEa31H1U1N7KDUSlxSqINWTl4DuyiTW+rg=; b=Bg5pWwF72tUyFTfzWN83fzISQ5+AFhXR7cM523gvWsMPMxGCuoikqQRr0p+kWY1rVdyT vifhsgg/oLKR3C7vrua/V0rFiAHi8AhVOU6JnrtyXuJSxOesZGszylNivehnfeFh6DZh dg+6+B9keEhxUB4n/t9N91cmko88t5ciyjpsPzEMpqat/qM8S1cAmUfsArB4uq76E/hY yl7gOVyH92zcySLozdQ9KIdGUzbrxSQPiJZGAsMj1rAKQ/llwnbRd9+ErP0M9KHKt8NB K0RZsyPdOKRRIkGn8Ny+6I9FRo0XuC4FrKZOfMULRvmRajNnN0BKMYui2OsViztKV/Yi RQ== Original-Received: from iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta01.appoci.oracle.com [130.35.100.223]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3mcgw2e52x-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 13 Dec 2022 18:31:54 +0000 Original-Received: from pps.filterd (iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 2BDIAr2v032750; Tue, 13 Dec 2022 18:31:54 GMT Original-Received: from nam02-bn1-obe.outbound.protection.outlook.com (mail-bn1nam02lp2040.outbound.protection.outlook.com [104.47.51.40]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3mcgjchyhy-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 13 Dec 2022 18:31:53 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=aGbo5z5XamXvC/td35POseG+UZpLZa9byB34mActkiICsHorl0LcOrxLOBUM19xcvBnC3EikvS3/iANkNe28J/USda/wOWI+ZXUwXYNe9sJ/kOQG2N+CoLY1DqUeO2GtdH0PNMPUWqKLwUOrf8R4IawMIXvFKJuFKHaOehpdWmsR33PMjbVlwa7W+U/01HP2ryvvLDxPm++HMrqJ5mITZyaS4xpZtRpsHKQmifmunsnDIi6FJphyrk8NIeZ6fxS/12zci+jqFkWty+2r5As8dIAK/naOFAhgNi/lV38xXu8qmAeBgDF7u9dT8FANTofHD5UsGtKCydT3clhkNwFsfw== 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-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=+Lk1ddoMKMEa31H1U1N7KDUSlxSqINWTl4DuyiTW+rg=; b=mJR69+tsh1+fTqO6WLTIrGdn2/0bGDCHM0QT7af9mp4FEPpxQIB6Xggpbxba35YGHN2VMSUc/cuR3o8breFoBtjIbr50/QEzPDnz3NVT14tKyjuX7vy5NKrM/QQx7jvU9RJPsChWoYfiBztGXyCCCJlwJgs5p5sI17U6IPgfXRQp9XUWb4GwlKCK5u7hHhjjfeYG3sYdDBBkK+HQ0N8qw2C7zkg0l+21n1ao1wfhfjXQ+vUYk+szThyEtSyVRPlwYv42M4p49scEkEDmcK0vCld+t9TzFslx4Tdvikp6QalaVcTmLT64bd2MuJW5Ekawkgw0XU0t0JaNWMaA3Hq+WA== 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=+Lk1ddoMKMEa31H1U1N7KDUSlxSqINWTl4DuyiTW+rg=; b=0Clem/VUoavTo/ZMBAadlPI7Fo/L+QqCXolPtBUXRVGHnXPWHu+rUrGkFWOzoCdDWcwj984o8Q356VCcKUAWGRvmc/aSHprpoTRwOAJD3Tm4IEnyNnRH181DdcgKp/j/YHXW6yCwvLoTc4Zuxwc1KfP+nJC3+YA5SBBhRHVzvZk= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by PH8PR10MB6600.namprd10.prod.outlook.com (2603:10b6:510:223::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5880.19; Tue, 13 Dec 2022 18:31:52 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::176d:3689:aa5b:91b]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::176d:3689:aa5b:91b%2]) with mapi id 15.20.5880.019; Tue, 13 Dec 2022 18:31:52 +0000 Thread-Topic: [External] : Re: [PATCH] elisp manual patch: add to file notification documentation Thread-Index: AQHZDxcZ2xSzDW5LT0ywGRS5GDkQGq5sIpkg In-Reply-To: <875yefi5mq.fsf@rabkins.net> Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-traffictypediagnostic: SJ0PR10MB5488:EE_|PH8PR10MB6600:EE_ x-ms-office365-filtering-correlation-id: 6c5c14c4-98d8-4af1-966d-08dadd384df6 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: ImB41OmoC0yqLpaf4WMHasMVkbZHgdo5wlD4q0AfBItld9yeddeJI38rRrsU/a12T/oFCMK/y7+GZBPNXvf3IuHTeqt4XV1EQHnxvvwsFLvjLRDngN6EY7Wh+XXbBA1u2NGK/nS0vM3tQmB7qcqs5cvYIF4mNAfvOJxsdlRoFeCZV8MXZ36Q/uuvVOiEbsfrlHRDerUKsKn58lmRQHgkbAJuOMMgjXoyeqjyo086Ng1K9YtdzUjBEvZcKO8PXJoMNva3MNEOaRDlPZrG/mgOSbA4YMhIazFdSxqGQcujxpCp7RvUBqEIrGRCAiMeDU1Y8ygwfVG5xPf/pqXTk4CdLcADPSjblhCMc/9v8tNMntSeYUyRxHhit+IrScG3reWZsCyb4C5BWS/8TLDDT004OuuP7sHaN3aUOYHwK/E5oJfIQoJ20vW9xeQEPkjUujzLoSL2FEil6s+KKPs9aGqwQvJB14v61Ixi/4FuHz2p/xpi+NgkcDsE6x7tS698ylK4ZuQ0P5w9N8eECZo1HbuBgGiyxysIeO72z6XD4a9exZU2V8nD/4Jx7oAJAcvrOISGjNZBMrzFCC3/qGaAEHgQatHvHu77zEmkNhmzV1q5EStaoiHrbseZO4dHdRoRtmDj7yaHitqoZy7YlIkfplFWe7gjSXt2du17zjBj6171MYDsNeSuFRSyNibDHIh4gV8k0nmfos6M8KkBJObYyAMF5Q== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SJ0PR10MB5488.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230022)(366004)(376002)(136003)(39860400002)(396003)(346002)(451199015)(66946007)(41300700001)(316002)(76116006)(54906003)(122000001)(33656002)(66476007)(66446008)(86362001)(2906002)(8676002)(4326008)(52536014)(8936002)(38070700005)(38100700002)(4744005)(55016003)(5660300002)(66556008)(71200400001)(64756008)(7696005)(478600001)(110136005)(6506007)(186003)(44832011)(26005)(9686003); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?6lvqhr2vAn074bMAfvMApcW/P6KoDCp2UNdvk36/27cqGzViOFltMSBr4Xmd?= =?us-ascii?Q?HupNXigxdgxBBAb/mrTcZs/RaFFSjTba13BTgYp+pnyC7+jwKeY5bo2qLPUx?= =?us-ascii?Q?b3u0EQbEP7BQP5VTF+vOQMyHoXLWmlHz2xgfCsAYHspoxgD8ylRJJ7rxMf2A?= =?us-ascii?Q?+XES24u43YwIx9fOVxdenZTgUygokHM6jAx5+9rJWjnwJjFr8LeiUd0+aBSb?= =?us-ascii?Q?RUovOx4dupGr12cTIrqjp3BfswySL3BvdxDtd+XMcIx5nJeWPnvgKmyzhnB2?= =?us-ascii?Q?5tpXoruVixSxKPmBTYwMnO3DiDNFzE4XiWsCtbUEltUwM9g7g7HDhhe7aEti?= =?us-ascii?Q?RAIDVigUxjaNA/xLHVGhaMsG1ClXvIe7CZcWJyiR08sAam9aZ/liZCx3dRCn?= =?us-ascii?Q?/u8OEEG3acdfqAvMiTMaNKWfDmyy6qhZPq/Q50aiO9SYtoUDSegXixBDi+7g?= =?us-ascii?Q?JCea1yDi5EaBsACX38IYywL4w4nJdy9Lv8CiG9kI81U98Yhij0YWPJBaetRt?= =?us-ascii?Q?6QpGVw8scjKBlwqu6joxdg+k2bQmQ4M2Sim71S4uhqzSGQyZ7ExpT3EQPvYX?= =?us-ascii?Q?lZ58afRGFKNg5LDjQZz8VesLAfJGex/oKaNU6mabIoa3ZRrhzDh209DwfKt9?= =?us-ascii?Q?H7 X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SJ0PR10MB5488.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 6c5c14c4-98d8-4af1-966d-08dadd384df6 X-MS-Exchange-CrossTenant-originalarrivaltime: 13 Dec 2022 18:31:52.1634 (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: I5JPIlGOHtaCpjMJWVxK1QBz+e2YTT3KR7xp9aelFu9D4BEryhbWc5IbRZigq1ZivLS+6N2upRkvXEp6W3JfZw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH8PR10MB6600 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.205,Aquarius:18.0.923,Hydra:6.0.545,FMLib:17.11.122.1 definitions=2022-12-13_03,2022-12-13_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 phishscore=0 bulkscore=0 malwarescore=0 mlxlogscore=716 mlxscore=0 adultscore=0 suspectscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2210170000 definitions=main-2212130161 X-Proofpoint-ORIG-GUID: YuJRwHoX3q3sgt1HfUKI3PFzi8Obg4Kj X-Proofpoint-GUID: YuJRwHoX3q3sgt1HfUKI3PFzi8Obg4Kj Received-SPF: pass client-ip=205.220.177.32; envelope-from=drew.adams@oracle.com; helo=mx0b-00069f02.pphosted.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:301344 Archived-At: > >> The following elisp manual documentation patch explains > >> to the user how to... ^^^^ user -> reader Reader of the manual. > > If this is supposed to be user-facing, shouldn't it be... >=20 > Is the content of the elisp manual supposed to be user-facing? > I guess it depends on how you all define that term. >=20 > When I wrote "user" above, I was referring to the "user" of=20 > the elisp manual, who is a person writing elisp. And yes, users, including "end" users (at any level of familiarity), can also use Lisp. If you want to talk about both users of some code and writers of some code, do that. But yes, a user of `cons' or `format' is a Lisp user, and in the case of Emacs that's an Elisp user, which implies an Emacs user.