Breakup and improve PMP's documentation

[MaelRL]

Summary of Changes

With the years and the additions to the package "Polygon Mesh Processing" (PMP), the user and reference manuals have grown overly large, making it difficult to find information.

This PR splits the documentation of PMP into four (three new) packages:

• PMP (core): essential functions, ranging from simple geometric functions to distance functions, feature detection etc.
• Boolean Operations on Meshes: Corefinement, autorefinement, clipping, splitting, slicing, [upcoming kernel ?]
• Meshing and Remeshing of Polygon Meshes: combinatorial and geometric, local and global meshing and remeshing.
• Polygon Mesh Repair: detection and treatment of defects in polygon meshes

TODO:

• Update usages of now deprecated PMP border.h (moved to BGL)
• Test deprecated border.h
• Fix "Topics" order
• Dispatch functions and doc coming from:
  • [PMP] Approximate convex decomposition #8935
  • Add functions to compute the kernel of a triangle mesh #9131
• Move .h but keep include/CGAL/PMP

Tentative TODO:

• Update some package icons?

Release Management

Integrate after :

• [PMP] Approximate convex decomposition #8935
• Add functions to compute the kernel of a triangle mesh #9131

• Affected package(s): PMP
• Issue(s) solved (if any):
• Feature/Small Feature (if any): PMP_doc_breakup
• Link to compiled documentation (obligatory for small feature) wrong link name to be changed
• License and copyright ownership: no change

[github-actions]

The documentation is built. It will be available, after a few minutes, here: https://cgal.github.io/9286/v0/Manual/index.html

[janetournois]

A few comments and one more question
For functions moved from namespace CGAL::PMP to namespace CGAL, are we going through a "deprecated" period, or a direct breaking change?

[MaelRL]

A few comments and one more question For functions moved from namespace CGAL::PMP to namespace CGAL, are we going through a "deprecated" period, or a direct breaking change?

PMP/border.h was moved to border.h in BGL, and the PMP functions are deprecated (it's in PMP "Core").