Re: [vchkpw] using SpamAssassin on a per user basis with qmail

2002-12-09 Thread Nick Lomonte

   ~vpopmail/domains/example.com/user/.qmail
 
 Is this what you are asking?

Yes ;)
 
-- 
Nick Lomonte
Network Engineer
Eonet
[EMAIL PROTECTED]
409.833.1700





Re: [vchkpw] using SpamAssassin on a per user basis with qmail

2002-12-06 Thread Nick Lomonte
On Wed, 2002-11-27 at 14:34, Cory Wright wrote:
  |spamc | /var/vpopmail/bin/vdelivermail '' /var/vpopmail/domains/example.com/user/
   

This works good, is there a way to do this in a .qmail file in the
user's home dir?
 
 
-- 
Nick Lomonte
Network Engineer
Eonet
[EMAIL PROTECTED]
409.833.1700





Re: [vchkpw] using SpamAssassin on a per user basis with qmail

2002-12-06 Thread Cory Wright
On Fri, Dec 06, 2002 at 03:49:43PM -0600, Nick Lomonte wrote:
 On Wed, 2002-11-27 at 14:34, Cory Wright wrote:
   |spamc | /var/vpopmail/bin/vdelivermail '' /var/vpopmail/domains/example.com/user/
 
 This works good, is there a way to do this in a .qmail file in the
 user's home dir?

Sure, I use the following on my account:

  |spamc |maildir ./Maildir/

The 'maildir' command is from the safecat package by Len Budney:

  http://www.nb.net/~lbudney/linux/software/safecat.html

Cory

--
Cory Wright
Stand Blue Technology
http://www.standblue.net/




Re: [vchkpw] using SpamAssassin on a per user basis with qmail

2002-12-06 Thread Cory Wright
On Fri, Dec 06, 2002 at 03:49:43PM -0600, Nick Lomonte wrote:
 This works good, is there a way to do this in a .qmail file in the
 user's home dir?

It just occured to me that you might mean the virtual users's vpopmail home
directory.  

  ~vpopmail/domains/example.com/user/.qmail

Is this what you are asking?

Cory

--
Cory Wright
Stand Blue Technology
http://www.standblue.net/




Re: [vchkpw] using SpamAssassin on a per user basis with qmail

2002-11-27 Thread Cory Wright
On Wed, Nov 27, 2002 at 01:48:59PM -0500, Brendan McAlpine wrote:
 Is it possible to use SA on a per user basis within qmail?

Sure.
 
 I know how to set up SA on a per domain basis, but not all users in the 
 domain I am setting up want spamassassin.  Is there a way to call spamc 
 from a .qmail file within an individual user's directory?

I have a setup like the following:

 [EMAIL PROTECTED] - /var/vpopmail/domains/example.com/user

Then, in /var/vpopmail/domains/example.com/.qmail-user:

 |spamc | /var/vpopmail/bin/vdelivermail '' /var/vpopmail/domains/example.com/user/
  
If you dont user spamc/spamd then you can do something similar with the 
`spamassassin` command.

Cory




Re: [vchkpw] using SpamAssassin on a per user basis with qmail

2002-11-27 Thread Brendan McAlpine
I tried this way, but it didn't work for me for some reason.

Here is how I got it to work a little while ago

