Re: Org-mode documentation within Emacs

[Eric S Fraga <e.fraga@ucl.ac.uk>]

Alan Schmitt <alan.schmitt@polytechnique.org> writes:

> Sebastien Vauban writes:
>
>> Don't play with `Info-directory-list', it's not intended to be settable by the
>> user. Set the `Info-default-directory-list' variable instead.
>
> I just tried it, and now I no longer have org in my info directory. Here
> is the value of Info-default-directory-list
>
> ("/Users/schmitta/.emacs.d/org/info"
> "/usr/local/Cellar/emacs-mac/emacs-24.3-mac-4.1/share/info/emacs/"
> "/usr/share/info/")
>
> and here is the value of Info-directory-list
>
> ("/Users/schmitta/.emacs.d/elpa/auctex-11.86" "/usr/share/info/")
>
> As it's the latter that is used to find the info files, it means that it
> won't find org. It seems that it is initialized before my initialization
> file can add the directory to the default value. (I'm using the startup
> kit, if it makes a difference.)
>
> I just read the help on "Info-directory-list", and it does not say I
> should not set it. Why is it bad? And how should I make emacs pick up
> the value from default?

I have

:    (add-to-list 'Info-directory-list "~/git/org-mode/doc/")

in my emacs customisation and have had for a very long time.  I've
always modified Info-directory-list and have never had a problem.  YMMV,
of course.

However, the documentation (in emacs 24.3.50 as that's what I am using
on this laptop...) for Info-default-directory-list says:

,----
| Although this is a customizable variable, that is mainly for technical
| reasons.  Normally, you should either set INFOPATH or customize
| `Info-additional-directory-list', rather than changing this variable.
`----

so maybe set the Info-additional-directory-list variable?  I've not
tried this.

-- 
: Eric S Fraga, GnuPG: 0xC89193D8FFFCF67D
: in Emacs 24.3.50.1 and Org release_7.9.3f-1199-g3a0e55