Documentation

deltachat-ffi/deltachat.h

@@ -4766,7 +4766,7 @@ void            dc_msg_set_file               (dc_msg_t* msg, const char* file,
  * otherwise it will be copied to the blobdir first.
  *
  * In order to deduplicate files that contain the same data,
- * the file will be named as a hash of the file data.
+ * the file will be named `<hash>.<extension>`, e.g. `ce940175885d7b78f7b7e9f1396611f.jpg`.
  *
  * NOTE:
  * - This function will rename the file. To get the new file path, call `get_file()`.

src/blob.rs

@@ -150,7 +150,7 @@ impl<'a> BlobObject<'a> {
     /// otherwise it will be copied to the blobdir first.
     ///
     /// In order to deduplicate files that contain the same data,
-    /// the file will be named `hash.extension`, e.g. ce940175885d7b78f7b7e9f1396611f.jpg.
+    /// the file will be named `<hash>.<extension>`, e.g. `ce940175885d7b78f7b7e9f1396611f.jpg`.
     /// The `original_name` param is only used to get the extension.
     ///
     /// This is done in a in way which avoids race-conditions when multiple files are
@@ -214,7 +214,8 @@ impl<'a> BlobObject<'a> {
 
     /// Creates a new blob object with the file contents in `data`.
     /// In order to deduplicate files that contain the same data,
-    /// the file will be renamed to a hash of the file data.
+    /// the file will be named `<hash>.<extension>`, e.g. `ce940175885d7b78f7b7e9f1396611f.jpg`.
+    /// The `original_name` param is only used to get the extension.
     ///
     /// The `data` will be written into the file without race-conditions.
     ///

src/message.rs

@@ -1094,7 +1094,7 @@ impl Message {
     /// otherwise it will be copied to the blobdir first.
     ///
     /// In order to deduplicate files that contain the same data,
-    /// the file will be named as a hash of the file data.
+    /// the file will be named `<hash>.<extension>`, e.g. `ce940175885d7b78f7b7e9f1396611f.jpg`.
     ///
     /// NOTE:
     /// - This function will rename the file. To get the new file path, call `get_file()`.
@@ -1126,7 +1126,7 @@ impl Message {
     /// Creates a new blob and sets it as a file associated with a message.
     ///
     /// In order to deduplicate files that contain the same data,
-    /// the filename will be a hash of the file data.
+    /// the file will be named `<hash>.<extension>`, e.g. `ce940175885d7b78f7b7e9f1396611f.jpg`.
     ///
     /// NOTE: The file must not be modified after this function was called.
     pub fn set_file_from_bytes(