From 655c33d5486641c930831a3a88df18bc91706030 Mon Sep 17 00:00:00 2001 From: Lars Bilke <lars.bilke@ufz.de> Date: Thu, 6 May 2021 13:38:16 +0200 Subject: [PATCH] [web] Added page on cli arguments. --- .../docs/userguide/basics/cli-arguments.md | 53 +++++++++++++++++++ .../docs/userguide/basics/project-file.md | 4 +- .../userguide/troubleshooting/get-support.md | 2 +- 3 files changed, 57 insertions(+), 2 deletions(-) create mode 100644 web/content/docs/userguide/basics/cli-arguments.md diff --git a/web/content/docs/userguide/basics/cli-arguments.md b/web/content/docs/userguide/basics/cli-arguments.md new file mode 100644 index 00000000000..d03e3bee88c --- /dev/null +++ b/web/content/docs/userguide/basics/cli-arguments.md @@ -0,0 +1,53 @@ ++++ +date = "2021-05-06T13:00:13+01`:00" +title = "Command-line arguments" +author = "Lars Bilke" +weight = 3 + +[menu] + [menu.userguide] + parent = "basics" ++++ + +The following arguments are available: + +``` +$ ogs --help + + --enable-fpe + enables floating point exceptions + + --unbuffered-std-out + use unbuffered standard output + + --config-warnings-nonfatal + warnings from parsing the configuration file will not trigger program + abortion + + -l <LOG_LEVEL>, --log-level <LOG_LEVEL> + the verbosity of logging messages: none, error, warn, info, debug, all + + -o <PATH>, --output-directory <PATH> + the output directory to write to + + -p <>, --xml-patch <> (accepted multiple times) + the xml patch file(s) which is (are) applied (in the given order) to + the PROJECT_FILE + + -r <PATH>, --reference <PATH> + Run output result comparison after successful simulation comparing to + all files in the given path. This requires test definitions to be + present in the project file. + + --, --ignore_rest + Ignores the rest of the labeled arguments following this flag. + + --version + Displays version information and exits. + + -h, --help + Displays usage information and exits. + + <PROJECT_FILE> + (required) Path to the ogs6 project file. +``` diff --git a/web/content/docs/userguide/basics/project-file.md b/web/content/docs/userguide/basics/project-file.md index 04c0e5e4f7d..77efd42b337 100644 --- a/web/content/docs/userguide/basics/project-file.md +++ b/web/content/docs/userguide/basics/project-file.md @@ -2,7 +2,7 @@ date = "2018-11-14T11:00:13+01`:00" title = "Project file syntax" author = "Lars Bilke" -weight = 3 +weight = 4 [menu] [menu.userguide] @@ -76,6 +76,8 @@ Patch files contain `<replace>`, `<add>` and `<remove>`-elements with [XPath](ht ogs -p path/to/square_1e0_neumann.xml [other/optional/patch_file.xml] path/to/square_1e0.prj ``` +Supplied patch files are applied in the given order. + ### Option 2b: Use a patch file directly If the patch file specifies a `base_file`: diff --git a/web/content/docs/userguide/troubleshooting/get-support.md b/web/content/docs/userguide/troubleshooting/get-support.md index ae5317a27e8..405f1869052 100644 --- a/web/content/docs/userguide/troubleshooting/get-support.md +++ b/web/content/docs/userguide/troubleshooting/get-support.md @@ -13,7 +13,7 @@ If you encounter issues using or developing OGS let us know. To help you in the ### Report contents -- OGS version (e.g. version number or git commit hash) +- Output of `ogs --version` (e.g. version number or git commit hash and CMake arguments) - Where did you obtained the program (e.g. self-compiled or as a binary download from the web site) - Operating system / hardware information (e.g. Ubuntu 20.04, Intel i5-10600K, 16 GB Ram) - Description of the issue: -- GitLab