1Copyright (c) 2002-2005, International Business Machines Corporation and others. All Rights Reserved.
2ufortune: a sample program demonstrating the use of ICU resource files by an application.
3
4This 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
10Files:
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
21To 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
27To 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
38To 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.
67