From 8573d01c162d08340275344a3d24d5188b9dbe07 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Miroslav=20Bajto=C5=A1?= <miroslav@strongloop.com>
Date: Tue, 14 Jan 2014 08:07:47 +0100
Subject: [PATCH] Replace `on` with `once` in middleware examples

Fix the jsdox for `app.installMiddleware` to use `app.once` for
listening on 'middleware:*' events.

The previous doc version using `on` was a sort of preliminary
pessimisation, becase the event handlers would stay in the heap
for the whole life-time of the app, even though they won't be called
more than once.
---
 lib/application.js | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/application.js b/lib/application.js
index 426d1e82..c7a19365 100644
--- a/lib/application.js
+++ b/lib/application.js
@@ -451,7 +451,7 @@ function tryReadConfig(cwd, fileName) {
  *
  *    Usage:
  *    ```js
- *    app.on('middleware:preprocessors', function() {
+ *    app.once('middleware:preprocessors', function() {
  *      app.use(loopback.limit('5.5mb'))
  *    });
  *    ```
@@ -461,7 +461,7 @@ function tryReadConfig(cwd, fileName) {
  *
  *    Usage:
  *    ```js
- *    app.on('middleware:handlers', function() {
+ *    app.once('middleware:handlers', function() {
  *      app.use('/admin', adminExpressApp);
  *      app.use('/custom', function(req, res, next) {
  *        res.send(200, { url: req.url });
@@ -483,7 +483,7 @@ function tryReadConfig(cwd, fileName) {
  *    ```js
  *    var bunyan = require('bunyan');
  *    var log = bunyan.createLogger({name: "myapp"});
- *    app.on('middleware:error-loggers', function() {
+ *    app.once('middleware:error-loggers', function() {
  *      app.use(function(err, req, res, next) {
  *        log.error(err);
  *        next(err);