pgRouting · cvvergara · Apr 25, 2025 · Apr 21, 2025 · Apr 25, 2025 · Apr 25, 2025
diff --git a/NEWS.md b/NEWS.md
diff --git a/doc/src/proposed.rst b/doc/src/proposed.rst
@@ -80,12 +80,6 @@ Proposed Functions
    :start-after: official-start
    :end-before: official-end
 
-.. rubric:: Utilities
-
-.. include:: topology-functions.rst
-   :start-after: utility_proposed-start
-   :end-before: utility_proposed-end
-
 .. toctree::
    :hidden:
 

diff --git a/doc/src/release_notes.rst b/doc/src/release_notes.rst
@@ -45,12 +45,7 @@ milestone for 3.8.0
 
 .. rubric:: Promotion to official function of pgRouting.
 
-* `#2772 <https://github.com/pgRouting/pgrouting/issues/2772>`__:
-  Promoted to official pgr_extractVertices in version 3.8
-
-  .. include:: pgr_extractVertices.rst
-     :start-after: Version 3.8.0
-     :end-before: .. rubric
+.. rubric:: Metric
 
 * `#2760 <https://github.com/pgRouting/pgrouting/issues/2760>`__:
   Promoted to official pgr_degree in version 3.8
@@ -59,30 +54,53 @@ milestone for 3.8.0
      :start-after: Version 3.8.0
      :end-before: .. rubric
 
+.. rubric:: Utilities
+
+* `#2772 <https://github.com/pgRouting/pgrouting/issues/2772>`__:
+  Promoted to official pgr_extractVertices in version 3.8
+
+  .. include:: pgr_extractVertices.rst
+     :start-after: Version 3.8.0
+     :end-before: .. rubric
+
 * `#2774 <https://github.com/pgRouting/pgrouting/issues/2774>`__:
   Promoted to official pgr_findCloseEdges in version 3.8
 
   .. include:: pgr_findCloseEdges.rst
      :start-after: Version 3.8.0
      :end-before: .. rubric
 
+* `#2873 <https://github.com/pgRouting/pgrouting/issues/2873>`__:
+  Promoted to official pgr_separateCrossing in version 3.8
+
+  .. include:: pgr_separateCrossing.rst
+     :start-after: Version 3.8.0
+     :end-before: Description
+
+* `#2874 <https://github.com/pgRouting/pgrouting/issues/2874>`__:
+  Promoted to official pgr_separateTouching in version 3.8
+
+  .. include:: pgr_separateTouching.rst
+     :start-after: Version 3.8.0
+     :end-before: Description
+
 .. rubric:: Proposed functions
 
-* Contraction
+.. rubric:: Contraction
 
-  * `#2790 <https://github.com/pgRouting/pgrouting/issues/2790>`__:
-    pgr_contractionDeadEnd new contraction function
-  * `#2791 <https://github.com/pgRouting/pgrouting/issues/2791>`__:
-    pgr_contractionLinear new contraction function
-  * `#2536 <https://github.com/pgRouting/pgrouting/issues/2536>`__:
-    Support for contraction hierarchies (pgr_contractionHierarchies)
+* `#2790 <https://github.com/pgRouting/pgrouting/issues/2790>`__:
+  pgr_contractionDeadEnd new contraction function
+* `#2791 <https://github.com/pgRouting/pgrouting/issues/2791>`__:
+  pgr_contractionLinear new contraction function
+* `#2536 <https://github.com/pgRouting/pgrouting/issues/2536>`__:
+  Support for contraction hierarchies (pgr_contractionHierarchies)
 
-* Utilities
+.. rubric:: Utilities
 
-  * `#2848 <https://github.com/pgRouting/pgrouting/issues/2848>`__:
-    Create pgr_separateCrossing new utility function
-  * `#2849 <https://github.com/pgRouting/pgrouting/issues/2849>`__:
-    Create of pgr_separateTouching new utility function
+* `#2848 <https://github.com/pgRouting/pgrouting/issues/2848>`__:
+  Create pgr_separateCrossing new utility function
+* `#2849 <https://github.com/pgRouting/pgrouting/issues/2849>`__:
+  Create of pgr_separateTouching new utility function
 
 .. rubric:: Official functions changes
 

diff --git a/doc/topology/topology-functions.rst b/doc/topology/topology-functions.rst
@@ -49,20 +49,15 @@ Utility functions
 - :doc:`pgr_extractVertices` - Extracts vertex information based on the edge
   table information.
 - :doc:`pgr_findCloseEdges` - Finds close edges of points on the fly
