nget 0.27.1  Copyright 1999-2004 Matthew Mueller <donut AT dakotacom.net>

Note if you are upgrading from a version 0.16-0.26 to 0.27 or later:
 The cache file format has changed, so the cache dir is now .nget5.
 Upgrade should be as simple as "mv ~/.nget4 ~/.nget5; rm ~/.nget5/*,cache*"


Requirements:
  GNU Make (sometimes installed as gmake)
  uulib >= 0.5.19     http://www.fpx.de/fp/Software/UUDeview/
    (included in the +uulib package)
  zlib                http://www.gzip.org/zlib/
    (recommended, needed for compressed cache)
  libpopt             http://freshmeat.net/projects/popt/
    (recommended, needed for -@ option)
  libpcre             http://www.pcre.org/
    (optional, use if you like perl-style regexs)
    (required for cygwin, since cygwin's regex has some problem with nget)
  liblockfile         http://packages.debian.org/liblockfile-dev
    (optional, only needed if your cache dir is on NFS)
    (note: liblockfile uses symlinks, so do not use liblockfile if you will
     store your .nget5 directory on a fat/vfat/etc filesystem or it will
     just hang trying to lock the file.)

TestSuite Requirements:
  Python >= 2.2       http://www.python.org/
  cppunit >= 1.8.0    http://cppunit.sourceforge.net/
  SUBTERFUGUE         http://subterfugue.org/
    (optional, currently only available for x86 linux >=2.4)


Install:      (./configure --help will show extra options not described here)
1) ./configure
2) make
3) make test     (optional, see TestSuite Requirements)
4) make install


Usage:
1) Before the first use, nget must be configured.
1.a) Make nget directory:         mkdir $HOME/.nget5
1.b) Copy example .ngetrc:        cp .ngetrc $HOME/.nget5/
1.c) Add your newsservers:        vi $HOME/.nget5/.ngetrc
   (Remember to chmod 600 your .ngetrc if you are using password auth.)
2) See manpage and nget --help output.  The manpage thoroughly describes all
  command line and configuration options, and has an examples section.


Portability:
nget is developed on linux (glibc2), and has been successfully compiled/tested
on: linux x86(gcc 2.95.4, gcc 3.0.4, gcc 3.2, gcc 3.3), linux alpha(gcc 2.95.2),
macosx(gcc 2.95.2), freebsd x86(gcc 2.95.4, gcc 3.0.4), solaris sparc(gcc
2.95.2), win32(mingw or cygwin) and should compile without modifications on
other systems using g++ 2.95+ or other up to date compliers.
Older compilers like gcc 2.7.x can no longer build nget, but can (probably)
still build ngetlite, so you can still use it to download on an older comp if
you have a recent comp that you can use nget to write the listfiles on (-w
option).


Copying:
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.
See the file 'COPYING' for more information.

I would appreciate it if you make modifications if you would send them
to me for possible inclusion in the main source.


You can find the latest version at
http://nget.sourceforge.net/
or
http://www.dakotacom.net/~donut/programs.html
or
http://freshmeat.net/projects/nget/

Preliminary instructions for (cross-)compiling nget with mingw32.

It is assumed here that you are using a cross compiler.  If not, ignore the
--host and --build args and the CC,CXX,etc setting, and install whatever
software you need to run the configure script (sh, rm, etc). (Or create a
config.h by hand.)

mingw32 doesn't have many libraries, so at the bare minimum you must use popt
and pcre (and nget+uulib).

see http://nget.sourceforge.net/patches/ for the mentioned patches

POPT:
patch -p1 < popt-1.6.4-mingw32cross.patch
autoconf && autoheader
CC=i586-mingw32msvc-gcc CXX=i586-mingw32msvc-g++ ./configure --build=i386-linux --host=i586-mingw32msvc --prefix=/somedir/mingw32/popt1.6.4
make install

PCRE:
CC=i586-mingw32msvc-gcc CXX=i586-mingw32msvc-g++ ./configure --build=i386-linux --host=i586-mingw32msvc --disable-shared --prefix=/somedir/mingw32/pcre3.9
patch -p0 < pcre-3.9-mingw32cross.patch
make CC=gcc ./chartables.c
make install

ZLIB:
AR="i586-mingw32msvc-ar rc" RANLIB=i586-mingw32msvc-ranlib CC=i586-mingw32msvc-gcc CXX=i586-mingw32msvc-g++ ./configure --prefix=/somedir/mingw32/zlib1.1.4
mkdir /somedir/mingw32/zlib1.1.4
make install

NGET:
cd uulib
patch -p0 < uulib-0.5.18-mingw32cross.patch
autoconf && autoheader
AR=i586-mingw32msvc-ar RANLIB=i586-mingw32msvc-ranlib CC=i586-mingw32msvc-gcc CXX=i586-mingw32msvc-g++ ./configure --build=i386-linux --host=i586-mingw32msvc
make
cd ..

./configure --build=i386-linux --host=i586-mingw32msvc --with-popt-prefix=/somedir/mingw32/popt1.6.4/ --with-pcre-prefix=/somedir/mingw32/pcre3.9 --with-zlib-prefix=/somedir/mingw32/zlib1.1.4
make

all done!

nget Copyright 1999-2004 Matthew Mueller <donut AT dakotacom.net>

Readme for nget win32 build.


Some env vars must be set:

1) if you don't have a "\tmp" dir:
set TMPDIR=c:\windows\temp  (or wherever you want)

2) for locating/storing config and cache files:
set HOME=c:\home (or whatever) and create c:\home\_nget4\_ngetrc
 -or-
set NGETHOME=c:\nget (or whatever) and create c:\nget\_ngetrc

(see the included _ngetrc for example config and nget.txt for more info)


Notes:

1) The Windows shell doesn't like ' as a quote character, so be sure to use "
if you need to quote an argument. (Ex: use -r "foo bar", not -r 'foo bar')