From 30ade5164cca9407f8b8febbeb2a2947b344580a Mon Sep 17 00:00:00 2001 From: Sylvestre Ledru Date: Fri, 2 Mar 2018 13:34:41 +0100 Subject: [PATCH 1/2] add the README --- debian/README | 100 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 100 insertions(+) create mode 100644 debian/README diff --git a/debian/README b/debian/README new file mode 100644 index 00000000..404cab81 --- /dev/null +++ b/debian/README @@ -0,0 +1,100 @@ +Organization of the repository +============================== + +The debian package for each LLVM point release is maintained as a git branch. +For example, the 6.0 release lives at in the "6.0" 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 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~svn268942. 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 6.0 release +branch at + http://llvm.org/svn/llvm-project/{llvm,...}/branches/release_60 +you should use, + + $ sh 6.0/debian/orig-tar.sh release_60 + +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 6.0.1 release candidate rc3 at + http://llvm.org/svn/llvm-project/{llvm,...}/tags/RELEASE_601/rc3 +you should use, + + $ sh 6.0/debian/orig-tar.sh RELEASE_601 rc3 6.0.1 + +For a stable release, the syntax is: + + $ sh 6.0/debian/orig-tar.sh RELEASE_600 final 6.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. From f7527df04463d2b23dbd498f550598eaf014872e Mon Sep 17 00:00:00 2001 From: Sylvestre Ledru Date: Tue, 20 Mar 2018 20:10:12 +0100 Subject: [PATCH 2/2] fix changelog --- debian/changelog | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/debian/changelog b/debian/changelog index 7a859d8f..b400ae2b 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,17 +1,12 @@ -llvm-toolchain-6.0 (1:6.0-3) unstable; urgency=medium - - * Remove a bunch of old unused patches - * Fix debian-watch-uses-insecure-uri as upstream has now https - * Standards-Version updated to 4.1.3 - - -- Sylvestre Ledru Sat, 17 Mar 2018 17:07:19 +0100 - llvm-toolchain-6.0 (1:6.0-2) unstable; urgency=medium * clang-tidy-6.0: depends on libclang-common-6.0-dev (Closes: #891999) * clang-tidy-6.0 also depends on clang-tools-6.0 for, at least clang-apply-replacements + * Remove a bunch of old unused patches + * Fix debian-watch-uses-insecure-uri as upstream has now https + * Standards-Version updated to 4.1.3 -- Sylvestre Ledru Mon, 05 Mar 2018 09:58:10 +0100