On Sun, Nov 26, 2017 at 12:10 AM, Greg Hendershott
<greghendersh...@gmail.com> wrote:
> As another example of using scribble/srcdoc, for Frog I made a
> `define-doc` macro:
> https://github.com/greghendershott/frog/blob/master/frog/private/define-doc.rkt
> Example usage:
>   https://github.com/greghendershott/frog/blob/master/frog/paths.rkt#L258-L268
> Where that gets pulled into the main frog.scrbl is the
> `include-extracted` last line here:
> https://github.com/greghendershott/frog/blob/master/frog/frog.scrbl#L959-L975
> (In other words, there is still a main scribble file for "user guide"
> and module-wide documentation. Where scribble/srcdoc helps is with
> per-definition "reference" portions of the doc.)

Thanks, I appreciate the pointer.  Side benefit:  Frog looks really
useful and I may take a swing at using it.

Unfortunately, this is again something that mixes code and
documentation pretty incestuously and looks like code with some
strings sprinkled in.  The scribble file, of course, is very clear and
easy to follow but doesn't include the code and requires a specific

This is probably just my issue and I should suck it up and get used to
the way that the new thing does it instead of expecting it to work
like the old thing.  Thanks for the feedback, everyone.

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.

Reply via email to