On Sep 6, 2006, at 9:34 AM, Lars Jensen wrote:
My latest project has been a REALbasic Language Reference parser. It
reads the HTML LR files and extracts the classes, modules,
interfaces, constants, properties, methods and functions (with their
parameter names, parameter types and return values), events, and
compiler directives that exist in the REALbasic frameworks. The
results are written to an XML file for later processing by
programming tools.
Interesting...this might be a good way to validate a hypothetical
third-party language reference, which could presumably generate the
same set of lists, for automatic comparison. Could it help jump-start
the creation of such a reference, by eliminating a lot of the tedious
drudgery? I'm not sure; there is still a large amount of the "how to"
and example material to consider.
In any case, I'd be interested in seeing the code and output if you
care to make it available.
I'm also one of those users that is very interested in any way to
improve the "Official" documentation in an "In House" manner. As much
as RS has been improving it's OLR, there is still a lot to be
desired. The new format lends itself well to rapid and continuing
changes as opposed to the old format.
As I mentioned in a previous post, there are some facts that have
been drilled into me. Theses are:
1) RS welcomes outside examples and Feedback but is very firm in
controlling anything to do with "Official" documentation.
2) Limited time and manpower are currently being focussed in more
important areas. UBs and Cocoa for example.
3) There have been several attempts at providing a user based Wikki
or example reference but they have usually failed through both lack
of official support from RS or the users themselves.
If you compare the examples from a few years ago and now you will see
that many of them are quite old. They still work but many lack the
new features that have developed over the past few years. Their
numbers have also reduced as many haven't been replaced and no longer
work.
If one compares the multitude of outside MS documentation vs. the
limited REALbasic (or Apple for that matter) documentation one must
also consider the user base differences and the size of the companies.
Better documentation and more examples would be wonderful. More
accurate and understandable current documentation is more important
first, IMHO.
Terry
PS. I would like a draft of your project as well if possible.
_______________________________________________
Unsubscribe or switch delivery mode:
<http://www.realsoftware.com/support/listmanager/>
Search the archives of this list here:
<http://support.realsoftware.com/listarchives/lists.html>
