[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

5.3 Soft vs. Hard Newlines

Some Bunao modules (STD:Print, STD:Write, LM:BlockItem, LM:BlockArray) have a text box widget, which allows entry of multiple lines of text. Entering a newline character (carriage return) in these boxes will break the line in the text box. This makes it easy to split long lines wherever it is convenient.

A newline that is entered by pressing return in a text box is called a soft newline. Functionally, it is invisible everywhere except in the text box. If the Show Soft Newlines option is on (see section Options Menu), then the soft newline will also appear as line breaks in the Tree. In either case, however, soft newlines are not seen by the functional part of the Bunao module. Soft newlines can appear anywhere in a Bunao text box, whether they are within a quoted string or an expression.

To enter a hard newline, which will be visible to the running program, enter the sequence `\n' in a quoted string. Note that entering a hard newline will never break the line in the text box or in the tree display. Hard newlines must be embedded in quoted strings, or Bunao will attempt to treat them as expressions.

The sequence to enter a hard newline is under user control. The default sequence is `\n'. For compatibility with the old Listmaker program, the hard newline marker can be set to `~~' by adding the following line to the `~/.bunao' file:

bunao.config.nlchar: ~~

For more details on the `.bunao' file, see The `.bunao' File.



This document was generated on October, 28 2005 using texi2html