| <!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&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 (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 (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 (en-US optional) |
| |
| <h4>Release</h4> |
| |
| OOo_3.1.1_Solarisx86_install_de.tar.gz<br/> |
| OOo_3.1.1_Solarisx86_install.tar.gz (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> |