[racket] another scribble newbie question
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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.racket-lang.org/users/archive/attachments/20130205/4f15ff83/attachment.html>