[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH] elisp manual patch: add to file notification documentation
From: |
Stefan Kangas |
Subject: |
Re: [PATCH] elisp manual patch: add to file notification documentation |
Date: |
Tue, 13 Dec 2022 10:20:46 -0800 |
Yoni Rabkin <yoni@rabkins.net> 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).
Re: [PATCH] elisp manual patch: add to file notification documentation, Yoni Rabkin, 2022/12/13