[thechat] Documentation was: Spam Assassin on Windows

[martin.p.burns at uk.pwcglobal.com]

Memo from Martin P Burns of PricewaterhouseCoopers

-------------------- Start of message text --------------------




>Fetchmail's docs are spectacularly obtuse

Really? I found them no worse than your average man page (which is still
pretty bad).

Fetchmail *does* have a few issues though in reliably fetching large
(most mails with attachments) from POP boxes, which can then clog
up getting the rest of your messages. I've got mine set up to
skip large messages, email me to notify (so I can manually fetch if
it's urgent), and only fetch them on every 10th run.

>- maybe
>Python people are just like that because the language
>is comparatively easy to read; certainly Zope's
>documentation is the worst I have *ever* seen on any
>product ever

Hey,  you found documentation!
<tip type="Zope documentation" author="martin at members.evolt.org">
Despite being an application with a sigmoidal learning cliff, Zope is
exceptionally badly documented.

This suggests that there's a fertile market for good Zope books. Market
there may be. <yoda>Fulfilment of that need, there is not.</yoda>

The Zope Book is free from Zope.org. Good job it's free - it's awful as a
learning resource. Don't pay for for the dead tree version.
The Zope Web Application Construction Kit is a great howto to configure
some popular Zope products (CMF, Squishdot). But if you want your site to
do anything different from a pre-fab recipe, you're stuffed.
The Book of Zope is actually not bad (so far). It has actual code samples
(woo!) in both DTML and Python, and goes into why you'd use one rather than
the other. Best I've seen so far.
</tip>

>Either get root to do it

You can also run it as your own user, although it tends to fail if you're
logged out

>with the syntax
>user chris with password foo is chrisevans here
>(or similar)

user chris with password foo is chrisevans here options ssh
is handy if your host supports it - a regular, predicable schedule of
logging in with cleartext makes me a bit nervous.

Cheers
Martin


--------------------- End of message text --------------------

This e-mail is sent by the above named in their
individual, non-business capacity and is not on
behalf of PricewaterhouseCoopers.

PricewaterhouseCoopers may monitor outgoing and incoming
e-mails and other telecommunications on its e-mail and
telecommunications systems.
----------------------------------------------------------------
The information transmitted is intended only for the person or entity to
which it is addressed and may contain confidential and/or privileged
material.  Any review, retransmission, dissemination or other use of, or
taking of any action in reliance upon, this information by persons or
entities other than the intended recipient is prohibited.   If you received
this in error, please contact the sender and delete the material from any
computer.