[PATCH] D145567: [Driver] Rename multilib flags to tags

Simon Tatham via Phabricator via cfe-commits cfe-commits at lists.llvm.org
Thu Mar 9 02:51:14 PST 2023


simon_tatham added a comment.

But it was useful to have it separate at least for review purposes, since it made it much easier when Michael asked me to proofread the change from 'flags' to 'tags'!



================
Comment at: clang/docs/Multilib.rst:66
    ``--target=armv7m-none-eabi`` are equivalent. Clang can also accept many
-   independent pieces of information within a single flag - for example
+   independent pieces of information within a single option - for example
    ``-march=armv8.1m.main+fp+mve`` specifies the architecture and two
----------------
An "option" here seems to be the same thing as an "argument" elsewhere in this paragraph. Since the terminology is already confusing, perhaps simplify by using the same word consistently throughout? I think "option" is more precise, because //positional// clang arguments like input files definitely //don't// play a part in this mechanism.


================
Comment at: clang/docs/Multilib.rst:182
   # List of multilib variants. Required.
   # The ordering of Variants is important if more than one variant can match
+  # the same set of tags. See the docs on multilib layering for more info.
----------------
That capital V looks unintentional to me, and is potentially confusing – someone might go looking for a formal definition of it somewhere.


================
Comment at: clang/include/clang/Driver/Multilib.h:64-65
+  /// Get the set of tags that indicate this multilib's use.
+  /// Tags are arbitrary strings although typically they will look similar to
+  /// command line options. A multilib is considered compatible if its tags are
+  /// a subset of the tags derived from the Clang command line options.
----------------
Tags are arbitrary strings, some of which are derived from command-line options and look similar to them, and others can be defined by a particular multilib.yaml


Repository:
  rG LLVM Github Monorepo

CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D145567/new/

https://reviews.llvm.org/D145567



More information about the cfe-commits mailing list