From: Aaron Taylor Date: Sat, 4 Feb 2023 02:14:22 +0000 (-0800) Subject: Moving README->README.md so gitweb notices it for display. X-Git-Url: http://git.subgeniuskitty.com/dwm/.git/commitdiff_plain/13dd93684910cd0210ca0158b2f8279499ab0adf Moving README->README.md so gitweb notices it for display. --- diff --git a/README b/README deleted file mode 100644 index 8019607..0000000 --- a/README +++ /dev/null @@ -1,119 +0,0 @@ -This git repository contains my personal branch of dwm-6.4. - -The changes made to stock dwm add the following abilities. - - - Replaced stock 'tile' layout with 'flextile'. - - - - Added new layout with three columns, master in the middle. - - - - Draw per-client indicators in the tag section of the status bar. - - - - Prompt the user before exiting/restarting dwm. - - - - Assign text names to tags at runtime. - - - - Layout menu popup presents available layouts. - - - - Select multiple tags for simultaneous display or window assignment. - - - - Deselect ALL tags, displaying an empty desktop. - - - - Center window names in status bar. - - - - Active client has wide, red border. - - - Customized rules/keybindings in `config.h`. - -In addition to the usual dependencies and installation tasks for dwm (see the -original README at the bottom of this file), there are the following new -dependencies/tasks. - - - xmenu from . This requires freetype2 - and imlib2, available in FreeBSD's ports collection under `print/freetype2` - and `graphics/imlib2`. This is required for the layout menu popup. - - - Customize (if needed) and install `layoutmenu.sh` somewhere in your `$PATH`. - Remember to make it executable. - - - Build and install SGK version of dwmstatus, then call from `.xinitrc`. - -Possible patches to consider in the future: - - - https://dwm.suckless.org/patches/cfacts/ - - - https://dwm.suckless.org/patches/mark/ - - - https://dwm.suckless.org/patches/monocle_count/ - - - https://dwm.suckless.org/patches/preserveonrestart/ - - - https://dwm.suckless.org/patches/swallow/ - -================================================================================ -================================================================================ -================================================================================ - -Below is the original dwm README file. - -================================================================================ -================================================================================ -================================================================================ - - -dwm - dynamic window manager -============================ -dwm is an extremely fast, small, and dynamic window manager for X. - - -Requirements ------------- -In order to build dwm you need the Xlib header files. - - -Installation ------------- -Edit config.mk to match your local setup (dwm is installed into -the /usr/local namespace by default). - -Afterwards enter the following command to build and install dwm (if -necessary as root): - - make clean install - - -Running dwm ------------ -Add the following line to your .xinitrc to start dwm using startx: - - exec dwm - -In order to connect dwm to a specific display, make sure that -the DISPLAY environment variable is set correctly, e.g.: - - DISPLAY=foo.bar:1 exec dwm - -(This will start dwm on display :1 of the host foo.bar.) - -In order to display status info in the bar, you can do something -like this in your .xinitrc: - - while xsetroot -name "`date` `uptime | sed 's/.*,//'`" - do - sleep 1 - done & - exec dwm - - -Configuration -------------- -The configuration of dwm is done by creating a custom config.h -and (re)compiling the source code. diff --git a/README.md b/README.md new file mode 100644 index 0000000..8019607 --- /dev/null +++ b/README.md @@ -0,0 +1,119 @@ +This git repository contains my personal branch of dwm-6.4. + +The changes made to stock dwm add the following abilities. + + - Replaced stock 'tile' layout with 'flextile'. + + + - Added new layout with three columns, master in the middle. + + + - Draw per-client indicators in the tag section of the status bar. + + + - Prompt the user before exiting/restarting dwm. + + + - Assign text names to tags at runtime. + + + - Layout menu popup presents available layouts. + + + - Select multiple tags for simultaneous display or window assignment. + + + - Deselect ALL tags, displaying an empty desktop. + + + - Center window names in status bar. + + + - Active client has wide, red border. + + - Customized rules/keybindings in `config.h`. + +In addition to the usual dependencies and installation tasks for dwm (see the +original README at the bottom of this file), there are the following new +dependencies/tasks. + + - xmenu from . This requires freetype2 + and imlib2, available in FreeBSD's ports collection under `print/freetype2` + and `graphics/imlib2`. This is required for the layout menu popup. + + - Customize (if needed) and install `layoutmenu.sh` somewhere in your `$PATH`. + Remember to make it executable. + + - Build and install SGK version of dwmstatus, then call from `.xinitrc`. + +Possible patches to consider in the future: + + - https://dwm.suckless.org/patches/cfacts/ + + - https://dwm.suckless.org/patches/mark/ + + - https://dwm.suckless.org/patches/monocle_count/ + + - https://dwm.suckless.org/patches/preserveonrestart/ + + - https://dwm.suckless.org/patches/swallow/ + +================================================================================ +================================================================================ +================================================================================ + +Below is the original dwm README file. + +================================================================================ +================================================================================ +================================================================================ + + +dwm - dynamic window manager +============================ +dwm is an extremely fast, small, and dynamic window manager for X. + + +Requirements +------------ +In order to build dwm you need the Xlib header files. + + +Installation +------------ +Edit config.mk to match your local setup (dwm is installed into +the /usr/local namespace by default). + +Afterwards enter the following command to build and install dwm (if +necessary as root): + + make clean install + + +Running dwm +----------- +Add the following line to your .xinitrc to start dwm using startx: + + exec dwm + +In order to connect dwm to a specific display, make sure that +the DISPLAY environment variable is set correctly, e.g.: + + DISPLAY=foo.bar:1 exec dwm + +(This will start dwm on display :1 of the host foo.bar.) + +In order to display status info in the bar, you can do something +like this in your .xinitrc: + + while xsetroot -name "`date` `uptime | sed 's/.*,//'`" + do + sleep 1 + done & + exec dwm + + +Configuration +------------- +The configuration of dwm is done by creating a custom config.h +and (re)compiling the source code.