openpkg/openpkg.pod

Fri, 16 Jan 2009 10:58:21 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Fri, 16 Jan 2009 10:58:21 +0100
changeset 92
645923d1e875
child 428
f880f219c566
permissions
-rw-r--r--

Correct and improve code logic, buildconf, and packaging. In particular:
1. Use descriptive variable names <var>libs instead of just <var>.
2. Although Nokia states in all Qt builds that 'NOTE: When linking
against OpenSSL, you can override the default library names
through OPENSSL_LIBS.' and even gives an example, their own
configuration logic rejects such an attempt. Correct this by
hard coding the OpenSSL library string in the configure script.
3. Consistently use the whitespace substitution [\t ] throughout.
4. Patch the buggy INCPATH of SQL plugin Qmake project files.
5. Add the 'x11' configuration variable to the qtconfig Qmake
project using the src/gui/gui.pro file as a model. This is
needed for qtconfig although not in other tools, because
the qtconfig buildconf indirectly includes qt_x11_p.h which
is dependent on X11 headers.
6. Avoid 'ld.so: fatal: hardware capability unsupported: SSE2 AMD_3DNow'
on platforms for which the config.tests/unix/[3dnow|sse2] succeed
although unsopported at run time by testing for the x86-64
instruction set at build time and regulating hardware capabilities.
7. Correctly install the desinger plugin by explicitly building it.
8. Remove custom plugin installation logic which is unnecessary.
9. Correct removal of temporary paths from shared object files.

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