unistd::getgrouplist: Move error explanation to correct section

Author: JayH5

src/unistd.rs

@@ -779,7 +779,7 @@ pub enum Whence {
     SeekCur = libc::SEEK_CUR,
     /// Specify an offset relative to the end of the file.
     SeekEnd = libc::SEEK_END,
-    /// Specify an offset relative to the next location in the file greater than or 
+    /// Specify an offset relative to the next location in the file greater than or
     /// equal to offset that contains some data. If offset points to
     /// some data, then the file offset is set to offset.
     #[cfg(any(target_os = "dragonfly", target_os = "freebsd",
@@ -788,7 +788,7 @@ pub enum Whence {
                                            target_arch = "mips64")))))]
     SeekData = libc::SEEK_DATA,
     /// Specify an offset relative to the next hole in the file greater than
-    /// or equal to offset. If offset points into the middle of a hole, then 
+    /// or equal to offset. If offset points into the middle of a hole, then
     /// the file offset should be set to offset. If there is no hole past offset,
     /// then the file offset should be adjusted to the end of the file (i.e., there
     /// is an implicit hole at the end of any file).
@@ -1056,15 +1056,17 @@ pub fn setgroups(groups: &[Gid]) -> Result<()> {
 /// groups that `user` is a member of. The additional group `group` is also
 /// added to the list.
 ///
-/// *Note:* Although the `getgrouplist()` call does not return any specific
+/// [Further reading](http://man7.org/linux/man-pages/man3/getgrouplist.3.html)
+///
+/// # Errors
+///
+/// Although the `getgrouplist()` call does not return any specific
 /// errors on any known platforms, this implementation will return a system
 /// error of `EINVAL` if the number of groups to be fetched exceeds the
 /// `NGROUPS_MAX` sysconf value. This mimics the behaviour of `getgroups()`
 /// and `setgroups()`. Additionally, while some implementations will return a
 /// partial list of groups when `NGROUPS_MAX` is exceeded, this implementation
 /// will only ever return the complete list or else an error.
-///
-/// [Further reading](http://man7.org/linux/man-pages/man3/getgrouplist.3.html)
 pub fn getgrouplist(user: &CString, group: Gid) -> Result<Vec<Gid>> {
     let ngroups_max = match sysconf(SysconfVar::NGROUPS_MAX) {
         Ok(Some(n)) => n as c_int,