
                             Qui-ne-faut HOWTO
                                      
Install and usage

     * fetch the source tarball
     * untar, cd quinefaut and make. The compilation should be
       straightforward, without a warning.
     * find a raw grayscale PNM image file of a scanned text somewhere,
       this one for example: rms.pnm (4M) and put it in the quinefaut
       directory (If you can't download 4M, try this rms.jpg (480k), and
       convert it to raw pnm with the GIMP).
     * type:
./quinefaut -v rms >output.qui
       you should first see a lot of dashes, then a series of
       allocating-freeing patches, then XeT, and it's over. It lasts
       approx. 10s on a Pentium 400 MHz
     * output.qui is a dump of the classifiers. Pipe it into decide:
cat output.qui |./decide trivial trivial.stripped |less
     * here are some lines, and the good version just above :-(
(quinefaut) harhers rawo in at ni0hi io 6r wiih Ihrir rul6rr.  And IheP drve og
rd oiher IradiIions saeh as C
(original)  hackers came in at night to be with their culture. And they develop
ed other traditions such as

(quinefaut) geIIing Chinesr Cood aI IKee  in ihe mowing.  And ( remrw6er wanP s
awses   sren Kow  a rar
(original)  getting Chinese Food at three in the morning. And I remember many s
unrises seen from a car

(quinefaut) cowing 6ark Kom  Chinaiown. (i was ac6allP  a veT  6eauIi61  ihing
Io see a samse    raase IhaI a
(original)  coming back from Chinatown. It was actually a very beautiful thing
to see a sunrise, cause that's

(quinefaut) sarh a calw Iime oC daP. II s a monder6l  Iime oC daP Io gei readP
io go io 6ed
(original)  such a calm time of day. It's a wonderful time of day to get ready
to go to bed
       and that's it.
       
More...?

     * hint: there are a lot of other images in the samples archive
     * let's try some other command line options:
./quinefaut -rkx rms
       it does the same thing, the difference is that is runs quiet, and
       you have funny images now in your working dir:
       rms-rotated-(xxx)rad.pnm, rms-skeleton.pnm, rms-xetresult.pnm.
       View them
     * last thing: try
./quinefaut -d rms >gnuplotish
       you now have a 25M gnuplotish file that contains all the contours
       points coordinates (see the FAQ). Pick up one:
$ grep path012 gnuplotish >contours
$ gnuplot

        G N U P L O T
        Linux version 3.5 (pre 3.6)
        patchlevel beta 340
        last modified Tue Nov 25 22:57:44 GMT 1997

        Copyright(C) 1986 - 1993, 1997
        Thomas Williams, Colin Kelley and many others

        Send comments and requests for help to info-gnuplot@dartmouth.edu
        Send bugs, suggestions and mods to submit@bugs.debian.org

Terminal type set to 'x11'
gnuplot> plot 'contours'
       youpi! that's a beautiful ``h''
       
Have fun
