r9950: add note about malloc/free

diff --git a/doc/ref_string.xml b/doc/ref_string.xml
index 7b0e93cd24a7f3914591f4335f47d0f10ec33be3..235950a8fa1cc34ce2715a1028850d24fd86e01c 100644 (file)
--- a/doc/ref_string.xml
+++ b/doc/ref_string.xml
@@ -52,7 +52,9 @@
          (result-code (c-gethostname name 256))
          (hostname (when (zerop result-code)
                      (uffi:convert-from-foreign-string name))))
-    (uffi:free-foreign-object name)
+    ;; UFFI does not yet provide a universal way to free
+    ;; memory allocated by C's malloc. At this point, a program
+    ;; needs to call C's free function to free such memory.
     (unless (zerop result-code)
       (error "gethostname() failed."))))
     </screen>