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