This is the GNU Inetutils package.
Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
2008, 2009, 2010, 2011, 2012, 2013 Free Software Foundation, Inc.
See end of file for copying conditions.

This document describes the actions needed to build GNU inetutils from
a pre-release tarball or sources checked out from the version control.

* Introduction

This is a *pre-release* version, and not ready for production use yet.
If you are taking source from version control, you will need to have
several special tools to help contribute.  See the section `Building',
below, for the detailed instructions on how to build the package.

Please, note that the accompanying documentation may be inaccurate or
incomplete.  See ChangeLog for the list of recent changes.

Report bugs to <bug-inetutils@gnu.org>

If you see a problem that you've already reported, feel free to
re-report it -- it won't bother us to get a reminder.  Besides, the
more messages we get regarding a particular problem the sooner it'll
be fixed -- usually.  If you sent a complete patch and nobody applied
it or got back to you, please let us know!

The source `tests/identify.c' should compile in all interesting
build environments, even without configuration.  The resulting
executables display some features known to have produced malfunctions
in portability.  Conveying some selected part of that output could
help us in locating the cause of compiling errors, or of missing
functionality in the built programs.

* Checking Out the Sources

The following instructions apply if you wish to obtain sources from
the version control repository.

To download the source tree from the repository, issue the following
command:

  git clone git://git.savannah.gnu.org/inetutils.git

This will give you read-only access.  If you think you need write
access, contact the mailing list.

* Prerequisites

You need the following packages, we don't make any extra effort to
accommodate older versions of these packages, so please make sure that
you have the latest stable version.

- Autoconf <http://www.gnu.org/software/autoconf/>
- Automake <http://www.gnu.org/software/automake/>
- Bison <http://www.gnu.org/software/bison/>
- Gnulib <http://www.gnu.org/software/gnulib/>
- M4 <http://www.gnu.org/software/m4/>
- Texinfo <http://www.gnu.org/software/texinfo>
- help2man <http://www.gnu.org/software/help2man>

* Building

1. Change to the source tree directory

   cd inetutils

2. Run

   ./bootstrap

Once done, proceed as described in the file INSTALL.

Normally you will have to run bootstrap only once.  However, if you
intend to hack, you might need to run it again later.  In this case,
you will probably want to save some time and bandwidth by avoiding
downloading the same files again.  If so, create in the top level
directory the file named `.bootstrap' with the following contents:

   --gnulib-srcdir=$HOME/gnulib --skip-po

Replace `$HOME/gnulib' with the actual directory where the gnulib
sources reside.

For more information about `bootstrap', run `bootstrap --help'.

Before running "make dist" in a freshly bootstrapped directory, you
need to have run "make" at least once to create the binaries which are
needed by help2man when generating man pages.

See INSTALL and README for the detailed instructions.

* Development

If you are looking for something to hack on, please take a look at the
TODO file in the repository, or in our bug tracker
<https://savannah.gnu.org/bugs/?group=inetutils>.

You can track the development process through the
<commit-inetutils@gnu.org> mailing list.  This is a medium volume
moderated list.

Daily snapshots built are available from
<http://hydra.nixos.org/view/gnu/inetutils-master/latest>.

Log outputs from building the daily snapshot on some systems are
available from <http://autobuild.josefsson.org/inetutils/>

Statistics based on commit logs are available from
<http://gitstats.josefsson.org/inetutils/>.

* Release procedures

[This is only useful for the maintainers of GNU inetutils.]

To make an release issue the following commands:

  make alpha        # or stable

Finally, bump the version number in NEWS, and configure.ac.

When doing a stable release, do not forget to:

 - record the release date in NEWS
 - create a tag (inetutils-N_M)
 - post an announcment to info-gnu@gnu.org
 - update web manual and coverage testing

** Announcement template

Subject: GNU inetutils VERSION released

The GNU inetutils team is proud to present version VERSION of the GNU
networking utilities.  The GNU Networking Utilities are the common
networking utilities, clients and servers of the GNU Operating System.

The following is new in this release:

FIXME: put recent NEWS items here

Please send bug reports to bug-inetutils@gnu.org.

Here are the compressed sources:
  ftp://ftp.gnu.org/gnu/inetutils/inetutils-VERSION.tar.xz

Here are the GPG detached signatures[*]:
  ftp://ftp.gnu.org/gnu/inetutils/inetutils-VERSION.tar.xz.sig

To reduce load on the main server, use a mirror listed at:
  http://www.gnu.org/order/ftp.html

[*] You can use either of the above signature files to verify that the
corresponding file (without the .sig suffix) is intact.  First, be
sure to download both the .sig file and the corresponding tarball.
Then, run a command like this:

  gpg --verify inetutils-VERSION.tar.xz.sig

If that command fails because you don't have the required public key,
then run this command to import it:

  gpg --keyserver keys.gnupg.net --recv-keys D95A3C35

and rerun the `gpg --verify' command.

Many thanks to all the people who contributed to this release.  Happy
hacking!

* Copyright information

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.  This file is offered as-is,
without any warranty.

Local Variables:
mode: outline
paragraph-separate: "[	 ]*$"
version-control: never
End:
