Various tidyings.

[sw-tools] / sw.1

diff --git a/sw.1 b/sw.1
index e231e43..e92cebe 100644 (file)
--- a/sw.1
+++ b/sw.1
@@ -1,6 +1,6 @@
 .\" -*-nroff-*-
 .\"
-.\" $Id: sw.1,v 1.2 1999/06/04 13:56:09 mdw Exp $
+.\" $Id: sw.1,v 1.3 1999/06/18 18:58:25 mdw Exp $
 .\"
 .\" Manual page for `sw'
 .\"
@@ -27,6 +27,9 @@
 .\"----- Revision history ---------------------------------------------------
 .\"
 .\" $Log: sw.1,v $
+.\" Revision 1.3  1999/06/18 18:58:25  mdw
+.\" Various tidyings.
+.\"
 .\" Revision 1.2  1999/06/04 13:56:09  mdw
 .\" Changes, extensions, polishings, spelling fixes...
 .\"
@@ -56,10 +59,10 @@
 .\" --- Style hacking ---
 .\"
 .ie \n(.g \{\
-.      fam P
-.      ds mw \fR[\f(BImdw\fR]
+.       fam P
+.       ds mw \fR[\f(BImdw\fR]
 .\}
-.el    .ds mw \fR[\fBmdw\fR]
+.el     .ds mw \fR[\fBmdw\fR]
 .ie t   .ds o \(bu
 .el     .ds o o
 .ds sw \fBsw\fP
@@ -850,6 +853,10 @@ Any environment variables defined by the remote execution program
 .BR rsh )
 override corresponding variables in the basis environment.
 .HP \*o
+The
+.B SW_ARCH
+variable is set to the name of the remote host's architecture.
+.HP \*o
 Variable assignments are read from the global 
 .IB prefix /share/sw\-env
 file.  This makes some assignments which are useful everywhere, and will
@@ -863,6 +870,49 @@ files is documented separately in
 .BR sw\-env (5).
 .\"
 .\"
+.SH LOCAL QUIRKS
+This section describes how non-vendor software works at EBI.  Chances
+are that other sites will work differently.  This description is here as
+an example setup for \*(sw.
+.PP
+All the non-vendor software gets put in one big shared filesystem, and
+is exported from our main fileserver.  The filesystem is mounted on all
+clients as
+.BR /sw/common .
+Architecture-neutral files are then
+placed in the conventional subdirectories off
+.B /sw/common
+(e.g., 
+.BR /sw/common/share,
+or 
+.BR /sw/common/info ).
+Architecture specific files are stored in subdirectories off
+.BR /sw/common/arch .
+For example, Linux binaries go in
+.BR /sw/common/arch/i386-linux/bin ,
+and Solaris libraries in
+.BR /sw/common/arch/sparc-solaris/lib .
+Additionally, each architecture-specific subtree has a symbolic link
+back up to
+.B /sw/common
+for each of the architecture-neutral subdirectories.
+.PP
+There is a symbolic link on every client, from
+.B /sw/arch
+to
+.BI /sw/common/arch/ arch\fR,
+where
+.I arch
+is the architecture of that client.  Thus, every client has two
+.I views
+of the software repository: the `common' view where every host sees
+exactly the same mapping between filenames and files, and the `arch'
+view where every host sees the same mapping between filenames and
+programs which do the same job.
+.PP
+And that's just about it.
+.\"
+.\"
 .SH ENVIRONMENT
 The following environment variables are of interest to
 .BR sw :