incubator-ooo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache OpenOffice Community > AOO 3.4 Release FAQ
Date Wed, 04 Apr 2012 13:48:00 GMT
Space: Apache OpenOffice Community (https://cwiki.apache.org/confluence/display/OOOUSERS)
Page: AOO 3.4 Release FAQ (https://cwiki.apache.org/confluence/display/OOOUSERS/AOO+3.4+Release+FAQ)

Change Comment:
---------------------------------------------------------------------
update src release packaging

Edited by Juergen Schmidt:
---------------------------------------------------------------------
This page describes the structure of the Apache OpenOffice 3.4 (AOO3.4) release, the project's
[trunk|https://svn.apache.org/repos/asf/incubator/ooo/trunk] and questions related to these
and their structure. It is intended e.g. to help reviewing a release candidate. A summary
of the activities that we undertook to get us to this point are described in [OOOUSERS:Summary
of Apache OpenOffice 3.4 IP Review Activities]   Additional information can also
be found under [IP Plan for Apache OpenOffice.|https://cwiki.apache.org/confluence/display/OOOUSERS/IP+Plan+for+Apache+OpenOffice]


*Q: How is a AOO3.4 release structured?*
A: The AOO3.4 release is composed of two main parts, the source package and binary packages.

*Q: What is contained in the source package of the release?*
A: The source package contains the full set of files from which the binary packages are created.
It contains all files necessary to build a version of AOO3.4 by externals. It includes all
files from the project trunk which are under ALv2 Apache license and files under Apache [category
A|http://www.apache.org/legal/3party.html] license, thus these file collections allow to build
complete, ALv2-compatible versions of AOO3.4. For information how to build AOO3.4 based on
this file sets, see [here|http://wiki.services.openoffice.org/wiki/Documentation/Building_Guide].
Detailed information about e.g. signature and examples based on the current developer snapshots
can be found [here|https://cwiki.apache.org/confluence/display/OOOUSERS/AOO+3.4+Unofficial+Developer+Snapshots#AOO3.4UnofficialDeveloperSnapshots-srcrelease].

*Q: What is contained in the binary package of the release?*
A: The binary package will be a combination of [full installation sets|https://cwiki.apache.org/confluence/display/OOOUSERS/AOO+3.4+Unofficial+Developer+Snapshots#AOO3.4UnofficialDeveloperSnapshots-fullsets],
[multilingual full installation sets|https://cwiki.apache.org/confluence/display/OOOUSERS/AOO+3.4+Unofficial+Developer+Snapshots#AOO3.4UnofficialDeveloperSnapshots-multilingualsets]
and individual [language packs|https://cwiki.apache.org/confluence/display/OOOUSERS/AOO+3.4+Unofficial+Developer+Snapshots#AOO3.4UnofficialDeveloperSnapshots-langpacks].
For a release candidate these will be signed to allow checking them being unmodified and originally
from Apache. The binary release will contain external components which may be classified as
Apache [category B|http://www.apache.org/legal/3party.html] and thus cannot be part of the
source release. This is done for the end user's convenience so that not everyone who downloads
AOO3.4 has to install components he is interested in by himself. Extra stuff added this way
contains e.g. Hyphenation and Spelling data, language sets, but also external libraries which
extend the functionality of AOO3.4.

*Q: How is the source release created?*
A: The source release packages are created by an ant script (_main/solven/bin/srcrelease.xml_)
which is triggered as special make target (_dmake aoo_srcrelease_) in the module/directory
_main/instsetoo_native/util_ where the binary packages (full install sets, language packs)
are built as well. The script packs all relevant content from trunk excepting some stuff that
is in trunk for convenience only like _ext_sources_. The script can be run at every time and
will exclude all generated files and pack the files from the repository only. The NOTICE,
LICENSE and README file from _main_ are copied in the root directory of the source release
package. The structure for AOO 3.4 looks like:
{code}
 aoo-3.4
 aoo-3.4/NOTICE
 aoo-3.4/LICENSE
 aoo-3.4/README
 aoo-3.4/main/...
 aoo-3.4/extras/...
 aoo-3.4/ext_libraries/...
{code} 

*Q: What is trunk/ext_libraries?*
A: When looking at the project's [trunk|https://svn.apache.org/repos/asf/incubator/ooo/trunk]
yo can see a sub directory called [ext_libraries|https://svn.apache.org/repos/asf/incubator/ooo/trunk/ext_libraries/].
It is part of the source release. The projects there contain mechanisms to download, patch
and build modules needed for a configured build (see [Building Guide|http://wiki.services.openoffice.org/wiki/Documentation/Building_Guide]),
but not the external code. The modules could also be part of the trunk/main directory, but
are a starting point for successively moving external content out of the trunk/main to get
a cleaner source structure in the future. New added libraries which need external content
should be added here.

*Q: What is trunk/ext_sources?*
A: When looking at the project's [trunk|https://svn.apache.org/repos/asf/incubator/ooo/trunk]
yo can see a sub directory called [ext_sources|https://svn.apache.org/repos/asf/incubator/ooo/trunk/ext_sources/].
This contains additions to the regular AOO3.4 which are not in the Apache source release,
but extend the functionality of the binary AOO3.4 releases. This is done to not force each
AOO3.4 user to install these contained additional functionality himself. ext_source is not
part of the source release. For being able to build various configured versions of AOO3.4
(using configure flags, see [Building Guide|http://wiki.services.openoffice.org/wiki/Documentation/Building_Guide])
the build environment has mechanisms to dynamically download the contents needed from sources
of the net.

*Q: Where are the LICENSE and NOTICE files?*
A: TODO

*Q: What information is contained in the LICENSE file?*
A: TODO

*Q: What information is contained in the NOTICE file?*
A: TODO

*Q: What are category-b components and how are these handled for building AOO3.4?*
A: TODO

Change your notification preferences: https://cwiki.apache.org/confluence/users/viewnotifications.action
  

Mime
View raw message