           return callback(null, clear_notices.concat(notifications))
 
   api.request_deletion = (session, params, callback) ->
+    ###
+    Request deletion.  If the receiving application's policy permits, delete
+    immediately; otherwise, create a DeletionRequest and associated
+    notifications.
+    ###
     unless utils.is_authenticated(session)
       return callback("Permission denied")
     for key in ["group", "application", "entity", "url", "title"]

    update = {}
    for key in ["application", "entity", "type"]
      conditions[key] = params[key]
    for key in ["title", "summary", "text", "url"]
      update[key] = params[key]
    # Avoid updating sharing if not passed explicitly.
    if params.sharing?

                  done(err, event)

              (done) ->
                api.add_search_index si, (err, si) -> done(err, si)

              (done) ->
                handler.trash_entity(session, params, done)
