adding number of preferences to allow iterating over preferences

[oweals/gnunet.git] / src / include / gnunet_cadet_service.h

diff --git a/src/include/gnunet_cadet_service.h b/src/include/gnunet_cadet_service.h
index 015a59ebf7394207aca60f753498a9635384fecd..6788fc232f5b8e333c9d5b3ca0497601ec4c1e04 100644 (file)
--- a/src/include/gnunet_cadet_service.h
+++ b/src/include/gnunet_cadet_service.h
@@ -1,6 +1,6 @@
 /*
      This file is part of GNUnet.
-     (C) 2009-2014 Christian Grothoff (and other contributing authors)
+     Copyright (C) 2009-2014 Christian Grothoff (and other contributing authors)
 
      GNUnet is free software; you can redistribute it and/or modify
      it under the terms of the GNU General Public License as published
@@ -177,7 +177,8 @@ typedef void *
 
 /**
  * Function called whenever a channel is destroyed.  Should clean up
- * any associated state.
+ * any associated state, including cancelling any pending transmission on this
+ * channel.
  *
  * It must NOT call #GNUNET_CADET_channel_destroy on the channel.
  *
@@ -201,9 +202,9 @@ typedef void
  * @param new_channel Function called when an *incoming* channel is created.
  *                    Can be NULL if no inbound channels are desired.
  *                    See @a ports.
- * @param cleaner Function called when a channel is destroyed by the remote peer.
- *                It is NOT called if #GNUNET_CADET_channel_destroy is called on
- *                the channel.
+ * @param cleaner Function called when a channel is destroyed.
+ *                It is called immediately if #GNUNET_CADET_channel_destroy
+ *                is called on the channel.
  * @param handlers Callbacks for messages we care about, NULL-terminated. Each
  *                 one must call #GNUNET_CADET_receive_done on the channel to
  *                 receive the next message.  Messages of a type that is not