Author: kwade
Update of /cvs/docs/release-notes/devel/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv25618
Modified Files:
Devel.xml Entertainment.xml
Log Message:
XML fixes to match test3 usage.
Index: Devel.xml
===================================================================
RCS file: /cvs/docs/release-notes/devel/en_US/Devel.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- Devel.xml 25 Sep 2006 07:00:27 -0000 1.2
+++ Devel.xml 26 Sep 2006 09:46:35 -0000 1.3
@@ -14,7 +14,7 @@
<section>
<title>Runtime</title>
<para>
- These are the new features in <code>glibc</code>:
+ These are the new features in <package>glibc</package>:
</para>
<itemizedlist>
<listitem>
@@ -46,8 +46,8 @@
<listitem>
<para>
The destination address sorting performed by the
- <code>getaddrinfo()</code> interface for hostname lookup can
- now be customized by rules in the <code>/etc/gai.conf</code>
+ <interface>getaddrinfo()</interface> interface for hostname lookup can
+ now be customized by rules in the <filename>/etc/gai.conf</filename>
file.
</para>
</listitem>
@@ -73,7 +73,7 @@
<title>Tools</title>
<para>
The linker includes support for the new ELF symbol hash table
- format. Use the <code>--hash-style</code> option of the linker
+ format. Use the <option>--hash-style</option> option of the linker
to select the format(s).
</para>
<section>
@@ -81,10 +81,10 @@
<para>
This release of Fedora has been built using Linux kernel
headers exported directly from the kernel, using the new
- <code>headers_install</code> feature of the 2.6.18 kernel.
- Thus, the <code>glibc-kernheaders</code> package has been
- removed and replaced with <code>kernel-headers</code>, a
- subpackage of <code>kernel</code>.
+ <option>headers_install</option> feature of the 2.6.18 kernel.
+ Thus, the <package>glibc-kernheaders</package> package has been
+ removed and replaced with <package>kernel-headers</package>, a
+ subpackage of <package>kernel</package>.
</para>
<para>
Developers may notice some changes between these new kernel
@@ -94,30 +94,31 @@
<itemizedlist>
<listitem>
<para>
- The <code><linux/compiler.h></code> header file has
+ The <filename><linux/compiler.h></filename> header file has
been removed, since it contains nothing of use to
userspace.
</para>
</listitem>
<listitem>
<para>
- The <code>_syscallX()</code> macros are removed. Userspace
- should use <code>syscall()</code> from the C library
+ The <systemitem class="macro">_syscallX()</systemitem> macros
are removed. Userspace
+ should use <systemitem class="macro">syscall()</systemitem>
from the C library
instead.
</para>
</listitem>
<listitem>
<para>
- The <code>PAGE_SIZE</code> macro is removed from some
- architectures, since the page size is variable. Userspace
- should be using <code>sysconf(_SC_PAGE_SIZE)</code> or
- <code>getpagesize()</code> instead.
+ The <systemitem class="macro">PAGE_SIZE</systemitem> macro is
+ removed from some architectures, since the page size is variable.
+ Userspace should be using <systemitem
+ class="macro">sysconf(_SC_PAGE_SIZE)</systemitem> or
<systemitem
+ class="macro">getpagesize()</systemitem> instead.
</para>
</listitem>
<listitem>
<para>
- The <code><asm/atomic.h></code> and
- <code><asm/bitops.h></code> header files have been
+ The <filename><asm/atomic.h></filename> and
+ <filename><asm/bitops.h></filename> header files have been
removed. These were not designed for use in userspace, and
would fail to compile on some architectures while silently
giving non-atomic behaviour on others. The C compiler
@@ -131,7 +132,7 @@
<para>
Content that was previously protected with <code>#ifdef
__KERNEL__</code> is now elided completely with the
- <code>unifdef</code> tool. Defining
+ <command>unifdef</command> tool. Defining
<code>__KERNEL___</code> in order to see parts that
should not be visible to userspace is no longer effective.
</para>
@@ -169,28 +170,28 @@
<code>.hash</code> section that provides symbols for dynamic
linking. This new <code>.gnu.hash</code> section, which is
produced with the new default
- <code>--hash-style=gnu</code> option for
- <code>gcc</code>, serves the same purpose as
+ <option>--hash-style=gnu</option> option for
+ <command>gcc</command>, serves the same purpose as
previous hash sections. It provides, however, an
approximately 50% increase in dynamic linking speed.
Binaries and libraries produced with the new hashing
function are incompatible with older
- <code>glibc</code> and dynamic linker releases. To
+ <systemitem class="library">glibc</systemitem> and dynamic
linker releases. To
use the old-style hashing routines for compatibility
- with older <code>glibc</code>-based systems, pass
- the <code>--hash-style=sysv</code> option instead.
+ with older <systemitem
class="library">glibc</systemitem>-based systems, pass
+ the <option>--hash-style=sysv</option> option instead.
</para>
</listitem>
<listitem>
<para>
You need GDB 6.1 or newer to debug binaries, unless
they are compiled using the
- <code>-fno-var-tracking</code> compilation option.
+ <option>-fno-var-tracking</option> compilation option.
</para>
</listitem>
<listitem>
<para>
- The <code>-fwritable-strings</code> option is no
+ The <option>-fwritable-strings</option> option is no
longer accepted.
</para>
</listitem>
@@ -198,16 +199,16 @@
<para>
English-language diagnostic messages now use Unicode
quotes. If you cannot read this, set your
- <code>LC_CTYPE</code> environment variable to
- <code>C</code> or change your terminal emulator.
+ <envar>LC_CTYPE</envar> environment variable to
+ <systemitem class="constant">C</systemitem> or change your
terminal emulator.
</para>
</listitem>
<listitem>
<para>
- The <code>specs</code> file is no longer installed
+ The <filename>specs</filename> file is no longer installed
on most systems. Ordinary users will not notice, but
developers who need to alter the file can use the
- <code>-dumpspecs</code> option to generate the file
+ <option>-dumpspecs</option> option to generate the file
for editing.
</para>
</listitem>
@@ -242,23 +243,23 @@
<para>
The new sentinel attribute causes the compiler to
issue a warning if a function such as
- <code>execl(char *path, const char *arg,
- ...)</code>, which requires a NULL list terminator,
+ <function>execl(char *path, const char *arg,
+ ...)</function>, which requires a NULL list terminator,
is missing the NULL.
</para>
</listitem>
<listitem>
<para>
- The <code>cast-as-lvalue</code>,
- <code>conditional-expression-as-lvalue</code>, and
- <code>compund-expression-as-lvalue</code> extensions
+ The <systemitem>cast-as-lvalue</systemitem>,
+ <systemitem>conditional-expression-as-lvalue</systemitem>, and
+ <systemitem>compund-expression-as-lvalue</systemitem> extensions
have been removed.
</para>
</listitem>
<listitem>
<para>
- The <code>#pragma pack()</code> semantics are now
- closer to those used by other compilers.
+ The <systemitem class="macro">#pragma pack()</systemitem>
+ semantics are now closer to those used by other compilers.
</para>
</listitem>
<listitem>
@@ -277,8 +278,8 @@
<listitem>
<para>
The basic compiler, without any optimization
- (<code>-O0</code>), has been measured as much as 25%
- faster in real-world code.
+ (<option>-O0</option>), has been measured as much as 25% faster in
+ real-world code.
</para>
</listitem>
<listitem>
@@ -286,7 +287,7 @@
Libraries may now contain function-scope static
variables in multi-threaded programs. Embedded
developers can use the
- <code>-fno-threadsafe-statics</code> to turn off
+ <option>-fno-threadsafe-statics</option> to turn off
this feature, but ordinary users should never do
this.
</para>
@@ -304,40 +305,40 @@
<ulink
url='http://fedora-test.fedoraproject.org/fedora-docs/fedora-docs/Pac...
packaging guidelines</ulink>. Changes were also made to some of
the entries in <code>Config::CONFIG</code> in the
- <code>rbconfig</code> module. The most important changes include:
+ <filename>rbconfig</filename> module. The most important changes
include:
</para>
<itemizedlist>
<listitem>
<para>
- <code>sitedir</code> and related directories
- (<code>sitelibdir</code>, <code>sitearchdir</code>) are
now
- under <code>rubylibdir</code>. Instead of
- <code>/usr/lib/site_ruby</code> they are underneath
- <code>/usr/lib/ruby/site_ruby</code>.
+ <filename>sitedir</filename> and related directories
+ (<filename>sitelibdir</filename>,
<filename>sitearchdir</filename>) are now
+ under <filename>rubylibdir</filename>. Instead of
+ <filename>/usr/lib/site_ruby</filename> they are underneath
+ <filename>/usr/lib/ruby/site_ruby</filename>.
</para>
</listitem>
<listitem>
<para>
The directories for architecture-independent pure Ruby code
- are always under <code>/usr/lib</code>, even on x86_64
+ are always under <filename>/usr/lib</filename>, even on x86_64
architecture, where they used to be under
- <code>/usr/lib64</code>. This change affects the
- <code>Config::CONFIG</code> entries
<code>rubylibdir</code>
- and <code>sitelibdir</code>.
+ <filename>/usr/lib64</filename>. This change affects the
+ <code>Config::CONFIG</code> entries
<filename>rubylibdir</filename>
+ and <filename>sitelibdir</filename>.
</para>
</listitem>
</itemizedlist>
<para>
- Directories that were previously in <code>$:</code> remain there
- for the time being, so that existing code, such as
- <code>/usr/lib/site_ruby</code>, does not need to be modified.
- These directories are deprecated though, and will be removed by
- the release of Fedora Core 8. Build Ruby RPM packages in
- accordance with
- <ulink
url='http://fedora-test.fedoraproject.org/fedora-docs/fedora-docs/Pac...
- packaging guidelines</ulink>. In particular, Ruby libraries should
- only be installed into <code>sitelibdir</code> and
- <code>sitearchdir</code>. You should also follow this rule for
+ Directories that were previously in <code>$:</code> remain there for
the
+ time being, so that existing code, such as
+ <filename>/usr/lib/site_ruby</filename>, does not need to be modified.
+ These directories are deprecated though, and will be removed by the
+ release of Fedora Core 8. Build Ruby RPM packages in accordance with
+ <ulink
+
url='http://fedora-test.fedoraproject.org/fedora-docs/fedora-docs/Pac...
+ packaging guidelines</ulink>. In particular, Ruby libraries should only
+ be installed into <filename>sitelibdir</filename> and
+ <filename>sitearchdir</filename>. You should also follow this rule for
Ruby code that is not packaged as an RPM.
</para>
</section>
Index: Entertainment.xml
===================================================================
RCS file: /cvs/docs/release-notes/devel/en_US/Entertainment.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- Entertainment.xml 24 Sep 2006 20:41:49 -0000 1.7
+++ Entertainment.xml 26 Sep 2006 09:46:35 -0000 1.8
@@ -10,8 +10,8 @@
<para>
Fedora Core and Fedora Extras provide a selection of games that
cover a variety of genres. By default, Fedora Core includes a small
- package of games for GNOME (called <code>gnome-games</code>) and KDE
- (<code>kdegames</code>). Fedora Extras provides additional games
+ package of games for GNOME (called <package>gnome-games</package>) and
KDE
+ (<package>kdegames</package>). Fedora Extras provides additional games
that span every major genre.
</para>