emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* [BUG] Org manual without correct org-version
@ 2018-04-13  5:07 Vladimir Lomov
  2018-04-13 17:37 ` Nicolas Goaziou
  0 siblings, 1 reply; 6+ messages in thread
From: Vladimir Lomov @ 2018-04-13  5:07 UTC (permalink / raw)
  To: General discussions about Org-mode

Hello,
I'm using org-mode from git and found that now it is not show the
'git' version but simply 9.1 in Info file. In doc/ there is
'org-version.inc', it is included into 'orgguide.texi' but not in
'org.texi'.

As I understand the 'org.texi' is generated from 'org-manual.org', so
'org-manual.org' should either somehow includes that file or provide
other way to get version information.

P.S. I'm practially do the following:
1. git clone/"update" to/the local repo;
2. byte-compile the files;
3. make a package (for my distro).

---
WBR, Vladimir Lomov

-- 
Sattinger's Law:
	It works better if you plug it in.

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

* Re: [BUG] Org manual without correct org-version
  2018-04-13  5:07 [BUG] Org manual without correct org-version Vladimir Lomov
@ 2018-04-13 17:37 ` Nicolas Goaziou
  2018-04-14 13:47   ` Vladimir Lomov
  0 siblings, 1 reply; 6+ messages in thread
From: Nicolas Goaziou @ 2018-04-13 17:37 UTC (permalink / raw)
  To: Vladimir Lomov; +Cc: General discussions about Org-mode

Hello,

Vladimir Lomov <lomov.vl@gmail.com> writes:

> I'm using org-mode from git and found that now it is not show the
> 'git' version but simply 9.1 in Info file. In doc/ there is
> 'org-version.inc', it is included into 'orgguide.texi' but not in
> 'org.texi'.
>
> As I understand the 'org.texi' is generated from 'org-manual.org', so
> 'org-manual.org' should either somehow includes that file or provide
> other way to get version information.

Why should it include the exact commit? Manual is for users. I'm not
sure this has any value.

Actually, "org-manual.org" strips, on purpose, the bugfix number and the
commit release.

Regards,

-- 
Nicolas Goaziou

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

* Re: [BUG] Org manual without correct org-version
  2018-04-13 17:37 ` Nicolas Goaziou
@ 2018-04-14 13:47   ` Vladimir Lomov
  2018-04-14 14:43     ` Nicolas Goaziou
  0 siblings, 1 reply; 6+ messages in thread
From: Vladimir Lomov @ 2018-04-14 13:47 UTC (permalink / raw)
  To: Nicolas Goaziou; +Cc: General discussions about Org-mode

Hello,
** Nicolas Goaziou [2018-04-13 19:37:09 +0200]:

> Hello,
> 
> Vladimir Lomov <lomov.vl@gmail.com> writes:
> 
>> I'm using org-mode from git and found that now it is not show the
>> 'git' version but simply 9.1 in Info file. In doc/ there is
>> 'org-version.inc', it is included into 'orgguide.texi' but not in
>> 'org.texi'.
>>
>> As I understand the 'org.texi' is generated from 'org-manual.org', so
>> 'org-manual.org' should either somehow includes that file or provide
>> other way to get version information.
> 
> Why should it include the exact commit? Manual is for users. I'm not
> sure this has any value.

Earlier there was "full" "git" version in Manual and I found it convenient
(I read the manual from time to time to find how to do something in org)
but now when I open Info with Org manual I'm a bit puzzled, it shows
version 9.1 while Org from Emacs (I use Emacs from git) shows version
9.1.9 and that confuses me completely, which version is "fresh"?

> Actually, "org-manual.org" strips, on purpose, the bugfix number and the
> commit release.

I understand that, but on the other hand, when I/someone uses Org from
git explicitly it would worth to show the "actual" version in Org Manual
(as seen by Info). WDYT?

> Regards,
> 
> -- 
> Nicolas Goaziou

---
WBR, Vladimir Lomov

-- 
After a time, you may find that "having" is not so pleasing a thing,
after all, as "wanting."  It is not logical, but it is often true.
		-- Spock, "Amok Time", stardate 3372.7

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

