ugh.book

The Unix Attitude 41 ...

42 ...

3 Documentation?............................................................... What Documentation? “One of the advantages of us ...

44 Documentation? On-line Documentation The Unix documentation system began as a single program called man. man was a tiny utili ...

On-line Documentation 45 indexes every single word in the entire multivolume set; man pages, on the other hand, are still indexe ...

46 Documentation? Nothing showed up, so I started looking in /usr/man. This is despite the fact that I know that things can be e ...

On-line Documentation 47 Waitaminit. There’s no lockf.3 man page on system? Time to try going around the problem: send mail to a ...

48 Documentation? michael: ls lock* No match. michael: cd standard michael: ls lock* lockf.z Oh, goody. It’s compress(1)ed. Why ...

On-line Documentation 49 It turns out that there is no way to obtain a manual page for a pro- gram called “local.” If you try, e ...

50 Documentation? Under the Bourne shell (the ‘standard’ Unix shell), the set command sets option switches. Under the c-shell (t ...

This Is Internal Documentation? 51 Is this documented somewhere or do I have to buy a source license and learn to read C? “man f ...

52 Documentation? Mail version SMI 4.0 Sat Apr 9 01:54:23 PDT 1988 Type? for help. "/usr/spool/mail/chris": 3 messages 3 new > ...

For Programmers, Not Users 53 /lib/cpp /lib/ /usr/local/lib/ /cpp next% Hmm... Excuse us for one second: % ls /lib cpp* gcrt0.o ...

54 Documentation? invention. Sadly, it hasn’t been very successful because of the underlying Unix documentation model establishe ...

For Programmers, Not Users 55 This is not to say that the source code contained worthwhile secrets. Any- one who had both access ...

56 Documentation? Unix Without Words: A Course Proposal ................................... Date: Fri, 24 Apr 92 12:58:28 PST Fr ...

Unix Without Words: A Course Proposal 57 INTRO: overview of the ‘no doc’ philosophy why manuals are evil why man pages are evil ...

58 Documentation? (Alternatively, maybe only chapters 6 & 7 are really necessary. Yeah, that’s the ticket: we'll call it The ...

Unix Without Words: A Course Proposal 59 ...

60 ...