#:use-sources is for the relatively rare case that (in the example below), db and bd/base both export identifiers from some some common, but undocumented place, like db/private/base (just making that up). It is an annotation that tells scribble that "even though db does not re-export db/base, please go ahead and document it like it does". Something like that. <div>
<br></div><div>Note that this is only appropriate if the exports *really* *are* the same identifier, but coming from some shared, undocumented place.</div><div><br></div><div>If the bindings are actually different, then they should be documented twice (perhaps abstracted over in some way, but ultimately with two defprocs or whatever).</div>
<div><br></div><div>(The easiest thing may be to make db re-export db/base, assuming it isn't already.)</div><div><br></div><div>Robby<br><div><br>On Monday, January 23, 2012, Neil Toronto wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
On 01/23/2012 01:36 PM, Ryan Culpepper wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
On 01/23/2012 01:31 PM, Neil Toronto wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
On 01/23/2012 01:18 PM, Neil Toronto wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
For some reason, when I require (for-label db/base), I still get<br>
warnings about `sql-timestamp?', `sql-time?' and `sql-date?', and red<br>
underlines under them.<br>
</blockquote>
<br>
Okay, I figured out what I need to do, but not why it works. I have to<br>
require JUST (for-label db), NOT (for-label db/base) NOR (for-label db<br>
db/base).<br>
<br>
That (for-label db/base) and (for-label db db/base) don't work makes no<br>
sense to me. Ryan's Scribble docs look fine. What's going on?<br>
</blockquote>
<br>
I suspect I should be using #:use-sources to tell Scribble that those<br>
bindings from db and db/base are the same.<br>
</blockquote>
<br>
I have a struct type exported by both `plot' and `plot/utils'. I should probably do the same.<br>
<br>
How would you do that, anyway? I've read and re-read the `defmodule' docs, but I still don't know how to use #:use-sources.<br>
<br>
Neil T<br>
_________________________<br>
Racket Developers list:<br>
<a href="http://lists.racket-lang.org/dev" target="_blank">http://lists.racket-lang.org/<u></u>dev</a><br>
</blockquote></div></div>