The adp Reference Manual

This is the adp Reference Manual, generated automatically by Declt version 4.0 beta 2 "William Riker" on Sun Dec 15 04:12:00 2024 GMT+0.

Table of Contents


1 Introduction


2 Systems

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


2.1 adp

Add Documentation, Please. A Common Lisp documentation generator and literate programming tool with Scribble files and @-syntax support.

Author

Héctor Galbis Sanchis

License

MIT

Dependencies
  • named-readtables (system).
  • scribble (system).
  • alexandria (system).
Source

adp.asd.

Child Components

3 Files

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


3.1 Lisp


3.1.1 adp/adp.asd

Source

adp.asd.

Parent Component

adp (system).

ASDF Systems

adp.


3.1.2 adp/package.lisp

Source

adp.asd.

Parent Component

adp (system).

Packages

adp.


3.1.3 adp/adp.lisp

Dependency

package.lisp (file).

Source

adp.asd.

Parent Component

adp (system).

Public Interface
Internals

4 Packages

Packages are listed by definition order.


4.1 adp

Source

package.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 Macros

Macro: define-adp-file (name &optional type)

Defines an adp file.

Package

adp.

Source

adp.lisp.

Macro: define-adp-operation (name)

Defines an adp operation.

Package

adp.

Source

adp.lisp.


5.1.2 Generic functions

Generic Function: export-content (op files system)

Exports the files gathered by ADP.

Package

adp.

Source

adp.lisp.

Generic Reader: file-component (object)
Package

adp.

Methods
Reader Method: file-component ((file file))

automatically generated reader method

Source

adp.lisp.

Target Slot

component.

Generic Reader: file-elements (object)
Package

adp.

Methods
Reader Method: file-elements ((file file))

automatically generated reader method

Source

adp.lisp.

Target Slot

elements.

Generic Function: post-process-file (op f)
Package

adp.

Source

adp.lisp.

Methods
Method: post-process-file ((op adp-op) f)
Generic Function: post-process-system (op s)
Package

adp.

Source

adp.lisp.

Methods
Method: post-process-system ((op adp-op) s)
Generic Function: pre-process-file (op f)
Package

adp.

Source

adp.lisp.

Methods
Method: pre-process-file ((op adp-op) f)
Generic Function: pre-process-system (op s)
Package

adp.

Source

adp.lisp.

Methods
Method: pre-process-system ((op adp-op) s)

5.1.3 Standalone methods

Method: operation-done-p ((o adp-op) (c component))

We can’t know if output files has been modified or removed. So, operation must always be done.

Package

asdf/action.

Source

adp.lisp.

Method: operation-done-p ((o prepare-adp-op) (c component))

We can’t know if output files has been modified or removed. So, operation must always be done.

Package

asdf/action.

Source

adp.lisp.

Method: perform ((o adp-op) (c scribble-source-file))
Package

asdf/action.

Source

adp.lisp.

Method: perform ((o load-op) (c scribble-source-file))
Package

asdf/action.

Source

adp.lisp.

Method: perform ((o compile-op) (c scribble-source-file))
Package

asdf/action.

Source

adp.lisp.

Method: perform ((o adp-op) (c system))
Package

asdf/action.

Source

adp.lisp.

Method: perform ((o adp-op) (c static-file))
Package

asdf/action.

Source

adp.lisp.

Method: perform ((o adp-op) (c cl-source-file))
Package

asdf/action.

Source

adp.lisp.

Method: perform ((o prepare-adp-op) (s system))
Package

asdf/action.

Source

adp.lisp.

Method: perform ((o prepare-adp-op) (c component))
Package

asdf/action.

Source

adp.lisp.


5.2 Internals


5.2.1 Special variables

Special Variable: *files*

A container with all the content files. The keys are the pathnames of the file relative to the asdf root file.

Package

adp.

Source

adp.lisp.


5.2.2 Macros

Macro: with-package-and-stream ((package-name stream-name file) &body body)
Package

adp.

Source

adp.lisp.


5.2.3 Ordinary functions

Function: add-file (file)

Adds a file to the files container.

Package

adp.

Source

adp.lisp.

Function: destroy-files-container ()

Destroys the files container.

Package

adp.

Source

adp.lisp.

Function: eval-expression (expr file)
Package

adp.

Source

adp.lisp.

Function: get-package-and-stream (file)
Package

adp.

Source

adp.lisp.

Function: make-files-container ()

Initializes the files container.

Package

adp.

Source

adp.lisp.

Function: reexport (symbol package)
Package

adp.

Source

adp.lisp.


5.2.4 Generic functions

Generic Reader: error-condition (condition)
Generic Writer: (setf error-condition) (condition)
Package

adp.

Methods
Reader Method: error-condition ((condition eval-error))
Writer Method: (setf error-condition) ((condition eval-error))
Source

adp.lisp.

Target Slot

error-condition.

Generic Reader: expression (condition)
Generic Writer: (setf expression) (condition)
Package

adp.

Methods
Reader Method: expression ((condition eval-error))
Writer Method: (setf expression) ((condition eval-error))
Source

adp.lisp.

Target Slot

expression.

Generic Reader: file (condition)
Generic Writer: (setf file) (condition)
Package

adp.

Methods
Reader Method: file ((condition eval-error))
Writer Method: (setf file) ((condition eval-error))
Source

adp.lisp.

Target Slot

file.

Generic Function: get-load-operation (o)
Package

adp.

Source

adp.lisp.

Methods
Method: get-load-operation ((o prepare-adp-op))

