gryf/window-maker.github.io
1
0
Fork 0
mirror of https://github.com/gryf/window-maker.github.io.git synced 2025-12-17 19:20:17 +01:00
Code Issues Projects Releases Wiki Activity

Converted first chapter of user guide to rst

Browse Source
This commit is contained in:
gryf
2019-05-27 20:21:11 +02:00
parent 2dc0ef5a2f
commit 3e6d9ac459
2 changed files with 64 additions and 49 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
docs/chap1.html
View File

@@ -1,49 +0,0 @@
---
layout: default
title: User Guide - Introduction
---
<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>

64
docs/chap1.rst Normal file
View File

@@ -0,0 +1,64 @@
---
layout: default
title: User Guide - Introduction
---
Introduction
============
This manual describes the usage and configuration of the Window Maker 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.
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.
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.
You can ignore the text in Extra Bindings boxes while you're getting familiar
with Window Maker. Once you've got familiar with it, you can read the text in
these boxes to learn more ways to accomplish tasks.
What is a window manager?
-------------------------
If you come from the Windows or MacOS world, you might be confused about all
these things like window managers, X windows etc.
In the Unix world, the task of providing a graphical user interface (GUI) is
normally divided by 3 different components:
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.
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.
For more information, read the manual page for X(1) and the documentation for
Xlib.
The primary function of the window manager is to control the layout of top
level windows on screen. Window Maker 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.
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, OpenLook, and Athena are examples of
toolkits.
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.