[Home] [Groups] - Message: [Prev in Group] [Next in Group]

nu.kanga.list.mud-dev

9181: [MUD-Dev] Re: MUD Design doc (long)

[Full Header] [Plain Text]
From: J C Lawrence <claw@under.engr.sgi.com>
Newsgroups: nu.kanga.list.mud-dev
Date: Mon, 21 Dec 1998 15:34:08 -0800
References: [1]
Organization: Kanga.Nu
On Fri, 18 Dec 1998 16:41:22 -0500 
Benjamin D Wiechel<strycher@toast.net> wrote:

> IIRC, one of JCL's responses to this thread pointed out that
> getting programmers to document in the code, much less to write
> actual external documentation, and then to also convince them to
> keep it updated, is quite a daunting task.  It may be an
> impossible one.

Let's just say that there is a commercial OS out there in whose
source I made the following comment (faithfully checked in, thru
code review etc):

  /* I don't know what this code does, but I do know that it doesn't
do what the above comment says it does.  Exercise caution. */

--
J C Lawrence                              Internet: claw@kanga.nu
(Contractor)                             Internet: coder@kanga.nu
---------(*)                    Internet: claw@under.engr.sgi.com
...Honorary Member of Clan McFud -- Teamer's Avenging Monolith...