From mboxrd@z Thu Jan 1 00:00:00 1970 Date: Fri, 2 Nov 2007 16:19:11 +0800 From: "fernanbolando" To: "Fans of the OS Plan 9 from Bell Labs" <9fans@cse.psu.edu>, "Pietro Gagliardi" Subject: Re: [9fans] Suggestion: Programming Tutorial for /sys/doc MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Message-ID: In-Reply-To: <02597431-3833-4DDD-8720-E0B2761DBE88@mac.com> References: <02597431-3833-4DDD-8720-E0B2761DBE88@mac.com> Cc: Topicbox-Message-UUID: e5bba20e-ead2-11e9-9d60-3106f5b1d025 -----Original Message----- From: Pietro Gagliardi > Hello. I've been trying out programming Plan 9 since I got the system > up and I think I'm getting the hang of learning from man pages. I'm > not a big fan of having to type "man -t 2 xxx | page" about 100 times > a day to figure out something, and there are things that the man > pages don't cover in a clear way, so I think a tutorial should be put > in. I already started writing one, and I think it would benefit from > being in /sys/doc. It will cover: > - basics > - compiler usage > - file access > - threads > - graphics and controls > - hopefully networking > - debugging > within about 15-30 pages. Anyone like this idea? - Pietro For someone like me who have not gotten used to the entire plan 9 ideas yet. Something like this would be very useful. But I think this type of documentation should be placed in the wiki not in /sys/doc. Once you have learned the system, you only need the man files as references or to get more details. Even in linux I remove all the documentation I can find except for the man files.