1.  install Safecat 
(http://www.nb.net/~lbudney/linux/software/safecat.html)
2.  edit your mailbox's .qmail file to look like this:

| /usr/bin/spamc -u vpopmail | maildir /path/to/your/maildir

Done.

It wasn't hard to implement once I dug around for about an hour and a 
half and found the solution and obviously this isn't compatible with 
qmailadmin.  The first time you go into qmailadmin and muck around with 
forwarding, etc. it will overwrite the .qmail file.

Brendan

On Wednesday, November 27, 2002, at 03:34 PM, Cory Wright wrote:

On Wed, Nov 27, 2002 at 01:48:59PM -0500, Brendan McAlpine wrote:

Is it possible to use SA on a per user basis within qmail?


Sure.


I know how to set up SA on a per domain basis, but not all users in 
the
domain I am setting up want spamassassin.  Is there a way to call 
spamc
from a .qmail file within an individual user's directory?

I have a setup like the following:

 [EMAIL PROTECTED] - /var/vpopmail/domains/example.com/user

Then, in /var/vpopmail/domains/example.com/.qmail-user:

 |spamc | /var/vpopmail/bin/vdelivermail '' 
/var/vpopmail/domains/example.com/user/

If you dont user spamc/spamd then you can do something similar with the
`spamassassin` command.

Cory







Re: [vchkpw] using SpamAssassin on a per user basis with qmail

2002-11-27 Thread Brendan McAlpine
Is there any way around the quota issue that you've found?

That is a big problem.

Brendan
On Wednesday, November 27, 2002, at 04:49 PM, Cory Wright wrote:


On Wed, Nov 27, 2002 at 04:43:28PM -0500, Brendan McAlpine wrote:

1.  install Safecat
(http://www.nb.net/~lbudney/linux/software/safecat.html)
2.  edit your mailbox's .qmail file to look like this:

| /usr/bin/spamc -u vpopmail | maildir /path/to/your/maildir

Done.

It wasn't hard to implement once I dug around for about an hour and a
half and found the solution and obviously this isn't compatible with
qmailadmin.  The first time you go into qmailadmin and muck around 
with
forwarding, etc. it will overwrite the .qmail file.

It also wont take into account any quota limits that are set.

Cory








Re: [vchkpw] using SpamAssassin on a per user basis with qmail

2002-11-27 Thread Cory Wright
On Wed, Nov 27, 2002 at 04:57:52PM -0500, Brendan McAlpine wrote:
 Is there any way around the quota issue that you've found?

Well, the solution is to use vdelivermail.  What was the problem that you
ran into by using that?

Cory




Re: [vchkpw] using SpamAssassin on a per user basis with qmail

2002-11-27 Thread Mystery Admin
On Wed, 27 Nov 2002 at 12:35:26, Cory Wright wrote:

 On Wed, Nov 27, 2002 at 01:48:59PM -0500, Brendan McAlpine wrote:
  Is it possible to use SA on a per user basis within qmail?
 
 Sure.
  
  I know how to set up SA on a per domain basis, but not all users in the 
  domain I am setting up want spamassassin.  Is there a way to call spamc 
  from a .qmail file within an individual user's directory?
 
 I have a setup like the following:
 
  [EMAIL PROTECTED] - /var/vpopmail/domains/example.com/user
 
 Then, in /var/vpopmail/domains/example.com/.qmail-user:
 
  |spamc | /var/vpopmail/bin/vdelivermail ''
 /var/vpopmail/domains/example.com/user/
   
 If you dont user spamc/spamd then you can do something similar with the 
 `spamassassin` command.
 
 Cory

Thanks for the great example!  The other example I had seen used MySQL for
authentication (I believe) eevn though I currently don't.  I'll give this a try!

Happy Thanksgiving! (If you celebrate the Holiday)

Peace

Tom



___
http://jawmail.org/





Re: [vchkpw] using SpamAssassin on a per user basis with qmail

2002-11-27 Thread Brendan McAlpine
Version 5.3.5

Brendan
On Wednesday, November 27, 2002, at 05:19 PM, Cory Wright wrote:


Brendan replied directory to me, I am sending this followup to the 
list.

On Wed, Nov 27, 2002 at 05:10:25PM -0500, Brendan McAlpine wrote:
Mail just disappeared when sent to my test mailbox.

No error messages, no bounce, just vanished.

What was the exact syntax you had for the .qmail file using
vdelivermail again?


|spamc | /var/vpopmail/bin/vdelivermail '' 
/var/vpopmail/domains/example.com/user/

Which version of vpopmail are you using?   I believe you need version 
5.3.7 or
newer and have it compiled with the --enable-make-seekable=y configure 
option
(which is the default).

Cory







Re: [vchkpw] using SpamAssassin on a per user basis with qmail

2002-11-27 Thread Cory Wright
On Wed, Nov 27, 2002 at 06:04:52PM -0500, Brendan McAlpine wrote:
 Version 5.3.5

Try upgrading to a newer 5.3.* release.  I suspect this will fix the 
problem and you will be able to use the spamc - vdelivermail method.

Cory




Re: [vchkpw] using spamassassin....

2002-11-14 Thread Brendan McAlpine
Do you use Spamassassin in conjunction with any other software or 
scripts, such as qmail-scanner, etc.?

Can I just run Spamassassin on its own?

Brendan
On Wednesday, November 13, 2002, at 02:09 PM, Rick Macdougall wrote:

Hi,

We use it in .qmail-default for domains that want it and set the
required_hits to 30.

Users can then manage required_hits, white list, black list etc via a 
PHP
web page.

Regards,

Rick

- Original Message -
From: Brendan McAlpine [EMAIL PROTECTED]
To: [EMAIL PROTECTED]
Sent: Wednesday, November 13, 2002 2:03 PM
Subject: [vchkpw] using spamassassin


Can anyone point me in the right direction for any resources regarding
installing and using spamassassin with qmail?

Basically I want to be able to use spamassassin on certain mailboxes
and not others on the system, and be able to add the ability to use the
filtering as new accounts are added.

TIA

Brendan










RE: [vchkpw] using spamassassin....

2002-11-14 Thread John Johnson
 I run spamassassin with qmail-scanner and I LOVE THE COMBO.. Install
Spamassassin
And configure the local.cf and then install qmail-scanner and it will
find it and
Call it to check email not procmail config files or anything like that..
I love it!

-John


 -Original Message-
 From: Brendan McAlpine [mailto:bmcalpine;macconnect.com] 
 Sent: Thursday, November 14, 2002 9:51 AM
 To: Rick Macdougall
 Cc: [EMAIL PROTECTED]
 Subject: Re: [vchkpw] using spamassassin
 
 
 Do you use Spamassassin in conjunction with any other software or 
 scripts, such as qmail-scanner, etc.?
 
 Can I just run Spamassassin on its own?
 
 Brendan
 On Wednesday, November 13, 2002, at 02:09 PM, Rick Macdougall wrote:
 
  Hi,
 
  We use it in .qmail-default for domains that want it and set the 
  required_hits to 30.
 
  Users can then manage required_hits, white list, black list 
 etc via a
  PHP
  web page.
 
  Regards,
 
  Rick
 
  - Original Message -
  From: Brendan McAlpine [EMAIL PROTECTED]
  To: [EMAIL PROTECTED]
  Sent: Wednesday, November 13, 2002 2:03 PM
  Subject: [vchkpw] using spamassassin
 
 
  Can anyone point me in the right direction for any 
 resources regarding 
  installing and using spamassassin with qmail?
 
  Basically I want to be able to use spamassassin on certain 
 mailboxes 
  and not others on the system, and be able to add the ability to use 
  the filtering as new accounts are added.
 
  TIA
 
  Brendan
 
 
 
 
 
 
 
 
 
 






Re: [vchkpw] using spamassassin....

2002-11-14 Thread Rick Macdougall
Hi,

I personally run it right from .qmail-default with no extra settings like
qmail-scanner.pl etc.

I used to run it from qmail-scanner.pl but the over head was just too much
considering I do smtp forwarding for some domains, other domains didn't want
it, etc etc.

Right now I can configure it for each domain seperately and I remove the
overhead of scanning each and every message that comes into our system.

As well, running it from qmail-scanner.pl loses the ability to do per user
config's.  Something our users really wanted.

Regards,

Rick

- Original Message -
From: Brendan McAlpine [EMAIL PROTECTED]
To: Rick Macdougall [EMAIL PROTECTED]
Cc: [EMAIL PROTECTED]
Sent: Thursday, November 14, 2002 12:50 PM
Subject: Re: [vchkpw] using spamassassin


Do you use Spamassassin in conjunction with any other software or
scripts, such as qmail-scanner, etc.?

Can I just run Spamassassin on its own?

Brendan
On Wednesday, November 13, 2002, at 02:09 PM, Rick Macdougall wrote:

 Hi,

 We use it in .qmail-default for domains that want it and set the
 required_hits to 30.

 Users can then manage required_hits, white list, black list etc via a
 PHP
 web page.

 Regards,

 Rick

 - Original Message -
 From: Brendan McAlpine [EMAIL PROTECTED]
 To: [EMAIL PROTECTED]
 Sent: Wednesday, November 13, 2002 2:03 PM
 Subject: [vchkpw] using spamassassin


 Can anyone point me in the right direction for any resources regarding
 installing and using spamassassin with qmail?

 Basically I want to be able to use spamassassin on certain mailboxes
 and not others on the system, and be able to add the ability to use the
 filtering as new accounts are added.

 TIA

 Brendan












Re: [vchkpw] using spamassassin....

2002-11-14 Thread Brendan McAlpine
I do NOT want to scan each and every message that comes in.  I want to 
set this up on a per user basis.  Is it straightforward to have 
spamassassin scan email for an individual user rather than by domain?

Brendan
On Thursday, November 14, 2002, at 01:00 PM, Rick Macdougall wrote:

Hi,

I personally run it right from .qmail-default with no extra settings 
like
qmail-scanner.pl etc.

I used to run it from qmail-scanner.pl but the over head was just too 
much
considering I do smtp forwarding for some domains, other domains 
didn't want
it, etc etc.

Right now I can configure it for each domain seperately and I remove 
the
overhead of scanning each and every message that comes into our system.

As well, running it from qmail-scanner.pl loses the ability to do per 
user
config's.  Something our users really wanted.

Regards,

Rick

- Original Message -
From: Brendan McAlpine [EMAIL PROTECTED]
To: Rick Macdougall [EMAIL PROTECTED]
Cc: [EMAIL PROTECTED]
Sent: Thursday, November 14, 2002 12:50 PM
Subject: Re: [vchkpw] using spamassassin


Do you use Spamassassin in conjunction with any other software or
scripts, such as qmail-scanner, etc.?

Can I just run Spamassassin on its own?

Brendan
On Wednesday, November 13, 2002, at 02:09 PM, Rick Macdougall wrote:

Hi,

We use it in .qmail-default for domains that want it and set the
required_hits to 30.

Users can then manage required_hits, white list, black list etc via a
PHP
web page.

Regards,

Rick

- Original Message -
From: Brendan McAlpine [EMAIL PROTECTED]
To: [EMAIL PROTECTED]
Sent: Wednesday, November 13, 2002 2:03 PM
Subject: [vchkpw] using spamassassin


Can anyone point me in the right direction for any resources regarding
installing and using spamassassin with qmail?

Basically I want to be able to use spamassassin on certain mailboxes
and not others on the system, and be able to add the ability to use 
the
filtering as new accounts are added.

TIA

Brendan
















Re: [vchkpw] using spamassassin....

2002-11-14 Thread Justin R. Miller
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Said Rick Macdougall on Thu, Nov 14, 2002 at 01:00:57PM -0500:

 I personally run it right from .qmail-default with no extra settings
 like qmail-scanner.pl etc.
 
 I used to run it from qmail-scanner.pl but the over head was just too
 much considering I do smtp forwarding for some domains, other domains
 didn't want it, etc etc.
 
 Right now I can configure it for each domain seperately and I remove
 the overhead of scanning each and every message that comes into our
 system.
 
 As well, running it from qmail-scanner.pl loses the ability to do per
 user config's.  Something our users really wanted.
 
So you just do something like run 'spamc -C /path/to/conf/file' in the
.qmail-default files?  And you said that you have a web frontend for it?
Care to share any code?  ;-)


- -- 
[!] Justin R. Miller [EMAIL PROTECTED]
Encrypted email preferred (key 0xC9C40C31)

-BEGIN PGP SIGNATURE-
Version: GnuPG v1.2.1 (FreeBSD)

iD8DBQE90+ko94d6K8nEDDERAqZ1AJ91e1Xo5lxcgcOk9hFqLbaCFhOvjgCgiKjC
s0z/jWNhqCz1GTbpl2FiwMg=
=XuRH
-END PGP SIGNATURE-




Re: [vchkpw] using spamassassin....

2002-11-14 Thread Jeff Koch

Hi Rick:

Does this work in conjunction with qmailadmin? I thought qmailadmin 
overwrote the entries in qmail-default.


Best Regards, Jeff Koch
--

On Thu, 14 Nov 2002, Rick Macdougall wrote:

 Hi,
 
 I personally run it right from .qmail-default with no extra settings like
 qmail-scanner.pl etc.
 
 I used to run it from qmail-scanner.pl but the over head was just too much
 considering I do smtp forwarding for some domains, other domains didn't want
 it, etc etc.
 
 Right now I can configure it for each domain seperately and I remove the
 overhead of scanning each and every message that comes into our system.
 
 As well, running it from qmail-scanner.pl loses the ability to do per user
 config's.  Something our users really wanted.
 
 Regards,
 
 Rick
 
 - Original Message -
 From: Brendan McAlpine [EMAIL PROTECTED]
 To: Rick Macdougall [EMAIL PROTECTED]
 Cc: [EMAIL PROTECTED]
 Sent: Thursday, November 14, 2002 12:50 PM
 Subject: Re: [vchkpw] using spamassassin
 
 
 Do you use Spamassassin in conjunction with any other software or
 scripts, such as qmail-scanner, etc.?
 
 Can I just run Spamassassin on its own?
 
 Brendan
 On Wednesday, November 13, 2002, at 02:09 PM, Rick Macdougall wrote:
 
  Hi,
 
  We use it in .qmail-default for domains that want it and set the
  required_hits to 30.
 
  Users can then manage required_hits, white list, black list etc via a
  PHP
  web page.
 
  Regards,
 
  Rick
 
  - Original Message -
  From: Brendan McAlpine [EMAIL PROTECTED]
  To: [EMAIL PROTECTED]
  Sent: Wednesday, November 13, 2002 2:03 PM
  Subject: [vchkpw] using spamassassin
 
 
  Can anyone point me in the right direction for any resources regarding
  installing and using spamassassin with qmail?
 
  Basically I want to be able to use spamassassin on certain mailboxes
  and not others on the system, and be able to add the ability to use the
  filtering as new accounts are added.
 
  TIA
 
  Brendan
 
 
 
 
 
 
 
 
 





RE: [vchkpw] using spamassassin....

2002-11-14 Thread John Johnson
 I would like to see this info as well... I am sure there is allways a
better
Way to do things so I have to check this out!!

-John


 -Original Message-
 From: Justin R. Miller [mailto:incanus;codesorcery.net] 
 Sent: Thursday, November 14, 2002 10:19 AM
 To: [EMAIL PROTECTED]
 Subject: Re: [vchkpw] using spamassassin
 
 
 -BEGIN PGP SIGNED MESSAGE-
 Hash: SHA1
 
 Said Rick Macdougall on Thu, Nov 14, 2002 at 01:00:57PM -0500:
 
  I personally run it right from .qmail-default with no extra 
 settings 
  like qmail-scanner.pl etc.
  
  I used to run it from qmail-scanner.pl but the over head 
 was just too 
  much considering I do smtp forwarding for some domains, 
 other domains 
  didn't want it, etc etc.
  
  Right now I can configure it for each domain seperately and 
 I remove 
  the overhead of scanning each and every message that comes into our 
  system.
  
  As well, running it from qmail-scanner.pl loses the ability 
 to do per 
  user config's.  Something our users really wanted.
  
 So you just do something like run 'spamc -C 
 /path/to/conf/file' in the .qmail-default files?  And you 
 said that you have a web frontend for it? Care to share any code?  ;-)
 
 
 - -- 
 [!] Justin R. Miller [EMAIL PROTECTED]
 Encrypted email preferred (key 0xC9C40C31)
 
 -BEGIN PGP SIGNATURE-
 Version: GnuPG v1.2.1 (FreeBSD)
 
 iD8DBQE90+ko94d6K8nEDDERAqZ1AJ91e1Xo5lxcgcOk9hFqLbaCFhOvjgCgiKjC
 s0z/jWNhqCz1GTbpl2FiwMg=
 =XuRH
 -END PGP SIGNATURE-
 
 
 
 






