* [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 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).