From 05e4a733f2141995181a551854d5df929f084adf Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Wed, 9 Aug 2023 21:55:35 +0200 Subject: New upstream version 1.44.0 --- src/nmcli/gen-metadata-nm-settings-nmcli.c | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) (limited to 'src/nmcli/gen-metadata-nm-settings-nmcli.c') diff --git a/src/nmcli/gen-metadata-nm-settings-nmcli.c b/src/nmcli/gen-metadata-nm-settings-nmcli.c index 196e4d35..8e5831ac 100644 --- a/src/nmcli/gen-metadata-nm-settings-nmcli.c +++ b/src/nmcli/gen-metadata-nm-settings-nmcli.c @@ -57,10 +57,22 @@ main(int argc, char *argv[]) g_print("\n%salias=%s", _indent_level(2 * INDENT + 10), tmp3 = _xml_escape_attribute(prop_info->property_alias)); - if (prop_info->describe_doc) - g_print("\n%sdescription=%s", + if (prop_info->describe_doc) { + /* These descriptions are used by interactive nmcli modes. For the most part, + * they are themselves generated (see "settings-docs.h"). Some of them are instead + * explicitly (manually) set. + * + * In any case, they serve little purpose outside of nmcli's interactive mode, + * because their formatting/wording would not be suitable. + * + * We generate this XML mainly to generate `man nm-settings-nmcli`, but the + * descriptions in "describe_doc" field are not suitable there. + * + * Name them something else ("") which isn't actually used. */ + g_print("\n%snmcli-description=%s", _indent_level(2 * INDENT + 10), tmp4 = _xml_escape_attribute(prop_info->describe_doc)); + } g_print(" />\n"); } -- cgit 1.3.0-6-gf8a5