[racket] another scribble newbie question

From: Matthew Flatt (mflatt at cs.utah.edu)
Date: Sun Apr 21 11:59:08 EDT 2013

I finally added a `#:link-target?' option to `defproc', etc., so you
can get the layout of `defproc' without defining/indexing.

At Tue, 5 Feb 2013 00:54:00 +0100, "Jos Koot" wrote:
> Hi,
> At last, with help of this list, I have a readable scribble/manual for my
> planet-fmt, I think. In this manual I have:
>  
> #lang scribble/manual
> blah blah blah
> @defproc[(fmt
>           (format (or/c string? fmt?)) ...
>           (port (or/c output-port? 'string 'current 'argument) 'string))
>          fmt?]
> Procedure @racket[fmt] produces a format-procedure, blah blah blah ....
>  
> Now I want to explain how to use the procedures produced by procedure fmt.
> There are two cases, therefore I include the following in the manual:
>  
> When procedure @racket[fmt] was called with an output-port or symbol
> @racket['string] or @racket['current] for its port-argument, the returned
> format-procedure can be called as follows:
> @defproc[#:kind "format-procedure"
>  (format-procedure
>   (datum any/c) ...)
>  (or/c string? void?)]
> When procedure @racket[fmt] was called with symbol @racket['argument] for
> its
> port-argument, the returned format-procedure can be called as follows:
> @defproc[#:kind "format-procedure"
>  (format-procedure
>   (port (or/c output-port? 'string 'current))
>   (datum any/c) ...)
>  (or/c void? string?)]
> blah blah blah
>  
> Now I have a problem: the identifier `format-procedure´ is included in the
> table of contents (two times). My question is: "how can I avoid every
> mention of this identifier in the table of contents?". Or asked in another
> way: how can I use the layout rendered by defproc without actually
> defproccing?
>  
> The `WARNING: collected information for key multiple times etc
> format-procedure etc´ does not bother me. In fact there is no info for this
> identifier.
>  
> I know we have defproc* too, but I think that would make my manual rather
> complicated for the reader.
>  
> Thanks to all who contributed to scribble, it is great,
> Jos
> ____________________
>   Racket Users list:
>   http://lists.racket-lang.org/users


Posted on the users mailing list.