[wikka-community] line breaks mid 'markup'

Dave Pawson dave.pawson
Thu Sep 10 08:43:29 GMT 2009

Hi Dario

2009/9/10 Dario Taraborelli <dartar at wikkawiki.org>:
> Hi Dave,
> Timothy is right - support for different kinds of whitespace as a separator
> in forced links was tacitly introduced in the formatter to capture potential
> exceptions.

Whats an exception then? Something contradicting the documentation?
E.g. a newline within a link?

> However, our official documentation (FormattingRules) is that users should
> only use the space character. I might be wrong, but I am not aware of any
> user systematically using these loose constraints on separators in forced
> links as a rule and we would definitely discourage their use.

That's what I found, newline within a link, 'I found it worked   so I left it'
was the rationale I was given.

 In the case of
> tables: line breaks within cells are not supported as new lines are used as
> row separators. This doesn't prevent users from using the --- markup to
> generate new lines inside cells.

But it does contradict the newlines within links regex? If they are allowed
in one place, why not in another would be the logic I guess.

> In the next release (using trunk as a codebase, after merging back
> 1.2-specific changes), the regular expressions used by the formatter will be
> stored in a library to simplify their maintenance and documentation. This
> should facilitate expressing formatting rules in other ways (hopefully
> including BNF).

Summary:  \n is allowed in a link, but nowhere else within an inline?

AFAIK that makes it the one exception?
Everything else about the syntax is line based.
  Or are there more exceptions?


Dave Pawson
Docbook FAQ.

More information about the community mailing list