[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]