doc: update

This commit is contained in:
Ferrari Martino Giordano
2024-03-20 16:06:04 +01:00
parent 6ea27eb5ab
commit 1bf403a339
6 changed files with 78 additions and 18 deletions
+37
View File
@@ -0,0 +1,37 @@
# MARTe Auto Documentation Tool
This tool create a simple yet effective documentation of a MARTe configuration.
It generates graph for state machines and real time applications, with different level of details.
Additionally create a markdown file with all the information condensed.
It automatically generate a standalone `html` and a `pdf` using `pandoc` (markdown to pdf/html) and `dot` (for generate the images for the graph).
It has only standard dependency and the only non standard are the ones needed for parsing the MARTe configurations file and are:
- `pyjson` for `json` configuration files
- `MARTe` for standard MARTe configuration files
In order to generate the `pdf` and `html` you will also need:
- `dot`
- `pandoc`
## Usage
```
ausage: autodoc [-h] [--type {json,marte}] [--loglevel {DEBUG,INFO,WARNING,ERROR,CRITICAL}] [--build BUILD] [--version] [-d DESTINATION] filename
MARTe configuration auto documentation tool
positional arguments:
filename Configuration file to document
options:
-h, --help show this help message and exit
--type {json,marte} Configuration file type (default: `marte`)
--loglevel {DEBUG,INFO,WARNING,ERROR,CRITICAL}
Logging level (default: `ERROR`)
--build BUILD build output flag
--version show program's version number and exit
-d DESTINATION, --destination DESTINATION
Destination folderutodoc -
```