Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-26 Thread Jay A. Kreibich 
On Fri, Mar 26, 2010 at 08:37:23PM +0100, Kees Nuyt scratched on the wall:
> On Thu, 25 Mar 2010 18:38:49 -0500, P Kishor
>  wrote:
> 
> >I must be in an alternate universe. So, I have turned off images in my
> >browser and I am looking at http://www.sqlite.org/lang_delete.html
> 
> You are trying to find a formal syntax description in text.
> It's not there,

  I want to remind everyone that even the "railroad diagrams" are not a
  formal syntax specifier.  They're designed to be easy-to-understand
  documentation, and are not definitive.  They are not a specification.
  They are built and maintained apart from the formal grammar, and
  there are numerous differences.
  
  Speaking of which, the formal grammar can easily be found in a full
  source distribution.  It is far from an ideal place to try to learn
  SQL, but it is there.


  I think it may be more helpful to have some type of text-based
  representation, even if it is just an "ASCII art" version of the
  current diagrams.  I dislike the fact you can't keyword search across
  a page of graphic diagrams.

  I'd also point out that not all that long ago the docs were in
  pseudo BNF, and people went crazy when the diagrams showed up.  I
  appreciate the fact that the graphical representations have their
  limits, but overall I think they do a much better job at expressing
  the general syntax to a much larger audience.


  Depending on the limitations of the OP's vision, it is also trivial
  to modify the syntax of the diagram script so that it generates HUGE
  diagrams.  I realize that may still not help, but it may be an option
  for others.

   -j

-- 
Jay A. Kreibich < J A Y  @  K R E I B I.C H >

"Our opponent is an alien starship packed with atomic bombs.  We have
 a protractor."   "I'll go home and see if I can scrounge up a ruler
 and a piece of string."  --from Anathem by Neal Stephenson
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-26 Thread Kees Nuyt 
On Thu, 25 Mar 2010 18:38:49 -0500, P Kishor
 wrote:

>I must be in an alternate universe. So, I have turned off images in my
>browser and I am looking at http://www.sqlite.org/lang_delete.html

You are trying to find a formal syntax description in text.
It's not there, but there is a description right below the
railroad diagram which serves that same purpose. I think
that's what Shane refers to.

On the page you point to:
"The DELETE command is used to remove records from a
table. The command consists of the "DELETE FROM" keywords
followed by the name of the table from which records are to
be removed.

Without a WHERE clause, all rows of the table are
removed. If a WHERE clause is supplied, then only those rows
that match the expression are removed."


