NetworkManager/man
Thomas Haller b7d0218ee1
docs: rework selecting properties with "generate-docs-nm-settings-docs-merge.py"
"generate-docs-nm-settings-docs-merge.py" merges properties from
multiple XMLs. It supported an argument "--only-from-first", to
only select properties that were in the first of the provided XMLs.

The idea is that the first XML would be "src/nmcli/gen-metadata-nm-settings-nmcli.xml"
which is generated from nmcli meta-data and exactly describes the
supported properties. For example, "connection.read-only", "user.data"
or "wireless.tx-power" exist as properties somewhere, but not supported
by nmcli.

Change that, to not tie the selected property to the first XML.
"gen-metadata-nm-settings-nmcli.xml" is the XML that contains which
properties to select from, but "src/libnm-client-impl/nm-property-infos-nmcli.xml"
contains hand crafted descriptions. The latter descriptions are
preferred. As the order of the XML is already relevant for which
description is preferred, the selection is orthogonal to that.

With this, prefer descriptions from "src/libnm-client-impl/nm-property-infos-nmcli.xml"
but still select properties from "src/nmcli/gen-metadata-nm-settings-nmcli.xml".

Note that the argument is only used to generate "man/nm-settings-docs-nmcli.xml",
and with the current input, there is no actual change in behavior.
2023-05-19 12:52:01 +02:00
..
common.ent.in build: allow configuring default for wifi.backend setting 2022-01-04 06:41:37 +01:00
meson.build docs: rework selecting properties with "generate-docs-nm-settings-docs-merge.py" 2023-05-19 12:52:01 +02:00
NetworkManager-dispatcher.xml man: NetworkManager-dispatcher: document reapply action 2023-02-08 20:51:07 +01:00
NetworkManager-wait-online.service.xml doc: fix documenting "carrier-wait-timeout" in NetworkManager-wait-online manual 2023-02-24 11:50:40 +01:00
NetworkManager.conf.xml man: update documentation about global DNS configuration 2023-03-03 14:06:24 +01:00
NetworkManager.xml man: update "--print-config" text in man NetworkManager 2022-09-08 16:19:11 +02:00
nm-cloud-setup.xml cloud-setup: use suppress_prefixlength rule to honor non-default-routes in the main table 2021-09-16 17:30:25 +02:00
nm-initrd-generator.xml man/nm-initrd-generator: add missing command line options 2022-07-14 21:32:48 +02:00
nm-online.xml man: add NetworkManager-wait-online.service.8 manual 2022-03-02 16:09:16 +01:00
nm-openvswitch.xml man: update nm-openswitch example 2019-07-09 12:05:32 +02:00
nm-settings-dbus.xsl man/nm-settings-dbus: include deprecation description, if present 2022-09-07 10:55:31 +02:00
nm-settings-ifcfg-rh.xsl nm-settings-ifcfg-rh: fix typo 2022-05-26 11:41:31 +02:00
nm-settings-keyfile.xsl docs: unify "nm-property-infos-*.xml" and "nm-settings-docs-*.xml" (root element) 2020-06-11 10:53:50 +02:00
nm-settings-nmcli.xsl docs: better handle description tags in generate-docs-nm-settings-docs-merge.py 2023-05-19 12:52:00 +02:00
nmcli-examples.xml nmcli/devices: add "checkpoint" command 2022-06-15 12:26:08 +02:00
nmcli.xml man/nmcli: document variables affecting fancy output 2022-10-11 16:34:49 +02:00
nmtui.1.in man: update version number and dates in manual pages 2016-03-09 10:11:27 +01:00
nmtui.xml man: turn the manual page cross-references into links 2016-06-21 18:40:13 +02:00