Difference between revisions of "Chart2"

Revision as of 15:05, 11 April 2006

This page gathers information about the new chart implementation of OpenOffice.org.

HERE - ADD some more information to make it look less empty...

Compiling the new chart module

The first step anyone need to achieve before starting to develop on the chart module is compiling OpenOffice.org with the needed modifications for the new chart module. OpenOffice.org provides two main ways to compile it : the "Vanilla" way and the "OOoBuild" way. Let's explain what they are and the differences between those two ways.

Compiling OpenOffice.org : the theory

Vanilla

Vanilla is the "standard" way to compile OOo. To compile OOo the "Vanilla" way, you only need to download the sources, unzip them, and follow the instructions given on the page [Add a link to the build steps from]. We will give Chart-specific details about this in the following sections.

OOoBuild

To make it simple, OOoBuild is a "wrapper" around the OpenOffice.org build process to make compiling OOo more straight-forward. Some of the enhancements added are :

• patches for known compiling problems
• integration with "ccache" and "icecream" to speed-up the process
• linux distribution specific compiling steps (specific splash screen for Fedora...)

So, to compile OOo with OOoBuild, just just need to download OOoBuild and put the OOo standard sources in a specific directory.

Compiling OpenOffice.org : the practice

Commmon steps

dependencies

First of all before starting to compile anything, you will need to install all the dependencies and tools needed for the compiling steps. On the Tools project page, you should find all the information on the "Building the source" section :

http://tools.openoffice.org/

There, you should read the different sub-sections, they will give you a nice introduction on how everything works. You should also notice that the steps are different on each OS.

Vanilla

Downloading the sources

Once you have all the dependencies installed, you will need to download the sources of OOo

At the moment, you need to download the milestone m152.

Télécharger la version m152 mettre update les fichiers pour correspondre au cws chart2mst3

Configuring

- Créer un fichier dans lequel on met toutes les options de compilation. - Détailler les options utiles. - Lancer le configure - Vérifier que toutes les dépendances sont remplies.

Building the tools (dmake...)

During the compiling step, the compiling process needs some tools to achieve the build. Before compiling, you need to build those tools. For example,

• dmake
• ...

To compile the tools, just type :

cd openOffice.org_m152/
./bootstrap

Setting the environment

Before starting to compile OOo, you need to set all the environment variables

tcsh
source LinuxIntelEnv.set
setenv nodep "TRUE" ; setenv NO_HIDS "TRUE" ; setenv MAXPROCESS 2
rehash

• nodep  : inhibits generation of dependency files
• maxprocess : sets the number of parallel dmakes per dir
• NO_HIDS prevents generation of HIDs (that's used for automated testing - you won't need it)

Compiling (finally...;-)

cd instsetoo_native
build -P2 --dlv_switch -link --all

• -P2 : fires up more than one dmake in _different_ dirs - thus, you end up with a maximum for 4 parallel compilations
• --dlv_switch -link : tells deliver not to copy files to solver, but link instead -> saves space

OOoBuild

Downloading OOoBuild

Downloading the sources

TODO : Describing the OOoBuild build process.

The bugs reported and the solutions.

During the compiling step, you will not be able to compile the whole code

ERROR 1 : the odk / sdk error

While compiling the Chart module, in the ODK project an error will rise :

 build -- version: 1.145
 =============
 Building project sdk_oo
 =============
 /home/pagalmes/workspace/OpenOffice/sdk_oo/pack/unzip_odk
 dmake:  Error -- `/home/pagalmes/workspace/OpenOffice/solver/680/unxlngi6/bin/odk_oo.zip' not found, and can't be made
 '---* RULES.MK *---'
 ERROR: Error 65280 occurred while making /home/pagalmes/workspace/OpenOffice/sdk_oo/pack/unzip_odk

the solution

Just ignore the two osdk and sdk_oo project not needed for compiling OOo :

cd instsetoo_native/util && build--since sdk_oo

ERROR 2 : the mandriva desktop error

While compiling, you may get the following error message :

1 module(s):
        sysui
need(s) to be rebuilt
 
Reason(s):
 
ERROR: error 65280 occurred while making /home/pagalmes/workspace/OpenOffice/sysui/desktop/mandriva
ERROR: error 65280 occurred while making /home/pagalmes/workspace/OpenOffice/sysui/desktop/redhat
 
Attention: if you build and deliver the above module(s) you may prolongue your the build issuing command "build --from sysui"

the solution

Try building the sysui project :

cd sysui
build

An error message should rise from this module.

Eror message :

[...] /home/pagalmes/workspace/OpenOffice/sysui/unxlngi6.pro/bin/desktop-integration/openoffice.org-mandriva-menus-2.0.2-152.noarch.rpm :
no such file or directory

Error code 1, while making
'/home/pagalmes/workspace/OpenOffice/sysui/unxlngi6.pro/bin/desktop-integration/openoffice.org-mandriva-menus-2.0.2-152.noarch.rpm'

This problem is solved by creating the following directory :

OpenOffice/sysui/unxlngi6.pro/bin/desktop-integration

Note : This error has been corrected with m155

Development life cycle

How to build only a particular project :

How to rebuild everything from scratch : (erase the ".dlp" files or smthg like that ??)

How to test the modifications done to the chart module :

Developping for the new chart module

The common steps.

Documentation

Some useful information

• Web page : http://graphics.openoffice.org/chart/chart.html
• specs : http://specs.openoffice.org/chart/index.html
• Current CWS Name : [chart2mst3]