From caf3d1cc3cb29051a8d29c3fb0f48b438ebd937e Mon Sep 17 00:00:00 2001
From: Giridhar <80974392+giri256@users.noreply.github.com>
Date: Wed, 22 Jul 2026 23:28:06 +0530
Subject: [PATCH] lsf: document Google Drive shortcut IDs - fixes #7863

Signed-off-by: Giridhar <80974392+giri256@users.noreply.github.com>
---
 cmd/lsf/lsf.go | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/cmd/lsf/lsf.go b/cmd/lsf/lsf.go
index 03a7d9f0c..66e0fca2a 100644
--- a/cmd/lsf/lsf.go
+++ b/cmd/lsf/lsf.go
@@ -80,6 +80,12 @@ T - tier of storage if known, e.g. "Hot" or "Cool"
 M - Metadata of object in JSON blob format, eg {"key":"value"}
 ` + "```" + `
 
+Some backends use composite IDs. In particular, Google Drive shortcuts are
+normally dereferenced, and their "i" field contains the target object's ID
+followed by the shortcut's ID, separated by a tab. This tab is part of the ID
+field and is not changed by ` + "`--separator`" + `. Use ` + "`--drive-skip-shortcuts`" + ` to omit
+shortcut entries.
+
 So if you wanted the path, size and modification time, you would use
 ` + "`--format \"pst\"`, or maybe `--format \"tsp\"`" + ` to put the path last.