xbps/doc
Juan RP 4ef0fbcada Multiple changes to xbps-src and shutils:
* Added XBPS_FETCH_CMD to xbps-src.conf, this will be used to fetch
  distfiles. Please note that it will be copied to the chroot, so
  it should be statically linked or with only libc required.

* Removed libtool_func.sh and associated vars, it's unneeded currently.

* Added keep_empty_dirs, keep_libtool_archives and nostrip. By default
  all empty dirs and libtool archives are removed, and executables and
  libraries stripped, respectively. One can use set the var in a build
  template to change the behaviour.

* Explain in README what are the requirements to build XBPS.

--HG--
extra : convert_revision : xtraeme%40gmail.com-20091017005836-uifiof32ndy0wmd8
2009-10-17 02:58:36 +02:00
..
BINPKG_INFO Initial import of xbps with code as August '09. 2009-08-17 19:07:20 +02:00
BINPKG_REPOSITORY Update documentation to match with reality. 2009-08-21 08:02:05 +02:00
README Multiple changes to xbps-src and shutils: 2009-10-17 02:58:36 +02:00
SRCPKG_INFO Update documentation to match with reality. 2009-08-21 08:02:05 +02:00
TODO Update documentation to match with reality. 2009-08-21 08:02:05 +02:00

-----------------------------------------------------------------------------
 WHAT IS IT?
-----------------------------------------------------------------------------

xbps - xtraeme's binary package ystem.

xbps is a new binary package system, taken ideas from other free available
implementations, such as dpkg/apt, RPM, pacman and others. Metadata handling
as package databases are handled by proplib. Multiple compression formats
are supported in binary packages thanks to libarchive.

xbps has been designed for Linux, and for the moment I'm not interested to
make it work on any other random OS. xbps is the base to create a basic
Linux system.

-----------------------------------------------------------------------------
 REQUIREMENTS
-----------------------------------------------------------------------------

xbps uses proplib, a property container object library and it's almost the
same one available for NetBSD. Be sure to have it installed before using
xbps. You can get it at:

http://code.google.com/p/portableproplib/

I'm also the human maintaining the portable proplib package. I'd suggest you
to install it into /usr/local to avoid issues with your distribution packages.

To build the xbps utils, you'll need:

	* acl (devel pkg with static lib)
	* zlib (devel pkg with static lib)
	* bzip2 (devel pkg with static lib)
	* xz (devel pkg with static lib)
	* libarchive (devel pkg with static lib, all features built in)
	* proplib (deve pkg with static lib, see above)

Additionally the following software is required in the host system to build
and install xbps binary packages:

	* GNU GCC C++
	* GNU Make
	* GNU Bison
	* fakeroot
	* wget OR curl OR fetch (statically linked or no additional deps)
	* perl
	* sudo

Super-user privileges are required as well, because all packages are built
in a chroot (except the ones that are included in a virtual package to be
able to build a minimal system for the chroot).

PLEASE NOTE THAT fakechroot or fakeroot-ng DO NOT WORK.

------------------------------------------------------------------------------
 HOW TO USE IT
------------------------------------------------------------------------------

Before using xbps, some required utilities need to be built and installed
into $(PREFIX); by default they are installed into /usr/local.
You can do this by issuing "make" and "make install" as root in the top
level directory. See the REQUIREMENTS section above for required packages.

Once the xbps distfiles are installed into prefix, you can start building
packages from source, add local repositories with binary packages, install or
remove them, etc.

If you are only interested in building/using packages from source, see the
SRCPKG_INFO file.

For information about binary packages, see the BINPKG_INFO file.

------------------------------------------------------------------------------
	Juan Romero Pardines <xtraeme@gmail.com>