suzanne.soy/hyper-literate
1
0
Fork 0
Code Issues 4 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

update docs with a working URL for --redirect

Browse Source
This commit is contained in:
Matthew Flatt 2018-10-08 19:14:28 -06:00
parent 1a5f2a44bd
commit 150de96b64
2 changed files with 11 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
scribble-doc/scribblings/scribble/renderer.scrbl
View File

@ -3,7 +3,8 @@
"utils.rkt"
(for-label racket/class
scribble/render
scribble/xref))
scribble/xref
setup/dirs))
@(define-syntax-rule (defmodule/local lib . content)
(begin
@ -354,6 +355,7 @@ Configures the renderer to redirect links to external documents via
@racket[url], adding a @tt{tag} query element to the end of the
URL that contains the Base64-encoded, @racket[print]ed, serialized
original tag (in the sense of @racket[link-element]) for the link.
The result of @racket[get-doc-search-url] is intended for use as @racket[url].
If the link is based on a cross-reference entry that has a
document-identifying string (see @racket[load-xref] and its

14
scribble-doc/scribblings/scribble/running.scrbl
View File

@ -148,7 +148,7 @@ information for all installed documentation, and @PFlag{m} or
setup/xref load-collections-xref}.
The @DFlag{redirect-main} flag for HTML output redirects links to the local
installation's documentation to a given URL, such as
installation's documentation (not user-scope documentation) to a given URL, such as
@tt{http://docs.racket-lang.org/}. Beware that documentation links
sometimes change (although Scribble generates HTML paths and anchors
in a relatively stable way), so
@ -156,11 +156,13 @@ in a relatively stable way), so
more reliable when building with an installation for @italic{version}.
The @DFlag{redirect-main} flag is ignored for non-HTML output.
The @DFlag{redirect} flag is like @DFlag{redirect-main}, except
that it builds on the given URL to indicate a cross-reference tag that
is more stable than an HTML path and anchor (in case the documentation
for a function changes sections, for example). No server currently
exists to serve such tag requests, however.
The @DFlag{redirect} flag is like @DFlag{redirect-main}, except that
it builds on the given URL to indicate a cross-reference tag that is
more stable than an HTML path and anchor (in case the documentation
for a function changes sections, for example), and it can generate
redirected linked for documentation that is installed in user scope.
The URL @tt{https://docs.racket-lang.org/local-redirect/index.html} can
work for these redirections.
For cross-references among documentation that is not part of the
Racket installation, use @DFlag{info-out} to save information from a