.TH publish 1 "29 November 1991" "USGS"
.SH NAME
publish \- make a directory available for AppleShare via CAP/AUFS
.SH SYNOPSIS
.B publish
.sp
.B publish
.I directory
.sp
.B publish
.I directory
.I asn
.SH DESCRIPTION
The
.B publish
command is used to make a Unix directory accessible to AppleShare clients,
normally Macintosh computers on an attached network.
Unix files in a published directory can be read, modified, removed, etc.,
by a Macintosh.
Files on your Macintosh can be stored on the Unix system with the usual
Macintosh click-and-drag of icons.
A published directory looks just like an AppleShare server volume.
.PP
.B `publish'
with no arguments lists your currently published directories.
.PP
.B `publish
.I directory'
sets up the named
.I directory
as an AppleShare volume,
with an AppleShare name based on the last part of the
.I directory
name.
.PP
.B `publish
.I directory
.I asn'
sets up
.I directory
as an AppleShare volume,
with an AppleShare name of
.I asn.
.SH EXAMPLES
If you want to store Macintosh files in a sub-directory named `Mac',
you could type:
.IP
% mkdir Mac
.br
% publish Mac
.PP
When you use AppleShare, this volume will be named `Mac'.
.PP
If you want another directory with a snazzier name:
.IP
% mkdir project
.br
% publish project 'My Special Project'
.PP
To mount `My Special Project' from your Macintosh:
.IP (1)
Under the Apple menu, select Chooser.
.IP (2)
Click on the AppleShare icon.
.IP (3)
Select the AppleTalk zone in which your Unix server lives.
.IP (4)
Double click your Unix server name.
.IP (5)
Type your Unix login name in the Name field,
your Unix password in the Password field,
and click OK.
.IP (6)
Double click on the entry for `My Special Project.`
The icon should appear on your desktop.
.SH LIMITATIONS
You should not modify $HOME/.afpvols with any other programs besides
.B publish
and
.BR unpublish (1).
.PP
You can't publish Unix directories with a colon (`:')
anywhere in the path name.
.PP
You can't use an AppleShare name more than once.
.PP
You can't publish overlapping Unix directories.
For example, you can't do this:
.sp
.RS
% publish ~/Mac
.br
% publish ~/Mac/project
.RE
.SH FILES
$HOME/.afpvols \- AUFS table of directories and AppleShare names
.SH SEE ALSO
unpublish(1), AUFS(1)
.SH AUTHOR
Rex Sanders, US Geological Survey, Pacific Marine Geology
  US Government work in the public domain.