bug#47762: closed (Doc of `macroexp-file-name' (Emacs 28))

[GNU bug Tracking System]

Your message dated Wed, 14 Apr 2021 09:22:21 +0300
with message-id <83a6q11j36.fsf@gnu.org>
and subject line Re: bug#47762: Doc of `macroexp-file-name' (Emacs 28)
has caused the debbugs.gnu.org bug report #47762,
regarding Doc of `macroexp-file-name' (Emacs 28)
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs@gnu.org.)


-- 
47762: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=47762
GNU Bug Tracking System
Contact help-debbugs@gnu.org with problems
> --- Begin Message ---
>
>
>
> Subject: 
>
> Doc of `macroexp-file-name' (Emacs 28)
>
>
>
>
> Date: 
>
> Tue, 13 Apr 2021 22:34:57 +0000
>
>
>
>
> I don't have Emacs 28 code, where this function is apparently defined.
> I'm going by what is shown here:
>
> https://emacs.stackexchange.com/a/64404/105
>
> The doc string shown there is this:
>
>  Return the name of the file from which the code comes.
>  Returns nil when we do not know.
>  A non-nil result is expected to be reliable when called from a macro in order
>  to find the file in which the macro's call was found, and it should be
>  reliable as well when used at the top-level of a file.
>  Other uses risk returning non-nil value that point to the wrong file.
>
> Please consider clarifying the doc for this function.  For example, just
> what code is meant here: "the file from which the code comes"?
>                                               ^^^^^^^^
>
> Looking at the source code doesn't help understanding of the function
> either (at least in releases prior to Emacs 28).  The doc string for
> variable `current-load-file' just says "Used for internal purposes by
> `load'.", and there's no doc string at all for variable
> `byte-compile-current-file'.
>
> In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
>  of 2019-08-29
> Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
> Windowing system distributor `Microsoft Corp.', version 10.0.19041
> Configured using:
>  `configure --without-dbus --host=x86_64-w64-mingw32
>  --without-compress-install 'CFLAGS=-O2 -static -g3''
>
>
>
>
> --- End Message ---
> --- Begin Message ---
>
>
>
> Subject: 
>
> Re: bug#47762: Doc of `macroexp-file-name' (Emacs 28)
>
>
>
>
> Date: 
>
> Wed, 14 Apr 2021 09:22:21 +0300
>
>
>
>
> > From: Drew Adams <drew.adams@oracle.com>
> > Date: Tue, 13 Apr 2021 22:34:57 +0000
> > 
> > The doc string shown there is this:
> > 
> >  Return the name of the file from which the code comes.
> >  Returns nil when we do not know.
> >  A non-nil result is expected to be reliable when called from a macro in order
> >  to find the file in which the macro's call was found, and it should be
> >  reliable as well when used at the top-level of a file.
> >  Other uses risk returning non-nil value that point to the wrong file.
> > 
> > Please consider clarifying the doc for this function.  For example, just
> > what code is meant here: "the file from which the code comes"?
> >                                               ^^^^^^^^
>
> This is explained by the text that you cited.
>
> Closing.
>
>
> --- End Message ---