<div dir="ltr">To partially answer my own e-mail:<br><br>For the multiple defmodules, I removed all by one of the defmodules for shared and replaced the last ones with @scheme[(require (planet williams/main/section/shared))].&nbsp; This eliminated the warnings and pretty much looks the same in the documentation.&nbsp; [The require line isn&#39;toutlined in a pastel pinkish box, but I don&#39;t think anyone will notice.]<br>
<br>There is one warning/message that I get now when I initially download and install the collection.&nbsp; It says it is removing the .zo for the GFDL.scrbl file.&nbsp; I&#39;m not sure why that one file is different than any of the other @include-sections.&nbsp; It has no code references to it since it is just text is all.<br>
<br>I have released the package update to PLaneT with the new documentation.<br><br>Doug<br><br><div class="gmail_quote">On Sun, Sep 21, 2008 at 11:58 AM, Doug Williams <span dir="ltr">&lt;<a href="mailto:m.douglas.williams@gmail.com">m.douglas.williams@gmail.com</a>&gt;</span> wrote:<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><div dir="ltr">I finally have the science collection documentation converted to Scribble, but have some warnings I&#39;d like to get rid of.<br>
<br>The problem is that I am using sub-collections and have some interdependent sets of functionality (specifically, gamma, psi, and zeta functions) that are in a single module, but documented in separate sections.&nbsp; Let me give a simplified example.<br>

<br>main.scrbl<br>...<br>@include-section[&quot;section.scrbl&quot;]<br>...<br><br>section.scrbl<br>...<br>@defmodule[(planet williams/main/section)]<br>...<br>@section{Section One}<br>...<br>@defmodule[(planet williams/main/section/shared)]<br>

...<br>@section{Section Two}<br>
...<br>
@defmodule[(planet williams/main/section/shared)]<br>
...<br><br>Note that the first defmodule is for the entire sub-collection - it requires and provides all of the modules in the subcollection.&nbsp; But, the user can also just require the modules they are using, if they want - for example the shared module above.<br>

<br>I get a warning the it collected information multiple times on (mod-path &quot;(planet williams/main/section/shared)&quot;) and (index-entry (mod-path &quot;(planet williams/main/section/shared)&quot;)).&nbsp; Is there an alternative to the second defmodule that won&#39;t give the warning?&nbsp; [The warning is visible to the user when they first require the package from PLaneT and it is downloaded and built.]<br>

<br>I also get a warning that it collected information multiple times on &quot;(exporting-libraries #f)&quot;.&nbsp; Is that likely from the same problem or a different one (like a different defmodule problem elsewhere)?&nbsp; [There are a lot of defmodules in the documentation and I&#39;ve notice that I can mistype planet references and not get an error, so there might be one lingering somwhere.&nbsp; Warning don&#39;t give any source location information, so it can be hard to tell where they originate.]<br>

<br>---<br><br>Second question: I am including (require (for-label (planet ../science-with-graphics.ss&quot;)) in each of the scribble files, but I&#39;m not sure it it&#39;s necessary if I have the defmodules.&nbsp; I assume it is used to resolve references for hyperlinking, but do the defprocs, etc provide the same information?&nbsp; <br>

<br>And, I guess a related question:&nbsp; in my defmodules I am using the planet reference, but I used the relative reference in the for-label.&nbsp; It seems logical to me to do that since the defmodule renders into something the user sees - and they know about the planet collection, while the for-label is internal to the scribble files and not visible to the user.&nbsp; Does the planet deference in defmodule refer to the copy in the planet repository (on my machine) or to the source code being used to build it?&nbsp; That is, do I have to have already built a .plt and fileinjected it for the defmodule to work?<br>

<br>---<br><br>One last question:&nbsp; How can I include an appendix (or at least an unnumbered section-include?&nbsp; I have the GNU Free Documentation License I need to include with the documentation, but would rather it wasn&#39;t a numbered section.<br>

<br>---<br><br>And, some general comments and kudos.<br><br>I was pleasantly surprised that the @math{} functionality was as developed as it is.&nbsp; The documentation says that _ and ^ may be added in the future.&nbsp; Well, apparently I downloaded through a time warp, because they work - at least for many cases (and I could use @subscript and @superscript in the others).&nbsp; I assume it&#39;s still a work in progress, but I was able to render many of the mathematical equations directly.<br>

<br>One nice feature would be something like @equation{...} that takes a TeX equation and renders it to an image.&nbsp; That&#39;s probably a bit too deep into the Scribble code for me to attempt, but it would be a great feature if someone wanted to tackle it.&nbsp; [Doing that manually is how I did the more advanced equations - integrals, summations, etc - that @math couldn&#39;t handle.]<br>

<br>I&#39;m very happy with how the science documentation looks in scribble.<br><br>Thanks<br></div>
</blockquote></div><br></div>