GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TEXT::WORDDIFF::HTMLTWOLINES (3)

.ds Aq ’

Name

Text::WordDiff::HTMLTwoLines - XHTML formatting for Text::WordDiff with content on two lines

CONTENTS

Synopsis



    use Text::WordDiff;

    my $diff = word_diff file1.txt, file2.txt;  { STYLE => HTMLTwoLines };
    my $diff = word_diff \$string1,   \$string2,    { STYLE => HTMLTwoLines };
    my $diff = word_diff \*FH1,       \*FH2,        { STYLE => HTMLTwoLines };
    my $diff = word_diff \&reader1,   \&reader2,    { STYLE => HTMLTwoLines };
    my $diff = word_diff \@records1,  \@records2,   { STYLE => HTMLTwoLines };

    # May also mix input types:
    my $diff = word_diff \@records1,  file_B.txt, { STYLE => HTMLTwoLines };



Description

This class subclasses Text::WordDiff::Base to provide a XHTML formatting for Text::WordDiff. See Term::WordDiff for usage details. This class should never be used directly.

Text::WordDiff::HTMLTwoLines formats word diffs for viewing in a Web browser. The output is similar to that produced by Term::WordDiff::HTML but the two lines (or files, records, etc.) are shown separately, with deleted items highlighted in the first line and inserted items highlighted in the second. HTMLTwoLines puts a span tag around each word or set of words in the diff.

The diff content is highlighted as follows:
o <div class="file">

The inputs to word_diff() are each contained in a div element of class file. All the following results are subsumed by these elements.
o <span class="fileheader">

The header section for the files being diffed, usually something like:



  --- in.txt    Thu Sep  1 12:51:03 2005



for the first file, and



  +++ out.txt   Thu Sep  1 12:52:12 2005



for the second.

This element immediately follows the opening file <div> element, but will not be present if Text::WordDiff cannot determine the file names for both files being compared.

o <span class="hunk">

This element contains a single diff hunk. Each hunk may contain the following elements:
o <ins>

Inserted content.

o <del>

Deleted content.

You may do whatever you like with these elements and classes; I highly recommend that you style them using CSS. You’ll find an example CSS file in the eg directory in the Text-WordDiff distribution.

See Also

Text::WordDiff
Text::WordDiff::ANSIColor
Text::WordDiff::ANSIColor

Author

Amelia Ireland <join(., $firstname, $lastname) . @gmail.com>

Copyright and License

Copyright (c) 2011 Amelia Ireland. Some Rights Reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 TEXT::WORDDIFF::HTMLTWOLINES (3) 2016-04-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.