Date: Wed, 7 Jun 1995 13:19:42 +0900 (JST)
From: "Stephen J. Turnbull" <turnbull AT turnbull DOT sk DOT tsukuba DOT ac DOT jp>
To: djgpp AT sun DOT soe DOT clarkson DOT edu
Subject: Proposal: DJGPP doc project (Was: Re: VOTE: CODE STANDARDS)

On Tue, 6 Jun 1995, DJ Delorie wrote:
> On Tue, 6 Jun 1995, Steve Turnbull [that's me] wrote:
>
> > software that's going to go away in the near future, the documentation of 
> > GO32 would be a horrible amount of effort.  Right?  Now, if you've looked 
> > at V2 and see similar problems, that might be a lot more important.  
> > But...  Who's gonna do the writing?
> 
> Someone with a good knowledge of English, I hope.  Volunteers sorely
> needed.
> 
> Well, enough from me.  Remember, "you are free to do what you want, as
> long as you don't stop others from being free to do what they want."
> The more people help with djgpp, the better it gets.  If you rely on
> me and the few people actively working on it, you get what we want, at
> the pace we are working.  If everyone getting this message (about 700
> people, I'm guessing) wrote a page of documentation, or documented one
> source file, we'd be done in a day.
> 
> Today seems like a good day to start.

As somebody else pointed out, coordination makes life more difficult, and
delays accomplishment.  I learned a while back that I'm not much for
actually writing stuff.  (I proposed a reorganization of the FAQ over a
year ago, then never released anything.  Thanks for doing it, Eli!)  But I
do read my mail, and I do coordination-type work pretty well. 

I volunteer to *coordinate* a "DJGPP Documentation Project."  I don't
promise to do any actual writing. :-) I will maintain (1) a list of who's
working on what; (2) a list of what's been accomplished; (3) a wish list; 
(4) an archive of documents (minimally in source form; possibly also in
ready-to-print forms), both the FSF docs and those produced by the project
specifically for DJGPP, and (5) a mailing list for those active in the
project.  (Announcements would reasonably go to djgpp-announce.)

Please mail me directly about this.  Suggestions for the wish list,
preferred source format(s), volunteers to write documents,
proposals/volunteers for a better coordinator :-), whatever. 

For the moment, the mailing list will be a simple alias on my Linux box; 
I don't trust my skills with listservs yet.  So mail requests to get on 
the list to me, too. 

... And as long as I'm here:

I made some uncalled-for (at least in public) sarcastic comments.  I
apologize to DJ, who has been setting a heroic example of (lack of)
flameage for 4 years (in my experience) now.  I apologize to the DJGPP
public, who are by and large calm, soft-spoken types.  Finally, I
apologize to Mr. Walker; "pot. kettle. black." would be a reasonable reply
to my comments.  The apology could easily be private, I suppose, but I
would like to set a better example than I did, and hope others won't 
follow that example.

Steve
-- 
Yaseppochi-gumi    http://turnbull.sk.tsukuba.ac.jp/   also anonymous FTP.