How to update "Info Documentation"?

How to update "Info Documentation"?

[Johan Ekh]

[-- Attachment #1: Type: text/plain, Size: 262 bytes --]

Hi all,
I keep up to date with org-mode using:

git pull && make clean && make && make doc && make install

It works very well except that my "Info Documentation" is not updated.
It is still some old version.

What do I have to do to get it updated?

BR / Johan

[-- Attachment #2: Type: text/html, Size: 339 bytes --]

Re: How to update "Info Documentation"?

[Walter Franzini]

[-- Attachment #1: Type: text/plain, Size: 609 bytes --]

Johan Ekh <ekh.johan-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:

> Hi all,
> I keep up to date with org-mode using:
>
> git pull && make clean && make && make doc && make install
>
> It works very well except that my "Info Documentation" is not updated.
> It is still some old version.

make info

and add the following snippet to you .emacs.el:

;; add documentation from the git clone
(eval-after-load "info"
  '(progn
     (info-initialize)                  
     (add-to-list 'Info-directory-list "~/lisp/org-mode/doc")))

hth
-- 
Walter Franzini
http://aegis.stepbuild.org/

[-- Attachment #2: Type: application/pgp-signature, Size: 197 bytes --]

Re: How to update "Info Documentation"?

[suvayu ali]

On Fri, Jul 29, 2011 at 11:34 AM, Johan Ekh <ekh.johan@gmail.com> wrote:
> Hi all,
> I keep up to date with org-mode using:
>
> git pull && make clean && make && make doc && make install
>
> It works very well except that my "Info Documentation" is not updated.
> It is still some old version.
>
> What do I have to do to get it updated?
>

3 options:

1. Set this variable to the appropriate path in your init file

;; Info directory
(add-to-list 'Info-default-directory-list
          (expand-file-name "/opt/emacs-lisp/share/info"))

2. Add to the INFOPATH variable in your shell profile file:

e.g. (bash)
~/.bash_profile
..
export INFOPATH=/opt/emacs-lisp/share/info:$INFOPATH

3. Edit your Makefile to reflect the proper infopath

# Where local software is found
prefix=/opt/emacs-lisp

..

# Where info files go.
infodir = $(prefix)/share/info


> BR / Johan
>

Hope this helps.

-- 
Suvayu

Open source is the future. It sets us free.

Re: How to update "Info Documentation"?

[Jude DaShiell]

1) make sure prefix on line 16 of Makefile is set correctly, if your real 
   prefix is /usr, that line shouldn't read /usr/local, 2) do make 
   info-install and then do info org and see if the documentation doesn't 
   suddenly update itself.  hth.On Fri, 29 Jul 2011, suvayu ali wrote:

> On Fri, Jul 29, 2011 at 11:34 AM, Johan Ekh <ekh.johan@gmail.com> wrote:
> > Hi all,
> > I keep up to date with org-mode using:
> >
> > git pull && make clean && make && make doc && make install
> >
> > It works very well except that my "Info Documentation" is not updated.
> > It is still some old version.
> >
> > What do I have to do to get it updated?
> >
> 
> 3 options:
> 
> 1. Set this variable to the appropriate path in your init file
> 
> ;; Info directory
> (add-to-list 'Info-default-directory-list
>           (expand-file-name "/opt/emacs-lisp/share/info"))
> 
> 2. Add to the INFOPATH variable in your shell profile file:
> 
> e.g. (bash)
> ~/.bash_profile
> ..
> export INFOPATH=/opt/emacs-lisp/share/info:$INFOPATH
> 
> 3. Edit your Makefile to reflect the proper infopath
> 
> # Where local software is found
> prefix=/opt/emacs-lisp
> 
> ..
> 
> # Where info files go.
> infodir = $(prefix)/share/info
> 
> 
> > BR / Johan
> >
> 
> Hope this helps.
> 
> 

Re: How to update "Info Documentation"?

[suvayu ali]

I updated the FAQ on Worg. Please give comments.

> From e64185198b26904b2edc01fae72ec1d75d4ad75c Mon Sep 17 00:00:00 2001
> From: Suvayu Ali <fatkasuvayu+linux@gmail.com>
> Date: Fri, 29 Jul 2011 12:18:55 +0200
> Subject: [PATCH] FAQ entry on how to update info files

> ---
>  org-faq.org |   41 +++++++++++++++++++++++++++++++++++++++++
>  1 files changed, 41 insertions(+), 0 deletions(-)

> diff --git a/org-faq.org b/org-faq.org
> index 6c0f605..b4e21c7 100644
> --- a/org-faq.org
> +++ b/org-faq.org
> @@ -356,6 +356,47 @@ options.
>        reduces the size of the repository and speeds up data access to
>        the objects.

> +** How do I update the info manual pages to the latest org-mode version?
> +
> +   Since org-mode already ships with Emacs, a rather common problem
> +   among users is "How do I update the info documentation to the
> +   latest version of org-mode?". There are three ways to achieve this:
> +
> +   1. You can set the =INFOPATH= environment variable in your login
> +      script like this:
> +
> +      #+begin_src shell-script :eval no
> +        # ~/.bash_profile
> +        export INFOPATH=/path/to/org-mode/info:$INFOPATH
> +        ...
> +      #+end_src
> +
> +      =/path/to/org-mode/info= is wherever you install org-mode.
> +
> +   2. You can achieve the same with elisp like this:
> +
> +      #+begin_src emacs-lisp :eval no
> +        ;; Info directory
> +        (add-to-list 'Info-default-directory-list
> +                     (expand-file-name "/path/to/org-mode/info"))
> +      #+end_src
> +
> +   3. You can also specify this in the Makefile while installing
> +      org-mode like this:
> +
> +      #+begin_src makefile-gmake :eval no
> +        # Where local software is found
> +        prefix=/path/to/emacs-root
> +        ...
> +        # Where info files go.
> +        infodir = $(prefix)/share/info
> +      #+end_src
> +
> +      After you install org-mode with =make install=, you can now
> +      install the new info files with =make install-info=. Note that
> +      this method _overwrites_ the old org-mode info files that is
> +      distributed with your version of GNU Emacs.
> +
>  ** How can I keep local changes and still track Org mode development?
>     :PROPERTIES:
>     :CUSTOM_ID: keeping-local-changes-current-with-Org-mode-development
> --
> 1.7.4.4



-- 
Suvayu

Open source is the future. It sets us free.

Re: How to update "Info Documentation"?

[Dave Abrahams]

on Fri Jul 29 2011, suvayu ali <fatkasuvayu+linux-AT-gmail.com> wrote:

> On Fri, Jul 29, 2011 at 11:34 AM, Johan Ekh <ekh.johan@gmail.com> wrote:
>> Hi all,
>> I keep up to date with org-mode using:
>>
>> git pull && make clean && make && make doc && make install
>>
>> It works very well except that my "Info Documentation" is not updated.
>> It is still some old version.
>>
>> What do I have to do to get it updated?
>>
>
> 3 options:

...or you could use <http://github.com/dimitri/el-get>, which takes care
of everything, including info, autoloads, and byte-compilation, and
doesn't require superuser privileges

  `M-x el-get-install RET org-mode RET'
  `M-x el-get-update RET org-mode RET'

Cheers,

-- 
Dave Abrahams
BoostPro Computing
http://www.boostpro.com

Re: How to update "Info Documentation"?

[suvayu ali]

On Fri, Jul 29, 2011 at 6:54 PM, Dave Abrahams <dave@boostpro.com> wrote:
> ...or you could use <http://github.com/dimitri/el-get>, which takes care
> of everything, including info, autoloads, and byte-compilation, and
> doesn't require superuser privileges
>

Is el-get like package.el? In that case how does one track the git
version of org-mode? I think the OP is using the git HEAD.

-- 
Suvayu

Open source is the future. It sets us free.

Re: How to update "Info Documentation"?

[Dave Abrahams]

on Fri Jul 29 2011, suvayu ali <fatkasuvayu+linux-AT-gmail.com> wrote:

> On Fri, Jul 29, 2011 at 6:54 PM, Dave Abrahams <dave@boostpro.com> wrote:
>> ...or you could use <http://github.com/dimitri/el-get>, which takes care
>> of everything, including info, autoloads, and byte-compilation, and
>> doesn't require superuser privileges
>>
>
> Is el-get like package.el? 

Sort of.  

> In that case how does one track the git version of org-mode?
> I think the OP is using the git HEAD.

That's the default.


-- 
Dave Abrahams
BoostPro Computing
http://www.boostpro.com