Documentation with scribble for infix syntax

Questions & Answers
1

Hi,

scribble seems to be done only for prefix notation, if i do that:

@defform[{name <- value}]{
Assign to the variable @racket[name] the value @racket[value].
}

scribble will assume name to be the macro name instead of <- , this annoying because in the index only name will appear.

Is there a way to circumvent this behavior?

Regards,

2

You need to define your own definfix and use that instead of defform.
Check how defform is defined in the Scribble sources.

3

i think i find it:

but the code and the way to modify and integrate it somewhere in scribble is sort of hieroglyphs for me. :grimacing:

update:

but i had find a little hack to put my macro and definitions in the index or left column of the web page:

@defthing[⥆ macro]{}
4

The defform form supports an #:id option. So, you could use

@defform[#:id <- {name <- value}]{
Assign to the variable @racket[name] the value @racket[value].
}

or have definfix expand to that.

2 Likes
5

Thank you, it fits perfectly.