GNU bug report logs - #42388
27.0.91; Manual is inconsistent about default init file location

Previous Next

Package: emacs;

Reported by: "Jorge P. de Morais Neto" <jorge <at> disroot.org>

Date: Thu, 16 Jul 2020 11:39:02 UTC

Severity: normal

Found in version 27.0.91

Fixed in version 27.1

Done: Robert Pluim <rpluim <at> gmail.com>

Bug is archived. No further changes may be made.

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 42388 in the body.
You can then email your comments to 42388 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

View this report as an mbox folder, status mbox, maintainer mbox


Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#42388; Package emacs. (Thu, 16 Jul 2020 11:39:02 GMT) Full text and rfc822 format available.

Acknowledgement sent to "Jorge P. de Morais Neto" <jorge <at> disroot.org>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Thu, 16 Jul 2020 11:39:02 GMT) Full text and rfc822 format available.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: "Jorge P. de Morais Neto" <jorge <at> disroot.org>
To: bug-gnu-emacs <at> gnu.org
Subject: 27.0.91; Manual is inconsistent about default init file location
Date: Thu, 16 Jul 2020 07:23:36 -0300
The manual at [[info:emacs#Find Init]] says:

       Emacs can also look in an XDG-compatible location for ‘init.el’,
    the default is the directory ‘~/.config/emacs’.  This can be
    overriden by setting ‘XDG_CONFIG_HOME’ in your environment, its
    value replaces ‘~/.config’ in the name of the default XDG init file.
    However ‘~/.emacs.d’ and ‘~/.emacs’ are always preferred if they
    exist, which means that you must delete or rename them in order to
    use the XDG location.

However, at [[info:emacs#Init File]] it says:

    When Emacs is started, it normally tries to load a Lisp program from
    an “initialization file”, or “init file” for short.  This file, if
    it exists, specifies how to initialize Emacs for you.  If the file
    ‘~/.config/emacs/init.el’ exists, it is used as the init file;
    otherwise Emacs may look at ‘~/.emacs.el’, ‘~/.emacs’,
    ‘~/.emacs.d/init.el’, or other locations.  *Note Find Init::.

So [[info:emacs#Find Init]] says that `~/.emacs.d' and `~/.emacs' are
preferred, while [[info:emacs#Init File]] says that
`~/.config/emacs/init.el' is preferred.

Regards

In GNU Emacs 27.0.91 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.24.5)
 of 2020-07-13 built on jorge--inspiron-5570
Repository revision: d24e56a5e4959f82b3da0dfac9ee3c428e077cbd
Repository branch: emacs-27
Windowing system distributor 'The X.Org Foundation', version 11.0.12004000
System Description: Debian GNU/Linux 10 (buster)

Recent messages:
Starting new Ispell process /home/jorge/.guix-profile/bin/enchant-2 with en_US dictionary...done
Mark set
Mark saved where search started
Ispell process killed
Starting new Ispell process /home/jorge/.guix-profile/bin/enchant-2 with pt_BR dictionary...done
Saving file /home/jorge/private/org/registro-dia.txt...
Wrote /home/jorge/private/org/registro-dia.txt

dumb


Configured using:
 'configure --with-mailutils --with-modules
 --enable-link-time-optimization'

Configured features:
XPM JPEG TIFF GIF PNG RSVG SOUND GPM DBUS GSETTINGS GLIB NOTIFY INOTIFY
ACL LIBSELINUX GNUTLS LIBXML2 FREETYPE HARFBUZZ M17N_FLT LIBOTF XFT ZLIB
TOOLKIT_SCROLL_BARS GTK3 X11 XDBE XIM MODULES THREADS LIBSYSTEMD JSON
PDUMPER LCMS2 GMP

Important settings:
  value of $LC_MONETARY: pt_BR.UTF-8
  value of $LC_NUMERIC: pt_BR.UTF-8
  value of $LC_TIME: pt_BR.UTF-8
  value of $LANG: en_US.UTF-8
  locale-coding-system: utf-8-unix

Major mode: Info

Minor modes in effect:
  semantic-minor-modes-format: ((:eval (if (or semantic-highlight-edits-mode semantic-show-unmatched-syntax-mode)  S)))
  global-edit-server-edit-mode: t
  csv-field-index-mode: t
  auto-correct-mode: t
  global-hl-line-mode: t
  shell-dirtrack-mode: t
  winner-mode: t
  savehist-mode: t
  recentf-mode: t
  ido-everywhere: t
  global-tab-line-mode: t
  tab-line-mode: t
  auto-insert-mode: t
  which-key-mode: t
  pdf-occur-global-minor-mode: t
  tooltip-mode: t
  global-eldoc-mode: t
  electric-indent-mode: t
  mouse-wheel-mode: t
  tool-bar-mode: t
  tab-bar-mode: t
  menu-bar-mode: t
  file-name-shadow-mode: t
  global-font-lock-mode: t
  font-lock-mode: t
  blink-cursor-mode: t
  auto-composition-mode: t
  auto-encryption-mode: t
  auto-compression-mode: t
  buffer-read-only: t
  size-indication-mode: t
  column-number-mode: t
  line-number-mode: t
  transient-mark-mode: t

Load-path shadows:
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ol-w3m hides /usr/local/share/emacs/27.0.91/lisp/org/ol-w3m
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-lua hides /usr/local/share/emacs/27.0.91/lisp/org/ob-lua
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-tangle hides /usr/local/share/emacs/27.0.91/lisp/org/ob-tangle
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ox-man hides /usr/local/share/emacs/27.0.91/lisp/org/ox-man
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-screen hides /usr/local/share/emacs/27.0.91/lisp/org/ob-screen
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-eshell hides /usr/local/share/emacs/27.0.91/lisp/org/ob-eshell
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-maxima hides /usr/local/share/emacs/27.0.91/lisp/org/ob-maxima
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-lisp hides /usr/local/share/emacs/27.0.91/lisp/org/ob-lisp
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-entities hides /usr/local/share/emacs/27.0.91/lisp/org/org-entities
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-num hides /usr/local/share/emacs/27.0.91/lisp/org/org-num
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-pcomplete hides /usr/local/share/emacs/27.0.91/lisp/org/org-pcomplete
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-crypt hides /usr/local/share/emacs/27.0.91/lisp/org/org-crypt
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-agenda hides /usr/local/share/emacs/27.0.91/lisp/org/org-agenda
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-groovy hides /usr/local/share/emacs/27.0.91/lisp/org/ob-groovy
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-keys hides /usr/local/share/emacs/27.0.91/lisp/org/org-keys
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ol-gnus hides /usr/local/share/emacs/27.0.91/lisp/org/ol-gnus
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-tempo hides /usr/local/share/emacs/27.0.91/lisp/org/org-tempo
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-table hides /usr/local/share/emacs/27.0.91/lisp/org/ob-table
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ox-latex hides /usr/local/share/emacs/27.0.91/lisp/org/ox-latex
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-element hides /usr/local/share/emacs/27.0.91/lisp/org/org-element
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-comint hides /usr/local/share/emacs/27.0.91/lisp/org/ob-comint
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-goto hides /usr/local/share/emacs/27.0.91/lisp/org/org-goto
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-octave hides /usr/local/share/emacs/27.0.91/lisp/org/ob-octave
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-plantuml hides /usr/local/share/emacs/27.0.91/lisp/org/ob-plantuml
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ox-beamer hides /usr/local/share/emacs/27.0.91/lisp/org/ox-beamer
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ol-eww hides /usr/local/share/emacs/27.0.91/lisp/org/ol-eww
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-lint hides /usr/local/share/emacs/27.0.91/lisp/org/org-lint
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-macs hides /usr/local/share/emacs/27.0.91/lisp/org/org-macs
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-shell hides /usr/local/share/emacs/27.0.91/lisp/org/ob-shell
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-processing hides /usr/local/share/emacs/27.0.91/lisp/org/ob-processing
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ol-bbdb hides /usr/local/share/emacs/27.0.91/lisp/org/ol-bbdb
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-indent hides /usr/local/share/emacs/27.0.91/lisp/org/org-indent
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-habit hides /usr/local/share/emacs/27.0.91/lisp/org/org-habit
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-ebnf hides /usr/local/share/emacs/27.0.91/lisp/org/ob-ebnf
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ol-eshell hides /usr/local/share/emacs/27.0.91/lisp/org/ol-eshell
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-gnuplot hides /usr/local/share/emacs/27.0.91/lisp/org/ob-gnuplot
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ox-ascii hides /usr/local/share/emacs/27.0.91/lisp/org/ox-ascii
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-haskell hides /usr/local/share/emacs/27.0.91/lisp/org/ob-haskell
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ox-icalendar hides /usr/local/share/emacs/27.0.91/lisp/org/ox-icalendar
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-capture hides /usr/local/share/emacs/27.0.91/lisp/org/org-capture
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-org hides /usr/local/share/emacs/27.0.91/lisp/org/ob-org
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-feed hides /usr/local/share/emacs/27.0.91/lisp/org/org-feed
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-datetree hides /usr/local/share/emacs/27.0.91/lisp/org/org-datetree
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-src hides /usr/local/share/emacs/27.0.91/lisp/org/org-src
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-mouse hides /usr/local/share/emacs/27.0.91/lisp/org/org-mouse
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-coq hides /usr/local/share/emacs/27.0.91/lisp/org/ob-coq
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-ruby hides /usr/local/share/emacs/27.0.91/lisp/org/ob-ruby
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-R hides /usr/local/share/emacs/27.0.91/lisp/org/ob-R
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-awk hides /usr/local/share/emacs/27.0.91/lisp/org/ob-awk
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ol-info hides /usr/local/share/emacs/27.0.91/lisp/org/ol-info
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-sed hides /usr/local/share/emacs/27.0.91/lisp/org/ob-sed
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-core hides /usr/local/share/emacs/27.0.91/lisp/org/ob-core
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-lob hides /usr/local/share/emacs/27.0.91/lisp/org/ob-lob
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-emacs-lisp hides /usr/local/share/emacs/27.0.91/lisp/org/ob-emacs-lisp
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-calc hides /usr/local/share/emacs/27.0.91/lisp/org/ob-calc
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ol hides /usr/local/share/emacs/27.0.91/lisp/org/ol
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ox hides /usr/local/share/emacs/27.0.91/lisp/org/ox
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-footnote hides /usr/local/share/emacs/27.0.91/lisp/org/org-footnote
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-ref hides /usr/local/share/emacs/27.0.91/lisp/org/ob-ref
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-id hides /usr/local/share/emacs/27.0.91/lisp/org/org-id
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ol-rmail hides /usr/local/share/emacs/27.0.91/lisp/org/ol-rmail
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-faces hides /usr/local/share/emacs/27.0.91/lisp/org/org-faces
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-vala hides /usr/local/share/emacs/27.0.91/lisp/org/ob-vala
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-ditaa hides /usr/local/share/emacs/27.0.91/lisp/org/ob-ditaa
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-fortran hides /usr/local/share/emacs/27.0.91/lisp/org/ob-fortran
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-js hides /usr/local/share/emacs/27.0.91/lisp/org/ob-js
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob hides /usr/local/share/emacs/27.0.91/lisp/org/ob
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-colview hides /usr/local/share/emacs/27.0.91/lisp/org/org-colview
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ol-irc hides /usr/local/share/emacs/27.0.91/lisp/org/ol-irc
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-css hides /usr/local/share/emacs/27.0.91/lisp/org/ob-css
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-ledger hides /usr/local/share/emacs/27.0.91/lisp/org/ob-ledger
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-makefile hides /usr/local/share/emacs/27.0.91/lisp/org/ob-makefile
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-forth hides /usr/local/share/emacs/27.0.91/lisp/org/ob-forth
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-ocaml hides /usr/local/share/emacs/27.0.91/lisp/org/ob-ocaml
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-sql hides /usr/local/share/emacs/27.0.91/lisp/org/ob-sql
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-ctags hides /usr/local/share/emacs/27.0.91/lisp/org/org-ctags
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-macro hides /usr/local/share/emacs/27.0.91/lisp/org/org-macro
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-picolisp hides /usr/local/share/emacs/27.0.91/lisp/org/ob-picolisp
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-protocol hides /usr/local/share/emacs/27.0.91/lisp/org/org-protocol
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-duration hides /usr/local/share/emacs/27.0.91/lisp/org/org-duration
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-io hides /usr/local/share/emacs/27.0.91/lisp/org/ob-io
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-perl hides /usr/local/share/emacs/27.0.91/lisp/org/ob-perl
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-timer hides /usr/local/share/emacs/27.0.91/lisp/org/org-timer
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-install hides /usr/local/share/emacs/27.0.91/lisp/org/org-install
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-compat hides /usr/local/share/emacs/27.0.91/lisp/org/org-compat
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-dot hides /usr/local/share/emacs/27.0.91/lisp/org/ob-dot
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-version hides /usr/local/share/emacs/27.0.91/lisp/org/org-version
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-scheme hides /usr/local/share/emacs/27.0.91/lisp/org/ob-scheme
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-python hides /usr/local/share/emacs/27.0.91/lisp/org/ob-python
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-mobile hides /usr/local/share/emacs/27.0.91/lisp/org/org-mobile
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-abc hides /usr/local/share/emacs/27.0.91/lisp/org/ob-abc
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-loaddefs hides /usr/local/share/emacs/27.0.91/lisp/org/org-loaddefs
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-asymptote hides /usr/local/share/emacs/27.0.91/lisp/org/ob-asymptote
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ox-md hides /usr/local/share/emacs/27.0.91/lisp/org/ox-md
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org hides /usr/local/share/emacs/27.0.91/lisp/org/org
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-C hides /usr/local/share/emacs/27.0.91/lisp/org/ob-C
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-archive hides /usr/local/share/emacs/27.0.91/lisp/org/org-archive
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ol-bibtex hides /usr/local/share/emacs/27.0.91/lisp/org/ol-bibtex
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-mscgen hides /usr/local/share/emacs/27.0.91/lisp/org/ob-mscgen
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ox-texinfo hides /usr/local/share/emacs/27.0.91/lisp/org/ox-texinfo
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ol-docview hides /usr/local/share/emacs/27.0.91/lisp/org/ol-docview
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-attach-git hides /usr/local/share/emacs/27.0.91/lisp/org/org-attach-git
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-clock hides /usr/local/share/emacs/27.0.91/lisp/org/org-clock
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-plot hides /usr/local/share/emacs/27.0.91/lisp/org/org-plot
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ol-mhe hides /usr/local/share/emacs/27.0.91/lisp/org/ol-mhe
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-clojure hides /usr/local/share/emacs/27.0.91/lisp/org/ob-clojure
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-exp hides /usr/local/share/emacs/27.0.91/lisp/org/ob-exp
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-attach hides /usr/local/share/emacs/27.0.91/lisp/org/org-attach
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-lilypond hides /usr/local/share/emacs/27.0.91/lisp/org/ob-lilypond
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ox-html hides /usr/local/share/emacs/27.0.91/lisp/org/ox-html
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ox-org hides /usr/local/share/emacs/27.0.91/lisp/org/ox-org
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-eval hides /usr/local/share/emacs/27.0.91/lisp/org/ob-eval
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-hledger hides /usr/local/share/emacs/27.0.91/lisp/org/ob-hledger
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-latex hides /usr/local/share/emacs/27.0.91/lisp/org/ob-latex
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-list hides /usr/local/share/emacs/27.0.91/lisp/org/org-list
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-sqlite hides /usr/local/share/emacs/27.0.91/lisp/org/ob-sqlite
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-matlab hides /usr/local/share/emacs/27.0.91/lisp/org/ob-matlab
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-stan hides /usr/local/share/emacs/27.0.91/lisp/org/ob-stan
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-J hides /usr/local/share/emacs/27.0.91/lisp/org/ob-J
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ox-odt hides /usr/local/share/emacs/27.0.91/lisp/org/ox-odt
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-table hides /usr/local/share/emacs/27.0.91/lisp/org/org-table
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/org-inlinetask hides /usr/local/share/emacs/27.0.91/lisp/org/org-inlinetask
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-sass hides /usr/local/share/emacs/27.0.91/lisp/org/ob-sass
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-shen hides /usr/local/share/emacs/27.0.91/lisp/org/ob-shen
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ox-publish hides /usr/local/share/emacs/27.0.91/lisp/org/ox-publish
/home/jorge/.config/emacs/elpa/org-plus-contrib-20200713/ob-java hides /usr/local/share/emacs/27.0.91/lisp/org/ob-java

Features:
(shadow mail-extr emacsbug sendmail tramp-cmds rfc2104 tramp-cache avy
server help-at-pt descr-text python tramp-sh tramp tramp-loaddefs
trampver tramp-integration tramp-compat ls-lisp ebdb-i18n
ebdb-i18n-basic ebdb-org ebdb-com ebdb-format ebdb eieio-base repeat
pcmpl-unix pdf-sync pdf-annot pdf-outline pdf-links pdf-history cl-print
eww mm-url url-queue magit-utils dash ob-ditaa ob-eukleides ob-plantuml
org-checklist org-collector org-colview org-crypt org-invoice org-learn
org-mac-link org-mairix org-toc ox-extra sgml-mode edit-server org-drill
persist hippie-exp org-expiry calccomp calc-alg files-x checkdoc
flymake-proc flymake pulse grep ffap org-goto cal-move calc-prog
calc-misc calc-vec calc-forms calc-menu calc-aent ox-org AAD-csv
csv-mode csv AAD timezone AAD-misc num3-mode view notmuch-jump shr-color
color smerge-mode diff two-column iso-transl eieio-opt speedbar sb-image
ezimage dframe help-fns cl-extra char-fold yasnippet help-mode
company-oddmuse company-keywords company-etags etags fileloop xref
project company-gtags company-dabbrev-code company-dabbrev company-files
company-capf company-cmake company-xcode company-clang company-semantic
company-eclim company-template company-bbdb company whitespace flyspell
ispell captain auto-correct misearch multi-isearch emms-librefm-stream
emms-librefm-scrobbler emms-playlist-limit emms-volume
emms-volume-mixerctl emms-volume-pulse emms-volume-amixer emms-i18n
emms-history emms-score emms-stream-info emms-metaplaylist-mode
emms-bookmarks emms-cue emms-mode-line-icon emms-browser sort
emms-playlist-sort emms-last-played emms-player-xine emms-player-mpd
emms-playing-time emms-lyrics emms-url emms-streams emms-show-all
emms-tag-editor emms-mark emms-mode-line emms-cache emms-info-tinytag
emms-info-metaflac emms-info-opusinfo emms-info-ogginfo
emms-info-mp3info emms-info later-do emms-playlist-mode emms-player-vlc
emms-player-mpv emms-player-mplayer emms-player-simple
emms-source-playlist emms-source-file locate emms-setup emms emms-compat
notmuch hl-line notmuch-hello notmuch-tree notmuch-show notmuch-print
notmuch-crypto notmuch-mua notmuch-message notmuch-draft
notmuch-maildir-fcc notmuch-address notmuch-company notmuch-parser
notmuch-wash coolj notmuch-query goto-addr thingatpt icalendar
notmuch-tag crm notmuch-lib notmuch-compat appt cal-iso cal-china lunar
solar cal-dst cal-islam cal-hebrew cal-julian holidays hol-loaddefs
diary-lib diary-loaddefs org-duration org-eldoc org-indent face-remap
ol-notmuch org-depend ol-w3m ol-rmail ol-irc ol-info org-habit ol-eww
ol-docview dabbrev org-clock tempo term disp-table ehelp ox-odt rng-loc
rng-uri rng-parse rng-match rng-dt rng-util rng-pttrn nxml-parse nxml-ns
nxml-enc xmltok nxml-util ox-md ox-latex ox-icalendar ox-html table
ox-ascii ox-publish ox org-element avl-tree generator org-capture
org-agenda gnus-art mm-uu mml2015 mm-view mml-smime smime dig ol-bibtex
vc-git diff-mode org-attach org-id nnir esh-mode doc-view bibtex cl
shell ob-octave eshell esh-cmd esh-ext esh-opt esh-proc esh-io esh-arg
esh-module esh-groups esh-util ebnf2ps ps-print ps-print-loaddefs ps-def
lpr ob-clojure calc-store calc-trail calc-ext calc calc-loaddefs
calc-macs warnings J-org J-org-minimal org org-macro org-footnote
org-pcomplete pcomplete org-list org-faces org-entities noutline outline
org-version ob-emacs-lisp org-table org-loaddefs cal-menu calendar
cal-loaddefs gnus-sum shr svg xml dom gnus-group gnus-undo gnus-start
gnus-cloud nnimap nnmail mail-source utf7 netrc nnoo parse-time iso8601
gnus-spec gnus-int gnus-range gnus-win gnus nnheader ob ob-tangle ol
org-src ob-ref ob-lob ob-table ob-exp ob-comint ob-core ob-eval org-keys
org-compat org-macs cc-mode cc-fonts cc-guess cc-menus cc-cmds cc-styles
cc-align cc-engine cc-vars cc-defs easy-mmode autoload radix-tree
lisp-mnt tar-mode arc-mode archive-mode mm-archive message rfc822 mml
mml-sec epa derived gnus-util rmail rmail-loaddefs time-date mailabbrev
gmm-utils mailheader mm-decode mm-bodies mm-encode mail-utils mule-util
gnutls network-stream url-http mail-parse rfc2231 rfc2047 rfc2045
mm-util ietf-drums mail-prsvr url-gw nsm rmc puny url-cache url-auth url
url-proxy url-privacy url-expand url-methods url-history url-cookie
url-domsuf url-util mailcap epg epg-config finder-inf winner savehist
recentf tree-widget image-file ido tab-line autoinsert pcase which-key
J-markdown J-local-host--email J-private J-bc edmacro kmacro dired-aux
pdf-occur ibuf-ext ibuffer ibuffer-loaddefs tablist tablist-filter
semantic/wisent/comp semantic/wisent semantic/wisent/wisent
semantic/util-modes semantic/util semantic semantic/tag semantic/lex
semantic/fw mode-local find-func cedet pdf-isearch let-alist pdf-misc
imenu pdf-tools compile comint ansi-color ring cus-edit cus-start
cus-load wid-edit pdf-view bookmark text-property-search pp jka-compr
pdf-cache pdf-info tq pdf-util advice format-spec image-mode exif
dired-x dired dired-loaddefs gnu-elpa-features rx info package easymenu
browse-url url-handlers url-parse auth-source cl-seq eieio eieio-core
cl-macs eieio-loaddefs password-cache json subr-x map url-vars seq
byte-opt gv bytecomp byte-compile cconv cl-loaddefs cl-lib tooltip eldoc
electric uniquify ediff-hook vc-hooks lisp-float-type mwheel term/x-win
x-win term/common-win x-dnd tool-bar dnd fontset image regexp-opt fringe
tabulated-list replace newcomment text-mode elisp-mode lisp-mode
prog-mode register page tab-bar menu-bar rfn-eshadow isearch timer
select scroll-bar mouse jit-lock font-lock syntax facemenu font-core
term/tty-colors frame minibuffer cl-generic cham georgian utf-8-lang
misc-lang vietnamese tibetan thai tai-viet lao korean japanese eucjp-ms
cp51932 hebrew greek romanian slovak czech european ethiopic indian
cyrillic chinese composite charscript charprop case-table epa-hook
jka-cmpr-hook help simple abbrev obarray cl-preloaded nadvice loaddefs
button faces cus-face macroexp files text-properties overlay sha1 md5
base64 format env code-pages mule custom widget hashtable-print-readable
backquote threads dbusbind inotify lcms2 dynamic-setting
system-font-setting font-render-setting move-toolbar gtk x-toolkit x
multi-tty make-network-process emacs)

Memory information:
((conses 16 4432427 611502)
 (symbols 48 76130 638)
 (strings 32 568118 28818)
 (string-bytes 1 22108359)
 (vectors 16 135596)
 (vector-slots 8 2739125 475650)
 (floats 8 2196 1999)
 (intervals 56 475468 12580)
 (buffers 1000 138))

-- 
- <https://jorgemorais.gitlab.io/justice-for-rms/>
- If an email of mine arrives at your spam box, please notify me.
- Please adopt free/libre formats like PDF, ODF, Org, LaTeX, Opus, WebM and 7z.
- Free/libre software for Replicant, LineageOS and Android: https://f-droid.org
- [[https://www.gnu.org/philosophy/free-sw.html][What is free software?]]




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#42388; Package emacs. (Thu, 16 Jul 2020 17:01:02 GMT) Full text and rfc822 format available.

Message #8 received at 42388 <at> debbugs.gnu.org (full text, mbox):

From: Robert Pluim <rpluim <at> gmail.com>
To: "Jorge P. de Morais Neto" <jorge <at> disroot.org>
Cc: 42388 <at> debbugs.gnu.org
Subject: Re: bug#42388: 27.0.91; Manual is inconsistent about default init
 file location
Date: Thu, 16 Jul 2020 19:00:04 +0200
>>>>> On Thu, 16 Jul 2020 07:23:36 -0300, "Jorge P. de Morais Neto" <jorge <at> disroot.org> said:

    Jorge> The manual at [[info:emacs#Find Init]] says:

    Jorge>        Emacs can also look in an XDG-compatible location for ‘init.el’,
    Jorge>     the default is the directory ‘~/.config/emacs’.  This can be
    Jorge>     overriden by setting ‘XDG_CONFIG_HOME’ in your environment, its
    Jorge>     value replaces ‘~/.config’ in the name of the default XDG init file.
    Jorge>     However ‘~/.emacs.d’ and ‘~/.emacs’ are always preferred if they
    Jorge>     exist, which means that you must delete or rename them in order to
    Jorge>     use the XDG location.

    Jorge> However, at [[info:emacs#Init File]] it says:

    Jorge>     When Emacs is started, it normally tries to load a Lisp program from
    Jorge>     an “initialization file”, or “init file” for short.  This file, if
    Jorge>     it exists, specifies how to initialize Emacs for you.  If the file
    Jorge>     ‘~/.config/emacs/init.el’ exists, it is used as the init file;
    Jorge>     otherwise Emacs may look at ‘~/.emacs.el’, ‘~/.emacs’,
    Jorge>     ‘~/.emacs.d/init.el’, or other locations.  *Note Find Init::.

    Jorge> So [[info:emacs#Find Init]] says that `~/.emacs.d' and `~/.emacs' are
    Jorge> preferred, while [[info:emacs#Init File]] says that
    Jorge> `~/.config/emacs/init.el' is preferred.

Yes, that is indeed inconsistent, I missed that part of the manual
when flipping the XDG preference.

I thought this would be a simple change, but as ever the rabbit hole
was deep. Based on testing '~/.emacs.el' is preferred to '~/.emacs',
is that expected? Anyway, I came up with the following:

diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi
index 719e09e861..00c8ee4f98 100644
--- a/doc/emacs/custom.texi
+++ b/doc/emacs/custom.texi
@@ -2252,10 +2252,13 @@ Init File
   When Emacs is started, it normally tries to load a Lisp program from
 an @dfn{initialization file}, or @dfn{init file} for short.  This
 file, if it exists, specifies how to initialize Emacs for you.
-If the file @file{~/.config/emacs/init.el} exists, it is used as the
-init file; otherwise Emacs may look at @file{~/.emacs.el},
-@file{~/.emacs}, @file{~/.emacs.d/init.el}, or other locations.
-@xref{Find Init}.
+Traditionally, file @file{~/.emacs} is used as the init file, although
+Emacs also looks at @file{~/.emacs.el}, @file{~/.emacs.d/init.el},
+@file{~/.config/emacs/init.el}, or other locations.  @xref{Find Init}.
+
+You may find it convenient to have all your Emacs configuration in one
+directory, in which case you should use @file{~/.emacs.d/init.el} or
+the XDG-compatible @file{~/.config/emacs/init.el}.
 
   You can use the command line switch @samp{-q} to prevent loading
 your init file, and @samp{-u} (or @samp{--user}) to specify a
@@ -2661,23 +2664,21 @@ Find Init
 @subsection How Emacs Finds Your Init File
 
   Emacs normally finds your init file in a location under your home
-directory.  @xref{Init File}.  By default this location is
-@file{~/.emacs.d/init.el} where @file{~/} stands for your home directory.
-This default can be overridden as described below.
+directory.  @xref{Init File}.
 
-Emacs looks for your init file
-using the filenames @file{~/.emacs.el}, @file{~/.emacs}, or
-@file{~/.emacs.d/init.el}; you can choose to use any one of these
-names.  (Note that only the locations directly in your home directory
-have a leading dot in the location's basename.)
+  Emacs looks for your init file using the filenames @file{~/.emacs.el},
+@file{~/.emacs}, or @file{~/.emacs.d/init.el} in that order; you can
+choose to use any one of these names.  (Note that only the locations
+directly in your home directory have a leading dot in the location's
+basename.)
 
 Emacs can also look in an XDG-compatible location for @file{init.el},
 the default is the directory @file{~/.config/emacs}.  This can be
 overriden by setting @env{XDG_CONFIG_HOME} in your environment, its
 value replaces @file{~/.config} in the name of the default XDG init
-file.  However @file{~/.emacs.d} and @file{~/.emacs} are always
-preferred if they exist, which means that you must delete or rename
-them in order to use the XDG location.
+file.  However @file{~/.emacs.d}, @file{~/.emacs}, and
+@file{~/.emacs.el} are always preferred if they exist, which means
+that you must delete or rename them in order to use the XDG location.
 
 Note also that if neither the XDG location nor @file{~/.emacs.d}
 exist, then Emacs will create @file{~/.emacs.d} (and therefore use it




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#42388; Package emacs. (Thu, 16 Jul 2020 19:28:02 GMT) Full text and rfc822 format available.

Message #11 received at 42388 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Robert Pluim <rpluim <at> gmail.com>
Cc: jorge <at> disroot.org, 42388 <at> debbugs.gnu.org
Subject: Re: bug#42388: 27.0.91;
 Manual is inconsistent about default init file location
Date: Thu, 16 Jul 2020 22:27:37 +0300
> From: Robert Pluim <rpluim <at> gmail.com>
> Date: Thu, 16 Jul 2020 19:00:04 +0200
> Cc: 42388 <at> debbugs.gnu.org
> 
> Yes, that is indeed inconsistent, I missed that part of the manual
> when flipping the XDG preference.
> 
> I thought this would be a simple change, but as ever the rabbit hole
> was deep. Based on testing '~/.emacs.el' is preferred to '~/.emacs',
> is that expected? Anyway, I came up with the following:

LGTM, please install on the release branch.

Thanks.




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#42388; Package emacs. (Fri, 17 Jul 2020 13:11:02 GMT) Full text and rfc822 format available.

Message #14 received at 42388 <at> debbugs.gnu.org (full text, mbox):

From: Robert Pluim <rpluim <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: jorge <at> disroot.org, 42388 <at> debbugs.gnu.org
Subject: Re: bug#42388: 27.0.91; Manual is inconsistent about default init
 file location
Date: Fri, 17 Jul 2020 15:10:27 +0200
>>>>> On Thu, 16 Jul 2020 22:27:37 +0300, Eli Zaretskii <eliz <at> gnu.org> said:
    >> I thought this would be a simple change, but as ever the rabbit hole
    >> was deep. Based on testing '~/.emacs.el' is preferred to '~/.emacs',
    >> is that expected? Anyway, I came up with the following:

    Eli> LGTM, please install on the release branch.

Done as f50d79af6b

Robert




bug marked as fixed in version 27.1, send any further explanations to 42388 <at> debbugs.gnu.org and "Jorge P. de Morais Neto" <jorge <at> disroot.org> Request was from Robert Pluim <rpluim <at> gmail.com> to control <at> debbugs.gnu.org. (Fri, 17 Jul 2020 13:12:01 GMT) Full text and rfc822 format available.

bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Sat, 15 Aug 2020 11:24:07 GMT) Full text and rfc822 format available.

This bug report was last modified 3 years and 255 days ago.

Previous Next


GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.