Item13883: Merge branch 'Release02x01'

foswiki · Jan 4, 2017 · 4bd2602 · 4bd2602
2 parents 3e8264c + 6e1c5cd
commit 4bd2602
Show file tree

Hide file tree

Showing 2 changed files with 14 additions and 3 deletions.
diff --git a/core/data/System/CommandAndCGIScripts.txt b/core/data/System/CommandAndCGIScripts.txt
@@ -1,4 +1,4 @@
-%META:TOPICINFO{author="ProjectContributor" date="1456765822" format="1.1" version="1"}%
+%META:TOPICINFO{author="ProjectContributor" date="1483547096" format="1.1" version="1"}%
 %META:TOPICPARENT{name="DeveloperDocumentationCategory"}%
 %STARTINCLUDE%
 ---+ CGI and Command Line Scripts
@@ -42,6 +42,15 @@ $ save topic=MyWeb.MyTopic user=admin action=save text="New text of the topic"
 </verbatim>
 All parameters require a value, even if that is the empty string. Note that parameters passed on the command-line should *not* be URL-encoded.
 
+*Note:* If any of the arguments will contain utf-8 strings, (ie. when entering a Unicode topic name), you must run the command
+using the perlrun argument =-CA=.  For example:
+<pre class="bash">
+$ cd /usr/local/foswiki/bin
+$ perl -CA ./save -topic MyWeb.My&Uuml;tf8T&ouml;pic -user admin -action save -text "Text with &raquo;&Auml;&euml;&iuml;&ouml;&uuml;&laquo; utf8 characters."
+</pre>
+
+For more details on the perl command line arguments, see [[http://perldoc.perl.org/perlrun.html]].
+
 ---+++++ "Authentication" in the command line environment
 
 Unlike the CGI environment, the default user for command line operations is =AdminUser=.
@@ -595,8 +604,8 @@ Uploads an attachment to a topic. The HTTP request is expected to be in =multipa
    * You can use a tool like =curl= to upload files from the command line using this script.
    * You can call upload easily from !XmlHttpRequest in Javascript.
    * You can directly invoke upload from the CLI script.__New with Foswiki 2.1__
-      * You must use the Perl CLI options  '-CA' if the filename contains non-ASCII characters.
-      * ex. Run from the bin directory: =perl -CA ./upload filepath="/path/and/filename.dat" filename="attachname.dat" topic=Sandbox.ExistingTopic=
+      * You must use the Perl CLI options  '-CA' if the filename or any other arguments contains utf-8 (non-ASCII) characters.
+      * ex. Run from the bin directory: =perl -CA ./upload filepath="/path/and/filename.dat" filename="&Atilde;ttachname.dat" topic=Sandbox.Existing&Uuml;tf8Topic=
 
 <div class="foswikiHelp"> 
 *%X% Note:* The =upload= script can only be called via HTTP POST method. Make sure you specify =method="post"= if you call the =upload= script via a form action. It is not possible to call =upload= from an =&lt;a href ...&gt;= link.

diff --git a/core/tools/configure b/core/tools/configure
@@ -488,6 +488,8 @@ Use -save to save a new configuration.
 
 Use -json and -trace to control the output of this script.
 
+If any command line arguments are utf-8 characters, be sure to run configure using the B<perl -CA tools/configure ...> command.
+
 =head1 OPTIONS
 
 =over 8