<p>I&#39;ve never gotten into anything but trivial syntax operations. I&#39;d be happy to dig further if anyone can get me started on stepping though expansions of included files. Sounds like a good learning opportunity.<br>

</p>
<div class="gmail_quote">On Apr 22, 2012 3:34 PM, &quot;Matthias Felleisen&quot; &lt;<a href="mailto:matthias@ccs.neu.edu">matthias@ccs.neu.edu</a>&gt; wrote:<br type="attribution"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
I haven&#39;t used /lp myself. I am stuck here -- Matthias<br>
<br>
<br>
<br>
On Apr 22, 2012, at 12:25 AM, Deren Dohoda wrote:<br>
<br>
&gt; Hi Matthias,<br>
&gt;<br>
&gt; I cannot seem to get it to work. I can get scribble to be happy, but<br>
&gt; not the scribble/lp file.<br>
&gt;<br>
&gt; First try: (somewhere in the middle of the file)<br>
&gt; @(begin<br>
&gt;   #reader scribble/comment-reader<br>
&gt;   (chunk &lt;hs-from-xs&gt;<br>
&gt;          (define hs ; (xi+1) - xi<br>
&gt;            (map - (rest xs) (drop-right xs 1)))))<br>
&gt; Second try:<br>
&gt; @chunk[&lt;hs-from-xs&gt;<br>
&gt;       #reader scribble/comment-reader<br>
&gt;       (define hs ; (xi+1) - xi<br>
&gt;         (map - (rest xs) (drop-right xs 1)))]<br>
&gt;<br>
&gt; Both can be scribbled with the comment when included with (lp-include<br>
&gt; ...), but doesn&#39;t run when one runs the file itself. When the file is<br>
&gt; run, this error appears: &quot;bad syntax (multiple expressions after<br>
&gt; identifier) in: (define hs (code:comment ...&quot; The only place I can<br>
&gt; find code:comment defined is in<br>
&gt; &quot;...Racket/collects/scribble/lp/lang/lang.rkt&quot;:<br>
&gt; (provide code:comment)<br>
&gt; (define-syntax (code:comment stx)<br>
&gt;  (if (eq? (syntax-local-context) &#39;expression)<br>
&gt;      (syntax (void))<br>
&gt;      (syntax (define (f x) x))))<br>
&gt;<br>
&gt; It looks like it was supposed to strip the comment when being run.<br>
&gt; &quot;...Racket/collects/scribble/comment-reader.rkt&quot; does have<br>
&gt;<br>
&gt; (define (do-comment port recur)<br>
&gt;    (let loop ()<br>
&gt;      (when (equal? #\; (peek-char port))<br>
&gt;        (read-char port)<br>
&gt;        (loop)))<br>
&gt;    (when (equal? #\space (peek-char port))<br>
&gt;      (read-char port))<br>
&gt;    `(code:comment<br>
&gt;      (unsyntax ...<br>
&gt;<br>
&gt; So it seems like this is where code:comment is coming from, but for<br>
&gt; some reason the code:comments rule from lang.rkt isn&#39;t seeing it.<br>
&gt;<br>
&gt; Deren<br>
&gt;<br>
&gt; On Sat, Apr 21, 2012 at 9:07 PM, Matthias Felleisen<br>
&gt; &lt;<a href="mailto:matthias@ccs.neu.edu">matthias@ccs.neu.edu</a>&gt; wrote:<br>
&gt;&gt;<br>
&gt;&gt; Do you use<br>
&gt;&gt;<br>
&gt;&gt; @;%<br>
&gt;&gt; @(begin<br>
&gt;&gt; #reader scribble/comment-reader<br>
&gt;&gt; (racketblock<br>
&gt;&gt; (place-image ROCKET X ... MTSCN)<br>
&gt;&gt; ))<br>
&gt;&gt; @;%<br>
&gt;&gt;<br>
&gt;&gt; to write down code blocks? It installs a reader that can cope with comments.<br>
&gt;&gt;<br>
&gt;&gt;<br>
&gt;&gt;<br>
&gt;&gt; On Apr 21, 2012, at 4:53 PM, Deren Dohoda wrote:<br>
&gt;&gt;<br>
&gt;&gt;&gt; I have finally started learning scribble for use in literate<br>
&gt;&gt;&gt; programming to break away from noweb for Racket. It&#39;s quite excellent,<br>
&gt;&gt;&gt; I am glad to be making the switch. Thank everyone for their work. I<br>
&gt;&gt;&gt; miss the math of latex but it isn&#39;t a dealbreaker.<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; However, part of writing code is commenting the code for reminders of<br>
&gt;&gt;&gt; why little bits are the way they are. The problem is that the scribble<br>
&gt;&gt;&gt; HTML output has stripped all comments from the chunks. I have tried<br>
&gt;&gt;&gt; digging down into scribble/lp but I must admit the guts are outside my<br>
&gt;&gt;&gt; ability to understand. I&#39;m guessing it is because the reader has<br>
&gt;&gt;&gt; already stripped comments from the syntax by the time Racket gets to<br>
&gt;&gt;&gt; the &quot;chunk&quot; syntax rule. The one bit that seems to indicate it strips<br>
&gt;&gt;&gt; comments (code:comment) never seems to be used anywhere. I know that<br>
&gt;&gt;&gt; there are code examples with comments in the Racket documentation. Is<br>
&gt;&gt;&gt; there any way to keep code comments preserved in the scribbled view of<br>
&gt;&gt;&gt; chunks?<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; Thanks,<br>
&gt;&gt;&gt; Deren<br>
&gt;&gt;&gt; ____________________<br>
&gt;&gt;&gt;  Racket Users list:<br>
&gt;&gt;&gt;  <a href="http://lists.racket-lang.org/users" target="_blank">http://lists.racket-lang.org/users</a><br>
&gt;&gt;<br>
<br>
</blockquote></div>