From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: [PATCH] elisp manual patch: add to file notification documentation Date: Tue, 13 Dec 2022 10:20:46 -0800 Message-ID: References: <87bko8knq2.fsf@rabkins.net> <875yefi5mq.fsf@rabkins.net> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="11024"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel , Michael Albinus To: Yoni Rabkin Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Dec 13 19:21:44 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 1p59uR-0002gO-RL for ged-emacs-devel@m.gmane-mx.org; Tue, 13 Dec 2022 19:21:43 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p59tc-0007mz-4u; Tue, 13 Dec 2022 13:20:52 -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 1p59ta-0007mf-B5 for emacs-devel@gnu.org; Tue, 13 Dec 2022 13:20:50 -0500 Original-Received: from mail-oa1-x36.google.com ([2001:4860:4864:20::36]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1p59tY-00078h-QP for emacs-devel@gnu.org; Tue, 13 Dec 2022 13:20:50 -0500 Original-Received: by mail-oa1-x36.google.com with SMTP id 586e51a60fabf-144b21f5e5fso13573579fac.12 for ; Tue, 13 Dec 2022 10:20:48 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:from:to:cc:subject:date:message-id:reply-to; bh=YaSnMK0ghY7fIgy3u1wlw35XM8IPMC5cUegWN0x2GTk=; b=gWmgCwF6HuMEBIrjRAbGRq6yUAUxCnVZWsiEV7cT23GyX/rAful3sYQeA7jfnXP+y6 zjQnPORxpII1tQby596B1ioDrMzHo268V1J3MaIpq6mpbhiQaFM7EB0KBDO8cbx2Wezz u8R5b0tzChHqkGMsHxSlPMJ+GXLDqEB6i7peshifLBVZYGr8HIBQztq49WI1fVy4m8kR 9vgcDGxVFKjJaPfOmFbalewAxpZOuNsDJ6wmrtvURVJswk3qdt64s/voa5umP3kau8U4 uSJZhDXZ/4rpKTT4+59O/Gg5//k5jJ1I47BrGizooHePesftaA8l+x8FrMWw69aLvHLR qn/Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=YaSnMK0ghY7fIgy3u1wlw35XM8IPMC5cUegWN0x2GTk=; b=mVYmZQCjLJ67UampE51xJRGcerdmIjbAVEwEPSb3Cu4oFxtl7DLOl0vby2P0rl5ng1 BLNVO31WO0zxGuSXu5R9qs6OpElI5idUApIgTruHdDVKlRXoJ+7vVxeVAO9ohN16EbfG 9SCU4AhjNIxyrJ4zldmh7P5ohq+/OsbScjQOu8TTCyDq5hgQgU2a+gQoLxkVazZh1Nfv I8ZAV36WZQKQtKVET5+VuTzi/xtsmiI5NahLor/J86oUrDkg+1RnJfFLsv2l73/uvkUj rR5kUfIzwldfj+uZCMkGwUQCWYGpu5MmB0tRicqCRry79uSerIkF3CPUKZ+8xnfu1Sns fUrQ== X-Gm-Message-State: ANoB5pmw1hqVv1cRz246z0KnfxTgW583qbCWUxpsfNOfVbc3FnaUWu7N hMqh8heIzLKcDGk2T5L+ecCNqlIpY2gJLX3NMc8= X-Google-Smtp-Source: AA0mqf5BJrl4IX8vQpI7Dl8v3tN51/zKF8xqFBBF0FqgUXg/o3hfH5UTjqgb/0ZVRLxoR0+pLrWe13eBWn0FjUf+x8c= X-Received: by 2002:a05:6870:6c06:b0:145:3a7:99c with SMTP id na6-20020a0568706c0600b0014503a7099cmr265974oab.92.1670955647559; Tue, 13 Dec 2022 10:20:47 -0800 (PST) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Tue, 13 Dec 2022 10:20:46 -0800 In-Reply-To: <875yefi5mq.fsf@rabkins.net> X-Hashcash: 1:20:221213:michael.albinus@gmx.de::F0ytHP9lq24wsh7o:CbaN Received-SPF: pass client-ip=2001:4860:4864:20::36; envelope-from=stefankangas@gmail.com; helo=mail-oa1-x36.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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:301340 Archived-At: Yoni Rabkin writes: >> If this is supposed to be user-facing, shouldn't it be renamed to >> `file-notify-library'? > > Is the content of the elisp manual supposed to be user-facing? I guess > it depends on how you all define that term. > > When I wrote "user" above, I was referring to the "user" of the elisp > manual, who is a person writing elisp. Yes, I also include ELisp developers when I say "user-facing" here. This is in contrast to implementation details, that ELisp developers must not rely upon. The convention is to mark the names of such implementation details either with two dashes "--" (new style) or "-internal" (old style).