Add documentation for WaveformIn and downgrade Waveform to legacy

Also add WaveformIn to default exports from softioc.builder and clarify in
code that Waveform is a legacy name.

Author: Araneidae

docs/reference/api.rst

@@ -322,12 +322,14 @@ All functions return a wrapped `ProcessDeviceSupportIn` or
 
 ..  function::
         Waveform(name, [value,] **fields)
+        WaveformIn(name, [value,] **fields)
         WaveformOut(name, [value,] **fields)
 
-    Create ``waveform`` records.  Depending on whether `Waveform` or
+    Create ``waveform`` records.  Depending on whether `WaveformIn` or
     `WaveformOut` is called the record is configured to behave as an IN or an
     OUT record, in particular `on_update` can only be specified when calling
-    `WaveformOut`.
+    `WaveformOut`.  The name `Waveform` is an alias for `WaveformIn` and exists
+    for largely historical reasons.
 
     If ``value`` is specified or if an `initial_value` is specified (only one of
     these can be used) the value is used to initialise the waveform and to
@@ -519,7 +521,7 @@ direction is confusing) using the following `softioc.builder` methods:
 
     :func:`~softioc.builder.aIn`, :func:`~softioc.builder.boolIn`,
     :func:`~softioc.builder.longIn`, :func:`~softioc.builder.stringIn`,
-    :func:`~softioc.builder.mbbIn`, :func:`~softioc.builder.Waveform`.
+    :func:`~softioc.builder.mbbIn`, :func:`~softioc.builder.WaveformIn`.
 
 Create OUT records for receiving control information into the IOC using the
 following methods:

docs/tutorials/creating-an-ioc.rst

@@ -119,7 +119,7 @@ by calling any of the following PV creation functions:
     :func:`~softioc.builder.longIn`, :func:`~softioc.builder.longOut`,
     :func:`~softioc.builder.stringIn`, :func:`~softioc.builder.stringOut`,
     :func:`~softioc.builder.mbbIn`, :func:`~softioc.builder.mbbOut`,
-    :func:`~softioc.builder.Waveform`, :func:`~softioc.builder.WaveformOut`.
+    :func:`~softioc.builder.WaveformIn`, :func:`~softioc.builder.WaveformOut`.
 
 These functions create, respectively, ``Python`` device bound records of the
 following types:

softioc/builder.py

@@ -231,12 +231,13 @@ def _waveform(value, fields):
     fields['FTVL'] = NumpyDtypeToDbf[datatype.name]
 
 
-def Waveform(name, *value, **fields):
+def WaveformIn(name, *value, **fields):
     _waveform(value, fields)
     _set_in_defaults(fields)
     return PythonDevice.waveform(name, **fields)
 
-WaveformIn = Waveform
+# Legacy name
+Waveform = WaveformIn
 
 def WaveformOut(name, *value, **fields):
     _waveform(value, fields)
@@ -319,7 +320,7 @@ def UnsetDevice():
     'longIn',   'longOut',
     'stringIn', 'stringOut',
     'mbbIn',    'mbbOut',
-    'Waveform', 'WaveformOut',
+    'Waveform', 'WaveformIn', 'WaveformOut',
     'longStringIn', 'longStringOut',
     'Action',
     # Other builder support functions