On Fri, 2007-08-24 at 18:13 +0200, Krzysztof Sobolewski wrote:
> I'm trying to do something with the sorry state of libtpproto-java package
> (by rewriting it from scratch). 

Cool!

> I thought that creating all frame classes by
> hand is boring and all, especially when there seems to be a formal
> definition of the frames' structure in documents package, so I thought that
> I'd use the protocol.xml file (actually protocol3.xml for now).

The idea is that these files should be usable by various libraries to
dynamically create the packet definitions.

It is used by both the libtpproto2-py and the libtpproto-rb, however
both these libraries are dormant at the moment (although libtpproto2-py
will get some love very shortly).

> Actually I already started writing a source file generator, and it turns out
> that this file would be very useful... if it got cleared up a bit. It
> doesn't validate against the DTD and the property names are missing or
> misplaced with long names...

It should probably validate against the DTD :)

> So the question is: is this file an official definition of the protocol? And
> if so, could it be made usable? :)

It will eventually be the "official definition" of the protocol from
tp04 and onwards. A document similar to protocol3.php will be generated
from the protocol.xml file (you can see the start of it here -> 
http://www.thousandparsec.net/tp/dev/documents/protocolxml.php ).

The protocol3.php document on the website is the official information
about tp03. However, it would still be really handy for the tp03 file to
be correct :)

> ("Usable" as in "machine-readable"; I'd probably be able to fix the most
> obvious problems, like this one:

You will have no complaint from us if you submit patches! :)

> --- a/protocol/protocol3.xml
> +++ b/protocol/protocol3.xml
> @@ -1083,7 +1083,7 @@
>  </packet>
> 
> 
> -<packet id="18" base="GetWithIDandSlot" name="GetMessage">
> +<packet id="18" base="GetWithIDSlot" name="GetMessage">
>         <longname>Get Message</longname>
>  </packet>

Committed.

> or similar)
> -KS

Really cool to have you aboard!

Tim Ansell


_______________________________________________
tp-devel mailing list
[email protected]
http://www.thousandparsec.net/tp/mailman.php/listinfo/tp-devel

Reply via email to