[racket-dev] docs not showing up on PLaneT for gzip.plt

From: Robby Findler (robby at eecs.northwestern.edu)
Date: Fri May 20 11:14:01 EDT 2011

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
<clements at brinckerhoff.org> 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
>



Posted on the dev mailing list.