release-notes/FC4 Makefile, NONE, 1.1 README-en.xml, NONE, 1.1 RELEASE-NOTES-en.xml, NONE, 1.1 README-master-en.xml, 1.1, NONE RELEASE-NOTES-master-en.xml, 1.2, NONE
Tommy Reynolds (jtr)
fedora-docs-commits at redhat.com
Thu May 26 20:33:12 UTC 2005
Author: jtr
Update of /cvs/docs/release-notes/FC4
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv27316
Added Files:
Makefile README-en.xml RELEASE-NOTES-en.xml
Removed Files:
README-master-en.xml RELEASE-NOTES-master-en.xml
Log Message:
Added basic Makefile maintenance script. To make this a bit easier,
I renamed the "master" files to more closely match their PDF and HTML
document names. (Practique: if you forget which document is the base
file, just grep for "DOCTYPE".)
--- NEW FILE Makefile ---
LANG = en
XSLPDF = ../../xsl/main-pdf.xsl
XSLHTML = ../../xsl/main-html.xsl
.SUFFIXES:
.SUFFIXES: .html .pdf .xml
%.pdf: %.xml
xmlto pdf -x ${XSLPDF} $<
%.html: %.xml
${RM} -r $@ ${@:.html=}
xmlto html -x ${XSLHTML} -o ${@:.html=} $<
mkdir -p ${@:.html=}/stylesheet-images
cp ../../stylesheet-images/*.png ${@:.html=}/stylesheet-images
cp ../../css/fedora.css ${@:.html=}
ln -s ${@:.html=}/index.html $@
all: README-${LANG}.pdf README-${LANG}.html RELEASE-NOTES-${LANG}.pdf \
RELEASE-NOTES-${LANG}.html eula.txt
# FIXME eula.txt: eula.py
# FIXME python -c "import py_compile; py_compile.compile('eula.py')"
# Note: keep "RELEASE-NOTES-en.xml" first, for now.
RNFILES=RELEASE-NOTES-en.xml daemons.xml database-servers.xml \
desktop.xml development-tools.xml feedback.xml file-servers.xml \
file-systems.xml hardware-reqs.xml install-notes.xml intro.xml \
java.xml kernel.xml misc-server.xml multimedia.xml \
networking.xml overview.xml package-movement.xml \
package-notes.xml printing.xml project-overview.xml samba.xml \
security.xml server-tools.xml web-servers.xml xorg.xml
# README-${LANG}.pdf: README-en.xml
# README-${LANG}.html: README-en.xml
RELEASE-NOTES-${LANG}.pdf: ${RNFILES}
RELEASE-NOTES-${LANG}.html: ${RNFILES}
clean:
distclean clobber: clean
${RM} -r README-${LANG}.pdf README-${LANG}.html README-${LANG}
${RM} -r RELEASE-NOTES-${LANG}.pdf RELEASE-NOTES-${LANG}.html \
RELEASE-NOTES-${LANG}
--- NEW FILE README-en.xml ---
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY % ALPHA "IGNORE">
<!ENTITY % X86 "INCLUDE">
<!ENTITY % IA64 "IGNORE">
<!ENTITY % S390 "IGNORE">
<!ENTITY % HA "IGNORE">
<!ENTITY % X86-64 "IGNORE">
<!ENTITY RH "Red Hat"> <!-- The generic term "Red Hat" -->
<!ENTITY RHL "&RH; Linux"> <!-- The generic term "Red Hat Linux" -->
<!ENTITY FORMAL-RHI "&RH;, Inc."> <!-- Formal version -->
<!ENTITY NAME "Fedora"> <!-- The project's (and software's) basic name -->
<!ENTITY PROJ "&NAME; Project"> <!-- The project's name -->
<!ENTITY DISTRO "&NAME; Core"> <!-- The software's name -->
<!ENTITY DISTROVER "@VERSION@"> <!-- The software's version -->
]>
<article id="index" lang="en" arch="x86;x86_64" os="test;final">
<articleinfo>
<title>&DISTRO; &DISTROVER; README</title>
<copyright>
<year>2004</year>
<holder>&FORMAL-RHI;</holder>
</copyright>
<legalnotice id="legalnotice">
<para>The contents of this CD-ROM are Copyright © 2004 &PROJ; and
others. Refer to the End User License Agreement and individual
copyright notices in each source package for distribution terms.</para>
<para>&NAME;, &RH;, &RH; Network, the &RH; "Shadow Man" logo, RPM, Maximum
RPM, the RPM logo, Linux Library, PowerTools, Linux Undercover,
RHmember, RHmember More, Rough Cuts, Rawhide and all &RH;-based
trademarks and logos are trademarks or registered trademarks of
&FORMAL-RHI; in the United States and other countries.</para>
<para>Linux is a registered trademark of Linus Torvalds.</para>
<para>Motif and UNIX are registered trademarks of The Open Group.</para>
<para>Intel and Pentium are registered trademarks of Intel
Corporation. Itanium and Celeron are trademarks of Intel
Corporation.</para>
<para>AMD, AMD Athlon, AMD Duron, and AMD K6 are trademarks of Advanced
Micro Devices, Inc.</para>
<para>Windows is a registered trademark of Microsoft Corporation.</para>
<para>SSH and Secure Shell are trademarks of SSH Communications Security,
Inc.</para>
<para>FireWire is a trademark of Apple Computer Corporation.</para>
<para>All other trademarks and copyrights referred to are the property of
their respective owners.</para>
<para>The GPG fingerprint of the <computeroutput>"Fedora Project
<fedora at redhat.com>"</computeroutput> key is:</para>
<para>CA B4 4B 99 6F 27 74 4E 86 12 7C DF B4 42 69 D0 4F 2A 6F D2</para>
</legalnotice>
</articleinfo>
<sect1 id="dir-org">
<title>DIRECTORY ORGANIZATION</title>
<para>&DISTRO; is delivered on multiple CD-ROMs consisting of installation
CD-ROMs and source code CD-ROMs.</para>
<para>The first installation CD-ROM can be directly booted into the
installation on most modern systems, and contains the following directory
structure (where <filename>/mnt/cdrom</filename> is the mount point of the
CD-ROM):</para>
<screen arch="x86">
<remark os="test">(x86)</remark>
<computeroutput>
/mnt/cdrom
|----> Fedora
| |----> RPMS -- binary packages
| `----> base -- information on this release of Fedora
| Core used by the installation process
|----> images -- boot and driver disk images
|----> isolinux -- files necessary to boot from CD-ROM
|----> README -- this file
|----> RELEASE-NOTES -- the latest information about this release
| of Fedora Core
`----> RPM-GPG-KEY -- GPG signature for packages from Red Hat
</computeroutput>
</screen>
<screen arch="x86_64">
<remark os="test">(x86_64)</remark>
<computeroutput>
/mnt/cdrom
|----> Fedora
| |----> RPMS -- binary packages
| `----> base -- information on this release of Fedora
| Core used by the installation process
|----> images -- boot disk ISO image
|----> isolinux -- files necessary to boot from CD-ROM
|----> README -- this file
|----> RELEASE-NOTES -- the latest information about this release
| of Fedora Core
`----> RPM-GPG-KEY -- GPG signature for packages from Red Hat
</computeroutput>
</screen>
<para>The remaining Installation CD-ROMs are similar to Installation CD-ROM
1, except that only the <filename>Fedora</filename> subdirectory is
present.</para>
<para>The directory layout of each source code CD-ROM is as follows:</para>
<screen>
<computeroutput>
/mnt/cdrom
|----> SRPMS -- source packages
`----> RPM-GPG-KEY -- GPG signature for packages from Red Hat
</computeroutput>
</screen>
<para>If you are setting up an installation tree for NFS, FTP, or HTTP
installations, you need to copy the <filename>RELEASE-NOTES</filename>
files and all files from the <filename>Fedora</filename> directory on
discs 1-3. On Linux and Unix systems, the following process will properly
configure the /target/directory on your server (repeat for each disc):</para>
<orderedlist>
<listitem>
<para>Insert disc</para>
</listitem>
<listitem>
<para><command>mount /mnt/cdrom</command></para>
</listitem>
<listitem>
<para><command>cp -a /mnt/cdrom/Fedora
/target/directory</command></para>
</listitem>
<listitem>
<para><command>cp /mnt/cdrom/RELEASE-NOTES* /target/directory</command>
(Do this only for disc 1)</para>
</listitem>
<listitem>
<para><command>umount /mnt/cdrom</command></para>
</listitem>
</orderedlist>
</sect1>
<sect1 id="installing">
<title>INSTALLING</title>
<para>Many computers can now automatically boot from CD-ROMs. If you have
such a machine (and it is properly configured) you can boot the &DISTRO;
CD-ROM directly. After booting, the &DISTRO; installation program will
start, and you will be able to install your system from the CD-ROM.</para>
<para arch="x86;x86_64"><remark os="test">(x86;x86_64)</remark> The
<filename>images/</filename> directory contains the file
<filename>boot.iso</filename>. This file is an ISO image that can be used
to boot the &DISTRO; installation program. It is a handy way to start
network-based installations without having to use multiple diskettes. To
use <filename>boot.iso</filename>, your computer must be able to boot from
its CD-ROM drive, and its BIOS settings must be configured to do so. You
must then burn <filename>boot.iso</filename> onto a recordable/rewriteable
CD-ROM.</para>
<para arch="x86;x86_64"><remark os="test">(x86;x86_64)</remark> Another image
file contained in the <filename>images/</filename> directory is
<filename>diskboot.img</filename>. This file is designed for use with USB
pen drives (or other bootable media with a capacity larger than a diskette
drive). Use the <command>dd</command> command to write the image.</para>
<note arch="x86;x86_64">
<title>Note</title>
<remark os="test">(x86;x86_64)</remark>
<para>The ability to use this image file with a USB pen drive depends on
the ability of your system's BIOS to boot from a USB device.</para>
</note>
</sect1>
<sect1 id="get-help">
<title>GETTING HELP</title>
<para>For those that have web access, see <ulink
url="http://fedora.redhat.com">http://fedora.redhat.com</ulink>. In
particular, access to &PROJ; mailing lists can be found at:</para>
<para><ulink
url="https://listman.redhat.com/mailman/listinfo/">https://listman.redhat.com/mailman/listinfo/</ulink></para>
</sect1>
<sect1 id="export-ctl">
<title>EXPORT CONTROL</title>
<para>The communication or transfer of any information received with this
product may be subject to specific government export approval. User shall
adhere to all applicable laws, regulations and rules relating to the
export or re-export of technical data or products to any proscribed
country listed in such applicable laws, regulations and rules unless
properly authorized. The obligations under this paragraph shall survive
in perpetuity.</para>
</sect1>
<sect1 id="s1-test" os="test">
<title>README Feedback Procedure</title>
<para>(This section will disappear when the final &DISTRO; release is
created.)</para>
<para>If you feel that this README could be improved in some way, submit a
bug report in &RH;'s bug reporting system:</para>
<para><ulink
url="https://bugzilla.redhat.com/bugzilla/easy_enter_bug.cgi">https://bugzilla.redhat.com/bugzilla/easy_enter_bug.cgi</ulink></para>
<para>When posting your bug, include the following information in the
specified fields:</para>
<itemizedlist>
<listitem>
<para><guilabel>Product:</guilabel> &DISTRO;</para>
</listitem>
<listitem>
<para><guilabel>Version:</guilabel> Not really important (I'm using
"devel")</para>
</listitem>
<listitem>
<para><guilabel>Component:</guilabel> fedora-release</para>
</listitem>
<listitem>
<para><guilabel>Summary:</guilabel> A short description of what could be
improved. If it includes the word "README", so much the
better.</para>
</listitem>
<listitem>
<para><guilabel>Description:</guilabel> A more in-depth description of
what could be improved.</para>
</listitem>
<listitem>
<para><guilabel>Blocks:</guilabel> 114406 (The README blocker bug
number)</para>
</listitem>
</itemizedlist>
<para>A quick way of seeing what sorts of bugs have been posted against the
README is to look at the bugs listed in the <guilabel>Bug 114406 depends
on:</guilabel> field of the &DISTRO; release notes blocker bug:</para>
<para><ulink
url="https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=114406">https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=114406</ulink></para>
<para>If you are interested in following the discussion of any of these
bugs, feel free to add yourself to the bug's CC list. That way, you'll
get email whenever there are any changes to the bug.</para>
<para>As bugs are posted for the various parts of the README file,
subsequent test versions of these release notes will contain links similar
to this one:</para>
<remark os="test">%%% <ulink
url="https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=114408">https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=114408</ulink>
%%%</remark>
<para>These links point to Bugzilla entries for the information preceding
the link. This makes it easier for people to contribute — just
point your browser at the link, add your comments to the bug, and commit
your changes.</para>
</sect1>
<ackno>(
<emphasis arch="x86">x86</emphasis>
<emphasis arch="x86_64">x86_64</emphasis>
)</ackno>
</article>
--- NEW FILE RELEASE-NOTES-en.xml ---
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"/usr/share/sgml/docbook/xml-dtd-4.3-1.0-25/docbookx.dtd" [
<!-- *************** Section files *************** -->
<!ENTITY FEEDBACK SYSTEM "./feedback.xml">
<!ENTITY HARDWARE-REQS SYSTEM "./hardware-reqs.xml">
<!ENTITY INSTALL-NOTES SYSTEM "./install-notes.xml">
<!ENTITY INTRO SYSTEM "./intro.xml">
<!ENTITY OVERVIEW SYSTEM "./overview.xml">
<!ENTITY PACKAGE-MOVEMENT SYSTEM "./package-movement.xml">
<!ENTITY PACKAGE-NOTES SYSTEM "./package-notes.xml">
<!ENTITY PROJECT-OVERVIEW SYSTEM "./project-overview.xml">
<!ENTITY KERNEL SYSTEM "./kernel.xml">
<!ENTITY SAMBA SYSTEM "./samba.xml">
<!ENTITY PRINTING SYSTEM "./printing.xml">
<!ENTITY SERVER-TOOLS SYSTEM "./server-tools.xml">
<!ENTITY DEVELOPMENT-TOOLS SYSTEM "./development-tools.xml">
<!ENTITY SECURITY SYSTEM "./security.xml">
<!ENTITY FILE-SYSTEMS SYSTEM "./file-systems.xml">
<!ENTITY FILE-SERVERS SYSTEM "./file-servers.xml">
<!ENTITY DATABASE-SERVERS SYSTEM "./database-servers.xml">
<!ENTITY WEB-SERVERS SYSTEM "./web-servers.xml">
<!ENTITY DAEMONS SYSTEM "./daemons.xml">
<!ENTITY MULTIMEDIA SYSTEM "./multimedia.xml">
<!ENTITY MISC-SERVER SYSTEM "./misc-server.xml">
<!ENTITY JAVA SYSTEM "./java.xml">
<!ENTITY NETWORKING SYSTEM "./networking.xml">
<!ENTITY XORG SYSTEM "./xorg.xml">
<!-- *************** COMMON FDP entities *************** -->
<!ENTITY % FEDORA-ENTITIES-EN SYSTEM "../../common/fedora-entities-en.xml">
%FEDORA-ENTITIES-EN;
<!ENTITY LEGALNOTICE SYSTEM "../../common/legalnotice-en.xml">
<!-- *************** Local entities *************** -->
<!ENTITY BOOKID "RELEASE-NOTES-&FCX;&DISTROVER; (2005-05-22-T16:20-0800)"> <!-- version of manual and date -->
<!ENTITY LOCALVER "4"> <!-- Set value to your choice, when guide version is out -->
<!-- of sync with FC release, use instead of FEDVER or FEDTESTVER -->
<!ENTITY BUG-URL "http://tinyurl.com/">
<!ENTITY NAME "Fedora"> <!-- The project's (and software's) basic name -->
<!ENTITY PROJ "&FP;"> <!-- The project's name -->
<!ENTITY DISTRO "&FC;"> <!-- The software's name -->
<!ENTITY DISTROVER "@VERSION@"> <!-- The software's version -->
]>
<article id="index" lang="en" arch="x86;x86_64" os="test;final">
<articleinfo>
<title>&DISTRO; &DISTROVER; Release Notes</title>
<copyright>
<year>2005</year>
<holder>&FORMAL-RHI;</holder>
</copyright>
&LEGALNOTICE;
</articleinfo>
&FEEDBACK;
&INTRO;
&HARDWARE-REQS;
&OVERVIEW;
&INSTALL-NOTES;
&PACKAGE-NOTES;
&PACKAGE-MOVEMENT;
&PROJECT-OVERVIEW;
<ackno>(
<emphasis arch="x86">x86</emphasis>
<emphasis arch="x86_64">x86_64</emphasis>
)</ackno>
</article>
--- README-master-en.xml DELETED ---
--- RELEASE-NOTES-master-en.xml DELETED ---
More information about the Fedora-docs-commits
mailing list