bug#47762: [External] : Re: bug#47762: Doc of `macroexp-file-name' (Emacs 28)

[Drew Adams]

> > 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.

FWIW, I disagree completely.  A reader really has
no idea how or where to use this function.