commit a6df0c6b3c195f8b286d0a1a88fe8b163f324195 Author: Carlos R. Mafra Date: Sat Feb 4 21:21:32 2012 +0000 Initial state for the homepage diff --git a/FAQ.php b/FAQ.php new file mode 100644 index 0000000..5ca1aa0 --- /dev/null +++ b/FAQ.php @@ -0,0 +1,51 @@ + + + + + Window Maker: Home + + + + + + + +
+ + + + +
+
+
+ +

FAQ

+ +

Have questions about Window Maker? If so, look no further. Below is our collection of Frequently Asked Questions and + their corresponding answers. Many of these have been adapted from the original FAQ by Chris + Green. Questions are routinely taken and added in from the mailing lists and IRC forums.

+ +
    +
  1. Introduction to Window Maker
  2. + +
  3. Installing Window Maker
  4. + +
  5. Configuring Window Maker
  6. + +
  7. Using Window Maker
  8. + +
  9. Application Compatibility
  10. + +
  11. Themes and Dockapps
  12. + +
  13. Miscellaneous Questions
  14. + +
  15. Troubleshooting Tips
  16. + +
  17. Programming for Window Maker
  18. +
+
+
+ + diff --git a/README b/README new file mode 100644 index 0000000..d803990 --- /dev/null +++ b/README @@ -0,0 +1,5 @@ +To keep the same formatting please consider using + +tidy -i -m 130 -m *.php + +after modifying the sources. diff --git a/dev.php b/dev.php new file mode 100644 index 0000000..2160e2a --- /dev/null +++ b/dev.php @@ -0,0 +1,56 @@ + + + + + Window Maker: Development + + + + + + + +
+ + + + +
+

Here are some pieces of information regarding development in Window Maker.

+ +

Source code versioning system

+ +

The source code for Window Maker is contained in a git repository located here. Git is very convenient for our purposes and you can find more + information about it on the mentioned link. To obtain a full-fledged copy of the repository do this:

+ +

git clone git://repo.or.cz/wmaker-crm.git

+ +

Submitting patches

+ +

The source code in the above git repository follows the coding style of the linux kernel. Please take a look + + here and try to respect it when submitting patches. This is really important.

+ +

If you want to contribute patches to Window Maker and you are not familiar with git, please take a look at the git + homepage above - it contains the kind of documentation you need to get started. You should also read the file contained + in the Window Maker repository The perfect Window Maker patch + which gives you further details about patches to Window Maker.

+ +

If your patch is really good and important, feel free to send it to the mailing list + wmaker-dev@lists.windowmaker.org anyway in whatever form most suits you. But please consider the fact that patches sent + in odd formats induce extra work for who applies them.

+ +

Last but not least, patches doing code cleanups are STRONGLY encouraged. Please go ahead! The risks + of introducing regressions when doing cleanups exists, but if you also follow the practice of having a patch for each + unrelated change you do, the eventuall regressions can be easily found and reverted.

+ +

WINGs

+ +

Window Maker uses the WINGs library for its widgets, click on that link for more information + about it.

+
+
+ + diff --git a/development.png b/development.png new file mode 100644 index 0000000..6a761da Binary files /dev/null and b/development.png differ diff --git a/dock.php b/dock.php new file mode 100644 index 0000000..29f0a0f --- /dev/null +++ b/dock.php @@ -0,0 +1,41 @@ + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + +
Home
News
Documentation
Mailing Lists
Development
+
+ + diff --git a/docs.php b/docs.php new file mode 100644 index 0000000..20140b2 --- /dev/null +++ b/docs.php @@ -0,0 +1,50 @@ + + + + + Window Maker: Documentation + + + + + + + +
+ + + + +
+
+
+ +

Documentation


+ +

It's a fact that one of the biggest problems with today's software is lack of good documentation, or any + documentation for that matter. Programmers generally don't have a lot of time to document their work, and the things + they do document are usually oriented towards other programmers. While we can appreciate the programmers point of view, + we feel it's necessary to cater to a larger audience (i.e our users) by providing clear, concise information on how to + use our software. The sections below will bring all of these pieces of information together for you.

+ +

