--- a/netwerk/base/public/nsReadLine.h
+++ b/netwerk/base/public/nsReadLine.h
@@ -9,22 +9,21 @@
 
 #include "nsIInputStream.h"
 #include "mozilla/Likely.h"
 
 /**
  * @file
  * Functions to read complete lines from an input stream.
  *
- * To properly use the helper function in here (NS_ReadLine) the caller
- * needs to declare a pointer to an nsLineBuffer, call
- * NS_InitLineBuffer on it, and pass it to NS_ReadLine every time it
+ * To properly use the helper function in here (NS_ReadLine) the caller should
+ * create a nsLineBuffer<T> with new, and pass it to NS_ReadLine every time it
  * wants a line out.
  *
- * When done, the pointer should be freed using PR_Free.
+ * When done, the object should be deleted.
  */
 
 /**
  * @internal
  * Buffer size. This many bytes will be buffered. If a line is longer than this,
  * the partial line will be appended to the out parameter of NS_ReadLine and the
  * buffer will be emptied.
  * Note: if you change this constant, please update the regression test in