Re: [gpsd-dev] [AIS] HTML testsuite report

[Christian Gagneraud]

On 29/05/12 10:30, Eric S. Raymond wrote:
> Christian Gagneraud<address@hidden>:
> > I wrote a script that parse sample.aivdm and generate an asciidoc
> > containing status and details about decoded sentences (sample.aivdm
> > has been partially reformatted to be easily parsable).
> > This is still a WIP, any comments are more than welcome!
> >
> > HTML output document is available here:
> > http://www.techworks.ie/pub/chris/gpsd/ais-testsuite.html
> >
> > Ideas for future enhancement:
> > - Add TOC
> > - Add gpsd version somewhere
> > - Add summary table
> > - Add scaled decoding along the unscaled ones
> > - Add CSV decoding too?
> > - Give the standard names associated to each sample
> > - Give the message friendly name
> >
> > Chris
>
> I find output interesting to look at, but then I am like you
> an AIS implementor - which is a pretty uncommon interest.  What
> did you have in mind for this script? Was it just generating
> some sort of explanation page for the website?

I have two goals, but I'm not sure exactly where to add these generated 
documentations bits:
- Gives a clear and detailed picture of what is decoded and what has 
been checked against known good decodings
- Show example of AIVDM sentences vs scaled/unscaled JSON.

The first point could be included somewhere in the beginning of the 
document to show GPSD's AIS decoding status

The other ones could be included after each message description table 
for example.

Chris



--
Christian Gagneraud,
Embedded systems engineer.
Techworks Marine
1 Harbour road
Dun Laoghaire
Co. Dublin
Ireland
Tel: + 353 (0) 1 236 5990
Web: http://www.techworks.ie/