8000 Merge pull request #144 from xeno-by/master · apapi/scala.github.com@907ccd4 · GitHub
[go: up one dir, main page]
Skip to content

Commit 907ccd4

Browse files
xeno-byxeno-by
committed
Merge pull request scala#144 from xeno-by/master
links to nightly paradise docs
2 parents 2c99646 + 7ab6aec commit 907ccd4

File tree

2 files changed

+4
-2
lines changed

2 files changed

+4
-2
lines changed

‎overviews/macros/paradise.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,3 +19,5 @@ We have set up a nightly build which publishes snapshot artifacts to Sonatype. C
1919
scalaVersion := "2.11.0-SNAPSHOT"
2020
scalaOrganization := "org.scala-lang.macro-paradise"
2121
resolvers += Resolver.sonatypeRepo("snapshots")
22+
23+
Scaladocs corresponding to paradise nightlies can be found at [our Jenkins server](https://scala-webapps.epfl.ch/jenkins/view/misc/job/macro-paradise-nightly-main/ws/dists/latest/doc/scala-devel-docs/api/index.html). For example, here's the new API for working with top-level definitions: [scala.reflect.macros.Synthetics](https://scala-webapps.epfl.ch/jenkins/view/misc/job/macro-paradise-nightly-main/ws/dists/latest/doc/scala-devel-docs/api/index.html#scala.reflect.macros.Synthetics).

‎overviews/macros/typemacros.md

Lines changed: 2 additions & 2 deletions
< 895C td data-grid-cell-id="diff-3d61e838a9352fbc1b175118f6e49f4cb60786da5bcca3dba0fcedb30e5242d4-29-29-2" data-line-anchor="diff-3d61e838a9352fbc1b175118f6e49f4cb60786da5bcca3dba0fcedb30e5242d4R29" data-selected="false" role="gridcell" style="background-color:var(--diffBlob-additionLine-bgColor, var(--diffBlob-addition-bgColor-line));padding-right:24px" tabindex="-1" valign="top" class="focusable-grid-cell diff-text-cell right-side-diff-cell left-side">+
The full source code of the `H2Db` type macro is provided [at Github](https://github.com/xeno-by/typemacros-h2db), and this guide covers its most important aspects. First the macro generates the statically typed database wrapper by connecting to a database at compile-time (tree generation is explained in [the reflection overview](http://docs.scala-lang.org/overviews/reflection/overview.html)). Then it uses the <span class="label success">NEW</span> `c.introduceTopLevel` API ([Scaladoc](https://scala-webapps.epfl.ch/jenkins/view/misc/job/macro-paradise-nightly-main/ws/dists/latest/doc/scala-devel-docs/api/index.html#scala.reflect.macros.Synthetics)) to insert the generated wrapper into the list of top-level definitions maintained by the compiler. Finally, the macro returns an `Apply` node, which represents a super constructor call to the generated class. <span class="label warning">NOTE</span> that type macros are supposed to expand into `c.Tree`, unlike def macros, which expand into `c.Expr[T]`. That's because `Expr`s represent terms, while type macros expand into types.
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Just as def macros make the compiler execute custom functions when it sees invoc
2626
Db.Coffees.update(brazilian.copy(price = 10))
2727
println(Db.Coffees.all)
2828

29-
The full source code of the `H2Db` type macro is provided [at Github](https://github.com/xeno-by/typemacros-h2db), and this guide covers its most important aspects. First the macro generates the statically typed database wrapper by connecting to a database at compile-time (tree generation is explained in [the reflection overview](http://docs.scala-lang.org/overviews/reflection/overview.html)). Then it uses the <span class="label success">NEW</span> `c.introduceTopLevel` API to insert the generated wrapper into the list of top-level definitions maintained by the compiler. Finally, the macro returns an `Apply` node, which represents a super constructor call to the generated class. <span class="label warning">NOTE</span> that type macros are supposed to expand into `c.Tree`, unlike def macros, which expand into `c.Expr[T]`. That's because `Expr`s represent terms, while type macros expand into types.
29
3030

3131
type H2Db(url: String) = macro impl
3232

@@ -71,7 +71,7 @@ Type macros represent a hybrid between def macros and type members. On the one h
7171
| Can be inherited | Yes | Yes | Yes |
7272
| Can override and be overridden | Yes | Yes | Yes |
7373

74-
In Scala programs type macros can appear in one of five possible roles: type role, applied type role, parent type role, new role and annotation role. Depending on the role in which a macro is used (can be inspected with the <span class="label success">NEW</span> `c.macroRole` API), its list of allowed expansions is different.
74+
In Scala programs type macros can appear in one of five possible roles: type role, applied type role, parent type role, new role and annotation role. Depending on the role in which a macro is used, which can be inspected with the <span class="label success">NEW</span> `c.macroRole` API ([Scaladoc](https://scala-webapps.epfl.ch/jenkins/view/misc/job/macro-paradise-nightly-main/ws/dists/latest/doc/scala-devel-docs/api/index.html#scala.reflect.macros.Enclosures)), its list of allowed expansions is different.
7575

7676
| Role | Example | Class | Non-class? | Apply? | Template? |
7777
|--------------|-------------------------------------------------|-------|------------|--------|-----------|

0 commit comments

Comments
 (0)
0