.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.ad l
.
.TH "POLYMER\-BOND" "1" "September 2010" "POLYMER 1.0.0.BETA.4" "Polymer Manual"
.
.SH "NAME"
\fBpolymer\-bond\fR \- Create sprite images defined in your \.polymer file
.
.SH "SYNOPSIS"
\fBpolymer bond\fR [\-\-force] [\-\-fast] [\-\-config=POLYMER_CONFIG]
.
.SH "DESCRIPTION"
Generate the sprites defined in your polymer(5) file\. After each sprite is generated, the sprites are optimised using whichever available PNG optimisers you have installed (PNGOUT, OptiPNG, and PNGCrush) in order to reduce the filesize as much as possible\.
.
.P
Sass and CSS is then generated according to the settings defined in your polymer(5) configuration\.
.
.P
Polymer keeps track of the contents of each sprite with a \fB\.polymer\-cache\fR file so that subsequent runs of \fBpolymer bond\fR will only re\-generate (and re\-optimise) those sprites whose sources have changed\. See the \fIPOLYMER CACHE\fR section \-\- below \-\- for more information\.
.
.SH "OPTIONS"
.
.TP
\fB\-\-force\fR
Something something something dark side: re\-generate sprites even if the sources have not changed since last time\.
.
.TP
\fB\-\-fast\fR
Skips optimisation of generated sprites\. Useful when you want to quickly preview changes without waiting for the optimisers to run\.
.
.TP
\fB\-\-config=<path>\fR
In order to perform some tasks \-\- such as generating sprites \-\- Polymer needs to locate your \fB\.polymer\fR project file\. The default behaviour is to look for one in the current working directory, and to keep ascending the directory structure until it finds one\.
.
.IP
To disable this behaviour, you may supply a path to the config file by using the \fB\-\-config\fR option\.
.
.SH "POLYMER CACHE"
Since optimising sprites can be a lengthy process (very large sprites may take minutes), Polymer keeps track of the contents of each sprite with a \fB\.polymer\-cache\fR file\.
.
.P
Polymer will re\-generate an existing sprite in the following cases:
.
.IP "1." 4
the contents of a source file is changed; or,
.
.IP "2." 4
a new source file is added, or an existing one deleted; or,
.
.IP "3." 4
the generated sprite file is missing; or,
.
.IP "4." 4
you pass the \fB\-\-force\fR option\.
.
.IP "" 0
.
.SH "SEE ALSO"
polymer(5)