This is the documentation-utils Reference Manual, version 1.2.0, generated automatically by Declt version 4.0 beta 2 "William Riker" on Sun Dec 15 06:00:13 2024 GMT+0.
The main system appears first, followed by any subsystem dependency.
documentation-utils
A few simple tools to help you with documenting your library.
Yukari Hafner <shinmera@tymoon.eu>
Yukari Hafner <shinmera@tymoon.eu>
(GIT https://github.com/Shinmera/documentation-utils.git)
zlib
1.2.0
trivial-indent
(system).
package.lisp
(file).
toolkit.lisp
(file).
documentation.lisp
(file).
Files are sorted by type and then listed depth-first from the systems components trees.
documentation-utils/documentation-utils.asd
documentation-utils/package.lisp
documentation-utils/toolkit.lisp
documentation-utils/documentation.lisp
documentation-utils/documentation-utils.asd
documentation-utils
(system).
documentation-utils/package.lisp
documentation-utils
(system).
documentation-utils/toolkit.lisp
package.lisp
(file).
documentation-utils
(system).
*default-formatter*
(special variable).
*documentation-tests*
(special variable).
*documentation-translators*
(special variable).
check
(function).
define-docs
(macro).
define-documentation-alias
(macro).
define-documentation-test
(macro).
define-documentation-translator
(macro).
documentation-formatter
(class).
documentation-test
(function).
(setf documentation-test)
(function).
documentation-translator
(function).
(setf documentation-translator)
(function).
format-documentation
(generic function).
remove-documentation-test
(function).
remove-documentation-translator
(function).
list-symbols
(function).
plain-formatter
(class).
removef
(function).
split-body-options
(function).
documentation-utils/documentation.lisp
toolkit.lisp
(file).
documentation-utils
(system).
Packages are listed by definition order.
documentation-utils
docs
org.shirakumo.documentation-utils
common-lisp
.
*default-formatter*
(special variable).
*documentation-tests*
(special variable).
*documentation-translators*
(special variable).
check
(function).
define-docs
(macro).
define-documentation-alias
(macro).
define-documentation-test
(macro).
define-documentation-translator
(macro).
documentation-formatter
(class).
documentation-test
(function).
(setf documentation-test)
(function).
documentation-translator
(function).
(setf documentation-translator)
(function).
format-documentation
(generic function).
remove-documentation-test
(function).
remove-documentation-translator
(function).
list-symbols
(function).
plain-formatter
(class).
removef
(function).
split-body-options
(function).
Definitions are sorted by export status, category, package, and then by lexicographic order.
Variable for the default formatter to use.
This should be either a DOCUMENTATION-FORMATTER instance, or a symbol
naming the class of one.
By default this value is an instance of PLAIN-FORMATTER.
See DOCUMENTATION-FORMATTER
See PLAIN-FORMATTER
See DEFINE-DOCS
Holds an alist of documentation types to test functions.
The function should take one argument, the specifier, and return non-NIL if the symbol is bound for the given type.
Holds an alist of documentation types to translator functions.
The function should take one argument, the specifier expression, and return a documentation form suitable to access the documentation for the given type.
Allows you to comfortably and easily set the documentation for your library.
Each expression in the body can either take a two or many argument structure. In the two argument structure, the type is implicitly assumed to be FUNCTION. The first argument is then the specifier, and the second the documentation. In the many argument structure the first argument is the type, the last is the documentation, and everything in between the specifier.
The expansion of the documentation accessor –and thus the structure of
the specifier– is dependant on the applicable documentation translator.
By default, the expansion is simply (CL:DOCUMENTATION SPECIFIER TYPE).
In addition to the actual documentation expressions, the docs definition may
begin with a set of keyword-value pairs. These options supply initargs for
the documentation formatter. By default, the formatter is *DEFAULT-FORMATTER*,
but a formatter class of your own can be selected with the :FORMATTER option.
This formatter will then translate the documentation expression at compile time
to reduce it into a docstring as expected by the underlying documentation
storage. Note that the initarg values are used at macroexpansion time, and so
are used as literals. If the chosen formatter is already a formatter instance,
the initargs are used with REINITIALIZE-INSTANCE. Otherwise if the formatter
is a symbol, MAKE-INSTANCE Is used.
See *DOCUMENTATION-TRANSLATORS*
See FORMAT-DOCUMENTATION
See *DEFAULT-FORMATTER*
Shorthand to define an alias to a translator.
This simply sets a delegating function that refers to the given type.
See *DOCUMENTATION-TRANSLATORS*
Shorthand to define a documentation test function.
See *DOCUMENTATION-TESTS*
Shorthand to define a documentation translator function.
See *DOCUMENTATION-TRANSLATORS*
Checks whether all symbols have documentation for all known types.
If documentation is not set for a given symbol and type combination, a
warning is signalled.
See *DOCUMENTATION-TESTS*
Access the documentation test function for the given type.
See *DOCUMENTATION-TESTS*
Access the documentation translator function for the given type.
See *DOCUMENTATION-TRANSLATORS*
Remove the documentation test function for the given type.
See *DOCUMENTATION-TESTS*
Remove the documentation translator function for the given type.
See *DOCUMENTATION-TRANSLATORS*
Processes the documentation string according to the formatter’s rules.
Passed along are the three values that make up a documentation definition:
- The fundamental type of the definition as used in DOCUMENTATION.
- An additional set of variants used to distinguish more complicated
definitions. For instance, for methods this would be the method qualifiers.
- The expression used for the actual documentation. This is always the last
expression within a documentation definition expression.
The function should either error on an invalid documentation expression, or
return a string to be passed to the underlying documentation storage.
You may use this function to store the documentation expression elsewhere
so that it may be processed into different formats using additional markup
than is appropriate for plain strings.
See DOCUMENTATION-FORMATTER
plain-formatter
) type var documentation) ¶Base class for all documentation formatters.
A documentation formatter is responsible for translating user-defined
documentation expressions into docstrings usable by the underlying
documentation storage. This can also be used to hook it into other systems
that access documentation and may enrich it with further styling or
information.
The only relevant function for this class is FORMAT-DOCUMENTATION, which
is used to perform the translation.
See FORMAT-DOCUMENTATION
Removes the given set of keys from the plist and returns a fresh copy.
Splits the body of expressions into two parts, a plist, and a body.
Returned are two values: a plist, and a body. The plist is composed of all keyword-value pairs found at the beginning of the body. The returned body is all the remaining expressions.
A formatter that only allows strings and emits them verbatim.
This is the default formatter.
See DOCUMENTATION-FORMATTER
Jump to: | (
C D F G L M R S |
---|
Jump to: | (
C D F G L M R S |
---|
Jump to: | *
S |
---|
Jump to: | *
S |
---|
Jump to: | C D F P S T |
---|
Jump to: | C D F P S T |
---|