From b802aac2d01cc1c7345705dfaf1e09e76813327e Mon Sep 17 00:00:00 2001 From: Christian Zimmermann Date: Sun, 4 Feb 2024 19:05:12 +0100 Subject: [PATCH] add github doxygen workflow + add LICENSE + update README --- .github/workflows/main.yml | 32 ++++++++++++++++++++++++++++++++ LICENSE | 21 +++++++++++++++++++++ README.md | 10 ++++++++-- 3 files changed, 61 insertions(+), 2 deletions(-) create mode 100644 .github/workflows/main.yml create mode 100644 LICENSE diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml new file mode 100644 index 0000000..5a213c9 --- /dev/null +++ b/.github/workflows/main.yml @@ -0,0 +1,32 @@ +# This file is based on https://github.com/satu0king/Github-Documentation-With-Doxygen/blob/master/main.yml + +name: Doxygen Action + +# Trigger workflow only on pushed to master branch: +on: + push: + branches: [ master ] + +jobs: + build: + # The type of runner that the job will run on + runs-on: ubuntu-latest + + # Steps represent a sequence of tasks that will be executed as part of the job + steps: + # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it + - uses: actions/checkout@v2 + + - name: Doxygen Action + uses: mattnotmitt/doxygen-action@v1.1.0 + with: + # Path to Doxyfile + doxyfile-path: "./doc/doxy/Doxyfile" + # Working directory + working-directory: "./doc/doxy" + + - name: Deploy + uses: peaceiris/actions-gh-pages@v3 + with: + github_token: ${{ secrets.GITHUB_TOKEN }} + publish_dir: ./html diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..1aa1a81 --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2024 Christian Zimmermann + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/README.md b/README.md index 4cc1039..5409839 100644 --- a/README.md +++ b/README.md @@ -70,7 +70,7 @@ Apart from range specific indices, there exist also special indices: #### Array types {#sec-array-types} -Finally, there are the container classes (arrays), which are derived from `CArrayBase` (const) or `ArrayBase` for a given data type `T`. All arrays are defined on a range, their data can be accessed or iterated over using suitable indices. The array-type actually containing data is called `MArray`. Moreover, there exist array-types that do not contain data, but view the data of other arrays or at least parts of the data. These are called `CSlice` (const view) or `Slice`. +Arrays or array-like types contain or view datasets and are derived from `CArrayBase` (const) or `ArrayBase` for a given data type `T`. All array types are defined on a range, their data can be accessed or iterated over using suitable indices. The array-type actually containing data is called `MArray`. Moreover, there exist array-types that do not contain data, but view the data of other arrays or at least parts of the data. These are called `CSlice` (const view) or `Slice`. #### Expressions and Operations @@ -144,5 +144,11 @@ for(size_t j = 0; j < s; ++j){ ``` -... +More documentation will follow... + +## Acknowledgments + +GitHub Doxygen Task based on work by [satu0king](https://github.com/satu0king/Github-Documentation-With-Doxygen/tree/master). + +I want to thank Gesina Schwalbe for creating the logo. -- 2.45.2