Add note about unique port-name requirement.

git-svn-id: http://subversion.jackaudio.org/jack/jack2/trunk/jackmp@4072 0c269be4-1314-0410-8aa9-9f06e86f4224

ChangeLog

@@ -36,6 +36,7 @@ David Garcia Garzon
 2010-10-29 Stephane Letz  <letz@grame.fr>
 
 	* Correct lsp.c code.
+	* Add note about unique port-name requirement.
 
 2010-09-08 Stephane Letz  <letz@grame.fr>
 

common/jack/jack.h

@@ -625,13 +625,16 @@ float jack_cpu_load (jack_client_t *client) JACK_OPTIONAL_WEAK_EXPORT;
  * name.  Exceeding that will cause the port registration to fail and
  * return NULL.
  *
+ * The @a port_name must be unique among all ports owned by this client.  
+ * If the name is not unique, the registration will fail.  
+ * 
  * All ports have a type, which may be any non-NULL and non-zero
  * length string, passed as an argument.  Some port types are built
  * into the JACK API, currently only JACK_DEFAULT_AUDIO_TYPE.
  *
  * @param client pointer to JACK client structure.
  * @param port_name non-empty short name for the new port (not
- * including the leading @a "client_name:").
+ * including the leading @a "client_name:"). Must be unique. 
  * @param port_type port type name.  If longer than
  * jack_port_type_size(), only that many characters are significant.
  * @param flags @ref JackPortFlags bit mask.