The trivial-documentation Reference Manual

This is the trivial-documentation Reference Manual, generated automatically by Declt version 4.0 beta 2 "William Riker" on Mon Feb 26 18:07:15 2024 GMT+0.

Table of Contents


1 Introduction


2 Systems

The main system appears first, followed by any subsystem dependency.


2.1 trivial-documentation

Extract documentation and definitions for symbols and packages.

Author

Max Rottenkolber <>

License

GNU AGPL

Dependencies
  • closer-mop (system).
  • sb-introspect (system).
Source

trivial-documentation.asd.

Child Component

extract.lisp (file).


3 Files

Files are sorted by type and then listed depth-first from the systems components trees.


3.1 Lisp


3.1.1 trivial-documentation/trivial-documentation.asd

Source

trivial-documentation.asd.

Parent Component

trivial-documentation (system).

ASDF Systems

trivial-documentation.


3.1.2 trivial-documentation/extract.lisp

Source

trivial-documentation.asd.

Parent Component

trivial-documentation (system).

Packages

trivial-documentation.

Public Interface
Internals

4 Packages

Packages are listed by definition order.


4.1 trivial-documentation

Extract documentation and definitions for symbols and packages.

Source

extract.lisp.

Use List

common-lisp.

Public Interface
Internals

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.


5.1 Public Interface


5.1.1 Ordinary functions

Function: package-api (package)

*Arguments and Values:*

_package_—a _package_ or a _string designator_ naming a _package_.

*Description:*

{extract-api} compiles and returns a _property list_ mapping the external symbols of _package_ to lists of definitions as returned by {symbol-definitions}. The returned _property list_ is in alphabetical order (by comparing the keys).

Package

trivial-documentation.

Source

extract.lisp.

Function: symbol-definitions (symbol)

*Arguments and Values:*

_symbol_—a symbol.

*Description:*

{symbol-definitions} compiles and returns a list of definitions for _symbol_. Each definition is a _property list_ containing at least two _properties_:

+ {:kind}—one of {:constant}, {:variable}, {:function}, {:generic-function}, {:macro}, {:structure}, {:class} or {:type}.
+ {:documentation}—the respective documentation string or {nil}.

Definitions of kind {:constant} and {:variable} have an additional _property_ {:value} which holds the initial value of the constant or variable.

Definitions of kind {:function}, {:generic-function} and {:macro} have an additional _property_ {:lambda-list} which holds the lambda list of the (generic) function or macro.

Definitions of kind {:class} have three additional _properties_ {:precedence-list}, {:initargs}, and {:slots} which hold the class precedence list, initialization arguments, and a _plist_ of _slot_ names and documentation strings of the class.

Package

trivial-documentation.

Source

extract.lisp.


5.2 Internals


5.2.1 Ordinary functions

Function: class-definition (class-name)

Compile definition for CLASS-NAME.

Package

trivial-documentation.

Source

extract.lisp.

Function: class-precedence-list (class-name)

Get class precedence list for CLASS-NAME.

Package

trivial-documentation.

Source

extract.lisp.

Function: class-slot-initargs (class-name)

Get class slot initargs for CLASS-NAME.

Package

trivial-documentation.

Source

extract.lisp.

Function: class-slots (class-name)

Get plist of slot names and docstrings for CLASS-NAME.

Package

trivial-documentation.

Source

extract.lisp.

Function: function-definition (function-name)

Compile definition for FUNCTION-NAME.

Package

trivial-documentation.

Source

extract.lisp.

Function: function-p (function-name)

Tests if FUNCTION-NAME is bound to a function.

Package

trivial-documentation.

Source

extract.lisp.

Function: generic-function-p (function-name)

Tests if FUNCTION-NAME is bound to a generic function.

Package

trivial-documentation.

Source

extract.lisp.

Function: lambda-list (function-name)

Get lambda list for FUNCTION-NAME.

Package

trivial-documentation.

Source

extract.lisp.

Function: macro-function-p (function-name)

Tests if FUNCTION-NAME is bound to a macro function.

Package

trivial-documentation.

Source

extract.lisp.

Function: make-definition (kind &rest plist)

Base definition constructor. Prepend PLIST with :KIND property of value KIND.

Package

trivial-documentation.

Source

extract.lisp.

Function: normalize-lambda-list (lambda-list)

Flatten symbols with default values.

Package

trivial-documentation.

Source

extract.lisp.

Function: symbol-name-< (symbol-x symbol-y)

Predicate to test if symbol names of SYMBOL-X and SYMBOL-Y satisfy STRING<.

Package

trivial-documentation.

Source

extract.lisp.

Function: type-definition (type-name)

Compile definition for TYPE-NAME.

Package

trivial-documentation.

Source

extract.lisp.

Function: variable-definition (variable-name)

Compile definition for VARIABLE.

Package

trivial-documentation.

Source

extract.lisp.


Appendix A Indexes


A.1 Concepts


A.2 Functions

Jump to:   C   F   G   L   M   N   P   S   T   V  
Index Entry  Section

C
class-definition: Private ordinary functions
class-precedence-list: Private ordinary functions
class-slot-initargs: Private ordinary functions
class-slots: Private ordinary functions

F
Function, class-definition: Private ordinary functions
Function, class-precedence-list: Private ordinary functions
Function, class-slot-initargs: Private ordinary functions
Function, class-slots: Private ordinary functions
Function, function-definition: Private ordinary functions
Function, function-p: Private ordinary functions
Function, generic-function-p: Private ordinary functions
Function, lambda-list: Private ordinary functions
Function, macro-function-p: Private ordinary functions
Function, make-definition: Private ordinary functions
Function, normalize-lambda-list: Private ordinary functions
Function, package-api: Public ordinary functions
Function, symbol-definitions: Public ordinary functions
Function, symbol-name-<: Private ordinary functions
Function, type-definition: Private ordinary functions
Function, variable-definition: Private ordinary functions
function-definition: Private ordinary functions
function-p: Private ordinary functions

G
generic-function-p: Private ordinary functions

L
lambda-list: Private ordinary functions

M
macro-function-p: Private ordinary functions
make-definition: Private ordinary functions

N
normalize-lambda-list: Private ordinary functions

P
package-api: Public ordinary functions

S
symbol-definitions: Public ordinary functions
symbol-name-<: Private ordinary functions

T
type-definition: Private ordinary functions

V
variable-definition: Private ordinary functions


A.3 Variables