diff --git a/types/nodegit/buf.d.ts b/types/nodegit/buf.d.ts
index 53886615ed..d9670bb293 100644
--- a/types/nodegit/buf.d.ts
+++ b/types/nodegit/buf.d.ts
@@ -1,12 +1,67 @@
 /// <reference types="node" />
 
 export class Buf {
+        /**
+         *
+         *
+         * @returns {number}
+         *
+         * @memberof Buf
+         */
         containsNul(): number;
+        /**
+         *
+         *
+         *
+         * @memberof Buf
+         */
         free(): void;
+        /**
+         *
+         *
+         * @param {number} target_size
+         * @returns {Promise<Buf>}
+         *
+         * @memberof Buf
+         */
         grow(target_size: number): Promise<Buf>;
+        /**
+         *
+         *
+         * @returns {number}
+         *
+         * @memberof Buf
+         */
         isBinary(): number;
+        /**
+         *
+         *
+         * @param {Buffer} data
+         * @param {number} datalen
+         * @returns {Promise<Buf>}
+         *
+         * @memberof Buf
+         */
         set(data: Buffer, datalen: number): Promise<Buf>;
+        /**
+         *
+         *
+         * @type {string}
+         * @memberof Buf
+         */
         ptr: string;
+        /**
+         *
+         *
+         * @type {number}
+         * @memberof Buf
+         */
         asize: number;
+        /**
+         *
+         *
+         * @type {number}
+         * @memberof Buf
+         */
         size: number;
     }