docs(services/s3): fix inverted comment on disable_list_objects_v2 (#7820)

yangyang233333 · web-flow · commit 73ba2c039e84 · 2026-06-25T15:25:35.000+08:00
The first line of the doc comment said disabling list objects v2 makes
OpenDAL 'not use the older List Objects V1', which is the opposite of the
actual behavior. Setting disable_list_objects_v2 = true makes the backend
select S3ListerV1, i.e. it falls back TO the older List Objects V1.

Fix the wording to 'fall back to the older List Objects V1' to match the
code and the following sentence about legacy services not supporting V2.
diff --git a/core/services/s3/src/backend.rs b/core/services/s3/src/backend.rs
@@ -404,7 +404,7 @@ impl S3Builder {
         self
     }
 
-    /// Disable list objects v2 so that opendal will not use the older
+    /// Disable list objects v2 so that opendal will fall back to the older
     /// List Objects V1 to list objects.
     ///
     /// By default, OpenDAL uses List Objects V2 to list objects. However,

Original file line number	Diff line number	Diff line change
`@@ -404,7 +404,7 @@ impl S3Builder {`
`404`	`404`	`self`
`405`	`405`	`}`
`406`	`406`
`407`		`- /// Disable list objects v2 so that opendal will not use the older`
	`407`	`+ /// Disable list objects v2 so that opendal will fall back to the older`
`408`	`408`	`/// List Objects V1 to list objects.`
`409`	`409`	`///`
`410`	`410`	`/// By default, OpenDAL uses List Objects V2 to list objects. However,`