Here's a workflow that is working well for me, now that things have settled.
In a Racket window, I have my package foo's scribble source file open:
/Users/username/github/foo/scribblings/foo.scrbl
I have the Package Manager open, and I keep it open, with the checkbox
checked "Updates can repla
Jack, following your advice, I did need one additional change.
Previously I had:
@(define my-eval (make-base-eval))
@example-eval[#:eval my-eval (require foo)]
Using scribble/example instead of scribble/eval, this additional change
made things work:
@(define my-eval (make-base-eval `(req
Jack, thanks, what you write makes a whole lot more sense and fits with
what I remember of scribble from the last time I scribbled, which was years
ago. I am delighted to find that scribble has many more interesting
features these days. My answers below:
On Friday, September 29, 2017 at 6:56:
A few other notes / tips:
- The `scribble/example` library is meant to replace the legacy
`scribble/eval` library, as the `examples` form provided by
`scribble/example` will make documentation building fail if example code
throws an unexpected error.
- Did you add a `scribblings` field to your
On Thursday, September 28, 2017 at 3:04:46 PM UTC-4, Ben Greenman wrote:
>
> Try adding `#:eval foo-eval` to `interaction`. (I'm guessing that would
> work.)
>
To close the loop, Ben, yes this also did work. Thanks!
--
You received this message because you are subscribed to the Google Groups
Try adding `#:eval foo-eval` to `interaction`. (I'm guessing that would
work.)
I'm more sure this will work:
#lang scribble/manual
@(require scribble/example "../main.rkt")
...
@(define foo-eval (make-base-eval '(require "../main.rkt")))
@examples[#:eval foo-eval #:label #f
(magic)
I hope this is an easy question for someone. I started a new foo package:
raco pkg new foo
I put my functions in foo/main.rkt. I saw a foo/scribblings/ dir, so I
created a file foo/scribblings/foo.scribl. I've got a nice little doc file
in there, which I can preview using:
cd scribbling
7 matches
Mail list logo