document that initialization order does not predictably determine host api indexes

diff --git a/include/portaudio.h b/include/portaudio.h
index 0d72b52f9e348233bf0efa0218a8f37ae22f3c42..311d0b0cfc7245ef59ba1e4a9fd8ea97f6c733e4 100644 (file)
--- a/include/portaudio.h
+++ b/include/portaudio.h
@@ -293,9 +293,11 @@ typedef enum PaHostApiTypeId
  hostApiTypeIds parameter is not available.
 
  The paInvalidHostApi error indicates that there was a problem with the
- hostApiTypes array. E.g. it contained duplicate entries.
+ hostApiTypes array. E.g. it contained invalid or duplicate entries.
 
  @note The host API initialization order determines default devices.
+ There is no predictable relationship between the order that host APIs appear
+ in hostApiTypes, and their hostApiIndexes assigned by Pa_Initialize().
 
  @see PaHostApiTypeId
 */