Project tools

Project home

Membership

Announcements

Mailing lists

Documents & files

Version control - CVS

Issue tracker

Tools (with Pages)

dmake

Tinderbox...

BuildBot results

Tinderbox

Search

This project All projects

Advanced search

Google search

How do I...

• Sitemap
• FAQ
• Get help?

start:

Tools Project

Project Owner: Martin Hollmichel

The tools project is an umbrella for projects supporting the infrastructure of OpenOffice.org.

Getting started with OOo_development: Before you start you might want to read the tips and ideas in the developer support guides, or just browse the Wiki pages.

There are also specifications available for some features.

Build Environment

OpenOffice.org Development with child workspaces (CWS):

• Overview
• Tools
  
• Policies
  
• Introduce a new module
  

Using CVS to get the source

• Overview of OpenOffice.org codelines

• Descriptions of current CVS branches and their status

• Downloading the source from CVS

• CVS Modules available from OpenOffice.org.

Building the source

• Background Information for building OpenOffice.org

• Description of the Build Process

  The build requirements and instructions changed between OpenOffice.org 1.1.x, the OpenOffice.org 2.0.x versions and again for the current development versions:

  • Instructions for current OpenOffice.org development versions

    These build instructions are currently migrated to the OpenOffice.org wiki and are not finished yet. Please help improving them.
    Use the build instructions for the OpenOffice.org 2.x version from below as an additional reference.

  • Instructions for OpenOffice.org 2.0.x

    • Linux
    • Solaris
    • Mac OS X (X11) or Mac OS X (Aqua)
    • Windows with Microsoft Visual C++ .NET2003 Compiler
      with Cygwin tools
      with 4NT shell - This is untested and most propably broken. Use on your own risk.
    • Windows with Microsoft Visual C++ 2005 Express Compiler click here

  • Instructions for OpenOffice.org 1.1.x and older

    • Linux
    • Solaris
    • Mac OSX
    • Windows with Microsoft Visual C++ .NET2002 Compiler
      with Cygwin tools
      with 4NT tools

• Build Environment description ( for OpenOffice 1.9.x / 2.x series )

• Diagram of inter-project dependencies by C.P. Hennessy

• Tips for Troubleshooting the build.

Testing the code

• Tinderbox
  With many developers working on different platforms on the same codebase easiely leads to incompatibilities. A Tinderbox allows you to check the "buildability" of the current code and helps finding who broke the build. The Tinderbox provides the build logfiles so that it is easy to check what (and who) broke the build.

  If you have some CPU time to burn please consider running a tinderbox client. We need many tinderbox client machines that are doing builds!

  Tinderbox topics/issues can be discussed on the tinderbox@tools.openoffice.org mailing list.

Working on the code

• Coding Guidelines (.sxw)

• Usage Of Java Policies

• Checklist for C++ Interface Reviews (.sxw)

• Debugging OpenOffice.org with Valgrind (.sxw)

Tools description

• Description of Autodoc (automatic documentation generation)
  ( for C++ and UNO-IDL;commandline syntax).

Performance and Profiling

Tools for performance measuring and related tasks.

• Performance Tuning and tools
• Profiling tools

Quality Assurance (QA)

QA is a separate project.

• Description of the Smoke Test
• Issue Writing Guidelines

Release Engineering

• Overview of Branches and Roadmap of OpenOffice.org releases and description of branches.
• Environment Information System is a Child Workspace (CWS) browsing interface
• File Naming Scheme

Modules in Tools Project
Module	Function
solenv	Solar environment.
dmake	A make utility similar to GNU make or the Workshop dmake. This utility has an irregular syntax but is available for Linux, Solaris, Win32 and other platforms. Learn more about dmake.
rscpp	Resource compiler preprocessor.
xml2cmp	Processor for UNO component descriptions.
jtools	Java applications needed to build Java in the build environment.
boot	Bootstrapping of build tools
config_office	Configuration of Build environment
soltools	Tools for the Solar Environment (checkdll, cpp, javadep, ldump, mkdepend)
autodoc	Tool for automatic documentation generation from C++ and UNO-IDL

To Do's
List	Contact
Usage of any Java compiler in the build environment The use of any Java should be possible there are free implementations such as Kaffe. There is even a possibility of using gcj in some instances.	haggai@openoffice.org
make tools Right now dmake uses some features other make tools do not have: $mktmp, boolean expressions etc. It has to be discussed if we need an alternative to dmake of if we want to stay with dmake.	martin.hollmichel at sun.com
Investigate alternative free Windows Compiler for OpenOffice.org build Mingw. Please see tracking Issue Digital Mars Free C++ compiler Also the new free tools from Microsoft. Some parts of Visual C are missing from the free version however.	martin.hollmichel at sun.com

 

$Revision: 1.97 $ $Date: 2007/06/26 13:39:07 $