2006-12-05  Behdad Esfahbod  <behdad@gnome.org>

        * docs/pango-sections.txt:
        * docs/tmpl/layout.sgml:
        * pango/pango-layout.c (pango_layout_get_lines_readonly),
        (pango_layout_get_line_readonly),
        (pango_layout_iter_get_run_readonly),
        (_pango_layout_iter_get_line), (pango_layout_iter_get_line),
        (pango_layout_iter_get_line_readonly):
        * pango/pango-layout.h:
        * pango/pango-renderer.c (pango_renderer_draw_layout):
        * pango/pango.def:
        Add new functions:
                pango_layout_iter_get_line_readonly()
                pango_layout_get_lines_readonly()
                pango_layout_iter_get_line_readonly()
                pango_layout_iter_get_run_readonly()
        These should be used when you do not intend to modify the run/line,
        which is more than most of the time.  So, update your app, benefit
        from more optimizations (in this case, line extents caching)!