Explanation of Perl one-liner required

Win has asked for the wisdom of the Perl Monks concerning the following question:

Replies are listed 'Best First'.
Re: Explanation of Perl one-liner required by moritz (Cardinal) on Sep 28, 2009 at 11:01 UTC
You can read about the various command line switches in perlrun, the substitution should be explained in perlintro or perlretut. The xx.pm is simply a command line argument to the script. Perl 6 - links to (nearly) everything that is Perl 6.	[reply]
Re: Explanation of Perl one-liner required by jakobi (Pilgrim) on Sep 28, 2009 at 11:16 UTC
rewrite the options to something 'more standard', then it's easier to read (I ignored the p being hidden in plain sight due to pi.bak and was also wondering for a sec): `perl -w -i.bak -pe 's/Text::CSV/Text::CSV_XS/g' FILE_BEING_EDITED` <Reveal this spoiler or all in this thread> :) Peter	[reply] [d/l]
Re: Explanation of Perl one-liner required by Anonymous Monk on Sep 28, 2009 at 11:19 UTC
This is indeed a peculiar structure which will universally fix old Text::CSV installations and upgrade them. You can read more about it by doing `perldoc Text::CSV::Upgrade` (you will need a version of Text::CSV newer than 0.59, if you don't have that installed, just download it from CPAN and execute the command in the untarred directory).	[reply] [d/l]
Re^2: Explanation of Perl one-liner required by CountZero (Bishop) on Sep 28, 2009 at 12:21 UTC
I do not agree. A modern Text::CSV will use the XS-version if available and the Pure Perl version if XS is not available. So there is no need to "upgrade" your scripts. As per the docs: Text::CSV provides facilities for the composition and decomposition of comma-separated values using Text::CSV_XS or its pure Perl version. If there is anything you should do, then it is to replace `Text::CSV_XS` by `Text::CSV` to make your script more universally applicable. CountZero A program should be light and agile, its subroutines connected like a string of pearls. The spirit and intent of the program should be retained throughout. There should be neither too little or too much, neither needless loops nor useless variables, neither lack of structure nor overwhelming rigidity." - The Tao of Programming, 4.1 - Geoffrey James	[reply] [d/l] [select]
Re^3: Explanation of Perl one-liner required by almut (Canon) on Sep 28, 2009 at 14:51 UTC
I do not agree. A modern Text::CSV will use the XS-version if available and the Pure Perl version if XS is not available See Re: use Text::CSV 1.13 please - if you can get it for the context in which this command had been suggested (by someone who should know) — which Win forgot to mention... :)	[reply]
Re^3: Explanation of Perl one-liner required by ikegami (Patriarch) on Sep 28, 2009 at 16:35 UTC
You're missing the context. He doesn't have a modern Text::CSV, and it's easier instructing this particular monk to install Text::CSV_XS (simple ppm command) than to have him upgrade Text::CSV (which would require installation of make tools, an exercise requiring at least 5 posts to explain to this monk).	[reply]
Re^4: Explanation of Perl one-liner required by CountZero (Bishop) on Sep 28, 2009 at 18:46 UTC
Re^5: Explanation of Perl one-liner required by ikegami (Patriarch) on Sep 28, 2009 at 18:50 UTC
Some notes below your chosen depth have not been shown here
Re^5: Explanation of Perl one-liner required by ikegami (Patriarch) on Sep 28, 2009 at 19:40 UTC
Re^2: Explanation of Perl one-liner required by Anonymous Monk on Sep 28, 2009 at 11:21 UTC
Forgot, sorry, the more correct invocation is `perl -peb.cak -we"s{Text::CSV}{Text::CSV_XS}g" xx.pm`	[reply] [d/l]
Re^3: Explanation of Perl one-liner required by jakobi (Pilgrim) on Sep 28, 2009 at 13:35 UTC
~~Please double check your switches for typos...~~ update: (delayed) enlightenment was achieved	[reply]
Re^4: Explanation of Perl one-liner required by Anonymous Monk on Sep 28, 2009 at 13:57 UTC
Re^5: Explanation of Perl one-liner required by jakobi (Pilgrim) on Sep 28, 2009 at 14:24 UTC