[racket] another scribble newbie question
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