develooper Front page | perl.perl6.internals | Postings from July 2002

RE: [PATCH] .dev files.

Thread Previous | Thread Next
John Porter
July 17, 2002 12:47
RE: [PATCH] .dev files.
Message ID:

Brent Dax wrote:
> Do you really want to see a ten-page discussion of hashing
> algorithms and why the current one was chosen in the middle
> of classes/perlhash.pmc?

I guess that wouldn't bother me as much as it might bother
some other people.

> *That's* the sort of thing the .dev files are for,
> not API documentation.

Well, fine; but then, that's not the sort of doco that needs
to have a 1-to-1 correspondence between source code file and
and doc file.

Furthermore -- why are .dev files not pdd files?
Is it because pdd is *design* while .dev is *implementation*?
If that's the case, then, like I said, having the source and
the doc in separate files, in different directories, makes
keeping them in sync more of a hassle and therefore more
likely to fall through the cracks.  Or "back-burnered".

I wonder what, if anything, XP has to say on this issue.


Do You Yahoo!?
Yahoo! Autos - Get free new car price quotes

Thread Previous | Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About