From b2eecb93522eddb59a3ce2838a05272068b89bd7 Mon Sep 17 00:00:00 2001
From: dobrek <>
Date: Tue, 21 May 2002 13:18:06 +0000
Subject: [PATCH] - Added more detailed description what is rpm.

---
 .../docbook/PLD-Guide/admin-manual/basics.xml | 15 +++++-
 .../docbook/PLD-Guide/admin-manual/sysadm.xml | 50 +++++++++++++++++++
 LDP/guide/docbook/PLD-Guide/make              | 10 ++--
 3 files changed, 70 insertions(+), 5 deletions(-)

diff --git a/LDP/guide/docbook/PLD-Guide/admin-manual/basics.xml b/LDP/guide/docbook/PLD-Guide/admin-manual/basics.xml
index 1b680084..321f376f 100644
--- a/LDP/guide/docbook/PLD-Guide/admin-manual/basics.xml
+++ b/LDP/guide/docbook/PLD-Guide/admin-manual/basics.xml
@@ -1,7 +1,10 @@
   <chapter id="oper">
     <title>Basic operation</title>
     <abstract>
-      <para>Some basics</para>
+      <para>This chapter describes basic operations done during everyday
+      system administrator work. This operations are not much different
+      then in other Linux based systems hence we concentrate on the
+      specific for PLD ones.</para>
     </abstract>
     <section id="restart-shutdown">
       <title>Restarting and shutting down</title>
@@ -22,6 +25,9 @@
 	On PC computers reboot can be also invoked by pressing Ctrl-Alt-Del sequence.
       </para>
     </section>
+    
+    </para>
+    </section> 
     <section id="subsystems">
       <title>Starting/stopping particular subsystems</title>
       <para>
@@ -200,6 +206,13 @@ rc-inetd       	0:---	1:---	2:---	3:***	4:***	5:***	6:---
 	brings it to level 2 (as a consequence, NFS subsystems will be stopped).
       </para>
     </section>
+
+	<section id="instaling">
+		<title>Instaling new packages</title>
+		<para>
+			
+		</para>
+	</section>
     </chapter>
 
 <!-- Keep this comment at the end of the file
diff --git a/LDP/guide/docbook/PLD-Guide/admin-manual/sysadm.xml b/LDP/guide/docbook/PLD-Guide/admin-manual/sysadm.xml
index 29e8371a..a7ebf0d4 100644
--- a/LDP/guide/docbook/PLD-Guide/admin-manual/sysadm.xml
+++ b/LDP/guide/docbook/PLD-Guide/admin-manual/sysadm.xml
@@ -4,6 +4,56 @@
 	<title>RPM package management</title>
 	<section>
 	  <title>Using RPM</title>
+   <para>
+    PLD is a rpm based Linux distribution. Rpm is a system of
+    maintaining software resources of your computer. This system 
+    provides you a command <command>rpm</command> which you can use to
+    perform basic operations (install, upgrade, remove) on your set of
+    packages. Every package is a collection of files which provides you 
+    some functionality. For instance program which your humble author 
+    use to write this text is called <command>vim.ispell</command>.
+    It is located in file <filename>/usr/bin/vim.ispell</filename>.
+    I can check that my <command>vim.ispell</command> comes from 
+    package <filename>vim-ispell-6.1.063-1</filename> using the command:
+    <programlisting>
+dobrek:~> rpm -qf /usr/bin/vim.ispell
+vim-ispell-6.1.063-1
+    </programlisting></para>
+    <para>This package could by installed by downloading file 
+    <filename>vim-ispell-6.1.063-1.i686.rpm</filename> from PLD ftp site
+    or one of the mirrors and invoking command <command>rpm  -i
+    vim-ispell-6.1.063-1.i686.rpm</command>. </para>
+    <para>
+    Rpm can by also used for removing packages using command 
+    <command>rpm -e vim-ispell </command>. 
+    </para>
+    <para>
+    Sometimes already installed packages require upgrade. It can
+    happen
+    that new version has a expected new feature or the old one has a
+    nasty security bug. If you want to upgrade package type 
+    <command>rpm -U \<package name\> </command>
+    <note>
+    Upgrading package which conatins your kernel is usually very bad
+    idea. Upgrade consist of removing the old package and installing the
+    new one. With kernel it is usually safe to install the new one test
+    and than id everything works fine remove the old one.
+    </note>
+    <note>
+    After upgrade some packages you will note that there are some new
+    files. It usually happens in the case of configuration files located
+    in <filename>/etc</filename>. For instance if you upgrade your <application>lpd</application>
+    daemon you will note that the file <filename>/etc/printcap</filename> hasn't been 
+    overwritten but the new file is created
+    <filename>/etc/printcap.rpmnew</filename>. It is almoust always
+    worth to look into this type of files to check out what are the
+    differences between old and new version. 
+    </note>
+
+    </para>
+
+    
+    
 	  <para>configuring rpm (limit languages, etc)</para>
 	</section>
 	<section>
diff --git a/LDP/guide/docbook/PLD-Guide/make b/LDP/guide/docbook/PLD-Guide/make
index 3aa7a02e..037d4d0e 100755
--- a/LDP/guide/docbook/PLD-Guide/make
+++ b/LDP/guide/docbook/PLD-Guide/make
@@ -1,6 +1,8 @@
 #!/bin/bash
-rm -rf /home/httpd/html/tmp/PLD-Guide
+DEST=~/public_html/LDP/
+rm -rf $DEST
 umask 022
-cp -r /home/users/ser/pldcvs/PLD-Guide /home/httpd/html/tmp
-cd /home/httpd/html/tmp/PLD-Guide; docbook2html PLD-Guide.xml
-chmod -R a+rX /home/httpd/html/tmp/PLD-Guide
+mkdir $DEST
+cp -r $PWD/* $DEST
+cd $DEST; docbook2html PLD-Guide.xml
+chmod -R a+rX $DEST/