Next: Tree Elements and Document Structure, Previous: Conversion to Plain Text, Up: Converting Texinfo Trees   [Contents][Index]

10.4.4 Texinfo Tree Elements in User Defined Functions ¶

Many user defined functions used for formatting have Texinfo tree elements as arguments. The user defined code should never modify the tree elements. It is possible to reuse Texinfo tree elements information, but with a copy. For example, the following is correct:

my @contents = @{$element->{'contents'}};
push @contents, {'text' => ' my added text'};
my $result = $converter->convert_tree({'cmdname' => 'strong',
                                  'contents' => \@contents });

The following is incorrect:

push @{$element->{'contents'}}, {'text' => ' my added text'};