Examples

Sometimes things need to be illustrated by examples, which in PerlPoint are paragraphs starting with an indentation.

   So, for example:
  
     Business people could present statistical
     data in an example, emphasizing their point.
  
     Programmers like to show source code in
     examples.

The number of whitespaces used as a paragraph prefix is up to you. It does not matter for the example to be recognized.

All whitespace used within an example block is preserved, which means it will be reproduced in the result, including the original wrapping.

Examples are paragraphs as usual - they end with a line of whitespace. Nevertheless, as such lines might be part of the example text, PerlPoint automatically combines subsequent example paragraphs. As a result, in fact an example block is completed by the first subsequent non-example paragraph. All intermediate newlines will be made part of the generated example block.

In other words: everything between the start of an example block and the next non-example paragraph will become part of this example, including whitespace lines.

   A piece of code, including whitespace lines:
  
    # use an intermediate scope
    {
     # scopy
     my $value;
  
     # calculate
     $value=20*$start;
  
     # print result
     print "Result: $value.n";
    }
  
   Now we will analyze this code ...

But you want to separate subsequent examples? Ok, in this case, use the special "-" paragraph:

    The first example.
  
    With its second part.
  
   -
  
    The second examples
    first line.

Note: there's a second paragraph type for examples, in order to handle special cases. If you aren't a programmer, chances are that you will not need this second type.