+- :doc:`pgr_separateCrossing` - Breaks geometries that cross each other.
+- :doc:`pgr_separateTouching` - Breaks geometries that (almost) touch each other.
 
 .. utility_official-end
 
 .. include:: proposed.rst
    :start-after: warning-begin
    :end-before: end-warning
 
-.. utility_proposed-start
-
-- :doc:`pgr_separateCrossing` - Breaks geometries that cross each other.
-- :doc:`pgr_separateTouching` - Breaks geometries that (almost) touch each other.
-
-.. utility_proposed-end
-
 .. toctree::
   :hidden:
 

diff --git a/doc/utilities/pgr_separateCrossing.rst b/doc/utilities/pgr_separateCrossing.rst
@@ -8,8 +8,8 @@
    ****************************************************************************
 
 .. index::
-   single: Utilities ; pgr_separateCrossing - proposed on v3.8.0
-   single: separateCrossing - proposed on v3.8.0
+   single: Utilities ; pgr_separateCrossing
+   single: separateCrossing
 
 |
 
@@ -23,7 +23,8 @@ do not cross.
 
 .. rubric:: Version 3.8.0
 
-* New proposed function.
+* Function promoted to official.
+* Proposed function.
 
 Description
 -------------------------------------------------------------------------------

diff --git a/doc/utilities/pgr_separateTouching.rst b/doc/utilities/pgr_separateTouching.rst
@@ -8,8 +8,8 @@
    ****************************************************************************
 
 .. index::
-   single: Utilities ; pgr_separateTouching - proposed on v3.8.0
-   single: separateTouching - proposed on v3.8.0
+   single: Utilities ; pgr_separateTouching
+   single: separateTouching
 
 |
 
@@ -23,7 +23,8 @@ are properly connected at endpoints
 
 .. rubric:: Version 3.8.0
 
-* New proposed function.
+* Function promoted to official.
+* Proposed function.
 
 Description
 -------------------------------------------------------------------------------

diff --git a/locale/en/LC_MESSAGES/pgrouting_doc_strings.po b/locale/en/LC_MESSAGES/pgrouting_doc_strings.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: pgRouting v3.8\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-04-25 02:02+0000\n"
+"POT-Creation-Date: 2025-04-25 15:15+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <[email protected]>\n"
@@ -3893,6 +3893,14 @@ msgstr ""
 msgid ":doc:`pgr_findCloseEdges` - Finds close edges of points on the fly"
 msgstr ""
 
+msgid ":doc:`pgr_separateCrossing` - Breaks geometries that cross each other."
+msgstr ""
+
+msgid ""
+":doc:`pgr_separateTouching` - Breaks geometries that (almost) touch each "
+"other."
+msgstr ""
+
 msgid "Functions by categories"
 msgstr ""
 
@@ -3942,23 +3950,26 @@ msgstr ""
 msgid "Promotion to official function of pgRouting."
 msgstr ""
 
+msgid "Metric"
+msgstr ""
+
 msgid ""
-"`#2772 <https://github.com/pgRouting/pgrouting/issues/2772>`__: Promoted "
-"to official pgr_extractVertices in version 3.8"
+"`#2760 <https://github.com/pgRouting/pgrouting/issues/2760>`__: Promoted "
+"to official pgr_degree in version 3.8"
 msgstr ""
 
 msgid "Error messages adjustment."
 msgstr ""
 
-msgid "Function promoted to official."
+msgid "New signature with only Edges SQL."
 msgstr ""
 
-msgid ""
-"`#2760 <https://github.com/pgRouting/pgrouting/issues/2760>`__: Promoted "
-"to official pgr_degree in version 3.8"
+msgid "Function promoted to official."
 msgstr ""
 
-msgid "New signature with only Edges SQL."
+msgid ""
+"`#2772 <https://github.com/pgRouting/pgrouting/issues/2772>`__: Promoted "
+"to official pgr_extractVertices in version 3.8"
 msgstr ""
 
 msgid ""
@@ -3969,6 +3980,19 @@ msgstr ""
 msgid "``partial`` option is removed."
 msgstr ""
 