For INSERT ( http://www.sqlite.org/lang_insert.html ) the
description is too terse to reconstruct the exact syntax. On
the other hand, SQLite implements the essentials of SQL-92,
which is available in cross-referenced text form:

http://vieka.com/esqldoc/sql92bnf.htm#query_specification
http://vieka.com/esqldoc/sql92bnf.htm#SQL_data_change_statement

I must admit that spec is very wordy and not tailored to
SQLite.

Nicolas Williams suggestion to add alt tags to the images is
a good idea. Perhaps the OP, Tyler Spivey, can shine his
light on that concept?
-- 
  (  Kees Nuyt
  )
c[_]
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-25 Thread P Kishor 
On Thu, Mar 25, 2010 at 6:48 PM, D. Richard Hipp  wrote:
>
> On Mar 25, 2010, at 7:38 PM, P Kishor wrote:
>>
>> If you see the docs at Pg or MySQL, they are in BNF format (I believe
>> that is what it is called). It is plain text, so it can be parsed,
>> seen, read aloud, and viewed via lynx (for those who care).
>
>
> I am very sorry that you find the syntax diagrams of SQLite difficult
> to read.  That is not the experience of most other users, however, who
> report finding the syntax diagrams easier to comprehend at a quick
> glance.
>
> We do not have the resources to maintain two parallel sets of syntax
> documentation with different representations to suite the preferences
> of individual readers..  And so the syntax diagrams will be all that
> is available for the foreseeable future.  I apologize for whatever
> inconvenience this may cause you.
>
>


Richard, I have no problems with the syntax diagrams. They are just
fine for me. I am only advocating on behalf of those who, for whatever
reason, physical inability (y'know Section 508 and stuff) or political
reasons ("kill all gifs") may be unable to see the images.

I also understand that hwaci or sqlite.org may not have the resources
to create both textual and pictorial docs.

Personally, I find the pictures fine, but maybe defaulting to pictures
leaves out a few of the constituents, while defaulting to text
excludes no one.

In any case, I have no felines in this skirmish.




-- 
Puneet Kishor http://www.punkish.org
Carbon Model http://carbonmodel.org
Charter Member, Open Source Geospatial Foundation http://www.osgeo.org
Science Commons Fellow, http://sciencecommons.org/about/whoweare/kishor
Nelson Institute, UW-Madison http://www.nelson.wisc.edu
---
Assertions are politics; backing up assertions with evidence is science
===
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-25 Thread D. Richard Hipp 

On Mar 25, 2010, at 7:38 PM, P Kishor wrote:
>
> If you see the docs at Pg or MySQL, they are in BNF format (I believe
> that is what it is called). It is plain text, so it can be parsed,
> seen, read aloud, and viewed via lynx (for those who care).


I am very sorry that you find the syntax diagrams of SQLite difficult  
to read.  That is not the experience of most other users, however, who  
report finding the syntax diagrams easier to comprehend at a quick  
glance.

We do not have the resources to maintain two parallel sets of syntax  
documentation with different representations to suite the preferences  
of individual readers..  And so the syntax diagrams will be all that  
is available for the foreseeable future.  I apologize for whatever  
inconvenience this may cause you.


D. Richard Hipp
d...@hwaci.com



___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-25 Thread P Kishor 
On Thu, Mar 25, 2010 at 6:28 PM, Shane Harrelson
 wrote:
> On Thu, Mar 25, 2010 at 7:24 PM, P Kishor  wrote:
>
>> On Thu, Mar 25, 2010 at 6:22 PM, P Kishor  wrote:
>> > On Thu, Mar 25, 2010 at 6:19 PM, Shane Harrelson 
>> wrote:
>> >>
>> >>
>> >> On Thu, Mar 25, 2010 at 7:06 PM, P Kishor  wrote:
>> >>>
>> >>> On Thu, Mar 25, 2010 at 5:59 PM, Shane Harrelson 
>> wrote:
>> >>> > I added a psuedo-BNF renderer for the bubble syntax graph data at
>> >>> >
>> >>> > http://www.sqlite.org/docsrc/artifact/873cf35adf
>> >>> >
>> >>> > to go along with the text based bubble graph at
>> >>> >
>> >>> > http://www.sqlite.org/docsrc/artifact/645054606c
>> >>> >
>> >>> > These are not meant to replace the official syntax specification at
>> >>> >
>> >>> > http://www.sqlite.org/syntaxdiagrams.html
>> >>> >
>> >>>
>> >>>
>> >>> This is gorgeous, but is it not possible to just have plain text docs?
>> >>> Much like most other database manuals do?
>> >>>
>> >>> http://www.postgresql.org/docs/8.4/static/ddl-basics.html
>> >>> http://dev.mysql.com/doc/refman/5.5/en/create-table.html
>> >>>
>> >>> or am I missing something?
>> >>>
>> >>>
>> >>> --
>> >>> Puneet Kishor
>> >>>
>> >>
>> >> Is this
>> >>
>> >> http://www.sqlite.org/lang.html
>> >>
>> >> or
>> >>
>> >> http://www.sqlite.org/lang_createtable.html
>> >>
>> >> what you're looking for?  Otherwise, I'm not sure what you're asking
>> for.
>> >>
>> >>
>> >
>> > The links you provided goes back to diagrams. I believe the OP was
>> > asking if there was plain text documentation available. Whether or not
>> > he was asking that, I am wondering... is there plain text
>> > documentation available at all? I mean, where can I see syntax spelled
>> > out like so
>> >
>> > DELETE FROM qualified_table-name WHERE expr
>> >
>> > It used to be available until the docs were migrated to the diagrams.
>> >
>>
>>
>>
>> Here is another way of conveying the problem here. Go to your
>> browser's settings and turn off images. Then try to read the
>> documentation at sqlite.org.
>> ___
>> sqlite-users mailing list
>> sqlite-users@sqlite.org
>> http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users
>>
>
>
> If you scroll down on on any of the lang_*.html pages, like
>
> http://www.sqlite.org/lang_createtable.html
>
> you'll see text based descriptions of the individual command.
> Even with graphics turned off.
>
> All of the individual pages are referenced from:
>
> http://www.sqlite.org/lang.html
>
> Is that what you mean?
>


I must be in an alternate universe. So, I have turned off images in my
browser and I am looking at http://www.sqlite.org/lang_delete.html

No matter how much I squint at it, I just cannot see the following
text anywhere on the page that would be the equivalent of the diagram
at http://www.sqlite.org/images/syntax/delete-stmt.gif

DELETE FROM qualified-table-name WHERE expr

If you see the docs at Pg or MySQL, they are in BNF format (I believe
that is what it is called). It is plain text, so it can be parsed,
seen, read aloud, and viewed via lynx (for those who care).


-- 
Puneet Kishor http://www.punkish.org
Carbon Model http://carbonmodel.org
Charter Member, Open Source Geospatial Foundation http://www.osgeo.org
Science Commons Fellow, http://sciencecommons.org/about/whoweare/kishor
Nelson Institute, UW-Madison http://www.nelson.wisc.edu
---
Assertions are politics; backing up assertions with evidence is science
===
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-25 Thread Nicolas Williams 
On Tue, Mar 23, 2010 at 11:50:10PM -0400, Shane Harrelson wrote:
> I have no idea what kinds of things a "screen reader" would need to make
> this version useful, but if you let me know, I will try to add them.

Screen readers are used by those who have impaired sight or not sight
(i.e., blindness).  Screen readers look for character data and generate
speech to read it.  GIFs, PNGs, ... are not readable by screen readers
-- not without resorting to OCR.  Thus just generating text to put in
the ALT tag of the IMGs would be a huge improvement in making the docs
accessible to the visually impaired.

What you made available at

http://www.sqlite.org/docsrc/artifact/873cf35adf

is readable via a screen reader because it's all text (the only IMG in
that page is for the SQLite3 documentation logo).

All you have to do now is make the scripts that generate

http://www.sqlite.org/lang.html

and friends put the text diagrams as ALT text for the GIFs and you're
done :)

(I don't need accessible docs, but clearly others do; on their behalf:
thanks!)

Nico
-- 
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-25 Thread Shane Harrelson 
On Thu, Mar 25, 2010 at 7:24 PM, P Kishor  wrote:

> On Thu, Mar 25, 2010 at 6:22 PM, P Kishor  wrote:
> > On Thu, Mar 25, 2010 at 6:19 PM, Shane Harrelson 
> wrote:
> >>
> >>
> >> On Thu, Mar 25, 2010 at 7:06 PM, P Kishor  wrote:
> >>>
> >>> On Thu, Mar 25, 2010 at 5:59 PM, Shane Harrelson 
> wrote:
> >>> > I added a psuedo-BNF renderer for the bubble syntax graph data at
> >>> >
> >>> > http://www.sqlite.org/docsrc/artifact/873cf35adf
> >>> >
> >>> > to go along with the text based bubble graph at
> >>> >
> >>> > http://www.sqlite.org/docsrc/artifact/645054606c
> >>> >
> >>> > These are not meant to replace the official syntax specification at
> >>> >
> >>> > http://www.sqlite.org/syntaxdiagrams.html
> >>> >
> >>>
> >>>
> >>> This is gorgeous, but is it not possible to just have plain text docs?
> >>> Much like most other database manuals do?
> >>>
> >>> http://www.postgresql.org/docs/8.4/static/ddl-basics.html
> >>> http://dev.mysql.com/doc/refman/5.5/en/create-table.html
> >>>
> >>> or am I missing something?
> >>>
> >>>
> >>> --
> >>> Puneet Kishor
> >>>
> >>
> >> Is this
> >>
> >> http://www.sqlite.org/lang.html
> >>
> >> or
> >>
> >> http://www.sqlite.org/lang_createtable.html
> >>
> >> what you're looking for?  Otherwise, I'm not sure what you're asking
> for.
> >>
> >>
> >
> > The links you provided goes back to diagrams. I believe the OP was
> > asking if there was plain text documentation available. Whether or not
> > he was asking that, I am wondering... is there plain text
> > documentation available at all? I mean, where can I see syntax spelled
> > out like so
> >
> > DELETE FROM qualified_table-name WHERE expr
> >
> > It used to be available until the docs were migrated to the diagrams.
> >
>
>
>
> Here is another way of conveying the problem here. Go to your
> browser's settings and turn off images. Then try to read the
> documentation at sqlite.org.
> ___
> sqlite-users mailing list
> sqlite-users@sqlite.org
> http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users
>


If you scroll down on on any of the lang_*.html pages, like

http://www.sqlite.org/lang_createtable.html

you'll see text based descriptions of the individual command.
Even with graphics turned off.

All of the individual pages are referenced from:

http://www.sqlite.org/lang.html

Is that what you mean?

-Shane
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-25 Thread P Kishor 
On Thu, Mar 25, 2010 at 6:22 PM, P Kishor  wrote:
> On Thu, Mar 25, 2010 at 6:19 PM, Shane Harrelson  wrote:
>>
>>
>> On Thu, Mar 25, 2010 at 7:06 PM, P Kishor  wrote:
>>>
>>> On Thu, Mar 25, 2010 at 5:59 PM, Shane Harrelson  wrote:
>>> > I added a psuedo-BNF renderer for the bubble syntax graph data at
>>> >
>>> > http://www.sqlite.org/docsrc/artifact/873cf35adf
>>> >
>>> > to go along with the text based bubble graph at
>>> >
>>> > http://www.sqlite.org/docsrc/artifact/645054606c
>>> >
>>> > These are not meant to replace the official syntax specification at
>>> >
>>> > http://www.sqlite.org/syntaxdiagrams.html
>>> >
>>>
>>>
>>> This is gorgeous, but is it not possible to just have plain text docs?
>>> Much like most other database manuals do?
>>>
>>> http://www.postgresql.org/docs/8.4/static/ddl-basics.html
>>> http://dev.mysql.com/doc/refman/5.5/en/create-table.html
>>>
>>> or am I missing something?
>>>
>>>
>>> --
>>> Puneet Kishor
>>>
>>
>> Is this
>>
>> http://www.sqlite.org/lang.html
>>
>> or
>>
>> http://www.sqlite.org/lang_createtable.html
>>
>> what you're looking for?  Otherwise, I'm not sure what you're asking for.
>>
>>
>
> The links you provided goes back to diagrams. I believe the OP was
> asking if there was plain text documentation available. Whether or not
> he was asking that, I am wondering... is there plain text
> documentation available at all? I mean, where can I see syntax spelled
> out like so
>
> DELETE FROM qualified_table-name WHERE expr
>
> It used to be available until the docs were migrated to the diagrams.
>



Here is another way of conveying the problem here. Go to your
browser's settings and turn off images. Then try to read the
documentation at sqlite.org.
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-25 Thread Shane Harrelson 
On Thu, Mar 25, 2010 at 7:22 PM, P Kishor  wrote:

> On Thu, Mar 25, 2010 at 6:19 PM, Shane Harrelson  wrote:
> >
> >
> > On Thu, Mar 25, 2010 at 7:06 PM, P Kishor  wrote:
> >>
> >> On Thu, Mar 25, 2010 at 5:59 PM, Shane Harrelson 
> wrote:
> >> > I added a psuedo-BNF renderer for the bubble syntax graph data at
> >> >
> >> > http://www.sqlite.org/docsrc/artifact/873cf35adf
> >> >
> >> > to go along with the text based bubble graph at
> >> >
> >> > http://www.sqlite.org/docsrc/artifact/645054606c
> >> >
> >> > These are not meant to replace the official syntax specification at
> >> >
> >> > http://www.sqlite.org/syntaxdiagrams.html
> >> >
> >>
> >>
> >> This is gorgeous, but is it not possible to just have plain text docs?
> >> Much like most other database manuals do?
> >>
> >> http://www.postgresql.org/docs/8.4/static/ddl-basics.html
> >> http://dev.mysql.com/doc/refman/5.5/en/create-table.html
> >>
> >> or am I missing something?
> >>
> >>
> >> --
> >> Puneet Kishor
> >>
> >
> > Is this
> >
> > http://www.sqlite.org/lang.html
> >
> > or
> >
> > http://www.sqlite.org/lang_createtable.html
> >
> > what you're looking for?  Otherwise, I'm not sure what you're asking for.
> >
> >
>
> The links you provided goes back to diagrams. I believe the OP was
> asking if there was plain text documentation available. Whether or not
> he was asking that, I am wondering... is there plain text
> documentation available at all? I mean, where can I see syntax spelled
> out like so
>
> DELETE FROM qualified_table-name WHERE expr
>
> It used to be available until the docs were migrated to the diagrams.
> ___
> sqlite-users mailing list
> sqlite-users@sqlite.org
> http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users
>


Is this

http://www.sqlite.org/lang.html

or

http://www.sqlite.org/lang_createtable.html

what you're looking for?  Otherwise, I'm not sure what you're asking for.

-Shane
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-25 Thread P Kishor 
On Thu, Mar 25, 2010 at 6:19 PM, Shane Harrelson  wrote:
>
>
> On Thu, Mar 25, 2010 at 7:06 PM, P Kishor  wrote:
>>
>> On Thu, Mar 25, 2010 at 5:59 PM, Shane Harrelson  wrote:
>> > I added a psuedo-BNF renderer for the bubble syntax graph data at
>> >
>> > http://www.sqlite.org/docsrc/artifact/873cf35adf
>> >
>> > to go along with the text based bubble graph at
>> >
>> > http://www.sqlite.org/docsrc/artifact/645054606c
>> >
>> > These are not meant to replace the official syntax specification at
>> >
>> > http://www.sqlite.org/syntaxdiagrams.html
>> >
>>
>>
>> This is gorgeous, but is it not possible to just have plain text docs?
>> Much like most other database manuals do?
>>
>> http://www.postgresql.org/docs/8.4/static/ddl-basics.html
>> http://dev.mysql.com/doc/refman/5.5/en/create-table.html
>>
>> or am I missing something?
>>
>>
>> --
>> Puneet Kishor
>>
>
> Is this
>
> http://www.sqlite.org/lang.html
>
> or
>
> http://www.sqlite.org/lang_createtable.html
>
> what you're looking for?  Otherwise, I'm not sure what you're asking for.
>
>

The links you provided goes back to diagrams. I believe the OP was
asking if there was plain text documentation available. Whether or not
he was asking that, I am wondering... is there plain text
documentation available at all? I mean, where can I see syntax spelled
out like so

DELETE FROM qualified_table-name WHERE expr

It used to be available until the docs were migrated to the diagrams.
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-25 Thread Shane Harrelson 
On Thu, Mar 25, 2010 at 7:06 PM, P Kishor  wrote:

> On Thu, Mar 25, 2010 at 5:59 PM, Shane Harrelson  wrote:
> > I added a psuedo-BNF renderer for the bubble syntax graph data at
> >
> > http://www.sqlite.org/docsrc/artifact/873cf35adf
> >
> > to go along with the text based bubble graph at
> >
> > http://www.sqlite.org/docsrc/artifact/645054606c
> >
> > These are not meant to replace the official syntax specification at
> >
> > http://www.sqlite.org/syntaxdiagrams.html
> >
>
>
> This is gorgeous, but is it not possible to just have plain text docs?
> Much like most other database manuals do?
>
> http://www.postgresql.org/docs/8.4/static/ddl-basics.html
> http://dev.mysql.com/doc/refman/5.5/en/create-table.html
>
> or am I missing something?
>
>
> --
> Puneet Kishor
>
>
Is this

http://www.sqlite.org/lang.html

or

http://www.sqlite.org/lang_createtable.html

what you're looking for?  Otherwise, I'm not sure what you're asking for.

-Shane
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-25 Thread P Kishor 
On Thu, Mar 25, 2010 at 5:59 PM, Shane Harrelson  wrote:
> I added a psuedo-BNF renderer for the bubble syntax graph data at
>
> http://www.sqlite.org/docsrc/artifact/873cf35adf
>
> to go along with the text based bubble graph at
>
> http://www.sqlite.org/docsrc/artifact/645054606c
>
> These are not meant to replace the official syntax specification at
>
> http://www.sqlite.org/syntaxdiagrams.html
>


This is gorgeous, but is it not possible to just have plain text docs?
Much like most other database manuals do?

http://www.postgresql.org/docs/8.4/static/ddl-basics.html
http://dev.mysql.com/doc/refman/5.5/en/create-table.html

or am I missing something?


-- 
Puneet Kishor
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-25 Thread Shane Harrelson 
I added a psuedo-BNF renderer for the bubble syntax graph data at

http://www.sqlite.org/docsrc/artifact/873cf35adf

to go along with the text based bubble graph at

http://www.sqlite.org/docsrc/artifact/645054606c

These are not meant to replace the official syntax specification at

http://www.sqlite.org/syntaxdiagrams.html

-Shane
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-23 Thread Shane Harrelson 
More updates for Chrome support.

http://www.sqlite.org/docsrc/artifact/981f61a5e4


On Tue, Mar 23, 2010 at 11:50 PM, Shane Harrelson  wrote:

> I knocked out a quick TCl script that uses *exactly* the same syntax graph
> specification as bubble-generator.tcl but attempts to render the graphs
> without GIFs.   You can see the script here:
>
>
> http://www.sqlite.org/docsrc/finfo?name=art/syntax/bubble-generator-text.tcl
>
> You can view the output here:
>
> http://www.sqlite.org/docsrc/artifact/149ec0f41f
>
> The script still needs a little work (especially in browsers other than
> FF), but the graphs are reasonable similar to the GIF based versions and
> usable.
>
> I have no idea what kinds of things a "screen reader" would need to make
> this version useful, but if you let me know, I will try to add them.
>
> HTH.
> -Shane
>
>
>
> On Mon, Mar 22, 2010 at 2:29 PM, Jay A. Kreibich  wrote:
>
>> On Mon, Mar 22, 2010 at 11:13:25PM +0530, Roger Binns scratched on the
>> wall:
>> > -BEGIN PGP SIGNED MESSAGE-
>> > Hash: SHA1
>> >
>> > Jay A. Kreibich wrote:
>> > > On Mon, Mar 22, 2010 at 05:57:18PM +0530, Roger Binns scratched on the
>> wall:
>> > >
>> > >> If you are the developer type yourself then it is a simple matter of
>> > >> programming :-)
>> > >
>> > >   As someone that's been spending a lot of time with that script,
>> > >   excuse me while I run around the room laughing maniacally.
>> >
>> > Perhaps you may want to review the definition SMOP
>>
>>   Yes, I'm well aware.  I was confirming, not trying to contradict.
>>
>>  And in defense of the script, the biggest issue is that I don't
>>  know TCL and it's somewhat casual syntax for literals can be very
>>  frustrating for someone that has not used this class of language.
>>
>>   -j
>>
>> --
>> Jay A. Kreibich < J A Y  @  K R E I B I.C H >
>>
>> "Our opponent is an alien starship packed with atomic bombs.  We have
>>  a protractor."   "I'll go home and see if I can scrounge up a ruler
>>  and a piece of string."  --from Anathem by Neal Stephenson
>> ___
>> 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] Available alternatives to syntax diagrams in documentation