Before you get started with Window Maker, you need to have an understanding of how to make use of the documentation + that comes with the source distribution. The main objective to using documentation is to understand + it, which coincidentally requires that you read it. A common mistake is for new or novice users to + overlook this information, leading them to frustration and a bad first impression. Please take a moment to peruse the + sections below, which should make the experience of learning Window Maker a more pleasant one.

+ + +
+
+ + diff --git a/docs.png b/docs.png new file mode 100644 index 0000000..aa3d9e5 Binary files /dev/null and b/docs.png differ diff --git a/header.php b/header.php new file mode 100644 index 0000000..6046cf0 --- /dev/null +++ b/header.php @@ -0,0 +1,13 @@ + + + + + + + Window Maker homepage + + + + + + diff --git a/home.php b/home.php new file mode 100644 index 0000000..c0b3694 --- /dev/null +++ b/home.php @@ -0,0 +1,44 @@ + + + + + Window Maker: Home + + + + + + + +
+ + + + +
+
+
+ +

Introduction

+ +

Window Maker is an X11 window manager originally designed to provide integration support for the + GNUstep Desktop Environment. In every way possible, it reproduces the elegant look and + feel of the NEXTSTEP user interface. It is fast, feature rich, easy to configure, and easy to use. It is also free + software, with contributions being made by programmers from around the world.

+ +

Window Maker includes compatibility options which allow it to work with other popular desktop environments, namely + GNOME and KDE, and comes with a powerful GUI configuration editor, called WPrefs, which removes the need to edit + text-based config files by hand. It also supports running dockapps which + help on tasks such as monitoring system performance and battery usage, mounting devices or connecting to the internet + etc. Please see the features section for more specifics on what Window Maker can do, and how it compares with other + popular window managers. A screenshot of a typical Window Maker workspace is here.

+ +

Latest stable version

+ +

The latest stable version is 0.95.1, released on 29.01.2012. See the NEWS section for more + information.

+
+
+ + diff --git a/homewmaker.png b/homewmaker.png new file mode 100644 index 0000000..3e5328e Binary files /dev/null and b/homewmaker.png differ diff --git a/homewmaker2.png b/homewmaker2.png new file mode 100644 index 0000000..af3cc6d Binary files /dev/null and b/homewmaker2.png differ diff --git a/index.php b/index.php new file mode 100644 index 0000000..734ec28 --- /dev/null +++ b/index.php @@ -0,0 +1,16 @@ + + + + + + + + Window Maker - A window manager for X + + + + + + + + diff --git a/installation.php b/installation.php new file mode 100644 index 0000000..da19028 --- /dev/null +++ b/installation.php @@ -0,0 +1,112 @@ + + + + + Window Maker: Documentation + + + + + + + +
+ + + + +
+
+
+ +

Installation Basics

+ +

Downloading and Extracting

+ +

The first necessary step is to download? 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.

+
+# cd /path/to/your/download
+# gunzip WindowMaker-0.xx.xx.tar.gz
+# tar -xf WindowMaker-0.xx.xx.tar
+# cd WindowMaker-0.xx.xx
+
+
+ +

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.

+ +

Next, we have the ChangeLog which describes a list of changes since the first version. Although it usually lists + technical advancements about the distribution, it is also useful for finding out about bug fixes and recently added + features.

+ +

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.

+ +

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.

+ +

Compiling

+ +

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:

+
+# ./configure -help
+
+
+ +

Three commonly used configuration options are:

+
+--prefix=DIR --enable-kde --enable-gnome
+
+
+ +

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 for the wmaker binary and /usr/local/GNUstep/Apps for the WPrefs + application (the WPrefs installation directory can be specified by using --with-appspath=DIR). Note that root access + will be needed later on during the installation process if the defaults were used. The second and third configuration + options will enable Window Maker to fully cooperate with KDE and GNOME respectively.

+ +

So if a user johndoe would like to install the wmaker binary into /home/johndoe/wmaker/bin instead of the default + /usr/local/bin, and if he wishes to use Window Maker in cooperation with KDE, the following arguments would be passed + to the configure script:

+
+ # ./configure --prefix=/home/johndoe/wmaker --enable-kde
+
+
+ +

