[antlr-interest] Lazy load of CommonTokenStream??
Raphael Reitzig
r_reitzi at cs.uni-kl.de
Mon Aug 18 14:00:28 PDT 2008
Well, only developers will use ANTLR. A developer should be able and
willing to use common developer tools.
I'm not strictly against putting doc in the downloads, but I do not
follow your arguments.
Besides, doc in downloads would be redundant. All information is in
the sources (and, as a bonus, can easily and quickly be transformed to
a readable format). I don't like redundancies.
Regards
Raphael
"Ron Hunter-Duvar" <ron.hunter-duvar at oracle.com> wrote (Mon Aug 18
21:48:41 2008):
> Yeah, but why expect each user to figure out how to do this, and
> install ant and doxygen if they're not already. Why not include it
> in a doc directory in the source shipment if it's already built?
>
> As it happens, I don't have ant installed due to some broken
> dependencies on the Linux I'm using. Installing ant forces a whole
> bunch of stuff I don't need (Eclipse, gcj, ...) and an Antlr-2.7.6
> package that breaks my use of Antlr 3.1. Until I work around that, I
> can't generate the docs locally.
>
> Ron
>
>
> Raphael Reitzig wrote:
>> That's what ant is made for!
>>
>> Try typing "ant doc" or "ant javadoc" when in downloads root folder
>> (seeing build.xml). Usually, doc targets are named like that. Any
>> different here?
>>
>> Raphael
>>
>> "Ron Hunter-Duvar" <ron.hunter-duvar at oracle.com> wrote (Mon Aug 18
>> 19:02:28 2008):
>>
>>> That helps, thanks.
>>>
>>> But I'd still like to have the Javadoc shipped with the source
>>> distribution if possible. It's what I'm used to working with, and
>>> it integrates well with the IDE I use (which doesn't generate it
>>> on its own, AFAIK). It also doesn't require me to be online to be
>>> able to look something up.
>>>
>>> I thought it was trivial to generate too, but I've never used the
>>> javadoc program myself before. When I tried to generate it I got a
>>> lot of warnings and errors. If I get time I'll look into it some
>>> more.
>>>
>>> Thanks,
>>> Ron
>>>
>>>
>>> Johannes Luber wrote:
>>>> Kay Röpke schrieb:
>>>>
>>>>> On Aug 18, 2008, at 5:35 PM, Ron Hunter-Duvar wrote:
>>>>>
>>>>>
>>>>>> Javadoc? As far as I can see, there isn't any in the source
>>>>>> distribution (and frankly, I was wondering why, but didn't get to
>>>>>> asking). Is it supposed to be there and somehow got missed? Or are we
>>>>>> supposed to roll our own?
>>>>>>
>>>>> Oh. I guess it isn't generated then. Didn't even notice that, because I
>>>>> always use an IDE and it apparently computes that automatically from the
>>>>> source attachment I configured.
>>>>> I think it should be generated, it's trivial to do so, isn't it?
>>>>>
>>>>> Ter?
>>>>>
>>>>
>>>> Look here: <http://antlr.org/api/Java/index.html>
>>>>
>>>> Johannes
>>>>
>>>>> cheers,
>>>>> -k
>>>>>
>>>>
>>>>
>>>>
>>>
>>> --
>>> Ron Hunter-Duvar | Software Developer V | 403-272-6580
>>> Oracle Service Engineering
>>> Gulf Canada Square 401 - 9th Avenue S.W., Calgary, AB, Canada T2P 3C5
>>>
>>> All opinions expressed here are mine, and do not necessarily represent
>>> those of my employer.
>>>
>>>
>>
>>
>>
>> ----------------------------------------------------------------
>> This message was sent using IMP, the Internet Messaging Program.
>> ------------------------------------------------------------------------
>>
>> http://www.antlr.org/mailman/listinfo/antlr-interest
>> Unsubscribe:
>> http://www.antlr.org/mailman/options/antlr-interest/your-email-address
>>
>>
>
> --
> Ron Hunter-Duvar | Software Developer V | 403-272-6580
> Oracle Service Engineering
> Gulf Canada Square 401 - 9th Avenue S.W., Calgary, AB, Canada T2P 3C5
>
> All opinions expressed here are mine, and do not necessarily represent
> those of my employer.
>
>
----------------------------------------------------------------
This message was sent using IMP, the Internet Messaging Program.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 191 bytes
Desc: PGP Digital Signature
Url : http://www.antlr.org/pipermail/antlr-interest/attachments/20080818/2f48d524/attachment.bin
More information about the antlr-interest
mailing list