* Re: [BUG] Org manual without correct org-version
  2018-04-14 13:47   ` Vladimir Lomov
@ 2018-04-14 14:43     ` Nicolas Goaziou
  2018-04-14 15:31       ` Vladimir Lomov
  0 siblings, 1 reply; 6+ messages in thread
From: Nicolas Goaziou @ 2018-04-14 14:43 UTC (permalink / raw)
  To: Vladimir Lomov; +Cc: General discussions about Org-mode

Vladimir Lomov <lomov.vl@gmail.com> writes:

> Earlier there was "full" "git" version in Manual and I found it convenient
> (I read the manual from time to time to find how to do something in org)
> but now when I open Info with Org manual I'm a bit puzzled, it shows
> version 9.1 while Org from Emacs (I use Emacs from git) shows version
> 9.1.9 and that confuses me completely, which version is "fresh"?

Barring typos and rewording, Org 9.1.9 is expected to have the same
manual as 9.1.0, or 9.1.13. An Org 9.1 manual means it is accurate for
Org 9.1.9. There is nothing puzzling.

> I understand that, but on the other hand, when I/someone uses Org from
> git explicitly it would worth to show the "actual" version in Org Manual
> (as seen by Info). WDYT?

If you use Org from git, you know the manual is on par with HEAD. As
a developer, I don't need to know the "git" version in manual. I'm
curious: what information are you missing?

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

* Re: [BUG] Org manual without correct org-version
  2018-04-14 14:43     ` Nicolas Goaziou
@ 2018-04-14 15:31       ` Vladimir Lomov
  2018-04-14 15:40         ` Nicolas Goaziou
  0 siblings, 1 reply; 6+ messages in thread
From: Vladimir Lomov @ 2018-04-14 15:31 UTC (permalink / raw)
  To: Nicolas Goaziou; +Cc: General discussions about Org-mode

Hello,
** Nicolas Goaziou [2018-04-14 16:43:31 +0200]:

> Vladimir Lomov <lomov.vl@gmail.com> writes:
> 
>> Earlier there was "full" "git" version in Manual and I found it convenient
>> (I read the manual from time to time to find how to do something in org)
>> but now when I open Info with Org manual I'm a bit puzzled, it shows
>> version 9.1 while Org from Emacs (I use Emacs from git) shows version
>> 9.1.9 and that confuses me completely, which version is "fresh"?
> 
> Barring typos and rewording, Org 9.1.9 is expected to have the same
> manual as 9.1.0, or 9.1.13. An Org 9.1 manual means it is accurate for
> Org 9.1.9. There is nothing puzzling.

I thought that for software versions 9.1 < 9.1.9 and means that 9.1
preceding the 9.1.9. And first thing that comes to my mind about recent
changes is a "template" system, there was '<s' and etc now it is 'C-c
C-,'. The '9.1' version (org from git) has 'Structure Templates' while
'9.1.9' version (org shipped with Emacs) doesn't have that section.

>> I understand that, but on the other hand, when I/someone uses Org from
>> git explicitly it would worth to show the "actual" version in Org Manual
>> (as seen by Info). WDYT?
> 
> If you use Org from git, you know the manual is on par with HEAD. As
> a developer, I don't need to know the "git" version in manual. I'm
> curious: what information are you missing?

I prefer search for information in most recent docs than in "out-dated"
(see example with 'Structure Templates' above). So simple check of
version would help to find out what document is 'fresh' enough.

---
WBR, Vladimir Lomov

-- 
Don't change the reason, just change the excuses!
		-- Joe Cointment

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

* Re: [BUG] Org manual without correct org-version
  2018-04-14 15:31       ` Vladimir Lomov
@ 2018-04-14 15:40         ` Nicolas Goaziou
  0 siblings, 0 replies; 6+ messages in thread
From: Nicolas Goaziou @ 2018-04-14 15:40 UTC (permalink / raw)
  To: Vladimir Lomov; +Cc: General discussions about Org-mode

Vladimir Lomov <lomov.vl@gmail.com> writes:

> I thought that for software versions 9.1 < 9.1.9 and means that 9.1
> preceding the 9.1.9.

We are not talking about software version but manual version.

> And first thing that comes to my mind about recent
> changes is a "template" system, there was '<s' and etc now it is 'C-c
> C-,'. The '9.1' version (org from git) has 'Structure Templates' while
> '9.1.9' version (org shipped with Emacs) doesn't have that section.

If you use Org from git master's branch (aka development branch), you
should know that it is, for the time being, akin to Org 9.2-alpha.
There, I suggest to use "org-manual.org" instead of Org info manual,
which is bound to be outdated.

If you use Org from maint branch, there is no such problem: the 9.1
manual is accurate.

> I prefer search for information in most recent docs than in "out-dated"
> (see example with 'Structure Templates' above). So simple check of
> version would help to find out what document is 'fresh' enough.

Again, this has nothing to do with manual version. See above.

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

end of thread, other threads:[~2018-04-14 15:40 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2018-04-13  5:07 [BUG] Org manual without correct org-version Vladimir Lomov
2018-04-13 17:37 ` Nicolas Goaziou
2018-04-14 13:47   ` Vladimir Lomov
2018-04-14 14:43     ` Nicolas Goaziou
2018-04-14 15:31       ` Vladimir Lomov
2018-04-14 15:40         ` Nicolas Goaziou

Code repositories for project(s) associated with this 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).