xref: /trunk/README.md (revision cf8e6a53ed981a205d7700be9a04dd40a005f9f6)
1<!--
2 Licensed to the Apache Software Foundation (ASF) under one
3 or more contributor license agreements.  See the NOTICE file
4 distributed with this work for additional information
5 regarding copyright ownership.  The ASF licenses this file
6 to you under the Apache License, Version 2.0 (the
7 "License"); you may not use this file except in compliance
8 with the License.  You may obtain a copy of the License at
9
10   http://www.apache.org/licenses/LICENSE-2.0
11
12 Unless required by applicable law or agreed to in writing,
13 software distributed under the License is distributed on an
14 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 KIND, either express or implied.  See the License for the
16 specific language governing permissions and limitations
17 under the License.
18-->
19
20# Apache OpenOffice<sup>®</sup>
21
22The Apache OpenOffice project (AOO) provides a full featured office productivity suite based on open standards.
23It is the continuation of the OpenOffice.org project.
24
25For detailed information about Apache OpenOffice please visit the [Project Website](https://openoffice.apache.org/).
26
27Apache OpenOffice is a very large project with many components and mainly implemented in C++ but also in Java, Perl, Python and other languages.
28
29Currently supported platforms include:
30
31- Microsoft Windows
32- macOS (OS X)
33- Linux variants
34- FreeBSD
35- OS/2
36
37OpenOffice is used by millions of users worldwide and with more than 390 million downloads it is one of the most successful open source projects.
38
39# Getting the latest sources via Git
40
41You can always checkout the latest source via Git using the following command:
42
43```
44git clone https://gitbox.apache.org/repos/asf/openoffice.git aoo
45```
46
47For further information visit [https://openoffice.apache.org/source.html](https://openoffice.apache.org/source.html).
48
49# Building Apache OpenOffice
50
51Apache OpenOffice is a big project and depends on several other external libraries.\
52The list of prerequisites varies for the different platforms.
53
54A comprehensive and complete building guide can be found in the [Project Wiki](https://wiki.openoffice.org/wiki/Documentation/Building_Guide_AOO).
55
56With having all prerequisites in place you can simply run
57
58```
59cd aoo/main
60autoconf
61./configure <configure_switches>
62./bootstrap
63source *.Set.sh
64cd instsetoo_native
65build --all
66```
67
68Note that building OpenOffice can take several hours.
69
70The 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.\
71The output can be found in the <output> directory in instsetoo_native/<output_dir>/Apache_OpenOffice/...
72