Upstream version 9.38.198.0
[platform/framework/web/crosswalk.git] / src / third_party / icu / source / samples / ufortune / readme.txt
1 Copyright (c) 2002-2005, International Business Machines Corporation and others. All Rights Reserved.
2 ufortune: a sample program demonstrating the use of ICU resource files by an application.
3
4 This sample demonstrates
5          Defining resources for use by an application
6          Compiling and packaging them into a dll
7          Referencing the resource-containing dll from application code
8          Loading resource data using ICU's API
9          
10 Files:
11     ./ufortune.c                 source code for the sample
12     ./ufortune.sln               Windows MSVC workspace.  Double-click this to get started.
13     ./ufortune.vcproj            Windows MSVC project file.
14     ./Makefile                   Makefile for Unixes.  Needs gmake.
15     resources/root.txt           Default resources  (text for messages in English)
16     resources/es.txt             Spanish language resources source file..
17     resources/res-file-list.txt  List of resource source files to be built
18     resources/Makefile           Makefile for compiling resources, for Unixes.
19     
20
21 To Build ufortune on Windows
22     1.  Install and build ICU
23     2.  In MSVC, open the workspace file icu\samples\ufortune\ufortune.sln
24     3.  Choose a Debug or Release build.
25     4.  Build.
26         
27 To Run on Windows
28     1.  Start a command shell window
29     2.  Add ICU's bin directory to the path, e.g.
30             set PATH=c:\icu\bin;%PATH%
31         (Use the path to where ever ICU is on your system.)
32     3.  cd into the ufortune directory, e.g.
33             cd c:\icu\source\samples\ufortune\debug
34     4.  Run it
35             ufortune
36      
37
38 To Build on Unixes
39     1.  Build ICU.  Specify an ICU install directory when running configure,
40         using the --prefix option.  The steps to build ICU will look something
41         like this:
42            cd <icu directory>/source
43            runConfigureICU <platform-name> --prefix <icu install directory> [other options]
44            gmake all
45            
46     2.  Install ICU, 
47            gmake install
48            
49     3.  Build the sample
50            cd <icu directory>/source/samples/ufortune
51            export ICU_PREFIX= <icu install directory>
52            gmake
53            
54  To Run on Unixes
55            cd <icu directory>/source/samples/ufortune
56            
57            gmake check
58               or
59            export LD_LIBRARY_PATH=<icu install directory>/lib:.:$LD_LIBRARY_PATH
60            ufortune
61            
62            
63  Note:  The name of the LD_LIBRARY_PATH variable is different on some systems.
64         If in doubt, run the sample using "gmake check", and note the name of
65         the variable that is used there.  LD_LIBRARY_PATH is the correct name
66         for Linux and Solaris.