release-notes/devel/en_US Installer.xml, 1.2, 1.3 Kernel.xml, 1.2, 1.3 Multimedia.xml, 1.2, 1.3 OverView.xml, 1.2, 1.3 PackageChanges.xml, 1.2, 1.3
Karsten Wade (kwade)
fedora-docs-commits at redhat.com
Wed Jul 12 12:13:57 UTC 2006
Author: kwade
Update of /cvs/docs/release-notes/devel/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv1475/en_US
Modified Files:
Installer.xml Kernel.xml Multimedia.xml OverView.xml
PackageChanges.xml
Log Message:
Fixes across the XML for various reasons, this is now ready to rock for test2.
Index: Installer.xml
===================================================================
RCS file: /cvs/docs/release-notes/devel/en_US/Installer.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- Installer.xml 12 Jul 2006 03:46:36 -0000 1.2
+++ Installer.xml 12 Jul 2006 12:13:54 -0000 1.3
@@ -15,14 +15,14 @@
<note>
<title>Downloading Large Files</title>
<para>
- If you intend to download the Fedora Core DVD ISO image, keep
- in mind that not all file downloading tools can accommodate
- files larger than 2GB in size. {{{wget}}} 1.9.1-16 and above,
- {{{curl}}} and {{{ncftpget}}} do not have this limitation, and
- can successfully download files larger than 2GB.
- '''BitTorrent''' is another method for downloading large
- files. For information about obtaining and using the torrent
- file, refer to http://torrent.fedoraproject.org/.
+ If you intend to download the Fedora Core DVD ISO image, keep in mind
+ that not all file downloading tools can accommodate files larger than
+ 2GB in size. <code>wget</code> 1.9.1-16 and above, <code>curl</code> and
+ <code>ncftpget</code> do not have this limitation, and can successfully
+ download files larger than 2GB. BitTorrent is another method for
+ downloading large files. For information about obtaining and using the
+ torrent file, refer to <ulink
+ url="http://torrent.fedoraproject.org/">http://torrent.fedoraproject.org/</ulink>.
</para>
</note>
</para>
@@ -57,12 +57,12 @@
</itemizedlist>
<para>
<important>
- <title>Bit``Torrent Automatically Verifies File Integrity</title>
+ <title>BitTorrent Automatically Verifies File Integrity</title>
<para>
- If you use '''Bit``Torrent''', any files you download are
+ If you use BitTorrent, any files you download are
automatically validated. If your file completes downloading,
you do not need to check it. Once you burn your CD, however,
- you should still use {{{mediacheck}}}.
+ you should still use <code>mediacheck</code>.
</para>
</important>
</para>
@@ -82,7 +82,7 @@
</itemizedlist>
<para>
<note>
- <title>{{{Memtest86}}} Availability</title>
+ <title>Memtest86 Availability</title>
<para>
You must boot from Installation Disc 1 or a rescue CD in order
to use this feature.
@@ -219,8 +219,8 @@
<important>
<title>System Configuration Backups</title>
<para>
- Backups of configurations in `/etc` are also useful in
- reconstructing system settings after a fresh installation.
+ Backups of configurations in <filename>/etc</filename> are also useful
+ in reconstructing system settings after a fresh installation.
</para>
</important>
</para>
Index: Kernel.xml
===================================================================
RCS file: /cvs/docs/release-notes/devel/en_US/Kernel.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- Kernel.xml 12 Jul 2006 03:46:36 -0000 1.2
+++ Kernel.xml 12 Jul 2006 12:13:54 -0000 1.3
@@ -3,405 +3,347 @@
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.docbook.org/xml/4.4/docbookx.dtd">
<section id="sn-Kernel">
- <title>Linux Kernel</title>
+ <title>Linux Kernel</title>
- <para>
- This section covers changes and important information regarding
- the kernel in Fedora Core
-<!--GetVal-macro not supported by the docbook formatter, but giving it a shot anyway-->
- 6 test2.
- </para>
+ <para>
+ This section covers changes and important information regarding the kernel
+ in Fedora Core <!--GetVal-macro not supported by the docbook formatter, but
+ giving it a shot anyway--> 6 test2.
+ </para>
- <section>
- <title>Version</title>
+ <section>
+ <title>Version</title>
- <para>
- This distribution is based on the 2.6 series of the Linux
- kernel. Fedora Core may include additional patches for
- improvements, bug fixes, or additional features. For this
- reason, the Fedora Core kernel may not be line-for-line
- equivalent to the so-called <emphasis>vanilla kernel</emphasis>
- from the kernel.org web site:
- </para>
+ <para>
+ This distribution is based on the 2.6 series of the Linux kernel. Fedora
+ Core may include additional patches for improvements, bug fixes, or
+ additional features. For this reason, the Fedora Core kernel may not be
+ line-for-line equivalent to the so-called <emphasis>vanilla
+ kernel</emphasis> from the kernel.org web site:
+ </para>
- <para>
- <ulink url='http://www.kernel.org/'>http://www.kernel.org/</ulink>
- </para>
+ <para>
+ <ulink url='http://www.kernel.org/'>http://www.kernel.org/</ulink>
+ </para>
- <para>
- To obtain a list of these patches, download the source RPM
- package and run the following command against it:
- </para>
+ <para>
+ To obtain a list of these patches, download the source RPM package and run
+ the following command against it:
+ </para>
- <itemizedlist>
- <listitem override='none'>
-<screen><![CDATA[rpm -qpl kernel-<version>.src.rpm
-]]></screen>
- </listitem>
- </itemizedlist>
- </section>
+ <itemizedlist>
+ <listitem override='none'>
+ <screen><![CDATA[rpm -qpl kernel-<version>.src.rpm ]]></screen>
+ </listitem>
+ </itemizedlist>
+ </section>
- <section>
- <title>Changelog</title>
+ <section>
+ <title>Changelog</title>
- <para>
- To retrieve a log of changes to the package, run the following
- command:
- </para>
+ <para>
+ To retrieve a log of changes to the package, run the following command:
+ </para>
- <itemizedlist>
- <listitem override='none'>
-<screen><![CDATA[rpm -q --changelog kernel-<version>
-]]></screen>
- </listitem>
- </itemizedlist>
+ <itemizedlist>
+ <listitem override='none'>
+ <screen><![CDATA[rpm -q --changelog kernel-<version> ]]></screen>
+ </listitem>
+ </itemizedlist>
- <para>
- If you need a user friendly version of the changelog, refer to
- <ulink url='http://wiki.kernelnewbies.org/LinuxChanges'>http://wiki.kernelnewbies.org/LinuxChanges</ulink>.
- A short and full diff of the kernel is available from
- <ulink url='http://kernel.org/git'>http://kernel.org/git</ulink>.
- The Fedora version kernel is based on the Linus tree.
- </para>
+ <para>
+ If you need a user friendly version of the changelog, refer to <ulink
+ url='http://wiki.kernelnewbies.org/LinuxChanges'>http://wiki.kernelnewbies.org/LinuxChanges</ulink>.
+ A short and full diff of the kernel is available from <ulink
+ url='http://kernel.org/git'>http://kernel.org/git</ulink>. The Fedora
+ version kernel is based on the Linus tree.
+ </para>
- <para>
- Customizations made for the Fedora version are available from
- <ulink url='http://cvs.fedora.redhat.com'>http://cvs.fedora.redhat.com</ulink>
- .
- </para>
- </section>
+ <para>
+ Customizations made for the Fedora version are available from <ulink
+ url='http://cvs.fedoraproject.org'>http://cvs.fedoraproject.org</ulink>
+ .
+ </para>
+ </section>
- <section>
- <title>Kernel Flavors</title>
+ <section>
+ <title>Kernel Flavors</title>
- <para>
- Fedora Core
-<!--GetVal-macro not supported by the docbook formatter, but giving it a shot anyway-->
- 6 test2 includes the following kernel builds:
- </para>
+ <para>
+ Fedora Core <!--GetVal-macro not supported by the docbook formatter, but
+ giving it a shot anyway--> 6 test2 includes the following kernel builds:
+ </para>
- <itemizedlist>
- <listitem>
- <para>
- Native kernel, in both uni-processor and SMP (Symmetric
- Multi-Processor) varieties. SMP kernels provide support for
- multiple CPUs. Configured sources are available in the
- <code>kernel-[smp-]devel-<version>.<arch>.rpm</code>
- package.
- </para>
- </listitem>
- <listitem>
- <para>
- Virtual kernel hypervisor for use with the Xen emulator
- package. Configured sources are available in the
- <code>kernel-xen0-devel-<version>.<arch>.rpm</code>
- package.
- </para>
- </listitem>
- <listitem>
- <para>
- Virtual kernel guest for use with the Xen emulator package.
- Configured sources are available in the
- <code>kernel-xenU-devel-<version>.<arch>.rpm</code>
- package.
- </para>
- </listitem>
- <listitem>
- <para>
- Kdump kernel for use with kexec/kdump capabilities.
- Configured sources are available in the
- <code>kernel-kdump-devel-<version>.<arch>.rpm</code>
- package.
- </para>
- </listitem>
- </itemizedlist>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Native kernel, in both uni-processor and SMP (Symmetric
+ Multi-Processor) varieties. SMP kernels provide support for multiple
+ CPUs. Configured sources are available in the
+ <code>kernel-[smp-]devel-<version>.<arch>.rpm</code> package.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Virtual kernel hypervisor for use with the Xen emulator package.
+ Configured sources are available in the
+ <code>kernel-xen0-devel-<version>.<arch>.rpm</code> package.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Virtual kernel guest for use with the Xen emulator package. Configured
+ sources are available in the
+ <code>kernel-xenU-devel-<version>.<arch>.rpm</code> package.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Kdump kernel for use with kexec/kdump capabilities. Configured sources
+ are available in the
+ <code>kernel-kdump-devel-<version>.<arch>.rpm</code> package.
+ </para>
+ </listitem>
+ </itemizedlist>
- <para>
- You may install kernel headers for all kernel flavors at the
- same time. The files are installed in the
- <code>/usr/src/kernels/<version>-[xen0|xenU|kdump]-<arch>/</code>
- tree. Use the following command:
- </para>
+ <para>
+ You may install kernel headers for all kernel flavors at the same time.
+ The files are installed in the
+ <code>/usr/src/kernels/<version>-[xen0|xenU|kdump]-<arch>/</code>
+ tree. Use the following command:
+ </para>
- <itemizedlist>
- <listitem override='none'>
-<screen><![CDATA[su -c 'yum install kernel-{xen0,xenU,kdump}-devel'
-]]></screen>
- </listitem>
- </itemizedlist>
+ <itemizedlist>
+ <listitem override='none'>
+ <screen><![CDATA[su -c 'yum install kernel-{xen0,xenU,kdump}-devel'
+ ]]></screen>
+ </listitem>
+ </itemizedlist>
+ <para>
+ Select one or more of these flavors, separated by commas and no spaces, as
+ appropriate. Enter the root password when prompted.
+ </para>
+ <note>
+ <title>x86_64 Default Kernel Provides SMP</title>
<para>
- Select one or more of these flavors, separated by commas and no
- spaces, as appropriate. Enter the root password when prompted.
+ There is no separate SMP kernel available for the x86_64 architecture in
+ Fedora Core <!--GetVal-macro not supported by the docbook formatter, but
+ giving it a shot anyway-->6 test2.
+ </para>
+ </note>
+ <note>
+ <title>PowerPC Kernel Support</title>
+ <para>
+ There is no support for Xen or kdump for the PowerPC architecture in
+ Fedora Core <!--GetVal-macro not supported by the docbook formatter, but
+ giving it a shot anyway-->6 test2.
</para>
+ </note>
+
+ </section>
- <itemizedlist>
- <listitem override='none'>
- <informaltable>
- <tgroup cols='1'>
- <colspec colname='col_0'/>
- <tbody>
- <row>
-<entry colsep='1' rowsep='1'><para> <inlinemediaobject><imageobject><imagedata width='16' fileref='http://docbook.wikiwikiweb.de/wiki/modern/img/icon-info.png' depth='16'/></imageobject><textobject><phrase>{i}</phrase></textobject></inlinemediaobject> <emphasis role='strong'>x86_64 Default Kernel Provides SMP</emphasis> </para></entry>
- </row>
- <row>
-<entry colsep='1' rowsep='1'><para> There is no separate SMP kernel available for the x86_64 architecture in Fedora Core <!--GetVal-macro not supported by the docbook formatter, but giving it a shot anyway-->6 test2. </para></entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- <informaltable>
- <tgroup cols='1'>
- <colspec colname='col_0'/>
- <tbody>
- <row>
-<entry colsep='1' rowsep='1'><para> <inlinemediaobject><imageobject><imagedata width='16' fileref='http://docbook.wikiwikiweb.de/wiki/modern/img/icon-info.png' depth='16'/></imageobject><textobject><phrase>{i}</phrase></textobject></inlinemediaobject> <emphasis role='strong'>PowerPC Kernel Support</emphasis> </para></entry>
- </row>
- <row>
-<entry colsep='1' rowsep='1'><para> There is no support for Xen or kdump for the PowerPC architecture in Fedora Core <!--GetVal-macro not supported by the docbook formatter, but giving it a shot anyway-->6 test2. </para></entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </listitem>
- </itemizedlist>
- </section>
-
- <section>
- <title>Reporting Bugs</title>
+ <section>
+ <title>Reporting Bugs</title>
- <para>
- Refer to
- <ulink url='http://kernel.org/pub/linux/docs/lkml/reporting-bugs.html'>http://kernel.org/pub/linux/docs/lkml/reporting-bugs.html</ulink>
- for information on reporting bugs in the Linux kernel. You may
- also use
- <ulink url='http://bugzilla.redhat.com'>http://bugzilla.redhat.com</ulink>
- for reporting bugs which are specific to Fedora.
- </para>
- </section>
+ <para>
+ Refer to <ulink
+ url='http://kernel.org/pub/linux/docs/lkml/reporting-bugs.html'>http://kernel.org/pub/linux/docs/lkml/reporting-bugs.html</ulink>
+ for information on reporting bugs in the Linux kernel. You may also use
+ <ulink url='http://bugzilla.redhat.com'>http://bugzilla.redhat.com</ulink>
+ for reporting bugs which are specific to Fedora.
+ </para>
+ </section>
- <section>
- <title>Following Generic Textbooks</title>
+ <section>
+ <title>Following Generic Textbooks</title>
- <para>
- Many of the tutorials, examples, and textbooks about Linux
- kernel development assume the kernel sources are installed under
- the <code>/usr/src/linux/</code> directory. If you make a
- symbolic link, as shown below, you should be able to use those
- learning materials with the Fedora Core packages. Install the
- appropriate kernel sources, as shown earlier, and then run the
- following command:
- </para>
+ <para>
+ Many of the tutorials, examples, and textbooks about Linux kernel
+ development assume the kernel sources are installed under the
+ <code>/usr/src/linux/</code> directory. If you make a symbolic link, as
+ shown below, you should be able to use those learning materials with the
+ Fedora Core packages. Install the appropriate kernel sources, as shown
+ earlier, and then run the following command:
+ </para>
- <itemizedlist>
- <listitem override='none'>
-<screen><![CDATA[su -c 'ln -s /usr/src/kernels/kernel-<all-the-rest> /usr/src/linux'
-]]></screen>
- </listitem>
- </itemizedlist>
+ <itemizedlist>
+ <listitem override='none'>
+ <screen><![CDATA[su -c 'ln -s /usr/src/kernels/kernel-<all-the-rest>
+ /usr/src/linux' ]]></screen>
+ </listitem>
+ </itemizedlist>
- <para>
- Enter the <code>root</code> password when prompted.
- </para>
- </section>
+ <para>
+ Enter the <code>root</code> password when prompted.
+ </para>
+ </section>
- <section>
- <title>Preparing for Kernel Development</title>
+ <section>
+ <title>Preparing for Kernel Development</title>
- <para>
- Fedora Core
-<!--GetVal-macro not supported by the docbook formatter, but giving it a shot anyway-->
- 6 test2 does not include the kernel-source package provided by
- older versions since only the kernel-devel package is required
- now to build external modules. Configured sources are available,
- as described in this kernel flavors section.
+ <para>
+ Fedora Core <!--GetVal-macro not supported by the docbook formatter, but
+ giving it a shot anyway--> 6 test2 does not include the kernel-source
+ package provided by older versions since only the kernel-devel package is
+ required now to build external modules. Configured sources are available,
+ as described in this kernel flavors section.
+ </para>
+
+ <note>
+ <title>Instructions Refer to Current Kernel</title>
+ <para>
+ To simplify the following directions, we have assumed that you want to
+ configure the kernel sources to match your currently-running kernel. In
+ the steps below, the expression <version> refers to the kernel
+ version shown by the command: <code>uname -r</code>.
</para>
+ </note>
- <itemizedlist>
- <listitem override='none'>
- <informaltable>
- <tgroup cols='1'>
- <colspec colname='col_0'/>
- <tbody>
- <row>
-<entry colsep='1' rowsep='1'><para> <inlinemediaobject><imageobject><imagedata width='16' fileref='http://docbook.wikiwikiweb.de/wiki/modern/img/icon-info.png' depth='16'/></imageobject><textobject><phrase>{i}</phrase></textobject></inlinemediaobject> <emphasis role='strong'>Instructions Refer to Current Kernel</emphasis> </para></entry>
- </row>
- <row>
-<entry colsep='1' rowsep='1'><para> To simplify the following directions, we have assumed that you want to configure the kernel sources to match your currently-running kernel. In the steps below, the expression <version> refers to the kernel version shown by the command: <code>uname -r</code>. </para></entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </listitem>
- </itemizedlist>
-
+ <para>
+ Users who require access to Fedora Core original kernel sources can find
+ them in the kernel .src.rpm package. To create an exploded source tree
+ from this file, perform the following steps:
+ </para>
+ <caution>
+ <title>Do Not Build Packages as Super-user (root)</title>
<para>
- Users who require access to Fedora Core original kernel sources
- can find them in the kernel .src.rpm package. To create an
- exploded source tree from this file, perform the following
- steps:
- </para>
-
- <itemizedlist>
- <listitem override='none'>
- <informaltable>
- <tgroup cols='1'>
- <colspec colname='col_0'/>
- <tbody>
- <row>
-<entry colsep='1' rowsep='1'><para> <inlinemediaobject><imageobject><imagedata width='15' fileref='http://docbook.wikiwikiweb.de/wiki/modern/img/attention.png' depth='15'/></imageobject><textobject><phrase><!></phrase></textobject></inlinemediaobject> <emphasis role='strong'>Do Not Build Packages as Super-user (root)</emphasis> </para></entry>
- </row>
- <row>
-<entry colsep='1' rowsep='1'><para> Building packages as the superuser is inherently dangerous and is not required, even for the kernel. These instructions allow you to install the kernel source as a normal user. Many general information sites refer to <code>/usr/src/linux</code> in their kernel instructions. If you use these instructions, simply substitute <code>~/rpmbuild/BUILD/kernel-<version>/linux-<version></code>. </para></entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </listitem>
- <listitem>
- <para>
- Prepare a RPM package building environment in your home
- directory. Run the following commands:
- </para>
- <itemizedlist>
- <listitem override='none'>
-<screen><![CDATA[su -c 'yum install fedora-rpmdevtools yum-utils'
-fedora-buildrpmtree
-]]></screen>
- <para>
- Enter the <code>root</code> password when prompted.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- <listitem>
- <para>
- Enable the appropriate <code>source</code> repository
- definition. In the case of the kernel released with Fedora
- Core 5, enable <code>core-source</code> by editing the file
- <code>/etc/yum.repos.d/fedora-core.repo</code> , setting the
- option <code>enabled=1</code> . In the case of update or
- testing kernels, enable the <code>source</code> definitions
- in <code>/etc/yum.repos.d/fedora-updates.repo</code> or
- <code>/etc/yum.repos.d/fedora-updates-testing.repo</code> as
- appropriate.
- </para>
- </listitem>
- <listitem>
- <para>
- Download the <code>kernel-<version>.src.rpm</code> file:
- </para>
- <itemizedlist>
- <listitem override='none'>
-<screen><![CDATA[yumdownloader --source kernel
-]]></screen>
- <para>
- Enter the <code>root</code> password when prompted.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- <listitem>
- <para>
- Install <code>kernel-<version>.src.rpm</code> using the
- command:
- </para>
- <itemizedlist>
- <listitem override='none'>
-<screen><![CDATA[rpm -Uvh kernel-<version>.src.rpm
-]]></screen>
- <para>
- This command writes the RPM contents into
- <code>${HOME}/rpmbuild/SOURCES</code> and
- <code>${HOME}/rpmbuild/SPECS</code> , where
- <code>${HOME}</code> is your home directory.
- </para>
- <informaltable>
- <tgroup cols='1'>
- <colspec colname='col_0'/>
- <tbody>
- <row>
-<entry colsep='1' rowsep='1'><para> <inlinemediaobject><imageobject><imagedata width='15' fileref='http://docbook.wikiwikiweb.de/wiki/modern/img/idea.png' depth='15'/></imageobject><textobject><phrase>(!)</phrase></textobject></inlinemediaobject> <emphasis role='strong'>Space Required</emphasis> </para></entry>
- </row>
- <row>
-<entry colsep='1' rowsep='1'><para> The full kernel building process may require several gigabytes of extra space on the file system containing your home directory. </para></entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </listitem>
- </itemizedlist>
- </listitem>
+ Building packages as the superuser is inherently dangerous and is not
+ required, even for the kernel. These instructions allow you to install
+ the kernel source as a normal user. Many general information sites
+ refer to <code>/usr/src/linux</code> in their kernel instructions. If
+ you use these instructions, simply substitute
+ <code>~/rpmbuild/BUILD/kernel-<version>/linux-<version></code>.
+ </para>
+ </caution>
+
+
+
+ <listitem>
+ <para>
+ Prepare a RPM package building environment in your home directory. Run
+ the following commands:
+ </para>
+ <itemizedlist>
+ <listitem override='none'>
+ <screen><![CDATA[su -c 'yum install fedora-rpmdevtools yum-utils'
+ fedora-buildrpmtree ]]></screen>
+ <para>
+ Enter the <code>root</code> password when prompted.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>
+ Enable the appropriate <code>source</code> repository definition. In the
+ case of the kernel released with Fedora Core 5, enable
+ <code>core-source</code> by editing the file
+ <code>/etc/yum.repos.d/fedora-core.repo</code> , setting the option
+ <code>enabled=1</code> . In the case of update or testing kernels,
+ enable the <code>source</code> definitions in
+ <code>/etc/yum.repos.d/fedora-updates.repo</code> or
+ <code>/etc/yum.repos.d/fedora-updates-testing.repo</code> as
+ appropriate.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Download the <code>kernel-<version>.src.rpm</code> file:
+ </para>
+ <itemizedlist>
+ <listitem override='none'>
+ <screen><![CDATA[yumdownloader --source kernel ]]></screen>
+ <para>
+ Enter the <code>root</code> password when prompted.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>
+ Install <code>kernel-<version>.src.rpm</code> using the command:
+ </para>
+ <itemizedlist>
+ <listitem override='none'>
+ <screen><![CDATA[rpm -Uvh kernel-<version>.src.rpm ]]></screen>
+ <para>
+ This command writes the RPM contents into
+ <code>${HOME}/rpmbuild/SOURCES</code> and
+ <code>${HOME}/rpmbuild/SPECS</code> , where <code>${HOME}</code> is
+ your home directory.
+ </para>
+ <tip>
+ <title>Space Required</title>
+ <para>
+ The full kernel building process may require several gigabytes of
+ extra space on the file system containing your home directory.
+ </para>
+ </tip>
+ </listitem>
<listitem>
<para>
Prepare the kernel sources using the commands:
</para>
<itemizedlist>
<listitem override='none'>
-<screen><![CDATA[cd ~/rpmbuild/SPECS
-rpmbuild -bp --target $(uname -m) kernel-2.6.spec
-]]></screen>
+ <screen><![CDATA[cd ~/rpmbuild/SPECS rpmbuild -bp --target $(uname
+ -m) kernel-2.6.spec ]]></screen>
<para>
The kernel source tree is located in the
- <code>${HOME}/rpmbuild/BUILD/kernel-<version>/</code>
- directory.
+ <code>${HOME}/rpmbuild/BUILD/kernel-<version>/</code>
+ directory.
</para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>
- The configurations for the specific kernels shipped in
- Fedora Core
-<!--GetVal-macro not supported by the docbook formatter, but giving it a shot anyway-->
- 6 test2 are in the <code>configs/</code> directory. For
- example, the i686 SMP configuration file is named
- <code>configs/kernel-<version>-i686-smp.config</code> .
- Issue the following command to place the desired
- configuration file in the proper place for building:
+ The configurations for the specific kernels shipped in Fedora Core
+ <!--GetVal-macro not supported by the docbook formatter, but giving
+ it a shot anyway--> 6 test2 are in the <code>configs/</code>
+ directory. For example, the i686 SMP configuration file is named
+ <code>configs/kernel-<version>-i686-smp.config</code> . Issue the
+ following command to place the desired configuration file in the
+ proper place for building:
</para>
<itemizedlist>
<listitem override='none'>
-<screen><![CDATA[cp configs/<desired-config-file> .config
-]]></screen>
+ <screen><![CDATA[cp configs/<desired-config-file> .config
+ ]]></screen>
<para>
- You can also find the <code>.config</code> file that
- matches your current kernel configuration in the
- <code>/lib/modules/<version>/build/.config</code>
- file.
+ You can also find the <code>.config</code> file that matches
+ your current kernel configuration in the
+ <code>/lib/modules/<version>/build/.config</code> file.
</para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>
- Every kernel gets a name based on its version number. This
- is the value the <code>uname -r</code> command displays. The
- kernel name is defined by the first four lines of the kernel
- <code>Makefile</code> . The <code>Makefile</code> has been
- changed to generate a kernel with a
- <emphasis>different</emphasis> name from that of the running
- kernel. To be accepted by the running kernel, a module must
- be compiled for a kernel with the correct name. To do this,
- you must edit the kernel <code>Makefile</code> .
+ Every kernel gets a name based on its version number. This is the
+ value the <code>uname -r</code> command displays. The kernel name is
+ defined by the first four lines of the kernel <code>Makefile</code>
+ . The <code>Makefile</code> has been changed to generate a kernel
+ with a <emphasis>different</emphasis> name from that of the running
+ kernel. To be accepted by the running kernel, a module must be
+ compiled for a kernel with the correct name. To do this, you must
+ edit the kernel <code>Makefile</code> .
</para>
<itemizedlist>
<listitem override='none'>
<para>
- For example, if the <code>uname -r</code> returns the
- string <code>2.6.15-1.1948_FC5</code> , change the
- <code>EXTRAVERSION</code> definition from this:
+ For example, if the <code>uname -r</code> returns the string
+ <code>2.6.15-1.1948_FC5</code> , change the
+ <code>EXTRAVERSION</code> definition from this:
</para>
-<screen><![CDATA[EXTRAVERSION = -prep
-]]></screen>
+ <screen><![CDATA[EXTRAVERSION = -prep ]]></screen>
<para>
to this:
</para>
-<screen><![CDATA[EXTRAVERSION = -1.1948_FC5
-]]></screen>
+ <screen><![CDATA[EXTRAVERSION = -1.1948_FC5 ]]></screen>
<para>
- That is, substitute everything from the final dash
- onward.
+ That is, substitute everything from the final dash onward.
</para>
</listitem>
</itemizedlist>
@@ -412,97 +354,76 @@
</para>
<itemizedlist>
<listitem override='none'>
-<screen><![CDATA[make oldconfig
-]]></screen>
+ <screen><![CDATA[make oldconfig ]]></screen>
<para>
You may then proceed as usual.
</para>
</listitem>
</itemizedlist>
</listitem>
- </itemizedlist>
- </section>
-
- <section>
- <title>Building Only Kernel Modules</title>
-
- <para>
- An exploded source tree is not required to build a kernel
- module, such as your own device driver, against the currently
- in-use kernel. Only the <code>kernel-devel</code> package is
- required to build external modules. If you did not select it
- during installation, use
- <emphasis role='strong'>Pirut</emphasis> to install it, going to
- <emphasis role='strong'>Applications > Add/Remove</emphasis>
- software or use <code>yum</code> to install it. Run the
- following command to install the <code>kernel-devel</code>
- package using <code>yum</code> .
- </para>
+
+ </section>
- <itemizedlist>
- <listitem override='none'>
-<screen><![CDATA[su -c 'yum install kernel-devel'
- ]]></screen>
- </listitem>
- </itemizedlist>
+ <section>
+ <title>Building Only Kernel Modules</title>
- <para>
- For example, to build the <code>foo.ko</code> module, create the
- following <code>Makefile</code> in the directory containing the
- <code>foo.c</code> file:
- </para>
+ <para>
+ An exploded source tree is not required to build a kernel module, such as
+ your own device driver, against the currently in-use kernel. Only the
+ <code>kernel-devel</code> package is required to build external modules.
+ If you did not select it during installation, use <emphasis
+ role='strong'>Pirut</emphasis> to install it, going to <emphasis
+ role='strong'>Applications > Add/Remove</emphasis> software or use
+ <code>yum</code> to install it. Run the following command to install the
+ <code>kernel-devel</code> package using <code>yum</code> .
+ </para>
- <itemizedlist>
- <listitem override='none'>
-<screen><![CDATA[obj-m := foo.o
+ <itemizedlist>
+ <listitem override='none'>
+ <screen><![CDATA[su -c 'yum install kernel-devel' ]]></screen>
+ </listitem>
+ </itemizedlist>
-KDIR := /lib/modules/$(shell uname -r)/build
-PWD := $(shell pwd)
+ <para>
+ For example, to build the <code>foo.ko</code> module, create the following
+ <code>Makefile</code> in the directory containing the <code>foo.c</code>
+ file:
+ </para>
-default:
- $(MAKE) -C $(KDIR) M=$(PWD) modules
-]]></screen>
- </listitem>
- </itemizedlist>
+ <itemizedlist>
+ <listitem override='none'>
+ <screen><![CDATA[obj-m := foo.o KDIR := /lib/modules/$(shell uname
+ -r)/build PWD := $(shell pwd) default: $(MAKE) -C $(KDIR) M=$(PWD)
+ modules ]]></screen>
+ </listitem>
+ </itemizedlist>
- <para>
- Issue the <code>make</code> command to build the
- <code>foo.ko</code> module.
- </para>
- </section>
+ <para>
+ Issue the <code>make</code> command to build the <code>foo.ko</code>
+ module.
+ </para>
+ </section>
- <section>
- <title>User Space Dependencies on the Kernel</title>
+ <section>
+ <title>User Space Dependencies on the Kernel</title>
+ <para>
+ Fedora Core <!--GetVal-macro not supported by the docbook formatter, but
+ giving it a shot anyway--> 6 test2 has support for clustered storage
+ through the Global File System (GFS). GFS requires special kernel modules
+ that work in conjunction with some user-space utilities, such as
+ management daemons. To remove such a kernel, perhaps after an update, use
+ the <code>su -c 'yum remove kernel-<version>'</code> command instead.
+ The <code>yum</code> command automatically removes dependent packages, if
+ necessary.
+ </para>
+ <note>
+ <title>PowerPC does not support GFS</title>
<para>
- Fedora Core
-<!--GetVal-macro not supported by the docbook formatter, but giving it a shot anyway-->
- 6 test2 has support for clustered storage through the Global
- File System (GFS). GFS requires special kernel modules that work
- in conjunction with some user-space utilities, such as
- management daemons. To remove such a kernel, perhaps after an
- update, use the <code>su -c 'yum remove
- kernel-<version>'</code> command instead. The
- <code>yum</code> command automatically removes dependent
- packages, if necessary.
+ The GFS kernel modules are not built for the PowerPC architecture in
+ Fedora Core <!--GetVal-macro not supported by the docbook formatter, but
+ giving it a shot anyway-->6 test2.
</para>
-
- <itemizedlist>
- <listitem override='none'>
- <informaltable>
- <tgroup cols='1'>
- <colspec colname='col_0'/>
- <tbody>
- <row>
-<entry colsep='1' rowsep='1'><para> <inlinemediaobject><imageobject><imagedata width='16' fileref='http://docbook.wikiwikiweb.de/wiki/modern/img/icon-info.png' depth='16'/></imageobject><textobject><phrase>{i}</phrase></textobject></inlinemediaobject> <emphasis role='strong'>PowerPC does not support GFS</emphasis> </para></entry>
- </row>
- <row>
-<entry colsep='1' rowsep='1'><para> The GFS kernel modules are not built for the PowerPC architecture in Fedora Core <!--GetVal-macro not supported by the docbook formatter, but giving it a shot anyway-->6 test2. </para></entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </listitem>
- </itemizedlist>
- </section>
+ </note>
</section>
+</section>
Index: Multimedia.xml
===================================================================
RCS file: /cvs/docs/release-notes/devel/en_US/Multimedia.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- Multimedia.xml 12 Jul 2006 03:46:36 -0000 1.2
+++ Multimedia.xml 12 Jul 2006 12:13:54 -0000 1.3
@@ -27,7 +27,7 @@
<para>
The default installation of Fedora Core includes
<emphasis role='strong'>Rhythmbox</emphasis>,
- <emphasis role='strong'>Totem</emphasis> and
+ <emphasis role='strong'>Totem</emphasis>, and
<emphasis role='strong'>Helix Player</emphasis> for media
playback. The Fedora Core and Fedora Extras repositories include
many other popular programs such as the
Index: OverView.xml
===================================================================
RCS file: /cvs/docs/release-notes/devel/en_US/OverView.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- OverView.xml 12 Jul 2006 03:46:36 -0000 1.2
+++ OverView.xml 12 Jul 2006 12:13:54 -0000 1.3
@@ -82,7 +82,7 @@
<para>
Printing support is improved in this release with the
inclusion of the <code>hplip</code> utility, which replaces
- <code>hpijs</code> . }}}
+ <code>hpijs</code>.
</para>
</listitem>
</itemizedlist>
Index: PackageChanges.xml
===================================================================
RCS file: /cvs/docs/release-notes/devel/en_US/PackageChanges.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- PackageChanges.xml 12 Jul 2006 03:46:36 -0000 1.2
+++ PackageChanges.xml 12 Jul 2006 12:13:54 -0000 1.3
@@ -2,50 +2,42 @@
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.docbook.org/xml/4.4/docbookx.dtd">
- <section id="sn-PackageChanges">
- <title>Package Changes</title>
-
- <para>
- This section has not been updated for Fedora Core
-<!--GetVal-macro not supported by the docbook formatter, but giving it a shot anyway-->
- 6 test2 by the
- <ulink url='http://fedoraproject.org/wiki/DocsProject/ReleaseNotes/Beats'>beat
+<section id="sn-PackageChanges">
+ <title>Package Changes</title>
+
+ <para>
+ This section has not been updated for Fedora Core <!--GetVal-macro not
+ supported by the docbook formatter, but giving it a shot anyway--> 6 test2
+ by the <ulink
+ url='http://fedoraproject.org/wiki/DocsProject/ReleaseNotes/Beats'>beat
writer</ulink>.
- </para>
-
- <itemizedlist>
- <listitem override='none'>
- <informaltable>
- <tgroup cols='1'>
- <colspec colname='col_0'/>
- <tbody>
- <row>
-<entry colsep='1' rowsep='1'><para> <inlinemediaobject><imageobject><imagedata width='16' fileref='http://docbook.wikiwikiweb.de/wiki/modern/img/icon-info.png' depth='16'/></imageobject><textobject><phrase>{i}</phrase></textobject></inlinemediaobject> <emphasis role='strong'>This list is automatically generated</emphasis> </para></entry>
- </row>
- <row>
-<entry colsep='1' rowsep='1'><para> This list is automatically generated. It is not a good choice for translation. </para></entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </listitem>
- </itemizedlist>
-<screen><![CDATA[This list was made using the {{{treediff}}} utility, ran as {{{treediff newtree oldtree}}} against the rawhide tree of 28 Feb. 2006.
-]]></screen>
+ </para>
+ <note>
+ <title>This list is automatically generated</title>
<para>
- For a list of which packages were updated since the previous
- release, refer to this page:
+ This list is automatically generated. It is not a good choice for
+ translation.
</para>
+ </note>
+ <para>
+ This list was made using the <command>treediff</command> utility, ran as
+ <command>treediff newtree oldtree</command> against the rawhide tree of 28
+ Feb. 2006.
+ </para>
+ <para>
+ For a list of which packages were updated since the previous release, refer
+ to this page:
+ </para>
- <para>
- <ulink url='http://fedoraproject.org/wiki/Docs/Beats/PackageChanges/UpdatedPackages'>http://fedoraproject.org/wiki/Docs/Beats/PackageChanges/UpdatedPackages</ulink>
- </para>
+ <para>
+ <ulink
+ url='http://fedoraproject.org/wiki/Docs/Beats/PackageChanges/UpdatedPackages'>http://fedoraproject.org/wiki/Docs/Beats/PackageChanges/UpdatedPackages</ulink>
+ </para>
- <para>
- You can also find a comparison of major packages between all
- Fedora versions at
- <ulink url='http://distrowatch.com/fedora'>http://distrowatch.com/fedora</ulink>
- </para>
-<screen><![CDATA[Insert treediff list here.
-]]></screen>
- </section>
+ <para>
+ You can also find a comparison of major packages between all Fedora versions
+ at <ulink
+ url='http://distrowatch.com/fedora'>http://distrowatch.com/fedora</ulink>
+ </para>
+ <screen><![CDATA[Insert treediff list here. ]]></screen>
+</section>
More information about the Fedora-docs-commits
mailing list