[racket] scribble/lp: comments stripped, how to stop?

This

> 91100:commit a1f9a6f1abc5dc278fbe43b25d9d7c547665f1c6
> 91101-Author: Matthias Felleisen <matthias at racket-lang.org>
> 91102-Date:   Tue May 19 22:23:17 2009 +0000
> 91103-
> 91104-    added hack to allow some comments in LP
> 91105-    

looks like Eli submitted something in my name :-) 
I just don't use the word 'hack' especially not like that. 

((My hunch is that Eli demoed it to me, I asked about it, and
we fixed it all in my tree. But this could be incorrect.))





On Apr 23, 2012, at 5:54 PM, Robby Findler wrote:

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