Provided by: freetable_2.3-4_all bug

NAME

       freetable - tool for making HTML tables generation easier

VERSION

       This manpage describes version 2.3 of freetable.

       It might be not 100% accurate if you use different version.

SYNOPSIS

       freetable [options] filename

       or

       freetable [options]

       Possible options are :

       -h, --help     Print usage info and exit

       -V, --version  Print version information and exit

       -c, --comment  Insert comment before every cell to point its location

       -b, --no-nbsp  Do not insert   to empty cells for lowered-3D apperance

       -w, --warning  Print a warning before each generated table that you should not change it.
       You should change its source.

       -l, --location Substitute <row> and <col> flags inside table with correct cell's location

       -m, --macro [program]
                      Use macro procesor to proces cells content (default: m4)

WARNING

        DO NOT USE MACRO PROCESSOR OVER UNSURE SOURCE
        M4 MAY BE USED TO COMPROMISE YOUR SECURITY
        FOR MORE INFORMATION ON THIS EXEC :

       info m4 'UNIX commands' syscmd

DESCRIPTION

       This is free replacement of wwwtable

       HTML is great language, but have one horrible flaw : tables. I spent many hours looking at
       HTML source I just written and trying to guess which cell in source is which in browser.

       If this also describes you, then read this manpage and your pain will stop.

       Program read HTML source from either stdin or file. Then it searches for line starting
       table:

           <wwwtable [options]>

       Then it analyzes table, put correct HTML table in this place and continue searching for
       the next table.

TABLE SYNTAX

       It is very easy:

           wwwtable :
           <wwwtable [wwwtable_options]>
           [preamble]
           [cell]
           [cell]
           ...
           </wwwtable>

       wwwtable_options will be passed to <table> tags. There is no magic inside preamble. It can
       be any HTML text. It will be simply put in front of table.

       cell is either normal_cell (<td> tag) or header_cell (<th> tag).  At least it was this way
       in freetable 1.x.  See the next section for alternative cell address syntax.

           normal_cell :
           (row,col) cell_options
           cell_content

           header_cell :
           ((row,col)) cell_options
           cell_content

       cell_options will be passed to cell tag. There is magic inside colspan and rowspan keys
       are parsed to make correct table.

       cell_content can be anything. It may contain text, tags, and even nested wwwtables.

       If you use -m (or --macro) option, it will be passed thru m4(1), with <row> and <col> set
       to adress of curent cell

       row and col are either numbers locating cells, expressions relative to previous cell or
       regular expresions to match few of them. Unlike wwwtable, freetable can use regular
       expresions for header cells. Also * can be used, and it mean .* really.

       Relative expressions are :

       = or empty means : the same as previous

       + or +X means : one and X more than previous

       - or -X means : one and X less than previous

       If many definisions adress the same cell all options and contents are concatenated in
       order of apperance.

       If you want to use only regular expresions you must tell program about the last cell :

           <wwwtable>
           (*,1)
           these are colums 1
           (1,*)
           these are rows 1
           (4,4)
           </wwwtable>

ALTERNATIVE CELL ADDRESS SYNTAX

       It is inconvenient to specify cell address as regular expression.  So in freetable 2.0 two
       new methods were introduced.  Both can be used to either normal or header cells.

       Full bakward compatibility is preserved.  To preserve it, new syntax had to be introduced.
       Unfortunatelly, you can't specify row address using one method, and column address using
       another.  To come around this, both new methods are very liberal and allow you to use =,
       +, -, +X -X and null string with the same meaning as they have in old addressing method.

       Unlike regular expression method, new methods will find out the last cell automatically.

       EXPLICIT RANGES

           (rowrange;colrange) cell_options
           cell_content

       Syntax for both rowrange and colrange is like: 1-2,4-7,9,12.  Duplicates will be
       eliminated. For purpose of relative addresses last given number is used. So if you write

           (1-100,32;1)
           foo
           (+,)
           bar

       Cell (33,1) will contain `foobar' and all others only `foo'.

       ARBITRARY PERL CODE

           ({code for rows},{code for tables}) cell_options
           cell_content

       You can use arbitrary Perl one-liner as long as it matches our not very intelligent
       regular expressions and evaluates to list.  Unfortunatelly there isn't any regular
       expression for Perl code, but as long as it doesn't contain },{ and }) it should work.
       Example:

           <wwwtable>
           ({grep {$_%3 == 1} 1..100},{1..2,4})
           foo
           </wwwtable>

       Will evaluate to 100 rows x 4 columns table with `foo' in every 1st, 2nd and 4th column of
       every row with number equal 1 modulo 3.

       If you want to use "arbitrary code" in one part of address and explicit range in the
       other, change - into .. in defenition of range, and put in between { and }.

       If you want to use "arbitrary code" in one part of address and regular expression in the
       other, you have to write {grep {/expression/} from..to}.  Unfortunatelly, in this case you
       have to specify size of the table explicitely.

INCOMPATIBILITIES WITH WWWTABLE

       If you was formerly user of wwwtable and want to change your tool, you should read this.
       Most of this is about regexps handling.  Notice also that wwwtable couldnt do location
       tags substitution nor macroprocesing.

       Option -w has completely oposite meaning. We dont print warnings by default, and -w or
       --warning is used to force warnings.

       Table header fields can be specified by regexps ex :

           ((1,*))

       It was impossible in wwwtable.

       Axis counters are 100% orthogonal. This mean that code :

           (*,1) width=30
           (*,2) width=35
           (*,3) width=40
           (=,=)
           Foo

       Foo will appear in 3rd column. If you wanted it to be in 1st you should write :

           (*,1) width=30
           (*,2) width=35
           (*,3) width=40
           (=,1)
           Foo

       or

           (*,) width=30
           (*,+) width=35
           (*,+) width=40
           (=,1)
           Foo

       In freetable 2.0 two new methods o specifying cell address were introduced. They are
       completely incompatible with wwwtable.

BUGS

       "Arbitrary Perl Code" cell address will fail on very complex Perl code.

SEE ALSO

       m4(1)

AUTHOR

       Tomasz Wegrzanowski <taw@users.sourceforge.net>