From 4ef2d9b4e7a9da1fca36e133446ac07b5c231231 Mon Sep 17 00:00:00 2001
From: "Carlos R. Mafra" <crmafra@gmail.com>
Date: Mon, 6 Feb 2012 00:01:34 +0000
Subject: [PATCH] Initial pages of "User guide"

---
 docs.php               |  4 +--
 guide.php              | 44 ++++++++++++++++++++++++++
 guide/introduction.php | 70 ++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 116 insertions(+), 2 deletions(-)
 create mode 100644 guide.php
 create mode 100644 guide/introduction.php
diff --git a/docs.php b/docs.php
index 017ed32..fd8c5ab 100644
--- a/docs.php
+++ b/docs.php
@@ -37,9 +37,9 @@
           <ul>
             <li><a href="installation.php">Installation Basics</a></li>
 
-            <li><a href="http://main.linuxfocus.org/~georges.t/">Guided Tour</a></li><!--        
+            <li><a href="http://main.linuxfocus.org/~georges.t/">Guided Tour</a></li>
             <li><a href="guide.php">User Guide</a></li>
-            <li><a href="desktop.php">Desktop/X Integration</a></li> -->
+<!--            <li><a href="desktop.php">Desktop/X Integration</a></li> -->
 
             <li><a href="FAQ.php">FAQ</a></li>
 
diff --git a/guide.php b/guide.php
new file mode 100644
index 0000000..6c44d40
--- /dev/null
+++ b/guide.php
@@ -0,0 +1,44 @@
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+  <meta name="generator" content="HTML Tidy for Linux (vers 25 March 2009), see www.w3.org" />
+
+  <title>Window Maker: News</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+  <link href="title.css" rel="stylesheet" type="text/css" />
+</head>
+
+<body>
+  <?php
+              include("header.php");
+              include("dock.php");
+      ?>
+
+  <div id="inhalt">
+    <table width="880" border="0" cellpadding="1" cellspacing="1">
+      <tr>
+        <td content="content" colspan="2" valign="top">
+          <h3><strong>WindowMaker User's Guide: Table of Contents</strong></h3>
+          <hr />
+
+          <ul>
+            <li><a href="guide/introduction.php">Introduction</a></li>
+
+            <li><a href="guide/windows.php">Windows</a></li>
+
+            <li><a href="guide/workspace.php">The Workspace</a></li>
+
+            <li><a href="guide/configure.php">Configuring WindowMaker</a></li>
+
+            <li><a href="guide/tips.php">Tips</a></li>
+
+            <li><a href="guide/glossary.php">Glossary</a></li>
+
+            <li><a href="guide/credits.php">credits</a></li>
+          </ul>
+          <hr />
+        </td>
+      </tr>
+    </table>
+  </div>
+</body>
+</html>
diff --git a/guide/introduction.php b/guide/introduction.php
new file mode 100644
index 0000000..140e0fc
--- /dev/null
+++ b/guide/introduction.php
@@ -0,0 +1,70 @@
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+  <meta name="generator" content="HTML Tidy for Linux (vers 25 March 2009), see www.w3.org" />
+
+  <title>Window Maker: News</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+  <link href="../title.css" rel="stylesheet" type="text/css" />
+</head>
+
+<body>
+  <?php
+              include("../header.php");
+              include("../dock.php");
+      ?>
+
+  <div id="inhalt">
+    <table width="880" border="0" cellpadding="1" cellspacing="1">
+      <tr>
+        <td content="content" colspan="2" valign="top">
+          <h3>Introduction</h3>
+
+          <p>This manual describes the usage and configuration of the WindowMaker window manager. It is intended for both users
+          who never used the X Window System and for users who have experience with other window managers.</p>
+
+          <p>How to Read this guide If you never have used a X window manager, you should read all of this guide, as it contains
+          detailed instructions for new users.</p>
+
+          <p>Text in sans serif font, indicate instructions you must follow to accomplish a given task. If you're out of time (or
+          patience), you should at least read text in these parts.</p>
+
+          <p>You can ignore the text in Extra Bindings boxes while you're getting familiar with WindowMaker. Once you've got
+          familiar with it, you can read the text in these boxes to learn more ways to accomplish tasks.</p>
+
+          <h1>1.1 What is a window manager?</h1>
+
+          <p>If you come from the Windows or MacOS world, you might be confused about all these things like window managers, X
+          windows etc.</p>
+
+          <p>In the Unix world, the task of providing a graphical user interface (GUI) is normally divided by 3 different
+          components:</p>
+
+          <p>the window server; the window manager and the user interface toolkit. The window server is standard and is usually
+          the X Window System or some vendor provided compatible version of it. The X Window System, or X for short, is a window
+          server. It's function is to provide a portable and high-level access to devices like keyboard, mouse and video display.
+          It allows applications to show graphical information on the display through rectangular areas called windows.</p>
+
+          <p>Most user interface objects, like buttons, menus and scrollers are made of windows. The top level windows displayed
+          by applications are named windows as well. These objects are not provided by the window server. These must be made by
+          the application program or by the user interface toolkit.</p>
+
+          <p>For more information, read the manual page for X(1) and the documentation for Xlib.</p>
+
+          <p>The primary function of the window manager is to control the layout of top level windows on screen. WindowMaker is a
+          window manager. It provides a titlebar and a resizebar to change window layout, application menus to launch
+          applications and execute special commands, application icons, miniwindows and an application dock. They will be
+          explained in more detail in the following chapters.</p>
+
+          <p>The user interface toolkit is a library or collection of libraries that provide an API for application developers to
+          program the interfaces for their applications. Toolkits generally provide controls like buttons, menus, radio-buttons
+          etc to be used for program interaction. There are currently many of these toolkits available for X. Motif
+          &#226;&#8222;&#162;, OpenLook &#226;&#8222;&#162;, and Athena are examples of toolkits.</p>
+
+          <p>All other features normally found in other operating systems, like file managers, are implemented as separate
+          programs and are not directly related to the window manager.</p>
+        </td>
+      </tr>
+    </table>
+  </div>
+</body>
+</html>
