Help and Documentation Utilities

► |  | Help and Documentation Utilities

1 | Searching in the Documentation
2 | Connecting to racket

Help and Documentation Utilities
1 Searching in the Documentation
send-main-page
perform-search
2 Connecting to racket
search-for
find-help/ lib
find-help
go-to-main-page

9.0
top contents ← prev up next →

# Help and Documentation Utilities🔗ℹ

This section describes utilities designed to connect to documentation and to support bug reports. See also scribble/xref.

## 1 Searching in the Documentation🔗ℹ

(require help/search) | package: scribble-lib

> > procedure
> > (send-main-page | [ | #:sub sub |  |  |  |
> > |  | #:notify notify |  |  |  |
> > |  | #:fragment fragment |  |  |  |
> > |  | #:query query]) |  | → |  | any
> sub : path-string? = "index.html"
> notify : (-> (or/c path? string?) void) = void
> fragment : (or/c #f string?) = #f
> query : (or/c #f string?) = #f

Visits the documentation file sub in the user’s browser.

When get-doc-open-url returns #f, send-main-page builds a URL that points into the main collection documentation or into the user-specific documentation, depending on the sub argument. Once it finds the path, send-main-page passes the path to notify. The fragment and query arguments are passed to send-url/file, along with the URL.

When get-doc-open-url returns a URL string, send-main-page appends sub to the URL and passes it to notify. It then appends fragment and query to the URL and passes it on to send-url.

Changed in version 6.0.1.6 of package scribble-lib: Added get-doc-open-url support.

> procedure (perform-search str [context]) → void?
> str : string?
> | context |  | : |  |
> (or/c #f
> string?
> (list/c string? string?))
> |  | = |  | #f

Searches for str in the documentation. The context argument supplies a context for the search or, if it is two strings, a context for the search and a label for that context.

## 2 Connecting to racket🔗ℹ

(require help/help-utils) | package: racket-doc

The help/help-utils library is dynamically loaded by the help form that is available by default in racket.

> procedure (search-for strs) → void?
> strs : (listof string?)

Calls perform-search after concatenating the elements of strs and adding spaces between them.

> procedure (find-help/lib id lib) → void?
> id : symbol?
> lib : module-path?

Visits the documentation page for id as an export of lib.

> procedure (find-help id) → void?
> id : identifier?

Visits the documentation for id.

> procedure (go-to-main-page) → void?

Visits the main entry page for the documentation.
top contents ← prev up next →