pw_build: Handle multiple artifacts in expressions

Toolchains may produce multiple files for a build command, such as an
ELF file and a .map file. Attempt to resolve this by filtering for
common compilation outputs.

Change-Id: I24bbf9ad667259148ef8c107135cba38dd9ffff8
Reviewed-on: https://pigweed-review.googlesource.com/c/pigweed/pigweed/+/38061
Commit-Queue: Wyatt Hepler <hepler@google.com>
Reviewed-by: Armando Montanez <amontanez@google.com>
diff --git a/pw_build/docs.rst b/pw_build/docs.rst
index 6fff0e4..6135755 100644
--- a/pw_build/docs.rst
+++ b/pw_build/docs.rst
@@ -155,6 +155,11 @@
 BUILD.gn files. This allows build code to use GN labels without having to worry
 about converting them to files.
 
+.. note::
+
+  We intend to replace these expressions with native GN features when possible.
+  See `pwbug/347 <http://bugs.pigweed.dev/347>`_.
+
 The following expressions are supported:
 
 .. describe:: <TARGET_FILE(gn_target)>