|
|
NeoOffice Build Instructions
From NeoWiki
| Revision as of 06:29, 24 October 2005 (edit) Sardisson (Talk | contribs) m (rebranding) ← Previous diff |
Revision as of 10:41, 26 October 2005 (edit) (undo) Sardisson (Talk | contribs) (add some "developer documentation") Next diff → |
||
| Line 1: | Line 1: | ||
| - | == Building NeoOffice == | + | == Building and Developing NeoOffice == |
| + | |||
| + | ===Build Instructions=== | ||
| Patrick Luby maintains the NeoOffice build instructions at | Patrick Luby maintains the NeoOffice build instructions at | ||
| http://www.planamesa.com/neojava/build.php | http://www.planamesa.com/neojava/build.php | ||
| - | Because building NeoOffice requires building [[OpenOffice.org_Mac_OS_X_%28X11%29|OpenOffice.org/X11]], you might find the [http://porting.openoffice.org/mac/build_11_X11.html OpenOffice.org 1.1.x for Mac OS X build instructions] helpful. | + | Because building NeoOffice requires building [[OpenOffice.org_Mac_OS_X_%28X11%29|OpenOffice.org/X11]], you might find the [http://porting.openoffice.org/mac/build_11_X11.html OpenOffice.org 1.1.x for Mac OS X build instructions] helpful. |
| + | |||
| + | ===Getting Help=== | ||
| + | |||
| + | [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. | ||
| + | |||
| + | You can also post questions in the [http://trinity.neooffice.org/modules.php?name=Forums&file=viewforum&f=9 NeoOffice/J 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 adding code or fixing an existing bug in OpenOffice.org or NeoOffice. (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. Sun's engineers do not build on Mac OS X so changes for Windows or Linux can easily break the build on Mac OS X and 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 latest code is always available in [http://www.planamesa.com/neojava/build.php cvs]. | ||
| You can also [http://trinity.neooffice.org/cgi-bin/cvsweb/neojava/ browse the NeoOffice source online]. | You can also [http://trinity.neooffice.org/cgi-bin/cvsweb/neojava/ browse the NeoOffice source online]. | ||
| + | |||
| + | ===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&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&t=1733 gcc4 porting] | ||
| + | : For those crazy enough to live on the bleeding edge, or those with Developer Transition Kits :-) | ||
| + | * [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=11238#11238 More cvs tips] | ||
| + | |||
| + | ===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]. | ||
| + | |||
| + | 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's like to add, if he ever gets time after adding Aqua widgets!). | ||
| [[Category:NeoOffice/J]][[Category:Contributing]] | [[Category:NeoOffice/J]][[Category:Contributing]] | ||
Revision as of 10:41, 26 October 2005
Contents |
Building and Developing NeoOffice
Build Instructions
Patrick Luby maintains the NeoOffice build instructions at http://www.planamesa.com/neojava/build.php
Because building NeoOffice requires building OpenOffice.org/X11, you might find the OpenOffice.org 1.1.x for Mac OS X build instructions helpful.
Getting Help
Archives of the dev@porting.openoffice.org mailing list are useful; you can search them for errors you encounter.
You can also post questions in the NeoOffice/J 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 "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 adding code or fixing an existing bug in OpenOffice.org or NeoOffice. (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. Sun's engineers do not build on Mac OS X so changes for Windows or Linux can easily break the build on Mac OS X and 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 latest code is always available in cvs.
You can also browse the NeoOffice source online.
Forum Threads
The following threads or posts from trinity may contain useful tips for beginners wishing to build NeoOffice:
- Along those lines, the NeoOffice developers also build the OpenOffice.org dependencies themselves rather than relying on Fink or DarwinPorts.
- 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.
- 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.
- For those crazy enough to live on the bleeding edge, or those with Developer Transition Kits :-)
Development Plans
For reference, the current (late 2005-2006) development plans are roughly outlined in this thread.
You can also check 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 a set of specifications for adding Mac-specific features (or, things he's like to add, if he ever gets time after adding Aqua widgets!).