After the configure script has been successfully executed, Window Maker can now be compiled with the make command; + simply enter:

+
+# make
+
+
+ +

Now is a good time to get a drink while the compilation takes place. Providing the compilation goes well, the final + step is to install the binaries and other support files. This is accomplished by entering: # make install

+ +

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 su - root. Otherwise, reconfigure and recompile Window Maker by specifying a + different installation directory, or kindly ask the local system administator to install it system wide.

+ +

Once Window Maker is installed system-wide, a default configuration can be installed on a per-user basis, through + the bundled installation script, wmaker.inst. Enter wmaker.inst in a terminal emulator to + configure Window Maker for your user.

+ +

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 ~/GNUstep before executing the script.

+
+
+ + diff --git a/intro.png b/intro.png new file mode 100644 index 0000000..2939576 Binary files /dev/null and b/intro.png differ diff --git a/lists.php b/lists.php new file mode 100644 index 0000000..76ce8d9 --- /dev/null +++ b/lists.php @@ -0,0 +1,100 @@ + + + + + Window Maker: Mailing Lists + + + + + + + +
+ + + + +
+
+
+ +

Mailing Lists

+ +

This page contains all of the information needed in order to subscribe or unsubscribe from the mailing lists, along + with the general guidelines that should be followed when posting messages.

+ +

Listed below are the currently available Window Maker mailing lists. We have switched our list software over to + Enemies of Carlotta. MHonArc + enables us to provide web-based archives to our users. Selecting a link under the Name field will bring up more details + and instructions regarding that specific list.

+
+          
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NAMEDESCRIPTIONGmane Archive
wmaker-devDevelopment discussion about the Window Maker window managerwmaker-dev Archives
wmaker-userUser discussion about the Window Maker window managerwmaker-user Archives
+ +

The following rules of etiquette are to be followed when posting to any of the lists:

+ +
    +
  • +

    Do not top post.

    +
  • + +
  • +

    Use of excessive quoting in E-mail replies is frowned upon.

    +
  • + +
  • +

    HTML messages and non-text attachments will be rejected.

    +
  • + +
  • +

    Do not post questions to a list without having read all of documentation + that is available to you. The Window Maker source code comes with a README, INSTALL, and NEWS file. There + is also an FAQ to read. These pieces of information are MANDATORY reading and contain answers to many + common questions. Please, do not post a question to the lists unless it can't be found in the documentation.

    +
  • + +
  • +

    Please, please, and pretty please THINK before you post. Try very hard not to intentionally + provoke others and cause flame-wars. We reserve the right to unsubscribe and ban any user that has a history of + causing trouble.

    +
  • +
+
+
+
+ + diff --git a/mailing_list.png b/mailing_list.png new file mode 100644 index 0000000..b3b9f61 Binary files /dev/null and b/mailing_list.png differ diff --git a/main.php b/main.php new file mode 100644 index 0000000..0758c90 --- /dev/null +++ b/main.php @@ -0,0 +1,32 @@ + + + + + + + + +
+ + + + +
+
+
+ +

Window Maker is an X11 window manager originally designed to provide integration support for the + GNUstep Desktop Environment. In every way possible, it reproduces the elegant look and + feel of the NEXTSTEP user interface. It is fast, feature rich, easy to configure, and easy to use. It is also free + software, with contributions being made by programmers from around the world.

+ +

Window Maker includes compatibility options which allow it to work with other popular desktop environments, namely + GNOME and KDE, and comes with a powerful GUI configuration editor, called WPrefs, which removes the need to edit + text-based config files by hand. It also supports running dockapps which + help on tasks such as monitoring system performance and battery usage, mounting devices or connecting to the internet + etc. Please see the features section for more specifics on what Window Maker can do, and how it compares with other + popular window managers.

+
+
+ + diff --git a/news.php b/news.php new file mode 100644 index 0000000..d3a1822 --- /dev/null +++ b/news.php @@ -0,0 +1,103 @@ + + + + + Window Maker: News + + + + + + + +
+ + + + +
+
+
+ +

Version 0.95.1 released

+ +

