Symbian3/SDK/Source/GUID-BF040EF4-E34C-40A3-AD15-F49426F56AA2.dita
changeset 7 51a74ef9ed63
equal deleted inserted replaced
6:43e37759235e 7:51a74ef9ed63
       
     1 <?xml version="1.0" encoding="utf-8"?>
       
     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
       
     3 <!-- This component and the accompanying materials are made available under the terms of the License 
       
     4 "Eclipse Public License v1.0" which accompanies this distribution, 
       
     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
       
     6 <!-- Initial Contributors:
       
     7     Nokia Corporation - initial contribution.
       
     8 Contributors: 
       
     9 -->
       
    10 <!DOCTYPE concept
       
    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
       
    12 <concept id="GUID-BF040EF4-E34C-40A3-AD15-F49426F56AA2" xml:lang="en"><title>Antiword
       
    13 Example</title><prolog><metadata><keywords/></metadata></prolog><conbody>
       
    14 <p>Antiword is an Open C console-based application.  ANTIWORD can be used
       
    15 for the following purposes:  </p>
       
    16 <p> converts a MS-word document (i.e. .doc) file in to a plain text(i.e. .txt)
       
    17 file. </p>
       
    18 <p>converts a MS-word document (i.e. .doc) file in to a Adobe acrobat(i.e.
       
    19 .pdf) file. </p>
       
    20 <p>converts MS-word document (i.e. .doc) file in to a post-script (i.e. .ps)
       
    21 file. </p>
       
    22 <p>converts a MS-word document (i.e. .doc) file in to a xml (i.e. .xml) file. </p>
       
    23 <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
       
    24 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>
       
    25 <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
       
    26 Implementation</title> <p>The following sections provide information about
       
    27 the implementation of the example. </p> <p><b>Capabilities</b> </p> The following
       
    28 program capability is defined in the <filepath>antiword.mmp</filepath> file: <codeph>CAPABILITY
       
    29 None</codeph><p><b>Implementation details of EXE</b> </p>This application
       
    30 uses main() as the entry point for the application. This is simple console
       
    31 based application.  Antiword is C application that is ported on the Open C
       
    32 which demonstrates the changes made in the application in order to work on
       
    33 Open C.  All changes made to the open source code is under SYMBIAN macro.
       
    34  Some of the environment variables are set explicitly using the Open C's setenv()
       
    35 API.  The fillArg() subroutine converts the given input command string to
       
    36 Linux's argv() format. Output of the conversion will be written to destination
       
    37 file i.e last commandline argument where as the original application expects
       
    38 the users to use the redirection operators for dumping the output to a target
       
    39 file. Some status messages will be prompted to the user in case of wrong input
       
    40 commands. The commandline help will be printed on the stdout using the original
       
    41 help text.  The input data files (font and mapping files for conversion) are
       
    42 added in the /data/resources directory and this directory will be exported
       
    43 to the  private folder of the Antiword application's, so that /private/A0001323/resources/
       
    44 will be used as the ANTIWORD_HOME directory in the application. The application
       
    45 can be launched by clicking its icon in the emulator as well as in the device.<p><b>Limitations</b></p><p>Antiword
       
    46 is not able to convert the embedded image or any other embedded multimedia
       
    47 objects from the document file. It converts only the text. Some of the related
       
    48 files, which supports the embedded images are commented in the mmp file as
       
    49 these files depend on the open source's sprite library.</p></section>
       
    50 <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
       
    51 Using</title> <p>The <xref href="GUID-3100800B-B2F7-50EF-BD4C-3C345ECCB2A5.dita">Symbian
       
    52 build process</xref> describes how to build this example application. </p> To
       
    53 build the Antiword application, go to the Antiword\group directory and build
       
    54 the application.  The definition for the whole application can be found in
       
    55 the bld.inf file in the group subdirectory of the applications main directory. </section>
       
    56 </conbody></concept>