git.saurik.com Git - apple/icu.git/blob - icuSources/tools/gencnval/gencnval.1.in

1 .\" Hey, Emacs! This is -*-nroff-*- you know...

2 .\"

3 .\" gencnval.1: manual page for the gencnval utility

4 .\"

6 .\" License & terms of use: http://www.unicode.org/copyright.html

8 .\"

9 .\" Manual page by Yves Arrouye <yves@realnames.com>.

10 .\" Manual page by George Rhoten

11 .\"

12 .TH GENCNVAL 1 "11 March 2004" "ICU MANPAGE" "ICU @VERSION@ Manual"

13 .SH NAME

14 .B gencnval

15 \- compile the converters aliases file

16 .SH SYNOPSIS

17 .B gencnval

18 [

19 .BR "\-h\fP, \fB\-?\fP, \fB\-\-help"

20 ]

21 [

22 .BR "\-v\fP, \fB\-\-verbose"

23 ]

24 [

25 .BR "\-c\fP, \fB\-\-copyright"

26 ]

27 [

28 .BI "\-s\fP, \fB\-\-sourcedir" " source"

29 ]

30 [

31 .BI "\-d\fP, \fB\-\-destdir" " destination"

32 ]

33 [

34 .I converterfile

35 ]

36 .SH DESCRIPTION

37 .B gencnval

38 converts the ICU aliases file

39 .I converterfile

40 into the binary file

41 .BR cnvalias.icu .

42 This binary file can then be read directly by ICU, or used by

43 .BR pkgdata (1)

44 for incorporation into a larger archive or library.

45 .PP

46 If

47 .I converterfile

48 is not provided, the default ICU

49 .B convrtrs.txt

50 file is used.

51 .SH OPTIONS

52 .TP

53 .BR "\-h\fP, \fB\-?\fP, \fB\-\-help"

54 Print help about usage and exit.

55 .TP

56 .BR "\-v\fP, \fB\-\-verbose"

57 Display verbose output. This information can include information about

58 conflicting aliases and the converters the aliases resolve to.

59 .TP

60 .BR "\-c\fP, \fB\-\-copyright"

61 Include a copyright notice in the binary data.

62 .TP

63 .BI "\-s\fP, \fB\-\-sourcedir" " source"

64 Set the source directory to

65 .IR source .

66 The default source directory is specified by the environment variable

67 .BR ICU_DATA .

68 .TP

69 .BI "\-d\fP, \fB\-\-destdir" " destination"

70 Set the destination directory to

71 .IR destination .

72 The default destination directory is specified by the environment variable

73 .BR ICU_DATA .

74 .SH ENVIRONMENT

75 .TP 10

76 .B ICU_DATA

77 Specifies the directory containing ICU data. Defaults to

78 .BR @thepkgicudatadir@/@PACKAGE@/@VERSION@/ .

79 Some tools in ICU depend on the presence of the trailing slash. It is thus

80 important to make sure that it is present if

81 .B ICU_DATA

82 is set.

83 .SH FILES

84 .TP \w'\fB@PACKAGE@/source/data/mappings/convrtrs.txt'u+3n

85 .B @PACKAGE@/source/data/mappings/convrtrs.txt

86 Description of ICU's converters and their aliases. This data file is not

87 normally installed, and it is available as a part of ICU source code.

88 .SH VERSION

89 @VERSION@

90 .SH COPYRIGHT

92 .SH SEE ALSO

93 .BR pkgdata (1)