builder-2.1.1.rdoc 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758
  1. = Builder 2.1.1 Released.
  2. Release 2.1.1 of Builder is mainly a bug fix release.
  3. == Changes in 2.1.1
  4. * Added <tt>reveal</tt> capability to BlankSlate.
  5. * Fixed a bug in BlankSlate where including a module into Object could
  6. cause methods to leak into BlankSlate.
  7. * Fixed typo in XmlMarkup class docs (from Martin Fowler).
  8. * Fixed test on private methods to differentiate between targetted and
  9. untargetted private methods.
  10. * Removed legacy capture of @self in XmlBase (@self was used back when
  11. we used instance eval).
  12. * Added additional tests for global functions (both direct and
  13. included).
  14. * Several misc internal cleanups, including rearranging the source
  15. code tree.
  16. <b>NOTE:</b> The escaping attribute values by default is different
  17. than in previous releases of Builder. This makes version 2.0.x
  18. somewhat incompatible with the 1.x series of Builder. If you use "&",
  19. "<", or ">" in attributes values, you may have to change your
  20. code. (Essentially you remove the manual escaping. The new way is
  21. easier, believe me).
  22. == What is Builder?
  23. Builder::XmlMarkup is a library that allows easy programmatic creation
  24. of XML markup. For example:
  25. builder = Builder::XmlMarkup.new(:target=>STDOUT, :indent=>2)
  26. builder.person { |b| b.name("Jim"); b.phone("555-1234") }
  27. will generate:
  28. <person>
  29. <name>Jim</name>
  30. <phone>555-1234</phone>
  31. </person>
  32. == Availability
  33. The easiest way to get and install builder is via RubyGems ...
  34. gem install builder (you may need root/admin privileges)
  35. == Thanks
  36. * Martin Fowler for spotting some typos in the documentation.
  37. -- Jim Weirich