2010-03-23 Thread Shane Harrelson 
I knocked out a quick TCl script that uses *exactly* the same syntax graph
specification as bubble-generator.tcl but attempts to render the graphs
without GIFs.   You can see the script here:

http://www.sqlite.org/docsrc/finfo?name=art/syntax/bubble-generator-text.tcl

You can view the output here:

http://www.sqlite.org/docsrc/artifact/149ec0f41f

The script still needs a little work (especially in browsers other than FF),
but the graphs are reasonable similar to the GIF based versions and usable.

I have no idea what kinds of things a "screen reader" would need to make
this version useful, but if you let me know, I will try to add them.

HTH.
-Shane


On Mon, Mar 22, 2010 at 2:29 PM, Jay A. Kreibich  wrote:

> On Mon, Mar 22, 2010 at 11:13:25PM +0530, Roger Binns scratched on the
> wall:
> > -BEGIN PGP SIGNED MESSAGE-
> > Hash: SHA1
> >
> > Jay A. Kreibich wrote:
> > > On Mon, Mar 22, 2010 at 05:57:18PM +0530, Roger Binns scratched on the
> wall:
> > >
> > >> If you are the developer type yourself then it is a simple matter of
> > >> programming :-)
> > >
> > >   As someone that's been spending a lot of time with that script,
> > >   excuse me while I run around the room laughing maniacally.
> >
> > Perhaps you may want to review the definition SMOP
>
>   Yes, I'm well aware.  I was confirming, not trying to contradict.
>
>  And in defense of the script, the biggest issue is that I don't
>  know TCL and it's somewhat casual syntax for literals can be very
>  frustrating for someone that has not used this class of language.
>
>   -j
>
> --
> Jay A. Kreibich < J A Y  @  K R E I B I.C H >
>
> "Our opponent is an alien starship packed with atomic bombs.  We have
>  a protractor."   "I'll go home and see if I can scrounge up a ruler
>  and a piece of string."  --from Anathem by Neal Stephenson
> ___
> 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] Available alternatives to syntax diagrams in documentation

2010-03-22 Thread Jay A. Kreibich 
On Mon, Mar 22, 2010 at 11:13:25PM +0530, Roger Binns scratched on the wall:
> -BEGIN PGP SIGNED MESSAGE-
> Hash: SHA1
> 
> Jay A. Kreibich wrote:
> > On Mon, Mar 22, 2010 at 05:57:18PM +0530, Roger Binns scratched on the wall:
> > 
> >> If you are the developer type yourself then it is a simple matter of
> >> programming :-)
> > 
> >   As someone that's been spending a lot of time with that script,
> >   excuse me while I run around the room laughing maniacally.
> 
> Perhaps you may want to review the definition SMOP

  Yes, I'm well aware.  I was confirming, not trying to contradict.

  And in defense of the script, the biggest issue is that I don't
  know TCL and it's somewhat casual syntax for literals can be very
  frustrating for someone that has not used this class of language.

   -j

-- 
Jay A. Kreibich < J A Y  @  K R E I B I.C H >