Re: [vchkpw] using spamassassin....

2002-11-14 Thread Rick Macdougall
My my, so many questions :)

I'm going to answer them all in one email to reduce the noise on the list.

1 - Not easy to run it on a per user basis but you can by running it in
their own .qmail file in their directory.  You could do it manually, or hack
qmailadmin to add the code itself to the .qmail file.

2 - No, it currently doesn't work in conjunction with qmailadmin.  If the
administrator of the domain changes the catch-all options it would get over
written.  I'll look into patching qmail to give the admin the option of
adding it or someone else can.  I'm kinda busy with other stuff right now,
so a patch to qmailadmin is near the bottom of my list.

3 - I use spamc -F -u $EXT$HOST to call spamassassin.  That makes spamd
look at a MySQL database for user preferences to over ride the default.  We
currently set required_hits to 30 by default and allow the user to turn on
better filtering if the so desire by a web page using phpsa.php.   That can
be found at http://www.spamassassin.org/devel/

Nothing really tricky to it.

For those who wish, my exact syntax in the qmail-default file is

| preline /usr/bin/spamc -f -u $EXT$HOST | /home/vpopmail/bin/vdelivermail
'' bounce-no-mailbox

Regards to all,

Rick







Re: [vchkpw] using spamassassin....

2002-11-14 Thread Brendan McAlpine
What would be the best syntax to have in the .qmail-default file to 
just filter the emails for the domain through spamassassin?


