intl/icu/source/tools/icupkg/icupkg.8.in@fc2d59ddac77 (annotated)
intl/icu/source/tools/icupkg/icupkg.8.in
Wed, 31 Dec 2014 07:22:50 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Wed, 31 Dec 2014 07:22:50 +0100
- branch
- TOR_BUG_3246
- changeset 4
- fc2d59ddac77
- permissions
- -rw-r--r--
Correct previous dual key logic pending first delivery installment.
| michael@0 | 1 | .\" Hey, Emacs! This is -*-nroff-*- you know... |
| michael@0 | 2 | .\" |
| michael@0 | 3 | .\" icupkg.8: manual page for the icupkg utility |
| michael@0 | 4 | .\" |
| michael@0 | 5 | .\" Copyright (C) 2000-2006 IBM, Inc. and others. |
| michael@0 | 6 | .\" |
| michael@0 | 7 | .TH ICUPKG 8 "18 August 2006" "ICU MANPAGE" "ICU @VERSION@ Manual" |
| michael@0 | 8 | .SH NAME |
| michael@0 | 9 | .B icupkg |
| michael@0 | 10 | \- extract or modify an ICU |
| michael@0 | 11 | .B .dat |
| michael@0 | 12 | archive |
| michael@0 | 13 | .SH SYNOPSIS |
| michael@0 | 14 | .B icupkg |
| michael@0 | 15 | [ |
| michael@0 | 16 | .BR "\-h\fP, \fB\-?\fP, \fB\-\-help" |
| michael@0 | 17 | ] |
| michael@0 | 18 | [ |
| michael@0 | 19 | .BR "\-tl\fP, \fB\-\-type" " l" |
| michael@0 | 20 | | |
| michael@0 | 21 | .BR "\-tb\fP, \fB\-\-type" " b" |
| michael@0 | 22 | | |
| michael@0 | 23 | .BR "\-te\fP, \fB\-\-type" " e" |
| michael@0 | 24 | ] |
| michael@0 | 25 | [ |
| michael@0 | 26 | .BR "\-c\fP, \fB\-\-copyright" |
| michael@0 | 27 | | |
| michael@0 | 28 | .BI "\-C\fP, \fB\-\-comment" " comment" |
| michael@0 | 29 | ] |
| michael@0 | 30 | [ |
| michael@0 | 31 | .BI "\-a\fP, \fB\-\-add" " list" |
| michael@0 | 32 | ] |
| michael@0 | 33 | [ |
| michael@0 | 34 | .BI "\-r\fP, \fB\-\-remove" " list" |
| michael@0 | 35 | ] |
| michael@0 | 36 | [ |
| michael@0 | 37 | .BI "\-x\fP, \fB\-\-extract" " list" |
| michael@0 | 38 | ] |
| michael@0 | 39 | [ |
| michael@0 | 40 | .BI "\-l\fP, \fB\-\-list" |
| michael@0 | 41 | ] |
| michael@0 | 42 | [ |
| michael@0 | 43 | .BI "\-s\fP, \fB\-\-sourcedir" " source" |
| michael@0 | 44 | ] |
| michael@0 | 45 | [ |
| michael@0 | 46 | .BI "\-d\fP, \fB\-\-destdir" " destination" |
| michael@0 | 47 | ] |
| michael@0 | 48 | [ |
| michael@0 | 49 | .BI "\-w\fP, \fB\-\-writepkg" |
| michael@0 | 50 | ] |
| michael@0 | 51 | [ |
| michael@0 | 52 | .BI "\-m\fP, \fB\-\-matchmode" " mode" |
| michael@0 | 53 | ] |
| michael@0 | 54 | .IR infilename |
| michael@0 | 55 | [ |
| michael@0 | 56 | .BI "outfilename" |
| michael@0 | 57 | ] |
| michael@0 | 58 | .SH DESCRIPTION |
| michael@0 | 59 | .B icupkg |
| michael@0 | 60 | reads the input ICU |
| michael@0 | 61 | .B .dat |
| michael@0 | 62 | package file, modify it according to the options, |
| michael@0 | 63 | swap it to the desired platform properties (charset & endianness), |
| michael@0 | 64 | and optionally write the resulting ICU |
| michael@0 | 65 | .B .dat |
| michael@0 | 66 | package to the output file. |
| michael@0 | 67 | Items are removed, then added, then extracted and listed. |
| michael@0 | 68 | An ICU |
| michael@0 | 69 | .B .dat |
| michael@0 | 70 | package is written if items are removed or added, |
| michael@0 | 71 | or if the input and output filenames differ, |
| michael@0 | 72 | or if the |
| michael@0 | 73 | .BR "\-w\fP, \fB\-\-writepkg" |
| michael@0 | 74 | option is set. |
| michael@0 | 75 | .PP |
| michael@0 | 76 | If the input filename is "new" then an empty package is created. |
| michael@0 | 77 | If the output filename is missing, then it is automatically generated |
| michael@0 | 78 | from the input filename. If the input filename ends with an l, b, or e |
| michael@0 | 79 | matching its platform properties, then the output filename will |
| michael@0 | 80 | contain the letter from the |
| michael@0 | 81 | .BI "\-t\fP, \fB\-\-type" |
| michael@0 | 82 | option. |
| michael@0 | 83 | .PP |
| michael@0 | 84 | This tool can also be used to just swap a single ICU data file, replacing the |
| michael@0 | 85 | former icuswap tool. For this mode, provide the infilename (and optional |
| michael@0 | 86 | outfilename) for a non-package ICU data file. |
| michael@0 | 87 | Allowed options include |
| michael@0 | 88 | .BI "\-t\fP, \fB\-w\fP, \fB\-s\fP" |
| michael@0 | 89 | and |
| michael@0 | 90 | .BI \-d |
| michael@0 | 91 | . |
| michael@0 | 92 | The filenames can be absolute, or relative to the source/dest dir paths. |
| michael@0 | 93 | Other options are not allowed in this mode. |
| michael@0 | 94 | .SH OPTIONS |
| michael@0 | 95 | .TP |
| michael@0 | 96 | .BR "\-h\fP, \fB\-?\fP, \fB\-\-help" |
| michael@0 | 97 | Print help about usage and exit. |
| michael@0 | 98 | .TP |
| michael@0 | 99 | .BI "\-tl\fP, \fB\-\-type" " l" |
| michael@0 | 100 | Output for little-endian/ASCII charset family. |
| michael@0 | 101 | The output type defaults to the input type. |
| michael@0 | 102 | .TP |
| michael@0 | 103 | .BI "\-tb\fP, \fB\-\-type" " b" |
| michael@0 | 104 | Output for big-endian/ASCII charset family. |
| michael@0 | 105 | The output type defaults to the input type. |
| michael@0 | 106 | .TP |
| michael@0 | 107 | .BI "\-te\fP, \fB\-\-type" " e" |
| michael@0 | 108 | Output for big-endian/EBCDIC charset family. |
| michael@0 | 109 | The output type defaults to the input type. |
| michael@0 | 110 | .TP |
| michael@0 | 111 | .BR \-c\fP, \fB\-\-copyright |
| michael@0 | 112 | Include the ICU copyright notice in the resulting data. |
| michael@0 | 113 | .TP |
| michael@0 | 114 | .BI "\-C\fP, \fB\-\-comment" " comment" |
| michael@0 | 115 | Include the specified |
| michael@0 | 116 | .I comment |
| michael@0 | 117 | in the resulting data instead of the ICU copyright notice. |
| michael@0 | 118 | .TP |
| michael@0 | 119 | .BI "\-a\fP, \fB\-\-add" " list" |
| michael@0 | 120 | Add items from the |
| michael@0 | 121 | .I list |
| michael@0 | 122 | to the package. The list can be a single filename with a |
| michael@0 | 123 | .B .txt |
| michael@0 | 124 | file extension containing a list of item filenames, or an ICU |
| michael@0 | 125 | .B .dat |
| michael@0 | 126 | package filename. |
| michael@0 | 127 | .TP |
| michael@0 | 128 | .BI "\-r\fP, \fB\-\-remove" " list" |
| michael@0 | 129 | Remove items from the |
| michael@0 | 130 | .I list |
| michael@0 | 131 | from the package. The list can be a single filename with a |
| michael@0 | 132 | .B .txt |
| michael@0 | 133 | file extension containing a list of item filenames, or an ICU |
| michael@0 | 134 | .B .dat |
| michael@0 | 135 | package filename. |
| michael@0 | 136 | .TP |
| michael@0 | 137 | .BI "\-x\fP, \fB\-\-extract" " list" |
| michael@0 | 138 | Extract items from the |
| michael@0 | 139 | .I list |
| michael@0 | 140 | from the package. The list can be a single filename with a |
| michael@0 | 141 | .B .txt |
| michael@0 | 142 | file extension containing a list of item filenames, or an ICU |
| michael@0 | 143 | .B .dat |
| michael@0 | 144 | package filename. |
| michael@0 | 145 | .TP |
| michael@0 | 146 | .BI "\-m\fP, \fB\-\-matchmode" " mode" |
| michael@0 | 147 | Set the matching mode for item names with wildcards. |
| michael@0 | 148 | .TP |
| michael@0 | 149 | .BI "\-s\fP, \fB\-\-sourcedir" " source" |
| michael@0 | 150 | Set the source directory to |
| michael@0 | 151 | .IR source . |
| michael@0 | 152 | The default source directory is the current directory. |
| michael@0 | 153 | .TP |
| michael@0 | 154 | .BI "\-d\fP, \fB\-\-destdir" " destination" |
| michael@0 | 155 | Set the destination directory to |
| michael@0 | 156 | .IR destination . |
| michael@0 | 157 | The default destination directory is the current directory. |
| michael@0 | 158 | .TP |
| michael@0 | 159 | .BI "\-l\fP, \fB\-\-list" |
| michael@0 | 160 | List the package items to stdout (after modifying the package). |
| michael@0 | 161 | .SH LIST FILE SYNTAX |
| michael@0 | 162 | Items are listed on one or more lines and separated by whitespace (space+tab). |
| michael@0 | 163 | Comments begin with |
| michael@0 | 164 | .B # |
| michael@0 | 165 | and are ignored. Empty lines are ignored. Lines where the first non-whitespace |
| michael@0 | 166 | character is one of "%&'()*+,-./:;<=>?_ are also ignored |
| michael@0 | 167 | to reserve for future syntax. |
| michael@0 | 168 | .PP |
| michael@0 | 169 | Items for removal or extraction may contain a single |
| michael@0 | 170 | .B * |
| michael@0 | 171 | wildcard character. The |
| michael@0 | 172 | .B * |
| michael@0 | 173 | matches zero or more characters. If |
| michael@0 | 174 | .BI "\-m\fP, \fB\-\-matchmode" " noslash" |
| michael@0 | 175 | is set, then the |
| michael@0 | 176 | .B * |
| michael@0 | 177 | character does not match the |
| michael@0 | 178 | .B / |
| michael@0 | 179 | character. |
| michael@0 | 180 | .PP |
| michael@0 | 181 | Items must be listed relative to the package, and the |
| michael@0 | 182 | .B "\fB\-\-sourcedir" |
| michael@0 | 183 | or the |
| michael@0 | 184 | .B "\fB\-\-destdir" |
| michael@0 | 185 | path will be prepended. The paths are only prepended to item |
| michael@0 | 186 | filenames while adding or extracting items, not to ICU .dat package or list |
| michael@0 | 187 | filenames. |
| michael@0 | 188 | .PP |
| michael@0 | 189 | Paths may contain |
| michael@0 | 190 | .B / |
| michael@0 | 191 | instead of the platform's file separator character and are converted as |
| michael@0 | 192 | appropriate. |
| michael@0 | 193 | .SH AUTHORS |
| michael@0 | 194 | Markus Scherer |
| michael@0 | 195 | .br |
| michael@0 | 196 | George Rhoten |
| michael@0 | 197 | .SH VERSION |
| michael@0 | 198 | 1.0 |
| michael@0 | 199 | .SH COPYRIGHT |
| michael@0 | 200 | Copyright (C) 2006 IBM, Inc. and others. |
| michael@0 | 201 | .SH SEE ALSO |
| michael@0 | 202 | .BR pkgdata (1) |
| michael@0 | 203 | .BR genrb (1) |
| michael@0 | 204 |
