update for 'long-key index entry configuration

Author: mflatt

scribble-doc/scribblings/scribble/base.scrbl

@@ -9,7 +9,7 @@
    (syntax-rules ()
      [(_ id result/c x ...)
       (defproc (id [#:tag tag (or/c #f string? (listof string?)) #f]
-                   [#:tag-prefix tag-prefix (or/c #f string? module-path?) #f]
+                   [#:tag-prefix tag-prefix (or/c #f string? module-path? hash?) #f]
                    [#:style style (or/c style? #f string? symbol? (listof symbol?)) #f]
                    [pre-content pre-content?] (... ...+))
         result/c
@@ -63,7 +63,7 @@ have @racketmodname[scribble/manual]).
 @section{Document Structure}
 
 @defproc[(title [#:tag tag (or/c #f string? (listof string?)) #f]
-                [#:tag-prefix tag-prefix (or/c #f string? module-path?) #f]
+                [#:tag-prefix tag-prefix (or/c #f string? module-path? hash?) #f]
                 [#:style style (or/c style? #f string? symbol? (listof symbol?)) #f]
                 [#:version vers (or/c string? #f) #f]
                 [#:date date (or/c string? #f) #f]
@@ -88,7 +88,10 @@ multi-page HTML output.
 The @racket[tag-prefix] argument is propagated to the generated
 structure (see @secref["tags"]). If @racket[tag-prefix] is a module
 path, it is converted to a string using
-@racket[module-path-prefix->string].
+@racket[module-path-prefix->string]. Similarly, if @racket[tag-prefix]
+is a hash table with @racket['tag-prefix] mapped to a module path,
+then it is replaced with a hash table where @racket['tag-prefix] is
+mapped to a string.
 
 The @racket[vers] argument is propagated to the @racket[title-decl]
 structure. Use @racket[""] as @racket[vers] to suppress version

scribble-doc/scribblings/scribble/manual.scrbl

@@ -2349,6 +2349,7 @@ exhaustive, because new modules can re-export the binding).}
                                                                                     [(method-name) symbol?]
                                                                                     [(constructor?) boolean?]
                                                                                     [(class-tag) tag?]
+                                                                                    [(long-key) string?]
                                                                                     [else any/c])]
                                                                                #:immutable #t))])]{
 
@@ -2375,12 +2376,17 @@ Some additional keys are well-known:
        in the case of a method or constructor index entry, where the
        @racket[name] field has the class name in both cases.}
 
+ @item{@racket['long-key]: An alternative string for searches to match.
+       This string is useful when the name that is normally used to refer to
+       a binding has an extra prefix that is added on import, for example.}
+
 ]
 
 The @racket[exported-index-desc*] struct is preferable over
 other index entry descriptions below.
 
-@history[#:added "1.53"]}
+@history[#:added "1.53"
+         #:changed "1.59" @elem{Added @racket['long-key].}]}
 
 @defstruct[(form-index-desc exported-index-desc) ()]{
 

scribble-lib/info.rkt

@@ -21,7 +21,7 @@
 
 (define pkg-authors '(mflatt eli))
 
-(define version "1.58")
+(define version "1.59")
 
 (define license
   '((Apache-2.0 OR MIT)

scribble-lib/scribble/manual-struct.rkt

@@ -36,7 +36,8 @@
                                                        [(method-name) symbol?]
                                                        [(display-from-libs) (listof content?)]
                                                        [(constructor?) boolean?]
-                                                       [(class-tag) tag?])])]
+                                                       [(class-tag) tag?]
+                                                       [(long-key) string?])])]
  [(method-index-desc exported-index-desc) ([method-name symbol?]
                                            [class-tag tag?])]
  [(constructor-index-desc exported-index-desc) ([class-tag tag?])]