openpkg/openpkg.pod

Tue, 29 Mar 2011 20:04:34 +0200

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Tue, 29 Mar 2011 20:04:34 +0200
changeset 334
4a34d7a82eab
child 428
f880f219c566
permissions
-rw-r--r--

Rework package yet again, correcting and introducing new buildconf logic:
Conditionally disable bootstrap stage comparison correctly, correct
english grammar, better find system as(1) and ld(1), indotruce detailed
optimization option messages, more completely guess cpu types, allow
profiled bootstrapping without a preinstalled GCC because many other
compilers have long since implemented 64-bit arithmetic, instruct make
to build sequentially (not in sparallel) when building a profiled
bootstrap as GCC online documents recommend, and generally improve
comment blocks.

The single most important correction in this changeset relates to the
GCC changed optimization policy since at least GCC 4.5, in which -march
is always passed and not always correctly guessed. In the case of this
package, allowing GCC to guess the architecture leads to wild build
errors at various subcomponents (zlib, libgcc, libiberty...) and
bootstrap stages. It seems quite platform specific, and the safest
approach to correcting this seems to be explicitly always specifying the
-march argument when bootstrapping GCC. Because the best choice 'native'
is not available when bootstrapping using a foreign (non GCC) compiler,
a guess is made according to rpmmacros l_platform in that case.

It is questionable as to whether these recent optimization changes
on the part of GCC or this package are compatible with each other,
or if either are complete or correct at all. At least applying these
corrections allows this package to build again in most cases test.

     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