Skip to content

Commit 12cb787

Browse files
committed
Document identity and manual sbt closure
1 parent 480d4de commit 12cb787

4 files changed

Lines changed: 589 additions & 74 deletions

File tree

README.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,22 @@ final class IdentityHandler extends ExpansionHandler:
6969
ExpansionEdit.finish(ExpansionEdit.start(input))
7070
```
7171

72+
The consumer imports the marker and uses short `@identity` as the normal form:
73+
74+
```scala
75+
package com.example.core
76+
77+
import com.example.`macro`.annotations.identity
78+
79+
@identity
80+
class Something
81+
```
82+
83+
This behavior-free first use proves discovery, binding, loading, invocation,
84+
and unchanged pass-through. The complete marker/handler/consumer tutorial and
85+
both manual sbt translations are in
86+
[External handler authoring](docs/EXTERNAL_HANDLER_AUTHORING.md#minimal-identity-first-use).
87+
7288
The next step is source-like member generation. The canonical example uses
7389
Scalameta `q` syntax, Quasiquotes 0.3.0 generated-origin lowering, and the generic
7490
MacroParadise placement helper. The bridge supplies honest source/span

0 commit comments

Comments
 (0)