"Our opponent is an alien starship packed with atomic bombs.  We have
 a protractor."   "I'll go home and see if I can scrounge up a ruler
 and a piece of string."  --from Anathem by Neal Stephenson
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-22 Thread Roger Binns 
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Jay A. Kreibich wrote:
> On Mon, Mar 22, 2010 at 05:57:18PM +0530, Roger Binns scratched on the wall:
> 
>> If you are the developer type yourself then it is a simple matter of
>> programming :-)
> 
>   As someone that's been spending a lot of time with that script,
>   excuse me while I run around the room laughing maniacally.

Perhaps you may want to review the definition SMOP which will confirm
that I described things accurately:

  http://en.wikipedia.org/wiki/Small_matter_of_programming

Roger
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.9 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEARECAAYFAkunrDkACgkQmOOfHg372QTntwCfb+dKHFISCeWK3A5inyu1Jdo+
qg8AnioJGTiTPXJLU2G4ZChcT98lhan+
=b+4T
-END PGP SIGNATURE-
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

Re: [sqlite] Available alternatives to syntax diagrams in documentation

2010-03-22 Thread Jay A. Kreibich 
On Mon, Mar 22, 2010 at 05:57:18PM +0530, Roger Binns scratched on the wall:

> If you are the developer type yourself then it is a simple matter of
> programming :-)

  As someone that's been spending a lot of time with that script,
  excuse me while I run around the room laughing maniacally.

   -j

-- 
Jay A. Kreibich < J A Y  @  K R E I B I.C H >

"Our opponent is an alien starship packed with atomic bombs.  We have
 a protractor."   "I'll go home and see if I can scrounge up a ruler
 and a piece of string."  --from Anathem by Neal Stephenson
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users

[sqlite] Available alternatives to syntax diagrams in documentation

2010-03-19 Thread Tyler Spivey 
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA512

While trying to look up the syntax of a command in the
documentation, I noticed that it switched to syntax diagrams in
3.6.4. I use a screen reader, and these diagrams are useless to me.

What alternatives are available besides using the 3.6.3 docs which
will become increasingly obsolete over time?

- --
Tyler Spivey - PGP Key ID: 0xae742aaf
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.9 (MingW32)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQIcBAEBCgAGBQJLo6+BAAoJEPb0SlyudCqv5twP/2cQIrqXI3io9T+w3+bZ8c4l
tv3wou5CHL1iHb8n/TpS/Bitf4ZtsYZa4xBxzBejltEVpAmmEVBXmWnCeeQwbzng
LNfRw53sJFPv3coIHHJz97AIYJEb/NOwjyRbveDw3mrSUSFLnFtpheonHT6t+qRu
C5DhwDhcSGjkjJwB5YJJMbQqxXWYRjvjPaSHl32TO40c4Q1fbqYjqY8JXbic/z6E
RpfqIgjd+no/jpBfx0mSjFzJzWC6GEpbKVX6PctVZUqC9hbESEwNhJ3FcIKMYUsG
kRL+TRDZVbDRoLUajGFU5sOPIHJ5PdenZ8+u5fD8g3mQ/MDZ5H1yVvaSovtC5aJz
kiNPmaAjIi0KWE72z7OKDKyxXKOceI5q8o5zcbnZ7QwuhyZ5JIQLh57SAQSRUbQL
R3kEAtYQj8SiI0H8GIohC9y1wthjZfdP22dAS9gs2Ht9jL8oVeAg2LZ6FO/PJqKV
K6sIG32WJDBc/jN4olL2vFRSzL3RNWrAlItlaJhRQNbaoHqtUrfA6DjSYkzUNySx
4er3nlJDWN1guJ71HmWpdhZ5CIt+Un2p+scBYQqVKs5s/G1Ujuc0++jOiB+DYLwh
fz3Udc7I7ky2xnLOyYuCM+T8KChdp2g8OV2Y1ICL0rCAVtqKkzwQPN+QqPjtliiI
LbASctlNlkpyDUB8SRql
=+Hp8
-END PGP SIGNATURE-
___
sqlite-users mailing list
sqlite-users@sqlite.org
http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users