Directory and File Name Schema


This document serves as a policy and contains important information for many projects, systems and components.


Old version

The previous version of this policy can be found here. The new version was already accepted by the Release Status Meeting.

Changes

Compared with the old policy the following has been changed:


Directories

Directories are created in the mirroring directory structure.
Directory names follow the filename and numbering schema of releases or developer builds respectively.


Files

File names follow the following schema. Each part is described in detail below.

(PRODUCT NAME)_(VERSION)_(TIMESTAMP)_(OS)_(ARCH)_(INSTALL TYPE)_(LANGUAGE).(FILE EXTENSION)

Separator Characters

The "-" (hyphen) is used to bind the data within a part if necessary (e.g., x86-64 or en-US).
The "_" (underscore) is used as separator to divide the different parts from each other (e.g., OOo_3.2.0 or x86_install).


Product Name

The product name can be one of the following:

Identifier Description
BrOo BrOffice.org used for a final release, Release Candidate and Beta Release.
OOo OpenOffice.org used for a final release, Release Candidate and Beta Release.
OOo-Dev Developer Snapshot. Can be installed in parallel to an OOo build.
OOo-SDK Software Development Kit.
OOo-Dev-SDK Software Development Kit as Developer Snapshot.
OOo-URE UNO Runtime Environment. (deprecated)

Version

The version can either be a final release, Release Candidate, Beta Release, branch from release or development codeline.

Example Type
3.2.0 Release version
3.2.0rc1 Release Candidate
3.0.0beta1 Beta Release
OOO320m7 Milestone from release codeline
DEV300m70 Milestone from development codeline

Timestamp (optional)

This identifier is optional. However, a Beta Release and Release Candidate always include a date stamp.

Format Example
YYYYMMDD 20100118

Operating System

The operating system can be one of the following:

Identifier Description
Win Microsoft Windows
Linux Linux
MacOS Apple Mac OS
Solaris Sun Solaris
FreeBSD FreeBSD

Architecture

The architecture can be one of the following:

Identifier Description
x86 Intel x86 (32-bit)
x86-64 Intel/AMD x86-64 (64-bit)
Sparc SPARC (32-bit)
PPC Power PC (32-bit)
IA64 Intel Itanium (64-bit)
HPPA HP PA-RISC (32-bit)
S390X IBM s390x (64-bit)

Install Type

The install type can be one of the following:

Identifier Description
install Full installation
install-wJRE Full installation with included Java Runtime Environment (JRE)
install-arc Full installation as archive
install-deb Full installation as Debian package (Linux only)
install-rpm Full installation as RPM package (Linux only)
install-rpm-wJRE Full installation as RPM package with included JRE (Linux only)
langpack Language pack
langpack-arc Language pack as archive
langpack-deb Language pack as Debian package (Linux only)
langpack-rpm Language pack as RPM package (Linux only)
src Source tarball

Language

The language can be any language that is specified in ISO 639-1.


Example Description
en-US English (US)
fr French
de German

File Extension

The file extension can be one of the following:

Identifier Description
dmg Apple Disk Image
exe Windows executable
sh Unix shell script
tar.bz2 Tar + Bzip2 archive
tar.gz Tar + Gnuzip archive
tbz Tar + Bzip2 archive
zip Zip archive

Examples

Archive builds

OOo_DEV300m70_Win_x86_install-arc_en-US.exe
OOo_DEV300m70_Linux_x86_install-arc_en-US.tar.gz
OOo_DEV300m70_Linux_x86-86_install-arc_en-US.tar.gz
OOo_DEV300m70_MacOS_x86_install-arc_en-US.dmg
OOo_DEV300m70_Solaris_Sparc_install-arc_en-US.tar.gz
OOo_DEV300m70_Solaris_x86_install-arc_en-US.tar.gz

Developer Snapshot

OOo-Dev_DEV300m70_Win_x86_install_en-US.exe
OOo-Dev_DEV300m70_Linux_x86_install-deb_en-US.tar.gz
OOo-Dev_DEV300m70_Linux_x86_install-rpm_en-US.tar.gz
OOo-Dev_DEV300m70_Linux_x86-64_install-deb_en-US.tar.gz
OOo-Dev_DEV300m70_Linux_x86-64_install-rpm_en-US.tar.gz
OOo-Dev_DEV300m70_MacOS_x86_install_en-US.dmg
OOo-Dev_DEV300m70_Solaris_Sparc_install_en-US.tar.gz
OOo-Dev_DEV300m70_Solaris_x86_install_en-US.tar.gz

