From: Georg Brandl <georg@python.org>
Date: Thu, 2 Oct 2014 06:34:41 +0000 (+0200)
Subject: Closes #19342: improve docstrings in grp module.
X-Git-Tag: v3.5.0a1~786^2
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=41ea1f4f26667c1741368567716d38febc2648a4;p=python

Closes #19342: improve docstrings in grp module.
---

diff --git a/Modules/grpmodule.c b/Modules/grpmodule.c
index c8a93723ea..da78253ccb 100644
--- a/Modules/grpmodule.c
+++ b/Modules/grpmodule.c
@@ -152,11 +152,11 @@ grp_getgrall(PyObject *self, PyObject *ignore)
 
 static PyMethodDef grp_methods[] = {
     {"getgrgid",        grp_getgrgid,   METH_O,
-     "getgrgid(id) -> tuple\n\
+     "getgrgid(id) -> (gr_name,gr_passwd,gr_gid,gr_mem)\n\
 Return the group database entry for the given numeric group ID.  If\n\
 id is not valid, raise KeyError."},
     {"getgrnam",        grp_getgrnam,   METH_VARARGS,
-     "getgrnam(name) -> tuple\n\
+     "getgrnam(name) -> (gr_name,gr_passwd,gr_gid,gr_mem)\n\
 Return the group database entry for the given group name.  If\n\
 name is not valid, raise KeyError."},
     {"getgrall",        grp_getgrall,   METH_NOARGS,
@@ -173,10 +173,10 @@ PyDoc_STRVAR(grp__doc__,
 Group entries are reported as 4-tuples containing the following fields\n\
 from the group database, in order:\n\
 \n\
-  name   - name of the group\n\
-  passwd - group password (encrypted); often empty\n\
-  gid    - numeric ID of the group\n\
-  mem    - list of members\n\
+  gr_name   - name of the group\n\
+  gr_passwd - group password (encrypted); often empty\n\
+  gr_gid    - numeric ID of the group\n\
+  gr_mem    - list of members\n\
 \n\
 The gid is an integer, name and password are strings.  (Note that most\n\
 users are not explicitly listed as members of the groups they are in\n\