docs: attribute the vendored third-party code

src/smda/common/labelprovider/rust_demangler/ is vendored third-party
code and carries no attribution. The commit that introduced it says so
directly -- it vendors the rust_demangler package by Team bi0s, MIT
licensed, with robustness behaviour reimplemented from Ghidra, which is
Apache-2.0. Neither is recorded: LICENSE covers only this project's own
BSD 2-Clause, there is no NOTICE, and the package has no header. The MIT
licence asks that its copyright and permission notice travel with copies
and substantial portions, and this code is redistributed in the wheel
published to PyPI.

Add a NOTICE carrying the MIT copyright line and permission text and a
pointer to Apache-2.0 for the Ghidra-derived parts, a docstring on the
vendored package pointing at it, and a line in the README credits.

The in-code comments this attribution was drawn from named "Ghidra's
rust-demangle.c", and no such file exists: Ghidra's Rust demanglers are
Java, at Ghidra/Features/Rust/src/main/java/ghidra/app/plugin/core/
analysis/rust/demangler/RustDemanglerV0.java and RustDemanglerLegacy.java.
Name those instead, in the NOTICE and in the two comments that were the
source of the error, and record that Ghidra's own V0 demangler is a port
of the rustc-demangle crate, which is the real upstream of the behaviour.

The NOTICE lists every vendored component rather than only the one that
prompted it, so Tarjan.py and DominatorTree.py -- both already credited
in the README paragraph the new line joins -- appear alongside it.

No pyproject change is needed: setuptools' default license-file glob
already matches NOTICE*, and a build confirms it reaches both the wheel
(dist-info/licenses/NOTICE) and the sdist.

Author: r0ny123

NOTICE

@@ -0,0 +1,64 @@
+SMDA
+Copyright (c) 2018-2020, Daniel Plohmann and Steffen Enders
+
+This product is licensed under the BSD 2-Clause License; see LICENSE.
+
+It includes third-party code, listed below with the notices its license
+requires.
+
+================================================================================
+rust_demangler
+--------------------------------------------------------------------------------
+src/smda/common/labelprovider/rust_demangler/ is derived from the rust_demangler
+package by Team bi0s (https://github.com/teambi0s/rust_demangler), used under the
+MIT License and modified for use here.
+
+MIT License
+
+Copyright (c) 2021 Team bi0s
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+================================================================================
+Ghidra
+--------------------------------------------------------------------------------
+Parts of the same directory reimplement behaviour from Ghidra's Rust demanglers
+(https://github.com/NationalSecurityAgency/ghidra), specifically
+Ghidra/Features/Rust/src/main/java/ghidra/app/plugin/core/analysis/rust/demangler/
+RustDemanglerV0.java and RustDemanglerLegacy.java: the recursion bound in the v0
+demangler and the strict hash handling in the legacy demangler. Ghidra is
+licensed under the Apache License, Version 2.0, available at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Ghidra's own V0 demangler is a port of the rustc-demangle crate
+(https://github.com/rust-lang/rustc-demangle), dual-licensed Apache-2.0 OR MIT.
+
+================================================================================
+Tarjan's algorithm
+--------------------------------------------------------------------------------
+src/smda/common/Tarjan.py is based on the implementation by Bas Westerbaan
+(https://github.com/bwesterb/py-tarjan), refactored into a class for pooled
+computation.
+
+================================================================================
+Lengauer-Tarjan dominator tree
+--------------------------------------------------------------------------------
+src/smda/common/DominatorTree.py is based on the implementation by Armin Rigo
+(https://bitbucket.org/arigo/arigo/src/default/hack/pypy-hack/heapstats/dominator.py).

README.md

@@ -197,6 +197,7 @@ Thanks to Jonathan Crussell for helping me to beef up SMDA enough to make it a d
 Thanks to Willi Ballenthin for improving the handling of ELF files, including properly handling API usage!
 Thanks to Daniel Enders for his contributions to the parsing of the Golang function registry and label information!
 The project uses the implementation of Tarjan's Algorithm by Bas Westerbaan and the implementation of Lengauer-Tarjan's Algorithm for the DominatorTree by Armin Rigo.
+Rust symbol demangling is derived from the rust_demangler package by Team bi0s (MIT), with behaviour reimplemented from Ghidra's Rust demanglers (Apache-2.0); see [NOTICE](NOTICE) for the full list of third-party components.
 Thanks to r0ny123 for his major code quality improvements via ruff and various contributions for several aspects of this project!
 
 Pull requests welcome! :)

src/smda/common/labelprovider/rust_demangler/__init__.py

@@ -1,3 +1,7 @@
+"""Rust symbol demangling, derived from Team bi0s' rust_demangler (MIT) with
+behaviour reimplemented from Ghidra's Rust demanglers. See NOTICE.
+"""
+
 from .main import demangle
 
 __all__ = ["demangle"]

src/smda/common/labelprovider/rust_demangler/rust_legacy.py

@@ -146,7 +146,7 @@ def is_ascii_punctuation(self, c):
         return c in string.punctuation
 
     def is_rust_hash(self, s):
-        # Improved robustness based on Ghidra's rust-demangle.c
+        # Improved robustness based on Ghidra's RustDemanglerLegacy
         # Legacy Rust symbols end with a path segment that encodes a 16 hex digit hash,
         # prefixed with "17h", i.e. '17h[a-f0-9]{16}'.
         if len(s) == 19 and s.startswith("17h"):

src/smda/common/labelprovider/rust_demangler/rust_v0.py

@@ -490,7 +490,7 @@ def skip_const(self):
 
 
 class Printer:
-    # Based on Ghidra's rust-demangle.c, we limit recursion to prevent stack overflows
+    # Following Ghidra's RustDemanglerV0, we limit recursion to prevent stack overflows
     # or excessive resource usage on malformed inputs.
     # Must fire well below CPython's own recursion limit (default 1000), or a
     # self-referential backref chain raises RecursionError before this guard.