lynx-dev Re: documentation benefitting developers (was: lynx2.8.2dev.16)

[Kim DeVaughn]

On Tue, Feb 09, 1999, Klaus Weide (address@hidden) said:
|
| On Mon, 8 Feb 1999, Kim DeVaughn wrote:
| >
| > I dunno the best place to document that "limitation" overall though ..
| > .. perhaps in the README and/or ABOUT-NLS file(s).  Or maybe there
| > should be some kind of INTERNALS file, for documenting such things
| > (which would also include things about var/fn() naming conventions,
| > macro usage (eg, FREE() vs. free()), "style, coding conventions, and
| > the like).
|
| Feel free to take the initiative to start one. :)

I asked for that one, didn't I ... :-) ...!


| Also have a look at
|    Linkname: C Programming Style in libwww
|         URL: http://www.w3.org/Library/User/Style/
|
| I regard some of that as still guiding Lynx, in a loose way.

Thanks ... I'll take a look.

Perhaps it should be added to the "Lynx links" section that is subtitled:

  "Resources for developers, system administrators and web authors"


| Maybe somewhat relevant, long time ago I started docs/README.defines;
| it seems that hasn't been "adopted" or kept updated (including by myself,
| I have to admit).  I didn't invest the necessary time to make and keep it
| relevant, or to advocate it to get "buy-in"...

Heh.  At least you were more organized about it that I ... my current
crib sheets are on the backs of various envelopes, and such.  My cat
tries to help me keep track of them ...

/kim