documentation patches

Chris Pressey cpressey at catseye.mine.nu
Mon Jan 26 12:52:41 PST 2004


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




More information about the Submit mailing list