Deprecate buffer option

HISTORY.md

@@ -5,6 +5,7 @@ unreleased
     - `clf` for the common log format
     - `iso` for the common ISO 8601 date time format
     - `web` for the common RFC 1123 date time format
+  * Deprecate `buffer` option
   * Fix date format in `common` and `combined` formats
   * Fix token arguments to accept values with `"`
 

README.md

@@ -26,11 +26,6 @@ a string of a format string, or a function that will produce a log entry.
 
 Morgan accepts these properties in the options object.
 
-#### buffer
-
-Buffer duration before writing logs to the `stream`, defaults to `false`. When
-set to `true`, defaults to `1000 ms`.
-
 #### immediate
 
 Write log line on request instead of response. This means that a requests will
@@ -103,15 +98,11 @@ The minimal output.
 
 - `:req[header]` ex: `:req[Accept]`
 - `:res[header]` ex: `:res[Content-Length]`
-- `:http-version`
 - `:response-time`
 - `:remote-addr`
 - `:remote-user`
-- `:date[format]`
-- `:method`
 - `:url`
 - `:referrer`
-- `:user-agent`
 - `:status`
 
 ##### Creating new tokens

index.js

@@ -67,12 +67,14 @@ exports = module.exports = function morgan(format, options) {
   // format function
   var fmt = compile(exports[format] || format || exports.default)
 
-  // options
+  // steam
+  var buffer = options.buffer
   var stream = options.stream || process.stdout
-    , buffer = options.buffer;
 
   // buffering support
   if (buffer) {
+    deprecate('buffer option')
+
     var realStream = stream
     var buf = []
     var timer = null