/
README
62 lines (47 loc) · 2.28 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
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.