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

Deploy gryf/window-maker.github.io to github.com/gryf/window-maker.github.io.git:gh-pages

Browse Source
This commit is contained in:
Deployment Bot (from Travis CI)
2020-04-06 17:04:05 +00:00
commit 17a465baa1
240 changed files with 23516 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

153
docs/installation.html Normal file
View File

@@ -0,0 +1,153 @@
<!DOCTYPE html>
<html>
<head>
<title>Window Maker: Documentation</title>
<meta charset="utf-8">
<link rel="stylesheet" href="/style.css" media="screen">
<meta name="HandheldFriendly" content="True">
<meta name="MobileOptimized" content="320">
<meta name="viewport"
content="width=device-width, minimumscale=1.0, maximum-scale=1.0">
</head>
<body>
<div id="wrapper">
<header>
<h1>
<a href="/">
<span class="first">Window</span><span class="second">Maker</span>
</a>
</h1>
</header>
<aside>
<nav class="menu">
<ul>
<li id="dock">
<a href="#"></a>
</li>
<li id="home" title="Home">
<a href="/">Home</a>
</li>
<li id="news" title="News">
<a href="/news">News</a>
</li>
<li id="docs" title="Documentation">
<a href="/docs">Documentation</a>
</li>
<li id="mail" title="Mailing lists">
<a href="/lists">Mailing</a>
</li>
<li id="devel" title="Development">
<a href="/dev">Development</a>
</li>
<li id="screenshots" title="Screenshots">
<a href="/screenshots">Screenshots</a>
</li>
<li id="themes" title="Themes">
<a href="/themes">Themes</a>
</li>
<li id="links" title="Links">
<a href="/links">Links</a>
</li>
</ul>
</nav>
</aside>
<article>
<div class="document" id="installation-basics">
<h1 class="title">Installation Basics</h1>
<div class="section" id="downloading-and-extracting">
<h1>Downloading and Extracting</h1>
<p>The first necessary step is to <a class="reference external" href="http://windowmaker.org/pub/source/release/WindowMaker-0.95.5.tar.gz">download</a> the
Window Maker source distribution. From this point on, we'll assume it has been
retrieved and is residing on the local hard disk. The next step is to extract
it, and change into the source directory.</p>
<pre class="code console highlight literal-block"><code><span class="gp">#</span> <span class="nb">cd</span> /path/to/your/download
<span class="gp">#</span> gunzip WindowMaker-0.xx.xx.tar.gz
<span class="gp">#</span> tar -xf WindowMaker-0.xx.xx.tar
<span class="gp">#</span> <span class="nb">cd</span> WindowMaker-0.xx.xx</code></pre>
<p>Now that things are extracted, it's time to look at the relevant pieces of
documentation. Most UNIX oriented free software packages come with a README
file, and Window Maker is no exception. The README file contains a summary
overview of what the distribution is, what the various directories contain, and
other general information.</p>
<p>Moving along, we have the NEWS file. For now, we just want to point out its
existence. It will become more useful to novice users over time. Veteran Window
Maker users will find it handy for keeping their configuration files up to
date, and learning about various changes which affect Window Maker's behavior.</p>
<p>The two remaining files we need to look at are INSTALL and BUGS. The INSTALL
file provides additional information that is necessary to install Window Maker
successfully. The BUGS file contains a list of known Window Maker bugs. If a
user feels they've found a bug in Window Maker, they should consult the BUGS
file first. If the bug isn't listed, proceed to the Bug Tracker and see if its
there.</p>
</div>
<div class="section" id="compiling">
<h1>Compiling</h1>
<p>After extracting the latest version of Window Maker using the previous
instructions, the next step is to compile it. First of all, the configure
script should be run. It will test to make sure all the necessary libraries,
compilers and build tools are available on the local system. The configure
script allows for various arguments to be passed to it which relate to Window
Maker's installation. For a complete list of all configurable settings, enter:</p>
<pre class="code console highlight literal-block"><code><span class="gp">$</span> ./configure --help</code></pre>
<p>Commonly used configuration options are:</p>
<pre class="code console highlight literal-block"><code><span class="go">--prefix=DIR --enable-modelock --enable-xinerama --enable-silent-rules</span></code></pre>
<p>The first configuration option lets Window Maker be installed into a
non-default installation directory (e.g if Window Maker cannot be installed
system wide for some reason, a user can specify a path under his/her home
directory). The default installation directory is /usr/local/bin. Note that
root access will be needed later on during the installation process if the
defaults were used.</p>
<p>So if a user johndoe would like to install the wmaker binary into
/home/johndoe/wmaker/bin instead of the default /usr/local/bin, the following
argument would be passed to the configure script:</p>
<pre class="code console highlight literal-block"><code><span class="gp">$</span> ./configure --prefix<span class="o">=</span>/home/johndoe/wmaker</code></pre>
<p>After the configure script has been successfully executed, Window Maker can now
be compiled with the make command; simply enter:</p>
<pre class="code console highlight literal-block"><code><span class="gp">$</span> make</code></pre>
<p>The final step is to install the binaries and other support files. This is
accomplished by entering:</p>
<pre class="code console highlight literal-block"><code><span class="gp">#</span> make install</code></pre>
<p>Note that this is the step that needs to be performed by root if the default
installation directory was used, or if a directory was specified that the
running user cannot write to. If the installing user has root access, they
should first become root by issuing <span class="docutils literal">su - root</span>. Otherwise, reconfigure and
recompile Window Maker by specifying a different installation directory, or
kindly ask the local system administator to install it system wide.</p>
<p>Once Window Maker is installed system-wide, a default configuration can be
installed on a per-user basis, through the bundled installation script,
<span class="docutils literal">wmaker.inst</span>. Enter <span class="docutils literal">wmaker.inst</span> in a terminal emulator to configure
Window Maker for your user.</p>
<p>This script copies the default Window Maker configuration to your user's home
directory and sets Window Maker as the default window manager. It is
recommended to create <span class="docutils literal">~/GNUstep</span> before executing the script.</p>
</div>
<div class="section" id="final-tweaks">
<h1>Final tweaks</h1>
<p>Edit your ~/.xinitrc to load your newly installed Window Maker using the line
<span class="docutils literal">exec /usr/local/bin/wmaker</span>.</p>
<p>Generate a new root menu (accessible with F12) with <span class="docutils literal">wmgenmenu</span>, for example</p>
<pre class="code console highlight literal-block"><code><span class="gp">$</span> wmgenmenu &gt; <span class="nv">$HOME</span>/GNUstep/Defaults/WMRootMenu</code></pre>
<p>Another recommended step is to install a few dockapps like wmvolman, wmmixer
and wmsystemtray which allow one to easily mount external media on /media among
other things. Visit <a class="reference external" href="http://www.dockapps.net">dockapps</a> for many more
choices.</p>
</div>
</div>
</article>
<div id="titlebar">
<div id="minimize"></div>
<div id="titlebar-inner">Window Maker: Documentation</div>
<div id="close"></div>
</div>
<div id="resizebar">
<div id="resizel"></div>
<div id="resizebar-inner">
</div>
<div id="resizer"></div>
</div>
</div>
</body>
</html>