Deduplicate indexed record entries in the HDF5 docs

There are multiple PVs that are instantiated up to 9 dimensions. Instead
of listing them exhaustively, document them once with an N variable as
done with NDArraySize parameter. This makes the documentation less
bloated and easier to add more such PVs in a concise and less
error-prone way.

Improving the way such collapsed table entries are documented is
out-of-the-scope of this patch, and it will be dealt with in future
changes.

While here, correct "posIndexDim" record names to use uppercase 'P'.

Author: henriquesimoes

docs/ADCore/NDFileHDF5.rst

@@ -751,45 +751,9 @@ Parameters and Records
     - longout, longin
   * - asynInt32
     - r/w
-    - Size of extra dimension 3
-    - HDF5_extraDimSize3
-    - $(P)$(R)ExtraDimSize3, $(P)$(R)ExtraDimSize3_RBV
-    - longout, longin
-  * - asynInt32
-    - r/w
-    - Size of extra dimension 4
-    - HDF5_extraDimSize4
-    - $(P)$(R)ExtraDimSize4, $(P)$(R)ExtraDimSize4_RBV
-    - longout, longin
-  * - asynInt32
-    - r/w
-    - Size of extra dimension 5
-    - HDF5_extraDimSize5
-    - $(P)$(R)ExtraDimSize5, $(P)$(R)ExtraDimSize5_RBV
-    - longout, longin
-  * - asynInt32
-    - r/w
-    - Size of extra dimension 6
-    - HDF5_extraDimSize6
-    - $(P)$(R)ExtraDimSize6, $(P)$(R)ExtraDimSize6_RBV
-    - longout, longin
-  * - asynInt32
-    - r/w
-    - Size of extra dimension 7
-    - HDF5_extraDimSize7
-    - $(P)$(R)ExtraDimSize7, $(P)$(R)ExtraDimSize7_RBV
-    - longout, longin
-  * - asynInt32
-    - r/w
-    - Size of extra dimension 8
-    - HDF5_extraDimSize8
-    - $(P)$(R)ExtraDimSize8, $(P)$(R)ExtraDimSize8_RBV
-    - longout, longin
-  * - asynInt32
-    - r/w
-    - Size of extra dimension 9
-    - HDF5_extraDimSize9
-    - $(P)$(R)ExtraDimSize9, $(P)$(R)ExtraDimSize9_RBV
+    - Size of the N'th extra dimension, for N in [3..9]
+    - HDF5_extraDimSize[N]
+    - $(P)$(R)ExtraDimSize[N], $(P)$(R)ExtraDimSize[N]_RBV
     - longout, longin
   * -
     -
@@ -820,45 +784,9 @@ Parameters and Records
     - stringout, stringin
   * - asynOctet
     - r/w
-    - Specify the NDAttribute name for the 3rd index
-    - HDF5_posNameDim3
-    - $(P)$(R)PosNameDim3, $(P)$(R)PosNameDim3_RBV
-    - stringout, stringin
-  * - asynOctet
-    - r/w
-    - Specify the NDAttribute name for the 4th index
-    - HDF5_posNameDim4
-    - $(P)$(R)PosNameDim4, $(P)$(R)PosNameDim4_RBV
-    - stringout, stringin
-  * - asynOctet
-    - r/w
-    - Specify the NDAttribute name for the 5th index
-    - HDF5_posNameDim5
-    - $(P)$(R)PosNameDim5, $(P)$(R)PosNameDim5_RBV
-    - stringout, stringin
-  * - asynOctet
-    - r/w
-    - Specify the NDAttribute name for the 6th index
-    - HDF5_posNameDim6
-    - $(P)$(R)PosNameDim6, $(P)$(R)PosNameDim6_RBV
-    - stringout, stringin
-  * - asynOctet
-    - r/w
-    - Specify the NDAttribute name for the 7th index
-    - HDF5_posNameDim7
-    - $(P)$(R)PosNameDim7, $(P)$(R)PosNameDim7_RBV
-    - stringout, stringin
-  * - asynOctet
-    - r/w
-    - Specify the NDAttribute name for the 8th index
-    - HDF5_posNameDim8
-    - $(P)$(R)PosNameDim8, $(P)$(R)PosNameDim8_RBV
-    - stringout, stringin
-  * - asynOctet
-    - r/w
-    - Specify the NDAttribute name for the 9th index
-    - HDF5_posNameDim9
-    - $(P)$(R)PosNameDim9, $(P)$(R)PosNameDim9_RBV
+    - Specify the NDAttribute name for the N'th index, for N in [3..9]
+    - HDF5_posNameDim[N]
+    - $(P)$(R)PosNameDim[N], $(P)$(R)PosNameDim[N]_RBV
     - stringout, stringin
   * -
     -
@@ -873,55 +801,19 @@ Parameters and Records
     - r/w
     - Specify the NDAttribute index for the X dimension
     - HDF5_posIndexDimX
-    - $(P)$(R)posIndexDimX, $(P)$(R)posIndexDimX_RBV
+    - $(P)$(R)PosIndexDimX, $(P)$(R)PosIndexDimX_RBV
     - stringout, stringin
   * - asynOctet
     - r/w
     - Specify the NDAttribute index for the Y dimension
     - HDF5_posIndexDimY
-    - $(P)$(R)posIndexDimY, $(P)$(R)posIndexDimY_RBV
-    - stringout, stringin
-  * - asynOctet
-    - r/w
-    - Specify the NDAttribute index for the 3rd dimension
-    - HDF5_posIndexDim3
-    - $(P)$(R)posIndexDim3, $(P)$(R)posIndexDim3_RBV
-    - stringout, stringin
-  * - asynOctet
-    - r/w
-    - Specify the NDAttribute index for the 4th dimension
-    - HDF5_posIndexDim4
-    - $(P)$(R)posIndexDim4, $(P)$(R)posIndexDim4_RBV
-    - stringout, stringin
-  * - asynOctet
-    - r/w
-    - Specify the NDAttribute index for the 5th dimension
-    - HDF5_posIndexDim5
-    - $(P)$(R)posIndexDim5, $(P)$(R)posIndexDim5_RBV
-    - stringout, stringin
-  * - asynOctet
-    - r/w
-    - Specify the NDAttribute index for the 6th dimension
-    - HDF5_posIndexDim6
-    - $(P)$(R)posIndexDim6, $(P)$(R)posIndexDim6_RBV
-    - stringout, stringin
-  * - asynOctet
-    - r/w
-    - Specify the NDAttribute index for the 7th dimension
-    - HDF5_posIndexDim7
-    - $(P)$(R)posIndexDim7, $(P)$(R)posIndexDim7_RBV
-    - stringout, stringin
-  * - asynOctet
-    - r/w
-    - Specify the NDAttribute index for the 8th dimension
-    - HDF5_posIndexDim8
-    - $(P)$(R)posIndexDim8, $(P)$(R)posIndexDim8_RBV
+    - $(P)$(R)PosIndexDimY, $(P)$(R)PosIndexDimY_RBV
     - stringout, stringin
   * - asynOctet
     - r/w
-    - Specify the NDAttribute index for the 9th dimension
-    - HDF5_posIndexDim9
-    - $(P)$(R)posIndexDim9, $(P)$(R)posIndexDim9_RBV
+    - Specify the NDAttribute index for the N'th dimension, for N in [3..9]
+    - HDF5_posIndexDim[N]
+    - $(P)$(R)PosIndexDim[N], $(P)$(R)PosIndexDim[N]_RBV
     - stringout, stringin
   * -
     -