Beta Release

OOo_3.0.0beta1_20080101_Win_x86_install-wJRE_en-US.exe
OOo_3.0.0beta1_20080101_Linux_x86_install-deb_en-US.tar.gz
OOo_3.0.0beta1_20080101_Linux_x86_install-rpm_en-US.tar.gz
OOo_3.0.0beta1_20080101_Linux_x86-64_install-deb_en-US.tar.gz
OOo_3.0.0beta1_20080101_Linux_x86-64_install-rpm-wJRE_en-US.tar.gz
OOo_3.0.0beta1_20080101_MacOS_x86_install_en-US.dmg
OOo_3.0.0beta1_20080101_Solaris_Sparc_install-wJRE_en-US.tar.gz
OOo_3.0.0beta1_20080101_Solaris_x86_install-wJRE_en-US.tar.gz

Release Candidate

OOo_3.2.0rc1_20100118_Win_x86_install-wJRE_en-US.exe
OOo_3.2.0rc1_20100118_Linux_x86_install-deb_en-US.tar.gz
OOo_3.2.0rc1_20100118_Linux_x86_install-rpm-wJRE_en-US.tar.gz
OOo_3.2.0rc1_20100118_Linux_x86-64_install-deb_en-US.tar.gz
OOo_3.2.0rc1_20100118_Linux_x86-64_install-rpm-wJRE_en-US.tar.gz
OOo_3.2.0rc1_20100118_MacOS_x86_install_en-US.dmg
OOo_3.2.0rc1_20100118_Solaris_Sparc_install-wJRE_en-US.tar.gz
OOo_3.2.0rc1_20100118_Solaris_x86_install-wJRE_en-US.tar.gz

Release

OOo_3.2.0_Win_x86_install_en-US.exe
OOo_3.2.0_Linux_x86_install-deb_en-US.tar.gz
OOo_3.2.0_Linux_x86_install-rpm_en-US.tar.gz
OOo_3.2.0_Linux_x86-64_install-deb_en-US.tar.gz
OOo_3.2.0_Linux_x86-64_install-rpm-wJRE_en-US.tar.gz
OOo_3.2.0_MacOS_x86_install_en-US.dmg
OOo_3.2.0_Solaris_Sparc_install-wJRE_en-US.tar.gz
OOo_3.2.0_Solaris_x86_install-wJRE_en-US.tar.gz

SDK

OOo-SDK_DEV300m70_Solaris_Sparc_install-arc_en-US.tar.gz
OOo-Dev-SDK_DEV300m70_Solaris_Sparc_install_en-US.tar.gz
OOo-SDK_3.0.0beta1_20080101_Solaris_Sparc_install_en-US.tar.gz
OOo-SDK_3.2.0rc1_20100118_Solaris_Sparc_install_en-US.tar.gz
OOo-SDK_3.2.0_Solaris_Sparc_install_en-US.tar.gz

Source tarballs (multiple files)

OOo-Dev_DEV300m70_src_binfilter.tar.gz
OOo-Dev_DEV300m70_src_core.tar.gz
OOo-Dev_DEV300m70_src_extensions.tar.gz
OOo-Dev_DEV300m70_src_l10n.tar.gz
OOo-Dev_DEV300m70_src_system.tar.gz
OOo-Dev_DEV300m70_src_testautomation.tar.gz

OOo_3.2.0rc1_20100118_src_binfilter.tar.bz2
OOo_3.2.0rc1_20100118_src_core.tar.bz2
OOo_3.2.0rc1_20100118_src_extensions.tar.bz2
OOo_3.2.0rc1_20100118_src_l10n.tar.bz2
OOo_3.2.0rc1_20100118_src_system.tar.bz2
OOo_3.2.0rc1_20100118_src_testautomation.tar.bz2

OOo_3.1.0_src_binfilter.tar.bz2
OOo_3.1.0_src_core.tar.bz2
OOo_3.1.0_src_extensions.tar.bz2
OOo_3.1.0_src_l10n.tar.bz2
OOo_3.1.0_src_system.tar.bz2
OOo_3.1.0_src_testautomation.tar.bz2

Source tarballs (single file)

OOo-Dev_DEV300m70_src.tar.bz2
OOo_3.0.0beta1_20080101_src.tar.bz2
OOo_3.2.0rc1_20100118_src.tar.bz2
OOo_3.2.0_src.tar.bz2