On Wed, Aug 6, 2014 at 2:19 PM, Mike Gran <spk...@yahoo.com> wrote: > > 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
Thanks for the responses; I've restructured my script according to these suggestions. David
