User:Jjmcd/Drafts/Building the F11 RPM

From FedoraProject

Jump to: navigation, search

In Fedora 11, fedora-release-notes.rpm contains 6 documents, the same as Fedora 10. However, unlike Fedora 10, the release notes proper are built with Publican. The other five documents are built with fedora-doc-utils, the same as Fedora 10.

Each of the five "old" documents are handled the same way. The documents are:

  • about-fedora
  • homepage
  • README
  • README-BURNING-ISOS
  • readme-live-image

For each of these five documents, first, the document must be cloned from git, and the copyright and version numbers changed. The changes are commited to git. The document is then built using f-d-u. In the case of about-fedora, it is also necessary to build the omf files, also using f-d-u.

Now the products of the build need to be moved into a directory named <document>-<version> in a precise arrangement. As an example, for Fedora 11 preview, the arrangements looked like:

 about-fedora-10.93.0
 |
 omf files
 |
 --- about-fedora
     |
     --- bn_IN
     |   |
     |   about-fedora.xml
     |
     --- C
     |   |
     |   about-fedora.xml
     |
     --- ca
     |
       (etc)

This directory structure is then stored in a tarfile named about-fedora-10.93.0.tar.gz

homepage also has some uniqueness:

 homepage-10.93.0
 |
 --- homepage
 |   |
 |   homepage.css
 |   index-bal.html
 |   index-bn_IN.html
 |    (etc)
 |
 --- images
 |   |
 |   cc_logo_76x18.png
 |    (etc)
 |
 --- img
 |   |
 |   applications-internetL_24px.png
 |    (etc)
 |
 --- stylesheet-images
     |
     1.png
      (etc)

The three READMEs all have the same format

 README-10.93.0
 |
 README-bn_IN.txt
 README-ca.txt
  (etc)

Each of these is made into a tarball with a name corresponding to the name of the top directory.