[fpc-devel] fpdoc's link attribute in Section tags

Graeme Geldenhuys graemeg.lists at gmail.com
Fri Aug 13 15:54:28 CEST 2010

[... sorry I only noticed now my Subj line is wrong. It should read Element


Due to lack of documentation regarding the link attribute in Element tags,
how are link attributes supposed be be handled.  ps: I'm looking at the
latest PDF docs of the last FPC release.

What happens if an Element tag has a link attribute, but that element node
also contains ShortDescr, Descr, SeeAlso etc nodes?  Does the link
attribute take preference, and the child nodes of that Element gets ignored?

To me the above make sense because the link attribute is at the Element
level. Otherwise it overly complicates matters - and I think will just
confuse documentation writers.

The HTML output writer works as I described above. If the link attribute
exists inside a Element tag, the child nodes of that Element is ignored. I
implemented the Linear output writers behaviour to follow the same rules.

BTW #2:
Please tell me the link attribute is only allowed in the Element tag, and
not in other tags? :-)

  - Graeme -

fpGUI Toolkit - a cross-platform GUI toolkit using Free Pascal

More information about the fpc-devel mailing list