[PLUG] Personal Documentation

Paul Johnson baloo at ursine.ca
Sun Feb 15 10:57:01 UTC 2004


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Sun, Feb 15, 2004 at 10:06:45AM -0800, Bill Spears wrote:
> Discussion for a quiet Sunday, when we should all be outside, because it
> is really sunny and beautiful:

I would, but I'm broke, and if I leave my parking space, odds are I'm
not getting it back.

> I like Linux, in fact, I  love it.  But dammmn, there are a lot of
> things to do and know, and man pages are usually useful only if you just
> need a reminder for some option name.  For example, it is pretty hard to
> figure out cdrecord from it's man pages, although it can be done.

Well, that's why there's frontends like k3b, xcdroast and CD Bake
Oven.  They deal with cdrecord so you don't have to.

But the comment about the man-pages...I learned Linux from those.  I
don't see what the big deal is.  Granted, I'm coming from the
perspective of learning DOS from the DOS 3.3 manual when I was 8.  But
still, if an 8-year-old could handle worse documentation than a man
page and come out on top, surely someone with a high school or college
education can handle it readily.

> So I was wondering, what kind of solutions have you come up with? 
> Anybody have their own man pages, info pages, html, doc book, spiral
> notebookes (my choice), whatever?  Let's talk.

Debian provides a nice package called dwww, which is pretty much
everything I need.
http://ursine.ca/dwww/

- -- 
 .''`.     Paul Johnson <baloo at ursine.ca>
: :'  :    
`. `'`     proud Debian admin and user
  `-  Debian - when you have better things to do than fix a system
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (GNU/Linux)

iD8DBQFAL8DLUzgNqloQMwcRAr/yAJ9ASMxExIvGpaK/rAJVq0mqFS02IACgyPbH
OXh3gdtPx9y2Ci4wmLbMT0A=
=aLS2
-----END PGP SIGNATURE-----




More information about the PLUG mailing list