Toby Inkster > HTML-Microformats > HTML::Microformats::Documentation::Notes

Download:
HTML-Microformats-0.105.tar.gz

Annotate this POD

Website

CPAN RT

Open  2
View/Report Bugs
Source  

NAME ^

HTML::Microformats::Documentation::Notes - misc usage and design notes

NOTES ^

Byzantine Internals

The internals of HTML::Microformats are pretty complicated - best to steer clear of them. Here are three usage patterns that mostly avoid dealing with the internals:

Stuff that's b0rked

The get_foo, set_foo, add_foo, clear_foo methods defined in HTML::Microformats::Format work unreliably and are poorly documented. You're better off using the data method and inspecting the returned structure for the data you need. This will be fixed in the future.

Here be monsters

There are several parts of the code which are incredibly complicated and desperately need refactoring. This will be done at some point, so don't rely too much on their current behaviour.

stringify and _stringify_helper in HTML::Microformats::Utilities. The whole of HTML::Microformats::Mixin::Parser.

SEE ALSO ^

HTML::Microformats.

AUTHOR ^

Toby Inkster <tobyink@cpan.org>.

COPYRIGHT AND LICENCE ^

Copyright 2008-2012 Toby Inkster

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: