Opened 12 years ago

Last modified 12 years ago

#3953 enhancement new

twisted.positioning howto documentation

Reported by: lvh Owned by: lvh
Priority: normal Milestone:
Component: core Keywords:
Cc: Thijs Triemstra Branch: positioning
branch-diff, diff-cov, branch-cov, buildbot


twisted.positioning, at time of writing still in development, should get documentation as soon as the API stabilizes.

Change History (4)

comment:1 Changed 12 years ago by lvh

More reviewing goodness:

t.p.nmea.NMEASentence properties. How do you do these properly? There's a suggestion by yours truly in the added patch, but I'm not entirely sure that's the proper way to handle them. For example, that raises KeyError instead of AttributeError -- and I'm not even sure if we should raise AttributeError or keep the current behavior of "if you don't know, return None".

comment:2 Changed 12 years ago by lvh

Disregard that last comment, attached to the wrong ticket.

comment:3 Changed 12 years ago by greywulf

Proposal for some documentation: ================================

A demo has already been shown here:

I propose adding a directory examples to twisted.positioning which would contain nmealog.txt and would be shell executables, so you could call ./ nmealog.txt

output would be as in would do the same, but demonstrate the 'positionreceived', 'altitudereceived' methods instead of rawer data.

Both examples can have documentation explaining proper usage of twisted.positioning.

If this proposal conflicts with any selected conventions of twisted, feel free to reformat.

comment:4 Changed 12 years ago by Thijs Triemstra

Author: lvh
Cc: Thijs Triemstra added
Owner: changed from Glyph to lvh

Assigning to lvh since he's working on t.positioning.

Note: See TracTickets for help on using tickets.