NAME
    grok - Perl 6 documentation reader

SYNOPSIS
    grok <options> <target>

     Options:
       -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, --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 Table Index itself ('table_index')
       * A path to a file containing Pod ('/some/file.pod')

DESCRIPTION
    This little application is intended to be a "perldoc" for Perl 6.

  Prior art and inspiration
    Perl 5's "perldoc" (<http://perldoc.perl.org/perldoc.html>)
    Python's "pydoc" (<http://docs.python.org/library/pydoc.html>)
    Ruby's "ri"
    (<http://svn.ruby-lang.org/cgi-bin/viewvc.cgi/trunk/lib/rdoc/>)
    <http://svn.pugscode.org/pugs/ext/Perldoc/>
    <http://svn.pugscode.org/pugs/examples/perldoc.pl>

CAVEATS
  Limitations of "Perl6::Perldoc"
    *The following only affects Pod 6 documents.*

    * Long lines are not wrapped to fit your terminal.

    * Extraneous whitespace in paragraphs is preserved, counter to the spec.

    * Formatting codes using french quotes ("C«»") aren't parsed correctly,
      so they are rendered verbatim.

    * Formatting codes within "=table" blocks are ignored.

AUTHOR
    Hinrik Örn Sigurðsson, hinrik.sig@gmail.com

LICENSE AND COPYRIGHT
    Copyright 2009 Hinrik Örn Sigurðsson

    "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 LICENSE that
    came with this distribution.