Skip to content

Commit

Permalink
update docs (#143)
Browse files Browse the repository at this point in the history
- remove warning of libtrixi being in an early stage
- add cmake t8code option

Co-authored-by: Michael Schlottke-Lakemper <[email protected]>
  • Loading branch information
benegee and sloede authored Oct 31, 2023
1 parent f91ba03 commit a450e43
Show file tree
Hide file tree
Showing 2 changed files with 8 additions and 10 deletions.
9 changes: 4 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,6 @@
**Libtrixi** is an interface library for using
[Trixi.jl](https://github.com/trixi-framework/Trixi.jl) from C/C++/Fortran.

**Note: This project is in an early stage and the API is still under development.
Nevertheless, basic functionality is already implemented and actively tested.**


## Getting started

Expand Down Expand Up @@ -58,7 +55,9 @@ For building, `cmake` and its typical workflow is used.

- Specifying the directory `install_directory` for later installation is optional.
- Optional specification of build type sets some default compiler options for optimized
or debug code
or debug code.
- Building with t8code support is optional. It requires to pass
`-DT8CODE_PREFIX=<t8code_install_directory>`.

3. Call make

Expand All @@ -81,7 +80,7 @@ For building, `cmake` and its typical workflow is used.
This will install all provided files to the specified location.

### Setting up Julia
After the library has been installed, you need to configure Julia for use with libtrixi. For
Besides the library being installed, you need to configure Julia for use with libtrixi. For
this, create a directory where all necessary files will be placed, e.g., `libtrixi-julia`.
Then, you can use the [`utils/libtrixi-init-julia`](utils/libtrixi-init-julia) tool (also
available at `<install_directory>/bin`) to do the rest for you. A minimal example would be:
Expand Down
9 changes: 4 additions & 5 deletions docs/src/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,6 @@
**Libtrixi** is an interface library for using
[Trixi.jl](https://github.com/trixi-framework/Trixi.jl) from C/C++/Fortran.

**Note: This project is in an early stage and the API is still under development.
Nevertheless, basic functionality is already implemented and actively tested.**


## Getting started

Expand Down Expand Up @@ -58,7 +55,9 @@ For building, `cmake` and its typical workflow is used.

- Specifying the directory `install_directory` for later installation is optional.
- Optional specification of build type sets some default compiler options for optimized
or debug code
or debug code.
- Building with t8code support is optional. It requires to pass
`-DT8CODE_PREFIX=<t8code_install_directory>`.

3. Call make

Expand All @@ -81,7 +80,7 @@ For building, `cmake` and its typical workflow is used.
This will install all provided files to the specified location.

### Setting up Julia
After the library has been installed, you need to configure Julia for use with libtrixi. For
Besides the library being installed, you need to configure Julia for use with libtrixi. For
this, create a directory where all necessary files will be placed, e.g., `libtrixi-julia`.
Then, you can use the
[`utils/libtrixi-init-julia`](https://github.com/trixi-framework/libtrixi/tree/main/utils/libtrixi-init-julia)
Expand Down

0 comments on commit a450e43

Please sign in to comment.