xref: /trunk/README.md (revision 2154eb031b299dcfc10857a75a01ff3fe76874d4)
12ab0ece2SJohn Bampton<!--
22ab0ece2SJohn Bampton Licensed to the Apache Software Foundation (ASF) under one
32ab0ece2SJohn Bampton or more contributor license agreements.  See the NOTICE file
42ab0ece2SJohn Bampton distributed with this work for additional information
52ab0ece2SJohn Bampton regarding copyright ownership.  The ASF licenses this file
62ab0ece2SJohn Bampton to you under the Apache License, Version 2.0 (the
72ab0ece2SJohn Bampton "License"); you may not use this file except in compliance
82ab0ece2SJohn Bampton with the License.  You may obtain a copy of the License at
92ab0ece2SJohn Bampton
102ab0ece2SJohn Bampton   http://www.apache.org/licenses/LICENSE-2.0
112ab0ece2SJohn Bampton
122ab0ece2SJohn Bampton Unless required by applicable law or agreed to in writing,
132ab0ece2SJohn Bampton software distributed under the License is distributed on an
142ab0ece2SJohn Bampton "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
152ab0ece2SJohn Bampton KIND, either express or implied.  See the License for the
162ab0ece2SJohn Bampton specific language governing permissions and limitations
172ab0ece2SJohn Bampton under the License.
182ab0ece2SJohn Bampton-->
192ab0ece2SJohn Bampton
20d78d7ef2SMatthias Seidel# Apache OpenOffice<sup>®</sup>
2111bf6ff1SPeter Kovacs
22ff9b9344SMatthias SeidelThe Apache OpenOffice project (AOO) provides a full featured office productivity suite based on open standards.
238897188dSmseidelIt is the continuation of the OpenOffice.org project.
2411bf6ff1SPeter Kovacs
258676c5dbSmseidelFor detailed information about Apache OpenOffice please visit the [Project Website](https://openoffice.apache.org/).
2611bf6ff1SPeter Kovacs
278897188dSmseidelApache OpenOffice is a very large project with many components and mainly implemented in C++ but also in Java, Perl, Python and other languages.
2811bf6ff1SPeter Kovacs
2911bf6ff1SPeter KovacsCurrently supported platforms include:
3011bf6ff1SPeter Kovacs
318897188dSmseidel- Microsoft Windows
328897188dSmseidel- macOS (OS X)
338897188dSmseidel- Linux variants
348897188dSmseidel- FreeBSD
358897188dSmseidel- OS/2
3611bf6ff1SPeter Kovacs
37*2154eb03SMatthias SeidelOpenOffice is used by millions of users worldwide and with more than 395 million downloads it is one of the most successful open source projects.
3811bf6ff1SPeter Kovacs
3951eff6d2SMatthias# Getting the latest sources via Git
4011bf6ff1SPeter Kovacs
418897188dSmseidelYou can always checkout the latest source via Git using the following command:
42a7f3bf48SJohn Bampton
438897188dSmseidel```
440df9dbdbSMatthiasgit clone https://gitbox.apache.org/repos/asf/openoffice.git aoo
458897188dSmseidel```
46a7f3bf48SJohn Bampton
478897188dSmseidelFor further information visit [https://openoffice.apache.org/source.html](https://openoffice.apache.org/source.html).
4811bf6ff1SPeter Kovacs
4951eff6d2SMatthias# Building Apache OpenOffice
5011bf6ff1SPeter Kovacs
518897188dSmseidelApache OpenOffice is a big project and depends on several other external libraries.\
5211bf6ff1SPeter KovacsThe list of prerequisites varies for the different platforms.
5311bf6ff1SPeter Kovacs
548676c5dbSmseidelA comprehensive and complete building guide can be found in the [Project Wiki](https://wiki.openoffice.org/wiki/Documentation/Building_Guide_AOO).
5511bf6ff1SPeter Kovacs
5611bf6ff1SPeter KovacsWith having all prerequisites in place you can simply run
57a7f3bf48SJohn Bampton
588897188dSmseidel```
5911bf6ff1SPeter Kovacscd aoo/main
6011bf6ff1SPeter Kovacsautoconf
6111bf6ff1SPeter Kovacs./configure <configure_switches>
6211bf6ff1SPeter Kovacs./bootstrap
6384cb8eb6Ssamuel100usource *.Set.sh
6411bf6ff1SPeter Kovacscd instsetoo_native
6511bf6ff1SPeter Kovacsbuild --all
668897188dSmseidel```
67a7f3bf48SJohn Bampton
6811bf6ff1SPeter KovacsNote that building OpenOffice can take several hours.
6911bf6ff1SPeter Kovacs
708897188dSmseidelThe default build will produce a setup version (e.g. setup program on Windows, dmg on macOS, rpm and deb packages on Linux) and an archived version.\
718897188dSmseidelThe output can be found in the <output> directory in instsetoo_native/<output_dir>/Apache_OpenOffice/...
72