path_id: add man page

extras/path_id/Makefile

@@ -45,7 +45,7 @@ uninstall-bin:
 .PHONY: uninstall-bin
 
 install-man:
-	@echo "Please create a man page for this tool."
+	$(INSTALL_DATA) -D $(PROG).8 $(DESTDIR)$(mandir)/man8/$(PROG).8
 .PHONY: install-man
 
 uninstall-man:

extras/path_id/path_id.8

@@ -0,0 +1,26 @@
+.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
+.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
+.SH SEE ALSO
+.BR udev (7)
+.SH AUTHORS
+Developed by Hannes Reinecke <hare@suse.de>.