[racket] another scribble newbie question
As in my other mail a minute ago, thank you Matthew.
Jos
> -----Original Message-----
> From: Matthew Flatt [mailto:mflatt at cs.utah.edu]
> Sent: domingo, 21 de abril de 2013 17:59
> To: Jos Koot
> Cc: users at racket-lang.org
> Subject: Re: [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