From: Kay Sievers <kay.sievers@vrfy.org>
Date: Sun, 22 Apr 2007 12:19:14 +0000 (+0200)
Subject: path_id: remove broken example
X-Git-Tag: 174~1996
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=commitdiff_plain;h=6ecad86d49c7d9602d4b0f36ce53ccb66eb2b80a

path_id: remove broken example
---

diff --git a/extras/path_id/path_id b/extras/path_id/path_id
index 8927d84ff..a7d650bf4 100644
--- a/extras/path_id/path_id
+++ b/extras/path_id/path_id
@@ -10,13 +10,6 @@
 #	This program is free software; you can redistribute it and/or modify it
 #	under the terms of the GNU General Public License as published by the
 #	Free Software Foundation version 2 of the License.
-#
-# to be called from a udev rule to return the name for a symlink
-#	DEVPATH=<devpath>; path_id
-#	path_id <devpath>
-
-# examples for all block devices on a system:
-#	for i in `find /sys/class/block`; do DEVPATH="`echo $i | sed -e 's@^/sys\|/dev@@g'`"; path_id; done
 
 SYSFS=/sys
 RESULT=1
diff --git a/extras/path_id/path_id.8 b/extras/path_id/path_id.8
index e55914de3..9dc596597 100644
--- a/extras/path_id/path_id.8
+++ b/extras/path_id/path_id.8
@@ -1,25 +1,14 @@
 .TH PATH_ID 8 "April 2007" "" "Linux Administrator's Manual"
 .SH NAME
-path_id \- udev callout to provide the shortest possible unique hardware path
-to a device for the Linux Persistent Device Naming scheme
+path_id \- udev callout to create a device path based unique name
+for a device to implement the Linux Persistent Device Naming scheme
 .SH SYNOPSIS
-DEVPATH=<devpath>; path_id
-
 path_id <devpath>
 .SH "DESCRIPTION"
 .B path_id
-is normally called from a udev rule, to provide udev a unique hardware path for
-a device. Udev can use this information to create symlinks in /dev/ to the real
-device node.
-.SH EXAMPLES
-For all block devices on a system:
-
-.nf
-for i in `find /sys/class/block`
-do
-	DEVPATH="`echo $i | sed -e 's@^/sys\|/dev@@g'`"; path_id
-done
-.fi
+is normally called from a udev rule, to create a unique name, based on
+the device properties along the chain of parent devices. Udev uses this
+information to create a persistent symlink to the real device node.
 .SH SEE ALSO
 .BR udev (7)
 .SH AUTHORS