making indentation marker &| implicit Per Bothner (28 May 2013 01:09 UTC)
Re: making indentation marker &| implicit Alex Shinn (28 May 2013 02:03 UTC)
Re: making indentation marker &| implicit Per Bothner (28 May 2013 07:19 UTC)
Re: making indentation marker &| implicit Alex Shinn (28 May 2013 08:41 UTC)
Re: making indentation marker &| implicit Per Bothner (01 Jun 2013 23:25 UTC)

Re: making indentation marker &| implicit Per Bothner 01 Jun 2013 23:25 UTC

Any preferences concerning explicit indentation marker:

&code{
     &|if (foo)
     &|    bar();
}

or Scribble-style implicit ("automagic") indentation:

&code{
     if (foo)
         bar();
}

"Automagic" indentation is of course is nicer-looking,
less distracting to read, and (possible) easier to write.

However, I see some downsides:

* More complicated rules with possibly-unexpected behavior.

* Slightly harder to have initial indentation for every line.
A work-around is to use a comment or continuation-marker.
For example:

&code{
     &-
       if (foo)
           bar();
}

This is more natural with explicit indentation:

&code{
     &|  if (foo)
     &|      bar();
}

* For text-oriented applications (e.g. paragraphs) indentation
is ignored (so automagic indentation doesn't get us anything),
while for literal text having the explicit markers might be
preferable anyway.

* Likewise, for a string literal (SRFI-109) explicit indentation
seems more "expected".

Comments or counter-example welcome - especially from people
experienced using Scribble.

I'm leaning towards explicit indentation using &| - i.e.
the current status of the specifications.
--
	--Per Bothner
xxxxxx@bothner.com   http://per.bothner.com/