mirror of
https://git.proxmox.com/git/llvm-toolchain
synced 2025-06-12 07:09:43 +00:00
| .. | ||
| patches | ||
| source | ||
| tests | ||
| changelog | ||
| clang-format-X.Y.install.in | ||
| clang-format-X.Y.lintian-overrides.in | ||
| clang-format-X.Y.manpages.in | ||
| clang-tidy-X.Y.install.in | ||
| clang-tidy-X.Y.links.in | ||
| clang-tidy-X.Y.lintian-overrides.in | ||
| clang-tidy-X.Y.manpages.in | ||
| clang-tools-X.Y.install.in | ||
| clang-tools-X.Y.links.in | ||
| clang-tools-X.Y.lintian-overrides.in | ||
| clang-tools-X.Y.manpages.in | ||
| clang-X.Y-doc.docs.in | ||
| clang-X.Y-examples.examples.in | ||
| clang-X.Y.install.in | ||
| clang-X.Y.links.in | ||
| clang-X.Y.lintian-overrides.in | ||
| clang-X.Y.manpages.in | ||
| compat | ||
| control | ||
| copyright | ||
| debian_path.h | ||
| libc++1-X.Y.install.in | ||
| libc++1-X.Y.links.in | ||
| libc++1-X.Y.lintian-overrides.in | ||
| libc++-X.Y-dev.install.in | ||
| libc++-X.Y-dev.links.in | ||
| libc++-X.Y-dev.lintian-overrides.in | ||
| libc++abi1-X.Y.install.in | ||
| libc++abi1-X.Y.links.in | ||
| libc++abi1-X.Y.lintian-overrides.in | ||
| libc++abi-X.Y-dev.install.in | ||
| libc++abi-X.Y-dev.links.in | ||
| libc++abi-X.Y-dev.lintian-overrides.in | ||
| libclang1-X.Y.install.in | ||
| libclang1-X.Y.links.in | ||
| libclang1-X.Y.lintian-overrides.in | ||
| libclang1-X.Y.symbols.in | ||
| libclang-common-X.Y-dev.install.in | ||
| libclang-common-X.Y-dev.links.in | ||
| libclang-cpp1-X.Y.install.in | ||
| libclang-X.Y-dev.install.in | ||
| libclang-X.Y-dev.links.in | ||
| liblld-X.Y-dev.install.in | ||
| liblld-X.Y.install.in | ||
| liblld-X.Y.links.in | ||
| liblldb-7.install.kfreebsd | ||
| liblldb-X.Y-dev.install.in | ||
| liblldb-X.Y-dev.links.in | ||
| liblldb-X.Y.install.in | ||
| liblldb-X.Y.links.in | ||
| liblldb-X.Y.lintian-overrides.in | ||
| libllvm-X.Y-ocaml-dev.dirs.in | ||
| libllvm-X.Y-ocaml-dev.install.in | ||
| libllvm-X.Y-ocaml-dev.lintian-overrides.in | ||
| libllvm-X.Y-ocaml-dev.META.in | ||
| libllvmX.Y.install.in | ||
| libllvmX.Y.links.in | ||
| libllvmX.Y.lintian-overrides.in | ||
| libomp5-X.Y.install.in | ||
| libomp5-X.Y.links.in | ||
| libomp5-X.Y.lintian-overrides.in | ||
| libomp5-X.Y.symbols.in | ||
| libomp-X.Y-dev.install.in | ||
| libomp-X.Y-dev.links.in | ||
| libomp-X.Y-doc.docs.in | ||
| libomp-X.Y.links.in | ||
| lld-X.Y.install.in | ||
| lld-X.Y.manpages.in | ||
| lldb-X.Y.install.in | ||
| lldb-X.Y.links.in | ||
| lldb-X.Y.lintian-overrides.in | ||
| lldb-X.Y.manpages.in | ||
| lldb-X.Y.postinst.in | ||
| llvm-priv-dev.dirs | ||
| llvm-X.Y-dev.dirs.in | ||
| llvm-X.Y-dev.install.in | ||
| llvm-X.Y-dev.links.in | ||
| llvm-X.Y-doc.dirs.in | ||
| llvm-X.Y-doc.install.in | ||
| llvm-X.Y-examples.dirs.in | ||
| llvm-X.Y-examples.examples.in | ||
| llvm-X.Y-examples.links.in | ||
| llvm-X.Y-runtime.binfmt.in | ||
| llvm-X.Y-runtime.install.in | ||
| llvm-X.Y-runtime.lintian-overrides.in | ||
| llvm-X.Y-runtime.manpages.in | ||
| llvm-X.Y-runtime.postinst.in | ||
| llvm-X.Y-runtime.prerm.in | ||
| llvm-X.Y-tools.dirs.in | ||
| llvm-X.Y-tools.install.in | ||
| llvm-X.Y.dirs.in | ||
| llvm-X.Y.install.in | ||
| llvm-X.Y.lintian-overrides.in | ||
| llvm-X.Y.manpages.in | ||
| NEWS | ||
| orig-tar.sh | ||
| pollycc.in | ||
| prepare-new-release.sh | ||
| python3-lldb-X.Y.install.in | ||
| python-clang-X.Y.install.in | ||
| python-lldb-X.Y.install.in | ||
| python-lldb-X.Y.links.in | ||
| qualify-clang.sh | ||
| README | ||
| README.source | ||
| rules | ||
| source.lintian-overrides | ||
| TODO | ||
| unpack.sh | ||
| watch | ||
Organization of the repository
==============================
The debian package for each LLVM point release is maintained as a git branch.
For example, the 9 release lives at in the "9" branch.
The current snapshot release is maintained in the "snapshot" branch.
The easiest way to get all branches is probably to have one
clone per version:
for f in 4.0 5.0 6.0 7 snapshot; do
git clone git@salsa.debian.org:pkg-llvm-team/llvm-toolchain.git -b $f $f
done
Steps for manually building a snapshot release
==============================================
1) Retrieve the latest snapshot and create original tarballs.
Run the orig-tar.sh script,
$ sh snapshot/debian/orig-tar.sh
which will retrieve the latest version for each LLVM subproject (llvm,
clang, lldb, etc.) from the main development (upstream SVN). and repack it
as a set of tarballs.
2) Unpack the original tarballs and apply quilt debian patches.
From the branches/ directory run the unpack.sh script,
$ sh unpack.sh
which will unpack the source tree inside a new directory such as
branches/llvm-toolchain-snapshot_3.9~svn269942. Depending on the current
snapshot version number and svn release, the directory name will be
different.
Quilt patches will then be applied.
3) Build the binary packages using,
$ fakeroot debian/rules binary
When debugging, successive builds can be recompiled faster by using tools such
as ccache (PATH=/usr/lib/ccache:$PATH fakeroot debian/rules binary).
Retrieving a specific branch or release candidate with orig-tar.sh
==================================================================
When using orig-tar.sh, if you need to retrieve a specific branch, you can pass
the branch name as the first argument. For example, to get the 9 release
branch at
http://llvm.org/svn/llvm-project/{llvm,...}/branches/release_90
you should use,
$ sh snapshot/debian/orig-tar.sh release_90
To retrieve a specific release candidate, you can pass the branch name as the
first argument, and the tag rc number as the second argument. For example, to
get the 9.0.1 release candidate rc3 at
http://llvm.org/svn/llvm-project/{llvm,...}/tags/RELEASE_901/rc3
you should use,
$ sh snapshot/debian/orig-tar.sh RELEASE_901 rc3 9.0.1
For a stable release, the syntax is:
$ sh snapshot/debian/orig-tar.sh RELEASE_900 final 9.0
Additional maintainer scripts
=============================
The script qualify-clang.sh that is found at the git debian/ directory
should be used to quickly test a newly built package. It runs a short
set of sanity-check tests and regression tests.
The script releases/snapshot/debian/prepare-new-release.sh is used when
preparing a new point release. It automatically replaces version numbers
in various files of the package.
Change in major upstream version
================================
TODO update with the git commands
$ svn copy snapshot VERSION
$ svn commit -m "VERSION branched" VERSION
$ cd VERSION
$ sed -i -e '0,/llvm-toolchain-snapshot/s/llvm-toolchain-snapshot/llvm-toolchain-VERSION/' debian/changelog debian/control
$ svn commit -m "snapshot => VERSION"
$ cd ../snapshot
$ emacs debian/prepare-new-release.sh
# Change the version
$ bash debian/prepare-new-release.sh
$ svn commit -m "new snapshot release"
Now, try build build it.