From: Jim Meyering <jim@meyering.net>
Date: Fri, 23 Feb 2007 21:16:12 +0000 (+0100)
Subject: * randperm.c (randperm_new): Comment: say that this function
X-Git-Tag: COREUTILS-6_8~11
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=813de08e50ee89bccff10d97caa673331de7a244;p=thirdparty%2Fcoreutils.git

* randperm.c (randperm_new): Comment: say that this function
returns a pointer to malloc'd storage.
---

diff --git a/lib/ChangeLog b/lib/ChangeLog
index 09b54b6498..2f833f71a5 100644
--- a/lib/ChangeLog
+++ b/lib/ChangeLog
@@ -1,3 +1,8 @@
+2007-02-23  Jim Meyering  <jim@meyering.net>
+
+	* randperm.c (randperm_new): Comment: say that this function
+	returns a pointer to malloc'd storage.
+
 2007-02-18  Jim Meyering  <jim@meyering.net>
 
 	* xfts.c: Include <stdlib.h> rather than exit.h, now that stdlib.h
diff --git a/lib/randperm.c b/lib/randperm.c
index faf34dde1c..c4438ddfba 100644
--- a/lib/randperm.c
+++ b/lib/randperm.c
@@ -1,6 +1,6 @@
 /* Generate random permutations.
 
-   Copyright (C) 2006 Free Software Foundation, Inc.
+   Copyright (C) 2006, 2007 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
@@ -58,9 +58,9 @@ randperm_bound (size_t h, size_t n)
   return bound;
 }
 
-/* From R, allocate and return the first H elements of a random
-   permutation of N elements.  H must not exceed N.  Return NULL if H
-   is zero.  */
+/* From R, allocate and return a malloc'd array of the first H elements
+   of a random permutation of N elements.  H must not exceed N.
+   Return NULL if H is zero.  */
 
 size_t *
 randperm_new (struct randint_source *r, size_t h, size_t n)