Interactive help: Difference between revisions
→{{header|Perl 6}}: Add a Perl 6 example
m (→{{header|REXX}}: added the REXX computer programming language for this task.) |
Thundergnat (talk | contribs) (→{{header|Perl 6}}: Add a Perl 6 example) |
||
Line 50:
tails BOOL Returned only tail of path.
types STRKEY Filter files to include type: one or more of chars 'fdlpsbc' for file, directory, link, etc.</pre>
=={{header|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.
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:
<lang perl6>sub MAIN(
Str $run, #= Task or file name
Str :$lang = 'perl6', #= Language, default perl6
Int :$skip = 0, #= Skip # to jump partially into a list
Bool :f(:$force), #= Override any skip parameter
) {
# do whatever
}</lang>
{{out|When saved locally as main.p6 and invoked with no (or wrong) passed parameters}}
<pre>Usage:
main.p6 [--lang=<Str>] [--skip=<Int>] [-f|--force] <run>
<run> Task or file name
--lang=<Str> Language, default perl6
--skip=<Int> Skip # to jump partially into a list
-f|--force Override any skip parameter
</pre>
=={{header|REXX}}==
| |||