( x . y )
email: frank@consxy.com | resume (pdf)

Package SHEEP (link)

Main sheep package.

Use sheep to validate that documentation strings on external symbols adhere to a strict format and exist, so that they can be output to markdown format, while looking decent when used within a common lisp process.

Contents (link)

  • function export-package - export-package takes in pkg and converts all the documentation for the symbols into markdown with the hope of emulating the hyperspec style.
  • function pretty-print-validate-packages - pretty-print-validate-packages takes pkgs and runs validation on all of them. It dumps to standard out failures as it comes upon them, finally returning whether it was successful or not.
  • function validate-package - validate-package takes in pkg and validates that all the external symbols adhere to documentation guidelines, exist, and can be parsed to be used for exporting.
  • condition validation-failure - Used internally for sheep parts to signal a validation error.

Function EXPORT-PACKAGE (link)

Syntax:

export-package pkg => markdown

Arguments and Values:

pkg---A package symbol markdown---A string containing the markdown representation of this packages documentation

Description:

export-package takes in pkg and converts all the documentation for the symbols into markdown with the hope of emulating the hyperspec style.

It should only be run after the package has been validated, as it assumes that all documentation it gets will be valid.

Function PRETTY-PRINT-VALIDATE-PACKAGES (link)

Syntax:

pretty-print-validate-packages &rest pkgs => success

pkgs::= pkg*

Arguments and Values:

success---Whether or not all symbols passed validation pkg---A package symbol

Description:

pretty-print-validate-packages takes pkgs and runs validation on all of them. It dumps to standard out failures as it comes upon them, finally returning whether it was successful or not.

This can be used in validation tests to ensure that documentation can be generated at a later date.

Examples:

(pretty-print-validate-packages :pkg1 :pkg2) => t

Function VALIDATE-PACKAGE (link)

Syntax:

validate-package pkg => failures

failures::= failure* failure::= (:failure symb msg)

Arguments and Values:

pkg---A package symbol symb---Symbol the check failed on msg---Message containing information about the failure

Description:

validate-package takes in pkg and validates that all the external symbols adhere to documentation guidelines, exist, and can be parsed to be used for exporting.

Only one error per symbol will be reported at a time, all concatenated to a list in the aforementioned form.

Condition VALIDATION-FAILURE (link)

Used internally for sheep parts to signal a validation error.