fixes #25263; provides a new switch mangle:nim/cpp for debug name mangling (#25264)

fixes #25263

- [x] documentation and changelogs

tests/codegen/titaniummangle.nim

@@ -1,6 +1,6 @@
 discard """
-  targets: "c"
-  matrix: "--debugger:native"
+  targets: "c cpp"
+  matrix: "--debugger:native --mangle:cpp"
   ccodecheck: "'_ZN14titaniummangle8testFuncE'"
   ccodecheck: "'_ZN14titaniummangle8testFuncE6stringN14titaniummangle3FooE'"
   ccodecheck: "'_ZN14titaniummangle8testFuncE3int7varargsI6stringE'"

tests/codegen/titaniummangle_nim.nim

@@ -0,0 +1,199 @@
+discard """
+  targets: "c"
+  matrix: "--debugger:native --mangle:nim; --debugger:native"
+  ccodecheck: "'testFunc__titaniummangle95nim_u1316'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u156'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u1305'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u241'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u1357'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u292'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u38'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u175'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u1302'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u1305'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u535'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u1294'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u336'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u425'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u308'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u129'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u320'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u223'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u545'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u543'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u895'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u1104'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u1155'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u636'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u705'"
+  ccodecheck: "'testFunc__titaniummangle95nim_u800'"
+  ccodecheck: "'new__titaniummangle95nim_u1320'"
+  ccodecheck: "'xxx__titaniummangle95nim_u1391'"
+  ccodecheck: "'xxx__titaniummangle95nim_u1394'"
+"""
+
+#When debugging this notice that if one check fails, it can be due to any of the above.
+
+type
+  Comparable = concept x, y
+    (x < y) is bool
+
+  Foo = object
+    a: int32
+    b: int32
+
+  FooTuple = tuple
+    a: int
+    b: int
+
+  Container[T] = object
+    data: T
+      
+  Container2[T, T2] = object
+    data: T
+    data2: T2
+
+  Boo = distinct Foo
+
+  Coo = Foo
+
+  Doo = Boo | Foo 
+
+  TestProc = proc(a:string): string
+
+type EnumSample = enum
+  a, b, c
+
+type EnumAnotherSample = enum
+  a, b, c
+
+proc testFunc(a: set[EnumSample]) = 
+  echo $a
+
+proc testFunc(a: typedesc) = 
+  echo $a
+
+proc testFunc(a: ptr Foo) = 
+  echo repr a
+
+proc testFunc(s: string, a: Coo) = 
+  echo repr a
+
+proc testFunc(s: int, a: Comparable) = 
+  echo repr a
+
+proc testFunc(a: TestProc) = 
+  let b = ""
+  echo repr a("")
+
+proc testFunc(a: ref Foo) = 
+  echo repr a
+
+proc testFunc(b: Boo) = 
+  echo repr b
+
+proc testFunc(a: ptr UncheckedArray[int]) = 
+  echo repr a
+
+proc testFunc(a: ptr int) = 
+  echo repr a
+
+proc testFunc(a: ptr ptr int) = 
+  echo repr a
+
+proc testFunc(e: FooTuple, str: cstring) = 
+  echo e
+
+proc testFunc(e: (float, float)) = 
+  echo e
+
+proc testFunc(e: EnumSample) = 
+  echo e
+
+proc testFunc(e: var int) = 
+  echo e
+
+proc testFunc(e: var Foo, a, b: int32, refFoo: ref Foo) = 
+  echo e
+
+proc testFunc(xs: Container[int]) = 
+  let a = 2
+  echo xs
+
+proc testFunc(xs: Container2[int32, int32]) = 
+  let a = 2
+  echo xs
+
+proc testFunc(xs: Container[Container2[int32, int32]]) = 
+  let a = 2
+  echo xs
+
+proc testFunc(xs: seq[int]) = 
+  let a = 2
+  echo xs
+
+proc testFunc(xs: openArray[string]) = 
+  let a = 2
+  echo xs
+
+proc testFunc(xs: array[2, int]) = 
+  let a = 2
+  echo xs
+
+proc testFunc(e: EnumAnotherSample) = 
+  echo e
+
+proc testFunc(a, b: int) = 
+  echo "hola"
+  discard
+
+proc testFunc(a: int, xs: varargs[string]) = 
+  let a = 10
+  for x in xs:
+    echo x
+
+proc xxx(v: static int) =
+  echo v
+
+proc testFunc() = 
+  var a = 2
+  var aPtr = a.addr
+  var foo = Foo()
+  let refFoo : ref Foo = new(Foo)
+  let b = Foo().Boo()
+  let d: Doo = Foo()
+  testFunc("", Coo())
+  testFunc(1, )
+  testFunc(b)
+  testFunc(EnumAnotherSample)
+  var t = [1, 2]
+  let uArr = cast[ptr UncheckedArray[int]](t.addr)
+  testFunc(uArr)
+  testFunc({})
+  testFunc(proc(s:string): string = "test")
+  testFunc(20, a.int32)
+  testFunc(20, 2)
+  testFunc(EnumSample.c)
+  testFunc(EnumAnotherSample.c)
+  testFunc((2, 1), "adios")
+  testFunc((22.1, 1.2))
+  testFunc(a.addr)
+  testFunc(foo.addr)
+  testFunc(aPtr.addr)
+  testFunc(refFoo)
+  testFunc(foo, 2, 1, refFoo)
+  testFunc(a)
+  testFunc(@[2, 1, 2])
+  testFunc(@["hola"])
+  testFunc(2, "hola", "adios")
+  let arr: array[2, int] = [2, 1]
+  testFunc(arr)
+  testFunc(Container[int](data: 10))
+  let c2 = Container2[int32, int32](data: 10, data2: 20)
+  testFunc(c2)
+  testFunc(Container[Container2[int32, int32]](data: c2))
+  xxx(10)
+  xxx(20)
+
+
+testFunc()