naloveyuki/BitLogger
1
0
Fork 0
mirror of https://github.com/Nanaloveyuki/BitLogger.git synced 2026-07-27 18:32:20 +00:00
Code Issues Packages Projects Releases Wiki Activity

📝 Add 1.0.1(0.6.1) change notes for wide file rotation

Browse Source
This commit is contained in:
Nanaloveyuki
2026-07-05 21:32:11 +08:00
parent 6e3cc165b6
commit b90481186f
14 changed files with 234 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/api/file-rotation.md
+5
View File
@@ -38,6 +38,9 @@ Detailed rules explaining key parameters and behaviors
- `max_backups <= 0` is normalized to `1`.
- Rotation is size-based only.
- This policy is consumed by `file_sink(...)`, file policy helpers, and config-driven file sink assembly.
- The default `max_bytes : Int` path follows the current 32-bit `Int` contract used by the standard file rotation APIs.
- On native targets, that default path is intended for ordinary log-file ranges rather than explicit large-file guarantees beyond the 32-bit `Int` boundary.
- If a native large-file threshold is required, prefer `file_rotation_i64(...)`.
### How to Use
@@ -79,3 +82,5 @@ e.g.:
2. Rotation currently focuses on size thresholds rather than time schedules or compression.
3. The default API keeps the portable `Int`-based contract stable; the wider native-only path is exposed separately through `file_rotation_i64(...)`.