+msgid ""
+"`#2873 <https://github.com/pgRouting/pgrouting/issues/2873>`__: Promoted "
+"to official pgr_separateCrossing in version 3.8"
+msgstr ""
+
+msgid "Proposed function."
+msgstr ""
+
+msgid ""
+"`#2874 <https://github.com/pgRouting/pgrouting/issues/2874>`__: Promoted "
+"to official pgr_separateTouching in version 3.8"
+msgstr ""
+
 msgid "Proposed functions"
 msgstr ""
 
@@ -15793,14 +15817,6 @@ msgid ""
 "Graph."
 msgstr ""
 
-msgid ":doc:`pgr_separateCrossing` - Breaks geometries that cross each other."
-msgstr ""
-
-msgid ""
-":doc:`pgr_separateTouching` - Breaks geometries that (almost) touch each "
-"other."
-msgstr ""
-
 msgid ":doc:`withPoints-family` - Functions based on Dijkstra algorithm."
 msgstr ""
 

diff --git a/locale/pot/pgrouting_doc_strings.pot b/locale/pot/pgrouting_doc_strings.pot
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: pgRouting v3.8\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-04-25 02:02+0000\n"
+"POT-Creation-Date: 2025-04-25 15:15+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <[email protected]>\n"
@@ -3490,6 +3490,12 @@ msgstr ""
 msgid ":doc:`pgr_findCloseEdges` - Finds close edges of points on the fly"
 msgstr ""
 
+msgid ":doc:`pgr_separateCrossing` - Breaks geometries that cross each other."
+msgstr ""
+
+msgid ":doc:`pgr_separateTouching` - Breaks geometries that (almost) touch each other."
+msgstr ""
+
 msgid "Functions by categories"
 msgstr ""
 
@@ -3535,19 +3541,22 @@ msgstr ""
 msgid "Promotion to official function of pgRouting."
 msgstr ""
 
-msgid "`#2772 <https://github.com/pgRouting/pgrouting/issues/2772>`__: Promoted to official pgr_extractVertices in version 3.8"
+msgid "Metric"
+msgstr ""
+
+msgid "`#2760 <https://github.com/pgRouting/pgrouting/issues/2760>`__: Promoted to official pgr_degree in version 3.8"
 msgstr ""
 
 msgid "Error messages adjustment."
 msgstr ""
 
-msgid "Function promoted to official."
+msgid "New signature with only Edges SQL."
 msgstr ""
 
-msgid "`#2760 <https://github.com/pgRouting/pgrouting/issues/2760>`__: Promoted to official pgr_degree in version 3.8"
+msgid "Function promoted to official."
 msgstr ""
 
-msgid "New signature with only Edges SQL."
+msgid "`#2772 <https://github.com/pgRouting/pgrouting/issues/2772>`__: Promoted to official pgr_extractVertices in version 3.8"
 msgstr ""
 
 msgid "`#2774 <https://github.com/pgRouting/pgrouting/issues/2774>`__: Promoted to official pgr_findCloseEdges in version 3.8"
@@ -3556,6 +3565,15 @@ msgstr ""
 msgid "``partial`` option is removed."
 msgstr ""
 
+msgid "`#2873 <https://github.com/pgRouting/pgrouting/issues/2873>`__: Promoted to official pgr_separateCrossing in version 3.8"
+msgstr ""
+
+msgid "Proposed function."
+msgstr ""
+
+msgid "`#2874 <https://github.com/pgRouting/pgrouting/issues/2874>`__: Promoted to official pgr_separateTouching in version 3.8"
+msgstr ""
+
 msgid "Proposed functions"
 msgstr ""
 
@@ -13249,12 +13267,6 @@ msgstr ""
 msgid ":doc:`pgr_lineGraph` - Transformation algorithm for generating a Line Graph."
 msgstr ""
 
-msgid ":doc:`pgr_separateCrossing` - Breaks geometries that cross each other."
-msgstr ""
-
-msgid ":doc:`pgr_separateTouching` - Breaks geometries that (almost) touch each other."
-msgstr ""
-
 msgid ":doc:`withPoints-family` - Functions based on Dijkstra algorithm."
 msgstr ""
 

diff --git a/sql/utilities/separateCrossing.sql b/sql/utilities/separateCrossing.sql
@@ -112,7 +112,6 @@ $BODY$ LANGUAGE 'plpgsql' VOLATILE STRICT;
 -- COMMENTS
 COMMENT ON FUNCTION pgr_separateCrossing(TEXT, FLOAT, BOOLEAN)
 IS 'pgr_separateCrossing
-PROPOSED
 - Parameters
   - Edges SQL with columns: id, geom
 - Optional parameters