X-Git-Url: https://git.distorted.org.uk/~mdw/sw-tools/blobdiff_plain/d7c27db69390bbde372bef64b2e2b8909d6a3bc7..9efcd1779c515c1492ff76a74319936d41e12c0b:/sw.1 diff --git a/sw.1 b/sw.1 index 6f8bf47..80af91d 100644 --- a/sw.1 +++ b/sw.1 @@ -1,6 +1,6 @@ .\" -*-nroff-*- .\" -.\" $Id: sw.1,v 1.6 1999/07/30 08:18:23 mdw Exp $ +.\" $Id: sw.1,v 1.9 1999/09/16 12:34:13 mdw Exp $ .\" .\" Manual page for `sw' .\" @@ -28,6 +28,15 @@ .\"----- Revision history --------------------------------------------------- .\" .\" $Log: sw.1,v $ +.\" Revision 1.9 1999/09/16 12:34:13 mdw +.\" Fix stupid typo. +.\" +.\" Revision 1.8 1999/09/10 15:27:40 mdw +.\" Include `%'-escape substitution. +.\" +.\" Revision 1.7 1999/07/30 18:44:33 mdw +.\" Improve cross-references and tidy up formatting. +.\" .\" Revision 1.6 1999/07/30 08:18:23 mdw .\" Sweep with ispell and fix some typos. .\" @@ -77,18 +86,18 @@ . .\"----- Main manual text --------------------------------------------------- . -.TH sw 1 "25 May 1999" "EBI tools" +.TH sw 1 "25 May 1999" sw-tools .PD 1 . .\"-------------------------------------------------------------------------- . -.SH NAME +.SH "NAME" . sw \- tool for convenient software installation . .\"-------------------------------------------------------------------------- . -.SH SYNOPSIS +.SH "SYNOPSIS" . .nf \fBsw \-\-help @@ -100,15 +109,15 @@ sw \- tool for convenient software installation \fBsw all\-arch \fBsw arch \fBsw commit -\fBsw \fR[\fB\-fbi\fR] [\fB\-a \fIarch\fB,\fIarch\fR...] [\fB\-o \fIstyle\fR] \fBconfigure \fR[\fIconfigure-arg\fR...] +\fBsw \fR[\fB\-fbip\fR] [\fB\-a \fIarch\fB,\fIarch\fR...] [\fB\-o \fIstyle\fR] \fBconfigure \fR[\fIconfigure-arg\fR...] \fBsw host \fIarch \fBsw \fR[\fB\-f\fR] [\fB\-a \fIarch\fB,\fIarch\fR...] \fBlinktree \fBsw listarch -\fBsw \fR[\fB\-fbi\fR] [\fB\-a \fIarch\fB,\fIarch\fR...] [\fB\-o \fIstyle\fR] \fBmake \fR[\fImake-arg\fR...] +\fBsw \fR[\fB\-fbip\fR] [\fB\-a \fIarch\fB,\fIarch\fR...] [\fB\-o \fIstyle\fR] \fBmake \fR[\fImake-arg\fR...] \fBsw only\-arch \fIarch \fR[\fIarch\fR...] \fBsw reset \fBsw rsh \fIhost\fR|\fIarch \fR[\fIcommand \fR[\fIargument\fR...]] -\fBsw \fR[\fB\-fbi\fR] [\fB\-a \fIarch\fB,\fIarch\fR...] [\fB\-o \fIstyle\fR] \fBrun \fIcommand \fR[\fIargument\fR...] +\fBsw \fR[\fB\-fbip\fR] [\fB\-a \fIarch\fB,\fIarch\fR...] [\fB\-o \fIstyle\fR] \fBrun \fIcommand \fR[\fIargument\fR...] \fBsw setup \fIpackage version \fR[\fImaintainer\fR] \fBsw \fR[\fB\-f\fR] [\fB\-a \fIarch\fB,\fIarch\fR...] \fBsnaplink \fIfile \fR[\fIfile\fR...] \fBsw status @@ -499,7 +508,29 @@ for more details on output styles. .B "\-b, \-\-beep" For build commands: make a beep noise when the build finishes. This provides a handy reminder if you're getting on with something else while -waiting for a long build. +waiting for a long build. Use +.RB ` +b ' +or +.RB ` \-\-no\-beep ' +to turn this option off. This option is disabled by default, although +may be enabled in the +.B SW +environment variable. +.TP +.B "\-p, \-\-percent" +For build commands: enable translation of +.RB ` % '-escape +sequences in command strings. These are described in more detail +in the section +.B "`%'-escape sequences" +below. Use +.RB ` +p ' +or +.RB ` --no-percent ' +to turn the option off. This option is enabled by default, although may +be disabled in the +.B SW +environment variable. .PP The remaining options aren't really intended for users. They're helpful for \*(sw's own purposes, though, and described here for completeness' sake. They @@ -536,7 +567,7 @@ about this, see the source code: it's quite well documented, really. . .\"-------------------------------------------------------------------------- . -.SH TERMINOLOGY +.SH "TERMINOLOGY" . The descriptions below make use of some technical terms: .TP @@ -801,6 +832,16 @@ Executes the program named passing it the given .IR argument s. .PP +The command name and arguments may be subject to +.RB ` % '-escape +substitution, depending on whether the +.B \-p +option is enabled. +.RB ` % '-escape +sequences are described in the section +.B "`%'-escape sequences" +below. +.PP Output from the command is both appended to the file .IB arch/.build-log and output in some @@ -866,6 +907,46 @@ actually need to follow creation of link trees. . .\"-------------------------------------------------------------------------- . +.SH "`%'-ESCAPE SUBSTITUTION" +. +If the +.B \-p +option is enabled, build commands and arguments are subject to +.RB ` % '-escape +substitution before being executed. Certain two-character sequences, +with the first character +.RB ` % ' +are replaced with strings, as follows: +.TP +.B %a +The architecture name of the host executing the command. +.TP +.B %h +The hostname of the host executing the command. +.TP +.B %P +The directory prefix with which \*(sw was installed. +.TP +.B %p +The name of the package being built. +.TP +.B %v +The version number of the package being built. +.TP +.B %u +The name of the maintainer of the package being built. +.TP +.B %% +A literal +.RB ` % ' +character. +.PP +Any +.RB ` % ' +sequences which aren't understood are left as they are. +. +.\"-------------------------------------------------------------------------- +. .SH "OUTPUT STYLES" . Output from a build command is presented in one of a number of named @@ -940,7 +1021,7 @@ files is documented separately in . .\"-------------------------------------------------------------------------- . -.SH LOCAL QUIRKS +.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 @@ -985,10 +1066,9 @@ And that's just about it. . .\"-------------------------------------------------------------------------- . -.SH ENVIRONMENT +.SH "ENVIRONMENT" . -The following environment variables are of interest to -.BR sw : +The following environment variables are of interest to \*(sw: .TP .B SW Contains a space-separated list of default command-line options. These @@ -1014,10 +1094,9 @@ program instead. . .\"-------------------------------------------------------------------------- . -.SH FILES +.SH "FILES" . -The following files are of interest to -.BR sw : +The following files are of interest to \*(sw: .TP .IB prefix /sw\-index The main index file, containing the list of which packages have been @@ -1059,13 +1138,21 @@ not very interesting, but might be handy one day. . .\"-------------------------------------------------------------------------- . -.SH BUGS +.SH "BUGS" . There are no bugs in .BR sw , merely unexpected behaviour modes. Silly you for thinking otherwise. . -.SH AUTHOR +.SH "SEE ALSO" +.BR sw-cgi (1), +.BR sw-share (1), +.BR sw-tidy (1), +.BR archtab (5), +.BR sw-env (5), +.BR sw-info (5) +. +.SH "AUTHOR" . The \*(sw program, and this manual, are \*(mw productions, in association with the European Bioinformatics Institute. They were written by Mark