[PATCH] D101446: [llvm] Improve export.sh with help and snapshot

[Konrad Wilhelm Kleine via Phabricator via llvm-commits]

kwk created this revision.
kwk added a reviewer: tstellar.
Herald added a reviewer: bollu.
kwk requested review of this revision.
Herald added a reviewer: jdoerfert.
Herald added subscribers: llvm-commits, sstefan1.
Herald added a project: LLVM.

This change adds the ability to create source tarballs for unreleased or untagged code by providing the `--snapshot <GIT_REF>` flag to the `llvm/utils/release/export.sh` script.

The default behavior of `export.sh` hasn't changed.

The `-help` output of `export.sh` was changed quite significantly to look like this:

  Export the Git sources and build tarballs from them.
  
  Usage: export.sh [-release|--release <major>.<minor>.<patch>]
                        [-rc|--rc <num>]
                        [-final|--final]
                        [-snapshot|--snapshot <git-ref>] 
  
  Flags:
  
    -release  | --release <major>.<minor>.<patch>    The version number of the release
    -rc       | --rc <num>                           The release candidate number
    -final    | --final                              When provided, this option will disable the rc flag
    -snapshot | --snapshot <git-ref>                 (optional) Use <git-ref> to determine the release and don't export the test-suite files
  
  The following list shows the filenames (with <placeholders>) for the artifacts and
  hard links for each LLVM component created by this script. Notice, the hard links
  are only created when you give .
  
      llvm-<RELEASE><RC>.src.tar.xz              <- llvm-<YYYYMMDD>.src.tar.xz
      clang-<RELEASE><RC>.src.tar.xz             <- clang-<YYYYMMDD>.src.tar.xz
      compiler-rt-<RELEASE><RC>.src.tar.xz       <- compiler-rt-<YYYYMMDD>.src.tar.xz
      libcxx-<RELEASE><RC>.src.tar.xz            <- libcxx-<YYYYMMDD>.src.tar.xz
      libcxxabi-<RELEASE><RC>.src.tar.xz         <- libcxxabi-<YYYYMMDD>.src.tar.xz
      libclc-<RELEASE><RC>.src.tar.xz            <- libclc-<YYYYMMDD>.src.tar.xz
      clang-tools-extra-<RELEASE><RC>.src.tar.xz <- clang-tools-extra-<YYYYMMDD>.src.tar.xz
      polly-<RELEASE><RC>.src.tar.xz             <- polly-<YYYYMMDD>.src.tar.xz
      lldb-<RELEASE><RC>.src.tar.xz              <- lldb-<YYYYMMDD>.src.tar.xz
      lld-<RELEASE><RC>.src.tar.xz               <- lld-<YYYYMMDD>.src.tar.xz
      openmp-<RELEASE><RC>.src.tar.xz            <- openmp-<YYYYMMDD>.src.tar.xz
      libunwind-<RELEASE><RC>.src.tar.xz         <- libunwind-<YYYYMMDD>.src.tar.xz
      flang-<RELEASE><RC>.src.tar.xz             <- flang-<YYYYMMDD>.src.tar.xz
  
  Additional files being generated:
  
    * llvm-project-<RELEASE><RC>.src.tar.xz    (the complete LLVM source project)
    * test-suite-<RELEASE><RC>.src.tar.xz      (only when not using --snapshot)
  
  To ease the creation of snapshot builds, we also provide these files
  
    * llvm-release-<YYYYMMDD>.txt        (contains the <RELEASE> as a text)
    * llvm-rc-<YYYYMMDD>.txt             (contains the rc version passed to the invocation of export.sh)
    * llvm-git-revision-<YYYYMMDD>.txt   (contains the current git revision sha1)
  
  Example values for the placeholders:
  
    * <RELEASE>  -> 13.0.0
    * <YYYYMMDD> -> 20210414
    * <RC>       -> rc4        (will be empty when using --snapshot)


Repository:
  rG LLVM Github Monorepo

https://reviews.llvm.org/D101446

Files:
  llvm/utils/release/export.sh

-------------- next part --------------
A non-text attachment was scrubbed...
Name: D101446.341158.patch
Type: text/x-patch
Size: 6621 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/llvm-commits/attachments/20210428/46476807/attachment.bin>