13 Attaching Documentation to Exports

▼ |  | Syntax: Meta-Programming Helpers

1 | Parsing and Specifying Syntax
2 | Syntax Object Helpers
3 | Datum Pattern Matching
4 | Module-Processing Helpers
5 | Macro Transformer Helpers
6 | Reader Helpers
7 | Parsing for Bodies
8 | Unsafe for Clause Transforms
9 | Source Locations
10 | Preserving Source Locations
11 | Non-Module Compilation And Expansion
12 | Trusting Standard Recertifying Transformers
13 | Attaching Documentation to Exports
14 | Contracts for Macro Subexpressions
15 | Macro Testing
16 | Internal-Definition Context Helpers
| Index

On this page:

provide-and-document
lookup-documentation

top ← prev up next →

### 13`` Attaching Documentation to Exports

(require syntax/docprovide) | package: base

> NOTE: This library is deprecated; use scribble/srcdoc, instead.

> syntax (provide-and-document doc-label-id doc-row ...)
> doc-row |  | = |  | (section-string (name type-datum doc-string ...) ...)
> |  | | |  | (all-from prefix-id module-path doc-label-id)
> |  | | |  | (all-from-except prefix-id module-path doc-label-id id ...)
> name |  | = |  | id
> |  | | |  | (local-name-id external-name-id)

A form that exports names and records documentation information.

The doc-label-id identifier is used as a key for accessing the documentation through lookup-documentation. The actual documentation is organized into “rows”, each with a section title.

A row has one of the following forms:

- (section-string (name type-datum doc-string ...) ...)

  Creates a documentation section whose title is section-string, and provides/documents each name. The type-datum is arbitrary, for use by clients that call lookup-documentation. The doc-strings are also arbitrary documentation information, usually concatenated by clients.

  A name is either an identifier or a renaming sequence (local-name-id extenal-name-id).

  Multiple rows with the same section name will be merged in the documentation output. The final order of sections matches the order of the first mention of each section.

- (all-from prefix-id module-path doc-label-id)

- (all-from-except prefix-id module-path doc-label-id id ...)

  Merges documentation and provisions from the specified module into the current one; the prefix-id is used to prefix the imports into the current module (so they can be re-exported). If ids are provided, the specified ids are not re-exported and their documentation is not merged.

> > procedure
> > (lookup-documentation |  | module-path-v |  |  |  |
> > |  | label-sym) |  | → |  | any
> module-path-v : module-path?
> label-sym : symbol?

Returns documentation for the specified module and label. The module-path-v argument is a quoted module path, like the argument to dynamic-require. The label-sym identifies a set of documentation using the symbol as a label identifier in provide-and-document.
top ← prev up next →