[Firebird-docs] Re: Reserved words

[Paul V. <pa...@vi...>]

Hello Lester,

[ reserved words glossary ]

> Is there an existing one ? I have not looked properly yet ;)

None that I know of, but then: I haven't looked *at all* ;-)

> If there isn't perhaps that is something I can start pulling
> together?

That would be great (unless we find an existing one we can use).

> As I think I said before, I an using Eclipse to manage the PHP,JS
> and CSS stuff and it handles XML as well, but needs some help there
> still - such as a decent viewer :)

I didn't know anything about Eclipse. I've looked up their website
just now, did some reading, and downloaded it. Looks very promising!

> Only problem I can see is that a couple of words wrap to the next
> column (GROUP_COMMIT_WAIT_TIME) but I can have a look at how that is
> managed.

I was going to ask you about that, but forgot. I thought either you or
the original author had done that on purpose to keep the column width
within limits (it happens three times, each time when the word is
really long), so I mimicked it in the XML. But I think it's ugly and
confusing (people may think that these words belong to two columns) so
we'd better change that.

In the original HTML they've just created spans like this:

      <td valign="top" colspan="2">
        <p align="left"> GROUP_COMMIT_WAIT</p>
      </td>

In DocBook XML this is done like:

      <entry namest="col-fb-only" nameend="col-sql92">
        <para>GROUP_COMMIT_WAIT</para>
      </entry>

The values for namest (span's start col) and nameend (end col) must
have been previously defined in the tgroup in order for this to work:

      <tgroup cols="4">
        <colspec colname="col-fb-and-sql99"/>
        <colspec colname="col-fb-only"/>
        <colspec colname="col-sql92"/>
        <colspec colname="col-sql99-only"/>

I've removed these spans from my XML version now; will attach it.

BTW: Let's take this conversation back to firebird-docs; maybe we can
get some useful input from others, but even if not, then at least they
can see what's going on.


Greetings,
Paul Vinkenoog


[ Cc: to firebird-docs ]