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:
- All files for Beta Releases and Release Candidates contain a timestamp. Archive builds, Dev builds and final releases will remain without one.
- The version of dev builds is no longer separated by a "_" to get rid of a wrong separator.
- Consolidated the "Intel" and "x86" ARCH into "x86" only, also to separate better against "x86-64".
- Renamed the "Win32" OS into "Win" as the ARCH addition which is following defines the architecture already.
- The "OS" and "ARCH" parts are also separated by an "_" (underscore).
- Created complete new install types.
- Using the "install-arc" install type for all builds of type "archive".
- JRE builds are put together with the install type to get rid of this optional part.
- Deb builds are put together with the install type to get rid of this optional part.
- There is no default package for Linux. The install type "install-deb" or "install-rpm" is always added.
- There is no default language. All installation sets include a language code.
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.exeOOo_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.exeOOo-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.exeOOo_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.exeOOo_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.exeOOo_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.gzOOo-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.gzOOo-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.bz2OOo_3.0.0beta1_20080101_src.tar.bz2
OOo_3.2.0rc1_20100118_src.tar.bz2
OOo_3.2.0_src.tar.bz2