[wiki] [sites] Adding a Documentation section to sucks. || Christoph Lohmann

From: <git_AT_suckless.org>
Date: Wed, 21 Oct 2015 14:29:29 +0200

commit fb68f5cbab8711537809d6ee635a082d0c0eb81c
Author: Christoph Lohmann <20h_AT_r-36.net>
Date: Wed Oct 21 14:28:30 2015 +0200

    Adding a Documentation section to sucks.
    Here GNU info and HTML documentation are added as bad examples.

diff --git a/suckless.org/sucks/index.md b/suckless.org/sucks/index.md
index 359cd06..692b3fa 100644
--- a/suckless.org/sucks/index.md
+++ b/suckless.org/sucks/index.md
_AT_@ -92,6 +92,24 @@ The following programs are broken (see [rocking stuff](/rocks) for saner alterna
 If you still need some program which expects a floating WM, use it in
 floating mode.
+Somewhen GNU tried to make the world a bit more miserable by inventing
+[texinfo][texinfo]. The result is that in 2015 man pages are still used and
+the documentation of GNU tools requires you to run `info $application`. The
+info browser is awkward and unintuitive and the reason why noone gets further
+than finding 'q' to quit it.
+Look at GNU tools how to not handle documentation.
+Talking about the suck in enforced HTML documentation which forces you to open
+up a 1 Gb of RAM wasting web browser just to see some eye-candy which could
+have been described in the source with some easy way to jump to that line in
+the source code is not worth the time.
+The suckless way is to have a short usage and a descriptive manpage. The
+complete details are in the source.
 See also
_AT__AT_ -101,3 +119,5 @@ The [list of harmful software](http://harmful.cat-v.org/software/) at [cat-v.org
 [st]: http://st.suckless.org/
 [uuterm]: http://etalabs.net/uuterm.html
 [icccm]: http://tronche.com/gui/x/icccm/
+[textinfo]: https://www.gnu.org/software/texinfo/
Received on Wed Oct 21 2015 - 14:29:29 CEST

This archive was generated by hypermail 2.3.0 : Wed Oct 21 2015 - 14:36:10 CEST