[Gardeners] Project Proposal: Standardized Utility Library

[Chris Dean]

Nikodemus Siivola <nikodemus at random-state.net> writes:
[many good examples deleted]

I see, thanks.  I wasn't clear on the difference between what I think
of as library documentation and the kind of spec you were mentioning .
(BTW, I think it's a difference in degree and not in kind.)

As an examplar of the documenation level I'm aiming for see:

  http://www.weitz.de/cl-ppcre/#all-matches

    all-matches regex target-string &key start end => list

    Returns a list containing the start and end positions of all
    matches of regex against target-string, i.e. if there are N
    matches the list contains (* 2 N) elements. If regex matches an
    empty string the scan is continued one position behind this match.

        Examples:

        * (cl-ppcre:all-matches "a" "foo bar baz")
        (5 6 9 10)

        * (cl-ppcre:all-matches "\\w*" "foo bar baz")
        (0 3 3 3 4 7 7 7 8 11 11 11)

I'm a regular user of CL-PPCRE (thanks Edi!) and it strikes me as just
the right level of documentation. 

Cheers,
Chris Dean