]> cloudbase.mooo.com Git - z180-stamp.git/blobdiff - fatfs/doc/en/setlabel.html
Merge branch 'chan-fatfs' into fatfs-integration
[z180-stamp.git] / fatfs / doc / en / setlabel.html
index 91179fc2da7f2a566963660004ac00a02a8a3c0f..f7a8b0ebbbf0e8152e0a7514bc8487221be2f33d 100644 (file)
@@ -49,12 +49,14 @@ FRESULT f_setlabel (
 \r
 <div class="para desc">\r
 <h4>Description</h4>\r
-<p>When the string has a drive number, the volume label will be set to the volume specified by the drive number. If not, the label will be set to the default drive. If the given string is a null-string, the volume label on the volume will be removed. The format of the volume label is similar to the short file name but there are some differences shown below:</p>\r
+<p>When the string has a drive number, the volume label will be set to the volume specified by the drive number. If not, the volume label will be set to the default drive. If length of the given volume label is zero, the volume label on the volume will be removed. The format of the volume label on the FAT volume is similar to the file name but there are some differences shown below:</p>\r
 <ul>\r
-<li>11 bytes or less in length as local character code. LFN extention is not applied to the volume label.</li>\r
-<li>Cannot contain period.</li>\r
-<li>Can contain spaces anywhere in the volume label. Trailing spaces are truncated off.</li>\r
+<li>Spaces can be contained anywhere in the volume label. Trailing spaces are truncated off at FAT volume.</li>\r
+<li>Period is not allowed.</li>\r
+<li>Up to 11 bytes long as conversion of OEM code page at FAT volume.</li>\r
+<li>Up to 11 characters long at exFAT volume. Case information is preserved.</li>\r
 </ul>\r
+<p>Remark: The standard system (Windows) has a problem at handling of the volume label with a heading <tt>\xE5</tt> on the FAT volume. To avoid this problem, this function rejects such volume label as invalid name.</p>\r
 </div>\r
 \r
 <div class="para comp">\r