YAML: Ignore empty documents and add tests for multiple documents

Merge branch 'dalcinl/vendor-libyaml' into 'master'

Vendor LibYAML

See merge request petsc/petsc!3652

YAML: Basic autodetection of YAML options files

YAML: Enable use of vendored LibYAML

Merge branch 'dalcinl/options-yaml' into 'master'

Enhancements to YAML options

See merge request petsc/petsc!3629

PetscOptionsInsertFile: Refactor to better support YAML options

* Filenames with '.yaml' or '.yml' extension are inserted as YAML options
* Appending ':yaml' to a filename forces insertion as YAML o

PetscOptionsInsertFile: Refactor to better support YAML options

* Filenames with '.yaml' or '.yml' extension are inserted as YAML options
* Appending ':yaml' to a filename forces insertion as YAML option

The previous rules propagate to PetscInitialize(..., file, ...) as well as
command line option `-options_file`

show more ...

YAML: Inserting all files/strings seen in other files and command line

test: Add test for pushing option prefixes starting with digits

Merge branch 'dalcinl/options-yaml' into 'master'

Enancements to YAML options

See merge request petsc/petsc!3618

Enhancements to YAML options

* Pass PetscOptions object to PetscOptionsInsertFileYAML().

* PetscOptionsInsert{File|String}YAML() are now always available and
will fail at runtime if PETSc was not

Enhancements to YAML options

* Pass PetscOptions object to PetscOptionsInsertFileYAML().

* PetscOptionsInsert{File|String}YAML() are now always available and
will fail at runtime if PETSc was not configured with YAML.

* Mapping keys starting with '$$' are considered dummy and not inserted.
These keys can be used with `!include` tags and for the definition of
YAML anchors to be expanded later with the merge key '<<'.

* Sequences of one-mappings insert an option with the list of keys.
For example, the following YAML options

```yaml
map:
- key0: abc
- key1: xyz
- key2: 123
```

insert the following options

```
-map key0,key1,key2
-map_key0 abc
-map_key1 xyz
-map_key2 123
```

show more ...

Merge branch 'jed/promote-examples-tests-tutorials' [petsc/petsc!2610]

* jed/promote-examples-tests-tutorials:
Promote examples/{tests,tutorials}/ to {tests,tutorials}/

Promote examples/{tests,tutorials}/ to {tests,tutorials}/

This shortens paths and improves consistency between test target names
and paths to the source and output files. Most of the work was
compl

Promote examples/{tests,tutorials}/ to {tests,tutorials}/

This shortens paths and improves consistency between test target names
and paths to the source and output files. Most of the work was
completed by this script, followed by mild cleanup of nonconforming
cases.

for makefile in `git ls-files 'src/*makefile'`; do
if rg -q 'DIRS.*\bexamples\b' $makefile; then
base=$(dirname $makefile)
dirs=$(cd $base/examples && ls -d tests tutorials 2>/dev/null | xargs echo)
perl -pi -e "s#^(DIRS.*)\bexamples\b#\1${dirs}#" $makefile
git rm $base/examples/makefile
for t in $dirs; do
git mv $base/examples/$t $base/
perl -pi -e "s#^(LOCDIR[[:space:]]*=).*#\1 $base/$t/#" $base/$t
done
fi
done

git grep -l -E -z 'examples/(tutorials|tests)' | xargs -0 perl -pi -e 's#examples/(tutorials|tests)#\1#g'
git checkout @ \
src/docs/website/documentation/changes/ \
src/benchmarks/results/

show more ...