usage of html-table-cell

[Bill Gribble]

On Wed, Jan 24, 2001 at 12:05:28AM -0800, Christian Stimming wrote:
> Could you please explain to me your intented usage of html-table-cell ? I 
> didn't understand the documentation, neither the one in report-html.txt 
> nor the one in sourcecode around the function.

The idea for tables is that you don't have to make special HTML
objects to put in the cells if you are making a table of data.  You
can just put literal numbers, strings, whatever, and the
<html-data-style> for that type gets used to turn the literal into
HTML.

However, there may be times when you need to set HTML markup style
information for an individual table cell, for instance if you want to
use the rowspan or colspan attributes, or if you want to change some
data or markup style information just for a particular cell.

In that case, you use an <html-table-cell> as the data in your call to
gnc:html-table-set-cell! or other table creation function.  You can
set whatever style information you want for the cell, and cells have
explicit support for setting rowspan and colspan.

As I am looking at the code, I see that I never finished the
html-table-cell-render function, so it never outputs the rowspan and
colspan in the <td> attributes.. oops! Also I see that if you want to
set a rowspan or colspan for a column header you can't do it with an
<html-table-cell>... that needs to be fixed.

> BTW, I think you better move report-html.txt to the gnucash/src/doc 
> directory. Took me quite some time to find it once again, since it's 
> hidden in a lot of scheme code...

You're right.  I should probably finish documenting the HTML
generation code, too :) I'm going back to working on reports pretty
soon so I'll generate more documentation as I go along.

b.g.