No subject


Wed Aug 19 09:31:43 CEST 2009


set docdb [XODoc [XODoc autoname docdb]]
::@ set analyzerObj $docdb
$docdb analyzeFile $file
*New Code:*
::@ set analyzerObj [self]
[self] analyzeFile $file

*Reason:* In order to get the inheritance to document correctly, I removed
the call "$docdb writeFile ${docdir}/$docfilename.html $file" and after all
the files are analyzed the write call is made.

*Change #2
*From metadataAnalyzer.xotcl (in a few places in various forms).
*Original Code:*
set t [$procClass create [my autoname ::xotcl::@::t]]
*New Code:
*set t [$procClass new]

*Reason:* Creating all the objects with t as a base name caused older
objects to be overwritten with new objects and then I could not longer
access the information I needed.
*
*
So I'm not sure if there were technical reasons for the code being this way
but I just wanted to point these things out in case this would be a problem.
In addition to the work I mentioned previously, I'm working on supporting
namespace documentation and supporting xotcl documentation for non-xotcl
code.

- Jeff

On Tue, Aug 18, 2009 at 10:00 AM, Gustaf Neumann <neumann at wu.ac.at> wrote:

> Hi Jeff,
>
> your work sounds great (pls. send as well the announced generated samples,
> they
> were not included in your message). We are in the process towards xotcl 2.0
> (there will be a paper at the forthcoming tcl conference);  therefore it
> would be
> a very good time for such improvements.
>
> all the best
> -gustaf neumann
>
>
> Jeff Levesque schrieb:
>
>> Hi All,
>> I hope this is still the right place for this, but I was wondering if
>> anyone
>> has any interest in some changes I've made to xodoc. I've really only
>> added
>> a couple things but they were big requirements for our documentation and I
>> figured it might be this way for others as well. Here's the feature list
>> and
>> what I've completed so far:
>>
>>   - Cleanup the output appearance/Make it look more like javadoc (In
>>   progress)
>>   - List inherited procedures for each class (Mostly finished)
>>   - Fix package (@ package provide ...) documentation (Mostly finished)
>>   - Create a side navigation bar of classes/procedures (similar to
>> javadoc)
>>   (Not started)
>>   - Add HTML functionality to xodoc as needed (In progress)
>>
>> I've attached a sample of the files generated from my version of xodoc. If
>> other people are interested I would go through and clean up the code
>> before
>> I made it available.
>>
>> - Jeff
>>  ------------------------------------------------------------------------
>>
>> _______________________________________________
>> Xotcl mailing list
>> Xotcl at alice.wu-wien.ac.at
>> http://alice.wu-wien.ac.at/mailman/listinfo/xotcl
>>
>>
>
>
> --
> Univ.Prof. Dr. Gustaf Neumann
> Institute of Information Systems and New Media
> WU Vienna
> Augasse 2-6, A-1090 Vienna, AUSTRIA
>
>


More information about the Xotcl mailing list