add FIXME comment about changing the name of Pa_GetAvailableHostApis

diff --git a/include/portaudio.h b/include/portaudio.h
index 5f98e1500f7c540c73ae649da585a009af205407..0d72b52f9e348233bf0efa0218a8f37ae22f3c42 100644 (file)
--- a/include/portaudio.h
+++ b/include/portaudio.h
@@ -320,7 +320,10 @@ PaError Pa_SelectHostApis( const PaHostApiTypeId *hostApiTypes, int count );
 */
 PaError Pa_GetSelectedHostApis( PaHostApiTypeId *hostApiTypes, int countAvailable, int *count );
 
-/** Returns the type ids of all available host APIs in initialization order.
+/** Returns the type ids of all compiled-in host APIs in initialization order.
+
+ Note that the compiled-in host APIs are not necessarily those that are
+ installed on the target system.
 
  @param hostApiTypes (IN/OUT) An array that will be filled with
  host API identifiers belonging to the PaHostApiTypeId enumeration.
@@ -329,6 +332,13 @@ PaError Pa_GetSelectedHostApis( PaHostApiTypeId *hostApiTypes, int countAvailabl
 
  @param countAvailable The number of available elements in the hostApiTypes array.
 
+ FIXME REVIEW: Consider a different name for this function, both "available"
+ and "supported" are ambiguous between what is available/supported on the
+ target platform and what is compiled into PA. Keep in mind that
+ Pa_IsFormatSupported refers to formats supported by a device.
+ Proposals:
+ GetConfiguredHostApis, GetCompiledHostApis
+
  @see Pa_SelectHostApis
 */
 PaError Pa_GetAvailableHostApis( PaHostApiTypeId *hostApiTypes, int countAvailable, int *count );