emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* suggestion for FAQ: clarifying how to upgrade org
@ 2012-09-08 11:29 Robert P. J. Day
  2012-09-08 19:36 ` Memnon Anon
  2012-09-09  0:21 ` Suvayu Ali
  0 siblings, 2 replies; 3+ messages in thread
From: Robert P. J. Day @ 2012-09-08 11:29 UTC (permalink / raw)
  To: emacs org-mode mailing list


  i'm reading the FAQ, section about upgrading org, and it's not clear
what one would do in the following situation.

  i'm running ubuntu 12.04 and in emacs running "M-x org-version" i
get, "version 6.33x".  however, ubuntu has a separate org-mode package
and, after installing that package via "apt-get install" and
restarting emacs, i get "version 7.8.02".

  that seems to work fine.  if that's an acceptable way to upgrade
org, that should probably be mentioned in the FAQ -- that you might
just be able to do a standard, distro-specific install of whatever
represents the org-mode package and emacs will pick it up
automatically.

  just an observation.

rday

p.s.  also curious about the advice here:

http://orgmode.org/worg/org-faq.html#mixed-install

in both cases above, when i asked for "org-version", i didn't get any
"release" info in parentheses.  all i saw was:

  "Org-mode version x.y.z"

which might confuse a reader expecting to see release information.
again, just another observation.

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: suggestion for FAQ: clarifying how to upgrade org
  2012-09-08 11:29 suggestion for FAQ: clarifying how to upgrade org Robert P. J. Day
@ 2012-09-08 19:36 ` Memnon Anon
  2012-09-09  0:21 ` Suvayu Ali
  1 sibling, 0 replies; 3+ messages in thread
From: Memnon Anon @ 2012-09-08 19:36 UTC (permalink / raw)
  To: emacs-orgmode

Hi rpjd,

"Robert P. J. Day" <rpjday@crashcourse.ca> writes:

>   that seems to work fine.  if that's an acceptable way to upgrade
> org, that should probably be mentioned in the FAQ -- that you might
> just be able to do a standard, distro-specific install of whatever
> represents the org-mode package and emacs will pick it up
> automatically.
>
>   just an observation.

That faq is exported from an org file on worg.
Sure, distro specific packages are a viable way to upgrade your org:

Would you like to add it?

If you don't know git, this is the relevant section:

--8<---------------cut here---------------start------------->8---
** My Emacs ships with an older version Org-mode! How do I upgrade?
   :PROPERTIES:
   :CUSTOM_ID: updating-org
   :END:

#+index: Upgrade

Org-mode develops quickly, which means that versions of Org-mode
shipped with Emacs are more or less out-of-date. If you'd like to
upgrade to the most recent version of org-mode, you have a number of
options.

 1. Download the [[http://orgmode.org/index.html#sec-3][most recent release]] of org-mode as zip or tarball and
    follow the [[http://orgmode.org/manual/Installation.html#Installation][installation instructions]] in the manual.
 2. Clone and install the development git repository as [[#keeping-current-with-Org-mode-development][explained
    here]]. If you don't want to run the bleeding edge, you can still
    use git [[#using-stable-releases-only][to track the most recent stable releases]].
 3. Install and updated org-mode automatically through the Emacs
    Package Manager as [[#installing-via-elpa][explained in this FAQ]].

/Note/: Please also see [[#mixed-install][Is my Orgmode installation mixed?]] for a common
issue with mixed installations.
--8<---------------cut here---------------end--------------->8---

Just insert your words and certainly someone will push it :).

otoh, http://orgmode.org/org-mode-download.html (where you are sent to
to to download org) already mentions "Alternate distributions".

> http://orgmode.org/worg/org-faq.html#mixed-install
>
> in both cases above, when i asked for "org-version", i didn't get any
> "release" info in parentheses.  all i saw was:
>
>   "Org-mode version x.y.z"
>
> which might confuse a reader expecting to see release information.
> again, just another observation.

,----[ org-faq.org - Is my Orgmode installation mixed? ]
|                                            An easy first step to
|   investigate this is to look at the output of =M-x org-version=.
|   - Good :: ~Org-mode version 7.8.11 (release_7.8.11-448-g1737d3 @
|             /path/to/org-mode/lisp/)~
|   - Bad :: ~Org-mode version 6.33x (release_7.8.11.409.ga3778)~
`----

org-version got improved to show the release bit in several steps,
starting with

| commit e7d2e4e18694cb8c4bec5a81815bf7ef9c8078a6
| Author: Achim Gratz <Stromeko@Stromeko.DE>
| Date:   Mon May 7 21:21:28 2012 +0200

So, the suggestion in org-faq will only work with org versions later
than May 19.

org-7.8.11, which ships with emacs24, was released ... a couple of days
later. But these changes obviously didn't make it into the bundled
version. Lets be vague then :), what about:

"An easy first step to investigate this /with a recent version/ is to look
 at the output of =M-x org-version=."

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: suggestion for FAQ: clarifying how to upgrade org
  2012-09-08 11:29 suggestion for FAQ: clarifying how to upgrade org Robert P. J. Day
  2012-09-08 19:36 ` Memnon Anon
@ 2012-09-09  0:21 ` Suvayu Ali
  1 sibling, 0 replies; 3+ messages in thread
From: Suvayu Ali @ 2012-09-09  0:21 UTC (permalink / raw)
  To: emacs-orgmode

On Sat, Sep 08, 2012 at 07:29:21AM -0400, Robert P. J. Day wrote:
> 
> http://orgmode.org/worg/org-faq.html#mixed-install
> 
> in both cases above, when i asked for "org-version", i didn't get any
> "release" info in parentheses.  all i saw was:
> 
>   "Org-mode version x.y.z"
> 
> which might confuse a reader expecting to see release information.
> again, just another observation.
> 

I updated the FAQ as per your suggestion.  Hope it is clearer now.

-- 
Suvayu

Open source is the future. It sets us free.

^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2012-09-09  0:21 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2012-09-08 11:29 suggestion for FAQ: clarifying how to upgrade org Robert P. J. Day
2012-09-08 19:36 ` Memnon Anon
2012-09-09  0:21 ` Suvayu Ali

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).