~ubuntu-branches/ubuntu/gutsy/icu/gutsy

« back to all changes in this revision

Viewing changes to debian/icurepackage.8.in

  • Committer: Package Import Robot
  • Author(s): Matthias Klose
  • Date: 2005-05-21 22:44:31 UTC
  • mfrom: (2.1.1 warty)
  • Revision ID: package-import@ubuntu.com-20050521224431-r7rktfhnu1n4tf1g
Tags: 2.1-2.1
Rename icu-doc to icu21-doc. icu-doc is built by the icu28 package.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" Hey, Emacs! This is -*-nroff-*- you know...
2
 
.\"
3
 
.\" icurepackage.8: manual page for the icurepackage utility
4
 
.\"
5
 
.\" Copyright (C) 2000 IBM, Inc. and others.
6
 
.\"
7
 
.\" Manual page by Yves Arrouye <yves@realnames.com>.
8
 
.\"
9
 
.TH ICUREPACKAGE 8 "7 February 2002" "ICU MANPAGE" "ICU @VERSION@ Manual"
10
 
.SH NAME
11
 
.B icurepackage
12
 
\- repackage a common data file from multiple sources
13
 
.SH SYNOPSIS
14
 
.B icurepackage
15
 
[
16
 
.BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
17
 
]
18
 
[
19
 
.BI "\-v\fP, \fB\-\-verbose"
20
 
]
21
 
[
22
 
.BI "\-s\fP, \fB\-\-sourcedir" " source"
23
 
]
24
 
[
25
 
.BI "\-d\fP, \fB\-\-destdir" " destination"
26
 
]
27
 
[
28
 
.BI "\-\-all"
29
 
]
30
 
[
31
 
.BI "\-\-extras"
32
 
|
33
 
.BI "\-e\fP, \fB\-\-extradir" " extras"
34
 
]
35
 
[
36
 
.BI "\-S\fP, \fB\-\-statedir" " statedir"
37
 
]
38
 
[
39
 
.BI "\-T\fP, \fB\-\-tempdir" " tempdir"
40
 
]
41
 
.SH DESCRIPTION
42
 
.B icurepackage
43
 
combines data from multiple sources to produce a single common data
44
 
file.
45
 
The sources for data are the common data file if it already exists,
46
 
a set of individual files that were distributed with ICU, and a set of
47
 
extra files supplied by the user.
48
 
.PP
49
 
The repackaging works as follows. The existing common file is first
50
 
unpacked using
51
 
.BR decmn (8).
52
 
Files are then added back to a new common file, starting with extra
53
 
files, then files unpacked from the existing common data file, and
54
 
ending with individual files that were distributed with ICU.
55
 
(Note that it is not necessary for the individual ICU files to exist
56
 
for 
57
 
.B icurepackage
58
 
to work properly.)
59
 
.PP
60
 
Some special files are ignored when the new common file is built. For
61
 
instance, the common data file itself is ignored, and, unless the
62
 
.BI "\-\-all"
63
 
option is used, the converter aliases file
64
 
.B cnvalias.dat
65
 
is also ignored.
66
 
.SH OPTIONS
67
 
.TP
68
 
.BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
69
 
Print help about usage and exit.
70
 
.TP
71
 
.BI "\-v\fP, \fB\-\-verbose"
72
 
Display extra informative messages during execution.
73
 
.BI "\-s\fP, \fB\-\-sourcedir" " source"
74
 
Set the source directory to
75
 
.IR source .
76
 
The default source directory is 
77
 
.BR @thelibdir@/@PACKAGE@/@VERSION@/files .
78
 
.TP
79
 
.BI "\-d\fP, \fB\-\-destdir" " destination"
80
 
Set the destination directory to
81
 
.IR destination .
82
 
The default destination directory is specified by the environment variable
83
 
.BR ICU_DATA .
84
 
.TP
85
 
.BI "\-\-all"
86
 
Include all data files except the common file itself, but not ignoring
87
 
the special data files mentionned in the
88
 
.B SYNOPSYS
89
 
section.
90
 
.TP
91
 
.BI "\-\-extras"
92
 
Include extra files that are found in the
93
 
.I destination
94
 
directory.
95
 
.TP
96
 
.BI "\-e\fP, \fB\-\-extradir" " extras"
97
 
Include extra files that are found in the
98
 
.I extras
99
 
directory.
100
 
.SH ENVIRONMENT
101
 
.TP 10
102
 
.B ICU_DATA
103
 
Specifies the directory containing ICU data. Defaults to
104
 
.BR @thepkgicudatadir@/@PACKAGE@/@VERSION@/ .
105
 
Some tools in ICU depend on the presence of the trailing slash. It is thus
106
 
important to make sure that it is present if
107
 
.B ICU_DATA
108
 
is set.
109
 
.TP
110
 
TMPDIR
111
 
The default value for the temporary directory specified by the
112
 
.BI "\-T,\fP, \fB-\-tempdir"
113
 
option.
114
 
.SH VERSION
115
 
@VERSION@
116
 
.SH COPYRIGHT
117
 
Copyright (C) 2000-2002 IBM, Inc. and others.
118
 
.SH SEE ALSO
119
 
.BR decmn (8),
120
 
.BR gencmn (8)