Skip to content

Commit 8693520

Browse files
committed
Use gitbook
1 parent a55e696 commit 8693520

File tree

11 files changed

+23
-30
lines changed

11 files changed

+23
-30
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
11
target/
22
scripts/.coursier
33
scripts/.scalafmt-*
4+
/docs/_book/

build.sbt

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -88,13 +88,3 @@ lazy val samples = project
8888
)
8989

9090
lazy val tools = project in file("tools")
91-
92-
lazy val docs = project
93-
.in(file("docs"))
94-
.enablePlugins(ParadoxPlugin)
95-
.settings(
96-
paradoxTheme := Some(builtinParadoxTheme("generic")),
97-
paradoxProperties in Compile ++= Map(
98-
"github.base_url" -> "https://github.com/kornilova-l/scala-native-bindgen/tree/master/"
99-
)
100-
)
Lines changed: 1 addition & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,11 @@
11
# Scala Native Bindgen
22

3-
@@@ index
4-
5-
* [Obtaining bindgen](obtaining-bindgen/index.md)
6-
* [Usage](command-line-usage/index.md)
7-
* [Limitations](limitations/index.md)
8-
9-
@@@
10-
113
This tool generates Scala Native bindings from C headers.
124
It's built upon clang and [LibTooling] and thus respects the conventions of clang-tools.
135

146
## License
157

168
This project is distributed under the Scala license.
17-
@github[See LICENSE.txt for details](/LICENSE.txt)
9+
[See LICENSE.txt for details](/LICENSE.txt)
1810

1911
[LibTooling]: https://clang.llvm.org/docs/LibTooling.html

docs/SUMMARY.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# Summary
2+
3+
* [Obtaining bindgen](obtaining-bindgen/README.md)
4+
* [Use docker container](obtaining-bindgen/docker-container.md)
5+
* [Build binary with CMake](obtaining-bindgen/cmake.md)
6+
* [Build binary with docker-compose](obtaining-bindgen/docker-compose.md)
7+
* [Usage](command-line-usage/README.md)
8+
* [Limitations](limitations/README.md)
9+
File renamed without changes.

docs/src/main/paradox/limitations/index.md renamed to docs/limitations/README.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,9 @@ There are multiple unsupported cases that should be considered when generating b
3030
```
3131

3232
3. There is no way to reuse already generated bindings.
33-
Bindgen outputs bindings also for headers that were included in a given header. See @github[#2](#2).
33+
Bindgen outputs bindings also for headers that were included in a given header. See [#2].
3434
4. Type qualifiers `const`, `volatile` and `restrict` are not supported.
35-
5. Extern variables are read-only. See @github[scala-native/scala-native#202](scala-native/scala-native#202).
35+
5. Extern variables are read-only. See [scala-native/scala-native#202].
36+
37+
[#2]: https://github.com/kornilova-l/scala-native-bindgen/issues/2
38+
[scala-native/scala-native#202]: https://github.com/scala-native/scala-native/issues/202
Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,6 @@
11
# Obtaining Bindgen
22

3-
@@@ index
4-
3+
There are 3 ways to obtain bindgen:
54
* [Use docker container](docker-container.md)
65
* [Build binary with CMake](cmake.md)
76
* [Build binary with docker-compose](docker-compose.md)
8-
9-
@@@
File renamed without changes.
File renamed without changes.

docs/src/main/paradox/obtaining-bindgen/docker-container.md renamed to docs/obtaining-bindgen/docker-container.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,13 +18,15 @@ docker run -v "$(pwd)":/src -v /usr/include:/usr/include \
1818

1919
The docker image does not contain standard headers so it is important to
2020
mount all system include directories that are used by the header file
21-
passed to `scala-native-bindgen`. See the @github[docker-bindgen.sh](/scripts/docker-bindgen.sh) script for
22-
how to wrap the dockerized program. The `$CWD` of the container is
23-
`/src` which should be mounted from `$(pwd)` in case relative paths are
24-
used.
21+
passed to `scala-native-bindgen`.
22+
23+
See the [docker-bindgen.sh] script for how to wrap the dockerized program.
24+
The `$CWD` of the container is `/src` which should be mounted from `$(pwd)`
25+
in case relative paths are used.
2526

2627
Note, the `scalabindgen/scala-native-bindgen:latest` image is updated on
2728
each merge to the `master` branch.
2829

2930
[Docker]: https://www.docker.com/
31+
[docker-bindgen.sh]: https://github.com/kornilova-l/scala-native-bindgen/blob/master/scripts/docker-bindgen.sh
3032

0 commit comments

Comments
 (0)