FreeBSD source tree https://cgit-dev.freebsd.org/src-test2/atom?h=master 2020-12-19T14:54:28Z 2020-12-19T14:54:28Z Gordon Bergling gbe@FreeBSD.org 2020-12-19T14:54:28Z urn:sha1:f6d234d8706fa4ad513bb5db2976b0e354a0f0fe - varios "new sentence, new line" warnings - varios "sections out of conventional order" warnings - varios "unusual Xr order" warnings - varios "missing section argument" warnings - varios "no blank before trailing delimiter" warnings - varios "normalizing date format" warnings MFC after: 1 month 2020-12-11T01:52:27Z Enji Cooper ngie@FreeBSD.org 2020-12-11T01:52:27Z urn:sha1:0c424c64f81c2c7c0ed2d6b72da9927d48b1c3dc Sort by manpage section, then sort entries alphabetically. This makes the manpages `make manlint` clean. MFC after: 1 week Sponsored by: DellEMC Isilon 2020-12-11T00:28:28Z Enji Cooper ngie@FreeBSD.org 2020-12-11T00:28:28Z urn:sha1:92d4164179518651ade878b87d5822db4e4dc355 Months should be fully spelled as their local-specific equivalents: in this case `Oct` should have been spelled like `October`. Reported by: make manlint MFC after: 1 week Sponsored by: DellEMC Isilon 2020-12-11T00:26:49Z Enji Cooper ngie@FreeBSD.org 2020-12-11T00:26:49Z urn:sha1:20daf0ca6ea8ac82fa3a88f1d5e68507773c9644 The CAVEATS section was misspelled as "CAVEAT" before this change. Fix the spelling to identify issues related to the section. Furthermore, given that the section order was incorrect, move the CAVEATS section down to the bottom of the manpage, per the conventional section order. MFC after: 1 week Reported by: make manlint Sponsored by: DellEMC Isilon 2020-12-09T03:20:51Z Kyle Evans kevans@FreeBSD.org 2020-12-09T03:20:51Z urn:sha1:e04a83a3e1b40fc7c41b5938d2e432ba01facd74 This was part of D27325. Reviewed by: kib 2020-12-08T04:18:16Z Enji Cooper ngie@FreeBSD.org 2020-12-08T04:18:16Z urn:sha1:00107a56e597aa029756d1a83321a06e5fc98c23 This is being done for the formatting and context changes. While the net content hasn't been changed, the content/context changes were sufficient to warrant the date bump. MFC after: 1 week MFC with: r368431, r368433, r368434, r368435 Sponsored by: DellEMC Isilon 2020-12-08T04:16:05Z Enji Cooper ngie@FreeBSD.org 2020-12-08T04:16:05Z urn:sha1:cf681016d47ed689da60c8cfe1a4fb894e036b4d While some of the syscalls' behavior were documented and implied in the RETURN VALUES section by earlier, e.g., the DESCRIPTION sections, as having behavior of the other calls (`*_fd` vs `*_file` vs `*_link`), there was a lot of implied return value behavior in the section prior to this change. Explicitly document the syscall behavior per the current implementation in sys/kern/vfs_extattr.c so others can better develop based on its explicit documented behavior instead of having to digest the context of the manpage to understand the appropriate behavior. MFC after: 1 week MFC with: r368431, r368433, r368434 Sponsored by: DellEMC Isilon 2020-12-08T04:05:19Z Enji Cooper ngie@FreeBSD.org 2020-12-08T04:05:19Z urn:sha1:f7055239398f3a13377f30ba124201909b482bbd - Remove an unnecessary trailing comma separating a two-item clause. - Sort more function calls alphabetically (in the same vein as r368433). MFC after: 1 week Sponsored by: DellEMC Isilon 2020-12-08T04:01:03Z Enji Cooper ngie@FreeBSD.org 2020-12-08T04:01:03Z urn:sha1:e8e0f91b8bb273684fa7d11eb514681c45edbf06 Although some sections of the manpage sort the syscalls alphabetically, many core areas of the manpage do not. Sort the syscalls so it is easier to pick out functional changes and to improve manpage readability. This formatting change is also being done to make future functional changes easier to spot. MFC after: 1 week Sponsored by: DellEMC Isilon 2020-12-08T03:48:05Z Enji Cooper ngie@FreeBSD.org 2020-12-08T03:48:05Z urn:sha1:403b2124d47c5b31c14d5242f29a61c42067d61a The date with .Dd prior to this change isn't canonically spelled out: it should have been "December", not "Dec". MFC after: 1 week Sponsored by: DellEMC Isilon