Document st_flags in the stat(2).

[sobomax]

Summary

The st_flags is quite important bit of info returned by the stat and used a lot around the code, yet not mentioned in the man page. Fill in the void by xref-ing chflags manpage.

[vangyzen]

lib/libc/sys/stat.2

31

Remember to bump this when you commit.

141

"User-defined" should be hyphenated.

Add "the" before "file".

[jilles]

lib/libc/sys/stat.2

141

I think "user-defined" should be removed entirely, since file flags are no more user-defined than permission bits are.

[vangyzen]

lib/libc/sys/stat.2

141

Good point. Agreed.

Maybe the original author meant "user-assigned", but even that seems too verbose.

[mckusick]

lib/libc/sys/stat.2

141

I concur with jilles. I would word it as "The file's flags." or perhaps "The flags enabled for the file.''

[mckusick]

With suggested change, I am happy with this (useful) update.

[sobomax]

Re-phrase a bit based on suggestions.

[sobomax]

Adjusted a bit as suggested.

[mckusick]

Looks good. Make it so.