Re: [sqlite] Version info in doc pages
I disagree with adding version info or dates of inclusion for things are added to the language. The fact that the code is there should be good enough, and if you need to know when something was added/removed/modified, the aforementioned doc will tell you. When something was added isn't as important to the syntax I need to know "now", and even at a cursory glance, the date it was added isn't relevant to what I need to know, and albeit for a single download, a few hundred bytes of additional HTML code wouldn't be a lot of info, but, on a free site with no adverts for public domain software, I'll gladly do a bit of extra leg work to find when something was added, if I need to know at all. What other things should be added to the document? When syntax is changed? Forget about the syntax itself, is the date information added when a parameter is added, removed, modified? If this kind of information were to be added, what determines what is flagged to have a 'date added' report? As for HGTTG, the linked doc isn't exactly burried under 30 levels concrete floor in some building on some planet in a galaxy far, far away. ;) On Mon, Sep 22, 2014 at 7:40 AM, HarryDwrote: > The changes.html page is fine, but I would rather see something on the > 'WITH clause' page itself. > > PHP online doc is a good example of how it can be done. > > Otherwise it would be like the Hitchhikers Guide to the Galaxy where the > plans for the destruction of Earth were available for all to view and > comment on, for many years in a place lightyears away, but known to but a > select few. > > On Sun, Sep 21, 2014 at 3:26 PM, Kevin Benson > wrote: > > > http://www.sqlite.org/changes.html > > > > 2014-02-03 (3.8.3) > > •Added support for common table expressions and the WITH clause. > > > > > > -- > >-- > > -- > > --Ô¿Ô-- > > K e V i N > > > > On Sun, Sep 21, 2014 at 8:46 AM, HarryD wrote: > > > > > I find it something of a shortcoming that the doc pages ( > > > http://www.sqlite.org/lang_with.html) do not mention the applicable > > > version > > > of sqlite. > > > > > > Example: I read about the 'with clause'. Exciting! But when trying > it, > > it > > > didn't work because I am using an older version. Not that old but still > > old > > > enough. > > > > > > Nowhere on the doc page is any mention of the first version it appeared > > > in. That would have been really helpful, and I think it is critical > that > > > it should appear there! > > > ___ > > > sqlite-users mailing list > > > sqlite-users@sqlite.org > > > http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users > > > > > ___ > > sqlite-users mailing list > > sqlite-users@sqlite.org > > http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users > > > ___ > sqlite-users mailing list > sqlite-users@sqlite.org > http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users > ___ sqlite-users mailing list sqlite-users@sqlite.org http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users
Re: [sqlite] Version info in doc pages
The changes.html page is fine, but I would rather see something on the 'WITH clause' page itself. PHP online doc is a good example of how it can be done. Otherwise it would be like the Hitchhikers Guide to the Galaxy where the plans for the destruction of Earth were available for all to view and comment on, for many years in a place lightyears away, but known to but a select few. On Sun, Sep 21, 2014 at 3:26 PM, Kevin Bensonwrote: > http://www.sqlite.org/changes.html > > 2014-02-03 (3.8.3) > •Added support for common table expressions and the WITH clause. > > > -- >-- > -- > --Ô¿Ô-- > K e V i N > > On Sun, Sep 21, 2014 at 8:46 AM, HarryD wrote: > > > I find it something of a shortcoming that the doc pages ( > > http://www.sqlite.org/lang_with.html) do not mention the applicable > > version > > of sqlite. > > > > Example: I read about the 'with clause'. Exciting! But when trying it, > it > > didn't work because I am using an older version. Not that old but still > old > > enough. > > > > Nowhere on the doc page is any mention of the first version it appeared > > in. That would have been really helpful, and I think it is critical that > > it should appear there! > > ___ > > sqlite-users mailing list > > sqlite-users@sqlite.org > > http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users > > > ___ > sqlite-users mailing list > sqlite-users@sqlite.org > http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users > ___ sqlite-users mailing list sqlite-users@sqlite.org http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users
Re: [sqlite] Version info in doc pages
http://www.sqlite.org/changes.html 2014-02-03 (3.8.3) •Added support for common table expressions and the WITH clause. -- -- -- --Ô¿Ô-- K e V i N On Sun, Sep 21, 2014 at 8:46 AM, HarryDwrote: > I find it something of a shortcoming that the doc pages ( > http://www.sqlite.org/lang_with.html) do not mention the applicable > version > of sqlite. > > Example: I read about the 'with clause'. Exciting! But when trying it, it > didn't work because I am using an older version. Not that old but still old > enough. > > Nowhere on the doc page is any mention of the first version it appeared > in. That would have been really helpful, and I think it is critical that > it should appear there! > ___ > sqlite-users mailing list > sqlite-users@sqlite.org > http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users > ___ sqlite-users mailing list sqlite-users@sqlite.org http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users
Re: [sqlite] Version info in doc pages
On Sun, Sep 21, 2014 at 2:53 PM, Stephan Bealwrote: > fossil has its own built-in copy of sqlite. It sounds like you're using > one which was built with the --internal-sqlite=0 flag. > My UTMOST apologies - i'm confusing traffic from two lists here (and thought yours was for the fossil list). -- - stephan beal http://wanderinghorse.net/home/stephan/ http://gplus.to/sgbeal "Freedom is sloppy. But since tyranny's the only guaranteed byproduct of those who insist on a perfect world, freedom will have to do." -- Bigby Wolf ___ sqlite-users mailing list sqlite-users@sqlite.org http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users
Re: [sqlite] Version info in doc pages
On Sun, Sep 21, 2014 at 2:46 PM, HarryDwrote: > I find it something of a shortcoming that the doc pages ( > http://www.sqlite.org/lang_with.html) do not mention the applicable > version > of sqlite. > > Example: I read about the 'with clause'. Exciting! But when trying it, it > didn't work because I am using an older version. Not that old but still old > enough. > fossil has its own built-in copy of sqlite. It sounds like you're using one which was built with the --internal-sqlite=0 flag. Try building it without that flag (or upgrading to a newer version, if you've got an old one) and it should "just work." -- - stephan beal http://wanderinghorse.net/home/stephan/ http://gplus.to/sgbeal "Freedom is sloppy. But since tyranny's the only guaranteed byproduct of those who insist on a perfect world, freedom will have to do." -- Bigby Wolf ___ sqlite-users mailing list sqlite-users@sqlite.org http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users