Improve documentation of file_size fields

src/types/animation.rs

@@ -37,7 +37,7 @@ pub struct Animation {
     #[serde(with = "crate::types::non_telegram_types::mime::opt_deser")]
     pub mime_type: Option<Mime>,
 
-    /// A size of a file.
+    /// File size in bytes.
     pub file_size: Option<u32>,
 }
 

src/types/audio.rs

@@ -34,7 +34,7 @@ pub struct Audio {
     #[serde(with = "crate::types::non_telegram_types::mime::opt_deser")]
     pub mime_type: Option<Mime>,
 
-    /// A size of a file.
+    /// File size in bytes.
     pub file_size: Option<u32>,
 
     /// A thumbnail of the album cover to which the music file belongs.

src/types/document.rs

@@ -32,6 +32,6 @@ pub struct Document {
     #[serde(default, with = "crate::types::non_telegram_types::mime::opt_deser")]
     pub mime_type: Option<Mime>,
 
-    /// A size of a file.
+    /// File size in bytes.
     pub file_size: Option<u32>,
 }

src/types/file.rs

@@ -21,7 +21,7 @@ pub struct File {
     /// file.
     pub file_unique_id: String,
 
-    /// File size, if known.
+    /// File size in bytes, if known.
     ///
     /// **Note:** in the Telegram Bot API this field is optional, however it was
     /// errourneusly marked as required in Teloxide. To workaround this issue,

src/types/passport_file.rs

@@ -17,8 +17,8 @@ pub struct PassportFile {
     /// file.
     pub file_unique_id: String,
 
-    /// File size.
+    /// File size in bytes.
-    pub file_size: u64,
+    pub file_size: u64, // FIXME: should be u32
 
     /// Time when the file was uploaded.
     #[serde(with = "crate::types::serde_date_from_unix_timestamp")]

src/types/photo_size.rs

@@ -21,7 +21,7 @@ pub struct PhotoSize {
     /// Photo height.
     pub height: u32,
 
-    /// File size.
+    /// File size in bytes.
     pub file_size: Option<u32>,
 }
 

src/types/sticker.rs

@@ -44,6 +44,6 @@ pub struct Sticker {
     /// For mask stickers, the position where the mask should be placed.
     pub mask_position: Option<MaskPosition>,
 
-    /// File size.
+    /// File size in bytes.
     pub file_size: Option<u32>,
 }

src/types/video.rs

@@ -36,6 +36,6 @@ pub struct Video {
     #[serde(with = "crate::types::non_telegram_types::mime::opt_deser")]
     pub mime_type: Option<Mime>,
 
-    /// File size.
+    /// File size in bytes.
     pub file_size: Option<u32>,
 }

src/types/video_note.rs

@@ -30,6 +30,6 @@ pub struct VideoNote {
     /// Video thumbnail.
     pub thumb: Option<PhotoSize>,
 
-    /// File size.
+    /// File size in bytes.
     pub file_size: Option<u32>,
 }

src/types/voice.rs

@@ -22,6 +22,6 @@ pub struct Voice {
     #[serde(with = "crate::types::non_telegram_types::mime::opt_deser")]
     pub mime_type: Option<Mime>,
 
-    /// File size.
+    /// File size in bytes.
     pub file_size: Option<u64>,
 }