On Thursday, November 14, 2002, at 01:29 PM, Rick Macdougall wrote:

My my, so many questions :)

I'm going to answer them all in one email to reduce the noise on the 
list.

1 - Not easy to run it on a per user basis but you can by running it in
their own .qmail file in their directory.  You could do it manually, 
or hack
qmailadmin to add the code itself to the .qmail file.

2 - No, it currently doesn't work in conjunction with qmailadmin.  If 
the
administrator of the domain changes the catch-all options it would get 
over
written.  I'll look into patching qmail to give the admin the option of
adding it or someone else can.  I'm kinda busy with other stuff right 
now,
so a patch to qmailadmin is near the bottom of my list.

3 - I use spamc -F -u $EXT$HOST to call spamassassin.  That makes 
spamd
look at a MySQL database for user preferences to over ride the 
default.  We
currently set required_hits to 30 by default and allow the user to 
turn on
better filtering if the so desire by a web page using phpsa.php.   
That can
be found at http://www.spamassassin.org/devel/

Nothing really tricky to it.

For those who wish, my exact syntax in the qmail-default file is

| preline /usr/bin/spamc -f -u $EXT$HOST | 
/home/vpopmail/bin/vdelivermail
'' bounce-no-mailbox

Regards to all,

Rick










Re: [vchkpw] using spamassassin....

