Skip to content


Subversion checkout URL

You can clone with
Download ZIP
tree: bfc515ed96
Fetching contributors…

Cannot retrieve contributors at this time

executable file 96 lines (60 sloc) 2.575 kB
#!/usr/bin/env perl
package grok;
use strict;
use warnings;
use App::Grok;
my $grok = App::Grok->new();
=encoding UTF-8
=head1 NAME
grok - Perl 6 documentation reader
B<grok> <options> <target>
-F FILE, --file=FILE A file to read Pod from
-h, --help Print this help message
-i, --index Print index of things grok knows about
-l, --locate Locate the target file
-o FORMAT, --output=FORMAT The output format, ansi/text/xhtml/pod
-T, --no-pager Send output to STDOUT without any pager
-U, --update Update all document resources from the web
-u, --unformatted Print unformatted Pod output
-V, --version Print version information
If you don't supply the -F or -i options, you need to supply a target.
The following targets are recognized:
* A Synopsis name ('s02', 's02-bits', 's32-rules')
* An Apocalypse name ('a01', 'a02', 'a03')
* An Exegesis name ('e01', 'e02', 'e03')
* An article name ('m01', 'm01-perl6-announcement', 'm02')
* A function name from Synopsis 29
* An entry in the Perl 6 Table Index ('%', '!=', 'split')
* The Perl 6 Tablet Index itself ('tablet_index')
* A path to a file containing Pod ('/some/file.pod')
This little application is intended to be a C<L<perldoc>> for Perl 6.
=head2 Prior art and inspiration
=over 4
=item Perl 5's C<perldoc> (L<>)
=item Python's C<pydoc> (L<>)
=item Ruby's C<ri> (L<>)
=item L<>
=item L<>
=head1 CAVEATS
=head2 Limitations of C<Perl6::Perldoc>
I<The following only affects Pod 6 documents.>
=over 2
=item * Long lines are not wrapped to fit your terminal.
=item * Extraneous whitespace in paragraphs is preserved, counter to the spec.
=item * Formatting codes using french quotes (C<C«»>) aren't parsed correctly,
so they are rendered verbatim.
=item * Formatting codes within C<=table> blocks are ignored.
=head1 AUTHOR
Hinrik Örn Sigurðsson, L<>
Copyright 2009 Hinrik Örn Sigurðsson
C<grok> is distributed under the terms of the Artistic License 2.0.
For more details, see the full text of the license in the file F<LICENSE>
that came with this distribution.
Jump to Line
Something went wrong with that request. Please try again.