Project

General

Profile

Actions

Bug #4909

open

Actor documentation: updates ignored, duplicate info, how to refer to other actors/models?

Added by Christopher Brooks over 14 years ago.

Status:
New
Priority:
Normal
Category:
documentation
Target version:
Start date:
03/29/2010
Due date:
% Done:

0%

Estimated time:
Bugzilla-Id:
4909

Description

A few comments about the Kepler Actor Documentation system

1. If I update the .xml file for a Director, then preexisting models
do not get the updates. I think this is wrong. For example,
I added text to PNDirector.xml. If a user has a preexisting model
that uses PNDirector, then to see the new text, they would need
to drag in a new PNDirector.

2. The model files contain copies of the documentation. This is
related to point 1 above. This will be an issue for large systems
because parsing a large file with redundant info takes time and
possibly consumes lots of memory

3. In a documentation .xml file, how do I refer to another actor
or director? For example in
kepler/directors/resources/kar/CoreDirectors/PNDirector.xml
I want to refer to the Ramp actor so that if the user
clicks on the link, then they are shown the Ramp actor documentation
How do I do that?

4. In a documentation .xml file, how do I refer to a model?
For example, in
kepler/directors/resources/kar/CoreDirectors/PNDirector.xml
I want to refer to
ptolemy/domains/pn/demo/RemoveNilTokens/RemoveNilTokens.xml
How do I do that?

Actions

Also available in: Atom PDF