doc: updated the Class:fs filesystem documentation as it was missing … by shrenisc · Pull Request #55279 · nodejs/node · GitHub
Skip to content

doc: updated the Class:fs filesystem documentation as it was missing …#55279

Closed
shrenisc wants to merge 9 commits into
nodejs:mainfrom
shrenisc:statfs_docs_update
Closed

doc: updated the Class:fs filesystem documentation as it was missing …#55279
shrenisc wants to merge 9 commits into
nodejs:mainfrom
shrenisc:statfs_docs_update

Conversation

@shrenisc

@shrenisc shrenisc commented Oct 5, 2024

Copy link
Copy Markdown

Defined the return type for statfs.bsize. Added examples for statfs.bavail, statfs.bfree, statfs.blocks and statfs.files for clarity. Explained why statfs.type returns a int|bigint value and added a table with most commonly used magic numbers and their filesystems.

Fixes: #50749

…information and examples

Defined the return type for statfs.bsize. Added examples for statfs.bavail, statfs.bfree, statfs.blocks and statfs.files for clarity. Cleared the air on why statfs.type returns a int|bigint value.

Fixes: #50749
@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 Oct 5, 2024
Comment thread doc/api/fs.md
Comment thread doc/api/fs.md
Comment thread doc/api/fs.md
Comment thread doc/api/fs.md
Comment thread doc/api/fs.md
Comment thread doc/api/fs.md Outdated
Comment thread doc/api/fs.md Outdated
Comment thread doc/api/fs.md Outdated
Comment thread doc/api/fs.md
Comment on lines +7660 to +7748

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of a table, is there a wikipage or something that users can be referred to?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I found a Linux Manual page which lists these filesystems but I am unsure whether we can link it here. Also, they only list Linux filesystems and miss out on the popular NTFS, NFS etc.

@avivkeller

Copy link
Copy Markdown
Member

Can you fix your commit message? Something like:

doc: add missing examples and information to fs

shrenisc and others added 3 commits October 5, 2024 23:04
Co-authored-by: Aviv Keller <redyetidev@gmail.com>
Co-authored-by: Aviv Keller <redyetidev@gmail.com>
…information and examples

Defined the return type for statfs.bsize. Added examples for statfs.bavail, statfs.bfree, statfs.blocks and statfs.files for clarity. Cleared the air on why statfs.type returns a int|bigint value.

Fixes: #50749
Comment thread doc/api/fs.md Outdated
shrenisc and others added 4 commits October 5, 2024 23:46
Defined the return type for statfs.bsize. Added examples for statfs.bavail, statfs.bfree, statfs.blocks and statfs.files for clarity. Explained why statfs.type returns a int|bigint value and added a table with most commonly used filesystems and their magic numbers.

Fixes: #50749
Defined the return type for statfs.bsize. Added examples for statfs.bavail, statfs.bfree, statfs.blocks and statfs.files for clarity. Explained why statfs.type returns a int|bigint value and added a table with most commonly used magic numbers and their filesystems.

Fixes: #50749
Co-authored-by: Aviv Keller <redyetidev@gmail.com>
@avivkeller

Copy link
Copy Markdown
Member

It looks like your merge caused some errors. Please remove the merge commit.

@shrenisc

shrenisc commented Oct 6, 2024 via email

Copy link
Copy Markdown
Author

@avivkeller

Copy link
Copy Markdown
Member

@shrenisc shrenisc closed this Oct 6, 2024
@shrenisc shrenisc deleted the statfs_docs_update branch October 6, 2024 19:15
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.

Missing documentation in fs.StatFs

3 participants