Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

doc

List of symbols:

build-doc, doc-map, doc-search, get-exemptions, get-globals-sorted, legacy-report, legacy_forms

build-doc

Usage: (build-doc valid-filepath)

Namespace: root

Uses mdbook to build the documentation for the given book.

Example:

#t

doc-map

Usage: (doc-map symbol)

Namespace: root

Returns documentation for given symbol as map. Keyword is a documentation fragment (usage, section, description, example) and value is text describing given fragment.

Example:

#t

Usage: (doc-search query-string [options-map])

Namespace: root

Search through all documentation for functions matching the query. The query string is searched across all documentation fields by default.

Options map can contain:

  • :regex #t - Use regular expressions for matching
  • :basic #t - Use basic matching (characters must appear in order)
  • :fields ["usage" "description"] - Limit search to specific fields
  • :namespace "namespace-name" - Filter by namespace
  • :section "section-name" - Filter by section
  • :markdown #t - Return results as a markdown-formatted string instead of vector
  • :styled #t - Return results with highlighted search matches
  • :style {:highlight-color "\x1b[43m\x1b[30m" ...} - Customize highlight style

Style options (when :style map is provided):

  • :highlight-color - Color for highlighting matches (default: yellow background, black text)
  • :default-color - Color to reset after highlight (default: \x1b[0m)
  • :use-background #f - Use foreground color instead of background

When :styled is true, matching text in results is highlighted to show why each result matched the search query.

Returns a vector of documentation maps, markdown string, or styled string.

Example:

(doc-search "file")
(doc-search "^str-" {:regex #t})
(doc-search "core" {:fields ["section"]})
(doc-search "map" {:basic #t :section "core"})
(doc-search "string" {:markdown #t})
(doc-search "string" {:styled #t})
(doc-search "map" {:style {:highlight-color *fg-red* :use-background #f}})

get-exemptions

Usage: (get-exemptions)

Namespace: root

Return a vector containing all the symbols currently exempted from docs (so the build passes), Ideally this will be 0.

No Examples

get-globals-sorted

Usage: (get-globals-sorted)

Namespace: root

Return a vector containing all the symbols currently defined globally in sorted order (alphanumerically).

No Examples

legacy-report

Usage: (legacy-report)

Namespace: root

Output as a string the current legacy report, detailing how much of the former sl-sh project has been covered by the new slosh.

Example:

#t

legacy_forms

Usage: (legacy_forms)

Namespace: root

Gets list of all forms that were used in the previous version of sl_sh.

Example:

#t