Remove old Polygon1 name from comments

Generic explanations are a better idea here anyway

Author: roystgnr

include/fe/fe.h

@@ -415,8 +415,10 @@ class FE : public FEGenericBase<typename FEOutputType<T>::type>
    *
    * On a p-refined element, \p o should be the total order of the element.
    *
-   * This method does not support all finite element types; e.g. the
-   * Polygon1 type may differ from element to element.
+   * This method does not support all finite element types; e.g. for an
+   * arbitrary polygon or polyhedron type the number of shape
+   * functions may depend on an individual element and not just its
+   * type.
    */
   static unsigned int n_shape_functions (const ElemType t,
                                          const Order o)
@@ -428,8 +430,10 @@ class FE : public FEGenericBase<typename FEOutputType<T>::type>
    *
    * On a p-refined element, \p o should be the total order of the element.
    *
-   * This method does not support all finite element types; e.g. the
-   * Polygon1 type may differ from element to element.
+   * This method does not support all finite element types; e.g. for an
+   * arbitrary polygon or polyhedron type the number of shape
+   * functions may depend on an individual element and not just its
+   * type.
    */
   static unsigned int n_dofs(const ElemType t,
                              const Order o);
@@ -452,8 +456,9 @@ class FE : public FEGenericBase<typename FEOutputType<T>::type>
    *
    * On a p-refined element, \p o should be the total order of the element.
    *
-   * This method does not support all finite element types; e.g. the
-   * Polygon1 type may differ from element to element.
+   * This method does not support all finite element types; e.g. for an
+   * arbitrary polygon or polyhedron type the meaning of a node index
+   * \p n may depend on an individual element and not just its type.
    */
   static unsigned int n_dofs_at_node(const ElemType t,
                                      const Order o,

include/fe/fe_abstract.h

@@ -209,9 +209,10 @@ class FEAbstract : public ReferenceCountedObject<FEAbstract>
    * indicate a tolerance.  For example, \f$ x \le 1 \f$  becomes
    * \f$ x \le 1 + \epsilon \f$.
    *
-   * This method overload is now deprecated, since it cannot support
-   * all finite element types; e.g. the Polygon1 type may differ from
-   * element to element.  Use \p Elem::on_reference_element() instead.
+   * \deprecated This method overload does not support all finite
+   * element types; e.g. the reference element for an arbitrary
+   * polygon or polyhedron type may differ from element to element.
+   * Use \p Elem::on_reference_element() instead.
    */
   static bool on_reference_element(const Point & p,
                                    const ElemType t,

include/fe/fe_interface.h

@@ -346,8 +346,9 @@ class FEInterface
    * \f$ \xi \le 1 \f$ becomes \f$ \xi \le 1 + \epsilon \f$.
    *
    * \deprecated This method overload does not support all finite
-   * element types; e.g. the Polygon1 type may differ from element to
-   * element.  Use \p Elem::on_reference_element() instead.
+   * element types; e.g. the reference element for an arbitrary
+   * polygon or polyhedron type may differ from element to element.
+   * Use \p Elem::on_reference_element() instead.
    */
   static bool on_reference_element(const Point & p,
                                    const ElemType t,