Lines Matching +full:create +full:- +full:release
1 ---
4 parent: Release & Milestone Tasks
7 ---
9 <!--
12 -->
18 {: .no_toc .text-delta }
23 ---
30 see** [ICU-8862](https://unicode-org.atlassian.net/browse/ICU-8862) **).**
33 `sudo apt-get install doxygen`
36 1. To update Doxygen, first [download binary or source release
38 2. Unpack the release, and run something like<br>
39 "`configure --prefix /usr/local`" (to install into /usr/local/bin etc)<br>
40 (Note for the binary release, 'configure' just builds an installer.)
43 4. Verify that '`doxygen --version`' gives the correct number.
51 …[tools/release/java/readme.txt](https://htmlpreview.github.io/?https://github.com/unicode-org/icu/…
58 2. grep --recursive --include="\*.h" --exclude-dir=".svn" -e "@deprecated"
59 -A 5 . > at-deprecated.txt
60 3. grep --recursive --include="\*.h" --exclude-dir=".svn" -e "U_DEPRECATED"
61 -B 5 -A 1 . > u_deprecated.txt
70 compatibility](https://unicode-org.github.io/icu/userguide/icu/design#icu-api-compatibility).
73 [com.ibm.icu.dev.tool.docs.CheckTags](https://github.com/unicode-org/icu/blob/main/icu4j/tools/buil…
75 tool will need to change to reflect the release number to search for.
78 report since the previous official release.
88 ---
92 APIs previously introduced as @draft are reviewed for every new release. The
93 current policy is to keep @draft status at least in one release cycle. For
95 Then the API will be reviewed by ICU technical committee before ICU 62 release
100 Andy's method (from email 2019-sep-05):
104 * Start by making a copy of the previous release spread sheet, to get the
107 * Do the API promotion - search the sources for @draft, and make a best guess
113 * Cross-check the API change report and the spread sheet.
118 1. Create a new GitHub branch.
120 3. This **ant** target generates a tab-separated values file at
122 4. Import the TSV file to Google spread sheet - for example, [ICU4J 61 Draft
125 * Create the spreadsheet in the shared ***ICU Projects*** folder.
127 older for ICU 61 release.
143 11. Once ICU TC approves the proposed change, create a pull request (PR), wait
146 ---
160 …[tools/release/java/readme.txt](https://github.com/unicode-org/icu/blob/main/tools/release/java/re…
168 * `export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64`
174 ArabicShaping constants do not have proper tags - otherwise, clean)
178 Once official release version is shipped, we need to keep API signature
180 only after the final official release.
187 ---
191 Once APIs are frozen for a reference release, we should check in the API
204 version is generated and checked into trunk just before ***maint-xx*** branch is
206 maintenance releases of the major version (A maintenance release should have no
209 ---
214 `#ifndef U_HIDE_DRAFT_API`. This allows users to `-DU_HIDE_DRAFT_API` to make
240 * We cannot #ifndef-guard virtual methods because that makes the vtable
244 * When you #ifndef-guard enum constants, normally the following unguarded ones
248 <span style="background-color:yellow">For more details (and cautions) see the
249 Coding Guidelines section [C/C++ Hiding Un-@stable
250 APIs](https://unicode-org.github.io/icu/userguide/dev/codingguidelines#cc-hiding-un-stable-apis).</…
265 We don't have tools for this. <span style="background-color:yellow">One approach
267 files. Use grep options like -A 3, -B 2 and -C 3 for context After, Before, and
268 Around the matching line. <span style="background-color:yellow">A better
269 approach if you have the tools available is to use a programming-oriented text
275 "(U_HIDE_\[A-Z_\]+)|(@draft)|(@deprecated)|(@obsolete)|(@system)|(@internal)|(@preview)"
279 <span style="background-color:yellow">As part of this, you may need to run side
283 <span style="background-color:yellow">There is no magic bullet; however you
288 ---
294 [ICU-8571](https://unicode-org.atlassian.net/browse/ICU-8571))*
299 2. `cd source/tools/gendraft ; make install-headers`
303 ---
308 that will come out before our next release, basically) with the tool
309 [com.ibm.icu.dev.tool.docs.ICUJDKCompare](https://github.com/unicode-org/icu/blob/main/icu4j/tools/…
312 ---
318 Build the API documentation pages for the new release. Run Doxygen to create the
319 javadoc files. Create icu4c-X_X_X-docs.zip
322 [ICU-8862](https://unicode-org.atlassian.net/browse/ICU-8862) )**
324 #### Create the ICU4C docs zip file:
328 `make doc-searchengine`
331 4. Create a zip file, e.g.,<br>
332 `tar cvfz /tmp/icu4c72rc.tar.gz * # Note: label the file apropriately for the release.
335 #### Create a PR for ICU4C docs using the docs zip file
337 1. Follow directions in [How to update ICU docs](https://unicode-org.github.io/icu-docs/HOWTO-Upda…
339 a. First, bring the `main` branch of your icu-docs local copy up to date.
341 …b. Create and switch to a feature branch based of the latest `main`. Ex: `git checkout -b ICU-<TI…
344 `apidoc/dev/icu4c` (release candicate) or `apidoc/released/icu4c`
345 (general release.)
348 in this directory, e.g., `rm -rf *`. (Remember "git restore" is a good friend!)
356 h. `git commit -m "ICU-<TICKET-NUMBER> Update ICU4C API reference docs for
358 …Example: [ICU-21546 Update ICU4C API reference docs for 69.1](https://github.com/unicode-org/icu-d…
360 i. `git push origin ICU-<TICKET-NUMBER>`
362 …j. Create Pull Request from your personal github fork of icu-docs from your newly-pushed branch `I…
363 the `unicode-org/icu-docs` repo's `main` branch
367 Note: This is also referenced below [Upload API documentations](docs.md#upload-api-documentations) …
372 <https://icu.unicode.org/setup/java/ant#TOC-Building-ICU4J-API-Reference-Document-with-JCite>
374 Build the API documentation pages for the new release:
383 <https://icu.unicode.org/setup/java/ant#TOC-Building-ICU4J-API-Reference-Document-with-JCite>
385 Use the release target
391 which generate all release files.
393 * Upload the output files including icu4j-docs.jar to the release page first,
396 See [Upload API documentations](docs.md#upload-api-documentations) below for how to make the API do…
400 See <https://unicode-org.github.io/icu-docs/HOWTO-Update.html> for instructions
401 to upload to <https://unicode-org.github.io/icu-docs/>