<refsection>
<title>Description</title>
- <para>Split an edge by creating a new node along an existing edge, modifying the original edge and adding a new edge.</para>
-
-
+ <para>
+Split an edge by creating a new node along an existing edge,
+modifying the original edge and adding a new edge.
+Updates all existing joined edges and relationships accordingly.
+ </para>
+
<!-- use this format if new function -->
<para>Availability: 1.? </para>
<para>Changed: 2.0 - In prior versions, this was misnamed ST_ModEdgesSplit</para>
<para>
Heal two edges by deleting the node connecting them, modifying the first edge
and deleting the second edge.
+Returns the id of the node created that joins the new edges.
+Updates all existing joined edges and relationships accordingly.
</para>
<refsection>
<title>Description</title>
- <para>Split an edge with edge id <varname>anedge</varname> by creating a new node with point location <varname>apoint</varname> along current edge, deleting the original edge and replacing it with two new edges. Returns the id of the new node created that joins the new edges.
- Updates all existing joined edges and relationships with the new ones.</para>
+ <para>
+Split an edge with edge id <varname>anedge</varname> by creating a
+new node with point location <varname>apoint</varname> along current
+edge, deleting the original edge and replacing it with two new edges.
+Returns the id of the new node created that joins the new edges.
+Updates all existing joined edges and relationships accordingly.
+ </para>
+
<para>If the spatial reference system (srid) of the point geometry is not the same as the topology, the <varname>apoint</varname> is not a point geometry, the point is null, the point already exists as a node, the edge does not correspond to an existing edge or the point is not within the edge then an exception is thrown.</para>