- Reference manual
- SWI-Prolog Source Documentation Version 2
Optionally, the description may be followed by one or more tags. Our tag convention is strongly based on the conventions used by javaDoc. It is adviced to place tags in the order they are described below.
@arg Name Description
- Defines the predicate arguments. Each argument has its own
@argtag. The first word is the name of the argument. The remainder of the tag is the description. Arguments declarations normally appear in order used by the predicate.
@param Name Description
- This is a synonym for
@arg, using the JavaDoc tag name.
@throws Term Description
- Error condition. First Prolog term is the error term. Remainder is the description.
@error Error Description
@throws, but the exception is embedded in
- Author of the module or predicate. Multiple entries are used if there are multiple authors.
- Version of the module. There is no formal versioning system.
- Point to related material. Often contains links to predicates or files.
- The predicate or module is deprecated. The description specifies what to use in new code.
@compat Standards and systems
- When implementing libraries or externally defined interfaces this tag describes to which standard the interface is compatible.
@copyright Copyright holder
- Copyright notice.
@license License conditions
- License conditions that apply to the source.
@bug Bug description
- Known problems with the interface or implementation.
@tbd Work to be done
- Not yet realised behaviour that is enticipated in future versions.