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

Copyright (c) 2002-2005, International Business Machines Corporation and others. All Rights Reserved.
numfmt: a sample program which displays number formatting in C and C++

This sample demonstrates
         Formatting a number
         Outputting text in the default codepage to the console
         
Files:
    main.cpp                   Main source file in C++
    capi.c                     C version 
    util.cpp                   formatted output convenience implementation
    util.h                     formatted output convenience header
    numfmt.sln                 Windows MSVC workspace.  Double-click this to get started.
    numfmt.vcproj              Windows MSVC project file

To Build on Windows
    1.  Install and build ICU
    2.  In MSVC, open the workspace file icu\samples\numfmt\numfmt.sln
    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 numfmt directory, e.g.
            cd c:\icu\source\samples\numfmt\debug
    4.  Run it
            numfmt

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
           cd <icu directory>/source/samples/numfmt
           gmake ICU_PREFIX=<icu install directory)
           
 To Run on Unixes
           cd <icu directory>/source/samples/numfmt
           
           gmake ICU_PREFIX=<icu install directory>  check
               -or- 

           export LD_LIBRARY_PATH=<icu install directory>/lib:.:$LD_LIBRARY_PATH
           numfmt
           
 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
73c04bcf	1	Copyright (c) 2002-2005, International Business Machines Corporation and others. All Rights Reserved.
b75a7d8f A	2	numfmt: a sample program which displays number formatting in C and C++
	3
	4	This sample demonstrates
	5	Formatting a number
	6	Outputting text in the default codepage to the console
	7
	8	Files:
	9	main.cpp Main source file in C++
	10	capi.c C version
	11	util.cpp formatted output convenience implementation
	12	util.h formatted output convenience header
73c04bcf A	13	numfmt.sln Windows MSVC workspace. Double-click this to get started.
73c04bcf A	14	numfmt.vcproj Windows MSVC project file
b75a7d8f A	15
	16	To Build on Windows
	17	1. Install and build ICU
73c04bcf	18	2. In MSVC, open the workspace file icu\samples\numfmt\numfmt.sln
b75a7d8f A	19	3. Choose a Debug or Release build.
	20	4. Build.
	21
	22	To Run on Windows
	23	1. Start a command shell window
	24	2. Add ICU's bin directory to the path, e.g.
	25	set PATH=c:\icu\bin;%PATH%
	26	(Use the path to where ever ICU is on your system.)
	27	3. cd into the numfmt directory, e.g.
	28	cd c:\icu\source\samples\numfmt\debug
	29	4. Run it
	30	numfmt
	31
	32	To Build on Unixes
	33	1. Build ICU.
	34	Specify an ICU install directory when running configure,
	35	using the --prefix option. The steps to build ICU will look something
	36	like this:
	37	cd <icu directory>/source
	38	runConfigureICU <platform-name> --prefix <icu install directory> [other options]
	39	gmake all
	40
	41	2. Install ICU,
	42	gmake install
	43
	44	3. Compile
	45	cd <icu directory>/source/samples/numfmt
	46	gmake ICU_PREFIX=<icu install directory)
	47
	48	To Run on Unixes
	49	cd <icu directory>/source/samples/numfmt
	50
	51	gmake ICU_PREFIX=<icu install directory> check
	52	-or-
	53
	54	export LD_LIBRARY_PATH=<icu install directory>/lib:.:$LD_LIBRARY_PATH
	55	numfmt
	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