<refnamediv>
<refname>ST_AddEdgeNewFaces</refname>
- <refpurpose>Add a new edge and, if in doing so it splits a face, delete the original face and replace it with two new faces. (NOT YET IMPLEMENTED)</refpurpose>
+ <refpurpose>Add a new edge and, if in doing so it splits a face, delete the original face and replace it with two new faces.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<refsection>
<title>Description</title>
- <para>Add a new edge and, if in doing so it splits a face, delete the original face and replace it with two new faces.</para>
- <para>If any arguments are null (meaning the nodes must already exist in the <varname>node</varname> table of the topology schema) ,
+ <para>
+Add a new edge and, if in doing so it splits a face, delete the original
+face and replace it with two new faces.
+Updates all existing joined edges and relationships accordingly.
+ </para>
+ <para>If any arguments are null, the given nodes are unknown (must already exist in the <varname>node</varname> table of the topology schema) ,
the <varname>acurve</varname> is not a <varname>LINESTRING</varname>, the <varname>anode</varname> and <varname>anothernode</varname> are not the start
and endpoints of <varname>acurve</varname> then an error is thrown.</para>
<para>If the spatial reference system (srid) of the <varname>acurve</varname> geometry is not the same as the topology an exception is thrown.</para>
<note><para>This is not completely implemented yet and currently always throws a NOT YET IMPLEMENTED error</para></note>
<!-- use this format if new function -->
- <para>Availability: 1.? </para>
+ <para>Availability: 2.0 </para>
<para>&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.12</para>
</refsection>