Changeset 7606 for lib/pugs/run.pod

Timestamp:

10/14/05 13:01:26 (3 years ago)

Author:

autrijus

Message:

* Add notes to Perl6::Pugs and pugs::run documentation about

the use of -- to separate pugs options and program options.
Reported by r0nny.

Files:

• lib/pugs/run.pod (modified) (1 diff)

lib/pugs/run.pod

@@ -24 +24 @@
 WRITEME
 
+=head2 Flags separation
+
+Pugs uses C<--> to separate flags of Pugs itself and arguments to the program.
+For example, this will print C<--help>:
+
+    $ pugs -e 'say @ARGS' -- --help
+
+But this will show the help message of Pugs:
+
+    $ pugs -e 'say @ARGS' --help
+
+For the same reason, to use Pugs in the Unix C<#!> line, add an extra C<-->
+after it:
+
+    #!/usr/bin/pugs --
+    say 'Hello, ', @ARGS, '!';
+
 =head2 Command line options