Explain how '--' works in command-line invocation.

Excerpted from 'man bash': GNU Bash-2.05b, 2002 July 15.

For: RT #120732, as requested by bulk88.

diff --git a/pod/perlrun.pod b/pod/perlrun.pod
index dbaa12c..1feecb0 100644 (file)
--- a/pod/perlrun.pod
+++ b/pod/perlrun.pod
@@ -220,6 +220,9 @@ clustered with the following switch, if any.
 
     #!/usr/bin/perl -spi.orig  # same as -s -p -i.orig
 
+A C<--> signals the end of options and disables further option processing. Any
+arguments after the C<--> are treated as filenames and arguments.
+
 Switches include:
 
 =over 5