Editing API:EPrints/DataObj/History (section)

===Utility Methods===
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->


<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=item_empty_tree -->
====empty_tree====

 $boolean = EPrints::DataObj::History::empty_tree( $domtree )
Returns <tt>true</tt> if there is no text in the XHTML <tt>$domtree</tt> other  than whitespace. Otherwise, returns <tt>false</tt>.

This method is liable to being moveded to [[API:EPrints/XML|EPrints::XML]]&gt; or  [[API:EPrints/Utils|EPrints::Utils]].

<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->


<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=item_render_xml_diffs -->
====render_xml_diffs====

 ( $f1, $f2 ) = EPrints::DataObj::History::render_xml_diffs( $tree1, $tree2, $indent, $width )
Returns two XHTML DOM trees.  The first for the older version, highlighting lines that are changed or removed and the second for  the newer version, highlighting libes that are changed or added.

<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->


<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=item_render_domtree -->
====render_domtree====

 ($xhtml, [$xhtml_padding]) = EPrints::DataObj::History::render_domtree( $session, $tree, $indent, $make_padded, $width )
Returns a rendering of the given tree as XHTML (showing the actual XML  structure).

If <tt>$make_padded</tt> is <tt>true</tt> then also generate another element,  which is empty but the same height to be used in the other column to  keep things level.

<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->


<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=item_diff -->
====diff====

 $boolean = EPrints::DataObj::History::diff( $tree1, $tree2 )
Returns <tt>true</tt> if the XML trees <tt>$tree1</tt> and <tt>$tree2</tt> are not the  same, otherwise returns <tt>false</tt>.

<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->


<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=item_mktext -->
====mktext====

 @lines = EPrints::DataObj::History::mktext( $session, $text, $offset, $endw, $width )
Returns the <tt>$text</tt> string broken into an array of lines which are <tt>$width</tt> long or less.

Inserts a 90 degree arrow at the end of each broken line to indicate that it has been broken.

<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->


<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=item_mkpad -->
====mkpad====

 $xhtml = EPrints::DataObj::History::mkpad( $session, $text, $offset, $endw, $width )
Return XHTML DOM of vertical padding equivalent to the lines that would  be needed to render <tt>$text</tt>.

<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->


<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=head_see_also -->