.rn '' }`
''' $RCSfile$$Revision$$Date$
'''
''' $Log$
'''
.de Sh
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp
.if t .sp .5v
.if n .sp
..
.de Ip
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.de Vb
.ft CW
.nf
.ne \\$1
..
.de Ve
.ft R

.fi
..
'''
'''
'''     Set up \*(-- to give an unbreakable dash;
'''     string Tr holds user defined translation string.
'''     Bell System Logo is used as a dummy character.
'''
.tr \(*W-|\(bv\*(Tr
.ie n \{\
.ds -- \(*W-
.ds PI pi
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
.ds L" ""
.ds R" ""
'''   \*(M", \*(S", \*(N" and \*(T" are the equivalent of
'''   \*(L" and \*(R", except that they are used on ".xx" lines,
'''   such as .IP and .SH, which do another additional levels of
'''   double-quote interpretation
.ds M" """
.ds S" """
.ds N" """""
.ds T" """""
.ds L' '
.ds R' '
.ds M' '
.ds S' '
.ds N' '
.ds T' '
'br\}
.el\{\
.ds -- \(em\|
.tr \*(Tr
.ds L" ``
.ds R" ''
.ds M" ``
.ds S" ''
.ds N" ``
.ds T" ''
.ds L' `
.ds R' '
.ds M' `
.ds S' '
.ds N' `
.ds T' '
.ds PI \(*p
'br\}
.\"	If the F register is turned on, we'll generate
.\"	index entries out stderr for the following things:
.\"		TH	Title 
.\"		SH	Header
.\"		Sh	Subsection 
.\"		Ip	Item
.\"		X<>	Xref  (embedded
.\"	Of course, you have to process the output yourself
.\"	in some meaninful fashion.
.if \nF \{
.de IX
.tm Index:\\$1\t\\n%\t"\\$2"
..
.nr % 0
.rr F
.\}
.TH FREETABLE 1 "perl 5.005, patch 03" "31/Dec/1999" "GNU/Linux Freedomization Project"
.UC
.if n .hy 0
.if n .na
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.de CQ          \" put $1 in typewriter font
.ft CW
'if n "\c
'if t \\&\\$1\c
'if n \\&\\$1\c
'if n \&"
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
'.ft R
..
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
.	\" AM - accent mark definitions
.bd B 3
.	\" fudge factors for nroff and troff
.if n \{\
.	ds #H 0
.	ds #V .8m
.	ds #F .3m
.	ds #[ \f1
.	ds #] \fP
.\}
.if t \{\
.	ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.	ds #V .6m
.	ds #F 0
.	ds #[ \&
.	ds #] \&
.\}
.	\" simple accents for nroff and troff
.if n \{\
.	ds ' \&
.	ds ` \&
.	ds ^ \&
.	ds , \&
.	ds ~ ~
.	ds ? ?
.	ds ! !
.	ds /
.	ds q
.\}
.if t \{\
.	ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.	ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.	ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.	ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.	ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.	ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
.	ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
.	ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.	ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
.\}
.	\" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.ds oe o\h'-(\w'o'u*4/10)'e
.ds Oe O\h'-(\w'O'u*4/10)'E
.	\" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.	\" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.	ds : e
.	ds 8 ss
.	ds v \h'-1'\o'\(aa\(ga'
.	ds _ \h'-1'^
.	ds . \h'-1'.
.	ds 3 3
.	ds o a
.	ds d- d\h'-1'\(ga
.	ds D- D\h'-1'\(hy
.	ds th \o'bp'
.	ds Th \o'LP'
.	ds ae ae
.	ds Ae AE
.	ds oe oe
.	ds Oe OE
.\}
.rm #[ #] #H #V #F C
.SH "NAME"
freetable \- tool for making html tables generation easier
.SH "SYNOPSIS"
\fBfreetable\fR [\-bcw] \fIfilename\fR
.PP
\fI\-c\fR     Do comment before every cell to point its location
.PP
\fI\-b\fR     Do not insert \fI&nbsp;\fR to empty cells to make lowered 3D apperance
.PP
\fI\-w\fR     Do not print a warning before each generated table that
you shouldnt change it. You should change its source.
.SH "DESCRIPTION"
This is free replacement of wwwtable
.PP
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.
.PP
If this also describes you, then read this manpage and your
pain will stop.
.PP
Program read html source from either stdin or file. Then it
searchs for line starting table:
<wwwtable [options]>
Then it analizes table, put correct html table in this place and
continue searching for the next table.
.SH "TABLE SYNTAX"
It is very easy:
.PP
.Vb 7
\&  wwwtable:
\&  <wwwtable [wwwtable_options]>
\&  [preamble]
\&  [cell]
\&  [cell]
\&  ...
\&  </wwwtable>
.Ve
wwwtable_options will be passed to table tags. There is no magic inside
.PP
preamble is any html text. It will be put in front of table.
.PP
cell is either \fInormal_cell\fR\|(td tag) or \fIheader_cell\fR\|(th tag)
.PP
.Vb 3
\&  normal_cell:
\&  (row,col) options
\&  content
.Ve
.Vb 3
\&  header_cell:
\&  ((row,col)) cell_options  
\&  cell_content
.Ve
cell_options will be passed to cell tag. There is magic inside
colspan and rowspan keys are parsed to make correct table.
.PP
cell_content is anything. It may contain tags, even nested wwwtables !
.PP
row and col are either numbers locating cells or regular expresions
to match few of them. Unlike wwwtable, freetable can use regular
expresions for header cells. Also \fI*\fR can be used, and it mean \fI.*\fR really.
.PP
You can also use :
.PP
\fI=\fR or empty what mean : the same as previous
.PP
\fI+\fR or \fI+X\fR what mean : one and X more than previous
.PP
\fI\-\fR or \fI\-X\fR what mean : one and X less than previous
.PP
If many re matches one cell both their options and content are
concatetated.
.PP
If you want use only regular expresions you must tell program about the last cell
.PP
.Vb 8
\&  <wwwtable>
\&  (*,1)
\&  these are colums 1
\&  (1,*)
\&  these are rows 1
\&  (4,4)
\&  </wwwtable>
\&=head1 INCOMPATIBILITIES WITH WWWTABLE
.Ve
If you was formerly user of wwwtable and want to change your tool, you
should read this. Most of this is about regexps handling.
.PP
Table header fields can be specified by regexps ex : ((1,*)). It was
impossible in wwwtable.
.PP
Axis counters are 100% orthogonal. This mean that code :
 (*,1) width=30
 (*,2) width=35
 (*,3) width=40
 (=,=)
 Foo
.PP
Foo will appear in 3rd column, and if oyu wanted it to be in 1th
this should be written :
.PP
.Vb 5
\& (*,1) width=30
\& (*,2) width=35
\& (*,3) width=40
\& (=,1)
\& Foo
.Ve
or
.PP
.Vb 5
\& (*,) width=30
\& (*,+) width=35
\& (*,+) width=40
\& (=,1)
\& Foo
.Ve

.rn }` ''
.IX Title "FREETABLE 1"
.IX Name "freetable - tool for making html tables generation easier"

.IX Header "NAME"

.IX Header "SYNOPSIS"

.IX Header "DESCRIPTION"

.IX Header "TABLE SYNTAX"