\BQuestion:

I used tags in an example and now it's difficult to find the correct line indentation. The result looks like

%hash=(
             key1 => value1,
         key2 => value2,
           );

when it should be

%hash=(
       key1 => value1,
       key2 => value2,
      );

\BAnswer:

Write down the complete example first as pure text and relatively indent the lines as necessary. Add the wished tags in a second step.

\BDiscussion:

This is a common problem with markup languages and not special to PerlPoint. Tags consume space. While this is no problem in a text dynamically wrapped, it is sometimes an issue in example authoring: sometimes its difficult to \see how the resulting lines of an example will be indented:

<<EOE

\PREFIX<%>\BOLD<hash>=\ITALIC<(>
        \BOLD<\YELLOW<key1>> => \GREEN<value1>,
        \BLACK<\ITALIC<key2>> => value2,
     \ITALIC<)>;

EOE

In order to simplify the task of indenting lines correctly, the "pure" example can be indented as necessary first

%hash=(
       key1 => value1,
       key2 => value2,
      );

and then you can add the tags you wish without modifying original indention and spaces.

<<EOE

\PREFIX<%>\BOLD<hash>=\ITALIC<(>
       \BOLD<\YELLOW<key1>> => \GREEN<value1>,
       \BLACK<\ITALIC<key2>> => value2,
      \ITALIC<)>;

EOE

4 POD Errors

The following errors were encountered while parsing the POD:

Around line 2:

Unknown directive: =Line

Around line 4:

Deleting unknown formatting code U<>

Around line 23:

Deleting unknown formatting code U<>

Around line 29:

Deleting unknown formatting code U<>