[deployment-guide/comm-rel: 14/35] Described the basic date usage.

[dsilas]

commit a0f5dd8b0a183c7b09ea1d016277a10429e3e53d
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Wed Jun 2 09:12:20 2010 +0200

    Described the basic date usage.

 en-US/Date_and_Time_Configuration.xml |   27 +++++++++++++++++++++++++--
 1 files changed, 25 insertions(+), 2 deletions(-)
---
diff --git a/en-US/Date_and_Time_Configuration.xml b/en-US/Date_and_Time_Configuration.xml
index 485d0f6..2ba0fa6 100644
--- a/en-US/Date_and_Time_Configuration.xml
+++ b/en-US/Date_and_Time_Configuration.xml
@@ -172,8 +172,10 @@
   <section id="sect-Date_and_Time_Configuration-Command_Line_Configuration">
     <title>Command Line Configuration</title>
     <para>
-      TODO.
+      In case your system does not have the <application>Date/Time Properties</application> tool installed, or the <emphasis>X Window Server</emphasis> is not running, you will have to change the system date and time on the command line. Note that in order to perform actions described in this section, you have to be logged in as a superuser:
     </para>
+    <screen>~]$ <command>su -</command>
+Password: </screen>
     <section id="sect-Date_and_Time_Configuration-Command_Line_Configuration-Date_and_Time">
       <title>Date and Time Setup</title>
       <indexterm significance="normal">
@@ -183,8 +185,29 @@
         <primary>date configuration</primary>
       </indexterm>
       <para>
-        TODO.
+        The <command>date</command> command allows the superuser to set the system date and time:
+      </para>
+      <procedure>
+        <step>
+          <para>
+            <emphasis>Change the current date.</emphasis> Type the command in the following form at a shell prompt, replacing the <replaceable>YYYY</replaceable> with a four-digit year, <replaceable>MM</replaceable> with a two-digit month, and <replaceable>DD</replaceable> with a two-digit day of the month (e.g., <emphasis>2010-06-02</emphasis>):
+          </para>
+          <screen>~]# <command>date +%D -s <replaceable>YYYY-MM-DD</replaceable></command></screen>
+        </step>
+        <step>
+          <para>
+            <emphasis>Change the current time.</emphasis> Use the following command, where <replaceable>HH</replaceable> stands for an hour, <replaceable>MM</replaceable> is a minute, and <replaceable>SS</replaceable> is a second, all typed in the two-digit form (e.g., <emphasis>23:26:00</emphasis>):
+          </para>
+          <screen>~]# <command>date +%T -s <replaceable>HH:MM:SS</replaceable></command></screen>
+          <para>If your system clock is set to use <acronym>UTC</acronym> (Universal Time, Coordinated, also known as Greenwich Mean Time or GMT), add the following option:</para>
+          <screen>~]# <command>date +%T -s <replaceable>HH:MM:SS</replaceable> -u</command></screen>
+        </step>
+      </procedure>
+      <para>
+        You can check your current settings typing <command>date</command> without any additional argument, e.g.:
       </para>
+      <screen>~]$ <command>date</command>
+Wed Jun  2 11:58:48 CEST 2010</screen>
     </section>
     <section id="sect-Date_and_Time_Configuration-Command_Line_Configuration-Network_Time_Protocol">
       <title>Network Time Protocol Setup</title>