<div dir="ltr">There _is_ reason to think these modules are different, because they were different in Planet1.  I&#39;ve had to remind myself several times that Planet2 packages don&#39;t have special require forms, and that&#39;s just during discussions -- I haven&#39;t even been writing code with them yet.  Clarifying that Planet2 simplifies the require lines, and makes user packages on a peer level with built-in collections, is a useful thing to put early on in the Planet2 docs.<br>

</div><div class="gmail_extra"><br clear="all"><div>Carl Eastlund</div>
<br><br><div class="gmail_quote">On Wed, Jan 2, 2013 at 3:27 PM, Jay McCarthy <span dir="ltr">&lt;<a href="mailto:jay.mccarthy@gmail.com" target="_blank">jay.mccarthy@gmail.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

<div dir="ltr">The documentation already says &quot;A package is a set of modules for some number of collections.&quot; And there&#39;s no reason to think that these modules are different from other modules, so I don&#39;t see why we need to point out that they are required like all other modules are.<div>


<br></div><div>If you think it&#39;s very confusing, then feel free to push the commit with two small changes:</div><div><br></div><div>1. The docs don&#39;t use the term &quot;planet2&quot;, so just say &quot;the Racket package manager&quot;</div>


<div><br></div><div>2. Consider using the same examples from the rest of the docs (such as data/matrix from tic-tac-toe)</div><div><br></div><div>Jay</div><div><br></div></div><div class="gmail_extra"><div><div class="h5">


<br><br><div class="gmail_quote">On Wed, Jan 2, 2013 at 12:30 PM, John Clements <span dir="ltr">&lt;<a href="mailto:clements@brinckerhoff.org" target="_blank">clements@brinckerhoff.org</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">


As I was trying to assembly my first planet2 package, I found myself wondering how exactly to &#39;require&#39; modules associated with planet2 packages. My initial assumption (require them like any other collection containing modules) turned out to be correct, but there was a period when I doubted this, and I think it should be documented.<br>



<br>
Below is a proposed doc change; I&#39;ll commit it if you like it, or abandon it if not. I&#39;m including the (git format-patch) text and also attaching it as a file.<br>
<br>
John<br>
<br>
<br>
<br>
&gt;From d3f72c47820effb240532c518378dc9709d69600 Mon Sep 17 00:00:00 2001<br>
From: John Clements &lt;<a href="mailto:clements@racket-lang.org" target="_blank">clements@racket-lang.org</a>&gt;<br>
Date: Tue, 1 Jan 2013 10:40:40 -0800<br>
Subject: [PATCH] added docs on requiring planet2 modules<br>
<br>
---<br>
 collects/planet2/scribblings/planet2.scrbl |   14 ++++++++++++++<br>
 1 files changed, 14 insertions(+), 0 deletions(-)<br>
<br>
diff --git a/collects/planet2/scribblings/planet2.scrbl b/collects/planet2/scribblings/planet2.scrbl<br>
index e9e565a..81d6e58 100644<br>
--- a/collects/planet2/scribblings/planet2.scrbl<br>
+++ b/collects/planet2/scribblings/planet2.scrbl<br>
@@ -200,6 +200,20 @@ imply a change in the @tech{checksum}.<br>
<br>
 @section{Using Packages}<br>
<br>
+Modules installed using planet2 may be @tech{require}d like any other<br>
+modules. For instance, if the package @pkgname{recipes} contains<br>
+the module file  @filepath{vegan/fruitsalad.rkt}, then package users<br>
+who have this package installed may evaluate<br>
+<br>
+@racketblock[(require vegan/fruitsalad)]<br>
+<br>
+...to require this module.<br>
+<br>
+@; ----------------------------------------<br>
+<br>
+@section{Managing Packages}<br>
+<br>
+<br>
 The Racket package manager has two user interfaces: a command line @exec{raco}<br>
 sub-command and a library. They have the exact same capabilities, as<br>
 the command line interface invokes the library functions and<br>
<span><font color="#888888">--<br>
1.7.7.5 (Apple Git-26)<br>
<br>
<br>
</font></span></blockquote></div><br><br clear="all"><div><br></div></div></div><span class="HOEnZb"><font color="#888888">-- <br>Jay McCarthy &lt;<a href="mailto:jay@cs.byu.edu" target="_blank">jay@cs.byu.edu</a>&gt;<br>

Assistant Professor / Brigham Young University<br><a href="http://faculty.cs.byu.edu/~jay" target="_blank">http://faculty.cs.byu.edu/~jay</a><br>
<br>&quot;The glory of God is Intelligence&quot; - D&amp;C 93
</font></span></div>
<br>_________________________<br>
  Racket Developers list:<br>
  <a href="http://lists.racket-lang.org/dev" target="_blank">http://lists.racket-lang.org/dev</a><br>
<br></blockquote></div><br></div>