openpkg/openpkg.pod

Wed, 14 Jan 2009 15:59:12 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Wed, 14 Jan 2009 15:59:12 +0100
changeset 86
78e7deb1d6ab
child 428
f880f219c566
permissions
-rw-r--r--

Correct and improve many buildconf and code logic blocks. In particular:
1. Document potential problems building with current binutils releases.
2. Document the flawed webkit and explain its temporary exclusion.
3. Document the edition of Qt which is built and installed.
4. Remove the Solaris x11_supdir logic as it is no longer found.
5. Correct several .pr[io] files including QMAKE_CXXFLAGS and INCPATH,
which previously caused preexisting Qt installations to deliver
erroneous old include and library logic instead of relying on
that of the currently building package. -I/opkg/include is now
placed at the end of the compile statements.
6. Don't trust the QMAKE_[INC|LIB]DIR_X11 identifiers in qmake.conf.
7. Allow more 64-bit builds and more properly identify the platform.
8. Place plugins (which are shared objects) in lib instead of share.
9. Build components as plugins when possible if with_shared is enabled.
10. Translate German text to English to be more consistent.
11. Instead of removing the pkgconfig directory of with_shared builds,
place it in a child directory useful for shared building.
12. Document the nonstandard shared build directory structure,
including using the hidden pkgconfig directory (PKG_CONFIG_PATH.)
13. Change %doc to specify files rather than directories in the RPM DB.

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

mercurial