yum-software-management yum-software-management-en.xml,1.1.1.1,1.2
by fedora-docs-commits@redhat.com
Author: elliss
Update of /cvs/docs/yum-software-management
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv31795
Modified Files:
yum-software-management-en.xml
Log Message:
- Added explanation of the example package to the introduction
- Added using package attributes to the Search section
- Reworked section on using Proxy Servers
- Minor style edits
- Bumped version to 0.4.2
Index: yum-software-management-en.xml
===================================================================
RCS file: /cvs/docs/yum-software-management/yum-software-management-en.xml,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -u -r1.1.1.1 -r1.2
--- yum-software-management-en.xml 1 Jun 2005 21:31:25 -0000 1.1.1.1
+++ yum-software-management-en.xml 12 Jun 2005 10:48:11 -0000 1.2
@@ -4,7 +4,7 @@
<!ENTITY % FEDORA-ENTITIES-EN SYSTEM "../common/fedora-entities-en.ent">
%FEDORA-ENTITIES-EN;
-<!ENTITY BOOKID "yum-software-management-0.4 (2005-06-01)"> <!-- change version of manual and date here -->
+<!ENTITY BOOKID "yum-software-management-0.4.2 (2005-06-12)"> <!-- change version of manual and date here -->
<!ENTITY LEGALNOTICE SYSTEM "../common/legalnotice-en.xml">
@@ -39,7 +39,7 @@
Initial import into CVS.
</para>
</revdescription>
- </revision>
+ </revision>
</revhistory>
</articleinfo>
@@ -79,6 +79,15 @@
updates. The details of maintaining your own repositories are explained
in <xref linkend="sn-managing-repositories"></xref>.
</para>
+ <para>
+ Most of the examples use the package <filename>tsclient</filename>,
+ which is included with &FC; to provide an application for remote desktop
+ access. If it is installed successfully you may start the application
+ by choosing
+ <menuchoice><guimenu>Applications</guimenu><guisubmenu>Internet</guisubmenu><guimenuitem>Terminal
+ Server Client</guimenuitem></menuchoice>. To use the examples,
+ substitute the name of the relevant package for <filename>tsclient</filename>.
+ </para>
<important>
<title>Avoid Logging in with the Root Account</title>
<para>
@@ -95,18 +104,19 @@
<section id="sn-yum-additional-resources">
<title>Additional Resources</title>
<indexterm>
- <primary>Yum, documentation</primary>
+ <primary>yum, documentation</primary>
</indexterm>
<indexterm>
- <primary>Yum, man pages</primary>
+ <primary>yum, man pages</primary>
</indexterm>
<para>
The <command>yum</command> utility has features and options that
- are not discussed in this document. You can learn more by reading the
- <command>man</command> pages for <command>yum(8)</command> and <filename>yum.conf(5)</filename>.
+ are not discussed in this document. Read the <command>man</command> pages
+ for <command>yum(8)</command> and <filename>yum.conf(5)</filename> to
+ learn more.
</para>
<indexterm>
- <primary>Yum, Websites</primary>
+ <primary>yum, Websites</primary>
</indexterm>
<para>
The official Website for <command>yum</command> is:
@@ -240,8 +250,9 @@
</indexterm>
<para>
Each package file has a long name that indicates several key pieces of
- information. <command>Yum</command> can use just the name of the
- software, or you can specify other items as well.
+ information. The <command>yum</command> utility may use just the name
+ of the package itself, but you may also use other attributes in the file
+ name to make queries more specific.
</para>
<para>
For example, this is the full name of a package supplied with &FC;:
@@ -255,7 +266,8 @@
<filename>tsclient-0.132</filename>. Add the hardware architecture to
the short name and use <filename>tsclient.i386</filename> to specify
packages for your type of computer. The package listings provided by
- <command>yum</command> itself use the format <filename>name.architecture</filename>.
+ <command>yum</command> itself use the format
+ <filename>name.architecture</filename>.
</para>
<tip>
<title>Specifying Packages</title>
@@ -396,15 +408,14 @@
<section id="sn-updating-your-system">
<title>Updating Your System with <command>yum</command></title>
<indexterm>
- <primary>system updating</primary>
+ <primary>updating, full system</primary>
</indexterm>
<indexterm>
- <primary>yum, updating system</primary>
+ <primary>yum, updating full system</primary>
</indexterm>
<para>
- Like <application>up2date</application>, <command>yum</command> can
- update all of the software that makes up your &FC; system in a single
- operation. This is done by the <option>update</option> function.
+ You may update all of the software that makes up your &FC; system in a single
+ operation. This is done with the <option>update</option> function.
</para>
<para>
To carry out a full system update, type this command in a terminal window:
@@ -493,6 +504,20 @@
<screen>
<userinput>yum list <replaceable>tsclient</replaceable></userinput>
</screen>
+<para>
+ To make your queries more specific, add other package attributes. For example,
+ to search for version 0.132 of the application the command would be:
+ </para>
+<screen>
+<userinput>yum list <replaceable>tsclient-0.132</replaceable></userinput>
+</screen>
+ <note>
+ <title>Package Attributes</title>
+ <para>
+ See <xref linkend="sn-package-names"></xref> for information on
+ package attributes.
+ </para>
+ </note>
<para>
If you do not know the name of the package, use either the
<option>search</option> or <option>provides</option> options.
@@ -634,8 +659,7 @@
the package that you specified.
</para>
<para>
- To install the package <filename>tsclient</filename> you should enter
- the command:
+ To install the package <filename>tsclient</filename>, enter the command:
</para>
<screen>
<userinput>su -c 'yum install <replaceable>tsclient</replaceable>'</userinput>
@@ -1106,8 +1130,8 @@
<para>
The <command>createrepo</command> utility makes no changes to the
directory other than adding a <filename>repo-data/</filename>
- sub-directory. Other utilities may also add their own index
- files to the directory.
+ sub-directory. Adding index files for other utilities does not
+ interfere with <command>yum</command>.
</para>
</tip>
</section>
@@ -1140,49 +1164,86 @@
<primary>yum, using a proxy server</primary>
</indexterm>
<para>
- If your system is connected to the Internet through a Web proxy server,
- the server must be specified in the environment variable
- <command>http_proxy</command>. This variable must specify the proxy
- server as a complete URL, including the port number. For example:
+ Repositories may be accessed through standard proxy servers. If your
+ system is connected to the Internet through a Web proxy server, specify
+ the details of the server in <filename>/etc/yum.conf</filename>. The
+ <command>proxy</command> setting must specify the proxy server as a
+ complete URL, including the TCP port number. If your proxy server
+ requires a username and password, specify these by adding
+ <command>proxy_username</command> and <command>proxy_password</command> settings.
+ </para>
+
+ <para>
+ For example, the settings below enable <command>yum</command> to use the
+ proxy server <command>mycache.mydomain.com</command>, connecting to port
+ <command>3128</command>, with the username <command>yum-user</command> and the password <command>qwerty</command>.
</para>
-<screen>
-<userinput>http_proxy="<replaceable>http://mycache.mydomain.com:3128</replaceable>"</userinput>
-</screen>
- <para>
- The URL may include a username and password, for proxy servers that
- require them. If the server in the previous example required the
- username <command>yum-user</command> and the password
- <command>qwerty</command> the complete variable would be:
- </para>
-<screen>
-<userinput>http_proxy="<replaceable>http://yum-user:qwerty@mycache.mydomain.com:3128</replaceable>"</userinput>
-</screen>
+
+ <example id="config-file-httpproxy">
+ <title>Configuration File Settings for Using A Proxy Server</title>
+ <programlisting>
+ <![CDATA[
+ # The proxy server - proxy server:port number
+ proxy=http://mycache.mydomain.com:3128
+ # The account details for yum connections
+ proxy_username=yum-user
+ proxy_password=qwerty
+ ]]>
+ </programlisting>
+ </example>
+
+ <note>
+ <title>Global Settings</title>
+ <para>
+ Defining a proxy server in <filename>/etc/yum.conf</filename> means that
+ <emphasis>all</emphasis> users connect to the proxy server with those
+ details when using <command>yum</command>.
+ </para>
+ </note>
+
<para>
- To enable proxy access for all users, create a new file called
- <filename>proxy.sh</filename> in the directory
- <filename>/etc/profile.d/</filename>, containing these two lines:
+ To enable proxy access for a specific user, add the lines in the
+ example box below to their shell profile. For the default
+ <command>bash</command> shell, the profile is the file
+ <filename>.bash_profile</filename>. The settings below enable <command>yum</command> to
+ use the proxy server <command>mycache.mydomain.com</command>, connecting to port <command>3128</command>.
</para>
<example id="profile-script-httpproxy">
- <title>Profile Script for Setting the Proxy Server</title>
+ <title>Profile Settings for Using A Proxy Server</title>
<programlisting>
<![CDATA[
+ # The Web proxy server used by this account
http_proxy="http://mycache.mydomain.com:3128"
export http_proxy
]]>
</programlisting>
</example>
- <para>
- This means that any user that logs in automatically has the environment variable set for them.
- </para>
+
+ <para>
+ If the proxy server requires a username and password then add these to the
+ URL. For example, to include the username
+ <command>yum-user</command> and the password <command>qwerty</command>:
+ </para>
+ <example id="profile-script-httpproxy-withpassword">
+ <title>Profile Settings for A Secured Proxy Server</title>
+ <programlisting>
+ <![CDATA[
+ # The Web proxy server, with the username and password for this account
+ http_proxy="http://yum-user:qwerty@mycache.mydomain.com:3128"
+ export http_proxy
+ ]]>
+ </programlisting>
+ </example>
<note>
- <title>http_proxy Variable with Other Utilities</title>
+ <title><command>http_proxy</command> Variable with Other Utilities</title>
<para>
The <command>http_proxy</command> variable is also used by <command>curl</command> and
- other utilities. <command>Yum</command> itself can use <command>http_proxy</command> in
- either upper-case or lower-case, but <command>curl</command> requires
+ other utilities. Although <command>yum</command> itself may use <command>http_proxy</command> in
+ either upper-case or lower-case, <command>curl</command> requires
the name of the variable to be in lower-case.
</para>
</note>
+
</section>
18 years, 11 months
install-guide fedora-install-guide-intro-en.xml,1.11,1.12
by fedora-docs-commits@redhat.com
Author: kwade
Update of /cvs/docs/install-guide
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv29258
Modified Files:
fedora-install-guide-intro-en.xml
Log Message:
Figured out what the problem was and fixed it.
Index: fedora-install-guide-intro-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-intro-en.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- fedora-install-guide-intro-en.xml 10 Jun 2005 18:38:43 -0000 1.11
+++ fedora-install-guide-intro-en.xml 12 Jun 2005 08:59:53 -0000 1.12
@@ -203,10 +203,14 @@
<para>
the name of the server
</para>
+ </listitem>
+ <listitem>
<para>
the network protocol used for installation (FTP, HTTP, or
NFS)
</para>
+ </listitem>
+ <listitem>
<para>
the path to the installation files
</para>
18 years, 11 months
desktop-up2date desktop-up2date-en.xml,1.1.1.1,1.2
by fedora-docs-commits@redhat.com
Author: elliss
Update of /cvs/docs/desktop-up2date
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv3938
Modified Files:
desktop-up2date-en.xml
Log Message:
Style fix - converted &em; to colons
Index: desktop-up2date-en.xml
===================================================================
RCS file: /cvs/docs/desktop-up2date/desktop-up2date-en.xml,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -u -r1.1.1.1 -r1.2
--- desktop-up2date-en.xml 5 Jun 2005 13:19:40 -0000 1.1.1.1
+++ desktop-up2date-en.xml 11 Jun 2005 17:12:20 -0000 1.2
@@ -214,15 +214,15 @@
</para>
</listitem>
<listitem>
- <para>Blue with a check mark — Your system is up to date.
+ <para>Blue with a check mark &mdash: your system is up to date.
</para>
</listitem>
<listitem>
- <para>Green with double arrows — Currently checking for updates.
+ <para>Green with double arrows: currently checking for updates.
</para>
</listitem>
<listitem>
- <para>Red with a flashing exclamation mark — There are newer
+ <para>Red with a flashing exclamation mark: there are newer
packages available for the software installed on your system.
</para>
</listitem>
18 years, 11 months
install-guide fedora-install-guide-en.xml,1.17,1.18
by fedora-docs-commits@redhat.com
Author: kwade
Update of /cvs/docs/install-guide
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv7891
Modified Files:
fedora-install-guide-en.xml
Log Message:
Updating the revision history.
Index: fedora-install-guide-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-en.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- fedora-install-guide-en.xml 10 Jun 2005 18:38:43 -0000 1.17
+++ fedora-install-guide-en.xml 10 Jun 2005 19:06:08 -0000 1.18
@@ -104,6 +104,16 @@
</para>
</revdescription>
</revision>
+ <revision>
+ <revnumber>1.0</revnumber>
+ <date>2005-06-10</date>
+ <authorinitials>KarstenWade</authorinitials>
+ <revdescription>
+ <para>
+ Release version
+ </para>
+ </revdescription>
+ </revision>
</revhistory>
</bookinfo>
18 years, 11 months
install-guide fedora-install-guide-en.xml, 1.16, 1.17 fedora-install-guide-intro-en.xml, 1.10, 1.11
by fedora-docs-commits@redhat.com
Author: kwade
Update of /cvs/docs/install-guide
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv6730
Modified Files:
fedora-install-guide-en.xml fedora-install-guide-intro-en.xml
Log Message:
Rolling version to 1.0, removing draftnotice, preparing to kick this bird out of the nest.
Index: fedora-install-guide-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-en.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- fedora-install-guide-en.xml 9 Jun 2005 00:18:10 -0000 1.16
+++ fedora-install-guide-en.xml 10 Jun 2005 18:38:43 -0000 1.17
@@ -4,16 +4,16 @@
<!ENTITY % FEDORA-ENTITIES-EN SYSTEM "../common/fedora-entities-en.ent">
%FEDORA-ENTITIES-EN;
-<!ENTITY VERSION "1.0rc1"> <!-- version for this document -->
+<!ENTITY VERSION "1.0"> <!-- version for this document -->
-<!ENTITY BOOKID "fedora-install-guide-en-&VERSION; (2005-06-08-T16:20-0700)"> <!-- change date here and VERSION entity everytime a change is made-->
+<!ENTITY BOOKID "fedora-install-guide-en-&VERSION; (2005-06-10-T16:20-0700)"> <!-- change date here and VERSION entity everytime a change is made-->
<!ENTITY LEGALNOTICE SYSTEM "../common/legalnotice-en.xml">
<!-- Bugzilla bug number for the draft notice -->
<!ENTITY BUG-NUM "129911">
<!ENTITY FCLOCALVER "4">
-<!ENTITY DOCLOCALVER "1.0rc1">
+<!ENTITY DOCLOCALVER "1.0">
<!ENTITY DRAFTNOTICE SYSTEM "../common/draftnotice-en.xml">
@@ -40,7 +40,7 @@
<book id="book" lang="en">
<bookinfo>
- <title>&FC; &FCLOCALVER; &IG; &DOCLOCALVER;</title>
+ <title>&FC; &FCLOCALVER; &IG;</title>
<!-- Remove DOCLOCALVER for release -->
<copyright>
<year>2005</year>
Index: fedora-install-guide-intro-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-intro-en.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- fedora-install-guide-intro-en.xml 9 Jun 2005 00:18:42 -0000 1.10
+++ fedora-install-guide-intro-en.xml 10 Jun 2005 18:38:43 -0000 1.11
@@ -2,7 +2,8 @@
<preface id="ch-intro">
<title>Introduction</title>
- &DRAFTNOTICE;
+ <!-- removed until we begin working on the FC5 version
+ &DRAFTNOTICE; -->
<para>
&FC; is a complete desktop and server operating system created
18 years, 11 months
install-guide fedora-install-guide-locale-en.xml,1.5,1.6
by fedora-docs-commits@redhat.com
Author: elliss
Update of /cvs/docs/install-guide
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv13062
Modified Files:
fedora-install-guide-locale-en.xml
Log Message:
Removed duplicated text - language selection already determined prior to Keyboard screen.
Index: fedora-install-guide-locale-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-locale-en.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- fedora-install-guide-locale-en.xml 27 May 2005 22:15:15 -0000 1.5
+++ fedora-install-guide-locale-en.xml 9 Jun 2005 22:57:57 -0000 1.6
@@ -86,10 +86,7 @@
<para>
Highlight the correct layout on the list, and select
- <guibutton>Next</guibutton>. The installation process continues
- in this language. This language also becomes the default language
- for your system. The installation program provides additional
- language support at a later stage.
+ <guibutton>Next</guibutton>.
</para>
</section>
18 years, 11 months
install-guide fedora-install-guide-bootloader-en.xml,1.12,1.13
by fedora-docs-commits@redhat.com
Author: elliss
Update of /cvs/docs/install-guide
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv12961
Modified Files:
fedora-install-guide-bootloader-en.xml
Log Message:
- Upgraded admonition to "important".
- Added <application> tags.
Index: fedora-install-guide-bootloader-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-bootloader-en.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- fedora-install-guide-bootloader-en.xml 9 Jun 2005 22:22:15 -0000 1.12
+++ fedora-install-guide-bootloader-en.xml 9 Jun 2005 22:36:07 -0000 1.13
@@ -74,15 +74,15 @@
</textobject>
</mediaobject>
</figure>
- <note>
+ <important>
<title>Boot Loader Required</title>
<para>
- Your computer must have GRUB or another boot loader installed
+ Your computer must have <application>GRUB</application> or another boot loader installed
in order to start, unless you create a separate startup
disk to boot from. <!-- FIXME: Add reference to startup disk elsewhere in the
IG. - PWF. -->
</para>
- </note>
+ </important>
</section>
<section id="sn-bootloader-others">
18 years, 11 months
install-guide fedora-install-guide-bootloader-en.xml,1.11,1.12
by fedora-docs-commits@redhat.com
Author: elliss
Update of /cvs/docs/install-guide
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv12879
Modified Files:
fedora-install-guide-bootloader-en.xml
Log Message:
- Reworded admonition to (hopefully) make it clearer that user do not have to install GRUB if a boot loader is already present.
- Added titles to a couple of admonitions for consistency with the rest of the document.
Index: fedora-install-guide-bootloader-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-bootloader-en.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- fedora-install-guide-bootloader-en.xml 9 Jun 2005 00:17:57 -0000 1.11
+++ fedora-install-guide-bootloader-en.xml 9 Jun 2005 22:22:15 -0000 1.12
@@ -75,10 +75,11 @@
</mediaobject>
</figure>
<note>
+ <title>Boot Loader Required</title>
<para>
- If you do not install any boot loader, you will not be able to
- boot Linux after the installation unless you generate a startup
- disk. <!-- FIXME: Add reference to startup disk elsewhere in the
+ Your computer must have GRUB or another boot loader installed
+ in order to start, unless you create a separate startup
+ disk to boot from. <!-- FIXME: Add reference to startup disk elsewhere in the
IG. - PWF. -->
</para>
</note>
@@ -268,6 +269,7 @@
loader options.
</para>
<note>
+ <title>Kernel Parameters</title>
<para>
For a partial list of the kernel command line parameters, type
the following command in a terminal window: <userinput>man
@@ -282,6 +284,7 @@
linkend="fig-bootloader-advanced"/> appears.
</para>
<note>
+ <title>Optional Menu</title>
<para>
&FC; displays the following advanced boot options menu
<emphasis>only</emphasis> if the advanced configuration checkbox
18 years, 11 months
install-guide fedora-install-guide-nextsteps-en.xml,1.6,1.7
by fedora-docs-commits@redhat.com
Author: elliss
Update of /cvs/docs/install-guide
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv11217
Modified Files:
fedora-install-guide-nextsteps-en.xml
Log Message:
Style edit: repetition of "develop".
Index: fedora-install-guide-nextsteps-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-nextsteps-en.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- fedora-install-guide-nextsteps-en.xml 9 Jun 2005 00:18:48 -0000 1.6
+++ fedora-install-guide-nextsteps-en.xml 9 Jun 2005 21:04:39 -0000 1.7
@@ -82,7 +82,7 @@
The &FP; is driven by the individuals that contribute to it. Community
members provide support and documentation to other users, help to improve the
software included in &FC; by testing, and develop new software
- alongside the developers employed by &RH;. The results of this
+ alongside the programmers employed by &RH;. The results of this
work are available to all.
</para>
18 years, 11 months
sudo-tutorial sudo-tutorial-en.xml,1.1.1.1,1.2
by fedora-docs-commits@redhat.com
Author: jtr
Update of /cvs/docs/sudo-tutorial
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv2904
Modified Files:
sudo-tutorial-en.xml
Log Message:
Checking that XML files in other directories aren't damaged during
tidy-bowl testing.
Index: sudo-tutorial-en.xml
===================================================================
RCS file: /cvs/docs/sudo-tutorial/sudo-tutorial-en.xml,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -u -r1.1.1.1 -r1.2
--- sudo-tutorial-en.xml 11 May 2005 16:50:26 -0000 1.1.1.1
+++ sudo-tutorial-en.xml 9 Jun 2005 16:06:26 -0000 1.2
@@ -442,3 +442,4 @@
</para>
</section>
</article>
+
18 years, 11 months