Mike Doherty > App-perlhl-0.005 > perlhl

Download:
App-perlhl-0.005.tar.gz

Annotate this POD

Website

View/Report Bugs
Source   Latest Release: App-perlhl-0.007

NAME ^

perlhl - command-line syntax highlighter for Perl source code

VERSION ^

version 0.005

SYNOPSIS ^

    perlhl < bin/perlhl | less -R
    perlhl bin/perlhl lib/App/perlhl.pm

DESCRIPTION ^

perlhl is a command line syntax highlighter for Perl code.

OPTIONS ^

--help, -h, -?

Opens this man page and exits.

--version

Prints the version of this program and supporting libraries.

--html

Output HMTL fragment instead of ANSI terminal escapes.

USE ^

Provide input on stdin to perlhl to highlight it to stdout with ANSI colour escapes.

    perlhl < script.pl

It is not recommended to provide multiple files on stdout, since they'll be concatenated. This makes it impossible to know where one ends and the next begins, and will yield inferior syntax highlighting results. To highlight multiple files, provide filenames on the command line:

    perlhl lib/My/Module.pm lib/My/Module/Again.pm

Provide the --html option to output an HTML fragment. In the future, this option might print a whole valid document.

SEE ALSO ^

There is a one-liner that can do something comparable:

    perl -MText::Highlight -E 'my $h = Text::Highlight->new(ansi => 1);
    > my $text = do { local $/; open my $fh, "<", $ARGV[0]; <$fh> };
    > say $h->highlight("Perl", $text);
    > ' bin/perlhl

AVAILABILITY ^

The project homepage is http://p3rl.org/App::perlhl.

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit http://www.perl.com/CPAN/ to find a CPAN site near you, or see https://metacpan.org/module/App::perlhl/.

SOURCE ^

The development version is on github at http://github.com/doherty/App-perlhl and may be cloned from git://github.com/doherty/App-perlhl.git

BUGS AND LIMITATIONS ^

You can make new bug reports, and view existing ones, through the web interface at https://github.com/doherty/App-perlhl/issues.

AUTHOR ^

Mike Doherty <doherty@cpan.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2011 by Mike Doherty.

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

syntax highlighting: