.TH SPIN 1
.SH NAME
spin \- distill files from memory.
.SH SYNOPSIS
.B spin
[
.B -l
N ] path pet
.SH DESCRIPTION
.TP
.B spin
reads a file from standard input.
.TP
.B path
to directory, must not exist.
.TP
.B pet
A pattern consists of any number of 2-symbols from
.RB ' 0123456789ABCDEF '
(the numbers for hexadecimal),
to tell of the bytes expected in succession.
.br
A single
.RB ' . '
means to
.IR blind-search .
.SS Options
.TP
\fB\-l\fR N
limits
.I blind-search
to NUM characters.
(default: 4096)
.SS Innards
A
.I search
starts when, in a
.IR Pet ,
the first pattern before any '.' is found.
Until a
.I search
is complete, no other patterns except those,
which follow the currently searched ones, are important.
.PP
If all the patterns of a
.I Pet
are found, the filename is written to the found inventory.
.PP
If a
.I search
is terminated by EOF or by limit,
the filename is written to the broken inventory.
.PP
In both inventory files, occurrences are
labeled with the start- and end-position of the input.
.SH BUGS
.I spin/extern.h
fills all your definition needs.
   512 active \fIPet\fRs,
   256 chars each.
 = 128KiB of memory.
.PP
A
.IR Pet ,
that exceeds its own storage of characters,
is continued in the next
.IR Pet .
As long as the pattern itself
exceeds not its of-memory, it's fine.