Re: doc snarfing does not work with Sun Forte preprocessor

From:

Neil Jerram

Subject:

Re: doc snarfing does not work with Sun Forte preprocessor

Date:

11 May 2001 00:37:25 +0100

User-agent:

Gnus/5.0808 (Gnus v5.8.8) Emacs/20.7

>>>>> "Michael" == Michael Livshin <address@hidden> writes:
Michael> Neil Jerram <address@hidden> writes:
>> - how do you know that you are building Guile with enough regex
>> support? (without which writing the tool would be a pain)
Michael> my memory is failing me again, it seems. what are
Michael> regexps needed for?
Michael> to extract the docstrings from the source? CPP does
Michael> that.
Michael> to massage the docstrings? I think it can be done
Michael> without regexp support -- the Texinfo'ish markup that is
Michael> used in the docstrings is pretty straightforwardly
Michael> parseable. regexps might make the task slightly easier,
Michael> though.
Yes, massaging; particularly the case when the new GCC (and now
Solaris CC) puts all of the docstring lines on the same output line. I
agree that this doesn't _require_ regex support, but it would be
easier with it.
Michael> looks to me I was being alarmist...
???
>> - some people suggested that the Right Thing would be for the
>> docstrings to become part of libguile (i.e. the library) and
>> then be handled correctly from within.
Michael> and those people still think so, let there be no doubt
Michael> about that. but fixing the current setup would also be
Michael> nice if it's not much work, what with a release getting
Michael> close.
Agreed, but I'm afraid I don't fancy it myself.
Neil