openpkg/openpkg.pod

Sun, 03 Apr 2011 13:34:55 +0200

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Sun, 03 Apr 2011 13:34:55 +0200
changeset 337
f71e028eb3e2
child 428
f880f219c566
permissions
-rw-r--r--

Correct and improve several packaging aspects including...
Correct datadir path for python modules, correct jar(1) path for
building libgcj classes, strip libexecdir path of version numbers,
improve name of oblbld build path, clean whitespace from as(1) and
ld(1) GNU detection, remove seemingly discarded '--with-local-prefix'
configure argument, and correct hardcoded lto plugin libtool archive
dependency information.

Most importantly, correct IA32 architecture detection logic in
config.gcc to correctly emit SSE2 instructions conditionally, leading
to the removal of all '-march' bootstrap options and replacement with
unconditional (for IA32/AMD64) '-mtune=native' options. Comments and
buildtime warnings are corrected appropriately. In theory these changes
cause a more portable, orthoganal, and optimal bootstrap to be built.

michael@13 1 ##
michael@13 2 ## openpkg -- OpenPKG Tool Chain
michael@13 3 ## Copyright (c) 2000-2007 OpenPKG Foundation e.V. <http://openpkg.net/>
michael@13 4 ## Copyright (c) 2000-2007 Ralf S. Engelschall <http://engelschall.com/>
michael@13 5 ##
michael@13 6 ## Permission to use, copy, modify, and distribute this software for
michael@13 7 ## any purpose with or without fee is hereby granted, provided that
michael@13 8 ## the above copyright notice and this permission notice appear in all
michael@13 9 ## copies.
michael@13 10 ##
michael@13 11 ## THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
michael@13 12 ## WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
michael@13 13 ## MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
michael@13 14 ## IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
michael@13 15 ## CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
michael@13 16 ## SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
michael@13 17 ## LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
michael@13 18 ## USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
michael@13 19 ## ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
michael@13 20 ## OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
michael@13 21 ## OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
michael@13 22 ## SUCH DAMAGE.
michael@13 23 ##
michael@13 24 ## openpkg.pod: Minimum Execution Frontend (Language: Perl POD)
michael@13 25 ##
michael@13 26
michael@13 27 =pod
michael@13 28
michael@13 29 =head1 NAME
michael@13 30
michael@13 31 B<OpenPKG> -- Cross-Platform Unix Software Packaging Facility
michael@13 32
michael@13 33 =head1 SYNOPSIS
michael@13 34
michael@13 35 =over 4
michael@13 36
michael@13 37 =item Command Line Interface
michael@13 38
michael@13 39 $ B<openpkg> [I<opt> ...] I<cmd> [I<cmd_opt> ...] [I<cmd_arg> ...]
michael@13 40
michael@13 41 $ B<openpkg> B<man> I<cmd>
michael@13 42
michael@13 43 =item Project Locations
michael@13 44
michael@13 45 http://www.openpkg.org/ web service
michael@13 46 http://cvs.openpkg.org/ repository service
michael@13 47 http://pgp.openpkg.org/ OpenPGP service
michael@13 48 ftp://ftp.openpkg.org/ download service
michael@13 49
michael@13 50 =item Project Forums
michael@13 51
michael@13 52 petidomo@openpkg.org mailing-list manager
michael@13 53 openpkg-announce@openpkg.org project announcements
michael@13 54 openpkg-dev@openpkg.org developer forum
michael@13 55 openpkg-users@openpkg.org users forum
michael@13 56
michael@13 57 =item Local Documentation
michael@13 58
michael@13 59 openpkg-rpm(1) RPM package manager
michael@13 60 openpkg-rpmbuild(1) RPM package manager (build only)
michael@13 61 openpkg-rpm2cpio(1) RPM payload utility
michael@13 62 openpkg-rpm-config(1) RPM C API utility
michael@13 63 openpkg-lsync(1) local area synchronization
michael@13 64 openpkg-rc(1) run-command facility
michael@13 65
michael@13 66 =back
michael@13 67
michael@13 68 =head1 DESCRIPTION
michael@13 69
michael@13 70 OpenPKG is the world leading instrument for deployment and maintenance
michael@13 71 of Open Source software when administration crosses Unix platform
michael@13 72 boundaries. The OpenPKG project is a collaboration effort with the
michael@13 73 goal of creating and maintaining portable and easy to install software
michael@13 74 packages for use on the major Unix server platforms.
michael@13 75
michael@13 76 The unique OpenPKG architecture leverages proven technologies like
michael@13 77 Red Hat Package Manager (RPM) to establish a unified administration
michael@13 78 environment, independent of the underlying operating system. OpenPKG
michael@13 79 is completely self-contained and does not even need a preinstallation
michael@13 80 of RPM. Instead, RPM is provided as an OpenPKG RPM package itself plus
michael@13 81 a tricky bootstrapping procedure in order to allow one to create from
michael@13 82 scratch the initial state of the whole OpenPKG software packaging
michael@13 83 system.
michael@13 84
michael@13 85 =cut
michael@13 86

mercurial