other hand if you want to retrieve an integer array and only one of the
 values seems to be no integer (according to strtoul(3)), the return value is
 -1 and the content of the supplied array (valueia in our example) is undefined.
+  Be aware of the fact that there is a magic border for the number of array
+elements that can be transferred at once. This is PARAM_MAX_ARRAY_LEN and
+currently set to 128.
   Take also care of what kind of pointer type you have to supply in the
 different value fields:
 - Param_getString() needs a char *,
 - The treatment of values out of bounds (e.g. strings longer than the foreseen
   PARAM_MAX_NAME_LEN and PARAM_MAX_VALUE_LEN) is not checked in the testsuite
   yet.
+- EPICS has a much more strict limitation on the length of PV names (28
+  including the prefix 'HAD:PARAM:'). So the full length of 127 + 127
+  characters for name + idx cannot be used when including a libcaParam.a in the
+  data path. Also libfileParam.a only supports an overall length of 127 for the
+  string s when s is produced via sprintf(s, "%s(%s%d)", name, idx, i).
 - As a fifth data type, blobs (binary large objects) should be supported in the
   future.