Front page | perl.perl6.internals |
Postings from July 2002
RE: [PATCH] .dev files.
Thread Previous
|
Thread Next
From:
Brent Dax
Date:
July 17, 2002 12:26
Subject:
RE: [PATCH] .dev files.
Message ID:
008b01c22dc8$67a26400$6501a8c0@deepblue
John Porter:
# Tanton Gibbs wrote:
# > . . . That saves a person digging through
# > the .c file to find what they are looking for.
# > Perhaps we could automatically update the .dev
# > file with the POD found in the .c file?
#
# As someone else has already said, a better place
# for the .dev information might be inside the .c
# file itself.
# I for one find the separation unnatural,
# uncustomary, and de-sync-prone.
# Frankly I just don't see what it buys us.
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? *That's* the sort of thing the .dev files are
for, not API documentation. I agree that API docs should be in the
source file, but not much more than that.
--Brent Dax <brentdax@cpan.org>
@roles=map {"Parrot $_"} qw(embedding regexen Configure)
He who fights and runs away wasted valuable running time with the
fighting.
Thread Previous
|
Thread Next