Personally for me the current documentation style is more understandable at a glance. Looking at it it's easier for me to understand the sequence of terms I should use, what can be omitted, what terms cannot be used together and so on. Old style looks for me more like list of requirements for programmer who will implement parser than user-readable documentation...
So apparently it's the matter of taste. :) And it looks like this documentation style is not proprietary to SQLite. Look for example here: http://download.oracle.com/docs/cd/B19306_01/server.102/b14200/statements_7002.htm#i2201774. But unfortunately to me this style is not so popular as I've expected: http://msdn.microsoft.com/en-us/library/ms174979.aspx http://dev.mysql.com/doc/refman/5.1/en/create-table.html The only issue on which I can agree with you (and maybe something should be done about it) is SQLite has no searchable text version (Oracle has it though also not very convenient I think). I'm not sure though how severe this issue is. Pavel On Wed, Aug 19, 2009 at 3:01 AM, Glenn Maynard<gl...@zewt.org> wrote: > SQLite had extremely readable SQL documentation: > http://www.3rd-impact.net/Document/SQLite/Translation/Current/Original/lang_createtable.html. > It was clear and intuitive; I can understand it at a glance. > > At some point, it was replaced with > http://sqlite.org/lang_createtable.html. It's closer to a rendering > of a parse tree than human documentation; I find it nearly unreadable. > With the text all baked into an image, it's also not searchable, and > I have to scroll up and down to read what used to fit in half a page. > > Is the text SQL documentation available for current SQLite versions? > > -- > Glenn Maynard > _______________________________________________ > 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
