--- a/src/common/packet.h Sat Oct 13 15:10:23 2007 -0700
+++ b/src/common/packet.h Sat Oct 13 15:14:00 2007 -0700
@@ -244,6 +244,16 @@
* A packet is allocated a new uid when it is created
* empty or with zero-filled payload.
*
+ * Note: This uid is an internal uid and cannot be counted on to
+ * provide an accurate counter of how many "simulated packets" of a
+ * particular protocol are in the system. It is not trivial to make
+ * this uid into such a counter, because of questions such as what
+ * should the uid be when the packet is sent over broadcast media, or
+ * when fragmentation occurs. If a user wants to trace actual packet
+ * counts, he or she should look at e.g. the IP ID field or transport
+ * sequence numbers, or other packet or frame counters at other
+ * protocol layers.
+ *
* \returns an integer identifier which uniquely
* identifies this packet.
*/