From 5a98619165d29a802c099b7ee8b8e8434992e160 Mon Sep 17 00:00:00 2001
From: Mattias Andrée <maandree@operamail.com>
Date: Fri, 20 Nov 2015 02:12:30 +0100
Subject: more etymology
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Mattias Andrée <maandree@operamail.com>
---
 src/strings/bcmp.c           | 2 ++
 src/strings/bcopy.c          | 2 ++
 src/strings/bzero.c          | 2 ++
 src/strings/explicit_bzero.c | 2 ++
 src/strings/ffs.c            | 4 +++-
 src/strings/ffsl.c           | 5 ++++-
 src/strings/ffsll.c          | 4 +++-
 src/strings/index.c          | 2 ++
 src/strings/rindex.c         | 2 ++
 9 files changed, 22 insertions(+), 3 deletions(-)

(limited to 'src/strings')

diff --git a/src/strings/bcmp.c b/src/strings/bcmp.c
index 3693354..23e6126 100644
--- a/src/strings/bcmp.c
+++ b/src/strings/bcmp.c
@@ -22,6 +22,8 @@
 
 /**
  * This function is identical to `memcmp`.
+ * 
+ * @etymology  (B)uffer: (c)o(mp)are.
  */
 int bcmp(const void* a, const void* b, size_t size)
 {
diff --git a/src/strings/bcopy.c b/src/strings/bcopy.c
index 47bbc1c..1abeb7c 100644
--- a/src/strings/bcopy.c
+++ b/src/strings/bcopy.c
@@ -23,6 +23,8 @@
 /**
  * Copy a memory segment to another, possibly overlapping, segment.
  * 
+ * @etymology  (B)uffer: (copy).
+ * 
  * @param  whence   The source memory segment.
  * @param  whither  The destination memory segment.
  * @param  size     The number of bytes to copy.
diff --git a/src/strings/bzero.c b/src/strings/bzero.c
index a3cb557..e581b94 100644
--- a/src/strings/bzero.c
+++ b/src/strings/bzero.c
@@ -23,6 +23,8 @@
 /**
  * Override a memory segment with zeroes.
  * 
+ * @etymology  (B)uffer: (zero) out.
+ * 
  * @param  segment  The memory segment to override.
  * @param  size     The size of the memory segment.
  */
diff --git a/src/strings/explicit_bzero.c b/src/strings/explicit_bzero.c
index 00fe4ab..387c666 100644
--- a/src/strings/explicit_bzero.c
+++ b/src/strings/explicit_bzero.c
@@ -33,6 +33,8 @@ void* (*volatile __slibc_explicit_memset)(void*, int, size_t) = memset;
  * Unlike `bzero` and `memset`, calls to this function
  * cannot be removed, as an optimisation, by the compiler.
  * 
+ * @etymology  (Explicit) version of (`bzero`).
+ * 
  * @param  segment  The memory segment to override.
  * @param  size     The size of the memory segment.
  */
diff --git a/src/strings/ffs.c b/src/strings/ffs.c
index 7de35a4..46ad612 100644
--- a/src/strings/ffs.c
+++ b/src/strings/ffs.c
@@ -22,7 +22,9 @@
 /**
  * Find the first set bit in an integer.
  * 
- * @param   i  The integer
+ * @etymology  (F)ind (f)irst (s)et bit on `int`.
+ * 
+ * @param   i  The integer.
  * @return     The value of the least significant set bit, zero if none.
  */
 int ffs(int i)
diff --git a/src/strings/ffsl.c b/src/strings/ffsl.c
index 6657769..3116723 100644
--- a/src/strings/ffsl.c
+++ b/src/strings/ffsl.c
@@ -18,10 +18,13 @@
 #include <strings.h>
 
 
+
 /**
  * Find the first set bit in an integer.
  * 
- * @param   i  The integer
+ * @etymology  (F)ind (f)irst (s)et bit on `(l)ong int`.
+ * 
+ * @param   i  The integer.
  * @return     The value of the least significant set bit, zero if none.
  */
 int ffsl(long i)
diff --git a/src/strings/ffsll.c b/src/strings/ffsll.c
index c053fb6..13d4c14 100644
--- a/src/strings/ffsll.c
+++ b/src/strings/ffsll.c
@@ -22,7 +22,9 @@
 /**
  * Find the first set bit in an integer.
  * 
- * @param   i  The integer
+ * @etymology  (F)ind (f)irst (s)et bit on `(l)ong (l)ong int`.
+ * 
+ * @param   i  The integer.
  * @return     The value of the least significant set bit, zero if none.
  */
 int ffsll(long long i)
diff --git a/src/strings/index.c b/src/strings/index.c
index 2f46d30..332811d 100644
--- a/src/strings/index.c
+++ b/src/strings/index.c
@@ -24,6 +24,8 @@
  * This function is identical to `strchr`.
  * 
  * This is a deprecated BSD extension.
+ * 
+ * @etymology  (Index) of character.
  */
 char* (index)(const char* string, int c)
 {
diff --git a/src/strings/rindex.c b/src/strings/rindex.c
index 0ab4ed1..3e39a9e 100644
--- a/src/strings/rindex.c
+++ b/src/strings/rindex.c
@@ -24,6 +24,8 @@
  * This function is identical to `strrchr`.
  * 
  * This is a deprecated BSD extension.
+ * 
+ * @etymology  (R)ight-most (index) of character.
  */
 char* (rindex)(const char* string, int c)
 {
-- 
cgit v1.2.3-70-g09d2