On Tuesday, August 5, 2014 7:04 PM, David Michael <fedora....@gmail.com> 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
