I read all of the Scribble documentation early on and got rather confused at the time. [I&#39;m sure the documentation is much better now that when it was first rolled out.] I relied on trial and error to get things to work. Unfortunately, I got itemized lists working with braces and that&#39;s been my design pattern - unfortunately, my design pattern is wrong. I am curious why it broke though. My fear is that many of my packages no longer load.<br>
<br><div class="gmail_quote">On Sat, Apr 25, 2009 at 9:33 AM, Robby Findler <span dir="ltr">&lt;<a href="mailto:robby@eecs.northwestern.edu">robby@eecs.northwestern.edu</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;">
If you want to understand why they work and why they don&#39;t work, I<br>
recommend the section on @ in the scribble manual.<br>
<br>
Robby<br>
<br>
On Sat, Apr 25, 2009 at 10:33 AM, Doug Williams<br>
<div><div></div><div class="h5">&lt;<a href="mailto:m.douglas.williams@gmail.com">m.douglas.williams@gmail.com</a>&gt; wrote:<br>
&gt; Matthias pointed that out to me. Unfortunately, braces generally work, too.<br>
&gt; In fact, that exact one worked until recently.  I&#39;ll go back and recode them<br>
&gt; all at some point.<br>
&gt;<br>
&gt; On Sat, Apr 25, 2009 at 9:29 AM, Robby Findler &lt;<a href="mailto:robby@eecs.northwestern.edu">robby@eecs.northwestern.edu</a>&gt;<br>
&gt; wrote:<br>
&gt;&gt;<br>
&gt;&gt; You want square brackets in the itemize, not {} ones. Itemize expects<br>
&gt;&gt; item arguments only, but with the {} you get spaces and newlines and<br>
&gt;&gt; things like that as well.<br>
&gt;&gt;<br>
&gt;&gt; Robby<br>
&gt;&gt;<br>
&gt;&gt; On Sat, Apr 25, 2009 at 10:04 AM, Doug Williams<br>
&gt;&gt; &lt;<a href="mailto:m.douglas.williams@gmail.com">m.douglas.williams@gmail.com</a>&gt; wrote:<br>
&gt;&gt; &gt; I had the following in the Scribble documentation for the simulation<br>
&gt;&gt; &gt; collection.<br>
&gt;&gt; &gt;<br>
&gt;&gt; &gt; @defproc[(set-insert! (set set?) (item any/c) (priority real? 100))<br>
&gt;&gt; &gt; any]{<br>
&gt;&gt; &gt; Create a cell containing @scheme[item] and inserts it into @scheme[set]<br>
&gt;&gt; &gt; with<br>
&gt;&gt; &gt; the given @scheme[priority] according to the type of the set.<br>
&gt;&gt; &gt;<br>
&gt;&gt; &gt; @itemize{<br>
&gt;&gt; &gt;   @item{@scheme[#:fifo]---@scheme[item] is inserted at the end of<br>
&gt;&gt; &gt; @scheme[set].  The @scheme[priority], if provided, is ignored.}<br>
&gt;&gt; &gt;   @item{@scheme[#:lifo]---@scheme[item] is inserted at the beginning of<br>
&gt;&gt; &gt; @scheme[set].  The @scheme[priority], if provided, is ignored.}<br>
&gt;&gt; &gt;   @item{@scheme[#:priority]---@scheme[item] is inserted into<br>
&gt;&gt; &gt; @scheme[set]<br>
&gt;&gt; &gt; according to the @scheme[priority].  If @scheme[priority] is not<br>
&gt;&gt; &gt; provided,<br>
&gt;&gt; &gt; the default value of @math{100} is used.}<br>
&gt;&gt; &gt;   }}<br>
&gt;&gt; &gt;<br>
&gt;&gt; &gt; That worked fine at the time version 3.3 of the simulation collection<br>
&gt;&gt; &gt; was<br>
&gt;&gt; &gt; built. [That was Nov. 27, 2008 according to the SVN log, but I&#39;m not<br>
&gt;&gt; &gt; sure<br>
&gt;&gt; &gt; what version of PLT Scheme I had loaded at that time.] Now it gives a<br>
&gt;&gt; &gt; syntax<br>
&gt;&gt; &gt; error and points to the first item in the itemized list. Removing that<br>
&gt;&gt; &gt; one<br>
&gt;&gt; &gt; just moves the error the the second item.<br>
&gt;&gt; &gt;<br>
&gt;&gt; &gt; Moving the itemized list outside of the body of the defproc block<br>
&gt;&gt; &gt; removes<br>
&gt;&gt; &gt; the error. The closing brace (curly bracket) was moved from the end of<br>
&gt;&gt; &gt; the<br>
&gt;&gt; &gt; itemized list up before the itemized list.<br>
&gt;&gt; &gt;<br>
&gt;&gt; &gt; @defproc[(set-insert! (set set?) (item any/c) (priority real? 100))<br>
&gt;&gt; &gt; any]{<br>
&gt;&gt; &gt; Create a cell containing @scheme[item] and inserts it into @scheme[set]<br>
&gt;&gt; &gt; with<br>
&gt;&gt; &gt; the given @scheme[priority] according to the type of the set.}<br>
&gt;&gt; &gt;<br>
&gt;&gt; &gt; @itemize{<br>
&gt;&gt; &gt;   @item{@scheme[#:fifo]---@scheme[item] is inserted at the end of<br>
&gt;&gt; &gt; @scheme[set].  The @scheme[priority], if provided, is ignored.}<br>
&gt;&gt; &gt;   @item{@scheme[#:lifo]---@scheme[item] is inserted at the beginning of<br>
&gt;&gt; &gt; @scheme[set].  The @scheme[priority], if provided, is ignored.}<br>
&gt;&gt; &gt;   @item{@scheme[#:priority]---@scheme[item] is inserted into<br>
&gt;&gt; &gt; @scheme[set]<br>
&gt;&gt; &gt; according to the @scheme[priority].  If @scheme[priority] is not<br>
&gt;&gt; &gt; provided,<br>
&gt;&gt; &gt; the default value of @math{100} is used.}<br>
&gt;&gt; &gt;   }<br>
&gt;&gt; &gt;<br>
&gt;&gt; &gt; Does anyone know what the problem is?<br>
&gt;&gt; &gt;<br>
&gt;&gt; &gt; The real problem is that building the Scribble documents failed when the<br>
&gt;&gt; &gt; simulation collection was downloaded from PLaneT using PLT Scheme 4.1.5.<br>
&gt;&gt; &gt; I&#39;ve updated the PLaneT package so it loads now, but wonder if any other<br>
&gt;&gt; &gt; packages have a similar problem.<br>
&gt;&gt; &gt;<br>
&gt;&gt; &gt; Doug<br>
&gt;&gt; &gt;<br>
&gt;&gt; &gt; _________________________________________________<br>
&gt;&gt; &gt;  For list-related administrative tasks:<br>
&gt;&gt; &gt;  <a href="http://list.cs.brown.edu/mailman/listinfo/plt-scheme" target="_blank">http://list.cs.brown.edu/mailman/listinfo/plt-scheme</a><br>
&gt;&gt; &gt;<br>
&gt;&gt; &gt;<br>
&gt;<br>
&gt;<br>
</div></div></blockquote></div><br>