Re: Block comment syntax

[David Michael]

On Wed, Aug 6, 2014 at 2:19 PM, Mike Gran <address@hidden> wrote:
>
> 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

Thanks for the responses; I've restructured my script according to
these suggestions.

David