<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="Generator" content="Microsoft Exchange Server">
<!-- converted from rtf -->
<style><!-- .EmailQuote { margin-left: 1pt; padding-left: 4pt; border-left: #800000 2px solid; } --></style>
</head>
<body>
<font face="Calibri, sans-serif" size="2">
<div>Hi,</div>
<div> </div>
<div>The Maemo Documentation Infrastructure project has reached PreFinal release for </div>
<div>the Maemo Documenation Toolchain development. This release is done to allow </div>
<div>Maemo communtiy to review and give feedback for the toolchain.</div>
<div> </div>
<div>Also Maemo Documentation Baseline for Fremantle that uses Documentation </div>
<div>Toolchain has been released as PreFinal for comments.</div>
<div> </div>
<div>This Fremantle Documentation Baseline includes following documents:</div>
<ul style="margin-top: 0pt; margin-bottom: 0pt; margin-left: 18pt; ">
<font face="Calibri, sans-serif" color="#1F497D">
<li>Maemo Documentation Guidelines</li><li>Maemo PC Connectivity Tutorial</li><li>Maemo Eclipse Tutorial</li><li>Maemo Flasher-3.5 Tutorial</li><li>Maemo SDK Virtual Image Tutorial</li><li>Maemo For Symbian Developers Guide</li></font>
</ul>
<div> </div>
<div>Maemo Documentation Toolchain and Baseline delivery archives can be downloaded </div>
<div>from official Maemo Development Environment Downloads page here: </div>
<div><a href="http://tablets-dev.nokia.com/maemo-dev-env-downloads.php">http://tablets-dev.nokia.com/maemo-dev-env-downloads.php</a></div>
<div> </div>
<div>Cheers,</div>
<div>//Jarmo</div>
<div> </div>
<div>*******</div>
<div> </div>
<div>MAEMO DOCUMENTATION TOOLCHAIN DETAILS</div>
<div> </div>
<div> * Toolchain version: Maemo Documentation Toolchain version 0.2.4 - PreFinal</div>
<div> * Release date: 08.02.2010</div>
<div> * Technologies supported: LaTeX, PDF, HTML, MediaWiki, Midgard</div>
<div> * Download link: <a href="http://tablets-dev.nokia.com/maemo-dev-env-downloads.php">
http://tablets-dev.nokia.com/maemo-dev-env-downloads.php</a></div>
<div> </div>
<div> Maemo base releases supported</div>
<div> </div>
<div> * Maemo Fremantle 5.x releases</div>
<div> * Maemo Diablo 4.1.2 releases</div>
<div> </div>
<div> Linux distributions supported</div>
<div> </div>
<div> * Ubuntu 9.04 Janunty Jackalope (and later)</div>
<div> * Debian 5.0 Lenny (and later)</div>
<div> </div>
<div> </div>
<div>FILES INCLUDED TO MAEMO DOCUMENTATION TOOLCHAIN DELIVERY</div>
<div> </div>
<div> Maemo specific packages:</div>
<div> * README - readme file for the Maemo documentation toolchain</div>
<div> * maemodoc-toolchain_0.2.4 - Maemo documentation scripts</div>
<div> * maemodoc-toolchain-wikify_0.2.4 - MediaWiki conversion script </div>
<div> * maemodoc-toolchain-mediawiki_0.2.4 - MediaWiki import environment</div>
<div> * latex2html_2008-2maemo2 - Maemo updated latex2html tool</div>
<div> </div>
<div> Debian Lenny specific packages (newer versions of packages)</div>
<div> * libboost-regex1.40.0_1.40.0-2</div>
<div> * libicu42_4.2.1-3_i386.deb</div>
<div> * source-highlight_3.1-2_i386.deb</div>
<div> </div>
<div> </div>
<div>SHORT DESCRIPTION</div>
<div> </div>
<div> * Maemo Documentation Toolchain includes only wellknown open source tools.</div>
<div> * Installation of Maemo Documentation Toolchain uses local repository for </div>
<div> those packages that Nokia has modified or that do not yet have later </div>
<div> enough version available for standard Debian or Ubuntu distribution.</div>
<div> * Maemo Documentation Toolchain is based on LaTeX and uses latex2html </div>
<div> and pdflatex tools to produce high quality PDF and HTML versions of </div>
<div> Maemo documents.</div>
<div> * Easy to use scripts are provided to automate documentation generation </div>
<div> from LaTeX with command line and menu interfaces.</div>
<div> * For HTML version of documents tools are provided to convert them to </div>
<div> the MediaWiki import format.</div>
<div> * For MediaWiki import format documents tools are provided to import </div>
<div> them to the MediaWiki service.</div>
<div> * MediaWiki import only updates wiki pages if same updated document gets </div>
<div> imported to the same location in MediaWiki as the previous import.</div>
<div> * For HTML version of documents tools are provided to import them to </div>
<div> the maemo.org Midgard.</div>
<div> * Maemo Documentation Guidelines LaTeX document provides an example </div>
<div> and instructions how to create Maemo documents using Maemo </div>
<div> Documentation Toolchain so that high quality PDF, HTML and MediaWiki </div>
<div> conversions are possible.</div>
<div> </div>
<div> </div>
<div>INSTALLATION</div>
<div> </div>
<div>- Unpack the toolchain package tarball to some convenient location.</div>
<div> </div>
<div> $ tar -C /path/to/local/repo -xzf maemodoc-toolchain_0.2.4.tar.gz</div>
<div> </div>
<div> </div>
<div>- Tell apt where to find the packages</div>
<div> </div>
<div> Create a file /etc/apt/sources.list.d/maemodoc-toolchain-local.list </div>
<div> with the contents.</div>
<div> </div>
<div> deb <a href="file:///path/to/local/repo/maemodoc-toolchain">file:///path/to/local/repo/maemodoc-toolchain</a> /</div>
<div> </div>
<div> and tell apt to update its list of available packages</div>
<div> </div>
<div> $ sudo apt-get update </div>
<div> </div>
<div> </div>
<div>- Install the toolchain.</div>
<div> </div>
<div> $ sudo apt-get install maemodoc-toolchain</div>
<div> </div>
<div> </div>
<div>- Optionally install the wiki import tool.</div>
<div> </div>
<div> $ sudo apt-get install maemodoc-toolchain-mediawiki</div>
<div> </div>
<div> This is only required if you want to be able to import wikified </div>
<div> documentation into MediaWiki and will pull in MediaWiki, Apache and </div>
<div> MySQL as dependencies but will /not/ touch their configuration.</div>
<div> </div>
<div> </div>
<div>TOOLCHAIN USAGE</div>
<div> </div>
<div>The executables are installed in /usr/bin.</div>
<div> </div>
<div>- `maemodoc-toolchain' consists of the following scripts</div>
<div> </div>
<div> - maemodoc-menu a simple frontend for maemodoc-html and </div>
<div> maemodoc-pdf ; can be used to generate HTML </div>
<div> and PDF from and to wikify Maemo LaTeX documents</div>
<div> </div>
<div> - maemodoc-html a LaTeX-HTML conversion tool</div>
<div> </div>
<div> - maemodoc-pdf a LaTeX-PDF conversion tool</div>
<div> </div>
<div> - maemodoc-scaleimage a tool for automatically scaling and rotating </div>
<div> images to conform to the Maemo documentation </div>
<div> size constraints</div>
<div> </div>
<div> </div>
<div>- `maemodoc-toolchain-wikify' pulled in as a dependency, contains</div>
<div> </div>
<div> - maemodoc-wikify a tool for (media)wikifying HTML generated </div>
<div> by maemodoc-html</div>
<div> </div>
<div> </div>
<div>- `maemodoc-toolchain-mediawiki' contains just one script</div>
<div> </div>
<div> - maemodoc-importwiki a tool for importing maemodoc-wikified </div>
<div> documents into MediWiki</div>
<div> </div>
<div>The packages install the normal bits, copyright and such, in /usr/share/doc.</div>
<div> </div>
<div> </div>
<div>Simply unpack the LaTeX files somewhere:</div>
<div> </div>
<div> $ tar xvzf maemodoc-baseline-latex_wXY.tar.gz</div>
<div> </div>
<div>Run one of `maemodoc-menu', `maemodoc-html' or `maemodoc-pdf'. </div>
<div>Use `-H' or `--help' to get a list of tool parameters.</div>
<div> </div>
</font>
</body>
</html>