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
doc-search
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