2002-11-13 Thread Rick Macdougall
Hi,

We use it in .qmail-default for domains that want it and set the
required_hits to 30.

Users can then manage required_hits, white list, black list etc via a PHP
web page.

Regards,

Rick

- Original Message -
From: Brendan McAlpine [EMAIL PROTECTED]
To: [EMAIL PROTECTED]
Sent: Wednesday, November 13, 2002 2:03 PM
Subject: [vchkpw] using spamassassin


Can anyone point me in the right direction for any resources regarding
installing and using spamassassin with qmail?

Basically I want to be able to use spamassassin on certain mailboxes
and not others on the system, and be able to add the ability to use the
filtering as new accounts are added.

TIA

Brendan







RE: [vchkpw] using spamassassin....

2002-11-13 Thread Clayton Weise
http://www.jerfu.com/toaster

-Original Message-
From: Brendan McAlpine [mailto:bmcalpine;macconnect.com]
Sent: Wednesday, November 13, 2002 11:03 AM
To: [EMAIL PROTECTED]
Subject: [vchkpw] using spamassassin


Can anyone point me in the right direction for any resources regarding 
installing and using spamassassin with qmail?

Basically I want to be able to use spamassassin on certain mailboxes 
and not others on the system, and be able to add the ability to use the 
filtering as new accounts are added.

TIA

Brendan

 




Re: [vchkpw] using spamassassin....

2002-11-13 Thread Brendan McAlpine
I forgot to mention that I am running FreeBSD 4.3.

Brendan
On Wednesday, November 13, 2002, at 02:22 PM, Clayton Weise wrote:


http://www.jerfu.com/toaster

-Original Message-
From: Brendan McAlpine [mailto:bmcalpine;macconnect.com]
Sent: Wednesday, November 13, 2002 11:03 AM
To: [EMAIL PROTECTED]
Subject: [vchkpw] using spamassassin


Can anyone point me in the right direction for any resources regarding
installing and using spamassassin with qmail?

Basically I want to be able to use spamassassin on certain mailboxes
and not others on the system, and be able to add the ability to use the
filtering as new accounts are added.

TIA

Brendan










Re: [vchkpw] using spamassassin....

2002-11-13 Thread Bill Shupp
On Wednesday, November 13, 2002, at 11:22  AM, Brendan McAlpine wrote:


I forgot to mention that I am running FreeBSD 4.3.


Just check out the spamassasin and qmail-scanner docs.  They are both 
detailed and good.

Regards,

Bill Shupp