DM-10943: References to TranForward and TranInverse are confusing

include/astshim/Frame.h

@@ -336,8 +336,7 @@ class Frame : public Mapping {
         system found is used. However, the overall Mapping between
         the source and destination coordinate systems is also
         examined.  Preference is given to cases where both the
-        forward and inverse transformations are defined (as indicated
-        by the TranForward and TranInverse attributes). If only one
+        forward and inverse transformations are defined. If only one
         transformation is defined, the forward one is preferred.
         - If the domain of the intermediate coordinate system matches
         the current "domainlist" field, the conversion path is
@@ -558,8 +557,7 @@ class Frame : public Mapping {
             Mapping between the target coordinate system and the
             resulting Frame is also examined. Preference is given to
             cases where both the forward and inverse transformations are
-            defined (as indicated by the TranForward and TranInverse
-            attributes). If only one transformation is defined, the
+            defined. If only one transformation is defined, the
             forward one is preferred.
         - If a match is found and the domain of the resulting Frame also
             matches the current "domainlist" field, it is

include/astshim/FrameSet.h

@@ -301,8 +301,8 @@ class FrameSet : public Frame {
         between the two supplied @ref Frame "Frames", including the specified end frames.
     - It should always be possible to generate the @ref Mapping requested, but this does not
         necessarily guarantee that it will be able to perform the required coordinate conversion.
-        If necessary, the `TranForward` and `TranInverse` attributes of the returned @ref Mapping
-        should be inspected to determine if the required transformation is available.
+        If necessary, call `hasForward` or `hasInverse` on the returned @ref Mapping
+        to determine if the required transformation is available.
     */
     std::shared_ptr<Mapping> getMapping(int ind1 = BASE, int ind2 = CURRENT) const {
         AstObject *rawMap = reinterpret_cast<AstObject *>(astGetMapping(getRawPtr(), ind1, ind2));

include/astshim/LutMap.h

@@ -54,10 +54,8 @@ In addition to those attributes provided by @ref Mapping and @ref Object,
 
 ### Notes
 
-- If the entries in the lookup table either increase or decrease monotonically, then the `LutMap`'s
-    `TranInverse` attribute will have a value of one, indicating that the inverse transformation
-    can be performed. Otherwise, it will have a value of zero, so that any attempt to use
-    the inverse transformation will result in an error.
+- If the entries in the lookup table increase or decrease monotonically, then the LutMap
+    will have an inverse transformation; otherwise it will not.
 */
 class LutMap : public Mapping {
     friend class Object;

include/astshim/MatrixMap.h

@@ -46,8 +46,7 @@ class MatrixMap : public Mapping {
     /**
     Construct a MatrixMap from a 2-d matrix
 
-    @note The inverse transformation (`TranInverse` attribute) will only be available if `matrix`
-    is square and non-singular.
+    @note The inverse transformation will only be available if `matrix` is square and non-singular.
 
     @param[in] matrix  The transformation matrix, where:
                         - The number of input coordinates is the number of columns.
@@ -63,8 +62,7 @@ class MatrixMap : public Mapping {
     /**
     Construct a MatrixMap from a 1-d vector of diagonal elements of a diagonal matrix
 
-    @note The inverse transformation (`TranInverse` attribute) will always be available
-        when constructed from a diagonal matrix.
+    @note The inverse transformation will always be available when constructed from a diagonal matrix.
 
     @param[in] diag  The diagonal elements of a diagonal matrix as a vector;
                         the number of input and output coordinates is the length of the vector.

include/astshim/Stream.h

@@ -164,6 +164,7 @@ class FileStream : public Stream {
 
     virtual ~FileStream() {}
 
+    /// Get the path to the file, as a string
     std::string getPath() const { return _path; }
 
 private: