Difference between revisions of "Getting the source"

From Apache OpenOffice Wiki
Redirect page
Jump to: navigation, search
(Checking out a CWS through CVS: no space between hash bang; echo before login; cvs update -dP for new directories, pruning empty ones; use pushd/popd to not run wild with cd .. just in case)
 
(25 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{|
+
#REDIRECT [[‎Documentation/Building Guide/Getting the source]]
|
+
=== Source code ===
+
 
+
The source code can be downloaded as tarballs, e.g. [http://download.openoffice.org/2.2.1/source.html here for OOo2.2.1]. In case there are newer releases or for developer snapshots please see the [http://download.openoffice.org/ Download Central] ''Development'' section.  The source is huge, so it was split to several files, for newer releases than OOo2.1 substitute OOo_2.1.0_ accordingly:
+
 
+
* <strong>OOo_2.1.0_src_core.tar.bz2</strong> - the necessary part for each build, the other tarballs depend on this one.
+
* OOo_2.1.0_src_binfilter.tar.bz2 - the filters for old binary [[StarOffice]] formats.
+
* OOo_2.1.0_src_l10n.tar.bz2 - translations to other languages than English and German.
+
* OOo_2.1.0_src_sdk.tar.bz2 - OOo SDK (Software Development Kit).
+
* OOo_2.1.0_src_system.tar.bz2 - libraries that usually are on a standard Linuxsystem and it's not necessary to build own version on Linux. For a Windows build this package is usually required.
+
 
+
For a full build you need them all. For development, <strong>src_core</strong> is usually all you need.
+
 
+
Download them to one directory and unpack them.  Information how to checkout from CVS follows.
+
 
+
=== Vanilla up-stream ===
+
 
+
You might be interested particulary in the [http://tools.openoffice.org/dev_docs/build_linux.html#GetTheSourceCode Get the source code] section in the build guide (for Linux, but it is quite similar for all the platforms).
+
 
+
export 'CVSROOT=:pserver:anoncvs@anoncvs.services.openoffice.org:/cvs'
+
cvs login
+
(CVS password: anoncvs)
+
cvs co -r <milestone> OpenOffice2
+
 
+
The tool to browse project [http://tools.openoffice.org/source/browse/tools/ source code online] has some [http://tools.openoffice.org/servlets/ProjectSource additional hints].
+
 
+
If you want just to test development releases, you can download already compiled builds from [http://download.openoffice.org/680/]. List of available Mac builds is in [[Mac OS X Development Builds]].
+
 
+
=== ooo-build ===
+
 
+
There are loads of versions of OO.o, and several choices of
+
branch, with multiple outstanding patch sets.
+
I recommend you build from up-stream CVS HEAD milestones
+
(SRC680 milestones), with patch sets to make them easier to
+
build from [http://go-ooo.org/packages/SRC680]
+
 
+
The very latest ooo-build (a small ~1.5Mb build wrapper) can
+
be got from SVN thus:
+
 
+
<pre>
+
svn co http://svn.gnome.org/svn/ooo-build/trunk ooo-build
+
</pre>
+
 
+
<strong>Note:</strong> You are going to need to download
+
an additional ~150Mb of compressed source, and have ~3Gb
+
of space to unpack and build it in.
+
 
+
 
+
== Checking out a CWS through CVS ==
+
 
+
''This section is a draft!''
+
 
+
First, find the CWS name such as picom.  Then, lookup the CWS name in EIS (e.g., [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Id=5112&logon=true&OpenOnly=false&Section=All picom]).  Notice "Milestone (current)" is m222 (in this example as of time of writing): that is the base milestone.  Then, notice the affected modules listed under "Modules & Files."
+
 
+
You will checkout the base milestone from CVS.  The convention for base milestone is SRC680_m### (later DEV300_m###?). Then in each affected module (where a module is basically a directory), you will update the module with CVS.  The convention for the revision tag for the CWS is cws_src680_####.
+
 
+
Here is a script.
+
 
+
<pre>
+
#!/bin/bash
+
# configure these variables according to the particular CWS
+
AFFECTED_MODULES="basebmp basegfx canvas comphelper cppcanvas \
+
        desktop filter goodies offapi offuh psprint sal  \
+
        slideshow solenv testshl2 tools unotools vcl xpdf"
+
BASE_MILESTONE_TAG=SRC680_m222
+
CWS_TAG=cws_src680_picom
+
 
+
export 'CVSROOT=:pserver:anoncvs@anoncvs.services.openoffice.org:/cvs'
+
echo Enter the password is anoncvs
+
cvs login
+
cvs co -r $BASE_MILESTONE_TAG OpenOffice2
+
for d in $AFFECTED_MODULES
+
do
+
        echo "updating module $d"
+
        pushd $d
+
        cvs up -dP -r $CWS_TAG
+
        popd
+
done
+
</pre>
+
 
+
== See also ==
+
 
+
*[[Building]]
+
| valign="top" |
+
{{Getting_It|Languages}}
+
|}
+
 
+
 
+
[[Category:Development]]
+

Latest revision as of 11:41, 2 September 2009

Personal tools