From mboxrd@z Thu Jan  1 00:00:00 1970
From: Glyn Millington <glyn.millington@gmail.com>
Subject: Re: Org-mode documentation within Emacs
Date: Tue, 23 Apr 2013 16:58:14 +0100
Message-ID: <87a9opxmqx.fsf@nowhere.org>
References: <2013-04-23T15-56-22@devnull.Karl-Voit.at>
	<m2k3nt7244.fsf@polytechnique.org> <86li89p9w8.fsf@somewhere.org>
	<m2k3ntl183.fsf@polytechnique.org>
Reply-To: glyn.millington@gmail.com
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([208.118.235.92]:51888)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <geo-emacs-orgmode@m.gmane.org>) id 1UUfne-0003mD-V3
	for emacs-orgmode@gnu.org; Tue, 23 Apr 2013 12:10:39 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <geo-emacs-orgmode@m.gmane.org>) id 1UUfnZ-0003EF-Tn
	for emacs-orgmode@gnu.org; Tue, 23 Apr 2013 12:10:34 -0400
Received: from plane.gmane.org ([80.91.229.3]:58619)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <geo-emacs-orgmode@m.gmane.org>) id 1UUfnZ-0003Dt-Mo
	for emacs-orgmode@gnu.org; Tue, 23 Apr 2013 12:10:29 -0400
Received: from list by plane.gmane.org with local (Exim 4.69)
	(envelope-from <geo-emacs-orgmode@m.gmane.org>) id 1UUfnX-0008VR-4q
	for emacs-orgmode@gnu.org; Tue, 23 Apr 2013 18:10:27 +0200
Received: from cust25-dsl91-135-3.idnet.net ([91.135.3.25])
	by main.gmane.org with esmtp (Gmexim 0.1 (Debian))
	id 1AlnuQ-0007hv-00
	for <emacs-orgmode@gnu.org>; Tue, 23 Apr 2013 18:10:27 +0200
Received: from glyn.millington by cust25-dsl91-135-3.idnet.net with local
	(Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00
	for <emacs-orgmode@gnu.org>; Tue, 23 Apr 2013 18:10:27 +0200
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: emacs-orgmode@gnu.org

Alan Schmitt <alan.schmitt@polytechnique.org> 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