Skip to content

Commit 46fc40a

Browse files
authored
Update README to reflect move from big-merge to rawhide (#773)
1 parent 9824494 commit 46fc40a

File tree

1 file changed

+13
-24
lines changed

1 file changed

+13
-24
lines changed

README.adoc

Lines changed: 13 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ This project uses `pre-commit` to validate that certain files (e.g. fmf or pytho
5050

5151
We build LLVM snapshots on a daily basis on Copr and create a github issue in this very repository for every day to keep track of the build and testing status. The link:https://github.com/fedora-llvm-team/llvm-snapshots/blob/816d4e061e748c82f15ca3d1c772d93814a91afe/.github/workflows/check-snapshots.yml#L40[maintainer] changes on a monthly basis and will be assigned to the issue.
5252

53-
For a while now we've switched from standalone builds to the building everything from a single link:https://src.fedoraproject.org/rpms/llvm/tree/big-merge[dist git repo] with the working title "big-merge" on the **Fedora Package Source**. Before we used to have one spec file repository for all the llvm subprojects (clang, lld, lldb, etc.).
53+
For a while now we've switched from standalone builds to the building everything from a single link:https://src.fedoraproject.org/rpms/llvm/tree/rawhide[dist git repo] with the working title "big-merge" on the **Fedora Package Source**. Before we used to have one spec file repository for all the llvm subprojects (clang, lld, lldb, etc.). Now we've taken it one step further and build the snapshots directly out of the `rawhide` branch.
5454

5555
Our snapshot builds are done under our link:https://copr.fedorainfracloud.org/groups/g/fedora-llvm-team/coprs/[group account] on Fedora Copr. There build for all supported Fedora version and some RHEL versions.
5656

@@ -80,11 +80,11 @@ $ export FAS_USER=<YOUR_USERMAME>
8080
NOTE: This is optional and only for copy pasting the below commands. Use the username to login in here: https://id.fedoraproject.org/login.
8181
--
8282

83-
2. Clone the original source code's `big-merge` branch and navigate to that directory.
83+
2. Clone the original source code's `rawhide` branch and navigate to that directory.
8484
+
8585
--
8686
----
87-
$ fedpkg clone llvm -b big-merge ~/dev/llvm-rpms/llvm
87+
$ fedpkg clone llvm -b rawhide ~/dev/llvm-rpms/llvm
8888
8989
$ cd ~/dev/llvm-rpms/llvm
9090
----
@@ -112,10 +112,10 @@ $ git commit -m "My changes"
112112
$ git push $FAS_USER HEAD:mybranch
113113
----
114114

115-
6. Create a pull-requst for your changes so they can go into the `big-merge` branch by executing this and heading over to your browser:
115+
6. Create a pull-request for your changes so they can go into the `rawhide` branch by executing this and heading over to your browser:
116116
+
117117
----
118-
$ xdg-open https://src.fedoraproject.org/fork/$FAS_USER/rpms/compiler-rt/diff/big-merge..mybranch
118+
$ xdg-open https://src.fedoraproject.org/fork/$FAS_USER/rpms/compiler-rt/diff/rawhide..mybranch
119119
----
120120

121121
7. Wait for your changes to be approved and merged. Maybe ping someone from the team.
@@ -133,37 +133,28 @@ $ copr build-package \
133133
@fedora-llvm-team/llvm-snapshots-big-merge-`date +%Y%m%d`
134134
----
135135

136-
This will build the `llvm` package with your changes as soon as they landed in the `big-merge` branch in today's Copr project.
136+
This will build the `llvm` package in today's Copr project with your changes as soon as they landed in the `rawhide` branch.
137137
--
138138

139139

140-
=== Syncing a package with rawhide
141-
142-
Unlike with many other projects, we actually do want to keep the complete git
143-
history of downstream patches and changes being made to a `.spec` file.
144-
145-
IMPORTANT: That is why we almost always prefer `git merge --no-ff --log --summary` over `git rebase`.
146-
147140
== Frequently Asked Questions [[faq]]
148141

149142
=== How can I clone `llvm`?
150143

151144
I cloned `llvm` with the appropriate tool (e.g. `fedpkg`, `centpkg` and `rhpkg`).
152145

153146
----
154-
$ fedpkg clone llvm -b rawhide ~/dev/llvm-rpms/llvm-rawhide #<1>
155-
$ fedpkg clone llvm -b big-merge ~/dev/llvm-rpms/llvm-big-merge #<2>
156-
$ centpkg clone llvm -b c9s ~/dev/llvm-rpms/llvm-centos #<3>
157-
$ rhpkg clone llvm -b rhel-9-main ~/dev/llvm-rpms/clang-rhel #<4>
147+
$ fedpkg clone llvm -b rawhide ~/src/llvm-rpms/llvm-rawhide #<1>
148+
$ centpkg clone llvm -b c9s ~/src/llvm-rpms/llvm-centos #<2>
149+
$ rhpkg clone llvm -b rhel-9-main ~/src/llvm-rpms/llvm-rhel #<3>
158150
----
159151
<1> This is for the regular fedora work on rawhide.
160-
<2> This is for the work on the LLVM snapshots.
161-
<3> This is for the work on CentOS stream.
162-
<4> This is for the internal work on RHEL9.
152+
<2> This is for the work on CentOS stream.
153+
<3> This is for the internal work on RHEL9.
163154

164155
=== How to sync with rawhide?
165156

166-
It is not entirely clear yet but we're aiming towards doing the snapshot work in the `rawhide` branch of fedora.
157+
We do the snapshot work in the `rawhide` branch of fedora.
167158

168159
These are the benefits that we see:
169160
* No special handling for contributors. They can just use rawhide.
@@ -178,9 +169,7 @@ Of course there are some downsides as well:
178169
* A bit more if/else branches in the spec files.
179170
* Duplicated patch files with slightly different content as they apply to each supported LLVM version.
180171

181-
We would need `%if %{maj_ver} >= 20` conditions or alike for different LLVM versions (see link:https://src.fedoraproject.org/rpms/llvm/pull-request/286#_4__13[this PR] for example).
182-
183-
Once we've found a good way to do the patch handling and versioning inside the `rawhide` spec file repository of `llvm`, we're going to update this very FAQ.
172+
We need `%if %{maj_ver} >= 20` conditions or alike for different LLVM versions (see link:https://src.fedoraproject.org/rpms/llvm/pull-request/286#_4__13[this PR] for example).
184173

185174
=== How do I find the monitor? [[monitor]]
186175

0 commit comments

Comments
 (0)