documentation patches

[Chris Pressey <cpressey@xxxxxxxxxxxxxxx>]

Hearing Justin's plea, two small documentation patches attached.

-Chris

Index: ln.1
===================================================================
RCS file: /home/dcvs/src/bin/ln/ln.1,v
retrieving revision 1.3
diff -u -r1.3 ln.1
--- ln.1	22 Jan 2004 17:30:30 -0000	1.3
+++ ln.1	26 Jan 2004 12:40:15 -0000
@@ -170,12 +170,48 @@
 which performs a
 .Xr link 2
 operation using the two passed arguments.
+.Sh VARIANT SYMLINKS
+DragonFly supports a special kind of dynamic
+symbolic link called a
+.Em variant symlink .
+The
+.Ar source_file
+of a variant symlink may contain one or more
+variable names.  Each of these variable
+names is enclosed in braces and preceded by a
+dollar sign in the style of variable references in
+.Xr sh 1
+and
+.Xr csh 1 .
+.Pp
+Whenever a variant symlink is followed, each
+variable named in its
+.Ar source_file
+is interpolated and replaced by its associated value.
+In this manner, a variant symlink may refer to different
+files at different times depending on the values of the
+.Em varsym variables
+currently held by the process,
+the user, and the system.
 .Pp
-Use varsym variables to get dynamic symbolic links.
-E.g.
-.Nm ln -s
-.Ar source_file_${varsym}
-.Ar target_file.
+Varsym variables can be set with the
+.Xr varsym 1
+utility.  Regular
+.Xr environ 7
+environment variables are
+not interpolated into variant symlinks.
+.Ss EXAMPLE
+.Bd -literal -offset indent
+sysctl -w vfs.varsym_enable=1
+
+ln -s 'a${fubar}b' test
+
+echo 'Hello' > axxb
+echo 'Goodbye' > ayyb
+
+varsym fubar=xx; cat test
+varsym fubar=yy; cat test
+.Ed
 .Sh SEE ALSO
 .Xr link 2 ,
 .Xr lstat 2 ,
@@ -195,6 +231,8 @@
 They are provided solely for compatibility with other
 .Nm
 implementations.
+.Pp
+Variant symlinks are unique (among BSDs) to DragonFly.
 .Sh STANDARDS
 The
 .Nm

Index: README
===================================================================
RCS file: /home/dcvs/src/nrelease/root/README,v
retrieving revision 1.8
diff -u -r1.8 README
--- README	23 Jan 2004 00:39:25 -0000	1.8
+++ README	26 Jan 2004 12:45:16 -0000
@@ -57,7 +57,7 @@
 	#	ad0s1d	256m		This will be your /var
 	#	ad0s1e	256m		This will be your /tmp
 	#	ad0s1f	8192m		This will be your /usr (min 4096m)
-	#	ad0s1g	*		All remaining space to yoru /home
+	#	ad0s1g	*		All remaining space to your /home
 	#
 	#  An example disklabel can be found in /etc/disklabel.ad0s1
 	#
@@ -123,6 +123,8 @@
 	#
 	rm /mnt/boot/loader.conf
 	rm /mnt/README
+	rm /mnt/boot.catalog
+	rm -r /mnt/rr_moved
 
     At this point it should be possible to reboot.  The CD may be locked
     since it is currently mounted.  Be careful of the CD drawer closing