xref: /aosp_15_r20/external/cronet/net/tools/tld_cleanup/README (revision 6777b5387eb2ff775bb5750e3f5d96f37fb7352b)

When updating src/net/base/registry_controlled_domains/effective_tld_names.dat:

1. Obtain the new effective_tld_names.dat, probably by downloading
   https://publicsuffix.org/list/public_suffix_list.dat

2. Remove whitespace from the ends of the lines.
   You could possibly use something like:
     sed -i -e "s/\s*$//g" \
         src/net/base/registry_controlled_domains/effective_tld_names.dat

3. Add the Chromium note back in just after the license at the top, and just
   before '===BEGIN ICANN DOMAINS==='. Ensure there is an empty line above and
   two empty lines below the note. The note should say:
// Chromium note: this is based on Mozilla's file:
// https://publicsuffix.org/list/public_suffix_list.dat

4. Diff the changes and restore any changes annotated with a "// CHROMIUM"
   comment.

5. Build tld_cleanup (the "(net)" > "tld_cleanup" project)

6. Run it (no arguments needed), typically from src/build/Release or
   src/build/Debug. It will re-generate
   src/net/base/registry_controlled_domains/effective_tld_names.gperf.

7. Check in the updated effective_tld_names.dat, effective_tld_names.gperf

Note that gperf is no longer used for effective_tld_names, but when building
chromium the file effective_tld_names.gperf will be parsed by make_dafsa.py
to generate the file effective_tld_names-inc.cc, which is included in
registry_controlled_domain.cc