From 4febf7f076fa4abaa36b0ae047aa893b1334fc93 Mon Sep 17 00:00:00 2001
From: Kay Sievers <kay.sievers@suse.de>
Date: Thu, 7 Sep 2006 11:08:07 +0200
Subject: [PATCH 1/1] man: add $attr{} section about symlinks

---
 udev.7   | 4 ++--
 udev.xml | 9 +++++++--
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/udev.7 b/udev.7
index fa6e52fdf..05fa2e622 100644
--- a/udev.7
+++ b/udev.7
@@ -196,13 +196,13 @@ The devpath of the device.
 \fB$id\fR, \fB%b\fR
 The name of the device matched while searching the devpath upwards for
 \fBSUBSYSTEMS\fR,
-\fBKERNELS\fR
+\fBKERNELS\fR,
 \fBDRIVERS\fR
 and
 \fBATTRS\fR.
 .TP 3n
 \fB$attr{\fR\fB\fIfile\fR\fR\fB}\fR, \fB%s{\fR\fB\fIfile\fR\fR\fB}\fR
-The value of a sysfs attribute found at the current or a parent device.
+The value of a sysfs attribute found at the device, where all keys of the rule have matched. If the matching device does not have such an attribute, all devices along the chain of parents are searched for a matching attribute. If the attribute is a symlink, the last element of the symlink target is returned as the value.
 .TP 3n
 \fB$env{\fR\fB\fIkey\fR\fR\fB}\fR, \fB%E{\fR\fB\fIkey\fR\fR\fB}\fR
 The value of an environment variable.
diff --git a/udev.xml b/udev.xml
index b2781b767..852ae039e 100644
--- a/udev.xml
+++ b/udev.xml
@@ -406,7 +406,7 @@
               <term><option>$id</option>, <option>%b</option></term>
               <listitem>
                 <para>The name of the device matched while searching the devpath upwards for
-                  <option>SUBSYSTEMS</option>, <option>KERNELS</option> <option>DRIVERS</option> and <option>ATTRS</option>.
+                  <option>SUBSYSTEMS</option>, <option>KERNELS</option>, <option>DRIVERS</option> and <option>ATTRS</option>.
                 </para>
               </listitem>
             </varlistentry>
@@ -414,7 +414,12 @@
             <varlistentry>
               <term><option>$attr{<replaceable>file</replaceable>}</option>, <option>%s{<replaceable>file</replaceable>}</option></term>
               <listitem>
-                <para>The value of a sysfs attribute found at the current or a parent device.</para>
+                <para>The value of a sysfs attribute found at the device, where
+                all keys of the rule have matched. If the matching device does not have
+                such an attribute, all devices along the chain of parents are searched
+                for a matching attribute.
+                If the attribute is a symlink, the last element of the symlink target is
+                returned as the value.</para>
               </listitem>
             </varlistentry>
 
-- 
2.30.2