Should we keep the man pages?

[Poul-Henning Kamp]

In message <498FEDE4.7060108 at redpill-linpro.com>, Per Andreas Buer writes:
>Hi,
>
>There is a lot of confusion regarding the documentation. Some of it is
>in the wiki and some of it is in the manual. Some of it is missing - but
>as always, we're working on that. :-)
>
>Should we drop the man pages? Should we drop all of them or just "man
>vcl"? Dropping a man page would men we would incorporate the content
>into the wiki - maybe adding a few extra ACL's on the pages to restrict
>editing.

I think there should be a manpage for the executables, varnishd, varnishlog,
varnishstat etc.

But for documenting the overall workings and VCL in particular, manpages
suffer badly from the inability to include sensible illustrations.

-- 
Poul-Henning Kamp       | UNIX since Zilog Zeus 3.20
phk at FreeBSD.ORG         | TCP/IP since RFC 956
FreeBSD committer       | BSD since 4.3-tahoe    
Never attribute to malice what can adequately be explained by incompetence.