sites

Unnamed repository; edit this file 'description' to name the repository.
Log | Files | Refs

commit 7a3be7883696b1aaddeee2137b587ce3e2258712
parent 8ba56a0d0c3c9d82a1f6d221f09a905cb623291e
Author: anselm@garbe.us <unknown>
Date:   Thu,  9 Feb 2012 21:23:09 +0100

another cleanup round
Diffstat:
Dsuckless.org/broken_libraries.md | 23-----------------------
Dsuckless.org/broken_programs.md | 53-----------------------------------------------------
Dsuckless.org/cool_daemons.md | 18------------------
Dsuckless.org/cool_libraries.md | 49-------------------------------------------------
Dsuckless.org/cool_programs.md | 133-------------------------------------------------------------------------------
Asuckless.org/rocks.md | 204+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Asuckless.org/sucks.md | 78++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
7 files changed, 282 insertions(+), 276 deletions(-)

diff --git a/suckless.org/broken_libraries.md b/suckless.org/broken_libraries.md @@ -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 --git a/suckless.org/broken_programs.md b/suckless.org/broken_programs.md @@ -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 --git a/suckless.org/cool_daemons.md b/suckless.org/cool_daemons.md @@ -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 --git a/suckless.org/cool_libraries.md b/suckless.org/cool_libraries.md @@ -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 --git a/suckless.org/cool_programs.md b/suckless.org/cool_programs.md @@ -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 --git a/suckless.org/rocks.md b/suckless.org/rocks.md @@ -0,0 +1,204 @@ +Stuff that rocks +================ + +Libraries +========= +This section 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) + + +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 + + +Daemons +======= + +This section 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 --git a/suckless.org/sucks.md b/suckless.org/sucks.md @@ -0,0 +1,78 @@ +Stuff that sucks +================ + +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/ + +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. + +Workarounds +----------- + +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/