Interactive help: Difference between revisions

m
→‎{{header|Raku}}: Updated, probably could use some more fleshing out
(Rename Perl 6 -> Raku, alphabetize, minor clean-up)
m (→‎{{header|Raku}}: Updated, probably could use some more fleshing out)
Line 391:
=={{header|Raku}}==
(formerly Perl 6)
Perl 6 help is generally in a specialized text format known as POD (Plain Old Documentation). It is sometimes referred to as POD6 to distinguish it from Perl 5 POD which is slightly different and not completely compatible. Perl 6 has a local command line help app: p6doc. It also has online browsable HTML documentation at [https://docs.perl6.org docs.perl6.org]. If you want to download the HTML docs for a local copy, or just prefer to browse the documentation as a single page [https://docs.perl6.org/perl6.html docs.perl6.org/perl6.html] may be more to your preference. If you prefer a different format, there are [https://modules.perl6.org/search/?q=POD%3A%3ATo utilities available] to convert the POD docs to several different formats; Markdown, PDF, Latex, plain text, etc.
 
Perl 6Raku help is generally in a specialized text format known as POD (Plain Old Documentation). It is sometimes referred to as POD6 to distinguish it from Perl 5 POD which is slightly different and not completely compatible. Perl 6Raku has a local command line help app: p6doc. <tt>zef install p6doc</tt> It also has online browsable HTML documentation at [https://docs.perl6raku.org docs.perl6raku.org]. If you want to download the HTML docs for a local copy, or just prefer to browse the documentation as a single page [https://docs.perl6raku.org/perl6.html docs.perl6raku.org/perl6.html] may be more to your preference. If you prefer a different format, there are [https://modules.perl6raku.org/search/?q=POD%3A%3ATo utilities available] to convert the POD docs to several different formats; Markdown, PDF, Latex, plain text, etc.
Individual Perl 6 scripts are to some extent self-documenting. If the script has a MAIN sub, and it is called with improper parameters, it will display an automatically generated help message showing the various possible parameters, which are required, which are optional, and what type each takes:
 
Individual Perl 6Raku scripts are to some extent self-documenting. If the script has a MAIN sub, and it is called with improper parameters, it will display an automatically generated help message showing the various possible parameters, which are required, which are optional, and what type each takes:
 
<lang perl6>sub MAIN(
Str $run, #= Task or file name
Str :$lang = 'perl6raku', #= Language, default perl6raku
Int :$skip = 0, #= Skip # to jump partially into a list
Bool :f(:$force), #= Override any skip parameter
Line 404 ⟶ 405:
}</lang>
 
{{out|When saved locally as main.p6raku and invoked with no (or wrong) passed parameters}}
<pre>Usage:
main.p6raku [--lang=<Str>] [--skip=<Int>] [-f|--force] <run>
<run> Task or file name
--lang=<Str> Language, default perl6raku
--skip=<Int> Skip # to jump partially into a list
-f|--force Override any skip parameter
10,327

edits