[TWiki-Dev] [SVN] HideyoImazu r27296 - twiki/branches/TWikiRelease06x00/core/data/TWiki

[<de...@de...>]

Author: HideyoImazu
Date: 2014-04-17 05:27:14 -0500 (Thu, 17 Apr 2014)
New Revision: 27296
Trac url: http://develop.twiki.org/trac/changeset/27296

Modified:
   twiki/branches/TWikiRelease06x00/core/data/TWiki/FileAttachment.txt
Log:
Item7483: AllowI18nFileName configuration parameter and null file name prevention

Modified: twiki/branches/TWikiRelease06x00/core/data/TWiki/FileAttachment.txt
===================================================================
--- twiki/branches/TWikiRelease06x00/core/data/TWiki/FileAttachment.txt	2014-04-17 10:26:41 UTC (rev 27295)
+++ twiki/branches/TWikiRelease06x00/core/data/TWiki/FileAttachment.txt	2014-04-17 10:27:14 UTC (rev 27296)
@@ -1,4 +1,4 @@
-%META:TOPICINFO{author="TWikiContributor" date="1277272356" format="1.1" version="$Rev$"}%
+%META:TOPICINFO{author="TWikiContributor" date="1397697075" format="1.1" version="$Rev$"}%
 %STARTINCLUDE%
 ---+ File Attachments
 
@@ -151,6 +151,18 @@
       * *To change the comment* on an attachment, enter a new comment and then click *Change properties*.  Note that the comment listed against the specific version will not change, however the comment displayed when viewing the topic does change.  
       * *To hide/unhide* an attachment, enable the ==Hide file== checkbox, then click ==Change properties==.
 
+---++ File names
+
+File systems tend to be liberal about characters used in file names.
+But there are characters which may cause problems if they are used in a file name of a TWiki attachment.
+As such, when TWiki saves an uploaded file attachment, it's saved as a file whose name is cleansed to avoid problems.
+Specifically:
+   * Space are replaed by underscores
+   * The =.txt= extension is appended to some filenames for security reasons
+   * Characters such as =~=, =$=, =@=, =%= are removed
+   * Non-ASCII characters are %IF{"{AllowI18NFileName} or {UseLocale}" then="kept as they are" else="deleted"}%
+When an attachment file name is altered by the process above, you are notified
+
 ---++ Known Issues
 
    * Unlike topics, attachments are not locked during editing. As a workaround, you can change the comment to indicate an attachment file is being worked on - the comment on the specific version isn't lost, it's there when you list all versions of the attachment.