diff -r 71503088f51b -r f880f219c566 openpkg/sea.pod
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/openpkg/sea.pod	Tue Jul 31 12:23:42 2012 +0200
@@ -0,0 +1,89 @@
+##
+##  sea -- Shell Execution Archive
+##  Copyright (c) 2012 Ralf S. Engelschall <rse@engelschall.com>
+##
+##  This program 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 2 of the License, or
+##  (at your option) any later version.
+##
+##  This program 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 this program; if not, write to the Free Software
+##  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
+##  USA, or contact Ralf S. Engelschall <rse@engelschall.com>.
+##
+##  NOTICE: Given that you include this file verbatim into your own
+##  source tree, you are justified in saying that it remains separate
+##  from your package, and that this way you are simply just using GNU
+##  shtool. So, in this situation, there is no requirement that your
+##  package itself is licensed under the GNU General Public License in
+##  order to take advantage of GNU shtool.
+##
+
+=pod
+
+=head1 NAME
+
+B<sea> - B<Shell Execution Archive>
+
+=head1 SYNOPSIS
+
+B<sea>
+[B<-h>|B<--help>]
+[B<-o>|B<--output> I<sea>]
+I<script>
+[I<file-or-dir> ...]
+
+=head1 DESCRIPTION
+
+The B<sea> utility allows you to wrap a control shell script (I<script>)
+plus zero or more payload file or directories (I<file-or-dir>) into a
+so-called I<Shell Execution Archive> (I<sea>), a sh(1) executable script
+which temporarily auto-extracts its payload and pass-through execution
+to the control script.
+
+=head1 OPTIONS AND ARGUMENTS
+
+=over 4
+
+=item B<-h>|B<--help>
+
+Just shows a short usage information of the B<sea> utility.
+
+=item B<-o>|B<--output> I<sea>
+
+The output I<Shell Execution Archive> file. By default the output is
+saved to a file with a basename derived from I<script> and with new
+attached extension F<.sea>.
+
+=item I<script>
+
+The mandatory control script which is added to the payload and which
+(after auto-extraction) is executed. It receives all command-line
+arguments originally passed to the I<Shell Execution Archive>.
+
+=item I<file-or-dir>
+
+Optional number of files or directories which are added to the payload.
+
+=back
+
+=head1 EXAMPLES
+
+ $ sea -o foo.src.sh foo.sh foo.src.d
+
+=head1 HISTORY
+
+The B<sea> command was implemented in April 2012 by I<Ralf S. Engelschall>
+E<lt>rse@engelschall.comE<gt>. Its idea is based on the
+OpenPKG shell packages (F<openpkg.src.sh>) and its implemenation was
+triggered by the demand for self-contained OpenPKG software stack source
+archives.
+
+=cut
+