Changeset 7606 for lib

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.

Location:

lib

Files:

• Perl6/Pugs.pm (modified) (1 diff)
• pugs/run.pod (modified) (1 diff)

lib/Perl6/Pugs.pm

@@ -17 +17 @@
     % pugs -e "{ 'Hello, ', @^x }.('World!').say"
     Hello, World!
+
+With Perl 5 embedding support (also note the C<--> in the C<#!> line):
+
+    #!/usr/bin/pugs --
+    use v6;
+    use perl5:DBI;
+    my $dbh = DBI.connect('dbi:SQLite:dbname=test.db');
+    $dbh.do("CREATE TABLE Test (Project, Pumpking)");
 
 =head1 DESCRIPTION

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