[hpoj-devel] updated SCAN-HOWTO documentation

[PASCHAL,DAVID (HP-Roseville,ex1) <dav...@hp...>]

Hi.  I just checked in some large updates to SCAN-HOWTO and some small
updates to INSTALL.  This was mostly to reflect the split of SANE into
separate backend and frontend packages and to add more detailed information
about scanning with ptal-hp.  I haven't yet gone through my old e-mail or
followed the setup instructions exactly to make sure I captured all the
"gotchas", but if anybody sees any mistakes, vague or incomplete
information, poor wording, typos, etc., then please let me know.  This
information is also accessible on the web site (click on "Documentation"),
useful for those who aren't using the development code in CVS, and be sure
to click on the CVS version of SCAN-HOWTO on that page.

Looking longer term, I would still like to further reorganize the
documentation for 0.8.  I'm considering changing the format from plain text
to HTML, to make it easier to hyperlink between different parts of the
documentation for the sake of walking users through basic installation and
linking to more detailed information about each command.  Since I expect
everybody has an HTML viewer on their system these days, this shouldn't be a
big problem, but I would be interested to hear what other people think.  I
probably will keep the HTML pretty light-weight just in case anybody needs
to look at it in plain-text modes (and also due to my poor HTML skills:-).
I may or may not provide Unix manual pages for the various commands in
addition to HTML versions.  In any case, the documentation will still be
provided with the package as well as on the web, for both the released and
CVS versions, so web access will still be optional for reading the
documentation.

David