formatting HTML in a gtksourceview widget

[Tom Hukins]

On Wed, May 26, 2010 at 07:11:11PM +0100, Dirk Koopman wrote:
> The documentation on HTML::Tidy is less than helpful:
> 
>   clean( $str [, $str...] )
> 
>   Cleans a string, or list of strings, that make up a single HTML file.
> 
>   Returns the cleaned string as a single string.

I believe it's more helpful than it was before I submitted a patch: it
used to say "Returns true if all went OK", never mentioning that it
returns the cleaned up HTML.

The author didn't commit my patch directly, so the documentation
doesn't contain what I wrote (see the RT ticket referenced from my
journal entry), but I'm grateful that he chose to commit any sort of
improvement.

> Not exactly obvious is it?

Perhaps not, but if you can improve it, you should send a patch to the
author.  If you can't improve it, I don't understand what you're
trying to achieve by mentioning this here.

Tom