[apple/icu.git] / icuSources / samples / udata / readme.txt

Copyright (c) 2002, International Business Machines Corporation and others. All Rights Reserved.
udata: Low level ICU data

This sample demonstrates
    Using the low level ICU data handling interfaces (udata) to create 
 and later access user data.
         
Files:
    writer.c       C source for Writer application, will generate data file to be read by Reader.
    reader.c       C source for Reader application, will read file created by Writer
    udata.dsw      Windows MSVC workspace.  Double-click this to get started.
    udata.dsp      Windows MSVC project file

To Build udata on Windows
    1.  Install and build ICU
    2.  In MSVC, open the workspace file icu\samples\udata\udata.dsw
    3.  Choose a Debug or Release build.
    4.  Build.

To Run on Windows
    1.  Start a command shell window
    2.  Add ICU's bin directory to the path, e.g.
            set PATH=c:\icu\bin;%PATH%
        (Use the path to where ever ICU is on your system.)
    3.  cd into the udata directory, e.g.
            cd c:\icu\source\samples\udata\debug
    4.  Run it
            writer
            reader

To Build on Unixes
    1.  Build ICU.  
        Specify an ICU install directory when running configure,
        using the --prefix option.  The steps to build ICU will look something
        like this:
           cd <icu directory>/source
           runConfigureICU <platform-name> --prefix <icu install directory> [other options]
           gmake all
           
    2.  Install ICU, 
           gmake install
 
    3.  Compile
           You will need to set ICU_PATH to the location of your ICU source tree, for example ICU_PATH=/home/srl/icu   (containing source, etc.)
           cd <icu directory>/source/samples/udata
           gmake ICU_PATH=<icu source directory> ICU_PREFIX=<icu install directory)
           
 To Run on Unixes
           cd <icu directory>/source/samples/udata
           gmake ICU_PREFIX=<icu install directory>  check
               -or- 

           export LD_LIBRARY_PATH=<icu install directory>/lib:.:$LD_LIBRARY_PATH
           writer
           reader
           
 Note:  The name of the LD_LIBRARY_PATH variable is different on some systems.
        If in doubt, run the sample using "gmake check", and note the name of
        the variable that is used there.  LD_LIBRARY_PATH is the correct name
        for Linux and Solaris.
Commit	Line	Data
b75a7d8f A	1	Copyright (c) 2002, International Business Machines Corporation and others. All Rights Reserved.
	2	udata: Low level ICU data
	3
	4	This sample demonstrates
	5	Using the low level ICU data handling interfaces (udata) to create
	6	and later access user data.
	7
	8	Files:
	9	writer.c C source for Writer application, will generate data file to be read by Reader.
	10	reader.c C source for Reader application, will read file created by Writer
	11	udata.dsw Windows MSVC workspace. Double-click this to get started.
	12	udata.dsp Windows MSVC project file
	13
	14	To Build udata on Windows
	15	1. Install and build ICU
	16	2. In MSVC, open the workspace file icu\samples\udata\udata.dsw
	17	3. Choose a Debug or Release build.
	18	4. Build.
	19
	20	To Run on Windows
	21	1. Start a command shell window
	22	2. Add ICU's bin directory to the path, e.g.
	23	set PATH=c:\icu\bin;%PATH%
	24	(Use the path to where ever ICU is on your system.)
	25	3. cd into the udata directory, e.g.
	26	cd c:\icu\source\samples\udata\debug
	27	4. Run it
	28	writer
	29	reader
	30
	31	To Build on Unixes
	32	1. Build ICU.
	33	Specify an ICU install directory when running configure,
	34	using the --prefix option. The steps to build ICU will look something
	35	like this:
	36	cd <icu directory>/source
	37	runConfigureICU <platform-name> --prefix <icu install directory> [other options]
	38	gmake all
	39
	40	2. Install ICU,
	41	gmake install
	42
	43	3. Compile
	44	You will need to set ICU_PATH to the location of your ICU source tree, for example ICU_PATH=/home/srl/icu (containing source, etc.)
	45	cd <icu directory>/source/samples/udata
	46	gmake ICU_PATH=<icu source directory> ICU_PREFIX=<icu install directory)
	47
	48	To Run on Unixes
	49	cd <icu directory>/source/samples/udata
	50	gmake ICU_PREFIX=<icu install directory> check
	51	-or-
	52
	53	export LD_LIBRARY_PATH=<icu install directory>/lib:.:$LD_LIBRARY_PATH
	54	writer
	55	reader
	56
	57	Note: The name of the LD_LIBRARY_PATH variable is different on some systems.
	58	If in doubt, run the sample using "gmake check", and note the name of
	59	the variable that is used there. LD_LIBRARY_PATH is the correct name
	60	for Linux and Solaris.
	61