This was a bug in the planet commandline's packaging code. When the documentation was named something like doc.scrbl (doc*.scrbl, really) then the packager was dropping it from the .plt file that it built. So if you re-build using the currently pushed planet tool, you should be in good shape (you can double check by unpacking the .plt file and seeing if you see the docs in there).
I've pushed a fix for the bug. This is the list of packages currently on planet that I believe were affected by the bug (some multiple versions, some not). vegashacker/leftparen.plt sbloch/picturing-programs.plt soegaard/gzip.plt soegaard/galore.plt clements/gzip.plt synx/pointer-address.plt synx/xml-writer.plt synx/xml-maker.plt synx/microdate.plt synx/libpq.plt synx/libpq.plt synx/sizeof.plt wmfarr/srfi-4-comprehensions.plt Thanks for uncovering the bug. Robby On Thu, May 19, 2011 at 2:54 PM, John Clements <[email protected]> wrote: > I just persuaded Jens Axel Soegaard to submit a new gzip library on my > behalf; unfortunately, it shows up in PLaneT as having Docs: [none]: > > http://planet.racket-lang.org/display.ss?package=gzip.plt&owner=soegaard > > ...despite this info.rkt file: > > #lang setup/infotab > > (define name "gzip") > (define blurb > (list "Provides gzip compression and decompression via zlib.")) > (define primary-file "main.rkt") > (define scribblings '(("doc.scrbl"))) > (define categories '(datastructures)) > (define version "2.0") > (define required-core-version "4.0") > (define release-notes '("updated required-version-number, scribble-ized and > racket-ized")) > > My current guess is that it could have something to do with the missing > 'repositories field or the existence of an old "doc.txt" file or perhaps to > the (spurious?) "planet-docs" directory that exists in the source, but I > can't really test this hypothesis without bugging Jens to submit package > after package. Is there some way to test locally whether a PlaneT .plt file > will show up as having documentation on the planet web page? I suppose I > could create my own planet package and then ask you to delete it for me.... > > > > FWIW, injecting the file locally does successfully build documentation: > > pcp070679pcs:/tmp clements$ raco planet fileinject soegaard gzip.plt 2 5 > > ============= Installing gzip.plt on Thu, 19 May 2011 12:47:43 ============= > raco setup: Unpacking archive from /private/tmp/gzip.plt > raco setup: unpacking doc.scrbl in > /Users/clements/Library/Racket/planet/300/5.1.1.5/cache/soegaard/gzip.plt/2/5/./ > raco setup: unpacking doc.txt in > /Users/clements/Library/Racket/planet/300/5.1.1.5/cache/soegaard/gzip.plt/2/5/./ > raco setup: unpacking info.rkt in > /Users/clements/Library/Racket/planet/300/5.1.1.5/cache/soegaard/gzip.plt/2/5/./ > raco setup: unpacking main.rkt in > /Users/clements/Library/Racket/planet/300/5.1.1.5/cache/soegaard/gzip.plt/2/5/./ > raco setup: making directory planet-docs in > /Users/clements/Library/Racket/planet/300/5.1.1.5/cache/soegaard/gzip.plt/2/5/./ > raco setup: unpacking scribble-common.js in > /Users/clements/Library/Racket/planet/300/5.1.1.5/cache/soegaard/gzip.plt/2/5/./ > raco setup: unpacking zlib1.dll in > /Users/clements/Library/Racket/planet/300/5.1.1.5/cache/soegaard/gzip.plt/2/5/./ > raco setup: version: 5.1.1.5 [3m] > raco setup: variants: 3m > raco setup: main collects: /Users/clements/plt/collects > raco setup: collects paths: > raco setup: /Users/clements/git-clements/clements/collects > raco setup: /Users/clements/clements/matthias/collects > raco setup: /Users/clements/Library/Racket/5.1.1.5/collects > raco setup: /Users/clements/plt/collects > raco setup: --- pre-installing collections --- > raco setup: --- compiling collections --- > raco setup: making: <planet>/soegaard/gzip.plt/2/5 (gzip) > raco setup: in <planet>/soegaard/gzip.plt/2/5 > raco setup: making: <planet>/soegaard/gzip.plt/2/5/planet-docs > raco setup: --- updating info-domain tables --- > raco setup: updating: > /Users/clements/Library/Racket/planet/300/5.1.1.5/cache.rktd > raco setup: --- creating launchers --- > raco setup: --- building documentation --- > raco setup: skipping: <planet>/clements/sxml2.plt/1/1/scribblings/sxml.scrbl > raco setup: skipping: <planet>/cce/scheme.plt/4/1/scribblings/main.scrbl > raco setup: skipping: > <planet>/williams/science.plt/3/10/scribblings/science.scrbl > raco setup: running: <planet>/soegaard/gzip.plt/2/5/doc.scrbl > raco setup: rendering: <planet>/soegaard/gzip.plt/2/5/doc.scrbl > raco setup: --- installing collections --- > raco setup: --- post-installing collections --- > ------------- Rebuilding documentation index ------------- > raco setup: version: 5.1.1.5 [3m] > raco setup: variants: 3m > raco setup: main collects: /Users/clements/plt/collects > raco setup: collects paths: > raco setup: /Users/clements/git-clements/clements/collects > raco setup: /Users/clements/clements/matthias/collects > raco setup: /Users/clements/Library/Racket/5.1.1.5/collects > raco setup: /Users/clements/plt/collects > raco setup: --- pre-installing collections --- > raco setup: --- compiling collections --- > raco setup: making: scribblings/main/user > raco setup: --- updating info-domain tables --- > raco setup: --- creating launchers --- > raco setup: --- building documentation --- > raco setup: skipping: <planet>/clements/sxml2.plt/1/1/scribblings/sxml.scrbl > raco setup: skipping: <planet>/cce/scheme.plt/4/1/scribblings/main.scrbl > raco setup: skipping: > <planet>/williams/science.plt/3/10/scribblings/science.scrbl > raco setup: rendering: scribblings/main/user/start.scrbl > raco setup: rendering: scribblings/main/user/search.scrbl > raco setup: re-rendering: scribblings/main/user/start.scrbl > raco setup: --- installing collections --- > raco setup: --- post-installing collections --- > #<pkg> > pcp070679pcs:/tmp clements$ raco doc gzip > > ... succeeds, though I can't paste that part... > > > Thanks for any help, > > John > > > > _________________________________________________ > For list-related administrative tasks: > http://lists.racket-lang.org/listinfo/dev > _________________________________________________ For list-related administrative tasks: http://lists.racket-lang.org/listinfo/dev
