llvm-project.git/llvm/docs/AssignmentTracking.md, branch users/nico/python-2

[NFC] Fix #106873 - update assignment tracking docs (#106959)

2024-09-02T13:57:59+00:00

[RemoveDIs] Update all docs to use debug records (#91768)

2024-06-11T13:16:32+00:00

As we approach the state where support for debug intrinsics is dropping and
we print and use debug records by default, the documentation should be updated
to refer to debug records as the primary debug info representation, with
debug intrinsics being relegated to an optional alternative.

This patch performs a few updates:
- Replace references to intrinsics with references to records across all
the documentation.
- Replace intrinsics with records in code examples.
- Move debug records prior to debug intrinsics in the
SourceLevelDebugging document, and change text to refer to them as the
primary representation.
- Add release notes describing the change.

[DebugInfo][Docs] Remove `dbg.addr` from docs

2023-03-02T09:29:42+00:00

Part of `dbg.addr` removal
Discussed in https://discourse.llvm.org/t/what-is-the-status-of-dbg-addr/62898

Differential Revision: https://reviews.llvm.org/D144792

[Assignment Tracking][NFC] Replace LLVM command line option with a module flag

2023-01-20T14:24:15+00:00

Remove LLVM flag -experimental-assignment-tracking. Assignment tracking is
still enabled from Clang with the command line -Xclang
-fexperimental-assignment-tracking which tells Clang to ask LLVM to run the
pass declare-to-assign. That pass converts conventional debug intrinsics to
assignment tracking metadata. With this patch it now also sets a module flag
debug-info-assignment-tracking with the value `i1 true` (using the flag conflict
rule `Max` since enabling assignment tracking on IR that contains only
conventional debug intrinsics should cause no issues).

Update the docs and tests too.

Reviewed By: CarlosAlbertoEnciso

Differential Revision: https://reviews.llvm.org/D142027

[Assignment Tracking][Docs] Remove TODO for replacing undef with poison

2023-01-12T10:22:14+00:00

This has been resolved for assignment tracking by the patch D140906 and others
in the same stack.

[DebugInfo] Replace UndefValue with PoisonValue in AssignmentTrackingAnalysis

2023-01-12T09:51:45+00:00

This helps towards the effort to remove UndefValue from LLVM.

Related to https://discourse.llvm.org/t/auto-undef-debug-uses-of-a-deleted-value

Reviewed By: scott.linder

Differential Revision: https://reviews.llvm.org/D140906

[Assignment Tracking] Update TODO list in docs

2022-12-09T17:08:22+00:00

[Assignment Tracking][1/*] Add initial docs for Assignment Tracking

2022-11-02T13:47:50+00:00

The Assignment Tracking debug-info feature is outlined in this RFC:

https://discourse.llvm.org/t/
  rfc-assignment-tracking-a-better-way-of-specifying-variable-locations-in-ir

Add documentation outlining the intent and design.