suzanne.soy/racket
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Changing the convention of referring to PLT in Planet 2 docs

Browse Source
This commit is contained in:
Jay McCarthy 2012-11-08 13:19:09 -07:00
parent 1df7f6b2e4
commit 1d3aa61c2a
1 changed files with 24 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
collects/planet2/scribblings/planet2.scrbl
View File

@ -85,12 +85,12 @@ with a @racket[read]-able hash table with the keys: @racket['source]
bound to the source and @racket['checksum] bound to the bound to the source and @racket['checksum] bound to the
checksum. Typically, the source will be a remote URL string. checksum. Typically, the source will be a remote URL string.
PLT supports two @tech{package name services}, which are enabled by The Racket maintainers supports two @tech{package name services},
default: @filepath{https://plt-etc.byu.edu:9004} for new Planet 2 which are enabled by default: @filepath{https://plt-etc.byu.edu:9004}
packages and @filepath{https://plt-etc.byu.edu:9003} for for new Planet 2 packages and @filepath{https://plt-etc.byu.edu:9003}
automatically generated Planet 2 packages for old Planet 1 for automatically generated Planet 2 packages for old Planet 1
packages. Anyone may host their own @tech{package name service}. The packages. Anyone may host their own @tech{package name service}. The
source for the PLT-hosted servers is in the source for the Racket-hosted servers is in the
@racket[(build-path (find-collects-dir) "meta" "planet2-index")] @racket[(build-path (find-collects-dir) "meta" "planet2-index")]
directory. directory.
@ -383,13 +383,14 @@ sub-collections for tests, typed interfaces, documentation, etc.}
@item{Packages are not allowed to start with @pkgname{plt}, @item{Packages are not allowed to start with @pkgname{plt},
@pkgname{racket}, or @pkgname{planet} without special approval from @pkgname{racket}, or @pkgname{planet} without special approval from
PLT curation.} Planet 2 curation.}
] ]
@section{Planet 1 Compatibility} @section{Planet 1 Compatibility}
PLT maintains a Planet 1 compatibility @tech{package name service} at The Racket maintainers run a Planet 1 compatibility @tech{package name
service} at
@link["https://plt-etc.byu.edu:9003/"]{https://plt-etc.byu.edu:9003/}. This @link["https://plt-etc.byu.edu:9003/"]{https://plt-etc.byu.edu:9003/}. This
PNS is included by default in the Planet search path. PNS is included by default in the Planet search path.
@ -563,7 +564,7 @@ responsive about fixing regressions against changes in Racket, etc.}
] ]
This categories will be curated by PLT. This categories will be curated by the Racket maintainers.
Our goal is for all packages to be in the @reponame{solar-system}, with Our goal is for all packages to be in the @reponame{solar-system}, with
the @reponame{galaxy} as a temporary place while the curators work with the the @reponame{galaxy} as a temporary place while the curators work with the
@ -582,12 +583,12 @@ the case that older packages have preference. (For example,
package used by both @pkgname{tic-tac-toe} and package used by both @pkgname{tic-tac-toe} and
@pkgname{factory-optimize}.) @pkgname{factory-optimize}.)
In contrast, the @reponame{planet} category will be a special category that In contrast, the @reponame{planet} category will be a special category
authors may apply for. Admission requires a code audit and implies that authors may apply for. Admission requires a code audit and
a "stamp of approval" from PLT. In the future, packages in this implies a "stamp of approval" from the Racket maintainers. In the
category will have more benefits, such as automatic regression testing future, packages in this category will have more benefits, such as
on DrDr, testing during releases, provided binaries, and advertisement automatic regression testing on DrDr, testing during releases,
during installation. provided binaries, and advertisement during installation.
The Planet 1 compatibility packages will also be included in The Planet 1 compatibility packages will also be included in
the @reponame{solar-system} category, automatically. the @reponame{solar-system} category, automatically.
@ -658,16 +659,16 @@ these included are painful to maintain and unreliable given users with
different versions of Racket installed. different versions of Racket installed.
One solution is to have a separate place where such "binary" packages One solution is to have a separate place where such "binary" packages
are available. For example, PLT could run a PNS for every Racket are available. For example, the Racket maintainers could run a PNS for
version, i.e., @filepath{https://binaries.racket-lang.org/5.3.1.4}, every Racket version, i.e.,
that would contain the binaries for all the packages in the @filepath{https://binaries.racket-lang.org/5.3.1.4}, that would
@reponame{planet} category. Thus, when you install package contain the binaries for all the packages in the @reponame{planet}
@pkgname{tic-tac-toe} you could also install the binary version from category. Thus, when you install package @pkgname{tic-tac-toe} you
the appropriate PNS. could also install the binary version from the appropriate PNS.
There are obvious problems with this... it could be expensive for PLT There are obvious problems with this... it could be expensive for the
in terms of space and time... Racket compilation is not necessarily Racket maintainers in terms of space and time... Racket compilation is
deterministic or platform-independent. not necessarily deterministic or platform-independent.
This problem requires more thought.} This problem requires more thought.}