man page: document when substitutions are applied for RUN and other keys

diff --git a/docs/udev.xml b/docs/udev.xml
index 7e29077977363e5ed0aefc0aae4e38a9aa28ae72..e0542a6be199048f024550dd784835bb17a47a6a 100644 (file)
--- a/docs/udev.xml
+++ b/docs/udev.xml
@@ -353,8 +353,12 @@
           </variablelist>
 
           <para>The <option>NAME</option>, <option>SYMLINK</option>, <option>PROGRAM</option>,
           </variablelist>
 
           <para>The <option>NAME</option>, <option>SYMLINK</option>, <option>PROGRAM</option>,

-          <option>OWNER</option>  and  <option>GROUP</option>  fields  support  simple
-          printf-like string substitutions:</para>
+          <option>OWNER</option>, <option>GROUP</option>  and  <option>RUN</option>
+          fields support simple printf-like string substitutions. The <option>RUN</option>
+          format chars gets applied after all rules have been processed, right before the program
+          is executed. It allows the use of the complete environment set by earlier matching
+          rules. For all other fields, substitutions are applied while the individual rule is
+          being processed. The available substitutions are:</para>

           <variablelist>
             <varlistentry>
               <term><option>$kernel</option>, <option>%k</option></term>
           <variablelist>
             <varlistentry>
               <term><option>$kernel</option>, <option>%k</option></term>

diff --git a/udev.7 b/udev.7
index a7e2f5a4e77b691ec335cf08cb7851fb8cb71632..711bd0861b0d1d99c247c0155d10d740dfbd1edb 100644 (file)
--- a/udev.7
+++ b/udev.7
@@ -164,10 +164,13 @@ The
 \fBNAME\fR,
 \fBSYMLINK\fR,
 \fBPROGRAM\fR,
 \fBNAME\fR,
 \fBSYMLINK\fR,
 \fBPROGRAM\fR,

-\fBOWNER\fR
-and
+\fBOWNER\fR,

 \fBGROUP\fR
 \fBGROUP\fR

-fields support simple printf\-like string substitutions:
+and
+\fBRUN\fR
+fields support simple printf\-like string substitutions. The
+\fBRUN\fR
+format chars gets applied after all rules have been processed, right before the program is executed. It allows the use of the complete environment set by earlier matching rules. For all other fields, substitutions are applied while the individual rule is being processed. The available substitutions are:

 .TP
 \fB$kernel\fR, \fB%k\fR
 The kernel name for this device.
 .TP
 \fB$kernel\fR, \fB%k\fR
 The kernel name for this device.