." Text automatically generated by txt2man-1.4.7
.TH fbcolor  "Januar 22, 2004" "" ""

.SH ABOUT

fbcolor - create colorflavours of fluxboxstyles
.SH SYNOPSIS
.nf
.fam C

$ \fIcat\fP \fIifile\fP | \fIfbcolor\fP [-ecthHv] > \fIofile\fP
.fam T
.fi
.SH OPTIONS

.TP
.B
-h
display this help
.TP
.B
-H
display detailed usageinformation
.TP
.B
-v
prints the version
.TP
.B
-t file
using a mapfile to turn tags into colors
.TP
.B
-c file
using a mapfile to turn colors into tags
.TP
.B
-e
extract colors from a stylefile an create
a mapfile
.RE
.PP

.SH DESCRIPTION

\fIfbcolor\fP is a small and handy (hopefully) tool to create
different colored flavours of a fluxbox-style.
.PP
basic idea is not to use real colors in the stylefile 
(#rrggbb or grey60 or whatever) but TAGS. then one
creates a MAPFILE which references the TAGS to realcolors
and use this MAPFILE in combination with the TAGGED
stylefile to create the real stylefile.
.RE
.PP

.RS
1.step: create the MAPFILE
.PP
.nf
.fam C
    its not a _rule_ to create the MAPFILE first and the
    tagged stylefile later. you can built them simultaneously
    or even create the MAPFILE from already built styles
    (see 2.step). a mapfile looks like:

    @FONTS@          #000000
    @MASTER@         #222244
    @COLOR1@         #444455
    @COLOR2@         blue4

    ATTENTION: the @ is essential !!!

.fam T
.fi
2.step: create the TAGGED stylefile
.PP
.nf
.fam C
    just use @YOURTAG@ \.\.\.whatever to mark different colors, eg

    menu.title.color:               @TITLECOLOR@
    window.title.focus.colorTo:     @COLORTO@

    ATTENTION: the @ is essential !!!

    to create a tagged stylefile from an normal stylefile
    one has to do the following:

      1. cat style | fbcolor -e > style.map
      2. cat style.map | fbcolor -t style > style.tagged

    thats it. one can then copy and modify this mapfile
    as normal

.fam T
.fi
3.step: create the final style
.PP
.nf
.fam C
    now one uses the generated mapfiles and creates all
    the nice flavours of a style one wants to. thats easy:

.nf
.fam C
     shell$> cat style.map | fbcolor -c style.tagged > newstyle

.fam T
.fi
.RS
and thats it too :)
.SH BUGS

not yet known
.SH AUTHOR

mathias gumz <gumz@cs.uni-magdeburg.de>