Pudu programming language
Menu
Package

@chrismichaelps / pudu-lang-docgen

Documentation publishing for Pudu: articles, API references, navigation, search, and static websites

0.1.0Apache-2.01

InstallClose

merge.md

Markdown28 lines872 B

GitHub ↗

merge


uid: guides.commands.merge description: Combine several cross-reference maps into one file.


Reads several cross-reference maps, from files or web addresses, and writes one map containing every identity.

docgen merge <maps...> --output <file>
Argument or optionDescription
mapsPaths or addresses of the maps to combine.
-o, --output <file>The file to write. A .json name writes JSON; any other name writes YAML. Required.

When several maps declare the same uid, the first map listed wins. The result is sorted by uid. The command prints merged <n> references into <file>.

It fails with DG904 when a map cannot be read, and exits with status 2 when no map or no --output is given.

Example

pudu run Docgen.pudu merge maps/docgen.yml maps/partner.json --output maps/all.yml