Skip to content

Commit 7d11cb8

Browse files
committed
Fixup after rebase
1 parent 879d93d commit 7d11cb8

File tree

1 file changed

+13
-15
lines changed

1 file changed

+13
-15
lines changed

src/coding-guidelines/macros.rst

Lines changed: 13 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -6,20 +6,17 @@
66
Macros
77
======
88

9-
.. guideline:: Avoid specialized, fixed patterns within declarative macros
10-
:id: gui_FSpI084vbwmJ
11-
:category: required
9+
.. guideline:: Shall not use Declarative Macros
10+
:id: gui_h0uG1C9ZjryA
11+
:category: mandatory
1212
:status: draft
13-
:release: 1.85.0;1.85.1
14-
:fls: fls_w44hav7mw3ao
13+
:release: todo
14+
:fls: fls_xa7lp0zg1ol2
1515
:decidability: decidable
16-
:scope: module
16+
:scope: system
1717
:tags: reduce-human-error
1818

19-
Matchers within macro rules are evaluated sequentially and short-circuit on
20-
the first match. If a specialized fixed matcher follows a broader matcher,
21-
it may be unreachable. This can lead to subtle and surprising bugs. It is
22-
encouraged to avoid the use of specialized, fixed matchers.
19+
Description of the guideline goes here.
2320

2421
.. rationale::
2522
:id: rat_U3AEUPyaUhcb
@@ -31,7 +28,7 @@ Macros
3128
:id: non_compl_ex_Gb4zimei8cNI
3229
:status: draft
3330

34-
Explanation of code example.
31+
(example of a simple expansion using a proc-macro)
3532

3633
.. code-block:: rust
3734
@@ -43,7 +40,7 @@ Macros
4340
:id: compl_ex_Pw7YCh4Iv47Z
4441
:status: draft
4542

46-
Explanation of code example
43+
(example of the same simple expansion using a declarative macro)
4744

4845
.. code-block:: rust
4946
@@ -307,16 +304,17 @@ Macros
307304
308305
.. guideline:: Avoid specialized, fixed patterns within declarative macros
309306
:id: gui_FSpI084vbwmJ
307+
:category: macros
310308
:status: draft
309+
:release: todo
311310
:fls: fls_w44hav7mw3ao
311+
:decidability: decidable
312+
:scope: system
312313
:tags: reduce-human-error
313-
:category: macros
314-
:recommendation: encouraged
315314

316315
Description of the guideline goes here.
317316

318317
.. rationale::
319-
320318
:id: rat_zqr9uEqP6nzW
321319
:status: draft
322320

0 commit comments

Comments
 (0)