NeoOffice Build Instructions

From NeoWiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 14:18, 30 August 2011 (edit)
Pluby (Talk | contribs)
(Prerequisites - README only has 3.x build prerequisites)
← Previous diff
Revision as of 15:48, 20 August 2016 (edit) (undo)
Pluby (Talk | contribs)
(Remove out of date content)
Next diff →
Line 1: Line 1:
-{{redbox|'''N.B.''' If you redistribute your personal builds, you '''must''' remove all instances of the NeoOffice trademark (including those present within graphics) in order to be in compliance with the [[NeoOffice_CD_Distribution_%26_Trademark_Usage|NeoOffice Distribution & Trademark Usage Policy]]. '''Distribution of non-official builds using the NeoOffice trademark is prohibited.'''}}+{{redbox|'''Important:''' If you redistribute your personal builds, you '''must''' remove all instances of the NeoOffice trademark (including those present within graphics) in order to be in compliance with the [[NeoOffice_CD_Distribution_%26_Trademark_Usage|NeoOffice Distribution & Trademark Usage Policy]]. '''Distribution of non-official builds using the NeoOffice trademark is prohibited.'''}}
-== Building and Developing NeoOffice ==+NeoOffice build instructions are [http://www.neooffice.org/neojava/build.php here].
-''Supplemental information about building NeoOffice and the NeoOffice development process''+
- +
-===Build Instructions===+
- +
-Patrick Luby maintains the NeoOffice build instructions at +
-http://www.neooffice.org/neojava/build.php<!-- (instructions for 2.0 Alpha PowerPC [http://www.neooffice.org/neojava/earlyaccessbuild.php here])-->.+
- +
-The latest NeoOffice 3.x build configuration information can be found by selecting the "download" link for the most current revision of <tt>[http://anoncvs.neooffice.org/cgi-bin/cvsweb/neojava/README.txt neojava/README.txt]</tt> in cvsweb. <!--'''N.B.''' As of 2008-09-21, NeoOffice 3.0 Early Access will not yet build successfully.-->+
- +
-====Prerequisites====+
- +
-See the [http://www.neooffice.org/neojava/build.php#req official build instructions] and, for NeoOffice 3.x builds, the latest <tt>neojava/README.txt</tt> file in cvsweb as described above.+
- +
-===Getting Help===+
- +
-[http://porting.openoffice.org/servlets/SummarizeList?listName=mac Archives] of the [mailto:mac@porting.openoffice.org mac@porting.openoffice.org] mailing list are useful; you can search them for errors you encounter.+
- +
-You can also post questions in the [http://trinity.neooffice.org/modules.php?name=Forums&file=viewforum&f=9 NeoOffice Development] forum on trinity (and search it for errors), but be aware that the NeoOffice developers consider the process of compiling OpenOffice.org (even as a subset of NeoOffice) as a [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=8775#8775 "trial by fire"] and little hand-holding is available. +
- +
-Experience has shown that those who are unable to work through the OpenOffice.org build will be unable to do the debugging and other work necessary when fixing an existing bug in OpenOffice.org or NeoOffice or adding new code/features. (Such "hand-holding" also cuts into the limited time the volunteer developers have to fix actual bugs and improve Mac OS X integration.)+
- +
-Building OpenOffice.org on the Mac (and by extension NeoOffice) is often difficult because there is always some change to the code for Linux or Windows that makes OOo no longer buildable on Mac OS X. While Sun's engineers do now build on Mac OS X, they do not build for PPC, so changes for Windows or Linux can still easily break the build on Mac OS X and go undetected.<!-- Also, Sun routinely does not merge Mac OS X fixes into the next build. A patch may be integrated in the OOo 1.1.3 code but then not merged into the OOo 1.1.4 code, and fixes from the OOo 1.1.x codeline will not appear in the OOo 2.x codeline.-->+
- +
-===Source Code===+
- +
-<!--NeoOffice source code is available as a tarball on the latest release or milestone disk image. -->The very latest NeoOffice source code is always available in [http://www.neooffice.org/neojava/build.php cvs] (anoncvs syncs with the secure master repository every three hours beginning at 12:00 AM Pacific [PST/PDT] time).+
- +
-You can also [http://trinity.neooffice.org/cgi-bin/cvsweb/neojava/ browse the NeoOffice source online].+
- +
-====CVS tags====+
-''for use in the cvs checkout commands in the [http://www.neooffice.org/neojava/build.php NeoOffice Build Instructions]; in the format <tt>tag modulename</tt>'' +
- +
-A "release" tag checks out the code of a full release or milestone version (e.g., NeoOffice 1.2 Alpha) as available on NeoOffice.org but '''does not include any subsequent patches or bugfixes'''. A "stable branch" tag will check out the latest code for an active branch, including any code delivered in any released patches and any code recently committed to fix bugs (a "stable branch" that is current may have future milestones or releases based on it, e.g. the 1.2 Branch will be the basis of NeoOffice 1.2 Beta and NeoOffice 1.2 "final", and perhaps even a "point" release like NeoOffice 1.2.1, at some point). A "development" tag is the site of ongoing future development and '''may not even build''' yet. You can find additional "legacy" tags by [http://trinity.neooffice.org/cgi-bin/cvsweb/neojava/ browsing cvsweb].+
- +
-<u>Current</u>+
- +
-'''Release''' (''NeoOffice 3.1.2''): <tt>NeoOffice-3_1_2 NeoOffice</tt>+
- +
-'''Stable Branch''' ( <!--''3.1.2 Early Access Branch''-->''none currently''<!---->): <!--<tt>NeoOffice-3_0_2_branch NeoOffice</tt>-->+
- +
-'''Development''' (<!--''upgrade to OpenOffice.org 3.1.x codebase''-->''none currently''): <!--<tt>HEAD NeoOffice</tt>-->+
- +
-<u>Legacy</u>+
- +
-'''Release''' (''NeoOffice 2.2.6''): <tt>NeoOffice-2_2_6 NeoOffice</tt>+
- +
-'''Stable Branch''' (''2.2.6 Branch''): <tt>NeoOffice-2_2_6_branch NeoOffice</tt>+
- +
-<!--'''Development''' (--><!--''cancelled MacIntel effort for 1.1 series''--><!--''none currently''): --><!--<tt>gcc4_x86_experimental_branch NeoOfficeJ</tt>-->+
- +
-{{alertbox|NeoOffice/J 1.1 Dev Note}}+
- +
-====Build Matrix====+
- +
-{| width="95%" cellspacing="2" style="text-align: right;"+
-|- style="border-bottom: 2px solid black;"+
-! Build Host<br>Neo Version !! 10.3.9 !! 10.4.x PPC !! 10.4.x Intel !! 10.5.x PPC !! 10.5 Intel !! 10.6 Intel+
-|- +
-! width=12% | NeoOffice 2.2.x<!--<br>Early Access-->+
-| style="background-color: red;" width=15% | '''Will not build''' || style="background-color: #0C3;" width=15% | gcc 3.3<br>''Xcode 2.4.1''<br>'''official builds''' || style="background-color: #0C3;" width=15% | gcc 4.0.1<br>''Xcode 2.4.1''<br>'''official builds''' || style="background-color: red;" | '''Will not build''' || style="background-color: red;" | '''Will not build''' || style="background-color: red;" | '''Will not build'''+
-|- +
-! NeoOffice 3.0.x+
-| style="background-color: red" | '''Will not build<br>Will not run''' || style="background-color: #0C3;" | gcc 4.0.1<br>''Xcode 2.5'' <br>'''official builds''' || style="background-color: #0C3;" | gcc 4.0.1<br>''Xcode 2.5'' <br>'''official builds''' || style="background-color: orange" | '''Unlikely to build<br>(building not supported)''' || style="background-color: orange" | '''Unlikely to build<br>(building not supported)''' || style="background-color: orange" | '''Unlikely to build<br>(building not supported)'''+
-|}+
- +
-===Forum Threads===+
-''The following threads or posts from trinity '''may''' contain useful tips for beginners wishing to build NeoOffice:''+
-* [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=11298#11298 Setting up your build environment]+
-: Along those lines, the NeoOffice developers also build the OpenOffice.org dependencies themselves rather than relying on Fink or DarwinPorts.+
-* [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=19756#19756 Avoiding problems with OOo anoncvs]+
-* [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=1364 Errors on Build]+
-* [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=1508 Tips for Building Neo/J]+
-: '''N.B.''' the above threads apply to the NeoOffice/J 1.1 release; the build requirements have changed slightly beginning with NeoOffice 1.2 Alpha.+
-* [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=1498 Compiling HEAD on 10.4]+
-: These changes have all been committed to HEAD and the NeoOffice 1.2 Alpha codebase, but there are some helpful tips about the NeoOffice build system and cvs in the later pages of the thread.+
-* [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=11465#11465 More explanation of the Neo build system]+
-* [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=18560#18560 Brief Q&A on how the Neo build system works and how to study it]+
-* [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=19084#19084 Another build system tip]+
-<!--* [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=1733 gcc4 porting]+
-: For those crazy enough to live on the bleeding edge, or those with Developer Transition Kits :-)-->+
-* More cvs tips: [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=11238#11238], [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=19079#19079], [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=19589#19589]+
-* [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=25404#25404 Updating a source tarball to cvs HEAD] (in this case, from the Aqua Beta 3 tarball to the latest HEAD patch code for Aqua Beta 3)+
-* [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=20888#20888 How to update your build when NeoOffice moves from one OOo version to another]+
-<!--* [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=2013 CVS tags for NeoOffice 1.2 release, NeoOffice 1.2 branch, and future MacIntel porting work] -->+
-<!-- * [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=13934#13934 Xcode versions for HEAD/NeoOffice 2.0] obsoleted via the "Readme.txt" file -->+
-* [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=14297#14297 building HEAD/NeoOffice 2.0 on 10.3.9]+
-* [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=2063 progress of NeoOffice 2.0 builds]+
-* [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=18919#18919 excising the “NeoOffice” trademark from your build]+
-<!-- Hide this here; it's a tip from an obsolete thread i removed, but when we get a real docuemnt, it's useful:+
- +
-So, if your build is still in the OOo phase of the build, you don't need to stop your build. Instead, you can just cd into the Neo/J vcl and setup2 directories and invoke "cvs update -d".+
- +
-Of course, if you build is already done, you will need to delete the "build.neo_vcl_patch" and "build.neo_setup2_patch" patch files, cvs update the neojava directory, and invoke "make all".+
--->+
- +
-===Development Plans===+
- +
-<!--For reference, the current (late 2005-2006) development plans are roughly outlined in [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=1481 this thread]-->NeoOffice development plans are usually outlined in the [https://trinity.neooffice.org/modules.php?name=Forums&file=viewforum&f=9 NeoOffice Development] forum on trinity.+
- +
-You can also check [http://bugzilla.neooffice.org/query.php?op=doquery&status%5b%5d=2 the bugs marked New/Deferred] in Bugzilla to see specific items the developers plan on implementing as time and resources permit.+
- +
-Ed Peterlin also maintains [http://www.dashboardbuddha.com/OOo/specs/index.html a set of specifications] for adding Mac-specific features (or, things he'd like to add, if he ever gets time after adding Aqua widgets!).+
- +
-====Other Tasks====+
- +
-Help is always welcome in debugging and fixing existing bugs; check the [http://bugzilla.neooffice.org/query.php?op=doquery&status%5b%5d=1 Unconfirmed] and [http://bugzilla.neooffice.org/query.php?op=doquery&status%5b%5d=4 Reopened] bugs (the [http://bugzilla.neooffice.org/query.php?op=doquery&status%5b%5d=3 Assigned] ones are generally being worked upon by the developer in question). For more information about working in the NeoOffice Bugzilla, see the [[Bugzilla Guide#Life-cycle of a Bug|Life-cycle of a Bug]] section of the [[Bugzilla Guide]].+
- +
-===Legacy Builds===+
- +
-If you want to build NeoOffice 2.x, the following information may be helpful:+
- +
-* [http://porting.openoffice.org/mac/build_680_X11.html OpenOffice.org 2.0.x for Mac OS X build instructions]+
-* The latest NeoOffice 2.x build configuration information can be found by selecting the "download" link for the most current revision of <tt>[http://anoncvs.neooffice.org/cgi-bin/cvsweb/neojava/README.txt?only_with_tag=NeoOffice-2_2_6_branch neojava/README.txt]</tt> on the <tt>NeoOffice_2_2_6_branch</tt> in cvsweb.+
- +
-If you want to build NeoOffice 1.2.x, the following information may be helpful:+
- +
-* [http://porting.openoffice.org/mac/build_11_X11.html OpenOffice.org 1.1.x for Mac OS X build instructions]+
-* [http://porting.openoffice.org/servlets/SummarizeList?listName=dev Archives] of the [mailto:dev@porting.openoffice.org dev@porting.openoffice.org] mailing list are useful; you can search them for errors you encounter.+
- +
-'''N.B.''' Distribution of non-current versions NeoOffice is '''prohibited''' by the [[NeoOffice_CD_Distribution_%26_Trademark_Usage|NeoOffice CD Distribution & Trademark Usage Policy]] '''if the software is branded as “NeoOffice”'''.+
{{botlangbarEN|[[Fr:Instructions_de_Compilation_de_NeoOffice|Français]] [[Es:Instrucciones_para_la_construcci%C3%B3n_de_NeoOffice_Build_Instructions|Español]] [[nl:NeoOffice Bouw Instructies|Nederlands]]}} {{botlangbarEN|[[Fr:Instructions_de_Compilation_de_NeoOffice|Français]] [[Es:Instrucciones_para_la_construcci%C3%B3n_de_NeoOffice_Build_Instructions|Español]] [[nl:NeoOffice Bouw Instructies|Nederlands]]}}
[[Category:NeoOffice]][[Category:Contributing]] [[Category:NeoOffice]][[Category:Contributing]]

Revision as of 15:48, 20 August 2016

Important: If you redistribute your personal builds, you must remove all instances of the NeoOffice trademark (including those present within graphics) in order to be in compliance with the NeoOffice Distribution & Trademark Usage Policy. Distribution of non-official builds using the NeoOffice trademark is prohibited.

NeoOffice build instructions are here.


This article in other languages: Français Español Nederlands
Personal tools