Clarify acl_entries.

diff --git a/ChangeLog b/ChangeLog
index eba593c..688319e 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2009-05-03  Bruno Haible  <bruno@clisp.org>
+
+       * lib/acl-internal.h (acl_entries): Clarify return value.
+       * lib/acl_entries.c (acl_entries): Likewise.
+
 2009-05-04  David Bartley  <dtbartle@csclub.uwaterloo.ca>
 
        Bug fix in acl module.

diff --git a/lib/acl-internal.h b/lib/acl-internal.h
index 33a47e5..e4661e8 100644 (file)
--- a/lib/acl-internal.h
+++ b/lib/acl-internal.h
@@ -1,6 +1,6 @@
 /* Internal implementation of access control lists.
 
-   Copyright (C) 2002-2003, 2005-2008 Free Software Foundation, Inc.
+   Copyright (C) 2002-2003, 2005-2009 Free Software Foundation, Inc.
 
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
@@ -136,6 +136,8 @@ rpl_acl_set_fd (int fd, acl_t acl)
      ((Err) == ENOTSUP || (Err) == ENOSYS || (Err) == EINVAL || (Err) == EBUSY)
 #  endif
 
+/* Return the number of entries in ACL.
+   Return -1 and set errno upon failure to determine it.  */
 /* Define a replacement for acl_entries if needed. (Only Linux has it.)  */
 #  if !HAVE_ACL_ENTRIES
 #   define acl_entries rpl_acl_entries

diff --git a/lib/acl_entries.c b/lib/acl_entries.c
index a931fff..7884e47 100644 (file)
--- a/lib/acl_entries.c
+++ b/lib/acl_entries.c
@@ -1,6 +1,6 @@
 /* Return the number of entries in an ACL.
 
-   Copyright (C) 2002-2003, 2005-2008 Free Software Foundation, Inc.
+   Copyright (C) 2002-2003, 2005-2009 Free Software Foundation, Inc.
 
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
@@ -24,7 +24,8 @@
 /* This file assumes POSIX-draft like ACLs
    (Linux, FreeBSD, MacOS X, IRIX, Tru64).  */
 
-/* Return the number of entries in ACL.  */
+/* Return the number of entries in ACL.
+   Return -1 and set errno upon failure to determine it.  */
 
 int
 acl_entries (acl_t acl)