Re: [O] Org-mode documentation within Emacs

[Glyn Millington]

Alan Schmitt <address@hidden> writes:

> Sebastien Vauban writes:
>
>> Hi Alan,
>> Alan Schmitt wrote:
>>> Karl Voit writes:
>>>
>>>> The repository[1] does contain the doc-directory. I compiled the
>>>> whole Org-mode repos including the doc sub-tree. So no compile
>>>> error while the docu is generated.
>>>> "C-h i" was my first guess but it does not list Org-mode at all
>>>> :-(
>>> This is what I have in my configuration files:
>>> #+BEGIN_SRC emacs-lisp (add-to-list 'Info-directory-list
>>> "/Users/schmitta/.emacs.d/org/info") #+END_SRC
>> 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?
>
> Thanks,
>
> Alan

Hi Alan,

This is how I do it.



1. Compile the .texi source
     i.e. makeinfo org.texi

(You should find org.texi in the doc directory)

That will result in a file simply called "org"

2. Put it into the right directory - can be  /home/glyn/info
3. Use install-info to edit file
  
   ie - in ~/info 

   install-info org dir

   where dir is the local info header file :-)   

I also have this in my init.el

(setq Info-default-directory-list (cons "/home/glyn/info/" 
Info-default-directory-list))

Then it should appear in Emacs' info-reader


atb



Glyn