summaryrefslogtreecommitdiffstats
path: root/md
diff options
Diffstat (limited to 'md')
-rw-r--r--md/issues/251030.1.md74
1 files changed, 74 insertions, 0 deletions
diff --git a/md/issues/251030.1.md b/md/issues/251030.1.md
new file mode 100644
index 0000000..b0a9f2f
--- /dev/null
+++ b/md/issues/251030.1.md
@@ -0,0 +1,74 @@
1Title: Normalize Some Class and Form Names
2Author: Ron Brender
3Email: ron.brender@gmail.com
4Champion:
5Submit-Date: 2025-10-30
6Revised-Date:
7Closed-Date:
8Propid: 251030.1
9Type: Editorial
10Status: Open
11Version: 6
12Format: markdown
13Revisions:
14
15## BACKGROUND
16
17As a result of adopting [230524.1][230524.1], "Location
18Descriptions on the Stack," and other recent proposals in V6,
19we have some new class and form names in the DWARF spec:
20
21Classes:
22
23- exprval
24- exprloc
25- locexpr
26- loclist
27
28Form:
29
30- `DW_FORM_expression`
31
32Classes exprval and locexpr use `DW_FORM_expression` (which is
33a renaming of `DW_FORM_exprloc` from V5).
34
35Classes loclist and vallist use `DW_FORM_loclistx` (this last
36carried over from V5).
37
38Notice that the exprval and exprloc names indicate the
39representation first (expression) and the meaning second
40(val vs loc) while locexpr and loclist are the opposite.
41
42Further, `DW_FORM_expression` is rather long compared to the
43usual abbreviated spelling of other classes and forms.
44
45
46## PROPOSAL
47
481) For the class names, adopt the order meaning then
49representation. That means change exprval to valexpr and
50exprloc to locexpr. The resulting set of names is: locexpr,
51loclist, valexpr and vallist.
52
532) Rename `DW_FORM_expression` to `DW_FORM_expr`. The latter
54is more consistent with the abbreviation conventions in the
55classes that use it (locexpr, valexpr).
56
573) Rename `DW_FORM_loclistx` to `DW_FORM_listx`. This better
58reflects the fact that that form is used with both value
59lists and location lists and not just locations.
60
61These are simple renamings only. `DW_FORM_expr` will use code
620x18 (used by `DW_FORM_exprloc` in V5), and the two names can
63be treated as synonyms. Similarly `DW_FORM_listx` can use code
640x22 (used by `DW_FORM_loclistx` in V5), and those two names
65can be treated as synonyms.
66
67Note that `DW_FORM_expression` is new in V6 and already
68defined as a renaming of `DW_FORM_exprloc`.
69
70Note that `DW_FORM_rnglistx` (carried over from V5) already
71follows the meaning then representation order and needs no
72change.
73
74[230524.1]: https://dwarfstd.org/issues/230524.1.html