-// generates code for all added modules into one object file
-// On sucess returns a pointer to a generated mach-o buffer and
-// length set to the buffer size. Client must free() the buffer
-// when done.
-// On failure, returns NULL (check lto_get_error_message() for details)
+// Generates code for all added modules into one native object file.
+// On sucess returns a pointer to a generated mach-o/ELF buffer and
+// length set to the buffer size. The buffer is owned by the
+// lto_code_gen_t and will be freed when lto_codegen_dispose()
+// is called, or lto_codegen_compile() is called again.
+// On failure, returns NULL (check lto_get_error_message() for details).