From Fedora Project Wiki

(Note on new-sources)
No edit summary
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{header|docs}}
{{header|docs}}


Before beginning this process, be sure you have been through the [[Preparing the Release Notes for final release]].
Before beginning this process, be sure you have been through the [[Preparing the Release Notes for final release]] and you have installed doc-publican-rpm.


1. Build the package with doc-publican-rpm - you will need the tar and spec files so keep track of them
1. Check the release notes out of the release git repo
fedpkg co fedora-release-notes
 
2. Change into the local repo folder
cd fedora-release-notes
 
3. copy fedora-release-notes.spec to the directory you will use to build the RPM.


2. Do a koji scratch build of the SRPM for both the next release and rawhide to ensure a clean build
4. Change to that directory and add a changelog entry to the copy of fedora-release-notes.spec.  Also, in the description update the Fedora release number if needed. There is no need to change anything else.  Rename that file to fedora-release-notes.spec.old.
 
5. Create doc-publican-rpm.config following the instructions in the man page
 
6. Build the package with doc-publican-rpm - you will need the tar and spec files so keep track of them
{{admon/warning|You must not do a publican publish between the publican build and making the tar.  |publican publish corrupts the htmls}}
 
7. Do a koji scratch build of the SRPM for both the next release and rawhide to ensure a clean build
   pushd ~/rpmbuild/SRPMS
   pushd ~/rpmbuild/SRPMS
   koji build --scratch dist-rawhide fedora-release-notes-x.y.z.fc13.src.rpm
   koji build --scratch rawhide fedora-release-notes-x.y.z.fc16.src.rpm
   koji build --scratch dist-f14 fedora-release-notes-x.y.z.fc13.src.rpm
   koji build --scratch f18-candidate fedora-release-notes-x.y.z.fc16.src.rpm
   popd
   popd


3. Check the release notes out of the release git repo
8. Switch back to the directory created by fedpkg
fedpkg co fedora-release-notes


4. Change into the local repo folder
9. Switch to the branch for the next release
  cd fedora-release-notes
  fedpkg switch-branch f17


5. Switch to the branch for the next release
10. Post the d-p-r produced tar to the repo
fedpkg switch-branch f14
 
6. Post the d-p-r produced tar to the repo
  fedpkg new-sources somewhere/fedora-release-notes-x.y.z.tar.gz
  fedpkg new-sources somewhere/fedora-release-notes-x.y.z.tar.gz


7. Copy the spec file into the local repo copy
11. Copy the spec file into the local repo copy
  cp somewhere/fedora-release-notes.spec .
  cp somewhere/fedora-release-notes.spec .


8. Add the changed spec file to the commit (fedpkg already added the tar)
12. Add the changed spec file to the commit (fedpkg already added the tar)
  git add fedora-release-notes.spec
  git add fedora-release-notes.spec


9. Commit the tar and specfile
13. Commit the tar and specfile
  git commit -m "yada yada yada"
  git commit -m "yada yada yada"


10. Push the changes up to fp.o
14. Push the changes up to fp.o
   git push
   git push


11. Build the package from the repo
15. Build the package from the repo
   fedpkg build
   fedpkg build


12. Repeat steps 5-11 for rawhide.  (Note that even though fedpkg new-sources indicates that the sources are already uploaded, you still need to execute the command to indicate that the new sources apply to the rawhide branch.)
16. Create a Bodhi update request
  fedpkg update
 
17. Repeat steps 9-15 for rawhide.  (Note that even though fedpkg new-sources indicates that the sources are already uploaded, you still need to execute the command to indicate that the new sources apply to the rawhide branch.) the rawhide package does not need to go to Bodhi.


13. Watch the progress of the builds on Koji (http://koji.fedoraproject.org/koji/).  When complete, log on to Bodhi and request stable.
18. Watch the progress of the builds on Koji (http://koji.fedoraproject.org/koji/).  When complete, log on to Bodhi and request stable.


14. Recruit your friends and neighbors to give the document karma (https://fedoraproject.org/wiki/Giving_a_document_karma)
19. Recruit your friends and neighbors to give the document karma (https://fedoraproject.org/wiki/Giving_a_document_karma)


{{Category:Docs_Project_process}}
[[Category:Docs Project process]]

Latest revision as of 15:08, 4 December 2012

Before beginning this process, be sure you have been through the Preparing the Release Notes for final release and you have installed doc-publican-rpm.

1. Check the release notes out of the release git repo

fedpkg co fedora-release-notes

2. Change into the local repo folder

cd fedora-release-notes

3. copy fedora-release-notes.spec to the directory you will use to build the RPM.

4. Change to that directory and add a changelog entry to the copy of fedora-release-notes.spec. Also, in the description update the Fedora release number if needed. There is no need to change anything else. Rename that file to fedora-release-notes.spec.old.

5. Create doc-publican-rpm.config following the instructions in the man page

6. Build the package with doc-publican-rpm - you will need the tar and spec files so keep track of them

You must not do a publican publish between the publican build and making the tar.
publican publish corrupts the htmls

7. Do a koji scratch build of the SRPM for both the next release and rawhide to ensure a clean build

 pushd ~/rpmbuild/SRPMS
 koji build --scratch rawhide fedora-release-notes-x.y.z.fc16.src.rpm
 koji build --scratch f18-candidate fedora-release-notes-x.y.z.fc16.src.rpm
 popd

8. Switch back to the directory created by fedpkg

9. Switch to the branch for the next release

fedpkg switch-branch f17

10. Post the d-p-r produced tar to the repo

fedpkg new-sources somewhere/fedora-release-notes-x.y.z.tar.gz

11. Copy the spec file into the local repo copy

cp somewhere/fedora-release-notes.spec .

12. Add the changed spec file to the commit (fedpkg already added the tar)

git add fedora-release-notes.spec

13. Commit the tar and specfile

git commit -m "yada yada yada"

14. Push the changes up to fp.o

 git push

15. Build the package from the repo

 fedpkg build

16. Create a Bodhi update request

 fedpkg update

17. Repeat steps 9-15 for rawhide. (Note that even though fedpkg new-sources indicates that the sources are already uploaded, you still need to execute the command to indicate that the new sources apply to the rawhide branch.) the rawhide package does not need to go to Bodhi.

18. Watch the progress of the builds on Koji (http://koji.fedoraproject.org/koji/). When complete, log on to Bodhi and request stable.

19. Recruit your friends and neighbors to give the document karma (https://fedoraproject.org/wiki/Giving_a_document_karma)