blob: 7f5bbf9237a472b9c4df54ef3ac9541a2db19e6e [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Directory and File Name Schema</title>
<link rel="stylesheet" type="text/css" href="http://www.openoffice.org/branding/css/style.css" media="screen"/>
<link rel="stylesheet" type="text/css" href="http://www.openoffice.org/branding/css/print.css" media="print"/>
<style type="text/css">
h2, h3, h4, h5 { border: 0; }
h2 { margin-bottom: 0; }
table.rel { margin: 1em 1em 0 0; background: #f9f9f9; border: 1px #aaaaaa solid; border-collapse: collapse; }
table.rel td { border: 1px #aaaaaa solid; padding: .2em 1em .2em .2em; font-size: 0.8em; }
table.rel th { background: #f2f2f2; text-align: left; border: 1px #aaaaaa solid; padding: 0.2em; font-size: 0.8em; }
</style>
</head>
<body>
<h1>Directory and File Name Schema</h1>
<br/>
<p>This document serves as a policy and contains important information for many projects, systems and components.</p><br/>
<h2>Old version</h2>
<p>The previous version of this policy <a href="filenames_old.html">can be found here</a>. The new version was already accepted by the
<a href="http://wiki.services.openoffice.org/wiki/ReleaseStatus_Minutes">Release Status Meeting</a>.</p>
<h2>Changes</h2>
<p>Compared with the old policy the following has been changed:</p>
<ul>
<li>All files for Beta Releases and Release Candidates contain a timestamp. Archive builds, Dev builds and final releases will remain without one.</li>
<li>The version of dev builds is no longer separated by a "_" to get rid of a wrong separator.</li>
<li>Consolidated the "Intel" and "x86" ARCH into "x86" only, also to separate better against "x86-64".</li>
<li>Renamed the "Win32" OS into "Win" as the ARCH addition which is following defines the architecture already.</li>
<li>The "OS" and "ARCH" parts are also separated by an "_" (underscore).</li>
<li>Created complete new install types.</li>
<li>Using the "install-arc" install type for all builds of type "archive".</li>
<li>JRE builds are put together with the install type to get rid of this optional part.</li>
<li>Deb builds are put together with the install type to get rid of this optional part.</li>
<li>There is no default package for Linux. The install type "install-deb" or "install-rpm" is always added.</li>
<li>There is no default language. All installation sets include a language code.</li>
</ul>
<br/>
<h2>Directories</h2>
<p>Directories are created in the mirroring <a href="http://distribution.openoffice.org/mirrors/#directory">directory structure</a>.<br/>
Directory names follow the filename and numbering schema of releases or developer builds respectively.</p>
<br/>
<h2>Files</h2>
<p>File names follow the following schema. Each part is described in detail below.</p>
<table cellspacing="0" cellpadding="0" class="rel">
<tr>
<th>(PRODUCT NAME)_(VERSION)_(TIMESTAMP)_(OS)_(ARCH)_(INSTALL TYPE)_(LANGUAGE).(FILE EXTENSION)</th>
</tr>
</table>
<br/>
<h3>Separator Characters</h3>
<p>The "-" (hyphen) is used to bind the data within a part if necessary (e.g., x86-64 or en-US).<br/>
The "_" (underscore) is used as separator to divide the different parts from each other (e.g., OOo_3.2.0 or x86_install).</p>
<br/>
<h3>Product Name</h3>
<p>The product name can be one of the following:</p>
<table cellspacing="0" cellpadding="0" class="rel">
<tr>
<th>Identifier</th>
<th>Description</th>
</tr>
<tr>
<td>BrOo</td>
<td>BrOffice.org used for a final release, Release Candidate and Beta Release.</td>
</tr>
<tr>
<td>OOo</td>
<td>OpenOffice.org used for a final release, Release Candidate and Beta Release.</td>
</tr>
<tr>
<td>OOo-Dev</td>
<td>Developer Snapshot. Can be installed in parallel to an OOo build.</td>
</tr>
<tr>
<td>OOo-SDK</td>
<td>Software Development Kit.</td>
</tr>
<tr>
<td>OOo-Dev-SDK</td>
<td>Software Development Kit as Developer Snapshot.</td>
</tr>
<tr>
<td>OOo-URE</td>
<td>UNO Runtime Environment. <i>(deprecated)</i></td>
</tr>
</table>
<br/>
<h3>Version</h3>
<p>The version can either be a final release, Release Candidate, Beta Release, branch from release or development codeline.</p>
<table cellspacing="0" cellpadding="0" class="rel">
<tr>
<th>Example</th>
<th>Type</th>
</tr>
<tr>
<td>3.2.0</td>
<td>Release version</td>
</tr>
<tr>
<td>3.2.0rc1</td>
<td>Release Candidate</td>
</tr>
<tr>
<td>3.0.0beta1</td>
<td>Beta Release</td>
</tr>
<tr>
<td>OOO320m7</td>
<td>Milestone from release codeline</td>
</tr>
<tr>
<td>DEV300m70</td>
<td>Milestone from development codeline</td>
</tr>
</table>
<br/>
<h3>Timestamp (optional)</h3>
<p>This identifier is optional. However, a Beta Release and Release Candidate <b>always</b> include a date stamp.</p>
<table cellspacing="0" cellpadding="0" class="rel">
<tr>
<th>Format</th>
<th>Example</th>
</tr>
<tr>
<td>YYYYMMDD</td>
<td>20100118</td>
</tr>
</table>
<br/>
<h3>Operating System</h3>
<p>The operating system can be one of the following:</p>
<table cellspacing="0" cellpadding="0" class="rel">
<tr>
<th>Identifier</th>
<th>Description</th>
</tr>
<tr>
<td>Win</td>
<td>Microsoft Windows</td>
</tr>
<tr>
<td>Linux</td>
<td>Linux</td>
</tr>
<tr>
<td>MacOS</td>
<td>Apple Mac OS</td>
</tr>
<tr>
<td>Solaris</td>
<td>Sun Solaris</td>
</tr>
<tr>
<td>FreeBSD</td>
<td>FreeBSD</td>
</tr>
</table>
<br/>
<h3>Architecture</h3>
<p>The architecture can be one of the following:</p>
<table cellspacing="0" cellpadding="0" class="rel">
<tr>
<th>Identifier</th>
<th>Description</th>
</tr>
<tr>
<td>x86</td>
<td>Intel x86 (32-bit)</td>
</tr>
<tr>
<td>x86-64</td>
<td>Intel/AMD x86-64 (64-bit)</td>
</tr>
<tr>
<td>Sparc</td>
<td>SPARC (32-bit)</td>
</tr>
<tr>
<td>PPC</td>
<td>Power PC (32-bit)</td>
</tr>
<tr>
<td>IA64</td>
<td>Intel Itanium (64-bit)</td>
</tr>
<tr>
<td>HPPA</td>
<td>HP PA-RISC (32-bit)</td>
</tr>
<tr>
<td>S390X</td>
<td>IBM s390x (64-bit)</td>
</tr>
</table>
<br/>
<h3>Install Type</h3>
<p>The install type can be one of the following:</p>
<table cellspacing="0" cellpadding="0" class="rel">
<tr>
<th>Identifier</th>
<th>Description</th>
</tr>
<tr>
<td>install</td>
<td>Full installation</td>
</tr>
<tr>
<td>install-wJRE</td>
<td>Full installation with included Java Runtime Environment (JRE)</td>
</tr>
<tr>
<td>install-arc</td>
<td>Full installation as archive</td>
</tr>
<tr>
<td>install-deb</td>
<td>Full installation as Debian package (Linux only)</td>
</tr>
<tr>
<td>install-rpm</td>
<td>Full installation as RPM package (Linux only)</td>
</tr>
<tr>
<td>install-rpm-wJRE</td>
<td>Full installation as RPM package with included JRE (Linux only)</td>
</tr>
<tr>
<td>langpack</td>
<td>Language pack</td>
</tr>
<tr>
<td>langpack-arc</td>
<td>Language pack as archive</td>
</tr>
<tr>
<td>langpack-deb</td>
<td>Language pack as Debian package (Linux only)</td>
</tr>
<tr>
<td>langpack-rpm</td>
<td>Language pack as RPM package (Linux only)</td>
</tr>
<tr>
<td>src</td>
<td>Source tarball</td>
</tr>
</table>
<br/>
<h3>Language</h3>
<p>The language can be any language that is specified in <a href="http://xml.coverpages.org/iso639a.html">ISO 639-1</a>.</p><br/>
<table cellspacing="0" cellpadding="0" class="rel">
<tr>
<th>Example</th>
<th>Description</th>
</tr>
<tr>
<td>en-US</td>
<td>English (US)</td>
</tr>
<tr>
<td>fr</td>
<td>French</td>
</tr>
<tr>
<td>de</td>
<td>German</td>
</tr>
</table>
<br/>
<h3>File Extension</h3>
<p>The file extension can be one of the following:</p>
<table cellspacing="0" cellpadding="0" class="rel">
<tr>
<th>Identifier</th>
<th>Description</th>
</tr>
<tr>
<td>dmg</td>
<td>Apple Disk Image</td>
</tr>
<tr>
<td>exe</td>
<td>Windows executable</td>
</tr>
<tr>
<td>sh</td>
<td>Unix shell script</td>
</tr>
<tr>
<td>tar.bz2</td>
<td>Tar + Bzip2 archive</td>
</tr>
<tr>
<td>tar.gz</td>
<td>Tar + Gnuzip archive</td>
</tr>
<tr>
<td>tbz</td>
<td>Tar + Bzip2 archive</td>
</tr>
<tr>
<td>zip</td>
<td>Zip archive</td>
</tr>
</table>
<br/>
<h3>Examples</h3>
<h4>Archive builds</h4>
OOo_DEV300m70_Win_x86_install-arc_en-US.exe<br/>
OOo_DEV300m70_Linux_x86_install-arc_en-US.tar.gz<br/>
OOo_DEV300m70_Linux_x86-86_install-arc_en-US.tar.gz<br/>
OOo_DEV300m70_MacOS_x86_install-arc_en-US.dmg<br/>
OOo_DEV300m70_Solaris_Sparc_install-arc_en-US.tar.gz<br/>
OOo_DEV300m70_Solaris_x86_install-arc_en-US.tar.gz
<h4>Developer Snapshot</h4>
OOo-Dev_DEV300m70_Win_x86_install_en-US.exe<br/>
OOo-Dev_DEV300m70_Linux_x86_install-deb_en-US.tar.gz<br/>
OOo-Dev_DEV300m70_Linux_x86_install-rpm_en-US.tar.gz<br/>
OOo-Dev_DEV300m70_Linux_x86-64_install-deb_en-US.tar.gz<br/>
OOo-Dev_DEV300m70_Linux_x86-64_install-rpm_en-US.tar.gz<br/>
OOo-Dev_DEV300m70_MacOS_x86_install_en-US.dmg<br/>
OOo-Dev_DEV300m70_Solaris_Sparc_install_en-US.tar.gz<br/>
OOo-Dev_DEV300m70_Solaris_x86_install_en-US.tar.gz
<h4>Beta Release</h4>
OOo_3.0.0beta1_20080101_Win_x86_install-wJRE_en-US.exe<br/>
OOo_3.0.0beta1_20080101_Linux_x86_install-deb_en-US.tar.gz<br/>
OOo_3.0.0beta1_20080101_Linux_x86_install-rpm_en-US.tar.gz<br/>
OOo_3.0.0beta1_20080101_Linux_x86-64_install-deb_en-US.tar.gz<br/>
OOo_3.0.0beta1_20080101_Linux_x86-64_install-rpm-wJRE_en-US.tar.gz<br/>
OOo_3.0.0beta1_20080101_MacOS_x86_install_en-US.dmg<br/>
OOo_3.0.0beta1_20080101_Solaris_Sparc_install-wJRE_en-US.tar.gz<br/>
OOo_3.0.0beta1_20080101_Solaris_x86_install-wJRE_en-US.tar.gz
<h4>Release Candidate</h4>
OOo_3.2.0rc1_20100118_Win_x86_install-wJRE_en-US.exe<br/>
OOo_3.2.0rc1_20100118_Linux_x86_install-deb_en-US.tar.gz<br/>
OOo_3.2.0rc1_20100118_Linux_x86_install-rpm-wJRE_en-US.tar.gz<br/>
OOo_3.2.0rc1_20100118_Linux_x86-64_install-deb_en-US.tar.gz<br/>
OOo_3.2.0rc1_20100118_Linux_x86-64_install-rpm-wJRE_en-US.tar.gz<br/>
OOo_3.2.0rc1_20100118_MacOS_x86_install_en-US.dmg<br/>
OOo_3.2.0rc1_20100118_Solaris_Sparc_install-wJRE_en-US.tar.gz<br/>
OOo_3.2.0rc1_20100118_Solaris_x86_install-wJRE_en-US.tar.gz
<h4>Release</h4>
OOo_3.2.0_Win_x86_install_en-US.exe<br/>
OOo_3.2.0_Linux_x86_install-deb_en-US.tar.gz<br/>
OOo_3.2.0_Linux_x86_install-rpm_en-US.tar.gz<br/>
OOo_3.2.0_Linux_x86-64_install-deb_en-US.tar.gz<br/>
OOo_3.2.0_Linux_x86-64_install-rpm-wJRE_en-US.tar.gz<br/>
OOo_3.2.0_MacOS_x86_install_en-US.dmg<br/>
OOo_3.2.0_Solaris_Sparc_install-wJRE_en-US.tar.gz<br/>
OOo_3.2.0_Solaris_x86_install-wJRE_en-US.tar.gz
<h4>SDK</h4>
OOo-SDK_DEV300m70_Solaris_Sparc_install-arc_en-US.tar.gz<br/>
OOo-Dev-SDK_DEV300m70_Solaris_Sparc_install_en-US.tar.gz<br/>
OOo-SDK_3.0.0beta1_20080101_Solaris_Sparc_install_en-US.tar.gz<br/>
OOo-SDK_3.2.0rc1_20100118_Solaris_Sparc_install_en-US.tar.gz<br/>
OOo-SDK_3.2.0_Solaris_Sparc_install_en-US.tar.gz
<h4>Source tarballs (multiple files)</h4>
OOo-Dev_DEV300m70_src_binfilter.tar.gz<br/>
OOo-Dev_DEV300m70_src_core.tar.gz<br/>
OOo-Dev_DEV300m70_src_extensions.tar.gz<br/>
OOo-Dev_DEV300m70_src_l10n.tar.gz<br/>
OOo-Dev_DEV300m70_src_system.tar.gz<br/>
OOo-Dev_DEV300m70_src_testautomation.tar.gz<br/><br/>
OOo_3.2.0rc1_20100118_src_binfilter.tar.bz2<br/>
OOo_3.2.0rc1_20100118_src_core.tar.bz2<br/>
OOo_3.2.0rc1_20100118_src_extensions.tar.bz2<br/>
OOo_3.2.0rc1_20100118_src_l10n.tar.bz2<br/>
OOo_3.2.0rc1_20100118_src_system.tar.bz2<br/>
OOo_3.2.0rc1_20100118_src_testautomation.tar.bz2<br/><br/>
OOo_3.1.0_src_binfilter.tar.bz2<br/>
OOo_3.1.0_src_core.tar.bz2<br/>
OOo_3.1.0_src_extensions.tar.bz2<br/>
OOo_3.1.0_src_l10n.tar.bz2<br/>
OOo_3.1.0_src_system.tar.bz2<br/>
OOo_3.1.0_src_testautomation.tar.bz2
<h4>Source tarballs (single file)</h4>
OOo-Dev_DEV300m70_src.tar.bz2<br/>
OOo_3.0.0beta1_20080101_src.tar.bz2<br/>
OOo_3.2.0rc1_20100118_src.tar.bz2<br/>
OOo_3.2.0_src.tar.bz2
</body>
</html>