Some files you might expect to find in ./pugs/docs/ are actually elsewhere:

./README                 Installation, platforms, mailinglists and websites.

./lib/pugs/run.pod       pugs::run - How to run Pugs
./lib/pugs/hack.pod      pugs::hack - How to hack on Pugs

./READTHEM               Haskell resources. Assorted recommended reading.

./dist/doc/html          Documentation of haskell files.
                         Created by "make haddock".
                         There is an online copy at:
                      http://nothingmuch.woobling.org/pugs_test_status/haddock/

./docs/talks/README      Contains links to html and pdf versions of talks.