When I developing my racket pacakge(simple-svg), I found I can't use 
include-section and defmodule together.

First, I split my scribble docs to separate files, and use include-section 
to include them.

Then I found cross reference not works.

I found when use scribble/manual to scribble package doc, it demand each 
section have a defmodule[package-name]!

include-section means you have multiple section in docs, so to let the 
cross reference work, you should add defmodule in each scribble file.

it means each section should have a defmodule.

This let cross reference work, but , it produces many annoying warnings, it 
said I use defmodule multiple times, yes, of course.

I tried, but don't find good ways to work this out.

So I change separate docs to a single scribble file, and move all defproc 
and codeblock to the subsections.

No more warnings and cross reference works.

But it make the docs looks so neat and loose the include-section power.

How to solve it? someone notice this?

-- 
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.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/racket-users/1d7d63ae-aacf-4de7-8a0e-418018216791%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to