Window Maker 0.95.1 was released on January 29th 2012.

+ +

The last official Window Maker release was version 0.92.0 from 2006, and version 0.95.1 contains many bug fixes and + also a few new features. Window Maker 0.92.0 was already very stable, so most of the bug fixes are related to odd or + not very frequent situations. One random example is the fix which avoids a segfault when creating more than 81 + workspaces, as reported on youtube here.

+ +

Another bug-fix of peculiar nature is this one, which happened once every + 49 days -- more precisely 2^32 milliseconds.

+ +

A lot of effort was put into cleaning up the code, with lots of code removal and tidying things up. The following + output should give you an idea of the development in the last cycle:

+
+[mafra@Pilar:wmaker.git]$ git diff --shortstat wmaker-0.92.0+..wmaker-0.95.1
+ 592 files changed, 118361 insertions(+), 133342 deletions(-)
+[mafra@Pilar:wmaker.git]$ git diff --shortstat 688a56e8ab67b..wmaker-0.95.1
+ 566 files changed, 37676 insertions(+), 41817 deletions(-)
+
The first shortstat is really everything, including the (huge) patch generated in this commit from 2009, which changed the old +sources to the linux kernel coding style. The second shortstat contains the summary of development after that patch. + +

New features and highlights

+ +

This list is really very incomplete, but should give a first-order approximation to what are the new features in + this release. For a bit more of details see the NEWS file included in the sources, although it also misses a lot of + things. For the truly curious among you, reading through git log is the complete source of + information.

+ +
    +
  • +

    Left/right window maximization, making them occupy the left/right area of the screen

    +
  • + +
  • +

    Maximus (a.k.a tiled) maximization. Maximizes windows such that it occupies the largest area without overlapping + other windows

    +
  • + +
  • +

    New mouse-resizing functionality. Windows can now be resized vertically (horizontally) using MOD+Wheel + (CTRL+Wheel)

    +
  • + +
  • +

    History and TAB completion in the run dialog

    +
  • + +
  • +

    A WPrefs option to make icons bounce when their respective applications want attention

    +
  • + +
  • +

    New applications (wmgenmenu and wmmenugen) to generate the root menu automatically by looking which applications + you have on your $PATH

    +
  • + +
  • +

    Automatic detection of configuration changes. Linux users whose kernel supports the inotify mechanism no longer can have their configuration changes + detected automatically without polling, which reduces the number of CPU wakeups

    +
  • + +
  • +

    Dockapps can now receive special treatment by setting their WM_CLASS to "DockApp"

    +
  • + +
  • +

    And many trivial things which reduce little annoyances one might have. For example, an option was added to + control whether or not Window Maker should do automatic workspace switching to satisfy a focus request from a + window located in another workspace.

    +
  • +
+ +


+ Info v0.95.1

