Difference between revisions of "Documentation/Building Guide/Getting the source"
B michaelsen (Talk | contribs) m (→Source Tarballs (for package maintainers)) |
B michaelsen (Talk | contribs) |
||
Line 54: | Line 54: | ||
For a full build you need them all. For development, the '''core''' package is usually all you need. | For a full build you need them all. For development, the '''core''' package is usually all you need. | ||
− | Unpack the tarballs one at a time to a directory. They will create a new directory with the name of the milestone, such as | + | Unpack the tarballs one at a time to a directory. They will create a new directory with the name of the milestone, such as <tt>OOO310_m11</tt>. This folder will from now on be the <code>$SRC_ROOT</code>, when you run <code>./configure</code> it will create a shell-script that will set the environment variable to this path. |
− | + | {{Template:Documentation/Caution|Avoid using winzip to extract the downloaded source archive. Observed problems include: | |
+ | * CR-LF errors that can affect makefiles and cause compile errors | ||
+ | * Certain files unpacked into root folder, esp. likely when actual path is deeply nested (e.g. <code>foo/bar/source/foo/java/org/x/y/z/w/LongFileName.hmm</code>) which again causes mysterious compile errors. | ||
+ | Use the tar from Cygwin instead: | ||
+ | <pre>tar xvzf OOo_3.x.x_src_core.tar.gz</pre>}} | ||
= SCM-Access (for developers) = | = SCM-Access (for developers) = | ||
Checking out a milestone (a stable development version released by RelEng | Checking out a milestone (a stable development version released by RelEng | ||
Line 82: | Line 86: | ||
= Footnotes = | = Footnotes = | ||
− | <span id="Foot1"><sup>1</sup> It's not absolutely necessary to build own versions for these modules on Linux. If you intend to build on Linux '''without''' the '''system''' tarball: | + | <span id="Foot1"><sup>1</sup>{{Template:Documentation/Note|It's not absolutely necessary to build own versions for these modules on Linux. If you intend to build on Linux '''without''' the '''system''' tarball: |
* You will need to tell ./configure explicitly to use the system libraries for the software that is otherwise contained in this tarball. Otherwise the build will fail. | * You will need to tell ./configure explicitly to use the system libraries for the software that is otherwise contained in this tarball. Otherwise the build will fail. | ||
* System software is in active development. If it has changed significantly (and Mozilla sometimes does), the build may fail or OpenOffice.org may not work correctly. | * System software is in active development. If it has changed significantly (and Mozilla sometimes does), the build may fail or OpenOffice.org may not work correctly. | ||
− | * unowinreg.dll - Do not be fooled by the .dll extension. Without it, the build will fail on Linux and it is not included in the core package. Don't worry about downloading this now because the build process will tell you where to get it and where to stick it to proceed. | + | * unowinreg.dll - Do not be fooled by the .dll extension. Without it, the build will fail on Linux and it is not included in the core package. Don't worry about downloading this now because the build process will tell you where to get it and where to stick it to proceed.}} |
</span> | </span> | ||
{{PDL1}} | {{PDL1}} |
Revision as of 09:30, 19 July 2009
Building Guide
|
Introduction Getting the source |
The source code can be fetched in several ways, as described below.
Contents
Source Tarballs (for package maintainers)
The latest release version of the source code can be downloaded as tarballs from Download, see Source on the right.
The source is pretty big and has therefore been split into several files.
Tarball | Description |
---|---|
OOo_3.x.x_src_core.tar.bz2 | The necessary part for each build, the other tarballs depend on this one. |
OOo_3.x.x_src_system.tar.bz2 | Libraries that usually exist on a standard Linux system1. For a Windows build this package is usually required. |
OOo_3.x.x_src_binfilter.tar.bz2 | The filters for old binary StarOffice formats |
OOo_3.x.x_src_l10n.tar.bz2 | Translations of the software for many languages |
OOo_3.x.x_src_extensions.tar.bz2 | Extensions source package |
OOo_3.x.x_src_testautomation.tar.bz2 | Automated test suite (optional) |
For a full build you need them all. For development, the core package is usually all you need.
Unpack the tarballs one at a time to a directory. They will create a new directory with the name of the milestone, such as OOO310_m11. This folder will from now on be the $SRC_ROOT
, when you run ./configure
it will create a shell-script that will set the environment variable to this path.
SCM-Access (for developers)
Checking out a milestone (a stable development version released by RelEng
svn checkout svn://svn.services.openoffice.org/ooo/tags/DEV300_mXX/
Replace XX with the highest currently available milestone.
The files will be placed in the current directory.
See:
http://svn.services.openoffice.org/ooo/tags/
for a list of available milestones. Template:Documentation/Note Template:Documentation/Tip
See also
Footnotes
Content on this page is licensed under the Public Documentation License (PDL). |