mirror of https://github.com/tidwall/tile38.git
64 lines
2.3 KiB
Markdown
64 lines
2.3 KiB
Markdown
|
This repository holds supplementary Go libraries for text processing, many involving Unicode.
|
||
|
|
|
||
|
|
|
||
|
|
# Semantic Versioning
|
||
|
|
This repo uses Semantic versioning (http://semver.org/), so
|
||
|
|
1. MAJOR version when you make incompatible API changes,
|
||
|
|
1. MINOR version when you add functionality in a backwards-compatible manner,
|
||
|
|
and
|
||
|
|
1. PATCH version when you make backwards-compatible bug fixes.
|
||
|
|
|
||
|
|
A Unicode major and minor version bump is mapped to a major version bump in
|
||
|
|
x/text.
|
||
|
|
A path version bump in Unicode is mapped to a minor version bump in x/text.
|
||
|
|
Note that, consistent with the definitions in semver, until version 1.0.0 of
|
||
|
|
x/text is reached, the minor version is considered a major version.
|
||
|
|
So going from 0.1.0 to 0.2.0 is considered to be a major version bump.
|
||
|
|
|
||
|
|
A major new CLDR version is mapped to a minor version increase in x/text.
|
||
|
|
Any other new CLDR version is mapped to a patch version increase in x/text.
|
||
|
|
|
||
|
|
|
||
|
|
# Contribute
|
||
|
|
To submit changes to this repository, see http://golang.org/doc/contribute.html.
|
||
|
|
|
||
|
|
To generate the tables in this repository (except for the encoding tables),
|
||
|
|
run go generate from this directory. By default tables are generated for the
|
||
|
|
Unicode version in core and the CLDR version defined in
|
||
|
|
golang.org/x/text/unicode/cldr.
|
||
|
|
|
||
|
|
Running go generate will as a side effect create a DATA subdirectory in this
|
||
|
|
directory, which holds all files that are used as a source for generating the
|
||
|
|
tables. This directory will also serve as a cache.
|
||
|
|
|
||
|
|
## Testing
|
||
|
|
Run
|
||
|
|
|
||
|
|
go test ./...
|
||
|
|
|
||
|
|
from this directory to run all tests. Add the "-tags icu" flag to also run
|
||
|
|
ICU conformance tests (if available). This requires that you have the correct
|
||
|
|
ICU version installed on your system.
|
||
|
|
|
||
|
|
## Versions
|
||
|
|
To update a Unicode version run
|
||
|
|
|
||
|
|
UNICODE_VERSION=x.x.x go generate
|
||
|
|
|
||
|
|
where `x.x.x` must correspond to a directory in http://www.unicode.org/Public/.
|
||
|
|
If this version is newer than the version in core it will also update the
|
||
|
|
relevant packages there. The idna package in x/net will always be updated.
|
||
|
|
|
||
|
|
To update a CLDR version run
|
||
|
|
|
||
|
|
CLDR_VERSION=version go generate
|
||
|
|
|
||
|
|
where `version` must correspond to a directory in
|
||
|
|
http://www.unicode.org/Public/cldr/.
|
||
|
|
|
||
|
|
Note that the code gets adapted over time to changes in the data and that
|
||
|
|
backwards compatibility is not maintained.
|
||
|
|
So updating to a different version may not work.
|
||
|
|
|
||
|
|
The files in DATA/{iana|icu|w3|whatwg} are currently not versioned.
|