changeset: 831:1b3039b7a0e8
tag: tip
user: anselm_AT_garbe.us
date: Thu Feb 09 21:15:55 2012 +0100
files: dwm.suckless.org/dynamic_window_management.md suckless.org/broken_libraries.md suckless.org/broken_programs.md suckless.org/bugs.md suckless.org/cool_daemons.md suckless.org/cool_libraries.md suckless.org/cool_programs.md suckless.org/devel/bugs.md suckless.org/devel/faq.md suckless.org/devel/index.md suckless.org/devel/patches.md suckless.org/faq.md suckless.org/manifest.md suckless.org/manifest/dynamic_window_management.md suckless.org/manifest/index.md suckless.org/misc/broken_libraries.md suckless.org/misc/broken_programs.md suckless.org/misc/cool_daemons.md suckless.org/misc/cool_libraries.md suckless.org/misc/cool_programs.md suckless.org/misc/index.md suckless.org/patches.md suckless.org/wiki.md suckless.org/wiki/index.md suckless.org/wiki/sandbox/index.md suckless.org/wiki/sandbox/submenu1/index.md suckless.org/wiki/sandbox/submenu1/subsubmenu1/index.md suckless.org/wiki/sandbox/submenu1/subsubmenu2/index.md suckless.org/wiki/sandbox/submenu1/subsubmenu3/index.md suckless.org/wiki/sandbo
x/submenu1/subsubmenu4/index.md suckless.org/wiki/sandbox/submenu2/subsubmenu1/index.md suckless.org/wiki/sandbox/submenu2/subsubmenu2/index.md suckless.org/wiki/sandbox/submenu2/subsubmenu3/index.md suckless.org/wiki/sandbox/submenu3/subsubmenu1/index.md suckless.org/wiki/sandbox/submenu3/subsubmenu2/index.md
description:
cleanup of suckless.org structure
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 dwm.suckless.org/dynamic_window_management.md
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/dwm.suckless.org/dynamic_window_management.md Thu Feb 09 21:15:55 2012 +0100
_AT_@ -0,0 +1,42 @@
+DYNAMIC WINDOW MANAGEMENT
+=========================
+
+We think that static window management as seen in Ion or wmi-10 is a far too
+rigid and inflexible working environment. In [acme](
http://acme.cat-v.org),
+larswm, and oberon, dynamic window management frees the user from these
+limitations. The user can start as many applications and windows as he likes,
+and easily arrange them in a useful way, helped by the window manager - the
+working environment changes with the tasks the user is performing. The
+experience is very fluid and natural. Similar concepts have been introduced in
+wmii and dwm.
+
+Dynamic window management states that it is the window manager's job to manage
+windows - and not the user's job to have to set up some specialized layout that
+will only work for one specific work scenario. This has been the larswm motto
+for a long time. In contrast to static window management, the user rarely has
+to think about how to organize windows, no matter what he is doing or how many
+applications are running at the same time. The window manager adapts to the
+current environment and helps the user manage and mold it to his needs, rather
+than forcing it to use a preset, fixed layout and trying to shoehorn all
+windows and applications into it.
+
+Dynamic window management has many advantages - you can create and tear down
+whole working environments in a matter of seconds rather than spending time
+fine-tuning a fixed layout that cannot work well in all cases. The number and
+nature of windows you work with changes all the time, and a dynamic window
+manager lets you adapt to that and always efficiently use your precious screen
+real estate.
+
+Some will argue that you should setup a different static workspace for each of
+the tasks you perform (one for web browsing, one for email reading, one for
+coding, etc.), but that is just a workaround for the limitations of static
+window management, and it doesn't account for the many sub-usage patterns each
+main task has.
+
+For example: the layout you use during debugging would probably be quite
+different to the one used during refactoring, you might want to have a patch
+someone emailed you in view while you look at some code, or edit a
+configuration file while you look at a man page or website. Dynamic window
+management lets you mix and match on the fly to always have the windows you
+need in view, and only the windows you need, without the need to reserve extra
+space which you may or may not end up using.
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/broken_libraries.md
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/suckless.org/broken_libraries.md Thu Feb 09 21:15:55 2012 +0100
_AT_@ -0,0 +1,23 @@
+Broken Libraries
+================
+
+These libraries are broken/considered harmful and should not be used if it's
+possible to avoid them. If you use them, consider looking for alternatives.
+
+* [glib][1] - implements C++ STL on top of C (because C++ sucks so much, let's
+ reinvent it!), adding lots of useless data types for
+ ["portability" and "readability" reasons][2].
+ Alternatives: whoever thinks it needs alternatives shall fill this space.
+
+* [GMP][3] - GNU's bignum/arbitrary precision library. Quite bloated, slow and
+ [calls abort() on failed malloc][4]
+ Alternatives: [libtommath][5], [TomsFastMath][6], [MPI][7]
+
+
+[1]:
http://library.gnome.org/devel/glib/
+[2]:
http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html (glib Basic Types)
+[3]:
http://gmplib.org/ (The GNU Multiple Precision Arithmetic Library)
+[4]:
http://gmplib.org:8000/gmp/file/14cd74efb9de/memory.c#l44 "GMP calls abort() on failed malloc()"
+[5]:
http://libtom.org/?page=features&newsitems=5&whatfile=ltm
+[6]:
http://libtom.org/?page=features&newsitems=5&whatfile=tfm
+[7]:
http://spinning-yarns.org/michael/mpi/
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/broken_programs.md
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/suckless.org/broken_programs.md Thu Feb 09 21:15:55 2012 +0100
_AT_@ -0,0 +1,53 @@
+BROKEN PROGRAMS
+===============
+
+There are many broken X programs. Go bug the developers of these broken
+programs to fix them. Here are some of the main causes of this brokenness:
+
+* The program assumes a specific window management model, i.e.
+ assumes you are using a WIMP-window manager like those
+ found in KDE or Gnome. This assumption breaks the
+ [ICCCM conventions][icccm].
+* The application uses a fixed size - this limitation does not fit
+ into the world of tiling window managers very well, and can also be
+ seen as breaking the ICCCM conventions, because a fixed sized window
+ assumes a specific window management model as well (though the ICCCM
+ does not forbid fixed-size windows). In any case, the ICCCM requests
+ that clients accept any size the window manager proposes to them.
+* The program is based on strange non-standard window manager
+ hints that only work properly with a window manager supporting these
+ extensions - this simply breaks the ICCCM as well. E.g. trash icon
+ programs.
+* The program does not conform to ICCCM due to some missing or
+ improperly set hints.
+
+WORKAROUND
+----------
+
+If you still need some program which expects a floating WM, use it in
+floating mode.
+
+The following programs are broken (see [cool
+programs](/common/cool_programs.html) for saner alternatives):
+
+* XMMS (assumes fixed size, doesn't set transient\_for hint properly)
+* Xchat
+* [Firefox](
http://www.mozilla.org/products/firefox) (doesn't set the TRANSIENT\_FOR hint correctly on its download dialog)
+* [GIMP](
http://www.gimp.org/) (GIMP expects a float environment to be useable)
+* beep-media-player
+* gqview
+* gthumb
+* mplayer with GUI (assumes special window management model. It works without the GUI)
+* xine (same as xmms)
+* aterm (doesn't like being resized by the WM), See [aterm-ml-post][aterm-ml-post]
+ Alternatives: (u)xterm, urxvt, [st][st], [uuterm][uuterm]
+
+SEE ALSO
+--------
+
+The [list of harmful software](
http://harmful.cat-v.org/software/) at [cat-v.org](
http://cat-v.org).
+
+[aterm-ml-post]:
http://lists.suckless.org/dev/1102/7141.html
+[st]:
http://st.suckless.org/
+[uuterm]:
http://etalabs.net/uuterm.html
+[icccm]:
http://tronche.com/gui/x/icccm/
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/bugs.md
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/suckless.org/bugs.md Thu Feb 09 21:15:55 2012 +0100
_AT_@ -0,0 +1,27 @@
+BUGS
+====
+
+Debugging
+---------
+If you find any crashes, please send a full backtrace to the dedicated mailing list.
+You can create backtraces with `gdb`:
+
+Before starting a program, you may have to allow core file creation. It is
+recommended that you put this in your profile:
+
+ $ ulimit -c unlimited
+
+Then start the program as usual.
+
+After the program crashes, do the following:
+
+ $ gdb --quiet `which program` /path/to/core
+ gdb> bt full
+
+If you encounter freezes (no crash at all) of the program, you can debug as follows:
+
+ $ gdb --quiet `which program` --attach `pgrep -o program`
+ gdb> bt full
+
+Send the output of that command to the mailing list along with the output of
+`program -v`! Thank you!
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/cool_daemons.md
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/suckless.org/cool_daemons.md Thu Feb 09 21:15:55 2012 +0100
_AT_@ -0,0 +1,18 @@
+Cool Daemons
+============
+
+This page is dedicated to Daemons that are related to the UNIX philosophy (but
+don't really belong into the cool programs section which is about programs
+which work well with dwm).
+
+Web Servers
+-----------
+* [Nostromo](
http://www.nazgul.ch/dev_nostromo.html)
+* [thttpd](
http://acme.com/software/thttpd/) - Outperforms many bigger httpds. Old, still works very well!
+* [mini_httpd](
http://acme.com/software/mini_httpd/) - By the thttpd developers. Even smaller subset of thttpd with support for .htpasswd, CGI, dirlisting, HTTP errors and SSL, nothing more or less than that.
+* See also: our very own [quark](
http://hg.suckless.org/quark/) which has not yet been released
+
+Gopher Servers
+--------------
+
+* [geomyidae](
http://www.r-36.net/src/geomyidae/) - small gopher-daemon written by 20h
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/cool_libraries.md
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/suckless.org/cool_libraries.md Thu Feb 09 21:15:55 2012 +0100
_AT_@ -0,0 +1,49 @@
+COOL LIBRARIES
+==============
+
+This category is for small, usable development libraries, which can be used for
+writing software that sucks less.
+These should preferrably be under the MIT/X consortium or BSD licenses, WTFPL,
+or public domain, or alternatively LGPL, because it makes them legally
+compatible with other suckless projects.
+
+libc implementations
+--------------------
+* [uClibc](
http://www.uclibc.org/) - strives to be a minimalist C library suitable for embedded computing
+* [musl](
http://www.etalabs.net/musl/) - standard C library that attempts to be even smaller than uClibc
+* See also: [embedded libc comparison](
http://www.etalabs.net/compare_libcs.html)
+
+Configuration file parsers
+--------------------------
+* [iniparser](
http://ndevilla.free.fr/iniparser/) - relatively small ini parsing library, contains a dictionary data structure and accessory functions (MIT licensed)
+
+Compression
+-----------
+* [liblzf](
http://oldhome.schmorp.de/marc/liblzf.html) - very fast, legally unencumbered compression library (dual licensed: 2-clause BSD or GPL License)
+* [xz embedded](
http://tukaani.org/xz/embedded.html) - lightweight decompressor for the xz LZMA compressor (public domain)
+* [zlib](
http://zlib.net/) - the "standard" compression/decompression library used in many applications ([zlib license](
http://zlib.net/zlib_license.html))
+
+libtom project
+--------------
+All of these are dual-licensed under WTFPL and also public domain. According
+to the website, "[…] the GPG and OpenSSL folk assume that completely abhorrent
+and messy source code is ok, so long as it works. The LibTom Projects aims to
+change this line of thinking."
+
+* [libtommath, libtomcrypt and tomsfastmath](
http://libtom.org/)
+
+Cryptography
+------------
+* [libtomcrypt](
http://libtom.org/?page=features&newsitems=5&whatfile=crypt) - the cryptography library from the libtom project
+* [polarssl](
http://polarssl.org/) - lightweight SSL/TLS implementation (unfortunately GPL)
+
+Mathematics
+-----------
+* [libtommath](
http://libtom.org/?page=features&newsitems=5&whatfile=ltm) - math/bignum library (can be used insted of the much bigger [GNU MP](
http://gmplib.org) library).
+* [libtomfastmath](
http://libtom.org/?page=features&newsitems=5&whatfile=tfm) - port of libtommath using inline assembler for speedup on various architectures
+* [libmpi](
http://spinning-yarns.org/michael/mpi/) - lightweight math lib from which libtommath was originally forked
+
+Miscellaneous
+-------------
+* [pjsip](
http://www.pjsip.org/) - open source SIP stack (GPL)
+* [libev](
http://software.schmorp.de/pkg/libev.html) - high performance event-loop modeled after libevent but much smaller (dual licensed under 2-clause BSD and GPL)
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/cool_programs.md
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/suckless.org/cool_programs.md Thu Feb 09 21:15:55 2012 +0100
_AT_@ -0,0 +1,133 @@
+COOL PROGRAMS
+=============
+
+Some programs work well with dwm. Some general rules of thumb
+for judging a programs as usable are:
+
+* The program will accept any window size
+* The program consists of a single window (there are no nested windows, such as in Xpdf)
+
+This covers most console-based programs and programs from [plan9port][].
+
+Accounting
+----------
+* [Ledger](
https://github.com/jwiegley/ledger/wiki)
+
+Audio Players
+-------------
+* [C* Music Player](
http://cmus.sourceforge.net/)
+* [DeaDBeeF](
http://deadbeef.sourceforge.net/)
+* [PyTone](
http://www.luga.de/pytone/) - PyTone is a music jukebox written in Python with a curses based GUI. It provides features like crossfading and multiple players, special emphasis is put on ease of use.
+* [cplay](
http://cplay.sourceforge.net/)
+* [moc](
http://moc.daper.net/)
+* [mpd](
http://www.musicpd.org/) - A client/server based music player with console and graphical front-ends.
+* [mpg123](
http://www.mpg123.de/) - A console mpg player which doesn't use auto*hell, or extra libraries.
+* [mpg321](
http://mpg321.sourceforge.net)
+* [vorbis-tools](
http://www.xiph.org/) (Ogg/FLAC) - Command-line tools to play Ogg and FLAC files.
+
+BitTorrent Clients
+------------------
+* [btpd](
https://github.com/btpd/btpd) - The BitTorrent Protocol Daemon
+
+Feed aggregators
+----------------
+* [newsbeuter](
http://www.newsbeuter.org/)
+
+IRC Clients
+-----------
+* [Irc](
http://swtch.com/irc/)
+* [acme:SAC](
http://caerwyn.com/acme/index.html)
+* [ii](/programs/ii.html) - A FIFO based IRC client which is part of the suckless.org project.
+* [ircc](
http://www.r-36.net/src/Various/ircc.tgz) - A no-frills, ncurses free, console-based IRC client.
+* [ircrc](
http://plan9.bell-labs.com/sources/contrib/fgb/rc/ircrc) - An rc-based IRC client similar to ircc. Needs minor modification to run on UNIX.
+* [irssi](
http://www.irssi.org/)
+* [sic](/programs/sic.html) - Another suckless.org IRC client. Similar to ircc.
+
+Image Viewers
+-------------
+* [feh](
https://derf.homelinux.org/projects/feh/)
+* [jpg/gif/bmp/png][plan9port] - Simple programs from Plan 9 to display images in no-frills windows. Included with plan9port.
+* [meh](
http://www.johnhawthorn.com/meh/) - image viewer using raw XLib, libjpeg, libpng and libgif
+* [page][plan9port] - Plan 9's image/document viewer program. Included with plan9port.
+* [qiv](
http://www.klografx.net/qiv/)
+* [sxiv](
https://github.com/muennich/sxiv) - Simple (or small or suckless) X Image Viewer. Depends on xlib and imlib2.
+* [xli](
http://pantransit.reptiles.org/prog/) - broken link? Apparently, there's a copy here:
http://ftp.x.org/contrib/applications/ -- at your own risk
+* [xzgv](
http://sourceforge.net/projects/xzgv)
+
+Instant Messaging Clients
+-------------------------
+* [bitlbee](
http://www.bitlbee.org/) - A program to translate IM protocols to IRC. You can now IM from your IRC client, and you don't even need to install anything.
+* [centericq](
http://konst.org.ua/centericq/)
+* [centerim](
http://www.centerim.org/) - A centericq fork.
+* [climm](
http://www.climm.org/)
+* [mcabber](
http://www.lilotux.net/~mikael/mcabber/) - A console jabber client.
+* [ysm](
http://ysmv7.sourceforge.net/)
+
+Mail Clients
+------------
+* [Mail][plan9port] - A mail client for [acme][acme]. Included with plan9port.
+* [Sylpheed](
http://sylpheed.sraoss.jp/en/)
+* [dmc](
http://lolcathost.org/cgi-bin/hg/dmc/) - A minimalistic approach to a commandline mail client (WIP)
+* [fdm](
http://fdm.sourceforge.net/) - MDA
+* [heirloom-mailx](
http://heirloom.sourceforge.net/mailx.html) - A mail client based on the original Berkeley Mail 8.1 with many new features.
+* [mutt](
http://www.mutt.org/)
+* [muttator](
http://vimperator.org/muttator) - A Thunderbird extension to make it keyboard friendly and mutt/Vim-like.
+* [nmh](
http://www.nongnu.org/nmh/)
+
+Media Players
+-------------
+* [mplayer](
http://www.mplayerhq.hu/) (without GUI) - You know mplayer, but you may not know that it works well without the GUI.
+* smplayer
+
+PDF Viewers
+-----------
+* [zathura](
http://zathura.pwmt.org/)
+
+Programming languages
+---------------------
+* [Lua](
http://www.lua.org)
+* [TinyPy](
http://www.tinypy.org/) - Tiny Python (partial python)
+
+Text Editors
+------------
+* [acme][acme] - [Rob Pike][rob]'s framing text editor for Plan 9. Included in [plan9port][].
+* [ired](
http://www.radare.org) (Minimalist hexadecimal editor and bindiffer for p9, w32 and *nix)
+* [nvi](
http://www.bostic.com/vi/) - A small, multiple file vi-alike.
+* [sam](
http://sam.cat-v.org/) - An editor by [Rob Pike][rob] with inspiration from ed.
+* [traditional vi](
http://ex-vi.sourceforge.net/) - A fixed version of the original vi.
+* [vim](
http://www.vim.org) (With the GUI, use `:set go+=c` to kill popup dialogs)
+* [wily](
http://www.cs.yorku.ca/~oz/wily/) - An acme clone for POSIX.
+
+Utilities
+---------
+* [9menu](
http://www.freshports.org/x11/9menu/) - A menu program based on the Blit-style menus so prevalent in Plan 9. A take on it is included with wmii.
+* [dmenu](/programs/dmenu.html) - Obvious
+
+Web Browsers
+------------
+* [Abaco](
http://lab-fgb.com/abaco/)
+* [Conkeror](
http://www.conkeror.org/) - A Gecko based browser, imparting it Emacs style key bindings, appearances, and behaviors.
+* [Dillo](
http://www.dillo.org/)
+* [ELinks](
http://elinks.or.cz/)
+* [Links](
http://links.twibright.com/)
+* [Lynx](
http://lynx.isc.org/)
+* [Vimperator](
http://vimperator.org/) - An extension to make Firefox keyboard friendly and Vim-like.
+* [edbrowse](
http://edbrowse.sourceforge.net/)
+* [surf](
http://surf.suckless.org/)
+* [uzbl](
http://uzbl.org/)
+* [w3m](
http://w3m.sf.net/)
+
+X11
+---
+* [xdotool](
http://www.semicomplete.com/projects/xdotool/) – A tool for
+ scripting X11 actions.
+* [xzoom](
http://git.r-36.net/xzoom/) – A simple zoom application.
+* [xclip](
http://sourceforge.net/projects/xclip/) – A tool for controlling the
+ X11 clipboard.
+* [keynav](
http://www.semicomplete.com/projects/keynav/) – A new way for
+ keyboard selection.
+* [ffcast](
https://github.com/lolilolicon/FFcast2) – Simple screencasting.
+
+[rob]:
http://herpolhode.com/rob/
+[plan9port]:
http://swtch.com/plan9port/
+[acme]:
http://acme.cat-v.org
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/devel/bugs.md
--- a/suckless.org/devel/bugs.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,27 +0,0 @@
-BUGS
-====
-
-Debugging
----------
-If you find any crashes, please send a full backtrace to the dedicated mailing list.
-You can create backtraces with `gdb`:
-
-Before starting a program, you may have to allow core file creation. It is
-recommended that you put this in your profile:
-
- $ ulimit -c unlimited
-
-Then start the program as usual.
-
-After the program crashes, do the following:
-
- $ gdb --quiet `which program` /path/to/core
- gdb> bt full
-
-If you encounter freezes (no crash at all) of the program, you can debug as follows:
-
- $ gdb --quiet `which program` --attach `pgrep -o program`
- gdb> bt full
-
-Send the output of that command to the mailing list along with the output of
-`program -v`! Thank you!
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/devel/faq.md
--- a/suckless.org/devel/faq.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,9 +0,0 @@
-FAQ
-===
-Why don't you use autoconf, et al.?
------------------------------------
-We don't use auto*hell for various reasons, start here:
-
-* [“Stop the autoconf insanity! Why we need a new build system.”](
http://freshmeat.net/articles/view/889/)
-* [“Why autoconf, automake and libtool fail”](
http://www.ohse.de/uwe/articles/aal.html)
-* [“[9fans] configure misery”](
http://lists.cse.psu.edu/archives/9fans/2003-November/029714.html)
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/devel/index.md
--- a/suckless.org/devel/index.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,3 +0,0 @@
-Development
-===========
-This section contains general information about our software development.
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/devel/patches.md
--- a/suckless.org/devel/patches.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,28 +0,0 @@
-PATCHES
-=======
-
-diff generation
----------------
-For mercurial users:
-
- cd program-directory
- hg diff > program-X.Y-yourpatchname.diff
-
-For tarballs:
-
- cd modified-program-directory/..
- diff -up original-program-directory modified-program-directory > program-X.Y-yourpatchname.diff
-
-where `X.Y` is a dwm tag name or version number.
-
-patch program
--------------
-For mercurial users:
-
- cd program-directory
- hg patch path/to/patch.diff
-
-For tarballs:
-
- cd program-directory
- patch -p1 < path/to/patch.diff
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/faq.md
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/suckless.org/faq.md Thu Feb 09 21:15:55 2012 +0100
_AT_@ -0,0 +1,10 @@
+FAQ
+===
+
+Why don't you use autoconf, et al.?
+-----------------------------------
+We don't use auto*hell for various reasons, start here:
+
+* [“Stop the autoconf insanity! Why we need a new build system.”](
http://freshmeat.net/articles/view/889/)
+* [“Why autoconf, automake and libtool fail”](
http://www.ohse.de/uwe/articles/aal.html)
+* [“[9fans] configure misery”](
http://lists.cse.psu.edu/archives/9fans/2003-November/029714.html)
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/manifest.md
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/suckless.org/manifest.md Thu Feb 09 21:15:55 2012 +0100
_AT_@ -0,0 +1,63 @@
+SUCK LESS PHILOSOPHY
+====================
+
+Background
+----------
+We are the home of quality software such as [dwm](
http://dwm.suckless.org),
+[dmenu](
http://tools.suckless.org/dmenu), [st](
http://st.suckless.org/) and
+plenty of other [tools](
http://tools.suckless.org), with
+a focus on simplicity, clarity and frugality. Our philosophy is
+about keeping things simple, minimal and usable. We believe this should become
+the mainstream philosophy in the IT sector. Unfortunately, the tendency for
+complex, error-prone and slow software seems to be prevalent in the present-day
+software industry. We intend to prove the opposite with our software projects.
+
+Our project focuses on advanced and experienced computer users. In contrast
+with the usual proprietary software world or many mainstream open source
+projects that focus more on average and non-technical end users, we think that
+experienced users are mostly ignored. This is particularly true for user
+interfaces, such as graphical environments on desktop computers, on mobile
+devices, and in so-called Web applications. We believe that the market of
+experienced users is growing continuously, with each user looking for more
+appropriate solutions for his/her work style.
+
+Designing simple and elegant software is far more difficult than letting ad-hoc
+or over-ambitious features obscure the code over time. However one has to pay
+this price to achieve reliability and maintainability. Furthermore, minimalism
+results in reasonable and attainable goals. We strive to maintain minimalism and
+clarity to drive development to completion.
+
+Manifest
+--------
+Many (open source) hackers are proud if they achieve large amounts of code,
+because they believe the more lines of code they've written, the more progress
+they have made. The more progress they have made, the more skilled they are.
+This is simply a delusion.
+
+Most hackers actually don't care much about code quality. Thus, if they get
+something working which seems to solve a problem, they stick with it. If this
+kind of software development is applied to the same source code throughout its
+entire life-cycle, we're left with large amounts of code, a totally screwed
+code structure, and a flawed system design. This is because of a lack of
+conceptual clarity and integrity in the development process.
+
+Code complexity is the mother of bloated, hard to use, and totally inconsistent
+software. With complex code, problems are solved in suboptimal ways, valuable
+resources are endlessly tied up, performance slows to a halt, and
+vulnerabilities become a commonplace. The only solution is to scrap the entire
+project and rewrite it from scratch.
+
+The bad news: quality rewrites rarely happen, because hackers are proud of
+large amounts of code. They think they understand the complexity in the code,
+thus there's no need to rewrite it. They think of themselves as masterminds,
+understanding what others can never hope to grasp. To these types, complex
+software is the ideal.
+
+Ingenious ideas are simple. Ingenious software is simple. Simplicity is the
+heart of the Unix philosophy. The more code lines you have removed, the more
+progress you have made. As the number of lines of code in your software
+shrinks, the more skilled you have become and the less your software sucks.
+
+Related links
+-------------
+* [The Duct Tape Programmer](
http://www.joelonsoftware.com/items/2009/09/23.html)
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/manifest/dynamic_window_management.md
--- a/suckless.org/manifest/dynamic_window_management.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,42 +0,0 @@
-DYNAMIC WINDOW MANAGEMENT
-=========================
-
-We think that static window management as seen in Ion or wmi-10 is a far too
-rigid and inflexible working environment. In [acme](
http://acme.cat-v.org),
-larswm, and oberon, dynamic window management frees the user from these
-limitations. The user can start as many applications and windows as he likes,
-and easily arrange them in a useful way, helped by the window manager - the
-working environment changes with the tasks the user is performing. The
-experience is very fluid and natural. Similar concepts have been introduced in
-wmii and dwm.
-
-Dynamic window management states that it is the window manager's job to manage
-windows - and not the user's job to have to set up some specialized layout that
-will only work for one specific work scenario. This has been the larswm motto
-for a long time. In contrast to static window management, the user rarely has
-to think about how to organize windows, no matter what he is doing or how many
-applications are running at the same time. The window manager adapts to the
-current environment and helps the user manage and mold it to his needs, rather
-than forcing it to use a preset, fixed layout and trying to shoehorn all
-windows and applications into it.
-
-Dynamic window management has many advantages - you can create and tear down
-whole working environments in a matter of seconds rather than spending time
-fine-tuning a fixed layout that cannot work well in all cases. The number and
-nature of windows you work with changes all the time, and a dynamic window
-manager lets you adapt to that and always efficiently use your precious screen
-real estate.
-
-Some will argue that you should setup a different static workspace for each of
-the tasks you perform (one for web browsing, one for email reading, one for
-coding, etc.), but that is just a workaround for the limitations of static
-window management, and it doesn't account for the many sub-usage patterns each
-main task has.
-
-For example: the layout you use during debugging would probably be quite
-different to the one used during refactoring, you might want to have a patch
-someone emailed you in view while you look at some code, or edit a
-configuration file while you look at a man page or website. Dynamic window
-management lets you mix and match on the fly to always have the windows you
-need in view, and only the windows you need, without the need to reserve extra
-space which you may or may not end up using.
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/manifest/index.md
--- a/suckless.org/manifest/index.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,63 +0,0 @@
-SUCK LESS PHILOSOPHY
-====================
-
-Background
-----------
-We are the home of quality software such as [dwm](
http://dwm.suckless.org),
-[dmenu](
http://tools.suckless.org/dmenu), [st](
http://st.suckless.org/) and
-plenty of other [tools](
http://tools.suckless.org), with
-a focus on simplicity, clarity and frugality. Our philosophy is
-about keeping things simple, minimal and usable. We believe this should become
-the mainstream philosophy in the IT sector. Unfortunately, the tendency for
-complex, error-prone and slow software seems to be prevalent in the present-day
-software industry. We intend to prove the opposite with our software projects.
-
-Our project focuses on advanced and experienced computer users. In contrast
-with the usual proprietary software world or many mainstream open source
-projects that focus more on average and non-technical end users, we think that
-experienced users are mostly ignored. This is particularly true for user
-interfaces, such as graphical environments on desktop computers, on mobile
-devices, and in so-called Web applications. We believe that the market of
-experienced users is growing continuously, with each user looking for more
-appropriate solutions for his/her work style.
-
-Designing simple and elegant software is far more difficult than letting ad-hoc
-or over-ambitious features obscure the code over time. However one has to pay
-this price to achieve reliability and maintainability. Furthermore, minimalism
-results in reasonable and attainable goals. We strive to maintain minimalism and
-clarity to drive development to completion.
-
-Manifest
---------
-Many (open source) hackers are proud if they achieve large amounts of code,
-because they believe the more lines of code they've written, the more progress
-they have made. The more progress they have made, the more skilled they are.
-This is simply a delusion.
-
-Most hackers actually don't care much about code quality. Thus, if they get
-something working which seems to solve a problem, they stick with it. If this
-kind of software development is applied to the same source code throughout its
-entire life-cycle, we're left with large amounts of code, a totally screwed
-code structure, and a flawed system design. This is because of a lack of
-conceptual clarity and integrity in the development process.
-
-Code complexity is the mother of bloated, hard to use, and totally inconsistent
-software. With complex code, problems are solved in suboptimal ways, valuable
-resources are endlessly tied up, performance slows to a halt, and
-vulnerabilities become a commonplace. The only solution is to scrap the entire
-project and rewrite it from scratch.
-
-The bad news: quality rewrites rarely happen, because hackers are proud of
-large amounts of code. They think they understand the complexity in the code,
-thus there's no need to rewrite it. They think of themselves as masterminds,
-understanding what others can never hope to grasp. To these types, complex
-software is the ideal.
-
-Ingenious ideas are simple. Ingenious software is simple. Simplicity is the
-heart of the Unix philosophy. The more code lines you have removed, the more
-progress you have made. As the number of lines of code in your software
-shrinks, the more skilled you have become and the less your software sucks.
-
-Related links
--------------
-* [The Duct Tape Programmer](
http://www.joelonsoftware.com/items/2009/09/23.html)
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/misc/broken_libraries.md
--- a/suckless.org/misc/broken_libraries.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,23 +0,0 @@
-Broken Libraries
-================
-
-These libraries are broken/considered harmful and should not be used if it's
-possible to avoid them. If you use them, consider looking for alternatives.
-
-* [glib][1] - implements C++ STL on top of C (because C++ sucks so much, let's
- reinvent it!), adding lots of useless data types for
- ["portability" and "readability" reasons][2].
- Alternatives: whoever thinks it needs alternatives shall fill this space.
-
-* [GMP][3] - GNU's bignum/arbitrary precision library. Quite bloated, slow and
- [calls abort() on failed malloc][4]
- Alternatives: [libtommath][5], [TomsFastMath][6], [MPI][7]
-
-
-[1]:
http://library.gnome.org/devel/glib/
-[2]:
http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html (glib Basic Types)
-[3]:
http://gmplib.org/ (The GNU Multiple Precision Arithmetic Library)
-[4]:
http://gmplib.org:8000/gmp/file/14cd74efb9de/memory.c#l44 "GMP calls abort() on failed malloc()"
-[5]:
http://libtom.org/?page=features&newsitems=5&whatfile=ltm
-[6]:
http://libtom.org/?page=features&newsitems=5&whatfile=tfm
-[7]:
http://spinning-yarns.org/michael/mpi/
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/misc/broken_programs.md
--- a/suckless.org/misc/broken_programs.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,53 +0,0 @@
-BROKEN PROGRAMS
-===============
-
-There are many broken X programs. Go bug the developers of these broken
-programs to fix them. Here are some of the main causes of this brokenness:
-
-* The program assumes a specific window management model, i.e.
- assumes you are using a WIMP-window manager like those
- found in KDE or Gnome. This assumption breaks the
- [ICCCM conventions][icccm].
-* The application uses a fixed size - this limitation does not fit
- into the world of tiling window managers very well, and can also be
- seen as breaking the ICCCM conventions, because a fixed sized window
- assumes a specific window management model as well (though the ICCCM
- does not forbid fixed-size windows). In any case, the ICCCM requests
- that clients accept any size the window manager proposes to them.
-* The program is based on strange non-standard window manager
- hints that only work properly with a window manager supporting these
- extensions - this simply breaks the ICCCM as well. E.g. trash icon
- programs.
-* The program does not conform to ICCCM due to some missing or
- improperly set hints.
-
-WORKAROUND
-----------
-
-If you still need some program which expects a floating WM, use it in
-floating mode.
-
-The following programs are broken (see [cool
-programs](/common/cool_programs.html) for saner alternatives):
-
-* XMMS (assumes fixed size, doesn't set transient\_for hint properly)
-* Xchat
-* [Firefox](
http://www.mozilla.org/products/firefox) (doesn't set the TRANSIENT\_FOR hint correctly on its download dialog)
-* [GIMP](
http://www.gimp.org/) (GIMP expects a float environment to be useable)
-* beep-media-player
-* gqview
-* gthumb
-* mplayer with GUI (assumes special window management model. It works without the GUI)
-* xine (same as xmms)
-* aterm (doesn't like being resized by the WM), See [aterm-ml-post][aterm-ml-post]
- Alternatives: (u)xterm, urxvt, [st][st], [uuterm][uuterm]
-
-SEE ALSO
---------
-
-The [list of harmful software](
http://harmful.cat-v.org/software/) at [cat-v.org](
http://cat-v.org).
-
-[aterm-ml-post]:
http://lists.suckless.org/dev/1102/7141.html
-[st]:
http://st.suckless.org/
-[uuterm]:
http://etalabs.net/uuterm.html
-[icccm]:
http://tronche.com/gui/x/icccm/
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/misc/cool_daemons.md
--- a/suckless.org/misc/cool_daemons.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,18 +0,0 @@
-Cool Daemons
-============
-
-This page is dedicated to Daemons that are related to the UNIX philosophy (but
-don't really belong into the cool programs section which is about programs
-which work well with dwm).
-
-Web Servers
------------
-* [Nostromo](
http://www.nazgul.ch/dev_nostromo.html)
-* [thttpd](
http://acme.com/software/thttpd/) - Outperforms many bigger httpds. Old, still works very well!
-* [mini_httpd](
http://acme.com/software/mini_httpd/) - By the thttpd developers. Even smaller subset of thttpd with support for .htpasswd, CGI, dirlisting, HTTP errors and SSL, nothing more or less than that.
-* See also: our very own [quark](
http://hg.suckless.org/quark/) which has not yet been released
-
-Gopher Servers
---------------
-
-* [geomyidae](
http://www.r-36.net/src/geomyidae/) - small gopher-daemon written by 20h
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/misc/cool_libraries.md
--- a/suckless.org/misc/cool_libraries.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,49 +0,0 @@
-COOL LIBRARIES
-==============
-
-This category is for small, usable development libraries, which can be used for
-writing software that sucks less.
-These should preferrably be under the MIT/X consortium or BSD licenses, WTFPL,
-or public domain, or alternatively LGPL, because it makes them legally
-compatible with other suckless projects.
-
-libc implementations
---------------------
-* [uClibc](
http://www.uclibc.org/) - strives to be a minimalist C library suitable for embedded computing
-* [musl](
http://www.etalabs.net/musl/) - standard C library that attempts to be even smaller than uClibc
-* See also: [embedded libc comparison](
http://www.etalabs.net/compare_libcs.html)
-
-Configuration file parsers
---------------------------
-* [iniparser](
http://ndevilla.free.fr/iniparser/) - relatively small ini parsing library, contains a dictionary data structure and accessory functions (MIT licensed)
-
-Compression
------------
-* [liblzf](
http://oldhome.schmorp.de/marc/liblzf.html) - very fast, legally unencumbered compression library (dual licensed: 2-clause BSD or GPL License)
-* [xz embedded](
http://tukaani.org/xz/embedded.html) - lightweight decompressor for the xz LZMA compressor (public domain)
-* [zlib](
http://zlib.net/) - the "standard" compression/decompression library used in many applications ([zlib license](
http://zlib.net/zlib_license.html))
-
-libtom project
---------------
-All of these are dual-licensed under WTFPL and also public domain. According
-to the website, "[…] the GPG and OpenSSL folk assume that completely abhorrent
-and messy source code is ok, so long as it works. The LibTom Projects aims to
-change this line of thinking."
-
-* [libtommath, libtomcrypt and tomsfastmath](
http://libtom.org/)
-
-Cryptography
-------------
-* [libtomcrypt](
http://libtom.org/?page=features&newsitems=5&whatfile=crypt) - the cryptography library from the libtom project
-* [polarssl](
http://polarssl.org/) - lightweight SSL/TLS implementation (unfortunately GPL)
-
-Mathematics
------------
-* [libtommath](
http://libtom.org/?page=features&newsitems=5&whatfile=ltm) - math/bignum library (can be used insted of the much bigger [GNU MP](
http://gmplib.org) library).
-* [libtomfastmath](
http://libtom.org/?page=features&newsitems=5&whatfile=tfm) - port of libtommath using inline assembler for speedup on various architectures
-* [libmpi](
http://spinning-yarns.org/michael/mpi/) - lightweight math lib from which libtommath was originally forked
-
-Miscellaneous
--------------
-* [pjsip](
http://www.pjsip.org/) - open source SIP stack (GPL)
-* [libev](
http://software.schmorp.de/pkg/libev.html) - high performance event-loop modeled after libevent but much smaller (dual licensed under 2-clause BSD and GPL)
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/misc/cool_programs.md
--- a/suckless.org/misc/cool_programs.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,133 +0,0 @@
-COOL PROGRAMS
-=============
-
-Some programs work well with dwm. Some general rules of thumb
-for judging a programs as usable are:
-
-* The program will accept any window size
-* The program consists of a single window (there are no nested windows, such as in Xpdf)
-
-This covers most console-based programs and programs from [plan9port][].
-
-Accounting
-----------
-* [Ledger](
https://github.com/jwiegley/ledger/wiki)
-
-Audio Players
--------------
-* [C* Music Player](
http://cmus.sourceforge.net/)
-* [DeaDBeeF](
http://deadbeef.sourceforge.net/)
-* [PyTone](
http://www.luga.de/pytone/) - PyTone is a music jukebox written in Python with a curses based GUI. It provides features like crossfading and multiple players, special emphasis is put on ease of use.
-* [cplay](
http://cplay.sourceforge.net/)
-* [moc](
http://moc.daper.net/)
-* [mpd](
http://www.musicpd.org/) - A client/server based music player with console and graphical front-ends.
-* [mpg123](
http://www.mpg123.de/) - A console mpg player which doesn't use auto*hell, or extra libraries.
-* [mpg321](
http://mpg321.sourceforge.net)
-* [vorbis-tools](
http://www.xiph.org/) (Ogg/FLAC) - Command-line tools to play Ogg and FLAC files.
-
-BitTorrent Clients
-------------------
-* [btpd](
https://github.com/btpd/btpd) - The BitTorrent Protocol Daemon
-
-Feed aggregators
-----------------
-* [newsbeuter](
http://www.newsbeuter.org/)
-
-IRC Clients
------------
-* [Irc](
http://swtch.com/irc/)
-* [acme:SAC](
http://caerwyn.com/acme/index.html)
-* [ii](/programs/ii.html) - A FIFO based IRC client which is part of the suckless.org project.
-* [ircc](
http://www.r-36.net/src/Various/ircc.tgz) - A no-frills, ncurses free, console-based IRC client.
-* [ircrc](
http://plan9.bell-labs.com/sources/contrib/fgb/rc/ircrc) - An rc-based IRC client similar to ircc. Needs minor modification to run on UNIX.
-* [irssi](
http://www.irssi.org/)
-* [sic](/programs/sic.html) - Another suckless.org IRC client. Similar to ircc.
-
-Image Viewers
--------------
-* [feh](
https://derf.homelinux.org/projects/feh/)
-* [jpg/gif/bmp/png][plan9port] - Simple programs from Plan 9 to display images in no-frills windows. Included with plan9port.
-* [meh](
http://www.johnhawthorn.com/meh/) - image viewer using raw XLib, libjpeg, libpng and libgif
-* [page][plan9port] - Plan 9's image/document viewer program. Included with plan9port.
-* [qiv](
http://www.klografx.net/qiv/)
-* [sxiv](
https://github.com/muennich/sxiv) - Simple (or small or suckless) X Image Viewer. Depends on xlib and imlib2.
-* [xli](
http://pantransit.reptiles.org/prog/) - broken link? Apparently, there's a copy here:
http://ftp.x.org/contrib/applications/ -- at your own risk
-* [xzgv](
http://sourceforge.net/projects/xzgv)
-
-Instant Messaging Clients
--------------------------
-* [bitlbee](
http://www.bitlbee.org/) - A program to translate IM protocols to IRC. You can now IM from your IRC client, and you don't even need to install anything.
-* [centericq](
http://konst.org.ua/centericq/)
-* [centerim](
http://www.centerim.org/) - A centericq fork.
-* [climm](
http://www.climm.org/)
-* [mcabber](
http://www.lilotux.net/~mikael/mcabber/) - A console jabber client.
-* [ysm](
http://ysmv7.sourceforge.net/)
-
-Mail Clients
-------------
-* [Mail][plan9port] - A mail client for [acme][acme]. Included with plan9port.
-* [Sylpheed](
http://sylpheed.sraoss.jp/en/)
-* [dmc](
http://lolcathost.org/cgi-bin/hg/dmc/) - A minimalistic approach to a commandline mail client (WIP)
-* [fdm](
http://fdm.sourceforge.net/) - MDA
-* [heirloom-mailx](
http://heirloom.sourceforge.net/mailx.html) - A mail client based on the original Berkeley Mail 8.1 with many new features.
-* [mutt](
http://www.mutt.org/)
-* [muttator](
http://vimperator.org/muttator) - A Thunderbird extension to make it keyboard friendly and mutt/Vim-like.
-* [nmh](
http://www.nongnu.org/nmh/)
-
-Media Players
--------------
-* [mplayer](
http://www.mplayerhq.hu/) (without GUI) - You know mplayer, but you may not know that it works well without the GUI.
-* smplayer
-
-PDF Viewers
------------
-* [zathura](
http://zathura.pwmt.org/)
-
-Programming languages
----------------------
-* [Lua](
http://www.lua.org)
-* [TinyPy](
http://www.tinypy.org/) - Tiny Python (partial python)
-
-Text Editors
-------------
-* [acme][acme] - [Rob Pike][rob]'s framing text editor for Plan 9. Included in [plan9port][].
-* [ired](
http://www.radare.org) (Minimalist hexadecimal editor and bindiffer for p9, w32 and *nix)
-* [nvi](
http://www.bostic.com/vi/) - A small, multiple file vi-alike.
-* [sam](
http://sam.cat-v.org/) - An editor by [Rob Pike][rob] with inspiration from ed.
-* [traditional vi](
http://ex-vi.sourceforge.net/) - A fixed version of the original vi.
-* [vim](
http://www.vim.org) (With the GUI, use `:set go+=c` to kill popup dialogs)
-* [wily](
http://www.cs.yorku.ca/~oz/wily/) - An acme clone for POSIX.
-
-Utilities
----------
-* [9menu](
http://www.freshports.org/x11/9menu/) - A menu program based on the Blit-style menus so prevalent in Plan 9. A take on it is included with wmii.
-* [dmenu](/programs/dmenu.html) - Obvious
-
-Web Browsers
-------------
-* [Abaco](
http://lab-fgb.com/abaco/)
-* [Conkeror](
http://www.conkeror.org/) - A Gecko based browser, imparting it Emacs style key bindings, appearances, and behaviors.
-* [Dillo](
http://www.dillo.org/)
-* [ELinks](
http://elinks.or.cz/)
-* [Links](
http://links.twibright.com/)
-* [Lynx](
http://lynx.isc.org/)
-* [Vimperator](
http://vimperator.org/) - An extension to make Firefox keyboard friendly and Vim-like.
-* [edbrowse](
http://edbrowse.sourceforge.net/)
-* [surf](
http://surf.suckless.org/)
-* [uzbl](
http://uzbl.org/)
-* [w3m](
http://w3m.sf.net/)
-
-X11
----
-* [xdotool](http://www.semicomplete.com/projects/xdotool/) – A tool for
- scripting X11 actions.
-* [xzoom](http://git.r-36.net/xzoom/) – A simple zoom application.
-* [xclip](http://sourceforge.net/projects/xclip/) – A tool for controlling the
- X11 clipboard.
-* [keynav](http://www.semicomplete.com/projects/keynav/) – A new way for
- keyboard selection.
-* [ffcast](https://github.com/lolilolicon/FFcast2) – Simple screencasting.
-
-[rob]: http://herpolhode.com/rob/
-[plan9port]: http://swtch.com/plan9port/
-[acme]: http://acme.cat-v.org
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/misc/index.md
--- a/suckless.org/misc/index.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,3 +0,0 @@
-MISC
-====
-This section contains information that has no particular category.
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/patches.md
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/suckless.org/patches.md Thu Feb 09 21:15:55 2012 +0100
_AT_@ -0,0 +1,28 @@
+PATCHES
+=======
+
+diff generation
+---------------
+For mercurial users:
+
+ cd program-directory
+ hg diff > program-X.Y-yourpatchname.diff
+
+For tarballs:
+
+ cd modified-program-directory/..
+ diff -up original-program-directory modified-program-directory > program-X.Y-yourpatchname.diff
+
+where `X.Y` is a dwm tag name or version number.
+
+patch program
+-------------
+For mercurial users:
+
+ cd program-directory
+ hg patch path/to/patch.diff
+
+For tarballs:
+
+ cd program-directory
+ patch -p1 < path/to/patch.diff
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/wiki.md
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/suckless.org/wiki.md Thu Feb 09 21:15:55 2012 +0100
_AT_@ -0,0 +1,34 @@
+THIS WIKI
+=========
+If you would like to contribute new content, you can clone this wiki to your
+local host using the following command:
+
+ hg clone http://hg.suckless.org/sites
+
+You can make changes to the wiki, though your changes will be reviewed by the
+suckless moderators before going public into the mainstream web site. Please
+make sure to pull for incoming changes before you push your changes, to
+minimize any problems.
+
+ hg push
+
+The wiki repository above is world-writable.
+
+Rules
+-----
+* If any abuse happens, we will disable world-writable access. Keep this in mind!
+ We kindly ask you to not destroy the way we like to collaborate
+ with the community.
+* Please do not add files bigger than *100kb*.
+* Please do not add any binary files except screenshots or images related to our software.
+ You are allowed to add your code patches to the wiki if you do not have an
+ external web server to serve them to the community. The extension of patches
+ should be `.diff`.
+* The extension of newly created Markdown files has to be `.md`.
+* Please do not add HTML files or inline JavaScript.
+
+Bugs
+----
+Mercurial aborts with the message "unknown bundle compression type" if you want
+to push with version 0.9.1. (Maybe this affects every version before 1.0.)
+If you use Debian Etch, there is a backport.
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/wiki/index.md
--- a/suckless.org/wiki/index.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,34 +0,0 @@
-THIS WIKI
-=========
-If you would like to contribute new content, you can clone this wiki to your
-local host using the following command:
-
- hg clone http://hg.suckless.org/sites
-
-You can make changes to the wiki, though your changes will be reviewed by the
-suckless moderators before going public into the mainstream web site. Please
-make sure to pull for incoming changes before you push your changes, to
-minimize any problems.
-
- hg push
-
-The wiki repository above is world-writable.
-
-Rules
------
-* If any abuse happens, we will disable world-writable access. Keep this in mind!
- We kindly ask you to not destroy the way we like to collaborate
- with the community.
-* Please do not add files bigger than *100kb*.
-* Please do not add any binary files except screenshots or images related to our software.
- You are allowed to add your code patches to the wiki if you do not have an
- external web server to serve them to the community. The extension of patches
- should be `.diff`.
-* The extension of newly created Markdown files has to be `.md`.
-* Please do not add HTML files or inline JavaScript.
-
-Bugs
-----
-Mercurial aborts with the message "unknown bundle compression type" if you want
-to push with version 0.9.1. (Maybe this affects every version before 1.0.)
-If you use Debian Etch, there is a backport.
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/wiki/sandbox/index.md
--- a/suckless.org/wiki/sandbox/index.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,19 +0,0 @@
-SANDBOX
-=========
-This is a test sandbox, to show all features of markdown.
-
-Topic
------
-[a link](http://suckless.org)
-
- a bold text
-
-*italics*
-
-Blah blah
-
-
-Comment
------
-Please add all possibilities of markdown, I had no time for reviewing the code. -- Zwansch
-
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/wiki/sandbox/submenu1/index.md
--- a/suckless.org/wiki/sandbox/submenu1/index.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,1 +0,0 @@
-weeee...
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/wiki/sandbox/submenu1/subsubmenu1/index.md
--- a/suckless.org/wiki/sandbox/submenu1/subsubmenu1/index.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,1 +0,0 @@
-test
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/wiki/sandbox/submenu1/subsubmenu2/index.md
--- a/suckless.org/wiki/sandbox/submenu1/subsubmenu2/index.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,1 +0,0 @@
-test
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/wiki/sandbox/submenu1/subsubmenu3/index.md
--- a/suckless.org/wiki/sandbox/submenu1/subsubmenu3/index.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,1 +0,0 @@
-test
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/wiki/sandbox/submenu1/subsubmenu4/index.md
--- a/suckless.org/wiki/sandbox/submenu1/subsubmenu4/index.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,1 +0,0 @@
-test
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/wiki/sandbox/submenu2/subsubmenu1/index.md
--- a/suckless.org/wiki/sandbox/submenu2/subsubmenu1/index.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,1 +0,0 @@
-test
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/wiki/sandbox/submenu2/subsubmenu2/index.md
--- a/suckless.org/wiki/sandbox/submenu2/subsubmenu2/index.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,1 +0,0 @@
-test
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/wiki/sandbox/submenu2/subsubmenu3/index.md
--- a/suckless.org/wiki/sandbox/submenu2/subsubmenu3/index.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,1 +0,0 @@
-test
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/wiki/sandbox/submenu3/subsubmenu1/index.md
--- a/suckless.org/wiki/sandbox/submenu3/subsubmenu1/index.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,1 +0,0 @@
-test
diff -r 1ed63c2f7033 -r 1b3039b7a0e8 suckless.org/wiki/sandbox/submenu3/subsubmenu2/index.md
--- a/suckless.org/wiki/sandbox/submenu3/subsubmenu2/index.md Wed Feb 08 23:07:10 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
_AT_@ -1,1 +0,0 @@
-test
Received on Thu Feb 09 2012 - 21:15:52 CET