Actor and model documentation is displayed using custom widget. The documentation for an actor or model can be edited by the user. To view the documentation for an actor, right click on the actor and select Documentation -> Get Documentation.
This functionality is implemented using DocTableau and other classes in vergil.actor and the PtDoclet doclet.
If the application is run from a prebuilt Windows installer, then the documentation usually need not be built. If the application was built from sources, the documentation files will need to be created.
If the documentation system is missing its files, the the Doc Builder
window will come up. To rebuild the documentation, view the documentation
on any actor, attribute or director, right click on the object,
select Documentation -> Get Documentation and then select Build ->
Build docs in the Doc Viewer. The Documentation Builder will requires
that $PTII/configure
was run so that the system knows
which packages are present.
If you are building from source, then you can either use the Documentation Builder as above or run:
cd $PTII/doc; make docs
make docs
in $PTII/doc
.
This rule runs
ptolemy.moml.filter.ActorIndex, which read in two files:
$PTII/doc/codeDoc/allNamedObjs.txt
$PTII/doc/doclets/PtDoclet.java
. This doclet is run while running
make
in $PTII/doc
.
$PTII/config/doc/models.txt
$PTII/config/doc/completeDemos.htm
.
cd $PTII/config makeThat rule runs HTMLAbout.main() which creates
models.txt
.
models.txt
need only be updated if
$PTII/config/doc/completeDemos.htm
changes.
.idx
files in $PTII/doc/codeDoc
.