+
+
+ + diff --git a/news.png b/news.png new file mode 100644 index 0000000..a08394d Binary files /dev/null and b/news.png differ diff --git a/title.css b/title.css new file mode 100644 index 0000000..abc7122 --- /dev/null +++ b/title.css @@ -0,0 +1,101 @@ +body { + color: #FFF; + font-size: 0.9em; + font-family: "Trebuchet MS", Arial, Helvetica, sans-serif; + background-color: #505075; + border-size: 0px; + margin-top: 0px; + margin-right: 0px; + margin-bottom: 0px; + margin-left: 0px; +} +td { +} +th { + color: #000 +} +.hpadding { + color: #483d8b; + font-weight: normal; + font-size: 14px; + font-family: "Trebuchet MS", Arial, Helvetica, sans-serif; + padding: 0px 10px +} +.textpadding { + color: white; + font-size: 12px; + font-family: "Trebuchet MS", Arial, Helvetica, sans-serif; + line-height: normal; + margin: 0; + padding: 0 10px +} +a { + font-family: "Trebuchet MS", Arial, Helvetica, sans-serif; +} +h1 { + color: #ebdeff; + font-size: 20pt; + font-family: "Trebuchet MS", Arial, Helvetica, sans-serif; + font-style: italic; + font-weight: bold; + line-height: 22pt +} +h2 { + color: #ebdeff; + font-size: 18pt; + font-family: "Trebuchet MS", Arial, Helvetica, sans-serif; + font-style: italic; + line-height: 20pt +} +h3 { + color: #e8fd00; + font-size: 14pt; + font-family: "Trebuchet MS", Arial, Helvetica, sans-serif; + font-style: normal; + line-height: 16pt +} +h4 { + color: #FFF; + font-size: 12pt; + font-family: "Trebuchet MS", Arial, Helvetica, sans-serif; + font-style: normal; + font-weight: bolder; + line-height: 12pt +} +pre { + background-color: #FFFFFF; + color: #000; +} +.caption { + font-size: 11pt; + font-family: "Trebuchet MS", Arial, Helvetica, sans-serif +} +a:hover { + text-decoration: underline; + color: #F00; +} +a: link { + text-decoration: underline; + color: #FFF; +} +# a:visited, a:active { +# text-decoration: underline; +# color: #FFF; +#} +img { + border: none; +} +#header { position: relative; top: 0px; left: 6%; + width: 100%; } + +#dock { position: absolute; top: 150px; left: 5px; + width: 100%; height: 500px; + } + +#inhalt { position: relative; top: 10px; left: 10%; + width: 100%; + } + +#tableline { + color: #F00; +} diff --git a/v0_95_1.png b/v0_95_1.png new file mode 100644 index 0000000..595b190 Binary files /dev/null and b/v0_95_1.png differ diff --git a/wings.php b/wings.php new file mode 100644 index 0000000..6a7ab30 --- /dev/null +++ b/wings.php @@ -0,0 +1,80 @@ + + + + + WINGst + + + + + + + +
+ + + + +
+
+
+ +

WINGs Is Not GNUstep

+ +

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.

+ +

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.

+ +

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 GNUstep Developer Documentation section.

+ +

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.

+ +

One of the more important aspects of WINGs is that it now provides proplist functionality. proplist, short for + property list, 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.

+ +

As an example, here is a short snippet from the proplist version of the default menu:

+
+(
+        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:)"),
+...
+)
+
+
+ +

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 WINGsman documentation project. Starters may find this tutorial, 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 contact us, as we'd like to get an idea of its popularity and practical uses, as + well as some additional material to place here.

+
+
+ + diff --git a/wmaker-dev.php b/wmaker-dev.php new file mode 100644 index 0000000..b4b5435 --- /dev/null +++ b/wmaker-dev.php @@ -0,0 +1,47 @@ + + + + + Window Maker: Home + + + + + + + +
+ + + + +
+
+
+ +

Window Maker Developer List

+ +

Overview

+ +

Window Maker Developer List is aimed at developers and others interested in the inner workings of Window Maker.

+ +

Subscribe

+ +

Send an email to wmaker-dev-subscribe@lists.windowmaker.org

+ +

You will get an email back to verify your address, reply and you are subscribed.

+ +

Unsubscribe

+ +

Send an email to wmaker-dev-unsubscribe@lists.windowmaker.org from the address + you are subscribed.

+ +

Archives

+ +

The list is archived at http://lists.windowmaker.org/dev/

+
+
+ + diff --git a/wmaker-screenshot.png b/wmaker-screenshot.png new file mode 100644 index 0000000..7b58971 Binary files /dev/null and b/wmaker-screenshot.png differ diff --git a/wmaker-user.php b/wmaker-user.php new file mode 100644 index 0000000..9376012 --- /dev/null +++ b/wmaker-user.php @@ -0,0 +1,47 @@ + + + + + Window Maker: Home + + + + + + + +
+ + + + +
+
+
+ +

Window Maker User List

+ +

Overview

+ +

Window Maker User List is aimed at the end user for questions, tips, suggestions and general discussion.

+ +

Subscribe

+ +

Send an email to wmaker-user-subscribe@lists.windowmaker.org

+ +

You will get an email back to verify your address, reply and you are subscribed.

+ +

Unsubscribe

+ +

Send an email to wmaker-user-unsubscribe@lists.windowmaker.org from the + address you are subscribed.

+ +

Archives

+ +

The list is archived at http://lists.windowmaker.org/user/

+
+
+ +