Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > comp.lang.c > #61371

Re: Understandability

From Bartc <bc@freeuk.com>
Newsgroups comp.lang.c
Subject Re: Understandability
Date 2015-05-02 10:38 +0100
Organization A noiseless patient Spider
Message-ID <mi25se$9sl$1@dont-email.me> (permalink)
References <f088f6c5-01bd-44ca-b51a-04e71d1bd169@googlegroups.com>

Show all headers | View raw


On 02/05/2015 01:55, David Kleinecke wrote:
> I googled "gcc tutorial" and looked at each hit. Two of the hits on
> the first page are not really about gcc. Here are the title and first
> sentence of the of the other hits:

> Not a single one starts with a statement about what gcc is and does.

This is a fairly typical experience for me.

Look at any open source project, and the comments at the start of most 
source files tend to be concerned with licence agreements rather than 
what the application or module does. The readme file is invariably some 
sort of version history. Or gives installation details. Or is about any 
subject under the sun except what the whole ******* thing is about and 
what it's for!

(I've been equally frustrated with user manuals and help files in the 
past. They usually assume that nothing has gone wrong and that 
everything works perfectly. But you only resort to the manual or help 
file when something doesn't work or has gone wrong!)

-- 
Bartc

Back to comp.lang.c | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread


Thread

Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-01 17:55 -0700
  Re: Understandability Keith Thompson <kst-u@mib.org> - 2015-05-01 19:41 -0700
  Re: Understandability wssimms@gmail.com - 2015-05-01 20:45 -0700
  Re: Understandability Bartc <bc@freeuk.com> - 2015-05-02 10:38 +0100
    Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-02 09:15 -0700
      Re: Understandability David Brown <david.brown@hesbynett.no> - 2015-05-04 09:26 +0200
        Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-04 12:52 -0700
  Re: Understandability Noob <root@127.0.0.1> - 2015-05-02 14:21 +0200
    Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-02 09:13 -0700
      Re: Understandability Ian Collins <ian-news@hotmail.com> - 2015-05-03 08:07 +1200
      Re: Understandability Keith Thompson <kst-u@mib.org> - 2015-05-02 13:11 -0700
        Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-03 10:50 -0700
          Re: Understandability Tim Rentsch <txr@alumni.caltech.edu> - 2015-05-03 13:26 -0700
            Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-04 12:29 -0700
              Re: Understandability Tim Rentsch <txr@alumni.caltech.edu> - 2015-05-05 05:47 -0700
        Re: Understandability raltbos@xs4all.nl (Richard Bos) - 2015-05-08 21:10 +0000
          Re: Understandability Ian Collins <ian-news@hotmail.com> - 2015-05-09 09:17 +1200
          Re: Understandability Keith Thompson <kst-u@mib.org> - 2015-05-08 14:32 -0700
            Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-09 09:13 -0700
              Re: Understandability Keith Thompson <kst-u@mib.org> - 2015-05-09 16:48 -0700
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-10 11:05 -0700
                Re: Understandability David Brown <david.brown@hesbynett.no> - 2015-05-11 08:48 +0200
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-11 09:55 -0700
                Re: Understandability James Kuyper <jameskuyper@verizon.net> - 2015-05-11 17:52 -0400
                Re: Understandability glen herrmannsfeldt <gah@ugcs.caltech.edu> - 2015-05-11 22:54 +0000
                Re: Understandability David Brown <david.brown@hesbynett.no> - 2015-05-12 08:49 +0200
                Re: Understandability Morris Dovey <mrdovey@iedu.com> - 2015-05-12 02:15 -0500
                Re: Understandability Phil Carmody <pc+usenet@asdf.org> - 2015-05-25 03:15 +0300
                Re: Understandability James Kuyper <jameskuyper@verizon.net> - 2015-05-25 00:45 -0400
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-25 10:26 -0700
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-11 10:06 -0700
                Re: Understandability David Brown <david.brown@hesbynett.no> - 2015-05-12 08:59 +0200
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-12 08:37 -0700
                Re: Understandability David Brown <david.brown@hesbynett.no> - 2015-05-13 08:53 +0200
                Re: Understandability Keith Thompson <kst-u@mib.org> - 2015-05-13 08:16 -0700
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-13 09:49 -0700
                Re: Understandability Keith Thompson <kst-u@mib.org> - 2015-05-13 10:53 -0700
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-14 10:35 -0700
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-13 09:31 -0700
                Re: Understandability James Kuyper <jameskuyper@verizon.net> - 2015-05-13 13:10 -0400
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-14 10:27 -0700
                Re: Understandability James Kuyper <jameskuyper@verizon.net> - 2015-05-14 22:51 -0400
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-15 10:02 -0700
                Re: Understandability James Kuyper <jameskuyper@verizon.net> - 2015-05-15 13:37 -0400
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-16 09:18 -0700
                Re: Understandability David Brown <david.brown@hesbynett.no> - 2015-05-16 23:56 +0200
                Re: Understandability gazelle@shell.xmission.com (Kenny McCormack) - 2015-05-17 12:45 +0000
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-17 09:16 -0700
                Re: Understandability James Kuyper <jameskuyper@verizon.net> - 2015-05-17 12:47 -0400
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-18 10:54 -0700
                Re: Understandability James Kuyper <jameskuyper@verizon.net> - 2015-05-18 15:00 -0400
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-19 09:49 -0700
                Re: Understandability James Kuyper <jameskuyper@verizon.net> - 2015-05-19 13:10 -0400
                Re: Understandability James Kuyper <jameskuyper@verizon.net> - 2015-05-16 19:01 -0400
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-17 09:30 -0700
                Re: Understandability James Kuyper <jameskuyper@verizon.net> - 2015-05-17 12:58 -0400
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-18 10:54 -0700
                Re: Understandability James Kuyper <jameskuyper@verizon.net> - 2015-05-18 14:56 -0400
                Re: Understandability David Kleinecke <dkleinecke@gmail.com> - 2015-05-19 09:46 -0700
                Re: Understandability James Kuyper <jameskuyper@verizon.net> - 2015-05-19 13:16 -0400
                Re: Understandability Richard Heathfield <rjh@cpax.org.uk> - 2015-05-19 18:23 +0100
                Re: Understandability James Kuyper <jameskuyper@verizon.net> - 2015-05-19 14:02 -0400
                Re: Understandability David Brown <david.brown@hesbynett.no> - 2015-05-19 00:11 +0200
                Re: Understandability James Kuyper <jameskuyper@verizon.net> - 2015-05-18 18:28 -0400
                Re: Understandability Keith Thompson <kst-u@mib.org> - 2015-05-15 10:52 -0700
                Re: Understandability David Brown <david.brown@hesbynett.no> - 2015-05-13 21:53 +0200
          Re: Understandability David Brown <david.brown@hesbynett.no> - 2015-05-09 16:18 +0200
          Re: Understandability Noob <root@127.0.0.1> - 2015-05-09 18:31 +0200
            Re: Understandability raltbos@xs4all.nl (Richard Bos) - 2015-05-17 10:44 +0000
              Re: Understandability glen herrmannsfeldt <gah@ugcs.caltech.edu> - 2015-05-17 15:53 +0000
      Re: Understandability David Brown <david.brown@hesbynett.no> - 2015-05-04 09:15 +0200
        Re: Understandability Waldek Hebisch <hebisch@math.uni.wroc.pl> - 2015-05-16 00:28 +0000
  Re: Understandability Tim Rentsch <txr@alumni.caltech.edu> - 2015-05-03 10:58 -0700

csiph-web