<div dir="ltr">Thanks, <br>I didn't realise that planet link items took precedence!<br><br><div class="gmail_quote">On Wed, Sep 17, 2008 at 4:35 PM, Carl Eastlund <span dir="ltr"><<a href="mailto:cce@ccs.neu.edu">cce@ccs.neu.edu</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><div class="Ih2E3d">> ; when ready to release; (use sake to automate this? )<br>
> planet unlink [dev-id] foo.plt 1 4 ;; remove the link<br>
> planet create foo ;; create foo.plt file for test installation [Will - is<br>
> there a reason to compile a temporary copy?]<br>
> planet fileinject [dev-id] foo.plt 1 4 ;; install for testing<br>
<br>
</div>You do not want to unlink the package at this point. If you take<br>
Will's (good) advice and test/build from a temporary copy, in fact,<br>
make sure to unlink the original and link the copy. </blockquote><div>I thought that link-ing or fileinject the copy were functionally equivalent? - provided you remembered to unlink the original - so linking is probably safer?<br>
<br></div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">When you run<br>
planet create, Planet attempts to build your Scribble documentation so<br>
it can include a rendered HTML file that will be readable on the<br>
Planet server. If you unlink your package, any internal references to<br>
(planet <dev-id>/foo:1:4/...) will be broken and planet create may<br>
fail.<br>
</blockquote><div>I don't understand - I thought the [planet]create-ed/fileinject-ed copy would have the documentation included?<br> <br></div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Leave your development links intact and functioning while using planet create.<br></blockquote><div>(because create builds the documentation?)<br><br>I think I'm missing something in my understanding of building scribble documentation. <br>
</div></div>Does scribble documentation need to be built in-place (via planet link) to work? [if it references other documentation?]<br><br>Thanks again [to all of you] for taking the time to help me with this.<br><br>Cheers<br>
<br>Stephen<br><br></div>