[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: making indentation marker &| implicit



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
per@xxxxxxxxxxx   http://per.bothner.com/