diff --git a/stralloc.h b/stralloc.h
index ec4f8a8..47cc9ea 100644
--- a/stralloc.h
+++ b/stralloc.h
@@ -56,11 +56,11 @@ extern int stralloc_cats(stralloc* sa,const char* in);
 /* stralloc_cat is analogous to stralloc_copy */
 extern int stralloc_cat(stralloc* sa,stralloc* in);
 
-/* stralloc_append adds one byte buf[0] to the end of the string stored
- * in sa. It is the same as stralloc_catb(&sa,buf,1). */
+/* stralloc_append adds one byte in[0] to the end of the string stored                                            
+ * in sa. It is the same as stralloc_catb(&sa,in,1). */                                                           
 extern int stralloc_append(stralloc* sa,const char* in); /* beware: this takes a pointer to 1 char */
 
-/* stralloc_starts returns 1 if the \0-terminated string in buf, without
+/* stralloc_starts returns 1 if the \0-terminated string in "in", without                                         
  * the terminating \0, is a prefix of the string stored in sa. Otherwise
  * it returns 0. sa must already be allocated. */
 extern int stralloc_starts(stralloc* sa,const char* in);
diff --git a/stralloc/stralloc_append.c b/stralloc/stralloc_append.c
index 068d83b..c90c778 100644
--- a/stralloc/stralloc_append.c
+++ b/stralloc/stralloc_append.c
@@ -1,7 +1,7 @@
 #include "stralloc.h"
 
-/* stralloc_append adds one byte buf[0] to the end of the string stored
- * in sa. It is the same as stralloc_catb(&sa,buf,1). */
+/* stralloc_append adds one byte in[0] to the end of the string stored                                            
+ * in sa. It is the same as stralloc_catb(&sa,in,1). */                                                           
 int stralloc_append(stralloc *sa,const char *in) {
   if (stralloc_readyplus(sa,1)) {
     sa->s[sa->len]=*in;