[antlr-interest] Lazy load of CommonTokenStream??
Ron Hunter-Duvar
ron.hunter-duvar at oracle.com
Mon Aug 18 14:34:55 PDT 2008
But a developer doesn't usually expect to have to build all his tools
first (though it happens, esp. in Linux 8^). By your reasoning, the jar
files are equally redundant, as they can easily be rebuilt from the Java
source files.
Ron
Raphael Reitzig wrote:
> 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.
> ------------------------------------------------------------------------
>
>
> List: 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.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.antlr.org/pipermail/antlr-interest/attachments/20080818/3ad75efa/attachment.html
More information about the antlr-interest
mailing list