Symbian3/SDK/Source/GUID-BF040EF4-E34C-40A3-AD15-F49426F56AA2.dita
changeset 7 51a74ef9ed63
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-BF040EF4-E34C-40A3-AD15-F49426F56AA2.dita	Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"Eclipse Public License v1.0" which accompanies this distribution, 
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+    Nokia Corporation - initial contribution.
+Contributors: 
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-BF040EF4-E34C-40A3-AD15-F49426F56AA2" xml:lang="en"><title>Antiword
+Example</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>Antiword is an Open C console-based application.  ANTIWORD can be used
+for the following purposes:  </p>
+<p> converts a MS-word document (i.e. .doc) file in to a plain text(i.e. .txt)
+file. </p>
+<p>converts a MS-word document (i.e. .doc) file in to a Adobe acrobat(i.e.
+.pdf) file. </p>
+<p>converts MS-word document (i.e. .doc) file in to a post-script (i.e. .ps)
+file. </p>
+<p>converts a MS-word document (i.e. .doc) file in to a xml (i.e. .xml) file. </p>
+<section id="GUID-026FD8D6-6C4A-5958-B289-775D4AE1E756-GENID-1-8-1-11-1-1-5-1-3-1-11-1-10-1-2-6"><title>Download</title> <p>Click
+on the following link to download the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-72f72df3-653c-414c-a357-7613ad8bc169.zip" scope="external"> antiword.zip</xref></p><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-72f72df3-653c-414c-a357-7613ad8bc169.html" scope="peer">browse</xref> to view the example code. </p> </section>
+<section id="GUID-7E7C4564-B10E-41F9-8A9D-D8A6C5E9C51C-GENID-1-8-1-11-1-1-5-1-3-1-11-1-10-1-2-7"><title>Design and
+Implementation</title> <p>The following sections provide information about
+the implementation of the example. </p> <p><b>Capabilities</b> </p> The following
+program capability is defined in the <filepath>antiword.mmp</filepath> file: <codeph>CAPABILITY
+None</codeph><p><b>Implementation details of EXE</b> </p>This application
+uses main() as the entry point for the application. This is simple console
+based application.  Antiword is C application that is ported on the Open C
+which demonstrates the changes made in the application in order to work on
+Open C.  All changes made to the open source code is under SYMBIAN macro.
+ Some of the environment variables are set explicitly using the Open C's setenv()
+API.  The fillArg() subroutine converts the given input command string to
+Linux's argv() format. Output of the conversion will be written to destination
+file i.e last commandline argument where as the original application expects
+the users to use the redirection operators for dumping the output to a target
+file. Some status messages will be prompted to the user in case of wrong input
+commands. The commandline help will be printed on the stdout using the original
+help text.  The input data files (font and mapping files for conversion) are
+added in the /data/resources directory and this directory will be exported
+to the  private folder of the Antiword application's, so that /private/A0001323/resources/
+will be used as the ANTIWORD_HOME directory in the application. The application
+can be launched by clicking its icon in the emulator as well as in the device.<p><b>Limitations</b></p><p>Antiword
+is not able to convert the embedded image or any other embedded multimedia
+objects from the document file. It converts only the text. Some of the related
+files, which supports the embedded images are commented in the mmp file as
+these files depend on the open source's sprite library.</p></section>
+<section id="GUID-67A72761-1D92-46D1-B1C9-7455978BDE4E-GENID-1-8-1-11-1-1-5-1-3-1-11-1-10-1-2-8"><title>Building and
+Using</title> <p>The <xref href="GUID-3100800B-B2F7-50EF-BD4C-3C345ECCB2A5.dita">Symbian
+build process</xref> describes how to build this example application. </p> To
+build the Antiword application, go to the Antiword\group directory and build
+the application.  The definition for the whole application can be found in
+the bld.inf file in the group subdirectory of the applications main directory. </section>
+</conbody></concept>
\ No newline at end of file