[plt-scheme] planet create needs compilation info
Is this a symptom of the recent problem Matthew pointed out on the
plt-dev mailing list (ie, planet is using some temporary island to
build the package locally)?
Robby
On Wed, Mar 11, 2009 at 1:03 PM, Dave Herman <dherman at ccs.neu.edu> wrote:
> Is part of the required workflow of PLaneT development that you should
> always compile before running `planet create'? I've included an example
> where you get different Scribble results depending on whether you've
> compiled.
>
> Small-ish example at the bottom of this message; here's how to reproduce:
> First create the development link:
>
> $ cd fnord
> $ planet link dherman fnord.plt 1 0 "`pwd`"
>
> These two sequences produce different results:
>
> # gets the links right
> $ setup-plt -P dherman fnord.plt 1 0
> $ cd ..
> $ planet create fnord
>
> # has missing links
> $ cd fnord
> $ rm -rf compiled doc
> $ cd ..
> $ planet create fnord
>
> I guess Scribble is relying on dependencies computed by the compiler and
> saved in the `compiled' directory. Since `planet create' is relying on this
> information to build the Scribble docs correctly, should it just
> automatically force a compilation first? Or is there some other way it can
> compute these dependencies without compiling?
>
> Dave
>
> ;; file: main.ss
> #lang scheme/base
> (require "stuff.ss")
> (provide (all-from-out "stuff.ss"))
>
> ;; file: stuff.ss
> #lang scheme/base
> (define-values (mumble grunch) (values 'mumble 'grunch))
> (provide mumble grunch)
>
> ;; file: info.ss
> #lang setup/infotab
> (define scribblings '(("fnord.scrbl")))
>
> ;; file: fnord.scrbl
> #lang scribble/doc
>
> @require[scribble/manual
> (for-label (planet dherman/fnord:1:0/main))]
>
> @section[#:tag "intro"]{Fnord}
>
> @defmodule[(planet dherman/fnord:1:0/main)]
>
> I'm mentioning @scheme[mumble] and @scheme[grunch].
>
> @section[#:tag "stuff"]{Mumble, Grunch}
>
> @defmodule[(planet dherman/fnord:1:0/stuff)]
>
> @defthing[mumble symbol?]{Fnord fnord fnord.}
> @defthing[grunch symbol?]{Fnord fnord fnord.}
>
> _________________________________________________
> For list-related administrative tasks:
> http://list.cs.brown.edu/mailman/listinfo/plt-scheme
>