I think the missing `f` in the left-hand margin reflects a missing
`defmodule`. Adding
@defmodule[some-module]
or
@declare-exporting[some-module]
makes `f` appear as expected.
At Wed, 16 Dec 2015 13:34:57 -0800 (PST), Matthew Butterick wrote:
> > Maybe there should be a `scribble/lp-manual` to provide the manual
> > style in the same way as `scribble/manual`.
>
> Perhaps, since it also implicates semantic issues, not just formatting. For
> instance, the following code produces a "<*>" link in the left-hand margin,
> but not an "f" link (as would be typical for `scribble/manual`).
>
> #lang scribble/lp2
> @(require scribble/manual)
>
> @title[#:style manual-doc-style]{Greatest function ever}
>
> @defproc[
> (f
> [x number?])
> number?]
> Squares a number.
>
> @chunk[<*>
> (define (f x) (* x x))]
>
>
>
>
> On Wednesday, December 16, 2015 at 1:12:59 PM UTC-8, Matthew Flatt wrote:
> > One solution is to attach `manual-doc-style` to a title:
> >
> > #lang scribble/lp2
> > @(require scribble/manual)
> >
> > @title[#:style manual-doc-style]{Example}
> >
> > @chunk[<f>
> > (define (f x) (+ x 1))]
> >
> > If you don't want to show a title, then it gets trickier.
> >
> > Maybe there should be a `scribble/lp-manual` to provide the manual
> > style in the same way as `scribble/manual`.
> >
> > At Wed, 16 Dec 2015 12:11:19 -0800, Matthew Butterick wrote:
> > > If you make these two Scribble files and click "Scribble HTML" in
> DrRacket,
> > > the second one (with `#lang scribble/manual) will render in the current
> manual
> > > style. But the first one (with `#lang scribble/lp2`) will render in the
> older
> > > manual style.
> > >
> > > This rendering issue surfaced on the list before [1] about `scribble/lp`.
> At
> > > the time, the answer seemed to be that it was a flaw that would be fixed
> in
> > > `scribble/lp2`. But the flaw seems to persist? Or am I doing it wrong?
> > >
> > > ;;
> > > ;; lp.scrbl
> > > ;;
> > > #lang scribble/lp2
> > > @chunk[<f>
> > > (define (f x) (+ x 1))]
> > >
> > > ;;
> > > ;; lp-wrap.scrbl
> > > ;;
> > > #lang scribble/manual
> > > @include-section[(submod "lp.scrbl" doc)]
> > >
> > >
> > >
> > > [1]
> > >
> https://groups.google.com/forum/#!searchin/racket-users/scribble$2Flp%7Csort:da
> > > te/racket-users/mkbYIHWnPwI/iV6h8FXJor4J
>
> --
> You received this message because you are subscribed to the Google Groups
> "Racket Users" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to racket-users+unsubscr...@googlegroups.com.
> For more options, visit https://groups.google.com/d/optout.
--
You received this message because you are subscribed to the Google Groups
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to racket-users+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
