blob: 9c2e79ed6743ac6dbe258196e70113d2e62c6d7d [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<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>
<p>This document serves as a policy and contains important information for many projects, systems and components.<br/>
It has been established through a <a href="http://www.openoffice.org/servlets/ReadMsg?list=releases&amp;msgNo=10209">discussion</a>
on the releases mailing list.</p>
<h2>New version</h2>
<p>This document was <a href="filenames_new.html">updated to a new version</a> to implement improvements and to get rid of some inconsistencies
to make the creation and maintainance of OOo builds easierer. It was already accepted by the
<a href="http://wiki.services.openoffice.org/wiki/ReleaseStatus_Minutes">Release Status Meeting</a> but a date to switch to the new filename schema
is not yet defined.</p>
<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 numbering schema of releases or developer builds respectively.</p>
<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)_(TYPE)_(BUNDLE)_(LANGUAGE)_(PACKAGE).(EXTENSION)</th>
</tr>
</table>
<br/><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>OOo</td>
<td>OpenOffice.org used for release builds, release candidates and beta releases.</td>
</tr>
<tr>
<td>OOo-Dev</td>
<td>Developer snapshot builds. 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-URE</td>
<td>UNO Runtime Environment. <i>(deprecated)</i></td>
</tr>
</table>
<br/><br/>
<h3>Version</h3>
<p>The version can either be a release version, beta release, release candidate, stable branch or developer branch.</p>
<table cellspacing="0" cellpadding="0" class="rel">
<tr>
<th>Example</th>
<th>Type</th>
</tr>
<tr>
<td>3.1.0</td>
<td>Release version</td>
</tr>
<tr>
<td>3.1.0rc1_20090601</td>
<td>Release candidate</td>
</tr>
<tr>
<td>3.0.0beta1_20080101</td>
<td>Beta release</td>
</tr>
<tr>
<td>OOO310_m17</td>
<td>Stable branch</td>
</tr>
<tr>
<td>DEV300_m54</td>
<td>Developer branch</td>
</tr>
</table>
<br/><br/>
<h3>Timestamp (optionl)</h3>
<p>This identifier is optional. However, release candidates and beta releases <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>20090807</td>
</tr>
</table>
<br/><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>Win32</td>
<td>Windows</td>
</tr>
<tr>
<td>Linux</td>
<td>Linux</td>
</tr>
<tr>
<td>MacOSX</td>
<td>Mac OS X</td>
</tr>
<tr>
<td>Solaris</td>
<td>Solaris</td>
</tr>
</table>
<br/><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>Intel</td>
<td>Intel x86 (32-bit)</td>
</tr>
<tr>
<td>Sparc</td>
<td>SPARC</td>
</tr>
<tr>
<td>PPC</td>
<td>Power PC</td>
</tr>
<tr>
<td>x86</td>
<td>Intel x86 (32-bit)</td>
</tr>
<tr>
<td>x86-64</td>
<td>x86 64-bit</td>
</tr>
<tr>
<td>IA64</td>
<td>Intel Itanium 64-bit</td>
</tr>
</table>
<br/><br/>
<h3>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 package</td>
</tr>
<tr>
<td>langpack</td>
<td>Language package</td>
</tr>
<tr>
<td>src</td>
<td>Source package</td>
</tr>
</table>
<br/><br/>
<h3>Bundle (optional)</h3>
<p>This identifier is optional. If no identifier is specified, woJRE is assumed.</p>
<table cellspacing="0" cellpadding="0" class="rel">
<tr>
<th>Identifier</th>
<th>Description</th>
</tr>
<tr>
<td>wJRE</td>
<td>with JRE</td>
</tr>
</table>
<br/><br/>
<h3>Language (optional)</h3>
<p>This identifier is optional. The language can be any language that is specified in <a href="http://xml.coverpages.org/iso639a.html">ISO 639-1</a>.<br/>
If no identifier is specified, <b>en-US - English (United States)</b> is assumed.</p>
<table cellspacing="0" cellpadding="0" class="rel">
<tr>
<th>Example</th>
<th>Description</th>
</tr>
<tr>
<td>en-US</td>
<td>English (United States)</td>
</tr>
<tr>
<td>fr</td>
<td>French</td>
</tr>
<tr>
<td>de</td>
<td>German</td>
</tr>
</table>
<br/><br/>
<h3>Package (optional)</h3>
<p>This identifier is optional for Linux builds. If no identifier is specified, rpm is assumed.</p>
<table cellspacing="0" cellpadding="0" class="rel">
<tr>
<th>Identifier</th>
<th>Description</th>
</tr>
<tr>
<td>deb</td>
<td>Debian package type</td>
</tr>
<tr>
<td>rpm</td>
<td>RedHat package type</td>
</tr>
</table>
<br/><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>dmg 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>zip</td>
<td>zip archive</td>
</tr>
</table>
<br/><br/>
<h3>Examples</h3>
<h4>Developer Snapshot builds</h4>
OOo-Dev_OOO310_m17_Solarisx86_install_de.tar.gz<br/>
OOo-Dev_DEV310_m54_Solarisx86_install.tar.gz&nbsp;&nbsp;&nbsp;&nbsp;(en-US optional)
<h4>Beta Releases</h4>
OOo_3.0.0beta1_20080101_Solarisx86_install_de.tar.gz<br/>
OOo_3.0.0beta1_20080101_Solarisx86_install.tar.gz&nbsp;&nbsp;&nbsp;&nbsp;(en-US optional)
<h4>Release Candidates</h4>
OOo_3.1.1rc1_20090807_Solarisx86_install_de.tar.gz<br/>
OOo_3.1.1rc1_20090807_Solarisx86_install.tar.gz&nbsp;&nbsp;&nbsp;&nbsp;(en-US optional)
<h4>Release</h4>
OOo_3.1.1_Solarisx86_install_de.tar.gz<br/>
OOo_3.1.1_Solarisx86_install.tar.gz&nbsp;&nbsp;&nbsp;&nbsp;(en-US optional)
<h4>Source file example</h4>
OOo_3.1.0_src_core.tar.bz2<br/>
OOo_3.1.0_src_system.tar.bz2<br/>
OOo_3.1.0_src_binfilter.tar.bz2<br/>
OOo_3.1.0_src_l10n.tar.bz2<br/>
OOo_3.1.0_src_extensions.tar.bz2<br/>
OOo_3.1.0_src_testautomation.tar.bz2
<br/><br/>
If the source archive is not split into several parts then use the following:<br/>
<br/>
OOo_OOE680_m3_src.tar.gz<br/>
OOo_SRC680_m193_src.tar.gz<br/>
OOo_2.1.0rc1_20061124_src.tar.gz<br/>
<h4>SDK</h4>
OOo-SDK_3.1.0_SolarisSparc_install_en-US.sh<br/>
</body>
</html>