[racket] another scribble newbie question

From: Jos Koot (jos.koot at gmail.com)
Date: Mon Apr 22 09:46:24 EDT 2013

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



Posted on the users mailing list.