From e65b6ff507dc5666f22a8523bf41264d09cb72f2 Mon Sep 17 00:00:00 2001 From: Morgan Aldridge Date: Thu, 31 Dec 2020 10:12:57 -0500 Subject: [PATCH] Added new README.md for GitHub --- README.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..e8cede0 --- /dev/null +++ b/README.md @@ -0,0 +1,59 @@ +# MLVWM + +## OVERVIEW + +MLVWM (Macintosh-Like Virtual Window Manager) is an X11 window manager with a classic MacOS appearance. Its primary features include: + +* Emulation of MacOS 7 & 8 menu bar & window decorations +* Optional multiple virtual desktops +* A main menu bar across the top of the screen, with: + * Configurable global and per-application menus + * Menu items trigger application functionality via keyboard shorcuts or commands + * An icon menu which shows all windows and supports: + * Switching desktops + * Selecting, hiding, and showing windows + * A balloon help menu + * The ability to "swallow" small windows into the menu bar +* Windows which support: + * Title bars with optional close, zoom, and shade buttons + * Resize handle + * Optional double-click to toggle window shade + * Drag as solid window or just outline +* Balloon help which shows X window information +* Global keyboard shortcuts +* Numerous configuration options to tune functionality + +## INSTALLATION + +Build & installation currently still requires [imake](https://en.wikipedia.org/wiki/Imake) & make. While the original documentation says that `xmkmf -a` should work, we've found it's usually necessary to do the following: + + cd man && xmkmf && cd - + cd sample_rc && xmkmf && cd - + cd mlvwm && xmkmf && cd - + xmkmf + make && make install + +## CONFIGURATION + +While some sample configuration files are included in the `sample_rc` directory, we highly suggest using the configuration files from the [mlvwmrc](https://github.com/morgant/mlvwmrc) project. + +## DOCUMENTATION + +We suggest reading the manual page (`man mlvwm`; English), but you may also find the original documentation helpful: + +* README: [English](README), [日本語](README.jp) +* CONFIGURATION: [English](CONFIGURATION), [日本語](CONFIGURATION.jp) +* CHANGELOG: [English](CHANGELOG), [日本語](CHANGELOG.jp) +* Website: [English](http://www2u.biglobe.ne.jp/~y-miyata/mlvwm.html) + +Note: the English documentation above was automatically generated from the Japanese documentation. + +## HISTORY + +MLVWM was originally developed in 1997 by Takashi HASEGAWAi, based on FVWM, while studying at Nagoya University. Active development proceeded through 2000. In 2020, Morgan Aldridge obtained permission to continue maintenance & development. + +## LICENSE + +This software is distributed as freeware as long as the original copyright remains in the source code and all documentation. Some files retain their original MIT license and one file is in the public domain. + +Macintosh and MacOS are registered trademarks of Apple, Inc. (née Apple Computer, Inc.)