Major rewrite. Provide short names for each command.

1 files changed, 98 insertions, 0 deletions

diff --git a/doc/eclat-assocaddr.1 b/doc/eclat-assocaddr.1
new file mode 100644
index 0000000..5c84232
--- /dev/null
+++ b/doc/eclat-assocaddr.1
@@ -0,0 +1,98 @@
+.\" This file is part of Eclat -*- nroff -*-
+.\" Copyright (C) 2012, 2013 Sergey Poznyakoff
+.\"
+.\" Eclat is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation; either version 3, or (at your option)
+.\" any later version.
+.\"
+.\" Eclat is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with Eclat.  If not, see <http://www.gnu.org/licenses/>.
+.TH ASSOCADDR 1 "January 19, 2013" "ECLAT" "Eclat User Reference"
+.SH NAME
+eclat assocaddr \- associate an IP address with an instance
+.SH SYNOPSIS
+\fBeclat assocaddr\fR [\fIOPTIONS\fR] \fIINSTANCE\fR \fIIP\fR
+
+\fBeclat assocaddr\fR [\fIOPTIONS\fR] \fIINSTANCE\fR \fIALLOC\-ID\fR
+
+\fBeclat assocaddr\fR \fB\-\-help\fR
+.SH DESCRIPTION
+The
+.B assocaddr
+command associates an Elastic IP address with an non-VPC instance or
+associates a VPC Elastic IP address with an instance in your VPC.
+.PP
+The first argument is always the ID of the instance to operate upon.
+The meaning of the second argument depends on the \fB\-\-vpc\fR command
+line option.  If that option is given, the second argument supplies the
+allocation ID that AWS returned when you allocated the Elastic IP
+address for use with Amazon VPC.  Otherwise, it is the Elastic IP to
+assign to the non-VPC instance.
+.SH OPTIONS
+.TP
+\fB\-A\fR, \fB\-\-allow\-reassociation\fR
+Allows an already associated address to be re-associated with the
+specified instance (VPC only).
+.TP
+\fB\-i\fR, \fB\-\-interface\fR=\fIIFACE\fR
+A network interface ID to associate with the instance (vpc only).
+.TP
+\fB\-p\fR, \fB\-\-private\-address\fR=\fIADDRESS\fR
+Private IP address to associate with the Elastic IP address (vpc
+only).
+.TP
+\fB\-v\fR, \fB\-\-vpc\fR
+Assign VPC addresses.
+.SH "OUTPUT AND RETURN VALUE"
+The default output format does not display anything if the operation
+succeeds.  Otherwise it prints on the standard error the diagnostic
+message returned by the Amazon, and returns code 1 to the shell.
+.PP
+The code 2 is returned if
+.B eclat
+is unable to recognize the response.
+.SH EXAMPLES
+.SS 1.
+Assign an Elastic IP to the instance:
+.P
+.nf
+.B eclat assocaddr i\-2ea64347 192.0.2.1
+.fi
+.SS 2.
+Associate an IP address with an instance in the VPC:
+.P
+.nf
+.B eclat assocaddr \-\-vpc i\-4fd2431a eipalloc\-5723d13e
+.fi
+.SH "SEE ALSO"
+.BR eclat (1),
+.BR eclat\-allocaddr (1),
+.BR eclat\-freeaddr (1),
+.BR eclat\-disassaddr (1).
+.SH AUTHORS
+Sergey Poznyakoff
+.SH "BUG REPORTS"
+Report bugs to <bug\-eclat@gnu.org.ua>.
+.SH COPYRIGHT
+Copyright \(co 2012, 2013 Sergey Poznyakoff
+.br
+.na
+License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
+.br
+.ad
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+.\" Local variables:
+.\" eval: (add-hook 'write-file-hooks 'time-stamp)
+.\" time-stamp-start: ".TH [A-Z_][A-Z0-9_.\\-]* [0-9] \""
+.\" time-stamp-format: "%:B %:d, %:y"
+.\" time-stamp-end: "\""
+.\" time-stamp-line-limit: 20
+.\" end:
+