5.2.5 Conditions

Condition: eval-error
Package

adp.

Source

adp.lisp.

Direct superclasses

error.

Direct methods
Direct slots
Slot: error-condition
Initform

(quote nil)

Initargs

:error-condition

Readers

error-condition.

Writers

(setf error-condition).

Slot: expression
Initform

(quote nil)

Initargs

:expression

Readers

expression.

Writers

(setf expression).

Slot: file
Initform

(quote nil)

Initargs

:file

Readers

file.

Writers

(setf file).


5.2.6 Classes

Class: adp-op

Operation for loading and generating documentation.

Package

adp.

Source

adp.lisp.

Direct superclasses
  • downward-operation.
  • selfward-operation.
Direct methods
Direct slots
Slot: selfward-operation
Package

asdf/action.

Allocation

:class

Initform

(quote adp::prepare-adp-op)

Class: file

Represents a unit of documentation that groups several elements.

Package

adp.

Source

adp.lisp.

Direct methods
Direct slots
Slot: component
Type

asdf/component:source-file

Initargs

:component

Readers

file-component.

Writers

This slot is read-only.

Slot: elements
Type

vector

Initform

(make-array 100 :fill-pointer 0)

Initargs

:elements

Readers

file-elements.

Writers

This slot is read-only.

Class: prepare-adp-op

Operation for loading and generating the documentation of dependencies.

Package

adp.

Source

adp.lisp.

Direct superclasses
  • sideway-operation.
  • upward-operation.
Direct methods
Direct slots
Slot: sideway-operation
Package

asdf/action.

Allocation

:class

Initform

(quote asdf/lisp-action:load-op)

Class: scribble-source-file

Component class for a Scribble source file (using type "scrbl")

Package

adp.

Source

adp.lisp.

Direct superclasses

source-file.

Direct methods
Direct slots
Slot: type
Package

common-lisp.

Initform

"scrbl"


Appendix A Indexes


A.1 Concepts


A.2 Functions

Jump to:   (  
A   D   E   F   G   M   O   P   R   W  
Index Entry  Section

(
(setf error-condition): Private generic functions
(setf error-condition): Private generic functions
(setf expression): Private generic functions
(setf expression): Private generic functions
(setf file): Private generic functions
(setf file): Private generic functions

A
add-file: Private ordinary functions

D
define-adp-file: Public macros
define-adp-operation: Public macros
destroy-files-container: Private ordinary functions

E
error-condition: Private generic functions
error-condition: Private generic functions
eval-expression: Private ordinary functions
export-content: Public generic functions
expression: Private generic functions
expression: Private generic functions

F
file: Private generic functions
file: Private generic functions
file-component: Public generic functions
file-component: Public generic functions
file-elements: Public generic functions
file-elements: Public generic functions
Function, add-file: Private ordinary functions
Function, destroy-files-container: Private ordinary functions
Function, eval-expression: Private ordinary functions
Function, get-package-and-stream: Private ordinary functions
Function, make-files-container: Private ordinary functions
Function, reexport: Private ordinary functions

G
Generic Function, (setf error-condition): Private generic functions
Generic Function, (setf expression): Private generic functions
Generic Function, (setf file): Private generic functions
Generic Function, error-condition: Private generic functions
Generic Function, export-content: Public generic functions
Generic Function, expression: Private generic functions
Generic Function, file: Private generic functions
Generic Function, file-component: Public generic functions
Generic Function, file-elements: Public generic functions
Generic Function, get-load-operation: Private generic functions
Generic Function, post-process-file: Public generic functions
Generic Function, post-process-system: Public generic functions
Generic Function, pre-process-file: Public generic functions
Generic Function, pre-process-system: Public generic functions
get-load-operation: Private generic functions
get-load-operation: Private generic functions
get-package-and-stream: Private ordinary functions

M
Macro, define-adp-file: Public macros
Macro, define-adp-operation: Public macros
Macro, with-package-and-stream: Private macros
make-files-container: Private ordinary functions
Method, (setf error-condition): Private generic functions
Method, (setf expression): Private generic functions
Method, (setf file): Private generic functions
Method, error-condition: Private generic functions
Method, expression: Private generic functions
Method, file: Private generic functions
Method, file-component: Public generic functions
Method, file-elements: Public generic functions
Method, get-load-operation: Private generic functions
Method, operation-done-p: Public standalone methods
Method, operation-done-p: Public standalone methods
Method, perform: Public standalone methods
Method, perform: Public standalone methods
Method, perform: Public standalone methods
Method, perform: Public standalone methods
Method, perform: Public standalone methods
Method, perform: Public standalone methods
Method, perform: Public standalone methods
Method, perform: Public standalone methods
Method, post-process-file: Public generic functions
Method, post-process-system: Public generic functions
Method, pre-process-file: Public generic functions
Method, pre-process-system: Public generic functions

O
operation-done-p: Public standalone methods
operation-done-p: Public standalone methods

P
perform: Public standalone methods
perform: Public standalone methods
perform: Public standalone methods
perform: Public standalone methods
perform: Public standalone methods
perform: Public standalone methods
perform: Public standalone methods
perform: Public standalone methods
post-process-file: Public generic functions
post-process-file: Public generic functions
post-process-system: Public generic functions
post-process-system: Public generic functions
pre-process-file: Public generic functions
pre-process-file: Public generic functions
pre-process-system: Public generic functions
pre-process-system: Public generic functions

R
reexport: Private ordinary functions

W
with-package-and-stream: Private macros