Skip to content

Commit da12180

Browse files
authored
improve some explanations
1 parent e8bc234 commit da12180

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

doc/Language/create-cli.rakudoc

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -131,7 +131,10 @@ sub MAIN(
131131
say 'Verbosity ', ($verbose ?? 'on' !! 'off');
132132
}
133133

134-
With C<file.dat> present, this will work this way:
134+
The clause C<where *.IO.f> checks that the string C<$file> corresponds to the name of a file that actually exists.
135+
The part C<= 'file.dat'> specifies a default value for C<$file> in case no argument for it is given.
136+
137+
If a file C<file.dat> is present, a call with no arguments will work this way:
135138
=begin code :lang<shell>
136139
$ raku frobnicate.raku
137140
24
@@ -158,12 +161,12 @@ Usage:
158161
frobnicate.raku [--length=<Int>] [--verbose] [<file>]
159162
=end code
160163

161-
Although you don't have to do anything in your code to do this, it may still
162-
be regarded as a bit terse.
164+
Such usage messages are generated completely automatically for you.
165+
If they seem too terse, you can easily add more information to them.
163166

164167
=head2 Improve usage messages with rakudoc comments
165168

166-
But there's an easy way to make that usage
169+
There's an easy way to make the autogenerated usage
167170
message better by providing hints using pod features:
168171

169172
=for code :method<False>

0 commit comments

Comments
 (0)