unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
* Re: master 10a31c6a29: Prefer saying "init file" to ".emacs" in FAQ
@ 2022-08-24 11:39 Eli Zaretskii
  2022-08-25 17:04 ` Stefan Kangas
  0 siblings, 1 reply; 3+ messages in thread
From: Eli Zaretskii @ 2022-08-24 11:39 UTC (permalink / raw)
  To: Stefan Kangas; +Cc: emacs-devel

> branch: master
> commit 10a31c6a29ec08b76cd079470979e87704af3858
> Author: Stefan Kangas <stefankangas@gmail.com>
> Commit: Stefan Kangas <stefankangas@gmail.com>
> 
>     Prefer saying "init file" to ".emacs" in FAQ
>     
>     * doc/misc/efaq.texi: Prefer saying "init file" to
>     ".emacs".  (Bug#49424)

It is not a good idea to replace '.emacs' with "init file", when the
latter is not explained anywhere in the FAQ.  This is a FAQ, which
assumes a very confused reader, so relying on their knowledge in this
matter is not recommended.

If you want to make such a change, please add a section about what is
an init file and how Emacs looks for it, and add a cross-reference to
there whenever "init file" is mentioned.

It could be that a cross-reference to "Setting up a customization
file" is enough, although that section is about something else, and
this question is only answered there at the end (and the text in that
last part is nowadays outdated).

Thanks.



^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: master 10a31c6a29: Prefer saying "init file" to ".emacs" in FAQ
  2022-08-24 11:39 master 10a31c6a29: Prefer saying "init file" to ".emacs" in FAQ Eli Zaretskii
@ 2022-08-25 17:04 ` Stefan Kangas
  2022-08-25 18:34   ` Eli Zaretskii
  0 siblings, 1 reply; 3+ messages in thread
From: Stefan Kangas @ 2022-08-25 17:04 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: emacs-devel

Eli Zaretskii <eliz@gnu.org> writes:

> It is not a good idea to replace '.emacs' with "init file", when the
> latter is not explained anywhere in the FAQ.  This is a FAQ, which
> assumes a very confused reader, so relying on their knowledge in this
> matter is not recommended.
>
> If you want to make such a change, please add a section about what is
> an init file and how Emacs looks for it, and add a cross-reference to
> there whenever "init file" is mentioned.

Thanks, I've now fixed this as you suggest (commit 55f681359e).  I hope
it looks okay.



^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: master 10a31c6a29: Prefer saying "init file" to ".emacs" in FAQ
  2022-08-25 17:04 ` Stefan Kangas
@ 2022-08-25 18:34   ` Eli Zaretskii
  0 siblings, 0 replies; 3+ messages in thread
From: Eli Zaretskii @ 2022-08-25 18:34 UTC (permalink / raw)
  To: Stefan Kangas; +Cc: emacs-devel

> From: Stefan Kangas <stefankangas@gmail.com>
> Date: Thu, 25 Aug 2022 10:04:29 -0700
> Cc: emacs-devel@gnu.org
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
> > It is not a good idea to replace '.emacs' with "init file", when the
> > latter is not explained anywhere in the FAQ.  This is a FAQ, which
> > assumes a very confused reader, so relying on their knowledge in this
> > matter is not recommended.
> >
> > If you want to make such a change, please add a section about what is
> > an init file and how Emacs looks for it, and add a cross-reference to
> > there whenever "init file" is mentioned.
> 
> Thanks, I've now fixed this as you suggest (commit 55f681359e).  I hope
> it looks okay.

It looks fine, thanks.



^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2022-08-25 18:34 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-08-24 11:39 master 10a31c6a29: Prefer saying "init file" to ".emacs" in FAQ Eli Zaretskii
2022-08-25 17:04 ` Stefan Kangas
2022-08-25 18:34   ` Eli Zaretskii

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).