Re: Block comment syntax

[Mike Gran]

On Tuesday, August 5, 2014 7:04 PM, David Michael <address@hidden> wrote:
>
>
>Hi,
>
>The block comment documentation[1] claims that the closing "!#" must
>appear on its own line, but this doesn't actually seem to be the
>case[2].  For example, the line "(display #! comment !# 1)"
>successfully outputs "1".
>
>Can anyone clarify whether the documentation needs to be updated, or
>if the currently acceptable syntax is unintentional and should be
>avoided?


The documentation needs to be clarified.  The return used to
be required
back in Guile v1.6.x but now !# will terminate any block comment without
a carriage return or line feed.

If you're using #! block comments for containing shell script headers
lines like "#!/bin/sh" or "#!/usr/bin/guile" 
it is a good idea to have the terminating !# on its own line, like the
docs suggest, though. 

Best practice here is probably to use "#!" block comments only for
containing shell script headers, and use the #| syntax otherwise.

-Mike Gran