gryf/window-maker.github.io
1
0
Fork 0
mirror of https://github.com/gryf/window-maker.github.io.git synced 2025-12-18 03:50: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

135
docs/wings.html Normal file
View File

@@ -0,0 +1,135 @@
<!DOCTYPE html>
<html>
<head>
<title>Window Maker: WINGs</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">
<div class="section" id="wings-is-not-gnustep">
<h1>WINGs Is Not GNUstep</h1>
<p>While GNUstep is our ideal development framework, it's overkill for a window
manager like Window Maker. We had a need for a quick, lightweight toolkit to
handle basic window manager tasks, which is how WINGs was born, and why it has
become an integral part of Window Maker's core.</p>
<p>Unlike the general uses of the GNUstep development environment, the WINGs
toolkit was designed as a specific solution for Window Maker. It is not
implemented in an object-oriented language, but was designed with OO schemas in
mind. It is encapsulated in objects that have various methods (functions),
which in turn can be accessed like real objects (i.e it's unknown what they
contain, and they only have the interface functions to alter their data). As
much as C will allow, that is. What really matters is that it's functional and
small enough for our purposes.</p>
<p>Surprisingly, there have been several developers who think WINGs is mature and
functional enough to write full fledged applications with it. For developers
who are interested in creating real applications, we would encourage them to
look at GNUstep instead. GNUstep is written in Objective-C, and anyone with a
solid C++ background shouldn't need more than an hour to begin programming in
Objective-C. For more information on this, please visit the <a class="reference external" href="http://www.gnustep.org/developers/documentation.html">GNUstep Developer
Documentation</a> section.</p>
<p>So, what does WINGs do for us, specifically? It contains many necessary
widgets, such as the buttons, file browser, color chooser, and text editor
dialog that are all used for creating the UI. It is currently missing a few
important items, such as DnD, treeview, and application menus, but those will
be integrated in future releases.</p>
<p>One of the more important aspects of WINGs is that it now provides proplist
functionality. proplist, short for <a class="reference external" href="http://en.wikipedia.org/wiki/Property_list">property list</a>, is what Window Maker uses to
generate and maintain structured configuration files. This data is stored as
plain ASCII text under a user's ~/GNUstep directory. These files are what make
up the menus, the current state and appearance of the desktop, the Dock, the
Clip, and the values set in WPrefs.</p>
<p>As an example, here is a short snippet from the proplist version of the default
menu:</p>
<pre class="code highlight literal-block"><code>(
Applications,
(
Info,
("Info Panel", INFO_PANEL),
(Legal, LEGAL_PANEL),
("System Console", EXEC, xconsole),
("System Load", SHEXEC, "xosview || xload"),
("Process List", EXEC, "xterm -e top"),
("Manual Browser", EXEC, xman)
),
(Run..., EXEC, "%a(Run,Type command to run:)"),
...
)</code></pre>
</div>
<div class="section" id="external-sources-of-information">
<h1>External sources of information</h1>
<p>As this section evolves, we will be providing more documentation on the
internals of WINGs. For the time being, developers interested in WINGs should
see Alexey Voinov's <a class="reference external" href="http://voins.program.ru/windowmaker/wingsman.html">WINGsman documentation project</a>. Starters may find <a class="reference external" href="/WINGs_tutorial/WINGtoc.html">this
tutorial</a>, which includes a library listing
based on Voinov's work, useful. We'll try to cover some examples and/or more
tutorials on how to program small applications in WINGs in the near future. For
anyone already using WINGs for a project, please <a class="reference external" href="/lists">contact us</a>, as we'd like to get an idea of its popularity and practical uses,
as well as some additional material to place here.</p>
</div>
</div>
</article>
<div id="titlebar">
<div id="minimize"></div>
<div id="titlebar-inner">Window Maker: WINGs</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>