Skip to content

doc: improve fs.StatFs documentation with examples and clarifications#62578

Open
aymanxdev wants to merge 1 commit intonodejs:mainfrom
aymanxdev:doc/update-fs-statfs-documentation
Open

doc: improve fs.StatFs documentation with examples and clarifications#62578
aymanxdev wants to merge 1 commit intonodejs:mainfrom
aymanxdev:doc/update-fs-statfs-documentation

Conversation

@aymanxdev
Copy link
Copy Markdown

Hey, this is my first PR here.

This PR improves the documentation for the fs.StatFs class properties by making them more useful and informative.

Summary of Changes

  • statfs.bavail, statfs.bfree, statfs.blocks: expand descriptions
    to explain how to multiply by bsize to get byte counts, and add
    mjs/cjs usage examples
  • statfs.bsize: clarify the unit by adding "in bytes"
  • statfs.type: replace the one-liner with a full explanation of what
    the numeric value represents (f_type from statfs(2), platform-
    specific, not portable across OSes)
  • Added [statfs.bsize] reference link to support the cross-references

Expand the descriptions for statfs.bavail, statfs.bfree, and statfs.blocks to explain how to multiply by bsize to get byte counts, and add usage examples. Expand statfs.type with an explanation of what the numeric value represents. Add a reference link for statfs.bsize to support the cross-references.
@nodejs-github-bot nodejs-github-bot added doc Issues and PRs related to the documentations. fs Issues and PRs related to the fs subsystem / file system. labels Apr 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc Issues and PRs related to the documentations. fs Issues and PRs related to the fs subsystem / file system.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants