From 07aacb371470b5561f13b95e399e5ff77e417b8f Mon Sep 17 00:00:00 2001
From: Karel Zak <kzak@redhat.com>
Date: Mon, 8 Apr 2024 10:19:56 +0200
Subject: [PATCH] findfs: (man) be more accurate in describing non-tags

Addresses: https://github.com/util-linux/util-linux/discussions/2914
Signed-off-by: Karel Zak <kzak@redhat.com>
---
 libblkid/src/evaluate.c  | 3 +++
 misc-utils/findfs.8.adoc | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/libblkid/src/evaluate.c b/libblkid/src/evaluate.c
index cd2f3a377a..26e556c089 100644
--- a/libblkid/src/evaluate.c
+++ b/libblkid/src/evaluate.c
@@ -224,6 +224,9 @@ static char *evaluate_by_scan(const char *token, const char *value,
  * @value: token data (e.g. "foo")
  * @cache: pointer to cache (or NULL when you don't want to re-use the cache)
  *
+* If the @value is NULL and @token is not in the NAME=value format, then return
+* a copy of the @token.
+ *
  * Returns: allocated string with a device name.
  */
 char *blkid_evaluate_tag(const char *token, const char *value, blkid_cache *cache)
diff --git a/misc-utils/findfs.8.adoc b/misc-utils/findfs.8.adoc
index 560a5bada7..4ff6a14b82 100644
--- a/misc-utils/findfs.8.adoc
+++ b/misc-utils/findfs.8.adoc
@@ -32,7 +32,7 @@ Specifies partition UUID. This partition identifier is supported for example for
 *PARTLABEL*=_<label>_::
 Specifies partition label (name). The partition labels are supported for example for GUID Partition Table (GPT) or MAC partition tables.
 
-If the filesystem or partition is found, the device name will be printed on stdout.
+If the filesystem or partition is found, the device name will be printed on stdout. If the input is not in the format of NAME=value, then the input will be copied to the output without any modification.
 
 The complete overview about filesystems and partitions you can get for example by
 
-- 
2.47.2